前言¶
在 DeepSeek Harness 的 Web 界面中，Agent 修改文件时缺乏直观的实时反馈。开发者需要频繁切换标签页或查看终端输出，才能确认修改内容。dsh-code-studio 插件将文件变更监视和代码编辑功能集成在 DSH Web UI 内部，解决了这一问题。
插件介绍¶
这是一个由 WindyPro-rourou 维护的插件，定位为 DSH Web UI 内的文件变更监视器与代码编辑器。它允许用户在不离开浏览器界面的情况下，实时查看 Agent 对文件的修改（以 Diff 形式呈现），并进行还原或手动编辑。
核心功能¶
该插件提供以下核心能力：
1. 实时文件修改监视：基于会话工具事件直推，不依赖文件系统轮询。
2. 多工作区覆盖 + 切换器：支持多工作区切换，按会话记忆。
3. 按会话隔离：每个 Code Studio 只响应当前会话的修改。
4. 会话状态记忆：变更列表、打开的标签、面板宽度、过滤条件按会话保留。
5. 一键还原：每个变更条目带还原按钮，可撤销 Agent 在本会话内的全部修改。
6. 修改历史时间线：按时间倒序回放 Agent / 用户 / 还原事件。
7. 发送到会话：把当前打开的文件内容一键发给当前会话的 Agent。
8. 语法高亮编辑器：行号、光标、滚动同步，支持 Ctrl+S 保存。
9. 大文件虚拟滚动：Diff 视图窗口化渲染，支持万行级文件流畅滚动。
10. SSE 断线自愈：事件带序号 + 服务端环形缓冲，断线重连自动补发丢失的变更。
11. 变更过滤搜索：按路径关键词 + 文件类型过滤变更列表。
12. 键盘快捷键：Ctrl+Alt+C 开关面板，Alt+↓/↑ 在变更间跳转。
13. 可拖拽面板：宽度自由调整，UI 与 DSH 主题一致。
安装与启用¶
使用以下命令安装插件：
dsh plugin --profile web add @windypro-rourou/dsh-code-studio
安装完成后，重启 dsh web 服务，左侧边栏会出现 Code Studio 入口。
典型用法¶
- 打开面板：通过对话头部工具栏的变更胶囊或侧边栏入口打开 Code Studio。
- 查看修改：让 Agent 修改代码，面板会自动浮现该文件的逐行 Diff（
+新增 /−删除 /~修改）。 - 还原修改：对不满意的修改点点击「还原」，一键回到 Agent 动手前。
- 文件操作：在「文件」页签中切换工作区、浏览文件树、直接编辑保存。
- 快速定位：使用顶部搜索框 + 类型筛选快速定位变更。
注意事项¶
- 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
- 单文件超过 512KB 不读取内容。
- 超过 100KB 的历史事件内容会截断保存。
- 通过 bash/pwsh 等非文件工具写入的变更依赖文件监视兜底，可能有少量延迟。
- 还原点保存在内存中，服务重启后丢失。
短结尾¶
该插件通过提供实时的 Diff 视图和内置编辑器，简化了 Agent 代码编辑的交互流程。更多细节可参考插件目录或GitHub 仓库。
