dsh-livedocs 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；自动检查通过：npm 包已发布且 engines 声明满足基线（声明 Node >=18）；该结论来自程序自动检查，未经人工实机验证。

dsh-livedocs 兼容性怎么样？

自动检查通过：npm 包已发布且 engines 声明满足基线（声明 Node >=18）；该结论来自程序自动检查，未经人工实机验证。

dsh-livedocs 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-livedocs 还在维护吗？

GitHub 1 星。最近一次上游提交在 2026/9/22。

实时库文档 sogoodayo/dsh-livedocs

Q: dsh-livedocs 是什么插件？

DSH 实时库文档：写代码前自动拉取项目安装版本的官方文档，消灭幻觉 API。零配置零 Key。为 DeepSeek Harness 提供按版本锁定的实时库文档，消灭幻觉 API。

DeepSeek Harnessv0.2.0

sogoodayo43 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

写代码前自动拉取对应版本官方文档，杜绝幻觉 API

30.6/100

综合分

GitHub 星标

395

npm 周下载

—/5

用户评分

数据截至 2026/9/24 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add dsh-livedocs

npm 源 · dsh-livedocs 的发布者账号已校验与本仓库一致

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：需留意

是什么[目录]—

dsh 原生插件 · search

暂无时间戳·判据 →

装得上吗[实装验证]!

实装验证未通过（runtime_boot_failed），装前请到仓库确认最近更新与 issue；本次验证针对插件 v0.2.3，当前版本为 v0.2.0，该结论可能已不适用

L4 · 真实安装等级说明 →

数据截至 2026/10/28·判据 →

安全吗[自动扫描]—

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

数据截至 2026/11/04·判据 →

还在维护吗[仓库]—

更新放缓：最近一次提交在 43 天前

暂无时间戳·判据 →

图例：✓ 通过! 需注意— 未判定 / 无数据· 「未判定」= 本站尚无数据，不代表插件有问题

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

可信度证据

安装兼容性检查✓ 自动检查通过

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✓npm 包dsh-livedocs @ 0.2.0

✓Node 引擎要求 >=18 · 基线 Node 22.19 满足

✓dsh CLI 依赖要求 >=0.2.0-rc.1 <0.3.0 · 最新 0.2.1-rc.2 兼容

✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/20 04:30:13

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

读写/删除本地文件发起外部网络请求

查看扫描证据（共 29 处，展示前 27 条）

