插件市场目录源 PerryLink/dsh-catalog

dsh-catalog

dshfind

这是 PerryLink DeepSeek Harness 插件家族的 DSH Community Market 标准目录源。它从 npm registry 生成，按公开的 v1 契约 schema 校验，并在服务商页面旁边放一份只读的采用等级 sidecar。每个条目都带中文名和一行中文简介（displayNameZh / summaryZh），与英文那一对并列。

- 清单：catalog-source.json（生成产物，见 Deploy）
- 服务商页面：artifacts/v1/plugins.json（生成产物）
- 等级 sidecar：artifacts/v1/levels.json（生成产物；已提交并部署镜像 deploy/artifacts/v1/levels.json，由 GET /v1/levels 提供）
- 事实来源：data/packages.json（npm 包名 → 仓库 → 显示名 → 分类）+ data/npm-snapshot.json（npm registry 快照）
- 生成器 / 校验器：scripts/build-catalog.mjs、scripts/validate.mjs、scripts/check-counts.mjs、scripts/check-levels.mjs
- 部署：线上地址 https://perrylink-dsh-catalog.perrylink.workers.dev（Cloudflare Workers，由 deploy.yml 自动执行；Vercel 静态方案见 vercel.json；Deno 单元 deploy/deno-worker.js 作为手动方案）

dsh-catalog 的工作流示意图

工作流概览：安装 → 打开面板 → 开始操作。目录就是发现入口。

维护状态：家族内部工具

2026-10-05 重新归类 —— 有意不退役。 对照官方 harness 和更广的生态，对整个插件家族做了一轮审查，把本仓库归类为家族内部工具，而不是产品。
它的职责是为 DSH Desktop Community Market 盘点本家族，因此不与第三方目录竞争，也无需退役。它继续维护。

一份名册，一个来源

目录是发现入口，不是家族名册的一比一投影。它承载 data/packages.json 里的 npm 记录（包括社区/第三方记录，以及为兼容旧安装而保留的已退役名称）。每个插件的 README 都带同一份折叠名册。

分类 sidecar（只读，非官方）

服务商页面的 categories 字段，每个包只带一个市场分类（共 12 类：security、workflow、developer-tools、integrations、research、content、data、observability、interface、business-ops、compliance、platform）。原型和领域标签发布在页面旁边，从不放进条目内部：v1 条目契约里没有 taxonomy 成员。

- Endpoint：GET /v1/taxonomy
- 提交的载荷：deploy/artifacts/v1/taxonomy.json
- Schema：dsh-taxonomy-sidecar/1
- revision / generatedAt 与它所描述的服务商页面一致
- 每个目录条目一条记录：{ name, category, archetype, domains, status }
- 事实来源：TAXONOMY.md
- check-taxonomy.mjs 把 sidecar 和页面绑在一起：每个条目都被覆盖，页面的 categories 恰好等于 [category]，并强制校验 12 分类 / 16 原型的词表。

sidecar 是机器可读的元数据，不是安全审查、排名或付费推广。

合规说明

- 契约：catalog-provider-contract.md（v1，manifestVersion/schemaVersion 为 1.0.0）。本仓库没有内置任何 schema；scripts/validate.mjs 复刻了 catalog-source.schema.json 和 catalog-provider-page.schema.json 的结构规则，以及跨字段规则（条目 id 唯一、npm 名称模式、条目里不含安装命令、仓库 URL 用 HTTPS、页面形状）。
- 使用最小可用配置档：query.supported = []，defaultLimit = maxLimit = 50，sorts = []。端点返回完整的有界页面（一次响应 126 个条目），所以 DSH Desktop 一次请求就能扫完，再在本地索引上做搜索和过滤。⚠️ maxLimit = 50 限制的是切片请求，不是这个整页响应——按设计，交付的页面比 maxLimit 大，这两个数字本来就不该相等。
- 每个条目都带 package.registry = "npm" + package.name，以及规范的 repository.url；绝不输出安装命令、shell 片段或可执行数据。
- 每个条目还带同源的 media.icon（/icons/<slug>.png，由 scripts/build-icons.mjs 确定性生成）；Worker 自己提供这些 PNG，所以图标留在目录源上，符合市场对媒体资源的要求。
- manifest 端点和 manifest 本身必须共用同一个 HTTPS 源（市场规则）。生成的占位端点 https://replace-with-deploy-origin.invalid/... 会在部署时替换成真实的部署源——不要把占位 URL 注册到 DSH Desktop。

