前言¶
在 DeepSeek Harness（DSH）里做面向典籍的对话，常见难点有两类：一是要把资料库根路径稳定地注入 system prompt，让模型按文件读原文，而不是凭训练数据复述；二是要把问诊、辨证、出方的流程收成可切换的预设，而不是每次手写长提示词。社区插件 dsh-tcm（维护者 yeweiliang7063，SkillHub 分类为模型推理）针对这两点：注册变量 tcm_kb_path、设置页「中医资料库」、预设「中医 · 岐黄经方」（id：tcm）。插件不含书目正文，索引由宿主侧自动生成与监视更新。
这是什么¶
dsh-tcm 是给 DSH 用的第三方中医插件（npm 包名同为 dsh-tcm，当前文档对应版本 1.3.0，MIT）。装上并在 profile 启用后，对话里可选预设「中医 · 岐黄经方」，设置里多一节「中医资料库」用于改资料库绝对路径；路径变更即时生效，无需重启 DSH。运行要求 Node.js 18+（与 DSH 自带运行时一致）。Windows、macOS、Linux 均支持，路径与目录监视按平台处理。
核心能力¶
systemPrompt 变量与提示词引用¶
插件向所有会话提供系统提示词变量 tcm_kb_path，指向当前「中医资料库」根目录。预设提示词里用 {{tcm_kb_path}} 引用，模型据此去读《黄帝内经》《难经》《伤寒杂病论》等用户放在资料库中的文件。目录不存在时，提示词会附带提醒，引导用户回到设置页修改路径。
预设「岐黄经方」的流程与输出¶
预设 id 为 tcm，名称为「中医 · 岐黄经方」。流程上以经方为法度：先问诊（通过提问工具一次性收集寒热、出汗、二便、六部脉、舌象等），答齐后再出方。输出固定为三段：分析病症、处方、煎服注意事项。
设置页「中医资料库」¶
客户端通过 lib/client.js 注入设置 UI（入口：设置 → 中医资料库）。可填写任意绝对路径，支持 ~ 展开；保存前检查目录是否存在。默认路径因平台而异：Windows 在 D:\中医知识库 已存在时用该路径，否则 %USERPROFILE%\中医知识库；macOS / Linux 为 ~/中医知识库。
资料库布局与索引¶
资料库建议结构如下（索引.md 无需手写）：
<资料库根目录>/
├─ 索引.md # 插件自动生成
├─ text/ # 各书纯文本副本
└─ skills/tcm-jingfang/SKILL.md # 可选检索规程
支持书目格式包括 .md、.txt、.pdf、.docx、.epub 等，放在根目录或 text/。DSH 启动约 2.5 秒后扫描并写出或更新 索引.md；之后增删改经 1.5 秒去抖后重建。不需要自动索引时，可将插件配置项 autoIndex 设为 false，改用手动命令：
node lib/build-index.mjs ~/中医知识库
或在插件目录执行 npm run index。
安装与启用¶
前提：DSH 已安装并至少启动过一次（以便生成 profile 目录）。
在 DSH 插件页安装¶
打开 DSH → 左侧「插件」→ 右上角「添加插件」，输入框填写 dsh-tcm 后安装，再点「立即启用」并重启 DSH。pnpm 存在约 24 小时 minimumReleaseAge，新发版当天可能仍装到旧版；可等一天或指定版本：
dsh-tcm@1.3.0
一键安装（仓库内脚本）¶
在已下载的插件仓库根目录执行（三选一）：
sh install.sh
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1
node install.mjs
常用参数示例：指定资料库 --kb、指定 profile --profile、--dry-run 仅预览。装完后重启 DSH。
从 npm / GitHub 写入 profile 依赖¶
可将 profile 的 package.json 依赖写成 GitHub 源后安装，再在 profile 目录执行登记命令：
"dsh-tcm": "github:yeweiliang7063/dsh-tcm"
node node_modules/dsh-tcm/install.mjs --profile . --from dsh-tcm
装好后在「设置 → 插件」确认 tcm-kb 已启用，并在「设置 → 中医资料库」改成实际资料库路径。
典型用法¶
- 自备医书文件放入资料库（纯文本副本可放
text/），等待或触发索引生成。 - 在对话中选择预设「中医 · 岐黄经方」，按预设流程完成问诊后再看方药与分析。
- 本地只读自检（不启动 DSH）：
node verify-preset.mjs
指定路径时：
TCM_PROFILE=/path/to/profile TCM_KB_PATH=/path/to/kb node verify-preset.mjs
路径工具单元测试：
npm test
适用场景与注意¶
适合已在 DSH 中开发或日常使用、并希望把中医典籍阅读与经方问诊流程插件化的用户。插件以当前 DSH 进程权限访问文件系统；安装前宜浏览 GitHub 仓库 源码与 MIT 许可证。仓库说明写明：第三方插件，非 DSH 官方；异常在插件边界内捕获，不致拖垮 DSH 启动；预设可能按原文呈现含附子、马钱子等峻毒药剂量，仅供学习研究，剂量与用法须自行核对原文与专业意见。无资料库时插件仍可加载，但对话会提示读不到资料、不会编造条文。
结尾¶
dsh-tcm 把资料库路径变量、设置 UI、经方预设和 索引.md 自动化串成一条可配置链路，便于在 DSH 里做典籍有据的对话。目录页：SkillHub · dsh-tcm；源码与完整安装说明：github.com/yeweiliang7063/dsh-tcm。
