前言¶

在 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 仓库 | 插件目录