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