代码与 Git 工作台 DazzzleKK/dsh-code-git-workbench

dsh-code-git-workbench

DeepSeek Harness Web UI 的 Code 和 Git 工作台。它在右侧边栏加两个页面：

- Code —— 面向 Harness 工作区的懒加载文件树、文件标签页、CodeMirror 编辑器、语法高亮、搜索、重新加载和保存。
- Git —— PyCharm 风格的日志：本地/远程分支、提交图、提交详情、文件差异、checkout、merge、rebase、cherry-pick、reset、revert、标签，以及 fetch/pull/push。

它还会在顶部栏的子代理目录弹窗里，把运行中的子代理排在空闲的子代理前面。

这个插件是 DeepSeek Harness 的宿主端 + 客户端代码。没有构建步骤，也不依赖 VS Code。PyCharm 风格的 Git UI 以源码形式与配套的 VS Code 扩展 pycharm-git-log 共享；两个仓库在运行时各自独立。

环境要求

- DeepSeek Harness，带内置的插件命令行（已在 0.2.1-rc.2 / DSH 44.x 桌面版上测试）。
- Git 页面需要一个本地 Git 仓库。
- 安装和运行插件都不需要 Node.js。

安装

把仓库克隆到一个固定位置，然后在 desktop 配置档里把这个文件夹注册为本地插件。

Windows

$repo = "C:\path\to\dsh-code-git-workbench"
$cli = "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd"
& $cli plugin --profile desktop add "link:$repo"

macOS / Linux

用应用自带的 dsh 命令行。具体路径取决于安装布局；如果命令行已经在 PATH 里：

dsh plugin --profile desktop add link:/absolute/path/to/dsh-code-git-workbench

完全退出 DeepSeek Harness 再重新打开。只重载窗口不够：宿主端那一半在进程启动时加载。

如果想改用浏览器配置档：

dsh --profile web

并用 --profile web 安装。

更新

git pull

然后重启 DeepSeek Harness。没有需要编译的东西。

卸载

& $cli plugin --profile desktop remove dsh-code-git-workbench

之后重启应用。

使用

1. 打开一个会话。两个页面都从会话的工作区起步；Code 可以切换到任意 Harness 工作区，Git 可以切换到任意本身是 Git 仓库的工作区。
2. 打开右侧边栏（桌面版按 Ctrl+Alt+B，或点边栏按钮）。
3. 点 + → Code 或 Git。引导页也会列出这两个页面。
4. 想要更大空间，用面板的全屏控件。

Code

- 懒加载目录树；.git 隐藏。
- 树头部的工区选择器列出所有 Harness 工作区。会话目录不是仓库时，Code 从第一个是仓库的工作区起步。选择按会话记住。
- 标签页各自保留文档、光标、滚动位置和未保存状态。
- 自动保存默认开启，参照 PyCharm：
- 最后一次编辑后空闲 2 秒 —— 所有未保存的标签页都写入；
- 切换到其他应用 / 隐藏 DSH 窗口时；
- 关闭文件标签页（标签页会保存，不会丢弃）；
- 切换工作区（先保存所有未保存的标签页）；
- 退出页面（pagehide，keepalive 请求）；
- 点击另一个 DSH 标签页（例如 Git）会让编辑器失焦并触发保存，这就覆盖了「VCS 操作之前」的场景。
在文件标签页之间切换不会强制保存；空闲、失焦、关闭这几个触发点会保存，和 PyCharm 一样。Ctrl+S 仍然可以手动保存；写入成功后状态栏显示 Auto-saved。
- Ctrl+R 重新加载当前文件。工具栏有 Save 和 Reload 两个操作。
- CodeMirror 提供行号、括号匹配、自动闭合、增量搜索（Ctrl+F），以及 JS/TS、Python、JSON、Markdown、HTML/CSS、YAML、SQL、shell、PowerShell 和类 C 语言的模式。
- 文件按 UTF-8 读写。超过 2 MB 的文件和二进制文件会被拒绝显示。

Git

