前言¶
在 DeepSeek Harness（DSH）里用 AI 改 Markdown、再跑脚本生成 Word 或 PDF，流程上很像改代码：多轮、有产物、需要你点头。磁盘上往往只有一份会被覆盖的工作副本，中间版本同名消失；技能散在项目层、用户层和内置层多个目录；源文件改了却忘了重新导出，交出去的 docx 仍是旧正文。这三类问题都不缺工具单点解决，缺的是放进 Web 端、和对话并排看的一条线。
下面介绍社区插件 dsh-workbench（维护者 liiydong，分类：工作流）。它在 DSH Web 端增加「工作台」面板：迭代时间轴、技能库、文档源与产物配对，并可停到右栏，让对话留在中间、时间轴在右侧。插件为 DSH Web 插件，零依赖，以只读为主；本体写文件仅涉及审批、记一版、打开文件，以及记录器 CLI 写入同一对记录文件。
这是什么¶
dsh-workbench 给 DeepSeek Harness Web 端加一个工作台：把「AI 改 md → 生成 Word/Excel/PDF → 你审这一版」变成可见的时间轴（版本快照、带理由的审批、打开某一版、和上一版比正文差异、把漏记的产物收编成记录）。产线按最近动过排序，目录从「最近用过 / 已登记工作区」里选；左栏图标可显示「待我审」角标。另带命令行记录器，AI 每产出一版可顺手记一条，不必一直开着面板。
当前 package 版本为 0.7.0，许可证 MIT，要求 DSH 引擎 >=0.1.5-rc.1。
核心功能¶
迭代（默认页签）¶
时间轴按产线分组，产线内按天分节，一轮一行。目录不必手打：顶栏「最近用过…」下拉（最近打开过的目录 + DSH 已登记工作区），或填写路径后点 浏览…——本机有原生选择器则弹系统对话框，远程/SSH 等 browse 后端则使用插件内目录浏览器。
每轮展示时间、产物类型（Word / PDF / Excel）、摘要（来自记录或收编时的 note）、改自哪些 md、审批状态。悬停可看到摘要卡（备注、体积、生成命令、快照路径、历史审批意见）。点开一轮可 通过 / 要改 / 重置为待审，理由写入 decisions.jsonl 并在后续悬停中保留。同一行可 打开这一版（快照）、打开成品（产线目录里会被覆盖的最新文件）、在文件夹里 选中文件；底部 和上一版比 对两版快照正文做段落级 diff（新增绿、删除红，段内词级高亮），pdf/pptx/老 xls 等暂不支持则按钮置灰并说明原因。
产线头部展示 .versions/ 快照数量与占用空间，以及记录文件中坏行/缺 id 的提示。顶栏可按待我审 / 已通过 / 要改、产线、类型筛选。目录变化可通过自动档位（默认 10 秒，可改 30 秒 / 1 分钟 / 关）探测，提示「多了 N 轮」后由你决定是否刷新，不擅自改当前视图。本机若装有 doc-iteration-control 等迭代流程技能，顶栏会出现 迭代流程，一键打开技能全文。
记录格式与记录器¶
每个产线目录下典型结构：
产线/
├── *.md
├── 论文全文.docx ← 工作副本，每次覆盖
└── .versions/
├── produced.jsonl ← 产出记录
├── decisions.jsonl ← 审批记录
└── …快照文件…
日常应由 记录器 或面板 记一版 追加 produced.jsonl，并复制快照到 .versions/（非硬链接，避免覆盖工作副本时旧快照被改写）。at 取产物 mtime；审批以同一 id 的最后一条 decisions.jsonl 为准。
命令行记录器与面板共用 lib/record.js 实现，示例：
node bin/record.mjs "D:\论文\毕业论文" 论文全文.docx \
--summary "第3章：修正乙苯转化率 0.62→0.58，重算全表" \
--sources "03-第三章-物料衡算.md" \
--tool "python thesis_docx.py"
不需要 DSH 或面板常驻；--json 便于 Agent 解析。同一版重复记会被拒绝；记录损坏仅剩快照时可复用快照补记（自愈）。
未入记录（补漏）¶
顶栏 未入记录 用于扫描「磁盘上有产物、记录里没有」的文件，并可从 DSH 会话日志保守推断生成命令与改过的 md。收编时你补一句说明，复制快照并追加一行；已被记录引用则 409 不覆盖。
技能库¶
先读 ctx.skills 注册表，再扫 ~/.agents/skills、~/.dsh/skills、项目 .agents/skills（一层、SKILL.md），避免 HTTP 路由无会话上下文时目录残缺。支持按名称/描述/触发词搜索与来源过滤，点选可看 SKILL.md 全文与路径。
文档配对¶
选定目录后扫描，按主干名配对 md/tex/qmd 等源与 docx/pdf/xlsx 等产物。状态包括：产物过期（产物比源旧）、无源产物、未生成产物、已同步。源或产物变化时同样可通过自动档位提示后手动刷新。
界面与入口¶
左栏 工作台 图标打开主区域三页签面板；可将面板 搬到右栏（⇥），与中央对话并排。标题行 ← → 为面板内浏览历史；← 返回对话 切回会话不改当前会话。左栏图标数字为待审轮数（0 不显示）。卸载插件后各入口一并消失；无右栏服务或未装 dsh-better-sidebar 时仅少对应入口，不影响其余功能。
安装与启用¶
从本机源码 link 安装（改代码后重启宿主即可）：
dsh plugin --profile web add link:/绝对路径/dsh-workbench
或从 GitHub 安装：
dsh plugin --profile web add github:liiydong/dsh-workbench
装完必须重启 dsh web：客户端 bundle 在组合阶段快照进内存，仅刷新页面不够。
卸载：
dsh plugin --profile web remove dsh-workbench
典型用法¶
1、在产线目录配置 md 源与固定文件名的 docx/xlsx 等工作副本，生成脚本跑完后执行 node bin/record.mjs …（或由迭代技能在流程末尾调用），使 .versions/produced.jsonl 与快照同步增长。
2、打开 DSH Web，点左栏工作台，在下拉或 浏览… 选中产线目录，在 迭代 页按状态筛选待审轮次，悬停看摘要，打开快照或 和上一版比 后给出通过/要改及理由。
3、需要与 AI 并排改稿时，点 搬到右栏，中间继续对话，右侧扫时间轴；若 md 已改但未重新导出，切到 文档 页看「产物过期」项并排期重生成。
4、在 技能库 查本机技能全文；若已装文档迭代类技能，用顶栏 迭代流程 对照规程，避免漏记 --summary / --sources。
适用场景与注意¶
适合长期用 DSH 做多轮文档/报告迭代、需要保留快照与审批轨迹、或要统一查看技能与 md–产物是否同步的开发者。插件以当前 dsh 进程权限读目录与会话日志；安装前请自行查看 GitHub 源码 与 MIT 许可证。和上一版比 只比产物快照正文，不比随时被改写的单一 md 源。差异在浏览器端计算，宿主通过 /api/dsh-workbench/ 下 JSON 路由提供文本等数据。
DeepSeek Harness 生态强调「一切皆插件」；社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-workbench 把「改 md → 出 Word → 人审」从不可见的覆盖循环，收成带快照、摘要、审批和 diff 的时间轴，并补上技能目录与文档配对两块常缺的全局视图。需要时可从 SkillHub 或 GitHub 按上述命令安装，重启 dsh web 后从左栏或右栏进入工作台。
- 目录页：https://www.skillhub.cn/plugins/liiydong/dsh-workbench
- GitHub：https://github.com/liiydong/dsh-workbench
