前言¶
在 DeepSeek Harness（DSH）桌面端里写代码、跑智能体会话时，仓库往往已经挂在宿主注册的 Workspace 上，但查看提交历史、对比差异、暂存提交和切分支仍要切到终端或外部 GUI。dsh-git-workspace 把「审查」收进右侧栏：历史、工作区更改、分支入口在同一套界面里完成，Git 命令由宿主通过 Workspace 与 subprocess 服务执行，浏览器侧不直接跑 shell。
下面介绍插件定位、能力、安装步骤和日常使用要点；事实以 GitHub 仓库 README 与包元数据为准。
这是什么¶
dsh-git-workspace（npm 包名 @monster-30cl/dsh-git-workspace，当前版本 0.1.0）是由 monster-30cl 维护的 客户端 类 DSH 插件。简介概括为：面向 DeepSeek Harness Desktop 的 Git 审查、工作区更改与分支管理界面。
插件启动时只读取仓库状态，不会自动改动工作区。未向会话模型注册工具，也不会自动拉起对话；仅在用户点击「AI 生成提交备注」时，才会把本次勾选文件的列表与差异发给宿主配置的默认模型。
核心功能¶
统一的「审查」页¶
右侧栏开始页进入「审查」后，可同时看到提交历史与工作区更改。提交侧支持：
- 搜索框按提交说明过滤；
- 作者下拉按提交作者过滤；
- 日期区间（可只选起始、只选结束或起止都选，按 Git 提交时间，起止日均含当天）与上述条件叠加或分别清空。
点选提交可查看文件列表、前后内容与补丁。代码区支持 Ctrl + 滚轮缩放文字（也可在设置里改附加按键，默认 Alt）；左右代码区默认横向、竖向同步滚动，标题栏按钮可开关两个方向的联动。
工作区更改与提交¶
「代码提交」区域支持提交、提交并推送、拉取、推送、搁置和回滚；勾选文件决定本次操作范围。提交或推送成功后，上半区历史会刷新并保留已有筛选；若提交成功但推送失败，仍会刷新本地提交记录。
未跟踪文件列表默认折叠，未跟踪项不能直接勾选提交；点文件右侧「＋」加入版本管理后才会进入「更改」列表并参与提交。回滚尚未提交的新增文件时，只取消版本管理、保留磁盘内容，文件回到未跟踪列表。
提交、提交并推送或搁置需填写备注；有上次成功操作的备注时可一键回填。备注窗口标题旁的星光图标可 AI 生成提交备注（基于勾选文件与差异，输出中文），使用宿主默认模型；生成不会改暂存区或自动提交。关闭窗口、改勾选或改备注会取消进行中的生成请求。
分支¶
会话头部分支名可切换本地或远程分支，菜单末尾可打开完整分支页。完整页支持选择 Workspace、刷新分支、新建分支、检出远程分支。「刷新」重读本地记录；「同步远端」执行 git fetch --all --prune，更新远端并清理已删除的远端跟踪记录，不删本地分支、不自动合并。
安装与启用¶
桌面端安装 不能 用 dsh plugin --profile desktop 改 Desktop 的保留 profile；应在桌面菜单「桌面插件…」里填入构建或下载得到的 .tgz 绝对路径 后执行安装。
从 GitHub 源码构建¶
需要 Node.js 22.19 或更高版本（package.json 中 engines.node 为 >=22.19.0）。
git clone https://github.com/monster-30cl/dsh-git-workspace.git
cd dsh-git-workspace
corepack enable
pnpm install
pnpm run check
pnpm pack
pnpm run check 会先 build 再 verify 面板接线。构建完成后，在「桌面插件…」安装框填入生成的 monster-30cl-dsh-git-workspace-0.1.0.tgz 的绝对路径。安装后启用「Git 工作区」插件并重启桌面端。
宿主须已为会话注册对应 Workspace；普通目录可打开界面，但 Git 操作会提示该目录不是工作树。
从 Release 安装¶
每个 v* 标签会附带 .tgz。下载后在「桌面插件…」中填入 tarball 绝对路径（例如 C:\path\to\monster-30cl-dsh-git-workspace-0.1.0.tgz）并安装。
典型用法¶
- 在右侧栏点「审查」，用搜索、作者、日期筛提交，点某次提交看 diff。
- 在「代码提交」区勾选要纳入的文件，填备注或点星光图标生成备注，再执行提交、推送或搁置等操作。
- 点会话头部分支名切换分支，或打开完整分支页做 fetch、新建与检出远程分支。
适用场景与注意¶
适合谁： 已在 DSH Desktop 里用 Workspace 管项目、希望少切终端完成 review 与日常 Git 操作的开发者。
安全与权限： 提交、推送、拉取、搁置、恢复与分支切换会修改共享 Workspace；分支切换前会请求确认。回滚未提交改动或删除搁置可能造成数据丢失，操作前核对勾选文件。Host 只接受已注册的 Workspace id，并把路径限制在该 Workspace 内。插件以当前 DSH 宿主权限执行 Git；安装前建议阅读源码与 MIT License（包内亦含源自 DeepSeek Harness 的 MIT 代码声明）。
AI 备注限制： 每次最多分析 60 个文件，长 diff 会截断，二进制仅提供文件信息；请求最长等待 90 秒，结果需人工核对。未配置默认模型时会提示原因，仍可手写备注。
兼容性： 当前构建面向 DeepSeek Harness Desktop 0.2.1-rc.3 的客户端服务与图标命名，并在兼容 DSH 环境中验收。依赖宿主的 Workspace、subprocess、Remote 与右侧栏客户端服务；不保证纯 headless 命令行 profile 能显示客户端界面。
生态说明： DSH 奉行「一切皆插件」；社区目录站点 Skillhub 插件页 为独立收录，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-git-workspace 把提交历史筛选、diff 阅读、工作区提交与分支管理收进 Desktop 右侧栏，Git 实际执行留在宿主 Workspace 边界内。需要安装包或源码时，可访问目录页 skillhub.cn/plugins/monster-30cl/dsh-git-workspace 与仓库 github.com/monster-30cl/dsh-git-workspace。
