PerryLink/dsh-plugin-guide ↗★ 2
The dsh-plugin-guide knowledge base as an installable DeepSeek Harness plugin: official docs, Cordis primer, community deep-dives, and battle-tested pitfalls registered as an on-demand agent skill.
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:PerryLink/dsh-plugin-guide
🗺️ 每条事实都链接到出处——官方文档、上游仓库或社区仓库。有疑问时以官方原文副本为准。
⏱️ 最后核验 2026-08-15——官方文档与上游
master（47f9438，见 SNAPSHOT.md）逐字节一致；npm 标签与dsh-plugin话题（08-15 快照抓取期间 API total_count 2668 → 2671 持续增长，分页快照收录 998 个仓库，见 sources.md §D.2）已实时重核；上游 HEAD 与 npm@deepseek-ai/dsh（0.1.0-rc.6）无变化。
| 官方文档 | 社区深读 | 实测踩坑 | dsh-plugin 话题 | 语言 | 智能体技能 |
|---|---|---|---|---|---|
| 215 篇（中英） | 114 个仓库 | 20+ | 998 快照（API ≈2670） | EN · 中文 · ES · PT · HI | dsh-plugin-guide |
本仓库本身是一个可安装的 DSH bundle：安装后把整套知识库注册为 dsh-plugin-guide 智能体技能——每个会话的技能目录里都可见，模型按需加载工作流、官方文档与社区深读（./guide/、./references/），无需复制、无需搜索。
# 从 git 安装（源码；建议钉住 commit 保证可复现）：
dsh plugin --profile
add github:PerryLink/dsh-plugin-guide#
# 或打 tarball 安装（入口是纯 ESM JS，无需构建步骤）：
pnpm pack
dsh plugin --profile
add ./dsh-plugin-guide-.tgz
bundle 声明了 dsh.bundle.patch，并以可选 peerDependency 钉住 @deepseek-ai/dsh@0.1.0-rc.6 版本火车。用 dsh --profile --dump-config 验证 dsh-plugin-guide 层已生效。
把整个目录复制进你的 agent 技能目录（相对路径保持不变）：
Windows（PowerShell）
pwsh -File scripts/install-skill.ps1 `
-Target "$env:USERPROFILE\.deepseek\skills\dsh-plugin-guide" # 或 \.agents\skills\dsh-plugin-guide
macOS / Linux
pwsh -File scripts/install-skill.ps1 -Target ~/.deepseek/skills/dsh-plugin-guide # 或 /.agents/skills/dsh-plugin-guide
安装脚本会跳过 downloads/（脚本生成）与 .github/，并对每个复制的文件做逐字节校验；手工 Copy-Item -Recurse 整个目录也可以。
然后对智能体说："用 dsh-plugin-guide 技能帮我开发一个 XX 插件。"
| 想要什么 | 读哪里 |
|---|---|
| 一页速查表 | guide/quick-reference.md |
| 完整 10 章路径 | guide/plugin-dev-guide.md |
| 官方与社区文档链接 | guide/links.md · references/community-ecosystem.md |
| 服务/事件精确 API | references/official-docs/docs/subsystems/ 与 docs/cordis-api/ |
| 路径 | 内容 |
|---|---|
SKILL.md | dsh-plugin-guide 技能：硬性红线 + 按任务类型的开发路径 |
package.json · cordis.patch.yml · index.js | 可安装的 DSH bundle：dsh.bundle.patch 清单 + 把知识库注册为 dsh-plugin-guide 技能的入口 |
guide/plugin-dev-guide.md | 完整开发指南（10 章） |
guide/quick-reference.md | 一页速查表（5 语种） |
guide/links.md | 精选 URL 索引：官方开发文档（线上 ↔ 本地副本）+ 社区开发文档链接 |
references/official-docs/ | 官方文档逐字副本（中英双语） |
references/*.md | 调研报告：仓库文档、文档站、Cordis、论文、社区生态、111 仓库归档（15 个深读） |
scripts/ | 幂等下载脚本 + 完整性检查器 + 话题快照生成器 |
downloads/ | 原始下载物——由 scripts/ 生成，不入版本库 |
next()、模型可见⟺已记录、Schemastery 配置。tsc 报错仍产出、Windows junction、多帧 zstd 会话、DSH_* 环境变量、npm latest 过期……scripts/archive-discussions.ps1 / scripts/download-community-articles.ps1 一键刷新。master、npm 与实时 dsh-plugin 话题复核。pwsh -File scripts/sync-official-docs.ps1 # 从本地 checkout 同步官方文档逐字副本（只取 origin/master）
pwsh -File scripts/download-sources.ps1 # 官网/文档站、Cordis、论文
pwsh -File scripts/download-community-repos.ps1 # 114 个社区仓库（codeload tarball，ETag 增量刷新）
pwsh -File scripts/download-community-articles.ps1 # 中/英/HN 社区文章 HTML 快照
pwsh -File scripts/archive-discussions.ps1 # 官方 Discussions（需 $env:GH_TOKEN）
pwsh -File scripts/gen-topic-snapshot.ps1 -OutDir # dsh-plugin 话题普查
pwsh -File scripts/verify-kit.ps1 -Checkout # 关键路径 + 断链扫描 + 官方文档漂移报告
每次 push 与 PR 都会由 CI 运行 verify-kit。
本仓库以 GitHub 话题 dsh 与 dsh-plugin 对外可见——逛这两个话题页可以发现数百个插件与开发资源。
dsh-plugin 话题页。社区维护，不是 DeepSeek 官方产品。DeepSeek Harness 处于开发者预览期、会发布破坏性变更；有疑问时以
references/official-docs/ 中的官方文档为准。