插件开发工具包 PerryLink/dsh-plugin-kit

@perrylink/dsh-plugin-kit

已迁移： 本项目现更名为 dsh-scaffold。本仓库仅作指引与备份保留，后续开发在新仓库进行。旧 npm 包 @perrylink/dsh-plugin-kit 已废弃。

非官方配套工具。 属于 DSH 标准家族；不构成认证、资质认定、安全审计或官方背书。标准见：https://github.com/PerryLink/dsh-standards。dsh.standards 块是 not-run 占位符，不代表通过。

dsh plugin --profile <name> add @perrylink/dsh-plugin-kit

PerryLink DSH 插件仓库共用的零运行时依赖工具包。逐项目审计发现，20 多个插件各自手写同一套 Provider 接缝，重复实现同样的 sanitize/pricing/verdict 结构，于是本包把这些全部抽出来——可插拔的 Provider 接缝、失败即拒绝的审批门与会话事件自适应门、机械化的 verify 脚本，以及共用的 sanitize/pricing/judge 纯模块——收进一个 ESM + TypeScript 包。

包名。 本项目在 npm 上发布为 @perrylink/dsh-plugin-kit。裸 npm 名 dsh-plugin-kit 属于另一个无关项目——安装它并不会装上本包。

- 1024 商店渠道：先执行一次 npm i -g dsh1024，再执行 dsh1024 plugin --profile web add @perrylink/dsh-plugin-kit（会计入 deepseek1024.com 的安装排名）。

DSH Market

dshfind

PerryLink DSH 插件仓库共用的零运行时依赖工具包。逐项目审计发现，20 多个插件各自手写同一个 Provider 接缝，重复实现同样的 sanitize/pricing/verdict 结构，所以这个包把这一切都抽出来——可插拔的 Provider 接缝、失败即拒绝的审批门与会话事件自适应门、机械化的 verify 脚本，以及共享的 sanitize/pricing/judge 纯模块——收进一个 ESM + TypeScript 包。

安装与卸载

作为库使用时，安装用 pnpm add（见快速开始）。这个包还附带一个刻意留空的 dsh.bundle.patch 层（cordis.patch.yml），所以当某个配置档想把这套工具作为包挂载时，它会走 harness 的 bundle 通道：

npm channel (published releases)
dsh plugin --profile web add @perrylink/dsh-plugin-kit

git channel (latest master)
dsh plugin --profile web add github:PerryLink/dsh-plugin-kit

卸载用：

pnpm remove @perrylink/dsh-plugin-kit

不会注册任何全局状态：卸载就是安装的逆操作。

dsh-plugin-kit 是什么？

PerryLink DSH 插件仓库共享的零运行时依赖工具包。逐项目审计发现，20 多个插件各自手写同一个 Provider 接缝，重复实现同样的 sanitize/pricing/verdict 结构，所以这个包把这一切都抽出来——可插拔的 Provider 接缝、失败即拒绝的审批门与会话事件自适应门、机械化的 verify 脚本，以及共享的 sanitize/pricing/judge 纯模块——收进一个 ESM + TypeScript 包。

dsh-plugin-kit 的工作流图：调用 → 插件 → 结果。

工作流概览：调用 → 插件 → 结果。下面的示例使用真实的命令接口。

兼容性

- DSH harness：这个工具包在运行时不会从 @deepseek-ai/ 导入任何东西。@deepseek-ai/cordis（^4.0.5-alpha.1）、@deepseek-ai/schemastery（^3.18.5-alpha.1）以及 @deepseek-ai/dsh- 系列包，都是可选的 peer 依赖，落在 PerryLink 插件仓库共用的 >=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0 区间内；它们只用于类型互操作。2026-09-11 已针对 dsh-v0.1.7-alpha.1 master 检出验证（完整门链 + 配置档安装冒烟），2026-10-05 又针对 dsh-v0.2.1-alpha.1 检出重新验证（完整门链 + 配置档安装冒烟）。
- Node：^22.19.0 || >=24.0.0，仅支持 ESM。
- 接口兼容：名称和结构与 dsh-mask（sanitize）、dsh-budget（pricing）、dsh-auto-review（judge 与 fallbackPolicy 词汇表）保持一致，所以迁移是机械化的。

你能得到什么

- 零运行时依赖——纯核心（seam、gates、shared）在浏览器里也能安全运行。
- ESM + 严格 TypeScript——每个模块都有 JSDoc 契约；开启 strict、noUncheckedIndexedAccess、exactOptionalPropertyTypes。
- 失败即拒绝与自适应门——审批绝不默认放行；在拒绝未知事件类型的主机上，会话事件追加会优雅降级。
- 新插件骨架 — template/ 内含 cordis.yml、一个三角色 src/index.ts（服务定义 / 提供方 / 消费方）、一个测试，以及共享的 Renovate 预设。

