dsh-workbench

面向 DeepSeek Harness Web 的双 Pane 工作台：并行处理两个 Session，配合全局快捷键、划词批注与可选的 Pane-local 侧边面板。

简体中文 · English

[!IMPORTANT] 当前版本是 0.2.0-rc.6 源码预览，不是即装即用的 npm 正式版。分屏能力依赖固定版本的 Harness fork；Better Sidebar 及其兼容包完全可选。本项目不会自动安装、更新或修改任何第三方插件。

[!TIP] 一句话安装（Release-first）：复制下面整句发给 DeepSeek Harness Agent

请安装 DSH Workbench。先检查当前 Harness：兼容双 Pane 就直接安装；不兼容时保留通用插件功能，并告诉我如何并行安装不覆盖官方 Harness 的自装补丁路径（bootstrap）。若沙箱不能写入 DSH_HOME，只给我一条最终终端命令。

完整判定规则与命令见 docs/INSTALL.md。v0.2.0-rc.6 GitHub Release 已发布，通用插件与分屏 bootstrap 两条路径均可直接使用；当前状态仍是 0.2.0-rc.6 源码预览（见 release-contract.json），不是 npm 正式版。想自己审计源码可用下方「高级：从源码构建」。

它解决什么问题

DeepSeek Harness 默认以单一当前 Session 驱动界面。DSH Workbench 在不复制 Conversation、不修改 Agent loop 的前提下，为 Web 端增加两个稳定、彼此独立的 Session Pane。

界面预览

双 Session Pane

两个 Session 使用独立的标题、工作区、模式、输入框和 Pane 面板控制；中央分隔线保持各自的 SessionProvider 生命周期。

跟随全局语言的快捷键设置

快捷键名称跟随 Harness 全局语言切换，可以改键并持久化。

这张截图摄于 0.2.0-rc.2，之后设置页被精简过：每个动作下面那行灰色/黄色小字 （动作 id 与浏览器保留键提示）已经移除。按键、动作名与改键交互与图中一致， 少掉的只是那两行小字。截图待重拍。

兼容性一览

完整 SHA、分支和分发状态以 release-contract.json 为准。原版 Harness 0.1.2-rc.1 尚未提供此分屏接口；原版 Better Sidebar 0.16.1 也没有多实例 Pane capability。

没有安装 Better Sidebar 时，Workbench 的双 Pane 和快捷键仍可正常使用。Panel Compatibility 不会启动 Pane observer，也不会改变 DOM、布局或样式。

快速开始

[!NOTE] v0.2.0-rc.6 GitHub Release 已发布，附带两个 TGZ、两个分屏 bootstrap 脚本、SHA256SUMS 与 release-manifest.json；下面两条路径今天就能照抄执行。Release 产物经 SHA256 校验，不是 GPG 签名产物（release-contract.json 的 sourceVerification.signedReleaseAvailable 仍为 false）。release-contract.json 状态本身仍是 0.2.0-rc.6 / source-preview——这是既定的分发模型（只发源码与本地 TGZ，不发 npm），不代表安装路径不可用。想自己从源码逐字审计，仍可用下方折叠区「高级：从源码构建（审计路径）」（即 docs/INSTALL.md § Advanced: source build）。

先选路径。两条路径互相独立，按你现在手上有什么来选：

• 机器上已经装了 DeepSeek Harness（dsh --version 能打印版本），并且暂时不需要分屏 → 走 (a) 通用插件。
• 还没有 Harness，或者就是冲着分屏来的 → 走 (b) 分屏 bootstrap。它自带并构建固定版本的 Harness fork，不需要预先安装 dsh；代价是它跑在一个隔离的全新环境里。

(a) 通用插件（stock Harness，默认）

前提：dsh 命令已经在 PATH 上可用——这条路径面向已经在用 DeepSeek Harness 的人。先跑 dsh --version，能打印版本才继续；否则安装命令会在最后一步报 CommandNotFoundException / command not found，此时改走下面的 (b)。安装 Harness 本身属于上游项目的事，本仓库不提供。

从 GitHub Release 下载不可变的 Workbench TGZ、核对 SHA256、用 dsh plugin --profile web add file:<path> 安装（Windows 上安装路径不要含空格，否则会遇到 ENOENT，详见下方链接）。分屏（双 Pane）在 stock Harness 上不会激活——官方接口尚未合并（见 discussion #4718）；其余功能不受影响。装完后用 dsh --profile web --dump-config 确认输出里出现 @wanyexin1998/dsh-workbench。完整命令块、前提检查与「装完之后」见 docs/INSTALL.md § Quick Install。

