前言¶

在 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