ylw-a/dsh-file-review

dsh-file-review

DeepSeek Harness 的文件资源管理器——可调整大小的文件树，支持右键菜单文件操作、由 Shiki 驱动的可编辑代码编辑器（预览即编辑）、Markdown 源码/渲染切换，以及目录树的自动刷新。

功能特性

- 文件树侧边栏（可停靠于左侧/右侧，可调整大小 220–900px）：懒加载目录、全部展开/折叠、跨工作区搜索。
- 右键菜单：剪切 / 复制 / 粘贴 / 复制绝对路径 / 复制相对路径 / 重命名 / 删除到回收站 / 新建文件 / 新建文件夹 / 刷新 / 在 VS Code 中打开.
- 统一编辑器（Shiki 语法高亮 + 在同一视图中直接编辑，无预览/编辑分屏）：防抖高亮、滚动同步的 textarea 幽灵叠加层、Ctrl/Cmd+S 保存、脏标签页关闭确认。
- Markdown：默认进行语法高亮的源码编辑，并提供 渲染/编辑 切换，进入只读渲染视图（官方 MarkdownText）。
- 自动刷新：可见的文件树每约 2 秒轮询一次，仅在条目签名发生变化时重新渲染；保留手动刷新按钮作为后备；写操作后立即刷新。
- 双重承载：无会话时为浮动编辑器窗口；存在会话后为固定的 文件 父标签页（对话 | 轨迹 | 文件）——共享存储，切换标签页时不会丢失任何内容。
- 删除操作会移入 Windows 回收站（PowerShell Microsoft.VisualBasic），绝不永久删除。

安装

需要本地 DeepSeek Harness 配置文件（web）。先构建，再添加该包：

npm install
npm run build
dsh plugin --profile web add -w

然后重启 harness。宿主端挂载 file-explorer 插件并注册 /plugins/file-explorer/ 路由；客户端渲染面板、侧边栏切换按钮和编辑器。

lib/ 和 docs/ 是构建产物 / 本地设计文档，不纳入提交（见 .gitignore）。修改 src/ 后需重新构建。

开发

npm install          # devDependencies only (esbuild, shiki, typescript…)
npm run build        # esbuild → lib/index.js (host ESM) + lib/client.js (client bundle)

- 宿主端（src/host/）：services → paths → recycle/vscode → ops → routes → index。所有写入操作在经 fs.resolve/fs.processPath 规范化后，均通过 node:fs/promises 进行。
- 客户端（src/client/）：api → store → highlighter/languages → styles → autoRefresh → components → slots/measure → index。组件从不直接 fetch，也从不接触 ctx；共享的路由契约位于 src/shared/contract.ts。
- 客户端 bundle 内联了 shiki（JavaScript 正则引擎，无 WASM），并固定支持约 25 种语言；颜色通过 --shiki- CSS 变量跟随 DSH 主题。

许可证

MIT