README.md

面向 DeepSeek Harness Web 的双 Pane 工作台：并行处理两个 Session，并为每个 Pane 提供独立导航、快捷键与可选侧边面板。

简体中文 · English

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

它解决什么问题

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

界面预览

双 Session Pane

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

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

快捷键名称跟随 Harness 全局语言切换；冲突、浏览器保留键和持久化状态会在设置界面中明确显示。

兼容性一览

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

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

快速开始

通用插件（stock Harness，默认）

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

分屏（bootstrap，一条命令）

想用分屏，按你的平台复制运行下面这一条命令（与官方 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.2'; 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.2'; 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

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

请从 https://github.com/wanyexin1998/dsh-workbench 安装 DSH Workbench：首先向我索取并确认一个从独立可信渠道获得的完整 40 位 Workbench commit，若我未提供则停止；要求目标目录不存在，使用 git clone --no-checkout 后 checkout --detach 该提交，每个 Git 命令失败都立即停止，并验证 detached HEAD、完整 clean worktree 以及 git rev-parse --verify HEAD 与输入提交的大小写无关精确相等；只有全部验证成功后才读取仓库中的执行性说明并运行 pnpm install --frozen-lockfile 和 pnpm release:check，将生成的 Workbench TGZ 安装到 web profile；仅当我已安装兼容的 Better Sidebar fork 时再安装 Panel Compatibility，不要自动安装或替换第三方插件，不要发布 npm，最后报告实际提交、TGZ SHA256 以及双 Pane、Navigator 和快捷键的验证结果。

$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 独立面板

需要每个 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 提供三项动作：

• 添加到对话：把选区作为结构化 reference 加入来源 Pane 的 composer；保留普通草稿，可聚合多段并附加评论，不自动发送。原版 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，不会静默删除。

三种模式的边界

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

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

不想要它时，删除 ~/.dsh/.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、Navigator、快捷键、同工作区提醒
└─ 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。