采纳级 sidecar（只读，非官方）

目录列表是安装元数据，不是认证、审计、排名或质量评分。等级信息发布在服务商页面旁边，绝不放进条目内部：v1 条目契约没有 levels 成员，放进去会让页面失效。sidecar 与 artifacts/v1/plugins.json 出自同一次运行；提交并部署的副本是 deploy/artifacts/v1/levels.json，由部署单元以 GET /v1/levels 提供。

- 同一修订。 sidecar 的 revision 和 generatedAt 就是目录页面自己的值，消费方因此能判断某条等级引用属于它正在读的页面。
- 来源是指针，不是关联。 source 指向标准项目的 publish/attestations/index.json（目前是私有草稿）。本仓库不在构建时抓取它，也不声称它已公开；因此 sidecar 不携带由它派生的状态。A–D 认证与 ENTRY/FLOW/BOOST 相互独立，永远不会换算成等级。
- 没有证据就是未运行。 每个目录条目都有一条记录，以 npm 名称为键。entry / flow / boost 使用市场标签 schema 的固定词汇。没有等级证据记录时，取值为 not-run / not-run / not-measured——绝不是通过，也绝不会因为某个包流行、被安装或在另一套方案下通过认证就升级。
- 安装元数据，不是实测版本。 peerRange / dshVersion（声明的范围；缺失时 dshVersion 为 null）复制自条目声明的 requires.dsh；这是安装范围，不代表该包已在该版本上实测。withdrawn: true 标记目录 status 为 retired 的行（生命周期事实）；冻结行保持普通状态。dshVersion 和 deprecated 保留给实测版本和真实弃用记录；目前两者都不写入。
- 只读参考。 消费方可以渲染这些状态、链接到证据，并从默认视图中去掉 withdrawn 行。不得把 sidecar 用作排名权重、付费展示信号或证据的替代品。

node scripts/check-levels.mjs 校验 schema、修订匹配、来源指针、非官方免责声明、npm 名称唯一性、三套状态词汇、布尔标志、目录全覆盖和证据规则。通过时退出码为 0，违规时为 2。npm test 和 npm run build:check 都包含这道关卡。

构建

node scripts/build-catalog.mjs # placeholder endpoint
node scripts/validate.mjs # structural checks
node scripts/check-levels.mjs # sidecar checks
node scripts/build-catalog.mjs https://<your-project>.deno.dev # real origin

build-catalog.mjs 把清单、服务商页面和等级 sidecar 写到仓库根目录，并将三者全部镜像到 deploy/，因此 deploy/deno-worker.js 是自包含的 Deno Deploy 单元（它的 ./ 导入总能解析）。
data/npm-snapshot.json 会以 UTF-8 安全的方式刷新：

node scripts/refresh-snapshot.mjs # re-fetch every package from registry.npmjs.org

定时工作流（.github/workflows/refresh-catalog.yml）每天运行一次，只在 registry 有变更时，才在 chore/catalog-refresh 分支上开一个 PR。
开 PR 之前，它会先跑数据、产物、类型三道检查；合并 PR 会触发部署工作流。上面这条手动命令用于强制刷新。

维护 data/

data/packages.json 和 data/npm-snapshot.json 是一个整体：新增或重命名包时，快照行必须在同一个 commit 里一起改。2026-09-09 连续两次 main 部署失败，原因正是如此——先是 data/packages.json 少了一个逗号，接着是某个包只列了名字、没带快照行（Error: npm snapshot missing for …）。这两种问题本地 pre-push 钩子都能拦住；每个 clone 只需启用一次：

git config core.hooksPath .githooks # then every push runs node scripts/check-data.mjs

scripts/check-data.mjs 是只读的。不要拿 node scripts/build-catalog.mjs 当检查用：不带参数调用它，会用占位 origin 重写已提交的 deploy/ 产物。

