dsh-plugin-git

DSH Git 插件

在 DeepSeek Harness（DSH）会话中管理 Git 项目：查看改动、提交代码、同步分支、浏览历史和解决冲突。

支持中文与英文界面，以及深色、浅色主题。

安装

1. 安装 Git 2.36 或更高版本，确保 git 在 PATH 中可用。
2. 在 DSH 的 插件 → 添加插件 中输入 @happyqu/dsh-plugin-git，安装并启用。
3. 打开项目工作区，点击会话标题栏的 Git 按钮进入工作台。

新会话选好工作区后，无需先发送消息，即可通过“标准模式”等模式选择器右侧的分支按钮切换或新建分支；分支弹窗底部可打开 Git 工作台。开始对话后，入口位于会话标题栏。Git 始终跟随当前工作区；切换工作区期间暂不可操作 Git。

本包需要在 DSH 中使用，无需自行构建。未检测到 Git 时，可在插件设置中指定可执行文件路径。

插件前端和 Host 使用同一版本协议；更新后需一并重新加载。旧 Git 和旧 Host 不提供替代执行流程。

主要功能

功能	说明
项目与工作区	新建项目、打开本地目录、克隆仓库；新建或克隆后自动进入对应会话
改动与提交	改动列表、暂存、文件或代码块提交、提交范围预览、提交并推送
分支与同步	管理分支、标签和远程仓库，执行 Fetch、Pull、Push 与合并
工作树	查看同一仓库的多个开发目录及文件状态，新建、打开、安全删除、锁定、移动、修复关联与清理失效记录
历史与对比	提交历史与提交图、版本对比、完整文件与图片预览、历史文件及 ZIP 导出
冲突与储藏	对照当前与传入版本、逐块或手动解决冲突、使用 VS Code 合并、管理 stash
Git LFS	跟踪规则、内容同步，以及带备份的历史迁入与迁出
AI 辅助	生成提交信息、解释提交，支持选择模型与思考模式

从侧栏或新会话菜单的 添加工作区 进入，可选择新建项目、本地目录或克隆仓库。新建项目会记住上次使用的保存目录，项目文件夹名称需手动填写。

改动列表会识别未跟踪目录中的独立 Git 仓库，并显示“未注册的 Git 仓库”提示。可直接打开该仓库管理、选择“仅本机忽略”（写入外层仓库的 .git/info/exclude），或“添加到 .gitignore”（可随提交共享）。丢弃更改会保留这些仓库及其内部文件；批量操作继续处理其他选中的文件，并列出保留的仓库。

在 Git 工作台的 工作树 模块中，选择目录查看分支、改动和进行中的操作。“在 Git 中打开”仅切换 Git 操作目录；“打开为 DSH 工作区”进入对应工作区会话。分支菜单也可新建工作树，或直接打开占用该分支的工作树。创建后若打开失败，可重试打开，已创建的目录会保留。

删除工作树会移除目录及关联记录，保留分支。插件不提供强制删除；主工作树、当前工作树、锁定目录，以及含有改动、未跟踪或被忽略文件、未完成 Git 操作的目录均不能删除。工作树间共享分支、标签和 stash，暂存区与本地文件各自独立。

工作树详情提供锁定／解锁、移动和修复关联，执行前均需检查预览。暂时离线的磁盘可先锁定，避免记录被清理；锁定／解锁无需目录在线。移动会保留本地文件和分支，目标目录必须不存在；主工作树、当前工作树、锁定目录和进行中的 Git 操作不能移动，子模块等其他限制由 Git 检查。手动移动关联工作树后，可选中旧记录，使用“修复关联”选择保留原 .git 文件的新目录。移动和修复不会自动修改 DSH 已有工作区路径，请从新目录重新打开工作区。

“清理失效记录”会先预览全部可清理记录（包括刚失效的记录），只清理关联元数据，保留分支及工作目录。磁盘暂时离线时不要清理对应记录；先锁定需要保留的工作树。预览后若状态变化，需重新预览再执行。

工作树列表默认优先显示最近使用的目录，支持按分支排序，并搜索任务备注。备注保存在当前设备，不写入仓库；插件内切换前可保存或放弃草稿，从 DSH 侧栏切换会话时，未保存的草稿会在本次插件运行期间保留，返回对应工作树即可继续编辑。移动和修复后会迁移备注、草稿及使用记录。详情会展示 Host 提供的关联工作区、会话名称；打开目录时优先复用已有工作区，避免重复创建。

选择其他工作树后，点击“比较工作树内容”，可比较两个目录当前磁盘上的文件，包含暂存、未暂存及未跟踪文件，支持差异及左右两侧内容预览。对比使用只读快照，不改变文件、索引或仓库对象；忽略文件和子模块目录不参与，重命名按新增和删除展示。快照有效期为 5 分钟，最多保留最近两次；上限为 5000 个文件、读取总量 32 MiB、单文件 4 MiB，超限时会提示并停止。目录后续变化不会改写已有快照，需点击刷新生成新对比。

使用须知

• 提交前需配置 Git 用户名与邮箱；远端认证沿用 Git 凭据管理器或 SSH 配置。
• AI 功能需要 DSH 中可用的模型服务，普通 Git 操作不依赖 AI。
• 在“设置 → AI 助手”中可配置提交信息的差异排除规则：每行一条，例如 dist/**、**/*.map，用 !dist/important.js 设置例外。匹配文件只提供文件信息，不读取差异正文，不影响实际提交；常见产物和大文件默认只提供摘要。
• Git LFS 功能需要另行安装 Git LFS。
• 连接远程 DSH 时，文件操作、Git 和外部编辑器均运行在远程设备上。
• 更新后若提示功能尚未加载，请重新加载 Git 插件 Host 或重启 DSH；仅刷新页面不会更新 Host。

维护者

版本发布与 npm 授权配置见 发版指南。

反馈

源码：GitHub · 问题反馈：Issues

提交问题时，请附上插件版本、Git 版本、复现步骤和相关错误信息。失败命令可在插件的“输出”中查看。

许可证

MIT