前言¶
在 DeepSeek Harness（DSH）Web 中做智能体开发时，常需要查看智能体生成或修改的文件。CodeReader 是 DSH Web 插件，把工作区文件树与多标签编辑画板放进对话界面，方便在同一窗口内浏览、核对、编辑并写回当前工作区磁盘。
这是什么¶
CodeReader 是 DSH Web 插件，由 PathChan 维护，许可证为 MIT。它的定位是：在 DSH Web 的对话界面中提供工作区文件树与多标签编辑画板。
package.json 名称为 codereader，仓库为 PathChan/CodeReader。
核心功能¶
工作区文件树¶
- 提供「打开文件」入口。
- 目录可逐级展开。
- 显示文件图标。
- 点击文件后在右侧画板打开。
多标签编辑画板¶
- 支持多标签打开源文件与产物。
- 当前文件可直接编辑。
- 提供语法高亮与行号。
- 未保存标签以圆点标识，关闭前将提示确认。
保存与打开¶
- 通过
Ctrl+S/Cmd+S或工具栏保存。 - 保存后内容写回当前工作区磁盘，并在写入后校验。
- 可将当前文件交由系统默认程序打开。
与智能体协同¶
- 智能体生成过程中，画板自动切换为只读，避免与模型同时改写同一文件。
- 点击对话中的产物路径时，可按设置选择「系统默认软件」或「在工作区画板中打开」。
设置¶
偏好保存在本机浏览器，不经过服务端。可设置：
- 默认打开方式
- 编辑器主题：跟随 Harness、深色、浅色
- 文件树设置入口
安装与启用¶
使用前需已安装 DSH，并使用 Web 配置。
安装插件：
npx @deepseek-ai/dsh plugin --profile web add github:PathChan/CodeReader
安装后启动 DSH Web，然后在侧栏使用文件树入口。
从本仓库源码安装时，先构建再加入配置：
npm install
npm run build
npx @deepseek-ai/dsh plugin --profile web add .
典型用法¶
1、安装插件并启动 DSH Web。
2、在侧栏工作区文件夹行点击「打开文件」。
3、在文件树中打开目标文件，于右侧画板编辑；保存后即写入磁盘。
4、如需使用本机程序打开，请使用画板工具栏中的「在系统默认软件中打开」。
适用场景与注意¶
CodeReader 适合使用 DSH Web、希望在对话界面内快速查看、核对或修改工作区文件的人。它围绕当前工作区提供文件浏览与编辑，不扩展工作区以外的路径访问。
注意：
- 读写范围限于当前工作区目录，不会访问工作区以外的路径。
- 插件以当前 DSH 进程权限运行；安装前应检查源码与许可证。
- 智能体生成过程中，画板自动切换为只读，避免与模型同时改写同一文件。
- 偏好保存在本机浏览器，不经过服务端。
链接¶
GitHub：https://github.com/PathChan/CodeReader
许可证：MIT
