dsh-git-plus

dsh plugin --profile web add dsh-git-plus

dsh-git-plus

<div align="center">

[English](README.md) | 简体中文

</div>

DeepSeek Harness Web GUI 的 IDE 风格 Git 面板。侧栏提供 Local Changes（本地变更）与 All Commits（全部提交），以及分支 / 标签 / Stash 管理、Fetch / Pull / Push 弹窗、带冲突处理的合并，还有输入框上的 zsh 风格分支标记。

<p align="center">

<img src="docs/image/screenshot_changes.png" alt="Local Changes 视图" width="50%">

<img src="docs/image/screenshot_commits.png" alt="All Commits 视图" width="50%">

</p>

安装

dsh plugin --profile web add git+ssh://git@github.com/bitxeno/dsh-git-plus.git

包发布到 npm 后也可以用registry形式安装：

dsh plugin --profile web add dsh-git-plus

已有安装用同一条命令即可更新；需要固定版本时在包名后追加 @<版本>。安装后重启 dsh web（只改客户端时刷新浏览器即可）。

用法

面板以 Git Plus 标签出现在会话视图中。

侧栏 —— 顶部导航切换 Local Changes 与 All Commits；下方是同步工具条（fetch / pull / push），再往下是可折叠的 Branches / Tags / Stashes / Remotes 分组：

• Fetch —— 选择单个远程或获取所有远程（始终 --prune）。
• Pull —— 选择远程与远程分支（默认取上游分支），显示合并目标分支，可勾选 --rebase 与 --autostash。
• Push —— 选择本地分支与目标 远程/分支（一键新建远程分支）；「建立跟踪引用（--set-upstream）」仅在目标为远程新分支时出现，另可选 --tags 与 --force。
• 分支行显示领先/落后计数；远端没有对应分支的行图标置灰。点击分支/标签过滤 All Commits，双击检出，右键打开行菜单（检出、合并、在此新建分支/标签、复制、删除）。
• Branches 与 Remotes 都按 / 折叠成分组；默认分支置顶显示（本地为 main 等，Remotes 为 origin/main）。Remotes 中默认分支不脱离其远程分组，而是留在 origin 分组内并排在第一位。
• Stash 行支持应用 / 应用并删除 / 删除（删除需二次点击确认）。

面板变窄时（手机，或被拖窄的桌面窗口——按面板自身宽度测量，不依赖视口）侧栏收起为常驻图标栏：顶部格子展开抽屉，接下来两个直接切换视图而不展开任何东西，下面四个分组图标展开抽屉并自动滚动到对应分组。抽屉浮在内容之上而非挤压内容；点击分支/标签、打开弹窗、点击遮罩或按 Esc 都会关闭抽屉。

Local Changes —— 逐文件或批量暂存 / 取消暂存 / 放弃，提交与 amend，逐文件差异。

All Commits —— 带 graph 轨道的提交历史，按消息或哈希前缀搜索，按作者与时间过滤；提交详情面板包含提交正文、变更统计、逐文件差异（统一 / 对照视图、图片对比、超大差异延迟加载）、文件树与文件内容。任意提交行可直接发起建分支 / 打标签 / 检出。

冲突 —— 合并或拉取产生冲突时出现横幅，列出冲突文件及各自的已解决状态；可在横幅上继续（git add -A 后提交）或中止。

输入框显示 zsh 风格的 <仓库名> (分支) 标记（可在设置中关闭；关闭后改为在 Git 标签旁显示状态圆点）。

设置

插件详情页有两个即时生效的选项：输入框分支标记开关、差异对比默认视图（统一 / 对照）。

配置

宿主配置写入选定 profile 的 cordis.patch.yml：

- id: git-plus
  config:
    timeoutMs: 8000
    networkTimeoutMs: 300000
    maxBytes: 4194304
    maxChanges: 1000
    refreshIntervalMs: 30000
    defaultDiffView: unified

• timeoutMs 限制单条本地 git 命令（默认 8000 毫秒）。
• networkTimeoutMs 限制网络类命令——fetch / pull / push（默认 300000 毫秒）。
• maxBytes 限制单条命令的 stdout 上限（默认 4 MiB）。
• maxChanges 限制变更列表长度（默认 1000）。
• refreshIntervalMs 是快照轮询间隔（默认 30000 毫秒）。

宿主配置变更后需要重启 dsh web。

开发

npm install
npm run check         # 类型检查 + 单元测试
npm run build         # 重新构建 lib/（宿主 + 客户端 bundle）
npm run deploy:local  # 把 lib/ 同步到本地 dsh profile

lib/ 随仓库提交，也是实际发布的内容；deploy:local 会把它同步到 ~/.dsh/profiles/web/node_modules/dsh-git-plus/lib 供本地调试。

发布：推送一条 chore(release): bump version to X.Y.Z 提交——workflow 会打 vX.Y.Z 标签、创建 GitHub Release（发布说明由 changelogithub 生成），并在配置了 NPM_TOKEN secret 的情况下发布 npm。

发布 npm（一次性配置）

npm 发布由仓库 secret NPM_TOKEN 控制开关——没配就只发 GitHub Release：

1. 建 token：npmjs.com → 右上角头像 → Access Tokens → Generate New Token。用 Automation（classic token），或 scope 限定到 dsh-git-plus 包且有读写权限的 Granular Access Token。建完立刻复制——只显示一次。

2. 用 GitHub CLI 加到仓库：

   gh secret set NPM_TOKEN --repo bitxeno/dsh-git-plus
   # 按提示粘贴 token，然后验证：
   gh secret list --repo bitxeno/dsh-git-plus

3. 之后正常发版即可自动发布（正式版打 latest 标签，带 - 的预发布打 next）。

注意：npm 包名必须是没被占用的（首次发布即创建，可先本地 npm publish --dry-run 验证）。轮换 token 时去 npmjs.com 重新生成再更新 secret 的值。