前言¶
在 DeepSeek Harness(DSH)里用智能体改代码时,工作区往往已经绑定到某个 Git 仓库。提交、拉取、推送、切分支、看 diff 若都要切到终端或外部 GUI,会打断会话节奏。下面介绍社区插件 dsh-cool-git:把 commit、pull、push、branch、diff 等基础能力接到会话标签栏,在当前工作区内完成常见 Git 管理。
这是什么¶
dsh-cool-git 是 DSH 的 客户端 类插件,由维护者 CoolTea001(CoolTea)发布,源码托管于 GitHub,目录页见 SkillHub。插件定位与官方简介一致:在会话标签栏增加 Git 管理,覆盖 commit、pull、push、branch、diff 等基础能力。
当前 npm 包版本为 0.2.3,许可证 MIT。运行环境要求 Node.js ^22.19.0 或 >=24.0.0(与 README 中的 node: >=22.19 一致)。
核心功能¶
以下能力均来自项目 README 的 Features 说明,安装后可在绑定的工作区内使用:
- 工作区绑定:查看并管理当前工作区内的代码变更。
- 分支切换:在本地与远程分支之间快速切换。
- 同步:一键 Pull、Push,同步远端与本地。
- Diff 视图:按文件查看变更 diff。
- 提交历史:浏览 commit 历史,并查看对应文件 diff。
- 自动生成 commit message:使用 DSH 当前默认模型生成提交说明,并填入 Commit Message 输入框。
安装与启用¶
官方安装方式不是手写 git clone,而是在 DSH 里用 add-plugin 功能,输入包名:
dsh-cool-git
添加插件后,按 DSH 常规流程重启或刷新 Web 服务(本地开发文档示例为执行 dsh web)。插件以 web 平台客户端形式注入(package.json 中 dsh.client.platform 为 web)。
若你要自行改插件源码,README 中的贡献说明给出了开发流程(克隆仓库、pnpm install、pnpm run dev);日常用户只需通过包名安装即可,无需克隆。
典型用法¶
安装并启用后,在 DSH 会话界面找到标签栏上的 Git 相关入口(具体 UI 以当前 DSH 与插件版本为准),一般可按下面顺序完成一次常见闭环:
- 在工作区绑定前提下,打开变更列表,确认待提交文件。
- 使用 Diff 视图逐文件核对修改;需要时可打开提交历史查看过往 commit 与 diff。
- 在 Commit Message 中手写说明,或使用「自动生成 commit message」让当前默认模型生成并填入。
- 执行 commit;需要与远端对齐时,用一键 Pull / Push 或先切换分支再同步。
分支切换、Pull、Push 均在插件提供的界面内完成,无需为上述基础操作单独离开当前会话。
适用场景与注意¶
适合谁:经常在 DSH 会话里改绑定 Git 工作区、又希望少切工具的开发者;需要的基础能力集中在提交、同步、分支与 diff,而不是替代完整 Git 客户端的全部高级功能。
权限与安全:插件在 当前 dsh 进程权限 下运行,对工作区 Git 仓库的读写与你在本机执行 git 命令的权限边界一致。安装前建议在 GitHub 仓库 查看源码与 MIT 许可证,确认符合你的环境策略。社区目录 SkillHub 为独立站点,与 DeepSeek / 幻方无官方从属关系,插件亦非官方应用商店预装项。
生态背景:DSH 采用「一切皆插件」的扩展方式;dsh-cool-git 属于客户端插件,通过 Cordis patch(cordis.patch.yml)与 DSH 集成。遇到问题可在仓库 Issues 反馈,也欢迎按 README 通过 PR 参与贡献。
结尾¶
dsh-cool-git 把 Git 的基础操作收进 DSH 会话标签栏,减少在终端与 IDE 之间来回切换。安装时在 add-plugin 中填写包名 dsh-cool-git 即可。
- 目录页:https://www.skillhub.cn/plugins/CoolTea001/dsh-cool-git
- GitHub:https://github.com/CoolTea001/dsh-cool-git