家族数量不是手工维护的：scripts/check-counts.mjs 从 data/packages.json 推导出这个数字，并约束所有声明它的地方——README 摘要（英文 + 中文）、manifest 描述、发布页面的 items/page.total，以及部署 live-smoke 的下限——都以这一个来源为准。运行它即可校验，或运行 node scripts/check-counts.mjs --write，从来源重写 README 里声明数量的位置。之所以有这个脚本，是因为数字确实漂移过：README 和 manifest 宣传的家族比页面实际发布的多了个包（具体数字和修复它的 commit 记录在 scripts/check-counts.mjs 的文件头里）。

.github/workflows/ci.yml 在每次推送到 main 和每个 pull request 上都会运行 scripts/check-data.mjs、scripts/check-counts.mjs、scripts/check-levels.mjs，以及 build/validate 这一对脚本，所以上面的钩子只是图个方便，并不是唯一的防线。
scripts/validate.mjs 优先解析已提交的 deploy/ 镜像——那才是真正发布的载荷，也是新 clone 唯一持有的副本——并约束 page.total 等于 items.length。
scripts/check-levels.mjs 用同样的方式解析，并约束 sidecar 与已提交页面的 revision 一致；如果本地构建同时留下了 artifacts/ 和 deploy/ 两份副本，它们必须一致。随后 CI 会重新构建，断言已提交的 deploy/catalog-source.json 仍然匹配，以此抓出改了 data/ 却没同步到 deploy/ 的情况。这次重新构建是唯一可以安全使用无参数形式的地方：runner 的 checkout 用完即弃，而且 manifest 不带时间戳，所以字节级可复现。

部署

线上地址：https://perrylink-dsh-catalog.perrylink.workers.dev（Cloudflare Workers，由 deploy 工作流自动部署）。
自动发布通道 —— 工作流会用线上 origin 重建清单，校验后再部署；某个通道缺少 token secret 时，会跳过该通道，不报错：

- Cloudflare Workers（已启用）：deploy/wrangler.toml + deploy/cloudflare-worker.js。需要 CLOUDFLARE_API_TOKEN + CLOUDFLARE_ACCOUNT_ID 两个 secret。部署分两轮：先上传占位 origin 的 worker，读出分配到的 .workers.dev URL，再按这个 origin 重建清单并重新部署。workers.dev 不可用时，回退到 Cloudflare Pages（.pages.dev）。
- Vercel：vercel.json 把 /v1/plugins 重写到 artifacts/v1/plugins.json，把 /v1/levels 重写到 artifacts/v1/levels.json。需要 VERCEL_TOKEN。
- Deno Deploy（手动）：自带 deploy/deno-worker.js；部署前先运行 node scripts/build-catalog.mjs https://<your-project>.deno.dev 重建。

站点在同一个 HTTPS origin 上以 application/json 提供 GET /catalog-source.json、GET /v1/plugins 和 GET /v1/levels。/v1/levels 是 sidecar 端点，不是 v1 清单契约的新成员。

在 DSH Desktop 中使用

打开内置 Market → Sources → 添加源 → 粘贴清单 URL https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → 选中它。浏览是只读的；安装清单里的任何插件，都要走 Market 自己的 npm 身份校验和用户确认。

收录进本目录只是元数据，不代表安全审查；level sidecar 只是只读参考，不是认证。这些插件在 dsh-plugin-certification 里也有证据记录，并可通过 dsh-cert-mcp 以 MCP 访问。

中文说明