(b) 分屏（bootstrap，一条命令）

不需要预先安装 dsh。按你的平台复制运行下面这一条命令（与官方 Harness 并存，零改动官方安装；要求 Node.js ^22.19/>=24、pnpm@11、git，Windows 需 PowerShell 7+）：

Windows（PowerShell 7+ / pwsh）：

& { $ErrorActionPreference = 'Stop'; $rel = 'https://github.com/wanyexin1998/dsh-workbench/releases/download/v0.2.0-rc.6'; Invoke-WebRequest "$rel/dsh-workbench-bootstrap.ps1" -OutFile dsh-workbench-bootstrap.ps1; Invoke-WebRequest "$rel/SHA256SUMS" -OutFile SHA256SUMS; $expectedLine = (Select-String -Path SHA256SUMS -Pattern 'dsh-workbench-bootstrap\.ps1$').Line; if (-not $expectedLine) { throw 'SHA256SUMS 中未找到 dsh-workbench-bootstrap.ps1 的记录，已中止' }; $expected = ($expectedLine -split '\s+')[0].ToLower(); if ($expected -notmatch '^[0-9a-f]{64}$') { throw "SHA256SUMS 中的哈希格式不合法：$expected" }; $actual = (Get-FileHash dsh-workbench-bootstrap.ps1 -Algorithm SHA256).Hash.ToLower(); if ($actual -ne $expected) { throw "SHA256 校验失败：期望 $expected，实际 $actual" }; pwsh -NoProfile -ExecutionPolicy Bypass -File .\dsh-workbench-bootstrap.ps1 }

macOS（Terminal）：

rel='https://github.com/wanyexin1998/dsh-workbench/releases/download/v0.2.0-rc.6'; if curl -fsSLO "$rel/dsh-workbench-bootstrap.sh" && curl -fsSLO "$rel/SHA256SUMS"; then expected=$(grep 'dsh-workbench-bootstrap\.sh$' SHA256SUMS | awk '{print $1}'); actual=$(shasum -a 256 dsh-workbench-bootstrap.sh | awk '{print $1}'); if [ -n "$expected" ] && printf '%s' "$expected" | grep -qE '^[0-9a-f]{64}$' && [ "$actual" = "$expected" ]; then chmod +x dsh-workbench-bootstrap.sh && ./dsh-workbench-bootstrap.sh; else echo 'SHA256 校验失败，已中止，不会执行未校验脚本' >&2; false; fi; else echo '下载失败，已中止，不会执行未校验脚本' >&2; false; fi

装完后用生成的启动器启动：Windows %USERPROFILE%\dsh-workbench\dsh-workbench.cmd，macOS $HOME/dsh-workbench/dsh-workbench。启动器把 DSH_HOME 固定在 <target>/home，所以第一次打开会是一个全新的空环境：没有历史会话、没有 Workspace，模型与供应商都要重新配置。这不是装坏了——隔离正是它不动你官方安装的原因，官方 Harness 的数据仍在它自己的 ~/.dsh 下。

脚本做了什么、如何卸载、哈希何时生效等完整说明见 docs/INSTALL.md § 分屏（bootstrap）。