快速开始

dsh plugin --profile web add github:PerryLink/dsh-plugin-kit

从 npm 安装：

pnpm add @perrylink/dsh-plugin-kit

从 git 安装（prepare 脚本只用生产依赖构建 lib/）：

pnpm add github:PerryLink/dsh-plugin-kit

一步替换手写的注册表：

import { ProviderRegistry } from '@perrylink/dsh-plugin-kit/seam'

const registry = new ProviderRegistry<Detector>({
default: { name: 'regex', impl: new RegexDetector() },
})
ctx.effect(() => registry.register('ner', new NerDetector()))
const active = registry.use('ner') ?? registry.use()

示例

下面是插件真实的入口；安装一次，然后调用其中一个。

详细示例

命令

~~~sh
import { createStripper } from '@perrylink/dsh-plugin-kit/shared'
createStripper().strip('call 13800138000 or email a@b.com')

输出

~~~text
call <PHONE_1> or email <EMAIL_1>

来源：README.md:153 (shared sanitize); src/shared/sanitize.ts:268; test/sanitize.test.ts:8-19

失败分支

输入

~~~text
const r = new ProviderRegistry(); r.register('openai', impl); r.register('openai', impl) // second call

输出

~~~text
Error: Provider "openai" is already registered

来源：plugins/dsh-plugin-kit/lib/seam/provider.js:55-58; plugins/dsh-plugin-kit/test/seam.test.ts:27-30; plugins/dsh-plugin-kit/README.md:164

简要示例

- applyFailClosed
- parseVerdict

配置

没有运行时配置：门禁和辅助函数都是纯函数。唯一的配置面是 cordis.patch.yml，这是为 harness 配置档组合提供的 bundle 补丁层；它不挂载任何插件行（本套件是库），只说明使用方插件如何添加自己的行。

工具与接口面

| 子路径 | 用途 |
| seam | ProviderRegistry<T> — 可逆、失败即报错的具名服务商注册表。 |
| gates | applyFailClosed；makeEventGate / maybeAppendSessionEvent / probeIgnorableAppend。 |
| shared | sanitize（Stripper、redactText、redactMapping、sanitizeText、sanitizeUrl）、pricing（BUILTIN_PRICES、estimateUsageCost、tokenCarbon、latencyStats、formatMoney、formatTokens）、judge（parseVerdict、VERDICT_SCHEMA、riskExceeds）。 |
| verify | 机械化的 CI 门禁（verify-license、verify-readme-languages、verify-seam），带 VerifyReport 和非零退出的命令行：node lib/verify/cli.js all . |
| template/ | 新插件骨架（cordis.yml、三角色插件、测试、README、renovate.json5）。 |
| 根 barrel | 重新导出以上全部内容。 |

权限与数据

本套件自身不做 I/O、不访问网络、不启动子进程。Stripper 只在内存中保留占位符到原文的映射，并且
stats()/redactMapping() 绝不输出明文；持久化映射的调用方要自己承担这个决定，并管好存储权限。

安全边界

- sanitize/redact* 属于展示层卫生，不是安全边界：它们只减少泄漏到日志和结果里的内容，不做认证，也不做授权。
- 审批门默认失败关闭（rejected）；唯一的放行路径是显式选择 allow-once。
- 宿主拒绝的会话事件追加会被跳过，绝不重试到可能破坏会话恢复的程度。
- 报告漏洞请走 GitHub Security Advisories，见 SECURITY.md。

已知限制

- 如果宿主的 Session.append 第三个参数是 SurfaceIntent（0.1.2-rc.1），可忽略信封探测会抛 validateNext；此时审批门退化为跳过未知项，审计事件被丢弃（失败关闭），而不是在这些宿主上记录日志。
- 0.1.2-rc.1（适配于 2026-09-02）：会话信封保留可忽略字段，仅用于兼容已存储日志的读取——Session.append 仍然无法写入该字段，所以审计门行为不变。
- 本套件不提供浏览器 UI 部分；它是库，由其他插件的宿主部分（以及可选的客户端部分）使用。

开发

pnpm install
pnpm run typecheck # tsc --noEmit
pnpm run typecheck:ci # CI face: tsc -p tsconfig.ci.json --noEmit
pnpm test # vitest unit tests
pnpm run build # emit lib/ + declarations (also run by prepare)
pnpm run verify:self-contained
pnpm run verify:artifacts

相关主题