PerryLink 全家桶的 DSH Community Market 标准目录源：126 个 npm 包（125 个家族仓 + 第三方 dsh-phocinae，后者只是并列收录，不算家族作品），由 npm registry 生成，按公开 v1 契约做结构校验；每个条目都带中文名与一句话中文摘要（displayNameZh / summaryZh），与英文成对。已上线 Cloudflare Workers（perrylink-dsh-catalog.perrylink.workers.dev，deploy workflow 自动部署；Vercel 静态重写与 Deno Deploy 为备选通道）。每个条目还带同源 media.icon 图标（/icons/.png，由 scripts/build-icons.mjs 确定性生成）。在 DSH Desktop 的 市场 → Sources 里添加 manifest URL 即可浏览（浏览只读；安装仍走市场自身的 npm 身份校验与用户确认）。生成产物中的占位域名 replace-with-deploy-origin.invalid 在部署时替换，请勿直接注册占位地址。维护纪律：data/packages.json 与 data/npm-snapshot.json 必须同一次 commit 成对更新（2026-09-09 连续两次 main 部署红灯即由此而来：先是漏逗号，后是新增包缺 npm 快照行）；执行一次 git config core.hooksPath .githooks 后，每次 push 都会跑只读门禁 scripts/check-data.mjs。切勿把不带参数的 node scripts/build-catalog.mjs 当作门禁——它会把已入库的 deploy/ 产物改写成占位域名。CI：.github/workflows/ci.yml 在每次 push 到 main 与每个 PR 上跑 scripts/check-data.mjs、scripts/check-counts.mjs、scripts/check-levels.mjs 与 build+validate；scripts/validate.mjs 默认直接读已入库的 deploy/ 产物（真正上线的载荷，干净 clone 里只有它），并把 page.total 锁到 items.length；随后重建断言 deploy/catalog-source.json 未过期，可发现「改了 data/ 却没重建 deploy/」；该重建在 CI 的一次性 checkout 里是安全的，因为 manifest 不含时间戳、可字节复现。计数单一来源：包数一律由 data/packages.json 派生——scripts/check-counts.mjs 校验 README（EN+ZH）/manifest/产物/部署冒烟下限一致，--write 可从该来源重写 README 计数，禁止手写。

层级 sidecar（只读、非官方）：目录只提供安装元数据与 level 引用，不做认证、审计、排序或权重。artifacts/v1/levels.json（生成物；入库/部署副本 deploy/artifacts/v1/levels.json，线上 GET /v1/levels）与 provider page 同 revision/generatedAt；按 npm 名为每个 catalog 条目提供 entry/flow/boost，没有 level 证据时一律 not-run/not-run/not-measured，绝不写成通过，也不从 A–D 评价推导。source 指向标准项目的 publish/attestations/index.json（目前为私有草案，公开可达性不作承诺）。peerRange 取自条目声明的 requires.dsh（安装元数据，不是实测版本）；status: retired 的条目带 withdrawn: true，dshVersion/deprecated 为保留字段，当前无实测版本与弃用记录，均不写。校验：node scripts/check-levels.mjs（0 通过 / 2 违规），已接入 npm test 与 npm run build:check。

License

Apache-2.0. Catalog data derives from the npm registry and the PerryLink plugin repositories.

DSH family line: this repository belongs to the PerryLink DeepSeek Harness plugin family, whose current line is dsh-v0.1.7-rc.2.

PerryLink DSH Plugin Family

This project is part of the DeepSeek Harness plugin family from PerryLink. The roster stays collapsed below so every README keeps a short first screen; expand it to see every row and its status.

Expand all plugins

| Plugin | Status |
| dsh-aqua-input-check | |
| dsh-archive-check | |
| dsh-auto-review | |
| dsh-autotier | 🧊 FROZEN — see the repo README |
| dsh-bid-ca-precheck | |
| dsh-bid-qual-check | |
| dsh-cert-mcp | 🧊 已冻结 —— 见仓库 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 |

采用级别（非官方）

生态正在转向三种采用深度，而不是等级：DSH-ENTRY（兼容性基线 —— 能不能装、能不能启动？）、DSH-FLOW（推荐可用性 —— 用户能不能安装、配置、恢复、升级和卸载？）、DSH-BOOST（Cordis 实践 —— 是否可量化地更便宜？）。它们不是认证，不是排名，也未获 DeepSeek 背书。

- 公开教学文案：dsh-plugin-guide/guide/standards.md
- dsh-plugin-doctor 在 JSON 报告里给出 ENTRY 投影；dsh-plugin-certification 解释了它的 A–D 评级为何与这些级别正交。
- 本目录的机器可读投影是 artifacts/v1/levels.json（GET /v1/levels）：只读 sidecar，不是条目字段。没有证据的状态一律为 not-run / not-measured。
- 机器可读的 spec/levels.json 和审计工具放在私有 dsh-standard 项目里（草稿；请询问维护者）。sidecar 的 source 指向该项目的 publish/attestations/index.json。