PerryLink/dsh-plugin-guide

🐳 dsh-plugin-guide

• 1024 商店渠道：先 npm i -g dsh1024，再 dsh1024 plugin --profile web add dsh-plugin-guide（计入 deepseek1024.com 安装排行）。

构建 DeepSeek Harness 插件所需的一切。

官方文档档案 · Cordis 入门 · 社区深读 · 实战踩坑 · agent 技能 · CLI 工具链

官方仓库。 本仓库是 dsh-plugin-guide 的唯一官方仓库，由 PerryLink 维护。其他账号下的同名仓库与本项目无关。

English · 简体中文 · Español · Português · हिन्दी

---

⭐ 如果它帮到了你

这个插件是 DSH 插件家族的一员（40+ 个，全部 Apache-2.0）。如果你在用，给个 star —— 它不会解锁任何功能，但会让下一个人在搜索里更容易找到它。

English: part of a 40+ plugin family for DeepSeek Harness. If it is useful, a star helps the next person find it — nothing is gated behind it.

Compatibility

Surface	Status
Harness	DeepSeek Harness dsh-v0.1.7-rc.2（2026-09-24 重同步，ddefc45）：官方文档快照已刷新到 rc.1；checker 现在期望四段式 peer 区间（`…
Node	`^22.19.0
Platforms	全部（纯 ESM bundle；无原生代码、无网络）
Model	任意（无模型交互）

What you get

dsh-plugin-guide 是 DSH 插件开发知识库加 CLI 工具链，打包为一个可安装 bundle。知识库注册为 dsh-plugin-guide agent 技能（在每个会话目录可见，按需加载工作流步骤、官方文档与社区深读）；dsh-plugin-dev CLI 在其之上提供三个机械层。

• 插件契约与红线 —— effect/disposer、waterfall next()、模型可见 ⟺ 已记录、Schemastery 配置。
• 官方文档档案 —— 官方仓库文档（英 + 中）逐字副本，在最近核验快照处与上游逐字节一致。
• Cordis 入门 —— 五个概念与机制时间线（repository-plugin 0809 引入、0811 移除；两条安装通道）。
• 20+ 个实战踩坑 —— 附根因 + 修法（cordis 双副本、tsconfig 三件套、多帧 zstd 会话、Windows junction、过期 npm latest…）。
• 社区深读 —— 归档 114 个社区仓库（15 个深读），外加每条事实都链回出处的完整来源索引。
• CLI 工具链 —— dsh-plugin-dev new / check / verify：脚手架、静态检查、打包验证 DSH 插件；每个检查项都链回它强制执行的技能章节。

Knowledge base

