dsh-plugin-guide 0.3.42 → 0.4.0

package/NOTICE.md

@@ -1,26 +1,11 @@
-# NOTICE — 第三方内容归属与许可说明
+# NOTICE
 
-本仓库（dsh-plugin-guide）是对 DeepSeek Harness 插件开发资料的研究归档。**本仓库自有文本**（`SKILL.md`、`guide/`、`references/` 下的调研报告与汇总、`scripts/`、`README.md`）以 **Apache License 2.0** 许可发布（见 [LICENSE](LICENSE)）。
+`dsh-plugin-guide` is a community guide. It is **not** an official DeepSeek
+Harness standard, certification, security audit, endorsement, or ranking.
 
-## 归档的第三方内容及其许可
+The guide's own text is licensed under Apache-2.0 (see `LICENSE`). It links to
+upstream projects and source documents; those remain under their own licenses.
+No upstream documentation mirror is redistributed in this package.
 
-| 归档位置 | 来源 | 上游许可 | 说明 |
-|---|---|---|---|
-| `references/official-docs/docs/**` | [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) 的 `docs/`（含全部中英双语文档） | MIT | 官方文档全文副本，用于离线阅读 |
-| `references/official-docs/AGENTS.md` 等 | 同上仓库根/子目录文档 | MIT | 同上 |
-| `downloads/github/cordis/**` | [cordiverse/cordis](https://github.com/cordiverse/cordis) | MIT | 上游 README/文档快照（`downloads/` 不入 git，脚本再生） |
-| `downloads/github/paper/**` | [cordiverse/paper](https://github.com/cordiverse/paper) | MIT | 论文 README 与 paper.pdf（不入 git，脚本再生） |
-| `downloads/community-repos/**` | 114 个社区仓库（omdsh-dev/*、vlln/*、文档型教程/skill 集合/目录市场/桌面端/安全 PoC 等，清单见 `references/community-ecosystem.md`） | 各异（MIT / BSD-3-Clause / Apache-2.0 等，以各仓库 LICENSE 为准） | 完整源码快照，仅供本地研究（不入 git，脚本再生） |
-| `downloads/web/**` | deepseek-harness.github.io、deepseek.com | 站点所有权利归原作者 | 页面 HTML 快照（不入 git，脚本再生） |
-
-## 分发边界（重要）
-
-- **`downloads/` 目录整体不进入版本库、不随本仓库再分发**：其内容为可再生的第三方快照（由 `scripts/download-sources.ps1` 与 `scripts/download-community-repos.ps1` 生成），其中部分内容上游带私有/内部使用约束或需要原许可授权。
-- **`downloads/community-repos/awesome-dsh-plugins/`（AdamPlatin123/awesome-dsh-plugins）**：其仓库内 AGENTS.md 声明内容源自私有组织调研、**仅限内部使用、不得公开分发**。本仓库仅在本机留存其公开可下载内容作参考，**严禁将其内容随本仓库或任何形式再分发**；如需公开引用，仅引用其公开 URL 与公开目录信息。
-- 各社区仓库的许可以其自带 LICENSE 为准；再分发任何社区代码前请逐仓核对其许可与约束。
-- 本知识库不构成 DeepSeek 或任何上游项目的官方背书；所有结论请对照官方原文使用。
-
-## 更新与维护
-
-- 首次使用/刷新归档：运行 `scripts/download-sources.ps1` 与 `scripts/download-community-repos.ps1`（需网络）。
-- 同步官方文档：`pwsh -File scripts/sync-official-docs.ps1 -Checkout <deepseek-harness-checkout>`（只同步 git 已跟踪文件，快照记录见 `references/official-docs/SNAPSHOT.md`）。
+`dsh-standards` (checks) and `dsh-plugin-spec` (rule text) are separate
+projects. `dsh-primer` is the old build/scaffold skill and CLI.

package/PRIVACY.md

@@ -0,0 +1,11 @@
+# Privacy
+
+`dsh-plugin-guide` is a local DeepSeek Harness plugin.
+
+- It reads only the workspace files, configuration and tool inputs needed for its documented features.
+- It does not add telemetry, analytics, advertising or a hosted account, and it sends no data to PerryLink.
+- Any network access or external service used by the plugin is documented in its README and is controlled by the user's own configuration.
+- It writes no data outside the DSH profile, the workspace, and the host's own session/log storage. The host controls that storage and its retention.
+- Removing the package removes its code; it does not delete host logs, workspace files or documents you already created.
+
+This statement covers the npm package, not the DSH host or any other plugin in the profile.

package/README-zh.md

@@ -1,457 +1,82 @@
-> **已迁移：** 此包现已迁至 **[dsh-primer](https://www.npmjs.com/package/dsh-primer)**。旧包 `dsh-plugin-guide` 已弃用；请安装 `dsh-primer`。
-
 <div align="center">
 
-# 🐳 dsh-plugin-guide
-
-**构建 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 插件所需的一切。**
+# dsh-plugin-guide
 
-*官方文档档案 · Cordis 入门 · 社区深读 · 实战踩坑 · agent 技能 · CLI 工具链*
+**DSH 插件质量指南：ENTRY、FLOW、BOOST。**
 
-> **官方仓库。** 本仓库是 dsh-plugin-guide 的唯一官方仓库，由 PerryLink 维护。其他账号下的同名仓库与本项目无关。
+社区指南，不是官方标准、不是认证、不是排名。
 
-
-```sh
-dsh plugin --profile web add dsh-plugin-guide
-```
+[![npm](https://img.shields.io/npm/v/dsh-plugin-guide)](https://www.npmjs.com/package/dsh-plugin-guide)
+[![CI](https://github.com/PerryLink/dsh-plugin-guide/actions/workflows/verify.yml/badge.svg)](https://github.com/PerryLink/dsh-plugin-guide/actions/workflows/verify.yml)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
-[![Gitee](https://img.shields.io/badge/Gitee-mirror-c71d23?logo=gitee)](https://gitee.com/perrylink/dsh-plugin-guide)
-[![DSH plugin](https://img.shields.io/badge/dsh--plugin-✅-green)](https://github.com/topics/dsh-plugin)
-[![dsh-doctor](https://raw.githubusercontent.com/PerryLink/dsh-plugin-doctor/main/badges/PerryLink__dsh-plugin-guide.svg)](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
-[![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-top-rated.svg)](https://dsh.market/)
-[![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
-[![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-plugin-guide/verify.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-plugin-guide/actions)
-[![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-plugin-guide?label=version)](https://github.com/PerryLink/dsh-plugin-guide/releases)
-[![npm version](https://img.shields.io/npm/v/dsh-plugin-guide)](https://www.npmjs.com/package/dsh-plugin-guide)
-[![npm downloads](https://img.shields.io/npm/dm/dsh-plugin-guide)](https://www.npmjs.com/package/dsh-plugin-guide)
-[![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-plugin-guide?metric=downloads&lang=zh)](https://dshfind.com/zh/plugins/PerryLink/dsh-plugin-guide?ref=badge)
-
-[English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
-
-```sh
-dsh plugin --profile <name> add dsh-plugin-guide
-```
 
+[English](README.md) · [简体中文](README-zh.md)
 
 </div>
 
 ---
 
-**📖 想在网页上读？** [perrylink.github.io/dsh-plugin-guide](https://perrylink.github.io/dsh-plugin-guide/) —— 每章独立成页，另有给助手用的机器可读 [llms.txt](https://perrylink.github.io/dsh-plugin-guide/llms.txt)。
-
-## 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`。
-
-## Why not just read the official docs?
-
-因为官方文档是写给"已经知道该翻哪一页"的人的，而 DSH **每 1.7–2.8 天发一个 prerelease**，且带破坏性变更。本插件补的正是最耗时间的三处缺口：
-
-| 缺口 | 本插件补什么 |
-|---|---|
-| **"我到底在对着哪一版开发？"** | [版本矩阵](guide/version-matrix.md)：四个都自称"最新"的值、子包 `latest` 冻结陷阱、破坏性变更断层，以及 `peerDependencies` 区间怎么选。**不存在稳定版**——所有已发布版本都是 prerelease。 |
-| **"这一版破坏了什么？"** | [迁移指南](guide/migration-0.2.md)：把 `0.1.6-alpha.2` → `0.2.1-alpha.2` 整理成**可引用的 seam**，每条含症状*与*修法并附官方出处——其中包括一处数据丢失风险和一处"模型请求还没发出就失败"的变更。 |
-| **"我的插件真的对吗？"** | [零依赖 CLI](SKILL.md)（`dsh-plugin-dev new / check / verify`）+ [官方文档逐字离线镜像](references/official-docs/)，让 agent 能引确切页面而不是靠猜。 |
-
-**60 秒自证：**
-
-```sh
-dsh plugin --profile web add dsh-plugin-guide
-```
-
-<!-- star-cta -->
-## ⭐ 如果它帮到了你
-
-这个插件是 [DSH 插件家族](https://github.com/PerryLink)的一员（95 个，全部 Apache-2.0）。如果你在用，**给个 star** —— 它不会解锁任何功能，但会让下一个人在搜索里更容易找到它。
-
-*English:* part of a 95 plugin family for DeepSeek Harness. If it is useful, **a star helps the next person find it** — nothing is gated behind it.
-
-## What is dsh-plugin-guide?
-
-构建 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 插件所需的一切。
-
-官方文档档案 · Cordis 入门 · 社区深读 · 实战踩坑 · agent 技能 · CLI 工具链
+## 这是什么
 
-![dsh-plugin-guide 工作流图：请求 → 策略/复核 → 判定。](docs/assets/dsh-plugin-guide-flow.svg)
+`dsh-plugin-guide` 是 DSH 插件的**指南层**：解释要检查什么、为什么重要，以及
+判定应该由哪个工具负责。它不做认证、不打分、不排名。
 
-*工作流概览：请求 → 策略/复核 → 判定。下面的示例使用实际命令面。*
-
-
-*同一次运行，动图版。*
-
-## Comparison
-
-![dsh-plugin-guide 的实测对比柱状图](https://raw.githubusercontent.com/PerryLink/dsh-plugin-guide/main/docs/assets/dsh-plugin-guide-evidence.png)
-
-content counts as stated in the README (What you get)
-
-## Compatibility
-
-| Surface | Status |
+| 包 | 角色 |
 |---|---|
-| Harness | DeepSeek Harness `dsh-v0.2.1-alpha.2`（`d743267388641bc76f17c45ce8b4c231aed1d32c`，master 最新 tag **且** = master HEAD，2026-10-09）；npm `latest`=`next`=`0.2.0-rc.2`、`alpha`=`0.2.1-alpha.2`。**不存在稳定版**——全部 31 个 npm 版本与 26 个 GitHub Release 都是 prerelease。官方文档副本与 [guide/migration-0.2.md](guide/migration-0.2.md) 钉在上一版 `dsh-v0.2.1-alpha.1`（`5badb15009`，2026-10-03）；此后新增的 20 份破坏性变更指南收录于 [guide/version-matrix.md](guide/version-matrix.md) §3。 |
-| Node | `^22.19.0 || >=24.0.0`（DeepSeek Harness 运行时） |
-| 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 配置。
-- **版本适配** —— [guide/version-matrix.md](guide/version-matrix.md)：五个"最新"的区别、子包 `latest` 冻结陷阱、四个破坏性变更断层、peer 区间怎么选、会话格式 V0→V4 谱系，以及 `0.2.1-alpha.2` 落的 19 条破坏性变更。
-- **官方文档档案** —— 官方仓库文档（英 + 中）逐字副本，在最近核验快照处与上游逐字节一致。
-- **Cordis 入门** —— 五个概念与机制时间线（repository-plugin 0809 引入、0811 移除；两条安装通道）。
-- **20+ 个实战踩坑** —— 附根因 + 修法（cordis 双副本、tsconfig 三件套、多帧 zstd 会话、Windows junction、过期 npm `latest`…）。
-- **社区深读** —— 归档 114 个社区仓库（15 个深读），外加每条事实都链回出处的完整来源索引。
-- **CLI 工具链** —— `dsh-plugin-dev new / check / verify`：脚手架、静态检查、打包验证 DSH 插件；每个检查项都链回它强制执行的技能章节。
-
-- **家族工具链路由** —— [guide/family-toolchain.md](guide/family-toolchain.md)：哪个工具负责哪个问题、`dsh-plugin-doctor` 33 项检查全表，以及与本库 16 项检查的交叉对照。
-- **镜像范围决策** —— [references/mirror-scope-decision.md](references/mirror-scope-decision.md)：为什么"删掉零引用内容以省 80% 体积"经复测**不成立**（它们被本库自己声明的宽 glob 覆盖）。
-- **官方自带技能要点** —— [references/official-plugin-dev-skill.md](references/official-plugin-dev-skill.md)：官方 `cordis-plugin-development` 技能的禁则、展示元数据清单与 UI/性能规则。
-- **采用分级（非官方）** —— [guide/standards.md](guide/standards.md)：DSH-ENTRY / DSH-FLOW / DSH-BOOST 三层模型、"采用深度 × 证据状态"两轴表、每层**不**声称什么，以及升级路径。GB / GB-T / GB-Z 仅为类比；认证 A–D 与三层正交。
-## 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/version-matrix.md` | **版本适配矩阵**：五个"最新"的区别、子包 `latest` 冻结、破坏性变更断层、peer 区间选择、会话格式谱系、`0.2.1-alpha.2` 的 19 条变更 |
-| `guide/quick-reference.md` | 一页速查表（5 语言） |
-| `guide/links.md` | 精选 URL 索引：官方开发文档（站点 ↔ 本地副本）+ 社区文档链接 |
-| `guide/when-to-retire-a-plugin.md` | 插件退役与冻结：一次组合审计的判据与实测数据（中英双语） |
-| `guide/choosing-a-plugin.md` | 插件选型：每个能力面该用哪个，含实测数字与核验警示（中英双语） |
-| `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/` 生成、不入库 |
-| `guide/family-toolchain.md` | **家族工具链路由**：问题→所有者→可引用产物；`dsh-plugin-doctor` 33 项检查全表与裁定语义；本库 16 项检查的交叉对照 |
-| `guide/migration-0.2.md` | 0.2 世代破坏性变更迁移指南（§0–§12 覆盖到 `0.2.1-alpha.1`，**§13 覆盖 `0.2.1-alpha.2` 的 19 个 seam**） |
-| `references/mirror-scope-decision.md` | 镜像范围决策记录：为什么不按"零引用"裁剪（附可复跑的测量脚本） |
-
-## CLI toolchain
+| **`dsh-plugin-guide`** | 本包：文字指南、三层地图、agent skill |
+| **`dsh-standards`** | 执行总包：ENTRY/FLOW 检查、三层审计、规范文件 |
+| **`dsh-plugin-spec`** | 底层规则文本与条款来源 |
+| **`dsh-primer`** | 旧的构建/脚手架技能和 CLI（原 `dsh-plugin-guide` 0.3.x） |
 
-bundle 附带零运行时依赖的 `dsh-plugin-dev` CLI（`bin/` → tsdown 打包的 `dist/dsh-plugin-dev.js`）。每个检查项都引用它强制执行的技能章节，agent 可继续人工审计。
+## 三层
 
-```sh
-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>]
-dsh-plugin-dev seams <query> | --since <version>   # 这个 API 在我目标宿主里存在吗？
-```
-
-| 子命令 | 作用 |
-|---|---|
-| `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 |
+| 层 | 回答 | 能否判定 |
+|---|---|---|
+| **ENTRY** | 能不能被识别、安装、启动 | 能：recognized / runtime / failed / incomplete / unavailable |
+| **FLOW** | 用户能不能装、配、用、升级、卸载 | 有 runtime 证据时能；否则 `not-run` |
+| **BOOST** | 有没有用好 Cordis | 不给插件级判定；按实践登记证据 |
 
-### Upstream roadmap
+三条轨道，不是三个等级；它们相加不等于分数或证书。
 
-`dsh-plugin-dev` 是官方插件开发 CLI（规划项 C12）的上游候选：脚手架/检查器/验证器是机械层，`SKILL.md` + `guide/` 仍是认知层。
+先读一页地图：[docs/levels.md](docs/levels.md)。
 
-## Quick start
+## 安装
 
 ```sh
-# 1. install the bundle into your profile
-dsh plugin --profile web add github:PerryLink/dsh-plugin-guide
-
-# 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 技能帮我构建一个 … 插件。"*
+然后在审查插件时让 agent 使用 `dsh-plugin-guide` 技能。它会将检查交给
+`dsh-standards`，将构建/脚手架工作指向 `dsh-primer`。
 
-或者直接驱动 CLI：
+## 检查插件
 
 ```sh
-npx dsh-plugin-guide new hello-plugin            # 脚手架生成 TS 插件仓库
-npx dsh-plugin-guide check --json                # 静态检查
-npx dsh-plugin-guide verify                      # 打包 + 干净 profile 冒烟
-```
-
-## Copy as a plain agent skill
-
-你也可以把整个文件夹复制到 agent 的技能目录（相对路径保持完好）：
+# 只做 ENTRY 识别（不声明 runtime）
+npx dsh-standards ./my-plugin --scope entry --entry-claim static
 
-```powershell
-# Windows (PowerShell)
-pwsh -File scripts/install-skill.ps1 `
-  -Target "$env:USERPROFILE\.deepseek\skills\dsh-plugin-guide"   # 或 <project>\.agents\skills\dsh-plugin-guide
+# 三层审计；没跑的层保持 not-run / not-measured
+npx dsh-levels audit ./my-plugin --format json
 ```
 
-```bash
-# 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` 整个文件夹也可以。
-
-### 示例
-
-以下为插件真实入口；安装后调用一个即可。
-
-#### 详细示例
-
-**命令**
-
-~~~sh
-dsh-plugin-dev seams L3
-~~~
-
-**输出**
-
-~~~text
-1 seam(s):
-
-L3  webRuntime service replaced by webStartup
-    kind        service-renamed
-    lands in    0.2.1-alpha.2
-    confidence  documented
-    official    docs/upgrade-guide/v0.2.1-alpha.1/web-listener-trust-config/guide.md
-    removed     service webRuntime; row web-runtime; ctx.webRuntime.lanAddresses; wildcard --host
-    instead     webStartup (row web-startup), concrete host literals
-    detectable  yes — inspect: src/**/*.ts, cordis.patch.yml
-~~~
-
-*来源 `README.md:152 (CLI toolchain); src/cli/commands/seams.ts:54; data/seams/index.json:44`*
-
-#### 失败分支
-
-**输入**
-
-~~~text
-node bin/dsh-plugin-dev.js seams no-such-seam-xyz
-~~~
-
-**输出**
-
-~~~text
-no seam or capability matches "no-such-seam-xyz". This is an absence of evidence in the knowledge base, not evidence that the API is absent from your target host — check references/official-docs/ before concluding either way.
-~~~
-
-*来源 `plugins/dsh-plugin-guide/src/cli/lib/seams.ts:122-130; plugins/dsh-plugin-guide/src/cli/commands/seams.ts:87-92; plugins/dsh-plugin-guide/tests/seams.test.ts:88-90`*
-
-#### 简短示例
-
-
-
-## Configuration
-
-技能 bundle 不暴露任何 Schemastery `Config` —— 它把知识库注册为 agent 技能，无可调键。`dsh-plugin-dev` CLI 从 flag 与 `DSH_PLUGIN_DEV_*` 环境变量读取可调项（见 [CLI toolchain](#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](NOTICE.md)（如 `downloads/` 仅本地、`awesome-dsh-plugins` 不得再分发）。
-
-## Known limitations
-
-- **官方文档是快照。** 上游变化时用 `scripts/sync-official-docs.ps1` 重新同步；新鲜度戳与提交号引用 `references/official-docs/SNAPSHOT.md`。
-- **`downloads/` 由脚本生成、不入库。** 原始快照（社区仓库归档、Discussions、文章）使用前需用脚本生成。
-- **`awesome-dsh-plugins` 内容仅本地。** 其上游声明内部使用约束，故不随仓库再分发。
-
-## Release channels
-
-所有渠道都从本仓库或 npm 解析，因此**推一个 tag 就能到所有渠道**；只有 Gitee 镜像是定时拷贝：
-
-| 渠道 | 真源 | 更新方式 |
-|---|---|---|
-| npm（`dsh-plugin-guide`） | 本仓库的 `package.json` | `v*` tag 触发 `.github/workflows/release.yml`：`verify-kit` 门禁 → 校验 CHANGELOG 有该版本段 → `npm publish --provenance`（版本已存在则跳过） |
-| GitHub Release | 同一个 tag | 同一 workflow 幂等创建 |
-| 展示徽章（npm 版本、GitHub tag、DSH Market、dsh-doctor） | 实时查询 | 无需发布——每次渲染都读 npm/registry |
-| Gitee 镜像 | 本仓库 | **只读定时镜像**，不是发布目标：由家族仓的 `gitee-sync` workflow 用 `--force-with-lease` 强制对齐 GitHub tip，所以 `main` 通常落后一次定时运行。**这里从不对 Gitee 推 tag**；报"镜像过期"前先用 `git ls-remote` 与 GitHub 对比 |
-| DSH Desktop Market / dsh1024 | npm | 市场装的就是 npm 包，发布即可安装，无需逐版本投稿 |
-## Keeping it fresh
-
-```sh
-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 构建。门禁：
-
-```sh
-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 run check:readmes           # five READMEs share section structure
-pnpm run check:parity            # translations have identical block counts
-pnpm run check:facts             # self-stated numbers match data/facts.json
-pnpm run check:ps1-bom           # PowerShell scripts keep their UTF-8 BOM
-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](https://github.com/PerryLink) —— 创建者与维护者：知识库内容、可安装 bundle 改造、生态提交与社区工程。
-- [@Yisa-yi](https://github.com/Yisa-yi) —— **产品经理**。全流程参与项目设计，从最初的大纲到最终发布的 bundle，负责的是产品形态而非代码：确定它以「可安装 bundle + 按需注册 agent skill」的形态交付（文档站只渲染同一批源文件，不另立一套内容）；确定 10 章开发指南的信息架构；确立「每条事实必须链接出处」的纪律；以及把认知层（`SKILL.md` + `guide/`）与机械层（`dsh-plugin-dev new / check / verify`）分开的分层设计。也确定了 `guide/unfixed-issues.md` 的证据标准——每条都带针对指定宿主提交的 `path:line`、设计取舍与真 bug 对照表，以及明确的「无法复现」小节——以及 `guide/when-to-retire-a-plugin.md` 的冻结/退役判据。守住范围边界（只读、不联网、不调用模型、无配置项）与五语 README 同步的要求。
-- 日常维护由 DeepSeek Harness agents 辅助（它们无 GitHub 账号，为透明起见列于此，不作贡献者）。
-
-## PerryLink DSH Plugin Family
-
-本项目是 [PerryLink](https://github.com/PerryLink) 维护的 DeepSeek Harness 插件家族成员。完整名单默认折叠，避免每个 README 的首屏被长表淹没；点击展开可查看每一行及其状态。
-
-<details>
-<summary>展开全部插件</summary>
-
-| 插件 | 状态 |
-|---|---|
-| **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** |  |
-| **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** |  |
-| **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** |  |
-| **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** |  |
-| **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** |  |
-| **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** |  |
-| **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** |  |
-| **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** |  |
-| **[dsh-click](https://github.com/PerryLink/dsh-click)** |  |
-| **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** |  |
-| **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** |  |
-| **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** |  |
-| **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** |  |
-| **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** |  |
-| **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** |  |
-| **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** |  |
-| **[dsh-eia-guide-check](https://github.com/PerryLink/dsh-eia-guide-check)** |  |
-| **[dsh-emergency-plan](https://github.com/PerryLink/dsh-emergency-plan)** |  |
-| **[dsh-essay-rubric-check](https://github.com/PerryLink/dsh-essay-rubric-check)** |  |
-| **[dsh-evidence-check](https://github.com/PerryLink/dsh-evidence-check)** |  |
-| **[dsh-export-ctl-check](https://github.com/PerryLink/dsh-export-ctl-check)** |  |
-| **[dsh-fast](https://github.com/PerryLink/dsh-fast)** |  |
-| **[dsh-fmea-table-check](https://github.com/PerryLink/dsh-fmea-table-check)** |  |
-| **[dsh-forecast-penalty](https://github.com/PerryLink/dsh-forecast-penalty)** |  |
-| **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** |  |
-| **[dsh-github](https://github.com/PerryLink/dsh-github)** |  |
-| **[dsh-gongwen-flow-check](https://github.com/PerryLink/dsh-gongwen-flow-check)** |  |
-| **[dsh-gongwen-word-check](https://github.com/PerryLink/dsh-gongwen-word-check)** |  |
-| **[dsh-guard-plan-qc](https://github.com/PerryLink/dsh-guard-plan-qc)** |  |
-| **[dsh-hazchem-check](https://github.com/PerryLink/dsh-hazchem-check)** |  |
-| **[dsh-hazplan-check](https://github.com/PerryLink/dsh-hazplan-check)** |  |
-| **[dsh-hidden-risk-map](https://github.com/PerryLink/dsh-hidden-risk-map)** |  |
-| **[dsh-hs-classify](https://github.com/PerryLink/dsh-hs-classify)** |  |
-| **[dsh-icd-rule-check](https://github.com/PerryLink/dsh-icd-rule-check)** |  |
-| **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** |  |
-| **[dsh-lawcite-adapter](https://github.com/PerryLink/dsh-lawcite-adapter)** |  |
-| **[dsh-laya](https://github.com/PerryLink/dsh-laya)** |  |
-| **[dsh-lc-doc-check](https://github.com/PerryLink/dsh-lc-doc-check)** |  |
-| **[dsh-learning-gap-check](https://github.com/PerryLink/dsh-learning-gap-check)** |  |
-| **[dsh-library](https://github.com/PerryLink/dsh-library)** |  |
-| **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** |  |
-| **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** |  |
-| **[dsh-mask](https://github.com/PerryLink/dsh-mask)** |  |
-| **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** |  |
-| **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** |  |
-| **[dsh-memento](https://github.com/PerryLink/dsh-memento)** |  |
-| **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** |  |
-| **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** |  |
-| **[dsh-observe](https://github.com/PerryLink/dsh-observe)** |  |
-| **[dsh-origin-rvc-check](https://github.com/PerryLink/dsh-origin-rvc-check)** |  |
-| **[dsh-ota-review-check](https://github.com/PerryLink/dsh-ota-review-check)** |  |
-| **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** |  |
-| **[dsh-paper-doc-adapter](https://github.com/PerryLink/dsh-paper-doc-adapter)** |  |
-| **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** |  |
-| **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** |  |
-| **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** |  |
-| **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** |  |
-| **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** |  |
-| **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** |  |
-| **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** |  |
-| **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** |  |
-| **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** |  |
-| **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** |  |
-| **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** |  |
-| **[dsh-ppap-check](https://github.com/PerryLink/dsh-ppap-check)** |  |
-| **[dsh-protest-deadline](https://github.com/PerryLink/dsh-protest-deadline)** |  |
-| **[dsh-railway-window](https://github.com/PerryLink/dsh-railway-window)** |  |
-| **[dsh-repair-order-qc](https://github.com/PerryLink/dsh-repair-order-qc)** |  |
-| **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** |  |
-| **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** |  |
-| **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** |  |
-| **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** |  |
-| **[dsh-score](https://github.com/PerryLink/dsh-score)** |  |
-| **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** |  |
-| **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** |  |
-| **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** |  |
-| **[dsh-soe-decision-check](https://github.com/PerryLink/dsh-soe-decision-check)** |  |
-| **[dsh-soilwater-check](https://github.com/PerryLink/dsh-soilwater-check)** |  |
-| **[dsh-sop-sync-check](https://github.com/PerryLink/dsh-sop-sync-check)** |  |
-| **[dsh-spc-gbt-adapter](https://github.com/PerryLink/dsh-spc-gbt-adapter)** |  |
-| **[dsh-talk](https://github.com/PerryLink/dsh-talk)** |  |
-| **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** |  |
-| **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** |  |
-| **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** |  |
-| **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** |  |
-| **[dsh-translate](https://github.com/PerryLink/dsh-translate)** |  |
-| **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** |  |
-| **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 已冻结 — 见仓库 README |
-| **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 已冻结 — 见仓库 README |
-| **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 已冻结 — 见仓库 README |
-| **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 已冻结 — 见仓库 README |
-| **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 已冻结 — 见仓库 README |
-| **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 已退役 — 见仓库 README |
-| **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 已退役 — 见仓库 README |
-| **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 已退役 — 见仓库 README |
-
-</details>
+`recognized` 不是通过，`static` 不是通过，`not-run` 也不是通过。
 
-## Disclaimer
+## 0.4.0 改了什么
 
-社区维护，**非** DeepSeek 官方产品。DeepSeek Harness 处于开发者预览期并发布破坏性变更；有疑问时，以 `references/official-docs/` 中的官方文档为准。
+- 旧的 agent skill 和 `dsh-plugin-dev` CLI 已迁到
+  [`dsh-primer`](https://github.com/PerryLink/dsh-primer)。
+- 本包现在是**指南层**：三层地图、检查路由、证据规则。
+- 旧 0.3.x npm 版本已标记 deprecated，已有安装仍可用；0.4.0 是产品切换，
+  锁在 `^0.3` 的用户不会自动升级。
+- 检查在 [`dsh-standards`](https://github.com/PerryLink/dsh-standards)，不在本包。
 
-## License
+## 边界
 
-[Apache License 2.0](LICENSE) © 2026 dsh-plugin-guide contributors —— 自有文本（`SKILL.md`、`guide/`、`references/`、`scripts/`、本 README）按 Apache-2.0；打包的第三方内容见 [NOTICE.md](NOTICE.md)。
+- 不做官方背书、认证、认可或安全审计。
+- 不做评分、排名或市场门禁。
+- 不伪造 runtime 证据：`static` ≠ `runtime`，`not-run` ≠ `pass`。
+- BOOST 是建议和证据，不是插件等级。
 
-### 从 DSH Desktop 市场安装
+## 许可
 
-所有 PerryLink 插件均可在 DSH Desktop 内置市场中浏览：**市场 → 来源 → 添加来源 → 粘贴** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ 选中**。安装仍需通过市场的 npm 身份校验与你的确认。
+Apache-2.0。见 [LICENSE](LICENSE) 与 [NOTICE.md](NOTICE.md)。