$WorkbenchCommit = Read-Host '输入已从独立可信渠道确认的完整 40 位 Workbench commit'
if ($WorkbenchCommit -notmatch '^[0-9a-fA-F]{40}$') { throw 'Workbench commit 必须是完整的 40 位十六进制值' }
$WorkbenchCommit = $WorkbenchCommit.ToLowerInvariant()
if (Test-Path -LiteralPath 'dsh-workbench') { throw '目标目录 dsh-workbench 已存在；为避免执行旧工作树，请使用空目录重试' }
git clone --no-checkout https://github.com/wanyexin1998/dsh-workbench.git
if ($LASTEXITCODE -ne 0) { throw '克隆 Workbench 失败' }
cd dsh-workbench
git checkout --detach $WorkbenchCommit
if ($LASTEXITCODE -ne 0) { throw '检出 Workbench commit 失败' }
$ResolvedCommit = (git rev-parse --verify HEAD).Trim().ToLowerInvariant()
if ($LASTEXITCODE -ne 0) { throw '无法解析 Workbench HEAD' }
if ($ResolvedCommit -ne $WorkbenchCommit) { throw "Workbench commit 不匹配：期望 $WorkbenchCommit，实际 $ResolvedCommit" }
$HeadRef = git symbolic-ref -q HEAD
if ($LASTEXITCODE -eq 0) { throw "Workbench 必须处于 detached HEAD，当前为 $HeadRef" }
if ($LASTEXITCODE -ne 1) { throw '无法验证 detached HEAD' }
$WorktreeState = git status --porcelain=v1 --untracked-files=all
if ($LASTEXITCODE -ne 0) { throw '无法验证 Workbench 工作树' }
if ($WorktreeState) { throw 'Workbench 工作树不是 clean 状态' }
# WORKBENCH-SOURCE-VERIFIED-BEFORE-REPOSITORY-CODE
pnpm install --frozen-lockfile
pnpm release:check

交互约定

• 普通点击 Session：替换当前聚焦 Pane。
• Ctrl / Command + 点击 Session：在另一侧打开。
• 打开第三个 Session：替换当前聚焦 Pane，不增加第三个 Pane。
• 聚焦变化：只改变交互路由，不打开、关闭或重挂载面板。
• 两个 Session 使用同一工作区时：显示非阻断提醒；插件不提供文件写入隔离。
• 刷新页面：恢复一个 Pane；多 Pane 成员关系当前为进程内状态。

默认快捷键

Primary = macOS 上的 ⌘，Windows / Linux 上的 Ctrl。所有动作均可在设置页重新绑定、清除或禁用；下表为出厂默认值，与 packages/dsh-workbench/src/native-ux/client/shortcuts.tsx 逐一核对。

可选：Pane 独立面板

⛔ 本节当前不可用。 固定的 Better Sidebar fork 基于上一个上游基线构建， 在本版所钉的基线上加载即抛，整个 harness 起不来（不是侧栏降级）。 装了之后应用打不开的话：从 profile 里移除 dsh-better-sidebar 再重启。 详见 docs/KNOWN_ISSUES.md。下面的步骤保留原样， 等一个在当前基线上重建的 fork 提交被钉进契约后即可恢复。

需要每个 Pane 独立显示右侧或底部面板时，再安装：

1. 固定提交的 Better Sidebar fork。
2. @wanyexin1998/dsh-workbench-panel-compat 本地 TGZ。

兼容包只消费版本化 Pane capability 和公开的 data-session-pane* host marker，不会修补 Better Sidebar 私有 store，也不会推断未知 DOM。

随手问 / Workbench Ask

Ctrl+Shift+C（macOS 为 Command+Shift+C）打开一个使用 聊天模式 / Chat mode 预设的全新或当天最近空白会话。在 Workbench Edition 中，它会在来源 Pane 旁边打开并聚焦；已有两个 Pane 时，Workbench 先确认，再只替换非来源 Pane。原版 Harness 不支持双 Pane 时，动作仍可用，但会原位切换到聊天会话并只提示一次降级原因。会话优先归入标题为 chat 的 Workspace；没有该 Workspace 时使用来源会话所属 Workspace。没有可解析的 Workspace 时安全停止，不自动创建目录或 Workspace。

在一条已完成消息中选择文字后，Workbench 提供三项动作：

• 添加到对话：在正文里就地标出这段话，并立刻打开批注卡片让你写下想说的；composer 上只多一枚计数 chip，不重复贴一遍原文。保留普通草稿，可聚合多段，不自动发送。原版 Harness 也可用，细节见下方「划词批注」。
• 更多详情：从选区所在会话的已完成 Turn fork child，在第二 Pane 打开，并恰好发送一次带 reference-only boundary 的本地化解释请求。仅 Presentation protocol 2 可用。
• 在侧边聊天中提问：同样 fork child，但只放入带 boundary 的选区 reference 和空普通草稿；用户显式输入问题并发送前，不发生模型调用。仅 Presentation protocol 2 可用。

侧聊 child 继承父会话的 cwd、模型、预设、Workspace、工具与 approval 流程。它不是零工具聊天；任何工具副作用都是真实的。关闭 Pane 只关闭呈现，Session 继续保留在侧栏。fork 已成功但 Pane 或输入操作失败时，界面会报告保留的 child id，不会静默删除。

