前言¶
在 DeepSeek Harness（DSH）里用 Web GUI 驱动智能体改代码时，常见做法是始终在同一个本地目录上操作：并行任务容易撞分支，要看 diff 往往要切终端或另开标签页，提 PR、对照 issue 也要来回切换工具。若你已经在用 DSH 的 dsh --profile web，又希望把 worktree、侧栏状态、整页 diff 和 GitHub PR/issue 引用收进同一浏览器标签页，社区插件 dsh-better-workspaces（npm 包名 @ds-hu/dsh-better-workspaces）针对的就是这一类流程。下面按「是什么 → 能做什么 → 怎么装 → 怎么用」说明，事实均来自 GitHub 仓库 README 与包元数据。
这是什么¶
dsh-better-workspaces 由维护者 ds-hu 发布，分类为 DSH 客户端插件：在 DeepSeek Harness Web GUI 中增强 Git 工作区能力，包括 worktree 创建与切换、侧栏 Git 状态徽章、文件与 diff 对话视图，以及类似 paseo 的 PR 相关操作。README 用一句话概括其目标：在 Web GUI 内完成 git worktree、完整 diff 检视、Pull Request 与 issue 引用，让每个任务拥有独立分支与目录，无需频繁切标签页或开终端。
插件当前在 GitHub 上约有 5 个 star；许可证为 MIT。技术文档见仓库内 docs/TECHNICAL.md 与 docs/adr/。
核心功能¶
以下能力均来自官方 README 的功能列表，按使用路径归纳。
1. Composer 上方的工作区模式¶
在提示框上方可在 Local 与 New worktree 之间切换：简单就地修改用 Local；需要独立分支与隔离目录的任务切换到 New worktree，降低并行任务互相干扰。
2. 从分支或 PR 快速创建 worktree¶
可输入分支名，或用界面上的随机生成（dice）。worktree 可基于任意本地分支、远程分支或开放的 Pull Request。点击 Create 后会创建隔离工作区并立即准备好会话。
3. 侧栏会话状态与 diff 体量¶
侧栏每个会话卡片显示当前活动分支与 diff 统计（例如 +11 −3）。若存在开放的 PR 或正在运行的 CI 检查，状态会显示在同一行，无需在终端执行 git status 才能感知概况。
4. 侧栏内整页 diff 检视¶
点击 ± 徽章打开 diff 抽屉。可在未提交变更、当前会话变更、任务范围或相对 base 分支的比较之间切换；支持按 hunk 展开、就地编辑文件、查看近期提交。
5. 不离开页面的 Git 操作¶
在 diff 视图中可直接执行 Commit、Pull、Push、打开 PR、merge、从 base 更新或丢弃变更；不适用的操作会说明所需前置状态。
6. 将 GitHub PR 与 issue 挂到提示词¶
Composer 旁的 GitHub 按钮会列出仓库中开放的 PR 与 issue，选中即可附加到当前提示。
7. 紧凑引用芯片与完整上下文¶
输入框内以紧凑芯片展示引用；发送时自动展开为完整标题、issue/PR 正文、分支信息与 URL，便于智能体获得准确上下文。
README 注明：worktree、侧栏徽章与 diff 检视不依赖 GitHub CLI；已认证的 gh 用于 PR/issue 选择器等能力。
安装与启用¶
官方安装命令（npm）如下。安装后需重启一次 dsh --profile web 以生效。
dsh plugin --profile web add @ds-hu/dsh-better-workspaces
也可在 DSH Web GUI 中安装：
- 侧栏打开 Plugins。
- 点击 Add plugin。
- 输入
@ds-hu/dsh-better-workspaces，来源选 Official npm registry。 - 点击 Install，完成后 Enable now；若提示重启，则重启
dsh --profile web。
环境要求¶
- DeepSeek Harness： ≥ 0.2.0
- Node.js： ≥ 20.19
- 工具：
git、pnpm（需在PATH中） - GitHub CLI（可选）： 已认证的
gh用于 PR/issue 选择器；其余 Git 增强功能可不装。
README 说明兼容 Linux、macOS 13+、Windows 10+，且操作均在当前浏览器标签页内完成。
插件以 DSH 客户端形式注入 Web 平台（package.json 中 dsh.client.platform 为 web），安装前建议自行查看 源码与许可证，并理解插件随当前 dsh 进程权限执行 Git 与网络相关操作。
典型用法¶
README 给出的 Quick Workflow 可照此复现：
- 启动会话： 在 DeepSeek Harness 中打开任意 git 工作区。
- 选择范围： 快速就地编辑选 Local；需要隔离分支选 New worktree。
- 开发与审查： 用 GitHub 选择器引用 issue，通过侧栏徽章查看进度，点
±做逐行 diff 审查。 - 交付： 在 diff 视图中 Commit、Push 或直接打开 Pull Request。
适用场景与注意¶
适合谁： 已在 DSH Web GUI 中开发、希望用 worktree 隔离并行任务、并在同一界面完成 diff 审查与常见 Git/GitHub 动作的团队或个人。
生态说明： DSH 采用「一切皆插件」的扩展方式；社区目录站点（如 SkillHub 上的插件页）为独立收录，与 DeepSeek / 幻方无官方从属关系，本文不以「官方应用商店」表述。
安全与权限： 安装第三方插件前请阅读仓库 docs/TECHNICAL.md 中的安全模型说明；所有 Git 与可选 gh 调用发生在本机 DSH 进程上下文中。
结尾¶
dsh-better-workspaces 把 worktree 切换、侧栏 Git 徽章、整页 diff 与 PR/issue 引用收敛到 DSH Web GUI，减少在终端与浏览器之间来回切换。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。
