前言¶
在 DeepSeek Harness（DSH）里做法律或文献类智能体时，对话侧往往已经有入库、检索、记笔记等工具，但本地文献库的状态不易一眼看清：有哪些条目、读到哪一段、笔记挂在哪，通常要反复让模型查库或自己翻目录。社区里也有类似「上下文洞察」形态的插件（例如 dsh-context），把信息放到 Web 客户端右侧停靠栏。下面介绍 violin-i 维护的 dsh-plugin-law-workbench：它在右侧注册「工作台」标签页，对 dsh-plugin-cnki-assist 维护的共享文献库做列表、检索与分段阅读，并与对话内工具共用同一份数据。
需要事先说明：根据仓库 README，本包已弃用。自 dsh-plugin-cnki-assist v0.5.0 起，工作台面板已并入该包；共享库路径与格式不变，数据无需迁移。新环境应直接安装 cnki-assist；本文仍按本仓库文档说明其能力与历史安装方式，便于对照归档代码与目录条目。
这是什么¶
dsh-plugin-law-workbench 是面向 DSH Web 客户端的插件（分类：客户端）。宿主侧读取 cnki-assist 维护的本地文献库（默认 ~/.dsh/law-library/，可通过行配置 libraryDir 覆盖），浏览器侧在 右侧停靠栏 注册「工作台」面板：文献列表、概念扩展全文检索、分段阅读、大纲、笔记与阅读进度。文献经对话里的 law_lib_add 入库后面板即时可见；v0.2 起面板上的笔记与阅读进度会 回写 共享库，与 law_lib_note、law_lib_read 等对话工具互通。
维护者：violin-i。许可证：MIT（见仓库）。适配 DSH 版本：>=0.2.0 <0.3.0（见 package.json 的 engines.dsh）。
核心功能¶
面板能力在 README 中列明，与对话内检索逻辑同源的部分包括中文 BM25 与法律概念同义扩展（与 law_lib_search 同源）。
- 文献列表：展示标题、页数、字数、分块数、笔记数、阅读进度；点击可续读上次位置。
- 全文检索：命中词以【】高亮片段并显示相关度分数，点击跳转阅读。
- 分段阅读：约 3000 字窗口翻页（上一段/下一段），阅读位置自动写入进度。
- 大纲：识别中文序号章节行，一键查看文献结构。
- 笔记：正文划选摘录与批注，笔记列表可管理（含删除），与对话侧工具共享。
- 刷新：同步最新入库状态。
架构概览¶
插件分宿主与浏览器两半，经 Cordis 补丁与 dsh.client 注入右侧栏 UI（见 README 架构表）。
| 半 | 产物 | 职责 |
|---|---|---|
| 宿主 | lib/index.js |
读取共享文献库，经 connection.fetch.register 暴露 7 个 POST 路由（/api/law-workbench/state\|search\|read\|outline\|notes\|note\|progress），笔记与进度回写共享库 |
| 浏览器 | lib/client.js |
注册 ctx.sidebarRightTabs 与 sidebar.right.pane.tab，React 面板（react 为平台外部模块） |
分发为预构建的 lib/，无构建脚本；安装时无需 allowBuilds 授权。
安装与启用¶
前置：已安装 dsh-plugin-cnki-assist（文献入库与检索工具链）。仅装本包无法单独完成入库链路。
推荐（弃用后的替代）：工作台已并入 cnki-assist v0.5.0+，请使用 README 给出的命令：
dsh plugin --profile web add github:violin-i/dsh-plugin-cnki-assist
历史安装（本仓库归档保留，不再更新）：
dsh plugin --profile web add github:violin-i/dsh-plugin-law-workbench
安装后 重启 dsh，在右侧停靠栏引导页（「+」新增控件）中会出现「工作台」入口。
DSH 社区插件目录位于独立站点 skillhub.cn，与 DeepSeek / 幻方无官方从属关系；安装前请自行审阅源码与许可证。插件以当前 dsh 进程权限运行，文献库位于用户目录下的共享路径，需注意本机数据安全。
典型用法¶
README 未给出逐步截图式教程，可复现的主路径如下。
- 安装并启用 dsh-plugin-cnki-assist（新用户直接装 cnki-assist 即可同时获得面板）。
- 在对话中通过
law_lib_add将文献写入共享库；面板点 刷新 或直接打开列表即可看到新条目。 - 在面板内 检索 或从列表进入 分段阅读；需要结构化浏览时使用 大纲；划选正文添加 笔记。
- 同一文献在对话中用
law_lib_search、law_lib_note、law_lib_read操作时，与面板读写的是同一份~/.dsh/law-library/（或libraryDir指定目录）数据。
适用场景与注意¶
- 适合：已在 DSH Web 端使用 cnki-assist 文献库、希望在右侧栏可视化浏览与续读、并与对话工具保持笔记/进度一致的用户或开发者。
- 不适合：仅命令行、不需要 Web 右栏 UI 的场景；或期望单独维护另一套文献索引而不使用共享库的情况。
- 版本：本包最新文档版本为 0.2.0；新功能与维护集中在 dsh-plugin-cnki-assist，请勿指望本仓库继续更新。
- 安全与合规：插件读取本地文献与笔记；安装前检查仓库 MIT 许可与源码。勿在未审计的插件上指向含敏感材料的库目录。
结尾¶
dsh-plugin-law-workbench 的价值在于：把 cnki-assist 共享文献库从「仅对话可见」扩展到 右侧工作台，列表、BM25+概念扩展检索、分段阅读与笔记进度一体化，并与 law_lib_* 工具单源同步。当前生态上应改用并入后的 dsh-plugin-cnki-assist；本仓库仍可作为面板协议与路由设计的参考。
