前言¶
用 DeepSeek Harness（DSH）做智能体开发时，常见做法是：左侧 Web 对话，右侧再开 IDE 或终端查文件、跑命令、看 Git 状态。窗口来回切，上下文也容易断。
下面介绍 loadingvx 维护的 deepseek-harness-workbench-plugin（npm 包名 dsh-workbench-plugin）。它在 DSH Web UI 的 Conversation 里嵌入三栏工作台：左侧保留聊天，中间是编辑器与智能终端，右侧是文件树、Git、用量与 Ultra Slash。新建会话即可打开，不必先发第一条消息。
这是什么¶
dsh-workbench-plugin 是面向 DeepSeek Harness Web UI 的工作台插件。维护者为 loadingvx，GitHub 仓库约 26 stars。SkillHub 分类为「模型推理」。
插件通过 Cordis patch 注入前端模块，在浏览器内提供 CodeMirror 6 编辑器、本地 PTY 终端、Git 面板、API 用量视图，以及不中断当前轮次的 Ultra Slash 斜杠命令。许可证为 MIT。
界面布局¶
工作台采用三栏结构：
- 左侧：Conversation 聊天区
- 中间：编辑器（默认首 tab 为 Agent Control Plane）与 Smart terminal
- 右侧 dock：Files、Source Control、Usage、Ultra Slash
列宽可拖拽调整，双击分隔条可重置；各栏可折叠为图标轨。折叠状态、右侧 dock 当前 tab、Usage 固定位置会在全局记住，刷新或新建会话后仍保留。页头 Workbench 按钮可整体显示或隐藏工作台。
核心功能¶
Agent Control Plane¶
编辑器第一个 tab，默认开启，可在 Settings → Agent control plane 关闭。
Execution trajectory（默认页）按时间线展示用户消息、每轮 LLM 调用、工具执行与 Agent 回复，左侧鱼骨线区分类型，可展开查看完整 I/O。
Capabilities 列出当前会话 Agent 的模型、工具、prompt 分段、子 Agent 与会话旋钮，支持在线调整；约每 4 秒自动刷新，也可手动 Refresh 或 Clear all knobs。
Usage 用量面板¶
右侧 dock 的 Usage tab，或固定到左侧 Settings 按钮上方（折叠图标轨时显示紧凑条），用于查看：
- 官方 API 余额（币种随 API，CNY 显示 ¥，USD 显示 $）
- 本机观测支出（余额下降累计，充值不清零；非官网终身消费）
- 本会话 token（输入 / 输出 / 缓存命中 / 缓存写入 / 命中率）
- 当前上下文占用
状态栏 Feedback 左侧同步显示余额。点击 Official usage 打开 platform.deepseek.com/usage。
Ultra Slash¶
斜杠命令向下一轮模型注入指引，不中断当前 turn。在右侧 Ultra Slash tab 管理；聊天框输入 /，在底部「插件命令」分组选用。
内置命令（不可改名或删除）：
| 命令 | 作用 |
|---|---|
/steer |
注入指引 |
/new |
空白会话；/new <text> 以该消息开启新会话 |
/skill |
任务结束后保存到 .dsh/skills/ |
/docs |
任务结束后写入 docs/ |
/canvas |
任务结束后在 .canvas/ 创建或更新 Canvas |
自定义 /name 快捷键存于 ~/.dsh/ultra-slash/commands.json，本机所有会话共享，最多 40 条。
Canvas¶
Agent 写入的 Canvas 文件位于工作区 .canvas/*.canvas.tsx（不在 IDE 配置目录）。工作台对 TSX 转译后在浏览器挂载 React 组件，支持编辑 / 预览 / 分屏（类似 Markdown）。Agent 写入后自动以预览模式打开。发送 /canvas <topic> 可在不中断当前轮次的情况下引导模型。
工作区编辑器¶
CodeMirror 6，支持 JavaScript、TypeScript、JSX、TSX、JSON、HTML、CSS、Markdown、Python、XML、YAML 语法高亮。键位模式 Plain / Emacs / Vim，默认 Emacs（直接插入，非 Vim normal mode）。
另支持 Markdown 编辑 / 预览 / 分屏（含 Mermaid）、图片与表格预览（csv / tsv / xlsx）、Git diff 标签页、多文件 tab 与脏文件关闭确认。选中内容或整文件可通过 Add to chat 送入对话，无需复制粘贴。
Smart terminal 与 AI command assist¶
编辑器内嵌本地 xterm.js PTY，工作目录为当前 workspace。真实 shell 命令（含粘贴的 $ ls）直接执行；自然语言由 AI command assist 翻译后写入当前终端会话。
Alt + I或工具栏 ✨ 按钮：打开 AI 命令辅助Alt + J：新建终端 tab（各 tab 独立 PTY）- 问候、警告等说明性文字以不可执行形式写入，不会当作命令运行
- 可配置破坏性命令黑名单（仅限制助手写入的命令，用户手动输入不受限）
POSIX 侧支持 bash / zsh / sh / dash；Windows 优先 Git Bash，其次系统 PowerShell。
文件、Git 与 Add to chat¶
Files：树形浏览、过滤、隐藏文件、.gitignore 标记、新建 / 重命名 / 删除；可在外部编辑器（Cursor、VS Code 等已安装应用）打开。
Source Control：git status、暂存、提交（支持流式 AI 提交消息，模板可编辑）、fetch / pull / push（脏树、落后远程、detached HEAD 等会拦截危险操作，不支持 --force）、分支切换与合并、提交图（GRAPH）。对话侧提供 git_status、git_diff、git_log、git_branch、git_commit 工具。
Add to chat：从文件树拖入文件或 DevTools 网络请求；终端输出右键添加选中或近期输出（含 pwd / shell 上下文）；嵌入式浏览器点选页面元素。均以引用 chip 形式进入输入框，随下一条消息发送。
通知音效与其他¶
会话结束或等待用户（审批、计划确认、提问）时播放提示音。Settings 中可选 5 种内置 Web Audio 音效或上传自定义音频（mp3、ogg、wav、webm、m4a、flac，最大 50 MB），支持循环提醒（默认每 10 秒，直至处理）。
界面支持中文与英文；内置升级检查器；路径与错误中的 token 会被脱敏。
安装与启用¶
前提：已安装 DeepSeek Harness，且 dsh web 可正常启动。
- 安装插件（须指定版本；pnpm 11 对新版本有 24 小时延迟，省略版本可能装到旧版 0.1.0）：
dsh plugin --profile web add dsh-workbench-plugin@0.1.31
若仍因版本过新被拒绝，在 ~/.dsh/profiles/web/pnpm-workspace.yaml 添加后重试：
minimumReleaseAgeExclude:
- dsh-workbench-plugin
-
重启
dsh web。 -
打开 http://127.0.0.1:3080，进入 Conversation 并新建会话。工作台右侧立即出现，无需先发消息。
SkillHub / GitHub 源安装（使用已构建的 lib/，源码-only 提交会失败）：
dsh plugin --profile web add github:loadingvx/deepseek-harness-workbench-plugin
典型用法¶
固定用量面板：打开右侧 Usage，点击固定图标，面板移到左侧 Settings 上方，聊天时可持续查看余额与会话 token。
不中断轮次注入指引：模型仍在运行时，在聊天框选 /steer 或自定义 Ultra Slash 命令，文本排队到下一轮模型访问，无需点 Stop。
终端自然语言转命令：在 Smart terminal 按 Alt + I，输入「列出当前目录下所有 .ts 文件」，助手将翻译后的 shell 命令写入当前 PTY。
Canvas 原型预览：发送 /canvas 仪表盘布局，任务结束后 Agent 在 .canvas/ 写入 .canvas.tsx，工作台自动打开预览。
AI 提交消息：在 Source Control 暂存变更后，生成提交消息，文本流式写入提交框，确认后提交。
适用场景与注意¶
适合在 DSH Web UI 内完成对话驱动开发、希望同一界面内编辑代码、跑终端、看 Git 与 API 用量的用户。Agent Control Plane 适合调试多轮工具调用与在线调整会话旋钮；Ultra Slash 与 Canvas 适合长任务中追加指引而不打断当前推理。
安装前请注意：
- 插件以当前
dsh进程权限运行，终端与 Git 操作作用于工作区，安装前应阅读源码与 MIT 许可证。 - npm 当前 latest 为 0.1.31（包名
dsh-workbench-plugin）；SkillHub 目录页显示版本可能滞后。 - 0.1.1 不含升级提示器，需手动安装 0.1.31；之后版本可在 UI 顶部看到升级通知，终端会以
#注释形式给出安装命令。
链接¶
- SkillHub 目录：https://www.skillhub.cn/plugins/loadingvx/deepseek-harness-workbench-plugin
- GitHub：https://github.com/loadingvx/deepseek-harness-workbench-plugin
- npm：https://www.npmjs.com/package/dsh-workbench-plugin