Path	是什么
SKILL.md	dsh-plugin-guide agent 技能：红线 + 按任务类型的开发路径
package.json · cordis.patch.yml · index.js	可安装 DSH bundle：dsh.bundle.patch 清单 + 注册技能的入口
guide/plugin-dev-guide.md	完整开发指南（10 章）
guide/quick-reference.md	一页速查表（5 语言）
guide/links.md	精选 URL 索引：官方开发文档（站点 ↔ 本地副本）+ 社区文档链接
references/official-docs/	官方仓库文档逐字副本（英 + 中）
references/*.md	调研报告：仓库文档、网站、Cordis、论文、社区生态、114 仓库归档（15 个深读）
scripts/	幂等下载脚本 + 完整性检查器 + 话题快照生成器
bin/ · src/cli/ · dist/	dsh-plugin-dev CLI：脚手架、检查器、验证器（TypeScript，tsdown 打包）
templates/	TS + JS 脚手架骨架：契约模板、Config、tests、cordis.patch.yml、五语 README
downloads/	原始快照 —— 由 scripts/ 生成、不入库

CLI toolchain

bundle 附带零运行时依赖的 dsh-plugin-dev CLI（bin/ → tsdown 打包的 dist/dsh-plugin-dev.js）。每个检查项都引用它强制执行的技能章节，agent 可继续人工审计。

dsh-plugin-dev new <name> [--lang ts|js] [--dir <path>] [--force] [--git]
dsh-plugin-dev check [--cwd <dir>] [--json] [--strict]
dsh-plugin-dev verify [--cwd <dir>] [--dsh <bin>] [--pnpm <bin>]

子命令	作用
new <name>	脚手架生成 TS 或 JS 插件仓库：src/index.ts 契约模板、Schemastery Config、tests、tsdown/vitest、注释齐全的 cordis.patch.yml、五语 README。幂等；无 --force 时拒绝覆盖非空目录。
check	静态检查：cordis.patch.yml 合法性、package.json 元数据（dsh.bundle.patch 指向、peer 依赖、engines、files 白名单）、五语 README 一致性、工程红线模式。输出 CI 可消费的 JSON。
verify	pnpm pack 后装入干净 mkdtemp DSH_HOME profile 做安装/启动/卸载冒烟（对齐 verify:self-contained）。失败给出日志尾部与建议。

CLI configuration

CLI 无硬编码可调参数——每个都是 flag 或环境变量。

可调项	Flag	环境变量	默认
模板目录	—	DSH_PLUGIN_DEV_TEMPLATES	<package>/templates
dsh 二进制	--dsh	DSH_PLUGIN_DEV_DSH	dsh
pnpm 二进制	--pnpm	DSH_PLUGIN_DEV_PNPM	pnpm
安装/打包超时	--timeout	DSH_PLUGIN_DEV_TIMEOUT	300000 ms
headless 冒烟超时	--smoke-timeout	DSH_PLUGIN_DEV_SMOKE_TIMEOUT	120000 ms

Upstream roadmap

dsh-plugin-dev 是官方插件开发 CLI（规划项 C12）的上游候选：脚手架/检查器/验证器是机械层，SKILL.md + guide/ 仍是认知层。

Quick start

# 1. install the bundle into your profile
dsh plugin --profile web add "github:PerryLink/dsh-plugin-guide#main"

# or from npm (published releases)
dsh plugin --profile web add dsh-plugin-guide

# 2. restart and verify the row
dsh --profile web --dump-config | grep -A3 'id: dsh-plugin-guide'

然后直接问你的 agent："用 dsh-plugin-guide 技能帮我构建一个 … 插件。"

或者直接驱动 CLI：

npx dsh-plugin-guide new hello-plugin            # 脚手架生成 TS 插件仓库
npx dsh-plugin-guide check --json                # 静态检查
npx dsh-plugin-guide verify                      # 打包 + 干净 profile 冒烟

Install & uninstall

• git channel（最新 main）：dsh plugin --profile web add github:PerryLink/dsh-plugin-guide#<sha> —— 固定提交以可复现；入口是纯 ESM JS，无构建步骤。
• npm channel（发布版本）：dsh plugin --profile web add dsh-plugin-guide。
• tarball channel：在本仓库执行 pnpm pack，然后 dsh plugin --profile web add ./dsh-plugin-guide-<version>.tgz。
• uninstall：dsh plugin --profile web remove dsh-plugin-guide。

Copy as a plain agent skill

你也可以把整个文件夹复制到 agent 的技能目录（相对路径保持完好）：

# Windows (PowerShell)
pwsh -File scripts/install-skill.ps1 `
  -Target "$env:USERPROFILE\.deepseek\skills\dsh-plugin-guide"   # 或 <project>\.agents\skills\dsh-plugin-guide

# macOS / Linux
pwsh -File scripts/install-skill.ps1 -Target ~/.deepseek/skills/dsh-plugin-guide   # 或 <project>/.agents/skills/dsh-plugin-guide

安装器跳过 downloads/（生成的）与 .github/，然后逐字节校验每个复制的文件。手动 Copy-Item -Recurse 整个文件夹也可以。

Configuration

技能 bundle 不暴露任何 Schemastery Config —— 它把知识库注册为 agent 技能，无可调键。dsh-plugin-dev CLI 从 flag 与 DSH_PLUGIN_DEV_* 环境变量读取可调项（见 CLI toolchain）。

Tools & surfaces

Surface	Kind	Notes
dsh-plugin-guide	skill	经 ctx.skills 注册；按需加载 SKILL.md + ./guide/ + ./references/
dsh-plugin-dev	bin (CLI)	new / check / verify 子命令；非 DSH 插件行

Permissions & data

• Permissions：workshop 清单声明 filesystem:read。
• Data：只读 —— 仅读取自身打包的 guide/ 与 references/ 文件。无网络请求、无写入、无模型调用。

Security boundaries

• 只读知识库。 bundle 只读取自身文件；绝不写入、绝不联网、绝不调用模型。
• 官方文档是逐字副本。 references/official-docs/ 从不在本仓库修改；问题反馈给上游，且只经 scripts/sync-official-docs.ps1 重新同步。
• 分发边界。 打包的第三方内容保留其上游许可；见 NOTICE.md（如 downloads/ 仅本地、awesome-dsh-plugins 不得再分发）。

Known limitations

• 官方文档是快照。 上游变化时用 scripts/sync-official-docs.ps1 重新同步；新鲜度戳与提交号引用 references/official-docs/SNAPSHOT.md。
• downloads/ 由脚本生成、不入库。 原始快照（社区仓库归档、Discussions、文章）使用前需用脚本生成。
• awesome-dsh-plugins 内容仅本地。 其上游声明内部使用约束，故不随仓库再分发。

Keeping it fresh

pwsh -File scripts/sync-official-docs.ps1                     # 从本地 checkout 取逐字文档副本
pwsh -File scripts/download-sources.ps1                       # 官方站点/文档、Cordis、论文
pwsh -File scripts/download-community-repos.ps1               # 社区仓库（codeload tarballs）
pwsh -File scripts/download-community-articles.ps1            # zh/en/HN 社区文章
pwsh -File scripts/archive-discussions.ps1                    # 官方 Discussions（需 $env:GH_TOKEN）
pwsh -File scripts/gen-topic-snapshot.ps1 -OutDir <dir>       # dsh-plugin 话题普查
pwsh -File scripts/verify-kit.ps1 -Checkout <checkout>        # 关键路径 + 链接扫描 + 文档漂移

Development

技能 bundle（index.js）是纯 ESM、无构建步骤；dsh-plugin-dev CLI 是 TypeScript，经 tsdown 构建。门禁：

pnpm install --frozen-lockfile
pnpm run typecheck && pnpm run typecheck:ci
pnpm test
pnpm run build
pnpm run verify:artifacts        # 自检 + 脚手架冒烟（无网络）
pnpm run verify:self-contained   # 打包 + 干净 profile 安装/启动/卸载冒烟
pnpm pack
pwsh -File scripts/verify-kit.ps1   # 关键路径 + 链接扫描（加 -Checkout <checkout> 做文档漂移）

Topics

dsh, deepseek-harness, dsh-plugin, cordis, agent-skill, plugin-development, knowledge-base, cli, scaffold, checker

Contributors

• PerryLink —— 创建者与维护者：知识库内容、可安装 bundle 改造、生态提交与社区工程。
• 日常维护由 DeepSeek Harness agents 辅助（它们无 GitHub 账号，为透明起见列于此，不作贡献者）。

PerryLink DSH Plugin Family

This project is one of the 45 DeepSeek Harness plugins maintained by PerryLink. If this one helps you, the others likely will too:

Plugin	One-liner
dsh-auto-review	Second-model auto-review on the approval chain, fail-closed by default
dsh-autotier	Automatic strong/cheap model-tier routing with deterministic risk guards and a /tier command
dsh-background-agents	Durable background child agents with a Web UI sidebar, messaging and interrupt
dsh-budget	Cost governance for DeepSeek Harness: budgets, carbon, and latency in one panel.
dsh-catalog	DSH Desktop Market standard catalog source for the PerryLink family
dsh-cert-mcp	Read-only MCP server exposing the certification registry: grades, snapshots and five-dimension evidence
dsh-checkpoint-rewind	Claude Code /rewind-equivalent: snapshots, session forks, one-shot restore
dsh-claude-move	Migrate Claude Code sessions, memory, skills and CLAUDE.md into DSH
dsh-click	Cross-platform native desktop control for DeepSeek Harness — Windows first.
dsh-composer-history	Terminal-style input history for the web composer: arrows, Ctrl+R search
dsh-data-quality	Dataset quality checks and citation cross-checks (the optional numeric bridge consumed here)
dsh-defend	Prompt-injection, jailbreak, and secret-leak defense for DeepSeek Harness.
dsh-doublecheck	Engineering-discipline guard: requirements grill, test gates, adversary review
dsh-draw	Unified static-image generation routing for DeepSeek Harness.
dsh-fast	Read-only performance diagnostics for DeepSeek Harness.
dsh-fund-research	Deterministic research reports for Chinese public mutual funds
dsh-github	GitHub PR/issues integration for DSH, every write gated by approval
dsh-industry-research	Industry research orchestration that seals its deliverables through this plugin's ctx.researchReport.assemble
dsh-laya	Laya typed decisions (noul/choice/score) as a first-class Cordis service and model-visible tools
dsh-library	Local document knowledge base for DeepSeek Harness.
dsh-local-ai	Local-model (Ollama) integration for DeepSeek Harness.
dsh-lsp-actions	LSP diagnostics, formatting, completion, code actions and rename over language servers
dsh-mask	PII masking middleware: anonymize at the model boundary, restore at the display layer
dsh-mcp-panel	Read-only MCP runtime panel: /mcp command + Settings tab with status, tools and errors
dsh-memento	Approval-gated cross-session memory: ctx.memory seam + SQLite + memory tool
dsh-observe	OpenTelemetry and Langfuse observability exporter for DeepSeek Harness.
dsh-output-styles	Claude Code outputStyles-equivalent runtime style switching
dsh-permission-rules	Claude Code-style declarative allow/deny/ask permission rules with audit
dsh-plugin-certification	Community certification registry with repro-checkable grades and badges
dsh-plugin-doctor	Zero-dependency static + sandbox smoke detector for DSH plugins
dsh-plugin-guide	Plugin-development knowledge base as an on-demand agent skill
dsh-plugin-kit	Shared zero-runtime-dependency toolkit for the PerryLink DSH plugins
dsh-plugin-upgrade	One-package, one-corridor-index plugin upgrade skill: routes a repository to the matching closed corridor card
dsh-plugin-upgrade-015	Merged 0.1.3-alpha.1 → 0.1.5-rc.1 upgrade corridor card plus a zero-dependency seam scanner
dsh-reach	Multi-channel approval/question bridge: WeChat/Telegram/Feishu, session console
dsh-research-report	Verifiable research-report engine: content-addressed evidence ledger and sealed versions
dsh-score	Multi-dimensional quality scoring for DeepSeek Harness plugins.
dsh-session-pin	Pin sessions in the Web sidebar with durable ordering
dsh-session-sync	Cross-device session sync for DeepSeek Harness — a dedicated git mirror of your session store.
dsh-skill-pack-security	Security-audit skill pack: secret scan, dependency and supply-chain review
dsh-talk	Voice-first session loop for DeepSeek Harness: talk to it, hear it answer.
dsh-team-rooms	Cross-session team rooms: shared message bus, task board and timeline
dsh-test-drive	Isolated install-and-smoke test drives for DeepSeek Harness plugins.
dsh-ticktick	TickTick/Dida365 task bridge: session-header panel + 11 tools
dsh-translate	Vendor parameter translation and deterministic JSON repair for DeepSeek Harness.

Disclaimer

社区维护，非 DeepSeek 官方产品。DeepSeek Harness 处于开发者预览期并发布破坏性变更；有疑问时，以 references/official-docs/ 中的官方文档为准。

License

Apache License 2.0 © 2026 dsh-plugin-guide contributors —— 自有文本（SKILL.md、guide/、references/、scripts/、本 README）按 Apache-2.0；打包的第三方内容见 NOTICE.md。

从 DSH Desktop 市场安装

所有 PerryLink 插件均可在 DSH Desktop 内置市场中浏览：市场 → 来源 → 添加来源 → 粘贴 https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → 选中。安装仍需通过市场的 npm 身份校验与你的确认。