dsh-plugin-guide 0.4.3 → 0.4.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.en.md +370 -0
- package/README.es.md +370 -0
- package/README.hi.md +370 -0
- package/README.md +334 -52
- package/README.pt.md +370 -0
- package/docs/assets/dsh-plugin-guide-flow-dark.svg +35 -0
- package/docs/assets/dsh-plugin-guide-flow-light.svg +35 -0
- package/docs/boost.md +59 -29
- package/docs/entry.md +195 -0
- package/docs/flow.md +149 -9
- package/docs/levels.md +23 -3
- package/docs/recipes.md +251 -0
- package/docs/rules.md +99 -0
- package/package.json +1 -1
- package/README-zh.md +0 -82
package/README.md
CHANGED
|
@@ -1,88 +1,370 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
|
|
3
|
+
<picture>
|
|
4
|
+
<source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-plugin-guide-flow-dark.svg">
|
|
5
|
+
<img src="docs/assets/dsh-plugin-guide-flow-light.svg" width="100%" alt="dsh-plugin-guide 装配与路由：cordis.patch.yml 插入一行 → index.js 经 ctx.skills.register 注册技能 → SKILL.md 正文 → docs/levels.md 三层 → dsh-standards 的 dsh-levels 出判定">
|
|
6
|
+
</picture>
|
|
7
|
+
|
|
3
8
|
# dsh-plugin-guide
|
|
4
9
|
|
|
5
|
-
|
|
10
|
+
**先问对问题再动手：把 DSH 插件的 ENTRY / FLOW / BOOST 三层问清楚，判定交给真正做检查的工具。**
|
|
11
|
+
|
|
12
|
+
DSH 插件的指南层——解释要检查什么、为什么重要、判定归谁；自身不做认证、不打分、不排名，只把检查路由到 `dsh-standards`。
|
|
6
13
|
|
|
7
|
-
|
|
14
|
+
[安装](#三步上手) · [配置](#配置) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
|
|
8
15
|
|
|
9
|
-
[](LICENSE)
|
|
17
|
+
[](#兼容性)
|
|
18
|
+
[](https://www.npmjs.com/package/dsh-plugin-guide)
|
|
19
|
+
[](https://github.com/PerryLink/dsh-plugin-guide/actions/workflows/verify.yml)
|
|
20
|
+
[](#兼容性)
|
|
12
21
|
|
|
13
|
-
[
|
|
22
|
+
[](https://github.com/PerryLink/dsh-plugin-guide/stargazers)
|
|
23
|
+
[](https://www.npmjs.com/package/dsh-plugin-guide)
|
|
24
|
+
[](https://gitee.com/perrylink/dsh-plugin-guide)
|
|
25
|
+
|
|
26
|
+
```sh
|
|
27
|
+
dsh plugin --profile web add dsh-plugin-guide
|
|
28
|
+
```
|
|
14
29
|
|
|
15
30
|
</div>
|
|
16
31
|
|
|
17
|
-
|
|
32
|
+
<sub>社区指南，与 DeepSeek 官方无关；不是认证、不是排名、不是安全审计。唯一仓库：<https://github.com/PerryLink/dsh-plugin-guide>（Gitee 为只读快照）。</sub>
|
|
18
33
|
|
|
19
|
-
##
|
|
34
|
+
## 它是什么
|
|
20
35
|
|
|
21
|
-
`dsh-plugin-guide`
|
|
22
|
-
check, why it matters, and which tool owns the verdict. It does not certify,
|
|
23
|
-
score, or rank plugins.
|
|
36
|
+
`dsh-plugin-guide` 是 DSH 插件的**指南层**：它解释要检查什么、为什么重要，以及判定应该由哪个工具负责。安装后它向宿主注册一个按需加载的 agent 技能，技能正文就是 `SKILL.md`，其中的相对引用（`./docs/...`）通过 `resourceBase` 目录解析到本包。它不做认证、不打分、不排名——检查在 `dsh-standards`，规则文本在 `dsh-plugin-spec`，构建与脚手架在 `dsh-primer`。
|
|
24
37
|
|
|
25
|
-
|
|
|
38
|
+
| 包 | 角色 |
|
|
26
39
|
|---|---|
|
|
27
|
-
| **`dsh-plugin-guide`** |
|
|
28
|
-
| **`dsh-standards`** |
|
|
29
|
-
| **`dsh-plugin-spec`** |
|
|
30
|
-
| **`dsh-primer`** |
|
|
40
|
+
| **`dsh-plugin-guide`** | 本包：文字指南、三层地图、agent 技能 |
|
|
41
|
+
| **`dsh-standards`** | 执行总包：ENTRY/FLOW 检查、三层审计（`dsh-levels`）、规范文件 |
|
|
42
|
+
| **`dsh-plugin-spec`** | 底层规则文本与条款来源 |
|
|
43
|
+
| **`dsh-primer`** | 旧的构建/脚手架技能和 CLI（原 `dsh-plugin-guide` 0.3.x） |
|
|
31
44
|
|
|
32
|
-
##
|
|
45
|
+
## 三步上手
|
|
33
46
|
|
|
34
|
-
|
|
35
|
-
|---|---|---|
|
|
36
|
-
| **ENTRY** | Can it be recognized, installed, and started? | Yes: recognized / runtime / failed / incomplete / unavailable |
|
|
37
|
-
| **FLOW** | Can a user install, configure, use, upgrade, and remove it? | Yes, only where runtime evidence exists; otherwise `not-run` |
|
|
38
|
-
| **BOOST** | Does it use Cordis well? | No plugin-level verdict; per-practice evidence |
|
|
47
|
+
1. **安装**（三选一）：
|
|
39
48
|
|
|
40
|
-
|
|
49
|
+
```sh
|
|
50
|
+
# git 通道（最新 main）
|
|
51
|
+
dsh plugin --profile web add github:PerryLink/dsh-plugin-guide
|
|
52
|
+
# npm 通道（已发布版本）
|
|
53
|
+
dsh plugin --profile web add dsh-plugin-guide
|
|
54
|
+
# tarball 通道：本仓库 npm pack 后
|
|
55
|
+
dsh plugin --profile web add ./dsh-plugin-guide-<version>.tgz
|
|
56
|
+
```
|
|
41
57
|
|
|
42
|
-
|
|
58
|
+
无构建步骤：`index.js` 即发布产物，`SKILL.md` 与 `docs/` 就是技能正文。
|
|
43
59
|
|
|
44
|
-
|
|
60
|
+
2. **让 agent 用一次技能**（技能按需加载，不常驻上下文）：
|
|
45
61
|
|
|
46
|
-
```
|
|
47
|
-
dsh plugin
|
|
48
|
-
```
|
|
62
|
+
```text
|
|
63
|
+
> 用 dsh-plugin-guide 审一下 ./my-plugin：先给 ENTRY 结论，再说明哪些层是 not-run。
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
3. **验证已生效**：
|
|
67
|
+
|
|
68
|
+
```sh
|
|
69
|
+
dsh --profile web --dump-config | grep -A2 'id: dsh-plugin-guide'
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
会话技能目录里应出现 `dsh-plugin-guide`，且技能正文指向 `docs/levels.md`（`package.json#dshWorkshop.capability.expected` 记录的验收形态）。
|
|
73
|
+
|
|
74
|
+
**卸载**：`dsh plugin --profile web remove dsh-plugin-guide`（或从 profile patch 删掉该行）。注册是 Cordis effect，卸载即撤销，不留残留。
|
|
75
|
+
|
|
76
|
+
## 核心能力
|
|
77
|
+
|
|
78
|
+
- **三层地图** —— ENTRY 问「能不能被识别、安装、启动」，FLOW 问「用户能不能装、配、用、升级、卸载」，BOOST 问「有没有用好 Cordis」。三条轨道，不是三个等级；它们相加不等于分数或证书。
|
|
79
|
+
- **检查路由** —— 本包只解释与分流：一致性检查交给 `dsh-standards`，规则文本查 `dsh-plugin-spec`，要搭新插件去找 `dsh-primer`（旧的 `dsh-plugin-dev` CLI 已在那边，不在本包）。
|
|
80
|
+
- **证据规则** —— `static` ≠ `runtime`、`recognized` ≠ `pass`、`not-run` ≠ `pass`；一条 PASS 需要命令、产物、环境与日期，缺了就写 `not-run` / `not-measured` / `incomplete`。
|
|
81
|
+
- **按需技能** —— `index.js` 读取 `SKILL.md`、剥掉 YAML frontmatter，以 `source: bundled` 与目录型 `resourceBase` 注册；技能只在被问到时进场，不占常驻提示前缀。
|
|
82
|
+
- **不越权** —— 不给判定、不挂市场门禁、不冒充官方；措辞纪律写在 `SKILL.md` 与 `STANDARDS.md` 里，可逐条核对。
|
|
83
|
+
|
|
84
|
+
### 三层分工
|
|
85
|
+
|
|
86
|
+
| 层 | 回答 | 能否判定 |
|
|
87
|
+
|---|---|---|
|
|
88
|
+
| **ENTRY** | 能不能被识别、安装、启动 | 能：recognized / runtime / failed / incomplete / unavailable |
|
|
89
|
+
| **FLOW** | 用户能不能装、配、用、升级、卸载 | 有 runtime 证据时能；否则 `not-run` |
|
|
90
|
+
| **BOOST** | 有没有用好 Cordis | 不给插件级判定；按实践登记证据 |
|
|
49
91
|
|
|
50
|
-
|
|
51
|
-
The skill routes checks to `dsh-standards` and points build work at
|
|
52
|
-
`dsh-primer`.
|
|
92
|
+
先读一页地图：[docs/levels.md](docs/levels.md)。
|
|
53
93
|
|
|
54
|
-
|
|
94
|
+
### 检查命令
|
|
55
95
|
|
|
56
96
|
```sh
|
|
57
|
-
# ENTRY
|
|
97
|
+
# 只做 ENTRY 识别（不声明 runtime）
|
|
58
98
|
npx dsh-standards ./my-plugin --scope entry --entry-claim static
|
|
59
99
|
|
|
60
|
-
#
|
|
100
|
+
# 三层审计；没跑的层保持 not-run / not-measured
|
|
61
101
|
npx -p dsh-standards dsh-levels ./my-plugin --format json
|
|
62
102
|
```
|
|
63
103
|
|
|
64
|
-
|
|
65
|
-
|
|
104
|
+
`recognized` 不是通过，`static` 不是通过，`not-run` 也不是通过。退出码：`0` 完成、`1` 可归因 FAIL、`2` 未完成/not-run、`3` 用法错误——`not-run` 与 `incomplete` 不得写成 pass（见 [docs/entry.md](docs/entry.md)）。
|
|
105
|
+
|
|
106
|
+
### 0.4.0 改了什么
|
|
107
|
+
|
|
108
|
+
- 旧的 agent 技能和 `dsh-plugin-dev` CLI 已迁到 [`dsh-primer`](https://github.com/PerryLink/dsh-primer)。
|
|
109
|
+
- 本包现在是**指南层**：三层地图、检查路由、证据规则。
|
|
110
|
+
- 旧 0.3.x npm 版本已标记 deprecated，已有安装仍可用；0.4.0 是产品切换，锁在 `^0.3` 的用户不会自动升级。
|
|
111
|
+
- 检查在 [`dsh-standards`](https://github.com/PerryLink/dsh-standards)，不在本包。
|
|
112
|
+
|
|
113
|
+
## 配置
|
|
114
|
+
|
|
115
|
+
本包没有 Schemastery `Config`：`cordis.patch.yml` 只 `insert` 一行，插件不读取任何 `config.*` 键。可调整的只有这一行本身和它所在的 profile。
|
|
116
|
+
|
|
117
|
+
| 键 | 默认值 | 含义 |
|
|
118
|
+
|---|---|---|
|
|
119
|
+
| `id` | `dsh-plugin-guide` | 行标识；后续 patch 层按 `id` 覆盖该行（整行替换） |
|
|
120
|
+
| `name` | `dsh-plugin-guide` | loader 要 import 的模块（`package.json#main` → `index.js`） |
|
|
121
|
+
| `config` | 不接受 | 本包不读任何配置键；写在这里不会生效 |
|
|
122
|
+
|
|
123
|
+
<details>
|
|
124
|
+
<summary>完整补丁文件（cordis.patch.yml，9 行）</summary>
|
|
125
|
+
|
|
126
|
+
```yaml
|
|
127
|
+
# dsh-plugin-guide bundle layer: register the packaged knowledge base as an agent skill.
|
|
128
|
+
# This file is the `dsh.bundle.patch` layer (see package.json#dsh.bundle.patch).
|
|
129
|
+
# Layer semantics: a YAML array of row verbs; `insert` adds plugin rows to the
|
|
130
|
+
# composed config. Later layers override a row by `id` (whole-config replacement).
|
|
131
|
+
- insert:
|
|
132
|
+
# `id`: stable row identifier used by later layers to override this row.
|
|
133
|
+
- id: dsh-plugin-guide
|
|
134
|
+
# `name`: the module the loader imports; resolves to this package's entry (package.json#main → index.js).
|
|
135
|
+
name: dsh-plugin-guide
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
</details>
|
|
139
|
+
|
|
140
|
+
要停用：从 profile patch 删掉该行，或执行 `dsh plugin --profile web remove dsh-plugin-guide`。
|
|
141
|
+
|
|
142
|
+
## FAQ
|
|
143
|
+
|
|
144
|
+
<details>
|
|
145
|
+
<summary>它会替我判定一个插件合不合格吗？</summary>
|
|
146
|
+
|
|
147
|
+
不会。本包是指南层，不是判定层：它解释三层问题、把检查路由到 `dsh-standards`，并给出证据规则。BOOST 更没有插件级的 pass/fail——实践可以登记证据，插件不会被贴「BOOST 等级」。
|
|
148
|
+
|
|
149
|
+
</details>
|
|
150
|
+
|
|
151
|
+
<details>
|
|
152
|
+
<summary>`recognized` 或 `static` 的结果算通过吗？</summary>
|
|
153
|
+
|
|
154
|
+
不算。`recognized` 只说明包形态可被识别，`static` 只说明做过静态预检；`static` ≠ `runtime`，`not-run` ≠ `pass`。FLOW 只跑了几个 journey 时结论是 `not-run`，不是软通过——也不要把 FLOW 的通过率或等级写进 README。
|
|
155
|
+
|
|
156
|
+
</details>
|
|
157
|
+
|
|
158
|
+
<details>
|
|
159
|
+
<summary>装上它会改动我的 profile 或别的插件吗？</summary>
|
|
160
|
+
|
|
161
|
+
不会。它只向 `skills` 服务注册一个技能（名字 `dsh-plugin-guide`，`source: bundled`），注册包在 `ctx.effect()` 里，卸载或热重载即撤销；不注册工具、命令、客户端 slot 或 `webServer` 前缀，不发网络请求，权限只声明 `filesystem:read`。
|
|
162
|
+
|
|
163
|
+
</details>
|
|
164
|
+
|
|
165
|
+
<details>
|
|
166
|
+
<summary>0.3.x 的老用户怎么办？</summary>
|
|
167
|
+
|
|
168
|
+
0.3.x 已标记 deprecated，但仍可安装；0.4.0 是产品切换，锁在 `^0.3` 的 profile 不会自动升级。旧的构建/脚手架技能与 `dsh-plugin-dev` CLI 现在归 [`dsh-primer`](https://github.com/PerryLink/dsh-primer)，本包只保留指南与路由。
|
|
169
|
+
|
|
170
|
+
</details>
|
|
171
|
+
|
|
172
|
+
<details>
|
|
173
|
+
<summary>检查器和规则原文在哪？</summary>
|
|
174
|
+
|
|
175
|
+
检查器与三层审计在 [`dsh-standards`](https://www.npmjs.com/package/dsh-standards)（`npx dsh-standards`、`npx -p dsh-standards dsh-levels`），规则文本在 [`dsh-plugin-spec`](https://github.com/PerryLink/dsh-plugin-spec)。本包 `package.json` 里的 `dsh.standards` 占位仍是 entry/flow = `not-run`、boost = `not-measured`、`evidence: null`——那是「没测」，不是「通过」。
|
|
176
|
+
|
|
177
|
+
</details>
|
|
178
|
+
|
|
179
|
+
## 安全边界
|
|
180
|
+
|
|
181
|
+
- 不做官方背书、认证、认可或安全审计。
|
|
182
|
+
- 不做评分、排名或市场门禁。
|
|
183
|
+
- 不伪造 runtime 证据：`static` ≠ `runtime`，`not-run` ≠ `pass`。
|
|
184
|
+
- BOOST 是建议和证据，不是插件等级。
|
|
185
|
+
- **文本即边界。** 指南只写能指向源文档的陈述；无法测量的实践（开发工时、维护成本）记成 WARN 或备注，不编数字（见 [docs/boost.md](docs/boost.md)）。
|
|
186
|
+
- **本包非官方。** 没有认证、认可、安全审计、排名或市场门禁；对外措辞里不出现 official / certified / secure / recommended / ranked 一类声明（见 [STANDARDS.md](STANDARDS.md)）。
|
|
187
|
+
|
|
188
|
+
## 权限与数据
|
|
189
|
+
|
|
190
|
+
- **权限**：`package.json#dshWorkshop.permissions` 只声明 `filesystem:read`。插件在 `apply()` 时读取包内 `SKILL.md`，技能正文的相对引用通过目录型 `resourceBase` 解析到包内 `docs/`。
|
|
191
|
+
- **数据**：不写 workspace、不写 profile 之外的位置；不装遥测、分析、广告或托管账号，也不向 PerryLink 发送任何数据（见 [PRIVACY.md](PRIVACY.md)）。宿主自己的会话/日志存储由宿主控制其保留策略。
|
|
192
|
+
- **卸载**：移除包只删代码，不删宿主日志、workspace 文件或你已经产出的文档。
|
|
193
|
+
|
|
194
|
+
## 已知限制
|
|
195
|
+
|
|
196
|
+
- **指南不产生判定。** 本包没有 judge 能力：既不能把插件标成 pass，也不能把它标成 fail；判定只来自 `dsh-standards` 实际跑出的结果。
|
|
197
|
+
- **FLOW 运行时仍是草案。** J1/J2/J4/J6 在 fixture 上有 runtime 证据；J3/J7 只到 fixture 级 runtime；J5/J8 只有静态预检；浏览器渲染尚未覆盖——所以「只跑了几个 journey」必须写成 `not-run`（见 [docs/flow.md](docs/flow.md)）。
|
|
198
|
+
- **BOOST 的实测样例是 fixture / 合成采集。** 不是生产基线；LEV-3、LEV-6、LEV-7 证据最强，其余只有 loader/context 级 fixture；没有证据就是 `not-measured`（见 [docs/boost.md](docs/boost.md)）。
|
|
199
|
+
- **规则随宿主演进。** 基线是 2026-11-04 的 DSH `0.2.2-alpha.3` / Cordis `4.0.6-alpha.2`；Node 自 `0.2.2-alpha.2` 起要求 `>=24.9.0`；`ctx.menus` 在 `0.2.2-alpha.3` 已移除；`engines.dsh` 自 `0.2.1-alpha.4` 起单独决定版本走廊（见 [docs/levels.md](docs/levels.md)）。
|
|
200
|
+
- **`dsh.standards` 占位不是成绩。** `package.json` 里 entry/flow = `not-run`、boost = `not-measured`、`evidence: null`，它只是占位。
|
|
201
|
+
- **0.3.x 停在旧形态。** 0.3.x 是 deprecated 的旧产品线；构建/脚手架能力现在在 `dsh-primer`，本包不再提供 CLI。
|
|
202
|
+
|
|
203
|
+
## 与其他 DSH 插件的互操作性
|
|
204
|
+
|
|
205
|
+
本插件**不干扰**其他插件：
|
|
206
|
+
|
|
207
|
+
- **无工具/命令/服务键冲突。** 不注册任何工具、命令或服务键，因此不占用任何裸名，也不存在服务键冲突。
|
|
208
|
+
- **无 slot 与 HTTP 路由冲突。** 不注册客户端 slot key，也不注册任何 `webServer` 前缀。
|
|
209
|
+
- **唯一依赖是 `skills` 服务。** `export const inject = ['skills']`，由宿主提供；不 import 宿主实现，只消费这个服务。
|
|
210
|
+
- **无共享事件监听。** 不监听 `agent/pre-step`、`tools/post-execute` 一类顺序敏感事件，因此不存在瀑布链条被短路的问题。
|
|
211
|
+
- **无 patch 层冲突。** 组合包 patch 只 `insert` 自己那一行，从不覆写内置行的 `config`。
|
|
212
|
+
- **无全局改写。** 不改原型、不写 `process.env`、不替换全局 fetch dispatcher。
|
|
213
|
+
- **注册即 effect。** `ctx.effect(() => ctx.skills.register(...))`，停止或热重载即撤销贡献。
|
|
214
|
+
|
|
215
|
+
对照基线：DSH `0.2.2-alpha.3` / Cordis `4.0.6-alpha.2`（[docs/levels.md](docs/levels.md) 记录，2026-11-04）。
|
|
216
|
+
|
|
217
|
+
## 兼容性
|
|
218
|
+
|
|
219
|
+
| 维度 | 状态 |
|
|
220
|
+
|---|---|
|
|
221
|
+
| Harness | `engines.dsh` = `>=0.2.2-0 <0.3.0`（自 `0.2.1-alpha.4` 起 `engines.dsh` 单独决定；npm 默认 semver 需要显式 `^0.2.2-alpha.3` 并集臂）。基线 DSH `0.2.2-alpha.3`（npm `alpha`），Cordis `4.0.6-alpha.2`。 |
|
|
222
|
+
| Node | `>=24.9.0`（0.2.2 线的要求，自 `0.2.2-alpha.2` 起） |
|
|
223
|
+
| 平台 | 任何 DSH 可运行处（纯文本技能；无浏览器半，无原生扩展） |
|
|
224
|
+
| 模型 | 不调用模型：技能文本由宿主注入上下文，无额外模型能力要求 |
|
|
225
|
+
|
|
226
|
+
## 生态与质量
|
|
227
|
+
|
|
228
|
+
- [npm 包页](https://www.npmjs.com/package/dsh-plugin-guide)（已发布版本，`0.4.3`）
|
|
229
|
+
- [Gitee 镜像](https://gitee.com/perrylink/dsh-plugin-guide)（只读快照；以 GitHub 为准）
|
|
230
|
+
- [dsh-standards](https://www.npmjs.com/package/dsh-standards)（检查器与三层审计 `dsh-levels`）
|
|
231
|
+
- [dsh-plugin-spec](https://github.com/PerryLink/dsh-plugin-spec)（底层规则文本与条款来源）
|
|
232
|
+
- [dsh-primer](https://github.com/PerryLink/dsh-primer)（旧的构建/脚手架技能与 CLI）
|
|
233
|
+
- 本仓文档：[三层地图](docs/levels.md) · [ENTRY](docs/entry.md) · [FLOW](docs/flow.md) · [BOOST](docs/boost.md)
|
|
234
|
+
- 仓库治理：[CHANGELOG](CHANGELOG.md) · [STANDARDS.md](STANDARDS.md) · [CONTRIBUTING](CONTRIBUTING.md)
|
|
235
|
+
|
|
236
|
+
## 开发
|
|
237
|
+
|
|
238
|
+
```sh
|
|
239
|
+
npm test # node --test tests/*.test.mjs
|
|
240
|
+
npm run test:pack # npm pack --dry-run
|
|
241
|
+
python scripts/gen-readme-assets.py # 重出 docs/assets 的深浅两版 hero SVG（Python + Pillow）
|
|
242
|
+
```
|
|
243
|
+
|
|
244
|
+
无构建步骤：`index.js` 即发布产物。CI 是 [.github/workflows/verify.yml](.github/workflows/verify.yml)（Node 22 与 24 矩阵，跑单测 + `npm pack --dry-run`）。配图由 [scripts/gen-readme-assets.py](scripts/gen-readme-assets.py) 程序化生成，可重复执行、幂等覆盖。
|
|
245
|
+
|
|
246
|
+
| 路径 | 作用 |
|
|
247
|
+
|---|---|
|
|
248
|
+
| `index.js` | 唯一宿主面：读 `SKILL.md`、剥 frontmatter、以 `ctx.effect` 注册技能 |
|
|
249
|
+
| `SKILL.md` | 技能正文与 `description`（YAML frontmatter） |
|
|
250
|
+
| `docs/` | 三层地图与 ENTRY/FLOW/BOOST 指南，即技能正文的相对引用 |
|
|
251
|
+
| `locale/` | 技能的 zh/en 展示元数据（`meta.title`、`meta.description`） |
|
|
252
|
+
| `cordis.patch.yml` | bundle 补丁层，只 `insert` 自己一行 |
|
|
253
|
+
| `tests/` | `node --test`：技能 frontmatter 解析与注册 |
|
|
254
|
+
| `scripts/gen-readme-assets.py` | 程序化出图（Python + Pillow） |
|
|
255
|
+
| `STANDARDS.md` · `NOTICE.md` · `PRIVACY.md` | 标准状态、NOTICE、隐私声明 |
|
|
66
256
|
|
|
67
|
-
##
|
|
257
|
+
## 家族与致谢
|
|
68
258
|
|
|
69
|
-
|
|
70
|
-
[`dsh-primer`](https://github.com/PerryLink/dsh-primer).
|
|
71
|
-
- This package is now the **guide** layer: three-layer map, check routing, and
|
|
72
|
-
evidence rules.
|
|
73
|
-
- The old 0.3.x npm versions are deprecated and remain available for existing
|
|
74
|
-
installs. The 0.4.0 line is a breaking product change; users pinned to `^0.3`
|
|
75
|
-
will not auto-upgrade.
|
|
76
|
-
- Checks live in [`dsh-standards`](https://github.com/PerryLink/dsh-standards),
|
|
77
|
-
not in this package.
|
|
259
|
+
本项目是 [PerryLink](https://github.com/PerryLink) 维护的 DeepSeek Harness 插件家族成员（全部 Apache-2.0）。如果这份指南帮到了你，**给个 star**——它不解锁任何功能，但会让下一个人更容易找到它。
|
|
78
260
|
|
|
79
|
-
|
|
261
|
+
- [@PerryLink](https://github.com/PerryLink) —— 创建者与维护者：三层地图与 ENTRY/FLOW/BOOST 指南文本、`SKILL.md` 技能、bundle 补丁层与五语文档。
|
|
80
262
|
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
263
|
+
<details>
|
|
264
|
+
<summary>展开全部插件</summary>
|
|
265
|
+
|
|
266
|
+
| 插件 | 状态 |
|
|
267
|
+
|---|---|
|
|
268
|
+
| **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
|
|
269
|
+
| **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
|
|
270
|
+
| **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
|
|
271
|
+
| **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 已冻结 — 见仓库 README |
|
|
272
|
+
| **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
|
|
273
|
+
| **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
|
|
274
|
+
| **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 已冻结 — 见仓库 README |
|
|
275
|
+
| **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
|
|
276
|
+
| **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
|
|
277
|
+
| **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
|
|
278
|
+
| **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
|
|
279
|
+
| **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
|
|
280
|
+
| **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | 🧊 已冻结 — 见仓库 README |
|
|
281
|
+
| **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
|
|
282
|
+
| **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
|
|
283
|
+
| **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
|
|
284
|
+
| **[dsh-eia-guide-check](https://github.com/PerryLink/dsh-eia-guide-check)** | |
|
|
285
|
+
| **[dsh-emergency-plan](https://github.com/PerryLink/dsh-emergency-plan)** | |
|
|
286
|
+
| **[dsh-essay-rubric-check](https://github.com/PerryLink/dsh-essay-rubric-check)** | |
|
|
287
|
+
| **[dsh-evidence-check](https://github.com/PerryLink/dsh-evidence-check)** | |
|
|
288
|
+
| **[dsh-export-ctl-check](https://github.com/PerryLink/dsh-export-ctl-check)** | |
|
|
289
|
+
| **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | |
|
|
290
|
+
| **[dsh-fmea-table-check](https://github.com/PerryLink/dsh-fmea-table-check)** | |
|
|
291
|
+
| **[dsh-forecast-penalty](https://github.com/PerryLink/dsh-forecast-penalty)** | |
|
|
292
|
+
| **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | |
|
|
293
|
+
| **[dsh-github](https://github.com/PerryLink/dsh-github)** | |
|
|
294
|
+
| **[dsh-gongwen-flow-check](https://github.com/PerryLink/dsh-gongwen-flow-check)** | |
|
|
295
|
+
| **[dsh-gongwen-word-check](https://github.com/PerryLink/dsh-gongwen-word-check)** | |
|
|
296
|
+
| **[dsh-guard-plan-qc](https://github.com/PerryLink/dsh-guard-plan-qc)** | |
|
|
297
|
+
| **[dsh-hazchem-check](https://github.com/PerryLink/dsh-hazchem-check)** | |
|
|
298
|
+
| **[dsh-hazplan-check](https://github.com/PerryLink/dsh-hazplan-check)** | |
|
|
299
|
+
| **[dsh-hidden-risk-map](https://github.com/PerryLink/dsh-hidden-risk-map)** | |
|
|
300
|
+
| **[dsh-hs-classify](https://github.com/PerryLink/dsh-hs-classify)** | |
|
|
301
|
+
| **[dsh-icd-rule-check](https://github.com/PerryLink/dsh-icd-rule-check)** | |
|
|
302
|
+
| **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | |
|
|
303
|
+
| **[dsh-lawcite-adapter](https://github.com/PerryLink/dsh-lawcite-adapter)** | |
|
|
304
|
+
| **[dsh-laya](https://github.com/PerryLink/dsh-laya)** | |
|
|
305
|
+
| **[dsh-lc-doc-check](https://github.com/PerryLink/dsh-lc-doc-check)** | |
|
|
306
|
+
| **[dsh-learning-gap-check](https://github.com/PerryLink/dsh-learning-gap-check)** | |
|
|
307
|
+
| **[dsh-library](https://github.com/PerryLink/dsh-library)** | |
|
|
308
|
+
| **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | |
|
|
309
|
+
| **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | |
|
|
310
|
+
| **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
|
|
311
|
+
| **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
|
|
312
|
+
| **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
|
|
313
|
+
| **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | 🧊 已冻结 — 见仓库 README |
|
|
314
|
+
| **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
|
|
315
|
+
| **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
|
|
316
|
+
| **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
|
|
317
|
+
| **[dsh-origin-rvc-check](https://github.com/PerryLink/dsh-origin-rvc-check)** | |
|
|
318
|
+
| **[dsh-ota-review-check](https://github.com/PerryLink/dsh-ota-review-check)** | |
|
|
319
|
+
| **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | |
|
|
320
|
+
| **[dsh-paper-doc-adapter](https://github.com/PerryLink/dsh-paper-doc-adapter)** | |
|
|
321
|
+
| **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | |
|
|
322
|
+
| **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
|
|
323
|
+
| **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
|
|
324
|
+
| **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
|
|
325
|
+
| **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | 🚫 已退役（仓库已归档） |
|
|
326
|
+
| **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
|
|
327
|
+
| **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | 🚫 已退役（仓库已归档） |
|
|
328
|
+
| **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | 🚫 已退役（仓库已归档） |
|
|
329
|
+
| **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
|
|
330
|
+
| **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
|
|
331
|
+
| **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
|
|
332
|
+
| **[dsh-ppap-check](https://github.com/PerryLink/dsh-ppap-check)** | |
|
|
333
|
+
| **[dsh-protest-deadline](https://github.com/PerryLink/dsh-protest-deadline)** | |
|
|
334
|
+
| **[dsh-railway-window](https://github.com/PerryLink/dsh-railway-window)** | |
|
|
335
|
+
| **[dsh-repair-order-qc](https://github.com/PerryLink/dsh-repair-order-qc)** | |
|
|
336
|
+
| **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | |
|
|
337
|
+
| **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
|
|
338
|
+
| **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
|
|
339
|
+
| **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
|
|
340
|
+
| **[dsh-score](https://github.com/PerryLink/dsh-score)** | 🧊 已冻结 — 见仓库 README |
|
|
341
|
+
| **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
|
|
342
|
+
| **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
|
|
343
|
+
| **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
|
|
344
|
+
| **[dsh-soe-decision-check](https://github.com/PerryLink/dsh-soe-decision-check)** | |
|
|
345
|
+
| **[dsh-soilwater-check](https://github.com/PerryLink/dsh-soilwater-check)** | |
|
|
346
|
+
| **[dsh-sop-sync-check](https://github.com/PerryLink/dsh-sop-sync-check)** | |
|
|
347
|
+
| **[dsh-spc-gbt-adapter](https://github.com/PerryLink/dsh-spc-gbt-adapter)** | |
|
|
348
|
+
| **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | |
|
|
349
|
+
| **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
|
|
350
|
+
| **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
|
|
351
|
+
| **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
|
|
352
|
+
| **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | 🚫 已退役（仓库已归档） |
|
|
353
|
+
| **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
|
|
354
|
+
| **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
|
|
355
|
+
| **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 已冻结 — 见仓库 README |
|
|
356
|
+
| **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 已冻结 — 见仓库 README |
|
|
357
|
+
| **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 已冻结 — 见仓库 README |
|
|
358
|
+
| **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 已冻结 — 见仓库 README |
|
|
359
|
+
| **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 已冻结 — 见仓库 README |
|
|
360
|
+
| **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 已退役（仓库已归档） |
|
|
361
|
+
| **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 已退役（仓库已归档） |
|
|
362
|
+
| **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 已退役（仓库已归档） |
|
|
363
|
+
|
|
364
|
+
</details>
|
|
85
365
|
|
|
86
366
|
## License
|
|
87
367
|
|
|
88
|
-
|
|
368
|
+
[LICENSE](LICENSE)（Apache License 2.0）© 2026 dsh-plugin-guide contributors
|
|
369
|
+
|
|
370
|
+
<p align="center"><sub>Apache-2.0 · 社区指南，与 DeepSeek 无关。</sub></p>
|