划词批注

「添加到对话」的完整动作链是：划词 → 点「添加到对话」→ 直接打字。

• 被引用的段落就地标出来：一层底色加下划线，右侧留白处放一枚 16px 的数字徽标。 正文不再被复制一份贴到 composer 上方，引用越多也不会把对话挤走。
• 加入的同一刻，批注卡片就在那段话旁边展开、光标已经在输入框里。写完点别处、按 Esc、或点保存都会存下来。
• 保存之后段落旁不留任何常驻浮层——常驻浮层的落点就在段落末行正下方，那里通常 是下一段正文。想再看那句批注有三条不遮挡的路：composer 上那枚 chip 展开的引用 列表（每行都写着批注正文）、把指针停在数字徽标上让标签临时浮出、或点徽标重新 开卡编辑。
• 发给模型的是纯文本：一行散文抬头（引用上文：），引用正文每行前缀 │， 你的批注单起一行 ↳。没有 XML 标签、没有 session id / 节点 key / 字符偏移， 也没有 HTML 转义——引用 Tom & Jerry 到模型那头仍然是 Tom & Jerry。

就地标注不修改 Harness 的 DOM。 底色与下划线通过浏览器的 CSS Custom Highlight API 绘制：Workbench 交给浏览器的是一个 Range，一个节点、一个属性都不往宿主 Conversation 里插。徽标、卡片、标签三层浮层都 portal 在 document.body 上， 用 0×0 的定位容器，不铺满屏幕、不拦截宿主的指针事件。

代价是这套 API 没有降级路径：不支持它的浏览器上底色画不出来，此时数字徽标、 引用列表与发送格式都照常工作，只是"看得见是哪一段"这件事没了（见 docs/KNOWN_ISSUES.md）。

三种模式的边界

聊天模式预设的安装与删除

安装 Workbench 后，Host 启动时会把 聊天模式 / Chat mode 预设写入 $DSH_HOME/.agent-presets/chat/（只创建、绝不覆盖；你删除后不会重建）。它是零工具预设：模型只对话，不读写文件、不执行命令、不加载项目上下文；模型与供应商仍按会话自由选择。实测示例的首轮输入为 181 token。

$DSH_HOME 未设置时才是 ~/.dsh/.agent-presets/chat/。走分屏 bootstrap 路径时不是这个位置：生成的启动器把 DSH_HOME 固定在 <target> 下的 home 目录，预设写在它里面的 .agent-presets/chat/（默认 target 为 Windows %USERPROFILE%\dsh-workbench、macOS $HOME/dsh-workbench）。

不想要它时，删除对应的 .agent-presets/chat/ 目录即可；Workbench 记录你的删除意图，不会重新写入。

安全与隐私

• 除聊天模式预设的一次性写入（只创建、绝不覆盖、尊重删除，见 docs/PRODUCT_CONTRACT.md）外，不新增 Host filesystem、subprocess、credential 或任意网络权限。
• 不在 Harness 自有存储之外持久化 Prompt、工具调用或 Session 内容。
• 两个 package 均为 private: true，防止意外 npm 发布。
• 仓库不包含 GitHub Actions；发布检查只在本地运行。
• 支持 GitHub Private Vulnerability Reporting。

安全问题请阅读 SECURITY.md，不要在公开 Issue 中提交凭证、私有 Session 内容、专有源码或可利用细节。

项目结构

packages/
├─ dsh-workbench/               # 双 Pane、快捷键、同工作区提醒
└─ dsh-workbench-panel-compat/  # 可选的 Pane-local 面板适配层
docs/
├─ INSTALL.md                   # 完整安装流程
├─ PRODUCT_CONTRACT.md          # 产品与运行时不变量
├─ COMPATIBILITY_MATRIX.md      # 精确兼容范围
└─ SECURITY_STATEMENT.md        # 安全边界

文档导航

常见问题

项目声明

DSH Workbench 是独立的社区维护项目，不是 DeepSeek 官方项目，也不代表 DeepSeek 或 Better Sidebar 维护者的认可。

Banner 中的鲸鱼标识取自 DeepSeek Harness 官方资源，仅用于说明产品兼容关系；DeepSeek 名称与标识的相关权利归其权利人所有。

本项目使用 MIT License。第三方归属与说明见 THIRD_PARTY_NOTICES.md。