前言¶
在 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）。
