codereader

Readme

# CodeReader

DeepSeek Harness（DSH）Web 插件：在对话界面中提供工作区文件树与多标签编辑画板。

智能体修改代码时，可在同一窗口中浏览、核对、编辑并写回磁盘，无需切换至外部编辑器。

## 功能

**文件树**

- 工作区文件夹行、「新会话」按钮左侧提供「打开文件」入口；再次点击可收起。
- 目录可逐级展开；文件图标采用 Seti 风格（与 VS Code 文件树同类）。
- 单击文件在右侧画板中打开；单击文件夹仅展开或折叠。

**画板编辑**

- 支持以多标签打开源文件与产物，当前文件可直接编辑。
- 提供语法高亮与行号；未保存标签以圆点标识，关闭前将提示确认。
- 通过 `Ctrl+S` / `Cmd+S` 或工具栏保存，内容写回当前工作区磁盘，并在写入后校验。
- 可将当前文件交由系统默认程序打开（如本机 IDE、图片查看器）。
- 画板可折叠，需要时再展开；DSH 侧栏收起时，文件树同步让出空间。

**与智能体协同**

- 智能体生成过程中，画板自动切换为只读，避免与模型同时改写同一文件。
- 对话中的产物路径被点击时，可按设置选择「系统默认软件」或「在工作区画板中打开」。

**设置**

偏好保存在本机浏览器，不经过服务端。

- **默认打开方式**：系统默认软件 / 工作区画板。
- **编辑器主题**：跟随 Harness、深色、浅色。
- **入口**：文件树工具栏齿轮，或 DSH「设置」中的「文件树设置」。

## 使用方法

1. 安装插件并启动 DSH Web（见下文）。
2. 在侧栏工作区文件夹行点击「打开文件」。
3. 在文件树中打开目标文件，于右侧画板编辑；保存后即写入磁盘。
4. 如需使用本机程序打开，请使用画板工具栏中的「在系统默认软件中打开」。

## 安装

需已安装 [DSH](https://github.com/deepseek-ai/DeepSeek-Harness)，并使用 Web 配置：

```bash
npx @deepseek-ai/dsh plugin --profile web add github:PathChan/CodeReader
npx @deepseek-ai/dsh web
```

从本仓库源码安装时，请先构建再加入配置：

```bash
npm install
npm run build
npx @deepseek-ai/dsh plugin --profile web add .
npx @deepseek-ai/dsh web
```

卸载：

```bash
npx @deepseek-ai/dsh plugin --profile web remove codereader
```

## 说明

- 读写范围限于当前工作区目录，不会访问工作区以外的路径。
- 许可证：[MIT](LICENSE)

更多 DSH 插件见 Topic：[dsh-plugin](https://github.com/topics/dsh-plugin)