读取本地文件
index.js:101
selfVersion = JSON.parse(readFileSync(join(pluginDir, 'package.json'), 'utf8')).version ?? selfVersion
写入本地文件
index.js:122
mkdirSync(join(pluginDir, 'data'), { recursive: true })
写入本地文件
index.js:123
writeFileSync(
读取本地文件
index.js:293
if (!existsSync(target)) {
写入本地文件
index.js:295
writeFileSync(target, `${title}\n\n${RULE_BODY}\n`)
读取本地文件
index.js:298
const current = readFileSync(target, 'utf8')
写入本地文件
index.js:312
writeFileSync(target, next)
写入本地文件
lib/cache.js:18
mkdirSync(this.blobsDir, { recursive: true })
读取本地文件
lib/cache.js:25
return JSON.parse(readFileSync(this.indexPath, 'utf8'))
写入本地文件
lib/cache.js:32
writeFileSync(this.indexPath, JSON.stringify(this.index, null, 2))
读取本地文件
lib/cache.js:46
if (!existsSync(blobPath)) {
读取本地文件
lib/cache.js:56
return { content: readFileSync(blobPath, 'utf8'), stale, fetchedAt: entry.fetchedAt }
写入本地文件
lib/cache.js:61
writeFileSync(join(this.blobsDir, file), content)
读取本地文件
lib/cache.js:85
if (existsSync(blobPath)) unlinkSync(blobPath)
删除本地文件
lib/cache.js:85
if (existsSync(blobPath)) unlinkSync(blobPath)
发起网络请求
lib/sources.js:17
const res = await fetch(url, {
读取本地文件
lib/lockfile.js:42
if (!existsSync(pkgJsonPath)) return null
读取本地文件
lib/lockfile.js:43
const pkg = JSON.parse(readFileSync(pkgJsonPath, 'utf8'))
读取本地文件
lib/lockfile.js:53
if (!existsSync(pkgPath)) return null
读取本地文件
lib/lockfile.js:54
const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'))
读取本地文件
lib/lockfile.js:68
if (!existsSync(lockPath)) return null
读取本地文件
lib/lockfile.js:69
const lock = JSON.parse(readFileSync(lockPath, 'utf8'))
读取本地文件
lib/project.js:16
if (existsSync(join(dir, 'package.json'))) return dir
读取本地文件
lib/project.js:33
pkg = JSON.parse(readFileSync(join(projectDir, 'package.json'), 'utf8'))
读取本地文件
lib/config.js:108
if (!existsSync(file)) return { config: { ...globalConfig }, projectFile: null, projectOverride: null }
读取本地文件
lib/config.js:110
const raw = JSON.parse(readFileSync(file, 'utf8'))
读取本地文件
lib/registry.js:24
cached = JSON.parse(readFileSync(file, 'utf8'))

扫描于 2026/11/4（1 天前） · 范围入口闭包 + 全包扫描 · 来源 npm 发布包

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/dsh-tools@deepseek-ai/dsh-typert-protocol@deepseek-ai/schemastery

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

功能亮点

自动拉取官方文档
匹配项目安装版本
零配置零Key

DSH 实时库文档：写代码前自动拉取项目安装版本的官方文档，消灭幻觉 API。零配置零 Key。为 DeepSeek Harness 提供按版本锁定的实时库文档，消灭幻觉 API。

README

由 DeepSeek 最新模型翻译生成

dsh-livedocs License: MIT npm DSH Plugin Awesome DSH llms.txt 为 DeepSeek Harness (DSH) 提供版本钉定的实时库文档——消灭幻觉 API。在 agent 写代码前，拉取版本对应的官方文档注入上下文：llms.txt 优先、GitHub tag 文档兜底、本地缓存离线可用、token 预算可控。装好即注册嵌入式技能自动触发，零配置、零 API Key（可选 Context7 云端兜底）。安装 npm（推荐，包名即插件名） dsh plugin --profile web add dsh-livedocs 或从 GitHub 安装 dsh plugin --profile web add github:sogoodayo/dsh-livedocs 用法三种方式，按无感程度排列： 0. 嵌入式技能（零配置，装好即生效）——插件向宿主的技能注册表登记了 livedocs 技能：模型目录里常驻一条约 30 token 的路由描述，一旦任务涉及第三方库（写代码、修 bug、问用法），模型会自动加载完整使用规则并按规则先查文档。可在设置卡片用「嵌入式技能」开关关闭。

展开完整文档（README 剩余 1 节）

dsh-livedocs

License: MIT
npm
DSH Plugin
Awesome DSH
llms.txt

为 DeepSeek Harness (DSH) 提供版本钉定的实时库文档——消灭幻觉 API。

在 agent 写代码前，拉取版本对应的官方文档注入上下文：llms.txt 优先、GitHub tag 文档兜底、本地缓存离线可用、token 预算可控。装好即注册嵌入式技能自动触发，零配置、零 API Key（可选 Context7 云端兜底）。

安装

npm（推荐，包名即插件名）
dsh plugin --profile web add dsh-livedocs

或从 GitHub 安装
dsh plugin --profile web add github:sogoodayo/dsh-livedocs

用法

三种方式，按无感程度排列：

0. 嵌入式技能（零配置，装好即生效）——插件向宿主的技能注册表登记了 livedocs 技能：模型目录里常驻一条约 30 token 的路由描述，一旦任务涉及第三方库（写代码、修 bug、问用法），模型会自动加载完整使用规则并按规则先查文档。可在设置卡片用「嵌入式技能」开关关闭。

1. 斜杠命令（手动，最直接）——在输入框敲 / 即可看到：

/livedocs react hooks
/livedocs next routing

结果直接渲染在会话里，不消耗模型 token。

2. 全局自动规则（推荐，装一次处处生效）——让 agent 跑一次：

用 docs_setup 装一下全局规则（scope 传 global）

规则写入 ~/.dsh/AGENTS.md，DSH 内置的指令组件会把它注入所有项目的所有会话，agent 写第三方库代码前会主动先查文档。

3. 模型自动选择——工具描述中已内置“写第三方库代码前必须先查”的引导，模型在编码任务中会自行调用。

工具

| 工具 | 说明 |
| docs_resolve | 库名 → 文档源（文档站 llms.txt、GitHub 仓库、最新版本） |
| docs_query | 拉取版本对应的文档片段，按 topic 检索、按 token 预算裁剪，7 天本地缓存；传 projectDir 自动钉项目里安装的版本 |
| docs_cache | 缓存统计 / 清理 |
| docs_setup | 把使用规则幂等写入 AGENTS.md（scope: project 项目级 / scope: global 全局） |

截图

| 设置卡片（中文，默认） | Settings card (English) |
| 设置卡片 | Settings card |

| 缓存文档管理 | /livedocs 斜杠命令 |
| 缓存文档管理 | 斜杠命令 |

工作原理

库名 → npm registry 元数据（版本 / 仓库 / 文档站） → 版本钉选：显式 version > node_modules / lockfile 实测 > 最新 release → 拉取链：llms-full.txt → llms.txt → GitHub README（按 tag 钉版本） → 可选兜底：配置 Context7 API Key 后，长尾库回退到 Context7 云端索引（支持版本钉定，401/429 显式报错） → 版本不一致时输出显式警告（llms.txt 永远是最新版的文档） → Markdown 按标题分块 → topic 打分（零命中自动回退概览）→ token 预算内裁剪 → JSON 文件 LRU 缓存（断网时返回过期缓存并标注 stale）

手动规则（可选）

不想跑 docs_setup 的话，手动在 AGENTS.md 中加一条：

Always call docs_query before writing code against any third-party library API.
Never rely on training data for framework APIs (Next.js, React, Vue, etc.).

路线图

- [x] M1：三工具 + 多源降级 + 缓存
- [x] M2：读项目 node_modules / lockfile 自动钉版本；docs_setup 规则幂等注入 AGENTS.md
- [x] M2.5：/livedocs 斜杠命令；全局规则；版本不一致警告；topic 零命中回退
- [x] M2.6：依赖上下文注入（每会话自动向模型展示项目依赖及安装版本）+ Top 3 依赖文档后台预热
- [x] M3：设置卡片（设置 → 插件 → 插件配置 → Live Docs）：总开关、注入/预热开关、预热 Top N、缓存 TTL 与上限、自定义文档源（customDocs）、缓存列表查看/移除/清空；项目级 .dsh-livedocs.json 覆盖
- [x] M3.7：策展注册表（50+ 主流库，verified llms.txt 源直连）+ 预热拉满 N 个（失败不占名额，注册表命中插队）+ 出错后查文档规则；缓存迁至 ~/.dsh/livedocs/（跨 profile 共享，插件升级不清零）
- [x] M4：可选 Context7 云端索引兜底（设置卡片填 Key 即启用，默认关闭；版本钉定 + 401/429 显式报错；Key 仅全局设置，项目文件不可覆盖）
- [x] M5：嵌入式 skill 自动触发（ctx.skills 运行时注册 livedocs 技能，目录描述常驻、正文按需加载；设置卡片可关；与总开关联动）
- [x] M6：设置卡片「检查更新」：Host 侧查询 npm registry 最新发布并对比运行版本，发现新版本时给出升级命令
- [x] M7：设置卡片中英双语切换（locale: zh/en，默认中文，即时生效）

兼容性

已在 DSH Developer Preview（web profile）的插件契约下开发：inject: ['tools'] + defineTool（@deepseek-ai/dsh-tools）。DSH 处于预览期，若宿主升级导致 inject 契约变化，请提 issue。

设计与调研依据见 docs/feasibility.md。

License

MIT