前言¶

在 DeepSeek Harness (DSH) 的開發流程中，框架和第三方庫的 API 更新頻繁，模型常依賴訓練數據生成過時或錯誤的代碼，即“幻覺 API”。dsh-livedocs 插件旨在解決這個問題，通過在智能體編寫代碼前注入版本對應的官方文檔上下文，確保代碼基於最新的、可驗證的信息。

插件由 sogoodayo 維護，基於 MIT 協議開源。

安裝與前置要求¶

安裝需要使用 DSH 的 Web Profile 契約。

dsh plugin --profile web add dsh-livedocs

前置要求如下：
* DSH 版本：>=0.1.5-rc.1 <0.3.0
* Node.js 版本：>=18
* 依賴：@deepseek-ai/dsh-tools

核心功能¶

插件主要解決文檔來源的權威性和版本一致性。

1. 版本鎖定與文檔源：優先讀取 llms.txt，GitHub tag 文檔兜底。支持配置 Context7 雲端索引（可選）。
2. 零配置與自動觸發：安裝後自動註冊嵌入式技能，模型在處理第三方庫任務時會自動調用。
3. 可控上下文：支持 Token 預算控制，支持本地離線緩存。

典型用法¶

插件提供三種使用方式，按無感程度排序：

1. 嵌入式技能（默認啓用）
   插件向宿主技能註冊表登記了 livedocs 技能。模型目錄裏常駐一條約 30 token 的路由描述，一旦任務涉及第三方庫（寫代碼、修 bug），模型會自動加載完整使用規則並按規則先查文檔。可在設置卡片關閉。

2. 斜槓命令
   在輸入框敲 / 即可觸發，例如：

/livedocs react hooks
/livedocs next routing

結果直接渲染在會話裏，不消耗模型 token。

3. 全局自動規則
   運行以下指令將規則注入到 ~/.dsh/AGENTS.md，實現全局生效：

用 docs_setup 裝一下全局規則（scope 傳 global）

工具說明¶

插件提供四個核心工具：

• docs_resolve：將庫名映射爲文檔源（llms.txt、GitHub 倉庫等）。
• docs_query：拉取版本對應的文檔片段，按 topic 檢索，支持 7 天本地緩存。
• docs_cache：緩存統計與清理。
• docs_setup：將使用規則冪等寫入 AGENTS.md（支持 scope: project 或 scope: global）。

注意事項¶

1. 插件以當前 DSH 進程權限運行，安裝前請檢查源碼與許可證。
2. 支持的作用域爲項目級和全局級。
3. 依賴 @deepseek-ai/dsh-tools。

總結¶

dsh-livedocs 通過版本鎖定和多種文檔源降級策略，爲 DeepSeek Harness 提供了可靠的官方文檔上下文。配合嵌入式技能和自動規則，能有效減少模型對框架 API 的誤用。

GitHub 倉庫 | 插件目錄