本仓库也是生态的维护中心：scripts/sync-peer-range.mjs 一条命令就能在目标目录下所有仓库里重新锁定共享的 peer 版本区间；renovate/default.json5 是每个仓库都继承的共享 Renovate 预设；.github/workflows/npm-publish.yml 是可复用的、由 tag 触发的发布工作流（只需一个 NPM_TOKEN secret）；data/repos.json 是门户读取的生态注册表。名单请读那个文件；各插件的 README 里带着折叠列表。详见 docs/ecosystem-tooling.md。

关键词：dsh, dsh-plugin, deepseek-harness, deepseek, cordis, perrylink, provider, seam, approval, sanitize, pricing, judge。

贡献者

由 PerryLink 维护，并得到 DSH 插件生态的贡献。

PerryLink DSH 插件家族

本项目属于 PerryLink 的 DeepSeek Harness 插件家族。名单默认折叠在下方，让每个 README 的首屏都保持简短；展开即可看到每一行及其状态。

展开全部插件

| 插件 | 状态 |
| dsh-aqua-input-check | |
| dsh-archive-check | |
| dsh-auto-review | |
| dsh-autotier | 🧊 FROZEN — 见仓库 README |
| dsh-bid-ca-precheck | |
| dsh-bid-qual-check | |
| dsh-cert-mcp | 🧊 FROZEN — 见仓库 README |
| dsh-checkpoint-rewind | |
| dsh-click | |
| dsh-composer-history | |
| dsh-contract-stance | |
| dsh-customs-doc-check | |
| dsh-data-quality | |
| dsh-demurrage-ledger | |
| dsh-doublecheck | |
| dsh-drill-script-check | |
| dsh-eia-guide-check | |
| dsh-emergency-plan | |
| dsh-essay-rubric-check | |
| dsh-evidence-check | |
| dsh-export-ctl-check | |
| dsh-fast | |
| dsh-fmea-table-check | |
| dsh-forecast-penalty | |
| dsh-fund-research | |
| dsh-github | |
| dsh-gongwen-flow-check | |
| dsh-gongwen-word-check | |
| dsh-guard-plan-qc | |
| dsh-hazchem-check | |
| dsh-hazplan-check | |
| dsh-hidden-risk-map | |
| dsh-hs-classify | |
| dsh-icd-rule-check | |
| dsh-industry-research | |
| dsh-lawcite-adapter | |
| dsh-laya | |
| dsh-lc-doc-check | |
| dsh-learning-gap-check | |
| dsh-library | |
| dsh-local-ai | |
| dsh-lsp-actions | |
| dsh-mask | |
| dsh-mcp-panel | |
| dsh-medrec-qc | |
| dsh-memento | |
| dsh-nsfc-form-check | |
| dsh-nurse-record-check | |
| dsh-observe | |
| dsh-origin-rvc-check | |
| dsh-ota-review-check | |
| dsh-output-styles | |
| dsh-paper-doc-adapter | |
| dsh-permission-rules | |
| dsh-permit-report-check | |
| dsh-pipeline-check | |
| dsh-pleading-draft | |
| dsh-plugin-doctor | |
| dsh-plugin-guide | |
| dsh-plugin-kit | |
| dsh-plugin-upgrade | |
| dsh-policy-brief-draft | |
| dsh-power-loss-split | |
| dsh-power-ticket-check | |
| dsh-ppap-check | |
| dsh-protest-deadline | |
| dsh-railway-window | |
| dsh-repair-order-qc | |
| dsh-research-report | |
| dsh-review-reply-check | |
| dsh-rulefile-check | |
| dsh-safety-brief-check | |
| dsh-score | |
| dsh-session-sync | |
| dsh-site-log-check | |
| dsh-skill-pack-security | |
| dsh-soe-decision-check | |
| dsh-soilwater-check | |
| dsh-sop-sync-check | |
| dsh-spc-gbt-adapter | |
| dsh-talk | |
| dsh-tender-extract | |
| dsh-tender-matrix | |
| dsh-test-drive | |
| dsh-ticktick | |
| dsh-translate | |
| dsh-warranty-calc | |
| dsh-community-bench | 🧊 已冻结 — 见仓库 README |
| dsh-budget | 🧊 已冻结 — 见仓库 README |
| dsh-claude-move | 🧊 已冻结 — 见仓库 README |
| dsh-defend | 🧊 已冻结 — 见仓库 README |
| dsh-draw | 🧊 已冻结 — 见仓库 README |
| dsh-reach | 🧊 已冻结 — 见仓库 README |
| dsh-background-agents | 🚫 已停用 — 见仓库 README |
| dsh-session-pin | 🚫 已停用 — 见仓库 README |
| dsh-team-rooms | 🚫 已停用 — 见仓库 README |

许可证

Apache-2.0 — 见 LICENSE。