dsh-autotier 0.2.14 → 0.2.16

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.md CHANGED
@@ -1,375 +1,395 @@
1
- # dsh-autotier
2
-
3
- [![Gitee](https://img.shields.io/badge/Gitee-mirror-c71d23?logo=gitee)](https://gitee.com/perrylink/dsh-autotier)
4
- [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-autotier/badge)](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-autotier)
5
- [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
6
- [![DSH plugin](https://img.shields.io/badge/dsh--plugin-✅-green)](https://github.com/topics/dsh-plugin)
7
- [![dsh-doctor](https://raw.githubusercontent.com/PerryLink/dsh-plugin-doctor/main/badges/PerryLink__dsh-autotier.svg)](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
8
- [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/)
9
- [![Node](https://img.shields.io/badge/node-%5E22.19.0%20%7C%7C%20%3E%3D24.0.0-brightgreen.svg)](#)
10
- [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-autotier/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-autotier/actions)
11
- [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-autotier?label=version)](https://github.com/PerryLink/dsh-autotier/releases)
12
- [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-autotier?metric=downloads)](https://dshfind.com/plugins/PerryLink/dsh-autotier?ref=badge)
13
-
14
- **English** | [简体中文](README-zh.md) | [Español](README-es.md) | [Português](README-pt.md) | [हिन्दी](README-hi.md)
15
-
16
- Automatic model-tier routing for DeepSeek Harness: one user instruction enters,
17
- one tier decision comes out — no manual model switching.
18
-
19
- Complex intent (architecture, planning, debugging, multi-step engineering) is
20
- planned on the **strong** tier and then implemented on the **cheap** tier.
21
- Simple intent (questions, retrieval, batch chores, daily work) is designed and
22
- implemented on the **cheap** tier directly. While the cheap tier executes,
23
- high-risk tool calls are denied by a deterministic guard, and repeated failures
24
- escalate to the strong tier with a TTL fallback.
25
-
26
- - **Official repository**: <https://github.com/PerryLink/dsh-autotier>
27
- - **npm**: `dsh-autotier` (bare, unscoped)
28
-
29
- <!-- star-cta -->
30
- ## ⭐ 如果它帮到了你
31
-
32
- 这个插件是 [DSH 插件家族](https://github.com/PerryLink)的一员(40+ 个,全部 Apache-2.0)。如果你在用,**给个 star** —— 它不会解锁任何功能,但会让下一个人在搜索里更容易找到它。
33
-
34
- *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.
35
-
36
-
37
- ## Compatibility
38
-
39
- | Harness | Status |
40
- |---|---|
41
- | `@deepseek-ai/dsh` `0.1.2-rc.1` | no longer supported; that line predates the `SettingsForms` contract this plugin now targets |
42
- | `@deepseek-ai/dsh` `0.1.5-rc.2` | no longer supported; the `settings.register` / `settings/updated` contract it exposes was removed upstream |
43
- | `@deepseek-ai/dsh` `0.1.6-alpha.2` | no longer supported; same removal, first line to ship `SettingsForms` |
44
- | `@deepseek-ai/dsh` `0.1.7-rc.2` | **required**; verified against the matching checkout (`typecheck`) and the published packages (`typecheck:ci`, 214 tests) |
45
- | `@deepseek-ai/cordis` `^4.0.3`, `@deepseek-ai/cosmokit` `^1.8.4`, `@deepseek-ai/schemastery` `^3.18.3` | peer baseline |
46
-
47
- Peer ranges name all published lines explicitly (`>=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0`), because a semver range whose only prerelease
48
- comparator sits on an earlier version tuple does not admit a later alpha.
49
- They are refreshed per published wave. The declared range is deliberately wider
50
- than the verified one: it documents what the manifest accepts, not what has been
51
- tested.
52
-
53
- **This release is a breaking adaptation.** The `0.1.6`-generation harness
54
- removed the settings *provider* seam this plugin was built on: the
55
- `@deepseek-ai/dsh-settings-file` package is gone, `ctx.settings` is now
56
- `SettingsForms` (a schema→form projector, with no `register`), and
57
- `settings/updated` no longer exists. There is no shared surface that lets one
58
- plugin observe another plugin's settings document, so no version of this plugin
59
- can support both contracts at once. Configuration now flows through the host's
60
- volatile-config mechanism, and the per-session routing mode — the setting that
61
- actually changes behaviour at runtime — is unchanged.
62
-
63
- The plugin is host-plane only. It needs no agent preset of its own: the host
64
- row applies to every session. A one-line prompt section in *your* preset is
65
- optional and only makes the router's decisions visible to the model (see
66
- [Install & uninstall](#install--uninstall)).
67
-
68
- ## What you get
69
-
70
- - **Intent gate** — every turn is classified from deterministic signals
71
- (message text, tool names, image presence, conversation length). The
72
- zero-token rule layer decides when it is confident; only a low-confidence turn
73
- calls the cheap judge model, and never on a cooldown.
74
- - **Tier landing on the official seam** — the decision is applied on the
75
- `agent/request` waterfall by returning a replacement provider/model/effort
76
- triple. Sampling scalars the session already chose (`temperature`, `maxTokens`,
77
- `stop`) are preserved.
78
- - **Plan-mode handoff** — a complex instruction enters plan mode on the strong
79
- tier; leaving plan mode drops back to the cheap tier for implementation.
80
- - **High-risk guard** — while the cheap tier executes, destructive commands
81
- (`rm -rf`, `sudo`, `mkfs`, `git push --force`, credential-file writes, …) are
82
- denied with a corrective message telling the model to escalate instead.
83
- - **Failure escalation** — repeated failures (optionally same-signature) raise
84
- the tier for a TTL; a model/route failure walks the configured fallback chain.
85
- - **Manual escape hatches** — `/tier auto|strong|cheap|off` and the
86
- `tier_status` / `tier_route` tools. Setting `routingMode: delegated` (or
87
- `/tier off`) stops routing for a session that must keep its own model.
88
- - **`ctx.autotier` service** — a small read surface (`status`) plus the
89
- `autotier/route` veto waterfall and `autotier/tier-changed` event, so other
90
- plugins can observe or override a decision.
91
-
92
- ## Quick start
93
-
94
- ```bash
95
- dsh plugin --profile web add dsh-autotier
96
- npm i -g dsh1024
97
- dsh1024 plugin --profile web add dsh-autotier
98
- ```
99
-
100
- Then start (or restart) the harness. The row is appended to your profile's
101
- `cordis.patch.yml`; routing starts on the next turn with no further setup.
102
-
103
- ## Install & uninstall
104
-
105
- **npm channel**
106
-
107
- ```bash
108
- dsh plugin --profile web add dsh-autotier
109
- npm i -g dsh1024
110
- dsh1024 plugin --profile web add dsh-autotier
111
- ```
112
-
113
- **git channel**
114
-
115
- ```bash
116
- dsh plugin --profile web add "github:PerryLink/dsh-autotier#main"
117
- git clone https://github.com/PerryLink/dsh-autotier.git
118
- cd dsh-autotier && pnpm install && pnpm run build
119
- dsh plugin --profile web add .
120
- ```
121
-
122
- **Optional preset prompt section.** The router works without it. To let the
123
- model know which tier it is running on, add one row to *your* agent preset
124
- (`docs/preset-row.md` has the exact block):
125
-
126
- ```yaml
127
- - insert:
128
- - id: autotier-prompt
129
- name: '@deepseek-ai/dsh-system-prompt'
130
- # sections: [...] — see docs/preset-row.md
131
- ```
132
-
133
- **Uninstall**
134
-
135
- ```bash
136
- dsh plugin --profile web remove dsh-autotier
137
- ```
138
-
139
- The row, its command, its tools and its listeners are all removed with the
140
- plugin. Configuration a user saved through the Plugins page lives in the active
141
- profile patch and belongs to that profile, not to this plugin; removing the row
142
- leaves it there untouched.
143
-
144
- ## Configuration
145
-
146
- Every key is validated at load time; an invalid value fails loudly instead of
147
- silently disabling routing. `cordis.patch.yml` in this repository documents the
148
- same keys inline.
149
-
150
- | Key | Default | Meaning |
151
- |---|---|---|
152
- | `tiers.strong.provider` | `deepseek-official` | Provider for the planning/review tier. |
153
- | `tiers.strong.model` | `deepseek-v4-pro` | Catalog id of the strong model. |
154
- | `tiers.strong.effort` | `high` | Adapter vocabulary `off` \| `low` \| `high` \| `max`. |
155
- | `tiers.strong.followSession` | `false` | `false` = this tier's effort overrides the session's. |
156
- | `tiers.strong.fallback` | `[]` | Ordered provider/model landings when the tier is unavailable. |
157
- | `tiers.cheap.provider` | `deepseek-official` | Provider for the implementation tier. |
158
- | `tiers.cheap.model` | `deepseek-flash` | Catalog id of the cheap model. |
159
- | `tiers.cheap.effort` | `low` | Adapter vocabulary `off` \| `low` \| `high` \| `max`. |
160
- | `tiers.cheap.followSession` | `true` | `true` = inherit the session's effort so an explicit choice wins. |
161
- | `tiers.cheap.fallback` | `[]` | Ordered provider/model landings when the tier is unavailable. |
162
- | `tiers.vision.provider` | `deepseek-official` | Provider for image-carrying turns. |
163
- | `tiers.vision.model` | `deepseek-flash` | The catalog's image-capable model. |
164
- | `intent.ruleThreshold` | `0.7` | Confidence at or above which the rule layer decides alone. |
165
- | `intent.attemptBand.enabled` | `false` | Start the middle band on the cheap tier and escalate on a signal. |
166
- | `intent.attemptBand.tauLow` | `0.45` | Lower bound of the attempt-first band. |
167
- | `intent.hysteresis.toStrong` | `0.8` | Score that switches a cheap turn to strong. |
168
- | `intent.hysteresis.toCheap` | `0.6` | Score below which a strong turn returns to cheap. |
169
- | `intent.rules` | `[]` | Declarative rule table (`when.patterns` / `when.tools` / `when.cwd`, `tier`, `priority`). |
170
- | `intent.judge.enabled` | `true` | Allow the low-confidence judge. |
171
- | `intent.judge.model` | `''` | Judge model id; empty = first catalog model containing `flash`. |
172
- | `intent.judge.temperature` | `0` | Judge sampling temperature. |
173
- | `intent.judge.maxTokens` | `16` | Judge output cap (it answers with one word). |
174
- | `intent.judge.cooldownMs` | `30000` | Minimum gap between two judge calls. |
175
- | `intent.judge.timeoutMs` | `2000` | Judge call timeout. |
176
- | `intent.judge.unavailableSkip` | `2` | Consecutive judge failures after which the turn skips it. |
177
- | `intent.scenarios` | all `true` | Per-scenario switches: `coding`, `review`, `planning`, `retrieval`, `batch`, `daily`, `longText`, `multimodal`. |
178
- | `intent.costMode` | `balanced` | Ambiguity arbitration: `cost-first` \| `quality-first` \| `balanced`. |
179
- | `guard.enabled` | `true` | Enable the deterministic high-risk guard. |
180
- | `guard.tiers` | `[cheap]` | Tiers the guard protects. |
181
- | `guard.whitelist` | `[]` | Commands, tools or path prefixes that never trip the guard. |
182
- | `guard.protectedPaths` | `['.dsh','AGENTS.md','package.json','.github/workflows']` | Self-modification surfaces that force strong-tier review. |
183
- | `guard.interopDefend` | `auto` | Relationship with `dsh-defend`: `auto` audits coexistence, `none` stays silent. |
184
- | `escalation.threshold` | `2` | Failures within the window that raise the tier. |
185
- | `escalation.windowMs` | `60000` | Failure-counting window. |
186
- | `escalation.ttlMs` | `180000` | How long an escalation stays in effect. |
187
- | `escalation.fallbackTtlMs` | `300000` | TTL used after a fallback landing was taken. |
188
- | `escalation.signature` | `true` | Count same-signature recurrences instead of every failure. |
189
- | `routingMode` | `auto` | `auto` \| `strong` \| `cheap` \| `delegated` \| `off`. |
190
-
191
- All keys can also be edited live from the plugin's card on the Plugins page; the
192
- Host validates the new value against the schema and commits it with
193
- `loader/volatile-update`, and this plugin then re-judges the whole configuration
194
- through the same cross-field judge the mount path uses. A value that violates a
195
- cross-field requirement (two tiers landing on the same route, a hysteresis pair
196
- that cannot stop flapping, a rule with neither a pattern nor a tool) leaves the
197
- last good policy routing instead of swapping in something unroutable.
198
-
199
- `routingMode` is the one key that is **not** live: it is the composition
200
- default, and the runtime switch is the session-scoped override written by
201
- `/tier`, the composer pill and the card's selector. Making it live as well would
202
- give the same behaviour two owners.
203
-
204
- ## Tools & surfaces
205
-
206
- | Surface | Kind | Purpose |
207
- |---|---|---|
208
- | `/tier` | command | `auto` \| `strong` \| `cheap` \| `off` \| `status`; session-scoped override. |
209
- | `tier_status` | tool | Current tier, mode, escalation TTL and guard state. |
210
- | `tier_route` | tool | Route one intent string without sending a request (dry run). |
211
- | `ctx.autotier` | service | `status()` read surface for other plugins. |
212
- | `autotier/route` | serial event | Third parties may veto a proposed tier. |
213
- | `autotier/tier-changed` | emit event | Observability when the effective tier changes. |
214
-
215
- ## Permissions & data
216
-
217
- - **Files** — the plugin reads no file and writes none. Configuration is the
218
- host's: a value saved on the Plugins page is persisted by the Host into the
219
- active profile patch, and this plugin only reads the live snapshot it is
220
- handed.
221
- - **Network** — the only outbound traffic is the judge call, which goes through
222
- the normal `ctx.llm` path and the configured provider.
223
- - **Session log** — the plugin appends no custom session events. The routing
224
- trail is the plugin logger plus the live `autotier/tier-changed` bus event;
225
- the only append it makes is the `plan/mode` fallback when the plan-mode
226
- service is absent. Custom event types are fail-closed on `0.1.2-alpha.1` and
227
- later, so no durable plugin-owned record is written.
228
- - **Secrets** — no credential is read, logged or stored by this plugin.
229
-
230
- ## Security boundaries
231
-
232
- - The guard is a **defence in depth**, not a sandbox. It denies the patterns it
233
- knows on the cheap tier and never weakens `dsh-defend`, the approval service,
234
- or the sandbox policy. Keep those enabled.
235
- - The guard protects only the tiers listed in `guard.tiers` (cheap by default).
236
- A strong-tier turn is not blocked by design: the strong model is the reviewer.
237
- - If the guard itself throws, the call is escalated to the strong tier rather
238
- than allowed — a broken guard must not become an open door.
239
- - `/tier off` disables routing entirely; the harness then behaves exactly as it
240
- did before the plugin was installed.
241
-
242
- ## Known limitations
243
-
244
- - The rule layer is deterministic and therefore finite: a novel phrasing of a
245
- complex request may start on the cheap tier and escalate only after a failure
246
- or a guard denial. The judge call covers the low-confidence middle.
247
- - Escalation is per-agent and in-memory; a harness restart starts from `auto`.
248
- - Tier switching resets the provider prompt cache for the changed request, so
249
- very chatty sessions may see a small cache-miss cost on the switch turn. The
250
- hysteresis thresholds exist to keep that rare.
251
- - The plugin routes conversation requests. Compaction and title generation are
252
- separate host seams; align their own model settings with the cheap tier if you
253
- want the same cost profile (`docs/supporting-lanes.md`).
254
- - `followSession: true` on the cheap tier means an explicit session model choice
255
- wins; in that case the cheap tier cannot force its own model.
256
- - **The Settings card and composer tier pill shipped in 0.2.0.** The card
257
- (routing mode, live tier landings, model catalog) lives in the Plugins settings
258
- section and the pill cycles the session mode from the composer.
259
- - **A model picked in the GUI is not detected automatically.** The router does
260
- not watch the `agent-default-model` document, so switching models there does
261
- not by itself stop routing — use `routingMode: delegated` or `/tier off`.
262
- - **Fingerprint posteriors are in-memory.** They reset on restart and re-learn
263
- from the judge's cold-start fallback; persisting them through the settings
264
- document is planned for v0.2.
265
- - **The attempt-first middle band ships disabled.** `intent.attemptBand.enabled`
266
- stays `false` until the calibration corpus and its metric gate land (v0.2).
267
-
268
- ## Development
269
-
270
- ```bash
271
- pnpm install
272
- pnpm run typecheck # against the local harness checkout type faces
273
- pnpm run typecheck:ci # against the published 0.1.7-rc.2 faces (what CI runs)
274
- pnpm test
275
- pnpm run build
276
- pnpm run verify:self-contained
277
- pnpm run verify:artifacts
278
- pnpm pack
279
- ```
280
-
281
- `pnpm run build` emits `lib/types` (tsc declarations) and `lib/index.js`
282
- (tsdown bundle). Tests use the published host packages directly — real
283
- `Context`, real session/tools/commands services — plus one real Loader
284
- composition over a temporary `cordis.yml`. The `settings` service is the one
285
- stand-in: the host's real `SettingsForms` binds to `configEditor`,
286
- `profileContext` and the Loader's fiber graph, none of which this plugin
287
- consumes, while the plugin's whole contract with it is `configure({ auto })`
288
- plus the Loader's `loader/volatile-update` event.
289
-
290
- ## Interoperability with other DSH plugins
291
-
292
- Verified against **DSH `0.2.0-rc.2`** (the runtime this README ships for) and the high-star plugin set surveyed on 2026-10-05.
293
-
294
- This plugin **does not interfere** with other plugins, including the widely installed high-star ones:
295
-
296
- - **No tool-name collision.** Every tool is namespaced; no bare name owned by a shipped tool or another plugin is registered.
297
- - **No service-key collision.** It provides `autotier`; that key is not a built-in seam and is not provided by any surveyed high-star plugin.
298
- - **No slot collision.** It registers no client slot key, so it cannot contend for a `shadows-shipped-ui` seat.
299
- - **No HTTP route collision.** It registers no `webServer` prefix.
300
- - **No patch-layer collision.** The bundle patch only `insert`s its own row; it never overrides a built-in row's `config`.
301
- - **No global mutation.** It does not patch prototypes, rewrite `process.env`, or replace the global fetch dispatcher.
302
-
303
- **Shared event listeners are non-interfering by construction.** It observes the ordering-sensitive events `agent/created`, `agent/request`, `agent/request-error`, `tools/pre-execute` with `ctx.on()` — Cordis's broadcast registration, where every listener runs and none can starve another. **Every listener here delegates through `next()`**, so the chain is never short-circuited, and a mutation is applied to the value `next()` produced rather than returned in its place:
304
- - `agent/request` — also used by `dsh-agent-teams` (1923★), which short-circuits by throwing without calling `next()`.
305
- - `tools/pre-execute` — also used by `cc-safety-net` (1576★).
306
-
307
- Static evidence: `dsh-plugin-doctor` K10–K13 report `pass` for every check on this repository.
308
-
309
- ## Topics
310
-
311
- `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `router`,
312
- `model-tier`, `cost`, `auto`.
313
-
314
- ## Contributors
315
-
316
- PerryLink. Issues and pull requests are welcome at
317
- <https://github.com/PerryLink/dsh-autotier/issues>.
318
-
319
- **Applicable DSH version:** verified against `dsh-v0.2.1-alpha.1` (the host release this build targets); requires `>=0.1.7-alpha.1 <0.2.0`.
320
-
321
- ## PerryLink DSH Plugin Family
322
-
323
- This project is one of the **44 DeepSeek Harness plugins** maintained by [PerryLink](https://github.com/PerryLink). If this one helps you, the others likely will too:
324
-
325
- | Plugin | One-liner |
326
- |---|---|
327
- | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | Second-model auto-review on the approval chain, fail-closed by default | |
328
- | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | Automatic strong/cheap model-tier routing with deterministic risk guards and a `/tier` command | |
1
+ # dsh-autotier
2
+
3
+ **English** | [简体中文](README-zh.md) | [Español](README-es.md) | [Português](README-pt.md) | [हिन्दी](README-hi.md)
4
+
5
+ Automatic model-tier routing for DeepSeek Harness: one user instruction enters,
6
+ one tier decision comes out — no manual model switching.
7
+
8
+
9
+ [![Gitee](https://img.shields.io/badge/Gitee-mirror-c71d23?logo=gitee)](https://gitee.com/perrylink/dsh-autotier)
10
+ [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-autotier/badge)](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-autotier)
11
+ [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
12
+ [![DSH plugin](https://img.shields.io/badge/dsh--plugin-✅-green)](https://github.com/topics/dsh-plugin)
13
+ [![dsh-doctor](https://raw.githubusercontent.com/PerryLink/dsh-plugin-doctor/main/badges/PerryLink__dsh-autotier.svg)](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
14
+ [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/)
15
+ [![Node](https://img.shields.io/badge/node-%5E22.19.0%20%7C%7C%20%3E%3D24.0.0-brightgreen.svg)](#)
16
+ [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-autotier/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-autotier/actions)
17
+ [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-autotier?label=version)](https://github.com/PerryLink/dsh-autotier/releases)
18
+ [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-autotier?metric=downloads)](https://dshfind.com/plugins/PerryLink/dsh-autotier?ref=badge)
19
+
20
+ Complex intent (architecture, planning, debugging, multi-step engineering) is
21
+ planned on the **strong** tier and then implemented on the **cheap** tier.
22
+ Simple intent (questions, retrieval, batch chores, daily work) is designed and
23
+ implemented on the **cheap** tier directly. While the cheap tier executes,
24
+ high-risk tool calls are denied by a deterministic guard, and repeated failures
25
+ escalate to the strong tier with a TTL fallback.
26
+
27
+ - **Official repository**: <https://github.com/PerryLink/dsh-autotier>
28
+ - **npm**: `dsh-autotier` (bare, unscoped)
29
+
30
+ **📖 Ecosystem knowledge base** — measured data, not marketing: [plugin development guide · plugin-selection data · maintenance criteria](https://perrylink.github.io/dsh-plugin-guide/).
31
+
32
+ <!-- star-cta -->
33
+ ## ⭐ 如果它帮到了你
34
+
35
+ 这个插件是 [DSH 插件家族](https://github.com/PerryLink)的一员(40+ 个,全部 Apache-2.0)。如果你在用,**给个 star** —— 它不会解锁任何功能,但会让下一个人在搜索里更容易找到它。
36
+
37
+ *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.
38
+
39
+
40
+ ## What is dsh-autotier?
41
+
42
+ npm channel
43
+
44
+ git channel
45
+
46
+ ![Terminal demo of dsh-autotier: dsh-autotier — install, then the documented tier defaults behind /tier](https://raw.githubusercontent.com/PerryLink/dsh-autotier/main/docs/assets/dsh-autotier-demo.png)
47
+
48
+ ![Animated terminal demo of dsh-autotier](https://raw.githubusercontent.com/PerryLink/dsh-autotier/main/docs/assets/dsh-autotier-demo.gif)
49
+
50
+ *The same run, animated.*
51
+
52
+ ## Compatibility
53
+
54
+ | Harness | Status |
55
+ |---|---|
56
+ | `@deepseek-ai/dsh` `0.1.2-rc.1` | no longer supported; that line predates the `SettingsForms` contract this plugin now targets |
57
+ | `@deepseek-ai/dsh` `0.1.5-rc.2` | no longer supported; the `settings.register` / `settings/updated` contract it exposes was removed upstream |
58
+ | `@deepseek-ai/dsh` `0.1.6-alpha.2` | no longer supported; same removal, first line to ship `SettingsForms` |
59
+ | `@deepseek-ai/dsh` `0.1.7-rc.2` | **required**; verified against the matching checkout (`typecheck`) and the published packages (`typecheck:ci`, 214 tests) |
60
+ | `@deepseek-ai/cordis` `^4.0.3`, `@deepseek-ai/cosmokit` `^1.8.4`, `@deepseek-ai/schemastery` `^3.18.3` | peer baseline |
61
+
62
+ Peer ranges name all published lines explicitly (`>=0.1.6-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0`), because a semver range whose only prerelease
63
+ comparator sits on an earlier version tuple does not admit a later alpha.
64
+ They are refreshed per published wave. The declared range is deliberately wider
65
+ than the verified one: it documents what the manifest accepts, not what has been
66
+ tested.
67
+
68
+ **This release is a breaking adaptation.** The `0.1.6`-generation harness
69
+ removed the settings *provider* seam this plugin was built on: the
70
+ `@deepseek-ai/dsh-settings-file` package is gone, `ctx.settings` is now
71
+ `SettingsForms` (a schema→form projector, with no `register`), and
72
+ `settings/updated` no longer exists. There is no shared surface that lets one
73
+ plugin observe another plugin's settings document, so no version of this plugin
74
+ can support both contracts at once. Configuration now flows through the host's
75
+ volatile-config mechanism, and the per-session routing mode — the setting that
76
+ actually changes behaviour at runtime — is unchanged.
77
+
78
+ The plugin is host-plane only. It needs no agent preset of its own: the host
79
+ row applies to every session. A one-line prompt section in *your* preset is
80
+ optional and only makes the router's decisions visible to the model (see
81
+ [Install & uninstall](#install--uninstall)).
82
+
83
+ ## What you get
84
+
85
+ - **Intent gate** — every turn is classified from deterministic signals
86
+ (message text, tool names, image presence, conversation length). The
87
+ zero-token rule layer decides when it is confident; only a low-confidence turn
88
+ calls the cheap judge model, and never on a cooldown.
89
+ - **Tier landing on the official seam** — the decision is applied on the
90
+ `agent/request` waterfall by returning a replacement provider/model/effort
91
+ triple. Sampling scalars the session already chose (`temperature`, `maxTokens`,
92
+ `stop`) are preserved.
93
+ - **Plan-mode handoff** — a complex instruction enters plan mode on the strong
94
+ tier; leaving plan mode drops back to the cheap tier for implementation.
95
+ - **High-risk guard** — while the cheap tier executes, destructive commands
96
+ (`rm -rf`, `sudo`, `mkfs`, `git push --force`, credential-file writes, …) are
97
+ denied with a corrective message telling the model to escalate instead.
98
+ - **Failure escalation** — repeated failures (optionally same-signature) raise
99
+ the tier for a TTL; a model/route failure walks the configured fallback chain.
100
+ - **Manual escape hatches** — `/tier auto|strong|cheap|off` and the
101
+ `tier_status` / `tier_route` tools. Setting `routingMode: delegated` (or
102
+ `/tier off`) stops routing for a session that must keep its own model.
103
+ - **`ctx.autotier` service** — a small read surface (`status`) plus the
104
+ `autotier/route` veto waterfall and `autotier/tier-changed` event, so other
105
+ plugins can observe or override a decision.
106
+
107
+ ## Quick start
108
+
109
+ ```sh
110
+ dsh plugin --profile web add github:PerryLink/dsh-autotier
111
+ ```
112
+
113
+ ```bash
114
+ dsh plugin --profile web add dsh-autotier
115
+ npm i -g dsh1024
116
+ dsh1024 plugin --profile web add dsh-autotier
117
+ ```
118
+
119
+ Then start (or restart) the harness. The row is appended to your profile's
120
+ `cordis.patch.yml`; routing starts on the next turn with no further setup.
121
+
122
+ ## Install & uninstall
123
+
124
+ **npm channel**
125
+
126
+ ```bash
127
+ dsh plugin --profile web add dsh-autotier
128
+ npm i -g dsh1024
129
+ dsh1024 plugin --profile web add dsh-autotier
130
+ ```
131
+
132
+ **git channel**
133
+
134
+ ```bash
135
+ dsh plugin --profile web add github:PerryLink/dsh-autotier
136
+ git clone https://github.com/PerryLink/dsh-autotier.git
137
+ cd dsh-autotier && pnpm install && pnpm run build
138
+ dsh plugin --profile web add .
139
+ ```
140
+
141
+ **Optional preset prompt section.** The router works without it. To let the
142
+ model know which tier it is running on, add one row to *your* agent preset
143
+ (`docs/preset-row.md` has the exact block):
144
+
145
+ ```yaml
146
+ - insert:
147
+ - id: autotier-prompt
148
+ name: '@deepseek-ai/dsh-system-prompt'
149
+ # sections: [...] — see docs/preset-row.md
150
+ ```
151
+
152
+ **Uninstall**
153
+
154
+ ```bash
155
+ dsh plugin --profile web remove dsh-autotier
156
+ ```
157
+
158
+ The row, its command, its tools and its listeners are all removed with the
159
+ plugin. Configuration a user saved through the Plugins page lives in the active
160
+ profile patch and belongs to that profile, not to this plugin; removing the row
161
+ leaves it there untouched.
162
+
163
+ ## Configuration
164
+
165
+ Every key is validated at load time; an invalid value fails loudly instead of
166
+ silently disabling routing. `cordis.patch.yml` in this repository documents the
167
+ same keys inline.
168
+
169
+ | Key | Default | Meaning |
170
+ |---|---|---|
171
+ | `tiers.strong.provider` | `deepseek-official` | Provider for the planning/review tier. |
172
+ | `tiers.strong.model` | `deepseek-v4-pro` | Catalog id of the strong model. |
173
+ | `tiers.strong.effort` | `high` | Adapter vocabulary `off` \| `low` \| `high` \| `max`. |
174
+ | `tiers.strong.followSession` | `false` | `false` = this tier's effort overrides the session's. |
175
+ | `tiers.strong.fallback` | `[]` | Ordered provider/model landings when the tier is unavailable. |
176
+ | `tiers.cheap.provider` | `deepseek-official` | Provider for the implementation tier. |
177
+ | `tiers.cheap.model` | `deepseek-flash` | Catalog id of the cheap model. |
178
+ | `tiers.cheap.effort` | `low` | Adapter vocabulary `off` \| `low` \| `high` \| `max`. |
179
+ | `tiers.cheap.followSession` | `true` | `true` = inherit the session's effort so an explicit choice wins. |
180
+ | `tiers.cheap.fallback` | `[]` | Ordered provider/model landings when the tier is unavailable. |
181
+ | `tiers.vision.provider` | `deepseek-official` | Provider for image-carrying turns. |
182
+ | `tiers.vision.model` | `deepseek-flash` | The catalog's image-capable model. |
183
+ | `intent.ruleThreshold` | `0.7` | Confidence at or above which the rule layer decides alone. |
184
+ | `intent.attemptBand.enabled` | `false` | Start the middle band on the cheap tier and escalate on a signal. |
185
+ | `intent.attemptBand.tauLow` | `0.45` | Lower bound of the attempt-first band. |
186
+ | `intent.hysteresis.toStrong` | `0.8` | Score that switches a cheap turn to strong. |
187
+ | `intent.hysteresis.toCheap` | `0.6` | Score below which a strong turn returns to cheap. |
188
+ | `intent.rules` | `[]` | Declarative rule table (`when.patterns` / `when.tools` / `when.cwd`, `tier`, `priority`). |
189
+ | `intent.judge.enabled` | `true` | Allow the low-confidence judge. |
190
+ | `intent.judge.model` | `''` | Judge model id; empty = first catalog model containing `flash`. |
191
+ | `intent.judge.temperature` | `0` | Judge sampling temperature. |
192
+ | `intent.judge.maxTokens` | `16` | Judge output cap (it answers with one word). |
193
+ | `intent.judge.cooldownMs` | `30000` | Minimum gap between two judge calls. |
194
+ | `intent.judge.timeoutMs` | `2000` | Judge call timeout. |
195
+ | `intent.judge.unavailableSkip` | `2` | Consecutive judge failures after which the turn skips it. |
196
+ | `intent.scenarios` | all `true` | Per-scenario switches: `coding`, `review`, `planning`, `retrieval`, `batch`, `daily`, `longText`, `multimodal`. |
197
+ | `intent.costMode` | `balanced` | Ambiguity arbitration: `cost-first` \| `quality-first` \| `balanced`. |
198
+ | `guard.enabled` | `true` | Enable the deterministic high-risk guard. |
199
+ | `guard.tiers` | `[cheap]` | Tiers the guard protects. |
200
+ | `guard.whitelist` | `[]` | Commands, tools or path prefixes that never trip the guard. |
201
+ | `guard.protectedPaths` | `['.dsh','AGENTS.md','package.json','.github/workflows']` | Self-modification surfaces that force strong-tier review. |
202
+ | `guard.interopDefend` | `auto` | Relationship with `dsh-defend`: `auto` audits coexistence, `none` stays silent. |
203
+ | `escalation.threshold` | `2` | Failures within the window that raise the tier. |
204
+ | `escalation.windowMs` | `60000` | Failure-counting window. |
205
+ | `escalation.ttlMs` | `180000` | How long an escalation stays in effect. |
206
+ | `escalation.fallbackTtlMs` | `300000` | TTL used after a fallback landing was taken. |
207
+ | `escalation.signature` | `true` | Count same-signature recurrences instead of every failure. |
208
+ | `routingMode` | `auto` | `auto` \| `strong` \| `cheap` \| `delegated` \| `off`. |
209
+
210
+ All keys can also be edited live from the plugin's card on the Plugins page; the
211
+ Host validates the new value against the schema and commits it with
212
+ `loader/volatile-update`, and this plugin then re-judges the whole configuration
213
+ through the same cross-field judge the mount path uses. A value that violates a
214
+ cross-field requirement (two tiers landing on the same route, a hysteresis pair
215
+ that cannot stop flapping, a rule with neither a pattern nor a tool) leaves the
216
+ last good policy routing instead of swapping in something unroutable.
217
+
218
+ `routingMode` is the one key that is **not** live: it is the composition
219
+ default, and the runtime switch is the session-scoped override written by
220
+ `/tier`, the composer pill and the card's selector. Making it live as well would
221
+ give the same behaviour two owners.
222
+
223
+ ## Tools & surfaces
224
+
225
+ | Surface | Kind | Purpose |
226
+ |---|---|---|
227
+ | `/tier` | command | `auto` \| `strong` \| `cheap` \| `off` \| `status`; session-scoped override. |
228
+ | `tier_status` | tool | Current tier, mode, escalation TTL and guard state. |
229
+ | `tier_route` | tool | Route one intent string without sending a request (dry run). |
230
+ | `ctx.autotier` | service | `status()` read surface for other plugins. |
231
+ | `autotier/route` | serial event | Third parties may veto a proposed tier. |
232
+ | `autotier/tier-changed` | emit event | Observability when the effective tier changes. |
233
+
234
+ ## Permissions & data
235
+
236
+ - **Files** — the plugin reads no file and writes none. Configuration is the
237
+ host's: a value saved on the Plugins page is persisted by the Host into the
238
+ active profile patch, and this plugin only reads the live snapshot it is
239
+ handed.
240
+ - **Network** — the only outbound traffic is the judge call, which goes through
241
+ the normal `ctx.llm` path and the configured provider.
242
+ - **Session log** — the plugin appends no custom session events. The routing
243
+ trail is the plugin logger plus the live `autotier/tier-changed` bus event;
244
+ the only append it makes is the `plan/mode` fallback when the plan-mode
245
+ service is absent. Custom event types are fail-closed on `0.1.2-alpha.1` and
246
+ later, so no durable plugin-owned record is written.
247
+ - **Secrets** — no credential is read, logged or stored by this plugin.
248
+
249
+ ## Security boundaries
250
+
251
+ - The guard is a **defence in depth**, not a sandbox. It denies the patterns it
252
+ knows on the cheap tier and never weakens `dsh-defend`, the approval service,
253
+ or the sandbox policy. Keep those enabled.
254
+ - The guard protects only the tiers listed in `guard.tiers` (cheap by default).
255
+ A strong-tier turn is not blocked by design: the strong model is the reviewer.
256
+ - If the guard itself throws, the call is escalated to the strong tier rather
257
+ than allowed — a broken guard must not become an open door.
258
+ - `/tier off` disables routing entirely; the harness then behaves exactly as it
259
+ did before the plugin was installed.
260
+
261
+ ## Known limitations
262
+
263
+ - The rule layer is deterministic and therefore finite: a novel phrasing of a
264
+ complex request may start on the cheap tier and escalate only after a failure
265
+ or a guard denial. The judge call covers the low-confidence middle.
266
+ - Escalation is per-agent and in-memory; a harness restart starts from `auto`.
267
+ - Tier switching resets the provider prompt cache for the changed request, so
268
+ very chatty sessions may see a small cache-miss cost on the switch turn. The
269
+ hysteresis thresholds exist to keep that rare.
270
+ - The plugin routes conversation requests. Compaction and title generation are
271
+ separate host seams; align their own model settings with the cheap tier if you
272
+ want the same cost profile (`docs/supporting-lanes.md`).
273
+ - `followSession: true` on the cheap tier means an explicit session model choice
274
+ wins; in that case the cheap tier cannot force its own model.
275
+ - **The Settings card and composer tier pill shipped in 0.2.0.** The card
276
+ (routing mode, live tier landings, model catalog) lives in the Plugins settings
277
+ section and the pill cycles the session mode from the composer.
278
+ - **A model picked in the GUI is not detected automatically.** The router does
279
+ not watch the `agent-default-model` document, so switching models there does
280
+ not by itself stop routing — use `routingMode: delegated` or `/tier off`.
281
+ - **Fingerprint posteriors are in-memory.** They reset on restart and re-learn
282
+ from the judge's cold-start fallback; persisting them through the settings
283
+ document is planned for v0.2.
284
+ - **The attempt-first middle band ships disabled.** `intent.attemptBand.enabled`
285
+ stays `false` until the calibration corpus and its metric gate land (v0.2).
286
+
287
+ ## Development
288
+
289
+ ```bash
290
+ pnpm install
291
+ pnpm run typecheck # against the local harness checkout type faces
292
+ pnpm run typecheck:ci # against the published 0.1.7-rc.2 faces (what CI runs)
293
+ pnpm test
294
+ pnpm run build
295
+ pnpm run verify:self-contained
296
+ pnpm run verify:artifacts
297
+ pnpm pack
298
+ ```
299
+
300
+ `pnpm run build` emits `lib/types` (tsc declarations) and `lib/index.js`
301
+ (tsdown bundle). Tests use the published host packages directly — real
302
+ `Context`, real session/tools/commands services — plus one real Loader
303
+ composition over a temporary `cordis.yml`. The `settings` service is the one
304
+ stand-in: the host's real `SettingsForms` binds to `configEditor`,
305
+ `profileContext` and the Loader's fiber graph, none of which this plugin
306
+ consumes, while the plugin's whole contract with it is `configure({ auto })`
307
+ plus the Loader's `loader/volatile-update` event.
308
+
309
+ ## Interoperability with other DSH plugins
310
+
311
+ Verified against **DSH `0.2.0-rc.2`** (the runtime this README ships for) and the high-star plugin set surveyed on 2026-10-05.
312
+
313
+ This plugin **does not interfere** with other plugins, including the widely installed high-star ones:
314
+
315
+ - **No tool-name collision.** Every tool is namespaced; no bare name owned by a shipped tool or another plugin is registered.
316
+ - **No service-key collision.** It provides `autotier`; that key is not a built-in seam and is not provided by any surveyed high-star plugin.
317
+ - **No slot collision.** It registers no client slot key, so it cannot contend for a `shadows-shipped-ui` seat.
318
+ - **No HTTP route collision.** It registers no `webServer` prefix.
319
+ - **No patch-layer collision.** The bundle patch only `insert`s its own row; it never overrides a built-in row's `config`.
320
+ - **No global mutation.** It does not patch prototypes, rewrite `process.env`, or replace the global fetch dispatcher.
321
+
322
+ **Shared event listeners are non-interfering by construction.** It observes the ordering-sensitive events `agent/created`, `agent/request`, `agent/request-error`, `tools/pre-execute` with `ctx.on()` — Cordis's broadcast registration, where every listener runs and none can starve another. **Every listener here delegates through `next()`**, so the chain is never short-circuited, and a mutation is applied to the value `next()` produced rather than returned in its place:
323
+ - `agent/request` — also used by `dsh-agent-teams` (1923★), which short-circuits by throwing without calling `next()`.
324
+ - `tools/pre-execute` — also used by `cc-safety-net` (1576★).
325
+
326
+ Static evidence: `dsh-plugin-doctor` K10–K13 report `pass` for every check on this repository.
327
+
328
+ ## Topics
329
+
330
+ `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `router`,
331
+ `model-tier`, `cost`, `auto`.
332
+
333
+ ## Contributors
334
+
335
+ PerryLink. Issues and pull requests are welcome at
336
+ <https://github.com/PerryLink/dsh-autotier/issues>.
337
+
338
+ **Applicable DSH version:** verified against `dsh-v0.2.1-alpha.1` (the host release this build targets); requires `>=0.1.7-alpha.1 <0.2.0`.
339
+
340
+ ## PerryLink DSH Plugin Family
341
+
342
+ This project is one of the **33 actively maintained** DeepSeek Harness plugins from [PerryLink](https://github.com/PerryLink) — the roster is **42**, of which **6** are frozen and **3** retired; every one keeps its row below, with the reason in the Status column. If this one helps you, the others likely will too:
343
+
344
+ | Plugin | One-liner | Status |
345
+ |---|---|---|
346
+ | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | Second-model auto-review on the approval chain, fail-closed by default | |
347
+ | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | Automatic strong/cheap model-tier routing with deterministic risk guards and a `/tier` command | |
329
348
  | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | Durable background child agents with a Web UI sidebar, messaging and interrupt | 🚫 **RETIRED** — see the note above |
330
- | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | Cost governance for DeepSeek Harness: budgets, carbon, and latency in one panel. | | 🧊 FROZEN — see the repo README |
331
- | **[dsh-catalog](https://github.com/PerryLink/dsh-catalog)** | DSH Desktop Market standard catalog source for the PerryLink family | |
332
- | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | Read-only MCP server exposing the certification registry: grades, snapshots and five-dimension evidence | |
333
- | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | Claude Code /rewind-equivalent: snapshots, session forks, one-shot restore | |
334
- | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | Migrate Claude Code sessions, memory, skills and CLAUDE.md into DSH | | 🧊 FROZEN — see the repo README |
335
- | **[dsh-click](https://github.com/PerryLink/dsh-click)** | Cross-platform native desktop control for DeepSeek Harness — Windows first. | |
336
- | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | Terminal-style input history for the web composer: arrows, Ctrl+R search | |
337
- | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | Dataset quality checks and citation cross-checks (the optional numeric bridge consumed here) | |
338
- | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | Prompt-injection, jailbreak, and secret-leak defense for DeepSeek Harness. | | 🧊 FROZEN — see the repo README |
339
- | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | Engineering-discipline guard: requirements grill, test gates, adversary review | |
340
- | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | Unified static-image generation routing for DeepSeek Harness. | | 🧊 FROZEN — see the repo README |
341
- | **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | Read-only performance diagnostics for DeepSeek Harness. | |
342
- | **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | Deterministic research reports for Chinese public mutual funds | |
343
- | **[dsh-github](https://github.com/PerryLink/dsh-github)** | GitHub PR/issues integration for DSH, every write gated by approval | |
344
- | **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | Industry research orchestration that seals its deliverables through this plugin's `ctx.researchReport.assemble` | |
345
- | **[dsh-laya](https://github.com/PerryLink/dsh-laya)** | Laya typed decisions (`noul`/`choice`/`score`) as a first-class Cordis service and model-visible tools | |
346
- | **[dsh-library](https://github.com/PerryLink/dsh-library)** | Local document knowledge base for DeepSeek Harness. | |
347
- | **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | Local-model (Ollama) integration for DeepSeek Harness. | |
348
- | **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | LSP diagnostics, formatting, completion, code actions and rename over language servers | |
349
- | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | PII masking middleware: anonymize at the model boundary, restore at the display layer | |
350
- | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | Read-only MCP runtime panel: /mcp command + Settings tab with status, tools and errors | |
351
- | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | Approval-gated cross-session memory: ctx.memory seam + SQLite + memory tool | | 🧊 FROZEN — see the repo README |
352
- | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | OpenTelemetry and Langfuse observability exporter for DeepSeek Harness. | |
353
- | **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | Claude Code outputStyles-equivalent runtime style switching | |
354
- | **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | Claude Code-style declarative allow/deny/ask permission rules with audit | |
355
- | **[dsh-plugin-certification](https://github.com/PerryLink/dsh-plugin-certification)** | Community certification registry with repro-checkable grades and badges | |
356
- | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | Zero-dependency static + sandbox smoke detector for DSH plugins | |
357
- | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | Plugin-development knowledge base as an on-demand agent skill | |
358
- | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | Shared zero-runtime-dependency toolkit for the PerryLink DSH plugins | |
359
- | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | One-package, one-corridor-index plugin upgrade skill: routes a repository to the matching closed corridor card | |
360
- | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | Multi-channel approval/question bridge: WeChat/Telegram/Feishu, session console | | 🧊 FROZEN — see the repo README |
361
- | **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | Verifiable research-report engine: content-addressed evidence ledger and sealed versions | |
362
- | **[dsh-score](https://github.com/PerryLink/dsh-score)** | Multi-dimensional quality scoring for DeepSeek Harness plugins. | |
349
+ | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | Cost governance for DeepSeek Harness: budgets, carbon, and latency in one panel. | 🧊 FROZEN — see the repo README |
350
+ | **[dsh-catalog](https://github.com/PerryLink/dsh-catalog)** | DSH Desktop Market standard catalog source for the PerryLink family | |
351
+ | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | Read-only MCP server exposing the certification registry: grades, snapshots and five-dimension evidence | |
352
+ | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | Claude Code /rewind-equivalent: snapshots, session forks, one-shot restore | |
353
+ | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | Migrate Claude Code sessions, memory, skills and CLAUDE.md into DSH | 🧊 FROZEN — see the repo README |
354
+ | **[dsh-click](https://github.com/PerryLink/dsh-click)** | Cross-platform native desktop control for DeepSeek Harness — Windows first. | |
355
+ | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | Terminal-style input history for the web composer: arrows, Ctrl+R search | |
356
+ | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | Dataset quality checks and citation cross-checks (the optional numeric bridge consumed here) | |
357
+ | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | Prompt-injection, jailbreak, and secret-leak defense for DeepSeek Harness. | 🧊 FROZEN — see the repo README |
358
+ | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | Engineering-discipline guard: requirements grill, test gates, adversary review | |
359
+ | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | Unified static-image generation routing for DeepSeek Harness. | 🧊 FROZEN — see the repo README |
360
+ | **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | Read-only performance diagnostics for DeepSeek Harness. | |
361
+ | **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | Deterministic research reports for Chinese public mutual funds | |
362
+ | **[dsh-github](https://github.com/PerryLink/dsh-github)** | GitHub PR/issues integration for DSH, every write gated by approval | |
363
+ | **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | Industry research orchestration that seals its deliverables through this plugin's `ctx.researchReport.assemble` | |
364
+ | **[dsh-laya](https://github.com/PerryLink/dsh-laya)** | Laya typed decisions (`noul`/`choice`/`score`) as a first-class Cordis service and model-visible tools | |
365
+ | **[dsh-library](https://github.com/PerryLink/dsh-library)** | Local document knowledge base for DeepSeek Harness. | |
366
+ | **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | Local-model (Ollama) integration for DeepSeek Harness. | |
367
+ | **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | LSP diagnostics, formatting, completion, code actions and rename over language servers | |
368
+ | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | PII masking middleware: anonymize at the model boundary, restore at the display layer | |
369
+ | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | Read-only MCP runtime panel: /mcp command + Settings tab with status, tools and errors | |
370
+ | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | Approval-gated cross-session memory: ctx.memory seam + SQLite + memory tool | 🧊 FROZEN — see the repo README |
371
+ | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | OpenTelemetry and Langfuse observability exporter for DeepSeek Harness. | |
372
+ | **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | Claude Code outputStyles-equivalent runtime style switching | |
373
+ | **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | Claude Code-style declarative allow/deny/ask permission rules with audit | |
374
+ | **[dsh-plugin-certification](https://github.com/PerryLink/dsh-plugin-certification)** | Community certification registry with repro-checkable grades and badges | |
375
+ | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | Zero-dependency static + sandbox smoke detector for DSH plugins | |
376
+ | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | Plugin-development knowledge base as an on-demand agent skill | |
377
+ | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | Shared zero-runtime-dependency toolkit for the PerryLink DSH plugins | |
378
+ | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | One-package, one-corridor-index plugin upgrade skill: routes a repository to the matching closed corridor card | |
379
+ | **[dsh-plugin-upgrade-015](https://github.com/PerryLink/dsh-plugin-upgrade-015)** | Merged `0.1.3-alpha.1` → `0.1.5-rc.1` upgrade corridor card plus a zero-dependency seam scanner | 🚫 RETIRED — corridors carried by `dsh-plugin-upgrade` |
380
+ | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | Multi-channel approval/question bridge: WeChat/Telegram/Feishu, session console | 🧊 FROZEN — see the repo README |
381
+ | **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | Verifiable research-report engine: content-addressed evidence ledger and sealed versions | |
382
+ | **[dsh-score](https://github.com/PerryLink/dsh-score)** | Multi-dimensional quality scoring for DeepSeek Harness plugins. | |
363
383
  | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | Pin sessions in the Web sidebar with durable ordering | 🚫 **RETIRED** — see the note above |
364
- | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | Cross-device session sync for DeepSeek Harness — a dedicated git mirror of your session store. | |
365
- | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | Security-audit skill pack: secret scan, dependency and supply-chain review | |
366
- | **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | Voice-first session loop for DeepSeek Harness: talk to it, hear it answer. | |
384
+ | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | Cross-device session sync for DeepSeek Harness — a dedicated git mirror of your session store. | |
385
+ | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | Security-audit skill pack: secret scan, dependency and supply-chain review | |
386
+ | **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | Voice-first session loop for DeepSeek Harness: talk to it, hear it answer. | |
367
387
  | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | Cross-session team rooms: shared message bus, task board and timeline | 🚫 **RETIRED** — see the note above |
368
- | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | Isolated install-and-smoke test drives for DeepSeek Harness plugins. | |
369
- | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | TickTick/Dida365 task bridge: session-header panel + 11 tools | |
370
- | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | Vendor parameter translation and deterministic JSON repair for DeepSeek Harness. | |
371
-
372
- ## License
373
-
374
- Apache-2.0. See [LICENSE](./LICENSE) and
375
- [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md).
388
+ | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | Isolated install-and-smoke test drives for DeepSeek Harness plugins. | |
389
+ | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | TickTick/Dida365 task bridge: session-header panel + 11 tools | |
390
+ | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | Vendor parameter translation and deterministic JSON repair for DeepSeek Harness. | |
391
+
392
+ ## License
393
+
394
+ Apache-2.0. See [LICENSE](./LICENSE) and
395
+ [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md).