lak321/dsh-filetree

DSH 文件树 — DeepSeek Harness 工程文件浏览器

给 DeepSeek Harness Web 界面增加工程查看 / 打开 / 编辑能力的插件组合。

DSH 官方界面没有文件浏览器，本插件补齐：在会话视图新增 “文件” 页签，显示当前工作区（工程）的完整目录树，点击文件即可查看，并支持 VSCode 风格的代码编辑与保存。

功能

- 📁 工程查看：完整目录树，展开/折叠所有子文件夹，跟随当前工作区（切换工程自动切换）
- 📖 打开文件：点击任意文件查看内容
- ✏️ 编辑保存：直接修改并保存到磁盘
- 🎨 VSCode 风格编辑器：
- C/C++ 语法高亮（关键词/字符串/注释/数字/预处理器，Dark+ 配色）
- 行号栏（随滚动联动）
- Tab 键缩进（4 空格）+ 回车自动缩进
- 状态栏（文件类型 / UTF-8 / 光标行列）
- 深色主题，透明滚动条

组成

Bundle 形态（标准 DSH 插件包，包根 = 仓库根）：

| 端 | 位置 | 作用 |
|---|---|---|
| Host（Node half） | host/lib/index.js（main / exports["."]） | 注册 POST /api/filetree HTTP 路由（list/read/write，基于 fs 服务） |
| Client（UI half） | client/lib/client.js（exports["./client"] + dsh.client.platform） | 会话视图“文件”页签：目录树 + VSCode 风格编辑器 |

组合层：根 cordis.patch.yml（dsh.bundle.patch 指向），挂载 host half；client half 由 exports["./client"] 自动进 __DSH_BOOT__。

安装

一条命令（git 源，产物已入库，无需构建）：

dsh plugin --profile web add "github:lak321/dsh-filetree#&path:/"

换成最新提交号（见仓库主页）。path:/ 指向仓库根（本 bundle 包根 = 仓库根）。

或本地目录（包目录内执行）：

cd dsh-filetree && dsh plugin --profile web add .

装完重启 DSH（npx -y @deepseek-ai/dsh web），浏览器打开后会话视图顶部出现 “文件” 页签。

旧的手动复制 host/+client/ 并注入 cordis.patch.yml 的方式已废弃，由 bundle 层栈安装替代（见 install/cordis.patch.example.yml 仅为历史参考）。

使用

1. 打开 DSH Web 界面，进入任意会话
2. 点顶部 “文件” 页签（在 对话 / 轨迹 之后）
3. 左侧为当前工程目录树（顶部显示工程名，来自当前工作区 cwd）
4. 点 ▸ 展开文件夹，点文件在右侧打开
5. 编辑 → 保存（顶栏按钮，未保存显示 ●）；关闭 收起编辑器

工作原理

- Host：dsh-filetree 在 apply 时通过 ctx.get('webServer').register() 注册 /api/filetree 路由，处理器用 ctx.get('fs') 执行目录列举 / 读文件 / 写文件。fs.resolve() 支持相对路径（工作区根）和绝对路径（如会话 cwd）。
- Client：dsh-client-ui-filetree 通过 ctx.slots.inject("conversation.view") 注册 files 页签（id: "files", order: 20, label: "文件"）。组件从 props.useSession 读取会话 cwd 作为文件树根目录，用浏览器 fetch 调 /api/filetree。编辑器为纯 JS 实现（textarea 叠加语法高亮层 + 行号），无第三方依赖。

开发要点（踩坑记录）

- single slot shadow 需更低 priority：若替换 sidebar.workspaces 这类 single slot，必须用 priority: -1，否则 loader 报 "already has a registration at priority 0"。
- client 插件必须导出 exports.inject（依赖列表，如 ["slots"]），否则 ctx.slots 不可用。
- client.js 是 window.__ModuleLoader__.load({ id, factory }) 格式，factory 内用 require("react")，导出 exports.apply / exports.inject。

License

MIT

插件发布

WhaleHub 插件市场提交规范（标准 bundle 整改 + Issue 表单/PR 流程）见
docs/whalehub-submission.md。