前言¶
在 DeepSeek Harness（DSH）里做智能体或项目开发时，工作区往往就是一个 Git 仓库。若要在浏览器里看分支、提交历史和变更预览，常见做法是切到终端或另开 IDE 的 Source Control 视图，视线和会话上下文会来回跳。DSH 社区把能力拆成插件；dsh-web-git-sidebar 面向 Web 配置档，把接近 VS Code 风格的 Git 面板放进左侧栏，并在底部提供随当前会话显示的快捷入口，减少「为了看 Git 而离开 Harness」的次数。
这是什么¶
DSH Web Git Sidebar（npm 包名 dsh-web-git-sidebar，维护者 RaditPasya）是 DSH 的 Web 客户端插件：在左侧栏提供 Git 图标与完整面板，并在 Settings 上方提供常驻的 Footer dock。README 强调操作在本地完成——No telemetry. No cloud. Just git. 插件要求 DSH >=0.2.0-rc.2，平台为 web；社区目录分类为客户端。许可证为 MIT。
核心功能¶
下面介绍 README 中已列出的能力，均可在安装后于 Web UI 中直接使用。
分支与同步状态¶
Branch switcher 支持搜索、切换与创建分支。列表会用符号表示与远端的关系，例如 ↑N ↓M 表示领先/落后、✓ 表示已同步、● 表示仅存在于本地。
提交图与预览¶
Commit graph 用 SVG 绘制分支线与合并曲线，合并点有环状标记；点击某一行可展开详情。Commit preview 展示该提交涉及的文件（新增/修改/删除）、增删行数、完整提交说明、作者与时间；悬停行可快速浏览摘要。Who’s who 为不同作者分配不同颜色，便于在长历史中扫视贡献者。
Footer dock¶
在侧边栏底部、Settings 上方有一个 始终可见 的分支下拉与最近提交条。它会 跟随当前打开的会话；在非 Git 工作区会自动隐藏。可点击标题折叠；拖动顶边（或聚焦后用方向键）调整高度，尺寸会被记住。
Pull / fetch 与性能¶
Pull / fetch 合并为一个按钮：已与远端同步时执行 fetch；落后时尝试 fast-forward，并反馈执行结果。状态、分支与图数据通过 一次批量 host 调用 获取并缓存，配合骨架屏，避免面板空白闪烁。每个 host 侧 Git 命令都有超时；仓库卡住时会报错而不是一直挂起面板。
安装与启用¶
安装命令来自项目 README，需使用 web 配置档：
dsh plugin --profile web add dsh-web-git-sidebar
安装后 重启 Web UI 一次（以加载新的 host 路由），再刷新页面，左侧栏会出现 Git 图标。
若要在本地改插件源码并联调，README 提供了 link 方式（需自行 clone 仓库后 link，此处不展开 clone 步骤；完整命令见 GitHub README）。
典型用法¶
- 在已绑定 Git 工作区的 Web 会话中，点击左侧 Git 图标，打开完整面板：切换或创建分支，在提交图中点选某次提交查看文件级预览。
- 无需打开完整面板时，使用底部 Footer dock 的分支下拉与最近提交列表；在非 Git 目录下 dock 不会显示。
- 需要与远端对齐时，在面板中使用 Pull / fetch 按钮，根据当前同步状态执行 fetch 或 fast-forward。
本地开发插件时，README 给出的构建与校验流程如下（供维护者或贡献者参考）：
pnpm install
node scripts/build.mjs
开发构建可读输出时使用 MINIFY=0 node scripts/build.mjs。link: 安装后改 client bundle 刷新即可；改 src/host/ 或 src/index.ts 需重启 DSH。
适用场景与注意¶
适合谁： 主要在 DSH Web UI 里工作、又希望分支、提交图和变更预览与对话/会话同屏的开发者；偏好本地 Git、不希望面板依赖云同步或遥测的场景。
环境与权限： 插件通过 DSH host 在工作区执行 Git 命令，与当前 DSH 进程权限一致。安装前建议在 GitHub 仓库 查看源码与 MIT 许可证，确认符合你的安全与合规要求。Node 引擎要求见 package.json（^22.19.0 || >=24.0.0）。
生态说明： DSH 采用「一切皆插件」的扩展方式；SkillHub 插件目录 为社区站点，与 DeepSeek / 幻方无官方从属关系，本文安装与功能描述以仓库 README 为准。
结尾¶
dsh-web-git-sidebar 把分支切换、彩色提交图、逐提交预览和 Pull/fetch 收进 Web 左侧栏与底部 dock，让 Git 状态留在你正在用的 Harness 界面里。进一步了解可访问社区目录页与源码仓库：
- 目录页：https://www.skillhub.cn/plugins/RaditPasya/dsh-web-git-sidebar
- GitHub：https://github.com/RaditPasya/dsh-web-git-sidebar
