dsh-sidebar-frog：DeepSeek Harness 里可弹出的文件与产物侧边栏

它是做什么的？

Popout Sidebar 是 DeepSeek Harness（DSH）的界面侧边栏插件，把 Agent 创建或改动的文件与所在工作区固定在随手可及的位置。它解决的是「文件散落、预览要跳出去、侧栏太窄」的麻烦：点开文件即以整面板宽度离线预览，侧栏嫌窄时一键弹出为独立浏览器标签页，可拖到第二块显示器。两个窗口共享同一会话、工作区与设置，实时同步。它由 zengqingsong 维护，采用 MIT 协议，零运行时依赖、无网络请求、无遥测，仅在工作区范围内读写。

核心功能

• 一键弹出到第二显示器：整个侧边栏移入独立浏览器标签页，会话、工作区、设置与分隔条位置全部共享，两个窗口不会各说各话。
• 完全离线的预览能力：代码、带公式与图表的 Markdown、PDF、HTML、图片、可排序 CSV 表格、Word / Excel / PowerPoint，以及支持 HTTP Range 的音视频，渲染库全部内置，无 CDN、无网络调用。
• 产物账本：Agent 写入或编辑过的文件自动出现，包括由 shell 命令间接产出的文件；被编辑的文件保留前后差异片段，撤销入口也在那里。
• 工作区文件树：接管系统侧边栏原有的 Files 标签，@ 引用、右键菜单与按目录刷新都在你原本查看的位置。
• 就地编辑保存：Markdown、纯文本与 CSV 用 CodeMirror 打开，Ctrl+S 保存，保存被限制在工作区内、会校验打开时的版本，并还原文件自身的换行符与字节序标记。
• 只读 Git 切片：显示分支、领先/落后，以及已改动 / 已暂存 / 未跟踪 / 冲突列表，任意文件可看对 HEAD 的行级差异；只读是硬边界，不做暂存、提交、检出与丢弃。

怎么使用这个插件？

在 DSH 的 web profile 中启用并重启服务、硬刷新浏览器后，右侧边栏会多出 Files、Artifacts、Jobs、Usage 与 Git 五个标签，左栏底部还会出现常驻的 File tree 按钮，新会话也能由此进入侧边栏。日常用法是：在 Artifacts 里点开 Agent 刚写出的文件，用整面板宽度预览；需要对照代码时切到 Files 树，用 @ 把文件引用进输入框；要改 Markdown、纯文本或 CSV 就直接在编辑器里改并保存。侧栏太窄时点弹出按钮，把它拖到第二块显示器，两个窗口共享同一份会话与设置。该插件面向 web profile 上的 DSH 0.1.5-rc.2，安装过程不执行构建脚本。

报错怎么排查？

预览或接口返回 401，通常是因为请求缺少浏览器 cookie——数据路由与产品自身的 /api 采用同样的 cookie 校验方式，带上 cookie 访问即可。若安装后界面没有变化，按官方说明重启 DSH 服务并硬刷新浏览器。若预览库加载异常，注意所有渲染器都是内置的，不依赖 CDN，因此应排查本地打包产物而非网络。