前言¶
在 DeepSeek Harness（DSH）裏做長會話時，SOP、術語表、會議記錄和筆記往往散落在 Obsidian 庫或本地文件夾裏，和聊天窗口是兩套界面：查一條流程要切應用，錄完會還要再貼 transcript。DSH 社區裏有不少客戶端插件；dsh-legal-workbench（維護者 gaog88666-boop）把右側欄做成工作臺，直接在會話旁瀏覽和編輯 Markdown、查 SOP、維護 glossary、錄音並可選實時轉寫，並對筆記與轉寫全文檢索。文件留在本機，README 寫明無需賬號、無遙測（詳見倉庫內 PRIVACY.md）。
這是什麼¶
dsh-legal-workbench 是面向 DeepSeek Harness 的客戶端插件（dsh.client 注入會話 UI 與右側欄）。它不替代 Obsidian：只需指定一個存放 .md 的文件夾（Obsidian vault 或任意目錄），插件直接讀寫該目錄下的 Markdown。當前 npm 包版本爲 1.1.1（MIT），GitHub 上約 5 stars；SkillHub 目錄頁：gaog88666-boop/dsh-legal-workbench。
核心功能¶
README 用卡片表格歸納能力；下面按同一事實簡要說明。
| 模塊 | 作用 | 前置條件 |
|---|---|---|
| SOP | 以樹形瀏覽 SOP 文件夾，就地閱讀、編輯筆記 | 已配置 vault 路徑 |
| Glossary | 一行一詞，行內編輯並寫回筆記 | vault |
| Recordings | 錄音、可選實時轉寫、對 transcript 高亮與批註、回放 | vault；實時轉寫需自行配置 Volcengine 密鑰 |
| Search | 對筆記、轉寫與批註做全文檢索 | vault |
| 按自有規則庫起草郵件 | 可選：自備 skill 文件夾 | |
| Usage badge | 展示 DeepSeek 餘額與剩餘語音時長 | 可選：自備密鑰 |
補充說明（均來自 README）：
- 未配置轉寫密鑰時，錄音與回放仍可用；轉寫默認關閉。
- 筆記內圖片不渲染，僅顯示文件名標籤；Markdown 支持刻意從簡（無 HTML、無嵌入 PDF、無 mermaid）。
- 多行選中時，批註錨定在首行；高亮顏色 UI 固定爲黃色。
- 工作臺與 Obsidian 共用同一批文件：此處保存後 Obsidian 立即可見；Obsidian 側改動需在工作臺點刷新後可見。
安裝與啓用¶
環境：已安裝 DSH，且版本 ≥ 0.2.0（可用 dsh --version 檢查）；安裝插件需能訪問 npm。README 註明在 macOS 上完整驗證；其他平臺可安裝運行，但調用系統命令的「在 Obsidian 中打開」「打開控制台」等操作可能需要改配置。
不需要 Obsidian 本體、API Key 或註冊賬號。
按你的 DSH 形態選擇命令（自定義 profile 名時，將 desktop / web 換成 ~/.dsh/profiles/ 下的名稱）：
DSH Desktop
dsh plugin --profile desktop add dsh-legal-workbench
自託管 DSH Web
dsh plugin --profile web add dsh-legal-workbench
安裝後重啓 DSH，點擊會話標題旁的工作臺圖標，或按 ⌥W 打開；Esc 關閉。
插件以當前 DSH 進程權限讀寫你配置的 vault 與 ~/.dsh-workbench/ 下的配置；安裝前建議在 GitHub 閱讀源碼與 MIT 許可證。
首次運行與配置位置¶
第一次打開工作臺時，只需填寫一項：存放 Markdown 筆記的文件夾完整路徑（Obsidian vault 或任意目錄），保存即可。轉寫、Usage badge、Pkulaw points 等可選能力在未提供憑據前保持 dormant。
路徑與目錄約定（README）：
- 筆記與錄音：位於 vault 內（首屏可配置子文件夾）。
- 插件配置：
~/.dsh-workbench/config.json。 - 可選 ASR 憑據：
~/.dsh-workbench/asr.json（權限 600，不進倉庫）。
典型用法¶
- 安裝並重啓 DSH 後，用
⌥W或標題旁圖標打開右側工作臺（若當前會話尚無右側欄，會以 overlay 形式打開，而非靜默失敗）。 - 配置 vault 路徑後，在 SOP 卡片中樹形打開流程筆記並就地編輯。
- 在 Glossary 中維護術語表，變更寫回對應筆記。
- 在 Recordings 中錄音；若已在
asr.json配置 Volcengine，可開實時轉寫並對 transcript 高亮、批註後回放。 - 用 Search 跨筆記、轉寫與批註檢索。
若面板打開但空白，README 建議在面板右上角點 refresh（1.1.0 已知首次加載問題，刷新一次即可）。
適用場景與注意¶
適合：已在本地用 Markdown / Obsidian 管理 SOP、術語與會議材料，希望在 DSH 會話旁完成查閱、輕量編輯、錄音與檢索，且希望數據留在本機的用戶（README 面向律所等場景的關鍵詞含 lawfirm，但能力本身是通用 vault 工作臺）。
注意：
- DSH 右側欄按會話掛載；無法 dock 時走 overlay。
- 報銷（reimbursement）相關卡片目前僅檢查模板是否存在，尚未解析模板內容。
- 導入音頻轉寫無進度條；若干 limitation 見 GitHub README「Known limitations」。
- 社區目錄 SkillHub 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；插件歸屬維護者與上述倉庫。
結尾¶
dsh-legal-workbench 把 Obsidian 式筆記庫嵌進 DSH 右側欄：SOP、glossary、錄音轉寫（可選）、全文搜索與若干可選擴展，安裝命令來自官方 README，配置集中在 ~/.dsh-workbench/。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub 倉庫（含 README.zh.md）。
