源代码管理 jeremytenjo/dsh-plugin-source-control

DeepSeek Harness 源代码管理

在会话右侧边栏中查看改动、生成提交信息、提交、推送，以及管理 GitHub 仓库。

功能

- 用会话的模型，根据当前 diff 生成 Conventional Commits 格式的提交信息。
- 用 git add -A 和 git commit 提交全部改动；钩子照常生效。
- 一眼看清当前分支、上游分支，以及领先/落后状态。
- 在顶部切换本地分支，或新建分支；新分支会自动检出。
- 按文件查看 diff，由 @pierre/diffs 提供 Shiki 语法高亮，带行号、hunk 分隔符，以及工作区与 HEAD 的对比上下文。
- 在 diff 面板里直接预览改动过的图片、视频和音频。
- 点击图片打开全屏查看器，支持滚轮/双指缩放、拖动平移和关闭按钮。
- 右键点击 diff 中的某一行，在 VS Code 中打开该文件并定位到这一行。
- 把未推送的提交推送到已配置的上游分支。
- 打开已连接的 GitHub 仓库，或用 gh 创建私有/公开仓库。
- 遇到死会话错误时，重启应用和 Host。
- 界面支持英文和中文。

媒体预览

图片、视频和音频会直接替代文本 diff 渲染。媒体通过仅限回环地址的路由流式传输，支持 range 请求以便拖动进度。点击图片打开全屏查看器，由 react-zoom-pan-pinch 驱动；滚动或双指缩放，拖动平移，按 Escape 或点关闭按钮退出。

切换分支

点击 GitHub 图标旁的分支指示器，切换本地分支或新建分支。新分支从当前 HEAD 创建，并立即检出。

环境要求

- DeepSeek Harness 0.2.1-rc.2。
- Git，且推送需要配置上游分支。
- 已配置模型，用于生成提交信息。
- 创建仓库需要：安装 GitHub CLI（gh），并用 gh auth login 完成认证。
- Open in VS Code 需要：安装 VS Code，且 code 命令在 PATH 中。

安装

git clone https://github.com/jeremytenjo/dsh-plugin-source-control.git
dsh plugin --profile desktop add ./dsh-plugin-source-control

重启 Host 或刷新页面。把 desktop 换成 dsh --profile <name> --dump-config 显示的配置档名称。

使用

1. 在会话中打开一个 Git 仓库。
2. 点击编辑器旁的 Git 按钮，打开源代码管理面板。
3. 点击顶栏的分支指示器，切换或新建分支。
4. 编写或生成提交信息，然后点击 Commit。
5. 分支领先于上游时，使用 Push。
6. 点击有改动的文件，打开它的差异对比；Open file 显示完整文件。
7. 用 GitHub 图标打开仓库，或新建仓库。

在提交信息输入框中按 Cmd+Enter / Ctrl+Enter 即可提交。

开发

浏览器端部分用 TSX 构建，搭配 React、Tailwind CSS、shadcn 基础组件和 Lucide 图标。client.js 是面板的即时加载包；@pierre/diffs 渲染器放在 client.diff.js 里，按需懒加载。src/client.tsx 是构建入口，并重新导出 src/client-controller.js，后者负责 Host RPC、状态、翻译和侧边栏接线。

pnpm install
pnpm typecheck
pnpm build

pnpm build 会重新生成 client.js、client.diff.js 和 Tailwind CSS。两个包都要提交。改动 Host 端部分后，重新加载插件（Settings → Plugins → 禁用/启用），或重启 Host。

安全与限制

- Git、gh 和 code 命令使用 argv 数组，从不经过 shell。重启操作使用 Electron 的 app.relaunch()。
- 差异视图比较工作区与 HEAD；它不浏览历史，也不查看任意版本。
- 差异高亮在主线程运行，懒加载的差异代码块约 10 MB。
- 媒体预览显示当前工作区文件；已删除的媒体回退为二进制提示。
- 切换分支只列出本地分支；不会检出远程分支。
- GitHub 支持仅针对 github.com。