dsh-workbench
看板由你定义。复杂操作,交给 agent。
平台越来越多,工作流越来越碎。
工作台只取所需,收进一屏:左栏项目与会话,中间常驻对话,右侧一块轻交互看板。
读取、编排与交付,交给 agent。动手之前,先问你。
An agent workbench — you shape the board, the agent does the work.
30 秒开始 → · 为什么是它 · 三种装法 · 看板如何定义 · 常见问题

平台在扩张,专注在流失
| 日常 | 代价 |
|---|---|
| 在多个平台间登录、查找、比对 | 上下文反复重建,思路一再中断 |
| 功能越堆越多,日常只用两三处 | 菜单、加载、通知,都是干扰 |
| 想拼一个自己的视图 | 等排期,或导出表格手工拼 |
| 想让 AI 参与读取与操作 | 接口不开放,AI 只能停在建议层 |
| 想追溯一次变更 | 记录散落各平台,难以对齐 |
取。汇。通。
| 工作台做的 | 化解 | |
|---|---|---|
| 取 | 以模块为界。缺陷、构建、发布、分析,按需而装 | 功能过载 → 只留所需 |
| 汇 | 跨平台数据,汇入同一张看板。按项目开,按你的顺序排 | 多平台 → 一屏 |
| 通 | 即使平台不提供接口,也能读取;写入走看板动作或 agent 工具,留痕可查 | 封闭 → AI 进入工作流 |
平台还是原来的平台。账号、权限、数据,都不迁移。工作台只做一件事:把所需收进一屏,把复杂操作交给 agent。 平台越封闭,这条路越有价值:数据从你已登录的浏览器里来,动作由看板或 agent 发起,写入都有记录。谁改的、改了什么,查得到。
不是传统看板。也不是聊天框。
| 传统看板 | 聊天框 | 工作台 | |
|---|---|---|---|
| 看板谁定 | 厂商预设,增项等排期 | 没有看板 | 由你定义。缺什么,让 agent 造 |
| 谁动手 | 你逐项操作 | agent 只给建议 | 单步动作你按;复杂操作 agent 执行。写入都有记录 |
| 结果在哪 | 另一个窗口,等刷新 | 散在对话记录里 | 同屏右栏,即时更新 |
| 边界 | 写操作散在按钮里 | 执行过程不可见 | 轻交互界面。写入留痕 |
看板轻交互,不是能力缺失。是产品判断:轻交互留在看板,复杂操作交给 agent。
看板由你定义。五个动作。
| 动作 | 你做什么 |
|---|---|
| 装 | 装、升、卸模块。装于本机,所有项目共用。 |
| 开 | 每个项目,开自己需要的卡片。 |
| 排 | 拖动,调整顺序。也可以让 agent 来。 |
| 配 | 每块卡片,都有它的设置。 |
| 造 | 没有的视角,让 agent 现场造。过门禁,再上板。 |
自定义,不等于随意。看板轻交互。写入都有记录。
和 agent,一起工作。三个同。
| 同什么 | 意味着 |
|---|---|
| 同屏 | 对话、卡片、详情,并排。 |
| 同事实 | agent 读得到看板数据。哪张卡会变,它知道。 |
| 同权限 | 写入走看板动作或 agent 工具。谁改的,查得到。 |
适合:每天在多个平台间往返的人。每个平台只用两三处功能的人。想让 AI 接手操作,又不想放弃审批与追溯的人。想为团队造一个内部工作台的人。
一次交代,四拍。
| 拍 | 发生什么 |
|---|---|
| 交代 | 「整理今天的发布风险。把构建卡片放到最前。」 |
| 执行 | agent 读缺陷、查构建、写总结。挪卡片前,先问你。 |
| 看见 | 右栏卡片与顺序,当场更新。 |
| 留下 | 调了哪些工具,改了什么,都在对话里。 |
三种装法
| 对比项 | 独立实例(推荐) | 装进 dsh web |
Desktop |
|---|---|---|---|
| 长什么样 | 自己的 :3081 与 profile |
就在 dsh web 里多一列看板 |
就在 DeepSeek Harness.app 里多一列看板 |
| 数据 | 会话 / 项目 / 附件跟 web 共用,设置各一份 | 沿用当前会话 | 沿用 Desktop 的会话 |
| 适合 | 想并行、想独立一份设置、想折腾 | 只想多一列看板 | 平时就在 Desktop 里 |
30 秒开始
前置:
| 要有 | 为什么 |
|---|---|
dsh(≥ 0.2.1-rc.5) |
本体;更旧的会被拒绝 |
| Node + pnpm | 安装与插件命令需要 |
| Chrome / Edge / Brave / Chromium / Vivaldi | 面板要借你浏览器里的登录状态读数据;第一次打开时在里面装一次 OpenCLI 扩展 |
可选:跑过一次 dsh web |
想继承它已有的设置 / 插件时;没有也能建 |
# 交互式:问来源、名字、要不要复制设置
npx @dsh-workbench/core create
# 或直接建默认的 workbench 实例(可重复跑)
npx --yes @dsh-workbench/core@latest setup
npx @dsh-workbench/core
打开 http://localhost:3081。原来的 dsh web 继续用 :3080;会话、项目和附件是同一份,
设置与插件各一份。
第一次打开还要装一次浏览器扩展
工作台会自己装 opencli 的隔离运行时,但浏览器里的 OpenCLI 扩展要你装一次 —— 面板读的是 你浏览器里的登录状态。用 Chrome / Edge / Brave / Chromium / Vivaldi 打开 OpenCLI(Chrome 应用商店) 装好、确认启用、浏览器保持开着,回「准备工作台」那一屏点「重试」。不装也能点「先进入工作台」, 只是要靠登录状态的面板取不到数据。Desktop 的这一屏还多一个「打开浏览器」。
全局装过也可以:npm i -g @dsh-workbench/core,然后直接 dsh-workbench。
换实例 / 端口:
npx @dsh-workbench/core --profile wb2
WORKBENCH_PORT=3091 npx @dsh-workbench/core
装进你现在的 dsh web
不想多一个实例、端口、进程:
dsh web侧栏 Plugins → Add plugin- 填
@dsh-workbench/core,Install → Enable now - 刷新页面
装在你当前环境里:会话、存储、附件接着用,不另开一份。之后和独立实例一样用; 细节见 详细用户指南。
装进 Desktop(DeepSeek Harness.app)
- 侧栏 Plugins → Add plugin
- 填
@dsh-workbench/core,Install → Enable now - 重开窗口 / 刷新
Desktop 用自己那份配置,不要跑 setup —— 那会另建一个实例。
装好后模块市场、看板、设置都在,会话沿用 Desktop 的。
Desktop 里个别浏览器调试能力不可用;网页浏览与录制照常。 装模块 / 更新工作台遇到权限或重启提示,退出并重开 Desktop;仍有问题看 packages/core/README.md 的常见问题。
三种装法装完后都一样:第一次打开要装一次 OpenCLI 浏览器扩展,面板才有数据(见上面的说明与「第一次打开」)。
第一次打开
- 首次启动会自己准备运行环境(opencli 的隔离运行时在
~/.dsh/workbench/opencli),不改你本机已有的工具配置。 - 浏览器里要装一次 OpenCLI 扩展,并保持浏览器开着;「准备工作台」里「连接浏览器」那一行显示已连接才算通。
- 需要登录的平台按卡片提示登录;回来点「重试」。
- 右侧先是一块空看板:去模块市场装,或让 agent 装。
- 失败会说明原因和下一步,不留白屏。
模块按需安装
五大动作里的「装」和「造」都在这里:缺陷、构建、分析…在「工作台模块市场」装 / 升 / 卸, 或者直接让 agent 代劳。工作台本身不带业务模块,装什么有什么;装在同一台机器上的模块, 所有项目共用。
想做自己的?开 DIY 模式,让 agent 现场做一个并装上——不用先学一套框架。 具体做法见 模块 DIY 指引。
数据和设置
- 会话、项目、附件:三种装法共用一份(都在
~/.dsh下)——在:3081里接着 web 的对话往下说,不用搬。 从 1.0.0 之前的独立实例升上来时,旧数据不会自动并:先退出所有 dsh,再跑dsh-workbench migrate,或到模块市场「工作台」那一行点「迁移旧数据」。这条提示是非硬性的,点「不再提醒」只收起提示,不会删旧数据。 - 设置与插件:独立实例是单独一份;装进
dsh web/ Desktop 就用它们自己的。独立实例可以从dsh web同步已配好的行。 - 运行时的工具:opencli、工坊、模块市场仍按 profile 各一份,互不打扰。
升级与卸载
- 升级:重跑
npx --yes @dsh-workbench/core@latest setup(可重复跑),重启工作台。旧实例的旧会话 / 项目不自动并,需要时跑dsh-workbench migrate。 - 插件页 / Desktop:在市场里更新,提示重启时重开。
- 卸载:插件页移除;独立实例再删
~/.dsh/profiles/workbench与~/.dsh/workbench(会话 / 项目 / 附件在~/.dsh下,不跟着删)。
常见问题
| 症状 | 怎么办 |
|---|---|
| 启动被拒,说 dsh 太旧 | npm i -g @deepseek-ai/dsh@latest,再重启工作台 |
:3081 被占 |
WORKBENCH_PORT=3091 npx @dsh-workbench/core |
| 左栏恢复出厂、右侧看板消失 | 插件被关了;Settings → 插件把 @dsh-workbench/core 拨回来,进不去就按 Meta+, |
| 自检说浏览器没连上 / 看板取不到数据 | 装一次 OpenCLI 扩展并启用,保持浏览器开着,回「准备工作台」那一屏点「重试」;Desktop 可点「打开浏览器」 |
| 看板一直空着 / 一直转 | 先确认这个工作区装了模块、平台账号登了、浏览器连接通了;第一次加载可能要几秒 |
| 页面白屏 / 提示插件加载失败 | 多半是插件冲突;重启工作台、检查插件开关,仍不行去仓库开 issue |
更多文档
| 想了解 | 读 |
|---|---|
| 完整用户指南 / 首次打开 / 常见问题 | packages/core/README.md |
| 文档站(本地起一个看) | packages/docs/README.md |
| 从源码构建、门禁、提交 | CONTRIBUTING.md |
| 架构 / 模块协议 | ARCHITECTURE.md |
| 写一个模块 | 模块 DIY 指引 |
| 安全 | SECURITY.md |
参与开发
从源码构建、门禁与提交约定见 CONTRIBUTING; 架构与模块协议见 ARCHITECTURE;文档路由见 AGENTS。
License
MIT。随仓技能文件另见 THIRD-PARTY-NOTICES.md。
No comments yet. Be the first to write one.