← Back to home@wanyexin1998

dsh-workbench

Community-maintained source preview for two-Pane DeepSeek Harness Web workflows

Stars
1
Language
TypeScript
Created
Aug 26, 2026
Updated
Aug 26, 2026
Workspace
GitHub repo

Introduction

DSH Workbench 双 Pane 工作台视觉：两个独立会话面板、中央分隔线与两侧 Navigator 轨迹

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

简体中文 · English

状态：源码预览 版本：0.2.0-rc.1 Session Presentation：protocol 2 可见 Pane：2 许可证：MIT

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

[!TIP] 一句话安装：复制下面整句发给 DeepSeek Harness

请从 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 和快捷键的验证结果。

它解决什么问题

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

能力用户体验
双 Pane同时查看和操作两个 Session；切换聚焦不会重新挂载另一侧
Pane 独立状态草稿、滚动位置、Navigator 和可选面板分别保留
Navigator按真实输入条目显示导航横线，悬浮预览并快速定位消息
全局快捷键简体中文 / English 名称随 Harness 全局语言切换，可修改和持久化
Pane-local 面板安装兼容包后，每个 Pane 可独立展开右侧、底部面板
安全降级Presentation protocol 不兼容时不启用双 Pane 容量

界面预览

双 Session Pane

DSH Workbench 浅色模式双 Pane 界面，分别打开 wyx_code 与 data-warehouse Session

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

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

DSH Workbench 快捷键设置页面，使用简体中文名称展示 Navigator、输入框、侧边栏、停止会话与关闭 Pane 操作

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

兼容性一览

组件是否必需当前支持说明
DeepSeek Harness必需fork codex/presentation-v2，固定提交 53015a6…提供 Session Presentation protocol 2
DSH Workbench必需0.2.0-rc.1最多两个可见 Pane
Better Sidebar可选fork 0.16.1，固定提交 91e772a…提供 Pane capability protocol 1
Panel Compatibility可选0.1.0-rc.1只连接显式兼容的面板提供方

完整 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、布局或样式。

快速开始

环境要求

  • Node.js ^22.19 或 >=24
  • pnpm 11
  • 已按固定提交构建的 Harness fork

构建并验证 Workbench

先从独立可信渠道获得并人工确认完整的 40 位 Workbench commit。不要把当前分支、短 SHA、普通 tag 或仓库自身的可变文档当作信任锚。

$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

成功后，dist/ 中会生成：

  • wanyexin1998-dsh-workbench-0.2.0-rc.1.tgz
  • wanyexin1998-dsh-workbench-panel-compat-0.1.0-rc.1.tgz
  • release-manifest.json
  • SHA256SUMS

release:check 会执行隐私/密钥扫描、发布契约校验、类型检查、187 项测试、依赖审计、干净重建、生成代码扫描、TGZ 打包和 SHA256 校验，不会执行 npm 发布。

完整安装顺序、Harness fork 构建方式和可选面板接入步骤见 docs/INSTALL.md。

交互约定

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

可选：Pane 独立面板

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

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

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

安全与隐私

  • 不新增 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        # 安全边界

文档导航

想了解文档
完整安装步骤docs/INSTALL.md
产品行为与边界docs/PRODUCT_CONTRACT.md
版本兼容关系docs/COMPATIBILITY_MATRIX.md
已知限制docs/KNOWN_ISSUES.md
卸载与残留状态docs/UNINSTALL.md
安全声明docs/SECURITY_STATEMENT.md
参与贡献CONTRIBUTING.md

常见问题

必须安装 Better Sidebar 吗？

不需要。Better Sidebar 和 Panel Compatibility 只负责可选的 Pane-local 右侧/底部面板；双 Pane、Navigator 和快捷键不依赖它。

可以同时打开 5 个 Pane 吗？

当前公开契约最多为两个可见 Pane。扩展到 5 个需要重新设计布局、容量与性能验收，不属于 0.2.0-rc.1。

为什么不能直接使用原版 Harness？

本版本依赖 Session Presentation protocol 2、稳定的 visible / focused 状态和每个 Pane 独立的 SessionProvider。原版 0.1.1-rc.2 尚未提供这些接口。

项目声明

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

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

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