- 每个工作区只要是 Git 仓库，就有仓库选择器。
- 分支树分本地/远程两组，支持过滤、当前分支、ahead/behind、checkout、checkout + rebase、merge、rebase、compare、push、重命名、删除和打标签操作。
- 用斜杠分隔的分支名会变成可展开的文件夹：feat/123-login 显示为 feat → 123-login。树在 Local 和 Remote 内部各自独立构建。只有一个远程时，远程名当作上下文，从文件夹路径里去掉；有多个远程时，远程名成为第一层文件夹。文件夹的展开状态按仓库记住。
- 可以在行上或右键菜单里给分支加星标。收藏的分支浮到自己文件夹（以及 Local/Remote 根）的顶部；选择按 Git 仓库存在浏览器配置档里，标签页/页面重载后仍然保留。
- 所选分支（或所有分支）的提交日志，带彩色图谱、ref 徽标、作者和日期；支持过滤和「加载更多」。
- 提交详情显示完整提交信息、父提交、文件和 +/-，并提供 checkout、branch、cherry-pick、merge、rebase、reset（soft/mixed/hard）、revert 和打标签。
- 文件行会打开内置的 diff 浮层。「Compare with working tree」在文件右键菜单里。
- Fetch all、pull 和 push。分支没有上游时，push 回退到 --set-upstream origin。
- 分支右键菜单可以把指定分支拉进当前分支：远程分支，或带上游的本地分支，显示为 Pull '<branch>' into Current。
- 工具栏的 diff 按钮打开 Working tree changes：已暂存、未暂存和未跟踪的文件及数量。点击文件打开它的 diff（[staged] = 索引 vs HEAD，[unstaged] = 工作区 vs 索引）。
- 远程分支超过 40 个时自动折叠。

子代理顺序

页头的后代数量按钮打开子代理目录。每次渲染后，运行中的行会按树的每一层移到空闲行上方。这个排序是 DOM 增强，因为随附的目录没有排序插槽；宿主状态不会被修改。

架构

index.mjs host half: /code-git static UI + JSON API
client.js client half: Sidebar tab types + subagent catalog sort
web/code/ vanilla JS + CodeMirror 5 (vendored)
web/git/ PyCharm-style Git UI
cordis.patch.yml inserts the bundle row into the profile

宿主 API 对每个请求都调用 ctx.connection.requestRejection(req)，因此继承了 Harness 的 Host/Origin 防护和浏览器认证。所有路由都是同源的：

- 桌面外壳把 dsh-app://app/code-git/... 连同宿主 cookie 转发给本地宿主；
- 浏览器直接与同一个监听端口通信。

API 一览：

| 路由 | 用途 |
| GET /code-git/api/context | 会话 cwd、选中的根目录、工作区、仓库状态 |
| GET /code-git/api/tree | 一层目录 |
| GET/PUT /code-git/api/file | 读取/写入单个文件 |
| GET /code-git/api/git/state | 分支、提交、引用、领先/落后 |
| GET /code-git/api/git/status | 已暂存、未暂存和未跟踪的文件 |
| GET /code-git/api/git/worktree-diff | 索引/HEAD/工作区文件内容 |
| GET /code-git/api/git/commit | 提交信息、父提交、文件统计 |
| GET /code-git/api/git/diff | 旧/新文件内容 |
| POST /code-git/api/git/action | checkout、merge、rebase、reset、fetch、pull branch、push、… |

每个请求都会对照会话已注册的工作区做检查；路径会解析并限制在选中的根目录内。Git 通过 execFile 运行，不经过 shell，并设置 GIT_TERMINAL_PROMPT=0。

Git UI 与配套 VS Code 扩展面板使用同一套 HTML/CSS/JS。web/git/bridge.js 实现了 UI 编写时依赖的那一小块 acquireVsCodeApi() 接口，并把它的消息映射到 JSON API。整个过程不涉及 VS Code 运行时。

开发

没有构建步骤：

- 宿主：改 index.mjs，重启宿主；
- 客户端：改 client.js，重启宿主（或使用支持补丁热重载的 web 配置档）；
- Code UI：改 web/code/；
- Git UI：改 web/git/。

要起一个用完即弃的测试实例：

$cli = "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd"
& $cli --profile web --port 3080 --no-open

打开打印出来的 token URL，用正常 UI 操作。

发布前的测试清单：

- Web UI 启动时没有插件加载错误；
- + 能列出 Code 和 Git；
- 目录树能展开，文件能打开，编辑 + 保存能写入磁盘；
- 切换工作区会更新目录树/页脚；
- Git 能显示分支和提交、详情和 diff；
- 远程分支超过 40 个时折叠；
- 子代理目录仍能打开，运行中的行排在最前。

不要在真实工作区上测试破坏性 Git 操作；用一个临时仓库。

面向智能体的指南见 AGENTS.md。

限制

- 没有 LSP、快速打开或文件监听；用工具栏刷新。
- 不使用自定义键盘快捷键：DSH Web 快捷键适配器接受
- 只使用内置目录（否则会提示 Unsupported Web shortcut），所以页面要从 + 指南打开。
- 编辑内容按原样保存；没有保存时格式化，也不合并外部改动。
- 只能选择 Harness 中已注册的工作区；任意目录会被宿主拒绝。
- 重置、删除、推送都在确认提示之后执行；面板内没有撤销。
- 子代理排序是 DOM 增强，不会改动宿主目录。

第三方代码

- CodeMirror 5 — MIT，Marijn Haverbeke 及贡献者。
- VS Code Codicons — MIT，Microsoft。

见 THIRD_PARTY_NOTICES.md。

许可证

MIT。见 LICENSE。