dsh-plugin-catalog · 插件目录面板
English
状态：开发版，非最终版本。 这是「边用边改」放出来的版本：功能与界面会不定期更新，
配置项、命令与数据目录都可能变。装之前请确认下一节的 DSH 版本区间，装完先跑一次自检。
Status: development build — not a final release. Released as-is from daily use; features and UI
change from time to time (settings, commands and the data directory may change too). Check the DSH
version range below before installing, and run the self-checks after you do.
插件目录面板 · 卡片 / 洞察条 / 来源四分类 / 体积与调用统计
DSH 侧栏「插件目录」：把本机的 插件与 Skill 摊成卡片，按来源四分类（官方 / 自写 / 第三方 / 混血），
用会话事件日志统计最近 90 天每个工具的调用次数、报错、耗时与涉及会话（子代理单独标出），
支持自定义标签 + AI 分类、每周缺口分析与安全审核、以及自写/混血的一键私有备份到 GitHub。
官方插件入口保留不隐藏。 本插件是独立的客户端插件：禁用它即恢复官方界面（见文末「自救」）。
内嵌的审核/发布 Agent 同时注册为工具（catalog_*，共 14 个），普通会话里一句话就能调起：
「审一遍 dsh-screenshot」「开放 dsh-catalog 仓」「列出我的自写插件」。
支持的 DSH 版本
装之前先对一下版本。版本不对时不会"凑合能用"：轻则面板能打开但按钮点了没反应，重则整个插件树加载失败。
| 项 | 值 |
|---|
| 声明区间 | >=0.2.1-rc.1 <0.3.0 —— 写在 package.json 的 engines.dsh，宿主按它判兼容 |
| 实测通过 | 0.2.1-rc.2 / 0.2.1-rc.3（Windows 11 · desktop profile · Node 24.21） |
| 为什么不能更低 | 用到 pluginManager.listPlugins / removeBundle / setBundleEnabled；且 DSH 0.2.1 起 ctx.tools.register() 要求 output 契约 —— 更低的宿主上这些 API 还不存在 |
0.3.x 及以上 | 未验证。面板可能能打开，但运行期对账 / 卡片动作会失效；宿主升级后请先跑一次 node dev/probe-release.mjs |
| Node | >=20（engines.node） |
适用 profile
desktop（本机实测环境：DSH 0.2.x，Windows）- 任何带
tools 与 webServer 服务的 profile 都可用（客户端半边是标准 web 平台 bundle）
- 依赖宿主的
llm 服务（AI 分类 / 翻译 / 审核）；没有它时面板仍可用，只是这些按钮会报「AI 通道不可用」
安装
三步装完，不需要任何本机脚本（Windows / macOS / Linux 都一样）。
# 0) 先确认宿主版本在上一节的区间里
dsh --version
# 1) 克隆到**工作区**（不要直接克隆进 profile/node_modules —— 那份会被后续 install 覆盖掉）
git clone https://github.com/JHboy203/dsh-plugin-catalog.git "<你的工作区>/DSH-Plugin/dsh-plugin-catalog"
- 把目录链进 profile（
<profile> 默认 desktop）：
# macOS / Linux
ln -s "<你的工作区>/DSH-Plugin/dsh-plugin-catalog" ~/.dsh/profiles/<profile>/node_modules/dsh-plugin-catalog
# Windows（普通 cmd 即可，不需要管理员）
mklink /J "%USERPROFILE%\.dsh\profiles\<profile>\node_modules\dsh-plugin-catalog" "<你的工作区>\DSH-Plugin\dsh-plugin-catalog"
- 改
<profile>/package.json 两处，然后完全退出并重启 DSH：
{
"dependencies": {
"dsh-plugin-catalog": "link:<你的工作区>/DSH-Plugin/dsh-plugin-catalog"
},
"dsh": {
"profile": {
"bundles": [ /* …原有条目…, "dsh-plugin-catalog" */ ]
}
}
}
侧栏出现「插件目录」图标即成功。
⚠️ 不要用 pnpm 系命令（dsh plugin add / pnpm add / npm install）装它。
dsh plugin 只是把参数原样转发给 pnpm；pnpm 会重算整棵树、把 @deepseek-ai/dsh-tools
再 hoist 一份到 profile 里，那一份会遮蔽宿主的 —— 后果是每次工具调用都报
Cannot read properties of undefined (reading 'prepare')，或下次启动时插件批量加载失败
（does not provide an export named 'CallId'）。这个坑在本机复发过三次。
本机若已有 .tools/dsh-plugin-install.cjs（作者工作区里的辅助脚本，不在本仓内），
它就是上面三步的自动化版：node .tools/dsh-plugin-install.cjs install dsh-plugin-catalog "<目录>"。
没有它也能按上面的手做装。
装完必须完全重启 DSH：dsh.profile.bundles 与 cordis.patch.yml 都是启动期读的。
平台：Windows / macOS / Linux 均可（路径按平台分隔符处理；本机只在 Windows 11 实测）。
卸载：面板卡片底部「卸载」（走宿主 removeBundle，不动文件），或从 dsh.profile.bundles 去掉包名后删除链接目录。
装完检查一下有没有埋雷 —— 工具调用报 prepare、或下次启动插件批量加载失败，基本都是
<profile>/node_modules/@deepseek-ai/dsh-tools 里多了一份（它会遮蔽宿主那份）。有这个目录就先移走再重启：
# macOS / Linux
ls ~/.dsh/profiles/<profile>/node_modules/@deepseek-ai
# Windows
dir "%USERPROFILE%\.dsh\profiles\<profile>\node_modules\@deepseek-ai"
用法
面板
侧栏出现「插件目录」图标（sidebar.panellist id = catalog）。点开是：
-
卡片：名称、简介（中文优先，没有中文就直接拿英文当正文，不再每张顶一行占位提示）、来源徽章、标签、创建/下载时间、调用总次数（含子代理拆分）；有报错的条目多一枚红色「报错 N」chip（悬停看错误率），从未调用过的次数置灰
-
搜索：名称 / 简介 / 判定依据，以及工具名 —— 输入 acp_status、catalog_export 这类工具名能直接定位到提供它的插件（命中时卡片上会显示「工具：xxx」）
-
洞察条：「全部 / 有调用 / 未使用 / 有报错 / 仅子代理」五个 chip 直接给条数，点一下就是筛选（计数为 0 的档位置灰但保留 —— 看得见"这台机器上没有这种人"，点开是空态 + 说明书）。每个 chip 悬停有一句解释，数字只随来源 / 类型变，不随关键词跳 —— 否则点开「未使用」后数字自己变成 0，看起来像数据丢了。「仅子代理」= 每一次调用都发生在子代理会话里：删掉它不会当场报错，只会让某条委派链下次跑的时候悄悄变差
-
筛选：来源（全部/官方/自写/第三方/混血/待标记）× 类型（全部/插件/Skill）
-
排序：调用次数 / 报错次数 / 报错率 / 体积 / 最近使用 / 时间 / 名称
（报错率比次数更能看出毛病：本机实测 @liustack/modlens 6 次调用全报错 = 100%，而 dsh-vision-router 报错 23 次却没进前四 —— 252 次调用里只占 9%）
-
视图记忆：筛选 / 搜索词 / 排序 / 页码 / 每页条数 / 滚动位置存在 localStorage，改客户端代码触发的热重载、或刷新页面之后，回来还是刚才那一屏；换筛选或换页会自动回顶部（否则第 2 页的第一条会落在屏幕外）。存储被禁用、或数据损坏时安静退回默认视图，不会白屏
-
多选批次：工具条「选择」进入选择模式，点卡片即选中（再点取消），被选中的卡有蓝框 + 勾徽章。批次条实时显示已选 N 条 · 约 X MB（体积一次性批量问，服务端并发 4；没有独立目录的 Skill 会如实标「N 条没有独立目录，按 0 计」），可「导出选中」「打标」「选中当前 N 条」「清空」。选中项跨筛选保留（未使用里挑几个、有报错里再挑几个，凑成一批），但不进 localStorage —— 重载后清空是故意的，免得半个批次被忘在那里
-
批量打标（三态）：批次条「打标」打开浮层，一次给这批条目加上/去掉 purpose 与 context 标签。每个标签显示这批里几个已经有它（n/N）：
全都有 → 实心，点一下＝全部去掉（−）；部分有 → 虚线；都没有 → 空态，点一下＝给缺的补上（＋）；
还没点之前 title 就写明"点一下会发生什么"。只改你点过的标签，不会清掉条目各自已有的其它标签（与浮窗里"整条替换"是两种语义，刻意分开）；
勾选只是本地意图，点「应用」才发一次请求 —— 中途失败不会留下半个批次。打过的条目记为手标，AI 自动分类不再覆盖
-
标签筛选：工具条下有一行标签（只在某个标签真的有条目在用时才出现），每个 chip 带命中条数。
同维度多选＝或（做截图 或 做媒体），跨维度＝且（再叠 用在 Web GUI）。点 chip 即筛，右侧「清除标签」只清标签、不动其它筛选条件
-
导出这一屏：工具条右侧「导出这 N 条」把当前筛选结果（顺序就是屏幕顺序，含筛选条件、报错率、安装位置）写成 reports/catalog-filtered-<时间戳>.md，路径可一键复制；0 条时按钮禁用。要完整快照（来源分布、调用 Top、归属覆盖率）仍用 catalog_export
-
也能导成 CSV（R28）：同一个按钮旁边还有一个「CSV」—— 同一屏、同一批筛选，只换格式：一条一行、12 列（名称/类型/来源/版本/加载/调用/报错/报错率/最近一次/体积/被依赖/位置），，Excel 直接双击打开中文不乱码。 出的是的那份表；选中批次同样有「CSV」按钮。两种格式共用同一批数字与措辞，差别只在装饰（Markdown 有反引号与加粗，CSV 里那些都是噪音）
⚠️ 面板必须自己滚：DSH 官方中列（div._centerCol）是 overflow:hidden，
面板若不自己 height:100% + overflow-y:auto，第二屏之后会被静默裁掉 ——
表现为「没有滚动条、也翻不到下面」。这条已固化成 dev/audit.mjs 的断言，改回去会红。
工具（同一套能力，普通会话里直接调）
| 工具 | 一句话 |
|---|
catalog_list | 列出所有插件与 Skill（可按来源/类型/关键字过滤）；R30 起 kind=mcp 只看 MCP 服务器 |
catalog_mcp | MCP 服务器：每台 = 组合文件里一条 @deepseek-ai/dsh-mcp-client 条目（serverName / 传输 / 命令或 URL / 开或关 / 文件:行），按官方 / 第三方 / 自己配置三分类计数，mcp__<serverName>__<tool> 的调用按服务器归属；view=orphans 找孤儿调用（指向已删/改名的服务器），view=problems 看配置问题，view=template 给三段可抄写法。只读，env/headers 的值从不显示 |
catalog_runtime | 运行期真相（R35）：宿主 Loader 里每个插件的 fiberPhase / enabled 与目录的声明层对账 —— 抓 fiberPhase=failed、声明会加载但 Loader 里没有、声明与运行时打架三类；读不到就如实说读不到。只读 |
catalog_stats | 全局概览，或某个条目的分工具明细 + 会话列表 |
catalog_tag | 列标签 / 打标签（单个 id＝整条替换；批量 ids＝只加不减）/ 批量去标签（action=untag）/ 新增自定义标签（必须给解释）/ 删标签 / 手工改来源（action=source）/ 手工改工具归属（action=tool-owner） |
catalog_classify | AI 自动打标签（会读自定义标签的解释） |
catalog_review | 审一遍某个插件（缺口分析 + 安全审核，只出建议） |
catalog_publish | 上传备份：plan → apply（需 planId + confirm，可带 ackRepos）→ public（独立门禁） |
catalog_export | 导出快照到 <数据目录>/reports/：format=md（默认）= 完整 Markdown 报告（清单、来源分布、调用 Top、仓库与 git 状态、待标记来源、归属覆盖率、每周发现、R35 起含「运行期（Loader 对账）」一节）；format=csv = 全部条目一行一条的 12 列表格（带 BOM，Excel 直接打开） |
catalog_health | 自检：跑的是哪一版、路径解析、统计覆盖、归属覆盖率、Skill 正文哈希覆盖率、「已看过」确认窗口、AI 通道、asar 模式、副本是否同步 |
catalog_skill_sync | Skill 的两份副本：plan 列出 staging 旧了的那几个（发布推的是 staging，它旧了等于发旧版）； + 做，写前把被覆盖文件备份成 ； 是反向撤销（把 staging 还原到备份，同样先出计划、 才写，只动 staging）；（计划里会列出最近 8 份可选，省略才是最近一份） |
界面定制与信息分层（R39）
面板把「一眼要看什么」和「点开再看什么」分开，并给了一小组显示偏好（右上角 ⚙）：
| 想解决的问题 | 现在的行为 |
|---|
| 头部信息重复、按钮太多 | 汇总只剩「插件 / Skill / MCP 数 + 调用量 + 更新时间」（来源分布交给工具条的来源筛选）；按钮收成 刷新 ▾ / 生成 ▾ / 审核 ▾ / 更多 ▾ + 备份 / 自检 / ⚙ |
| 变化 / 副本 / staging 提示占三行 | 默认折成一行「概览：…」，点「展开」看明细、点「×」整条隐藏（⚙ 里能恢复）；staging 旧了在折叠态也给一键同步 |
| 卡片正文是一段被截断的长文 | 卡片只放一句简要介绍（句末优先），完整介绍在详情浮窗里 |
| 卡片底部动作高低参差、有的卡缺项 | 动作位固定（插件 4 / Skill 3 / MCP 3），不可用时灰着并说明原因；动作默认收进详情页标题右侧（⚙ 里可切回卡片底部） |
| 有的卡没有中文简介 | 卡片退回显示原文；连原文都没有就明说「没有写简介」并指路「生成 ▾ → 中文简介」；打开详情时缺中文会自动补一条（同一插件一分钟只试一次） |
| 来源判定 / 标签各占一整块 | 详情页标题右侧两个按钮：来源判定 / 标签，点开就地展开（内容没删，收起时键盘与自检仍可读） |
| 详情页简介没有内容 | 完整介绍在这里：中文优先，中英都有可切；缺中文时显示原文 + 「生成中文简介」 |
| 技术块看不懂 | 每个块标题下一行大白话（「依赖关系」＝删了会不会弄坏别的插件）；⚙ 里可关 |
| 工具名不知道是干什么的 | 每个工具名下面一行中文说明（鼠标悬停也有 title）；静态表覆盖宿主与常见插件工具，自写插件的专有工具可点「生成 ▾ → 工具说明」补 |
| 涉及会话一屏 20 条太长 | 默认 每页 5 条（5 / 10 / 20 / 50 / 100 可选） |
设置项（⚙）：动作按钮放哪 / 卡片简介长短 / 顶部概览三态 / 大白话 / 简介语言 / 缺中文自动生成 /
会话每页条数 / 密度 / 列表每页条数 / 恢复默认。只改显示偏好，不改任何插件与配置；
写在浏览器 localStorage（换浏览器才丢）。
MCP 分类（R30）
面板工具条上第三颗类型 chip：全部 / 插件 / Skill / MCP。MCP 与插件是两种不同的东西，所以它有自己的判据：
| 问题 | 答案从哪来 |
|---|
| 有哪些 MCP 服务器 | cordis.yml / cordis.patch.yml 里 name: '@deepseek-ai/dsh-mcp-client' 的每条条目（按 id 合并，patch 只写 disabled 时配置仍取基线） |
| 它是官方 / 第三方 / 自己配置 | 启发式 + 理由：命令指向本地文件、配了本地 cwd、url 是环回地址 → 自己配置；命令/参数/url 里出现 @deepseek-ai/ → 官方；其余（npx/uvx/docker 拉外部包、公网 url）→ 第三方。判错了可以在浮窗里改（catalog_tag action=source） |
| 它在跑吗 | 只有三态：启用 / 关掉（disabled: true）/ 条件启用（!!js，不求值）。它不在 dsh.profile.bundles 里，所以四态加载判据对它没有意义 |
| 它被调用过多少 | 工具名契约 mcp__<serverName>__<tool> —— 按前缀归属到服务器，不靠描述指纹。mcp__ 的调用不算宿主核心工具 |
| 为什么一台都没有 | 本机目前确实没配。此时分类页给空态 + 三段可抄模板（自己配置 / 第三方 / 远程），不是一张空表 |
数据来源与边界：
- 声明层（与「配置层」浮层读同一份文本、同一时刻），改完组合文件要 重启 DSH 才生效（
cordis.patch.yml 不热更）。
env / headers 的值永不下发到浏览器或报告，只给键名；url 的 userinfo 与 query 隐藏。- 「孤儿调用」= 统计里出现过
mcp__<server>__*，但组合文件里现在没有这台服务器 —— 删过条目或改了 serverName；catalog_health / 交接单会把它标成 warn。
运行期真相与卡片操作（R35）
两件事必须分开看：声明层回答"按配置会不会被加载"，运行期回答"宿主 Loader 里它到底怎么了"。
本插件两个都有，而且互不替代。
运行期真相（catalog_runtime / 卡片 chip / 洞察条）
| 运行期状态 | 含义 | 面板上怎么显示 |
|---|
active | Loader 里在跑；声明层也一致 | 不占版面（133 张卡不该每张顶一个绿标） |
failed | fiberPhase = failed：apply 抛过错，工具/路由可能已回滚 | 红色 chip「运行期失败」+ 头部横幅点名 |
declared-absent | 声明层说会加载，Loader 里没有这一条（启动时被 skip） | 琥珀 chip「不在 loader」 |
pending / loading / unloading | 正在加载/卸载 | 琥珀 chip |
disabled | Loader 里 enabled=false，且不在 bundles（合法停用） | 灰色 chip「已停用」 |
unknown | 读不到运行期（旧宿主 / 没有 pluginManager） | 不显示，/health 与工具里有原因 |
判据在 lib/runtime.mjs（纯函数）：moduleName 带子路径时按包名归一；同一个包多条 Loader 条目时
取"最能说明问题"的那条（failed 优先）；读失败给 index = null，而不是空表 ——
用空表会把所有"声明会加载"的条目全判成 declared-absent，面板立刻一片假警报。
两类"看起来缺席、其实正常"的东西（真机第一跑踩到的坑，已进自检）：
bundle 是层（@deepseek-ai/dsh-base 就是 96 条 insert 的官方大层），它自己不作为插件运行；
transitive 是 npm 依赖（@dsh-ops/bash-win32-x64 是原生二进制），本来就不注册 Loader 条目。
所以 declared-absent 只对非 bundle 的普通插件与 config 条目成立；bundle 的健康改问
listBundles() 的 availability / error，而且只对 enabled === true 的 bundle 报 ——
离线官方目录里"可选但没装"的条目（本机 dsh-subagent-claude-code / -codex）不算故障。
卡片上的五个动作（只走面板，不注册成工具）
| 动作 | 怎么做 | 可逆吗 | 生效 |
|---|
插件 卸载 | 宿主 pluginManager.removeBundle()（不碰文件系统，不删源码） | 重新装回即可；profile 依赖与 bundle 行由宿主收 | 立即 |
插件 停用 / 启用 | setBundleEnabled（在 bundles 里）或 setPluginEnabled（Loader 条目） | 再点一次启用 | 立即 |
Skill 删除 | 整目录移进 <数据目录>/trash/skills/（rename，跨卷回退"先复制再删源"） | 可以：面板「回收站」→「还原到原位」 | 立即（下次扫描后消失） |
MCP 停用 | 往 profile cordis.patch.yml 追加 2 行（- id: … + disabled: true），只按 id 覆盖 | 删掉那 2 行 / 再改 disabled: false | 重启 DSH |
MCP 删除条目 | 从 profile 的组合文件里删掉该条目块 | 文件旁留了 .bak-<时间戳> | 重启 DSH |
三条安全纪律（都有自检钉死）：
- 两段式：点动作只出计划（
POST /action/plan：可不可用、阻断项、警告、目标、备份/回收站位置）；
确认条里再点一次才执行（POST /action/apply 必须带一次性 token + confirm:true，5 分钟过期）。
- 写前备份、写后校验：改组合文件先复制
.bak-<时间戳>，再写临时文件 + rename 原子替换；
然后重新解析校验（目标 id 少一条、别的条目一条不少、总数只少 1），校验不过自动把备份写回去。
Skill 删除本身就是"移动"，所以回收站就是它的备份。
- 留痕：每次动作（成功与失败）追加一条到
<数据目录>/actions-journal.json（最多 100 条），
面板与 catalog_health 都能看到最近几条 ——"它怎么不见了"要能查到是谁、什么时候干的。
边界（如实）：
- MCP 只处置 profile 自己那两份组合文件里的条目；bundle 自带 patch 层里的条目（
node_modules/<bundle>/cordis.patch.yml）阻断 ——
删它等于改安装包，重装/升级就回来了。MCP 的解析器也只看 profile 两份文件（bundle 层的 config: 最小解析器读不懂）。
- 插件卸载不删源码：自写插件通常是 junction，卸载只去掉依赖与入口。想彻底删，先卸载、再自己删工作区目录。
- 随插件安装的 Skill（
assets/skill/ / skill/）不给删 —— 请卸载插件或改插件源码。
- 运行期真相依赖宿主
pluginManager.listPlugins()；没有它的老宿主上这一层退化为「读不到」，面板其余功能不受影响。
数据与隐私
全部落在工作区 .dsh-plugin-catalog/（不写插件安装目录 —— 升级/重装即丢）：
| 文件 | 内容 |
|---|
cache/stats.json | 90 天调用统计（按会话分片，便于增量刷新） |
cache/catalog.json | 插件/Skill 快照（来源判定、时间、仓库） |
cache/attrib.json | 工具→插件归属索引 |
tags.json | 自定义标签（含解释）与每个条目的标签 |
overrides.json | 你手工标过的来源与工具归属 |
intros.json | 中文简介缓存（可手改） |
weekly.json | 每周任务上次执行时间与结果 |
settings.json | 设置 |
actions-journal.json | R35：卡片动作的留痕（成功与失败都记，最多 100 条；没有 token / 没有文件正文） |
trash/skills/ + trash/skills.json | R35：Skill 删除的回收站（整目录 + 索引，可在面板里还原） |
红线：统计里只有会话 ID、会话昵称、时间戳、工具名、计数。没有任何对话文本。
工具参数只在解析 skill 调用取技能名时被读一次，随后丢弃。
统计口径：
- 只读
.dsh/sessions/**/session*.zstd，绝不扫 .dsh/dsh-checkpoint-rewind/ 那类百万文件级快照目录。
- 一个会话可能同时有 v3 与 v4 两份日志（本机 772 个会话里 36 个如此），按 callId 去重，不会把调用算两遍。
- 首次打开前台不等：先显示缓存，后台算（本机 811 个日志 / 455 MB / 59,813 次调用，全量约 40~60 秒）；
之后走缓存，增量刷新约 0.5 秒。
- 缓存超过 24 小时会在界面上提示「建议刷新」，不会自动重算（避免你以为卡了）。
来源四分类怎么判
| 来源 | 判据（文件系统事实，不看人设） |
|---|
| 官方 | @deepseek-ai/* 作用域；或 dsh.profile.bundles 里声明、代码在宿主 app.asar 内 |
| 自写 | ① profile 里那个条目是 junction/symlink 且真实路径在工作区（实测 22 个）② 或 package.json 的 author 命中本人账号 ③ 或真实路径在工作区 DSH-Plugin/、.gh-upload/ 下 |
| 第三方 | 其余 |
| 混血 | 上面任一基础上，有 .git + origin 指向非本人仓 + 能比出差异（工作区脏，或本地领先上游 commit） |
Skill 的「自写」判据是：.gh-upload/my-dsh-skills/（自写集合仓）里有同名目录。
诚实的边界：npm 装进来后被就地改过的包，本工具无法自动判定 —— node_modules 里没有 .git，
也没有发布包的哈希可比。这类会标「待确认」或需要你手工标一次；标完存在 overrides.json，不再问。
用在哪里（与本机其它插件的关系）
- 工具归属是推断的：
ctx.tools.schemas() 只给 name/description/parameters，宿主没有工具→插件的登记表
（ToolService 按 agent scope 分 layers，与插件无关）。所以用两条证据链：
① description 指纹（那段描述逐字来自注册它的插件源码，唯一命中即归它）；
② 无 description 时退到 name: '<tool>' 字面量（弱证据）。
有描述却哪儿都找不到 ⇒ 判为宿主核心/官方，面板单列，不算进任何插件卡片。
- 实测覆盖率（本机 196 个工具 / 53,759 次调用）：描述指纹 193 个（85.2% 的调用量）、
名字字面量 1 个、判为宿主 2 个（
plugin_manager / exit_plan_mode）、歧义 0、未归属 0。
所以卡片上的「调用总次数」是按真实归属累加的，不是按名字猜的。
⚠️ 关键细节：插件源码里的 description 常被多行字符串拼接切开，直接拿拼好的句子去源码里找
会永远找不到（一开始就是这么把一堆自写插件误判成"宿主"的）。所以两边都压平（去空白/引号/加号/转义）
再比，dev/audit.mjs 里有针对拼接与转义 \n 的回归用例。
- 官方工具包在
app.asar 内（77 个 dsh-tool-*），会按 asar 索引读出来参与归属判定 —— 否则
65% 的调用量会挂在一句「未知来源」上。
⚠️ Electron 把 app.asar 当目录，openSync 打开归档本身会失败；lib/asar.mjs 自动区分
「virtual 模式（宿主里，走成员路径）」与「header 模式（纯 node）」，/health 会报当前模式。
「插件安装」升级时的卸载协作（R32）
宿主 0.2.1 的 pluginManager.installBundle 按包名判已装，对已存在的包名一律回
already-installed（原文：uninstall it before installing another version）。所以
dsh-plugin-installer 的「检查更新 → 升级」只有一条路：先卸载旧版，再装新版。
卸载这件事落在本插件，原因是判据都在这儿：谁声明依赖它、它现在会不会被加载、
它是 npm 还是 link:、是不是宿主自带包。判据与执行分开写，就会出现「面板说安全、执行时指空」。
| 层 | 是什么 | 边界 |
|---|
lib/removal.mjs | 单个已装包的计划 + 执行 | 只调宿主 removeBundle()，不删任何文件；计划带 5 分钟一次性 token；执行前复核版本与依赖声明（stale-plan）；执行后以依赖行为准（宿主回 applied 但依赖还在 = 没卸掉） |
Cordis 服务 pluginCatalog.removal | 跨插件契约（api: 1） | ctx.provide 在 apply 的同步阶段声明；消费方用 ctx.get("pluginCatalog") 可选取用 |
路由 POST /plugin-catalog/removal/plan · /removal/apply | 排查与人工调用 | apply 必须 token + confirm:true；与上面走同一条代码路径 |
留痕 data/removal-journal.json | 每次真卸载记一条（最多 50 条，成功与失败都记） | 「为什么它不见了」查得到是谁、因为什么 |
两边都不硬依赖：
- 本插件不改「处置清单」的行为（批量清理目录仍然只生成、永不执行）。它只是多了一项
「单个包」的能力，没有消费方时安静地待着，面板与 13 个工具一个都不变；
dsh-plugin-installer 取不到这个服务时，升级会被明确拒绝并说清原因（不会排一队必然失败的任务）；
安装、回滚、诊断、Skill 安装等全部照常。
判断「它到底会不会被加载」仍然只看 catalog_list 的 loadState；这里提供的是
动手那一步，不是第二套判据。
发布到 GitHub（自写 / 混血）
一个总按钮：「上传备份到 GitHub」→ 先出计划（不动任何东西）→ 你确认后才推。
- 命名：自写
dsh-<name>；混血 dsh-<name>-local（不覆盖原仓）
- 所有仓默认私有，全插件只有一处建仓且写死
--private
- 不 force push（
lib/gitops.mjs 里没有 --force 这条路径）
- 密钥命中即停：扫
.env、.env.*、secrets/、*.key、*.pem、configs/*-secret.json、
configs/*-config.json 与常见 token/私钥/连接串模式；命中 critical/high 的仓跳过、其余照推，
最后给「未推清单」。清单只给「文件:行 + 规则 + 掩码 + 一句判断」，不回显明文。
- README 中英两版：英文版由 AI 按规范翻译（章节一一对应、专有名词保留原文、代码块与占位符原样、
「待补充」→
TBD）；没有需要补英文的内容就不生成（英文 README、正文过少、只有「待补充」骨架都不生成）。
- 公开是独立的一次操作（
catalog_publish action=public）：必须 confirm:true，且先重扫一遍，
有命中直接拒绝。
每周任务
打开面板时若距上次超过 7 天，后台跑一次缺口分析（不阻塞界面）。
安全审核 不自动跑 —— 面板上会显示「安全审核（已到期）」按钮，由你点（它要读源码片段，更贵也更需要你在场）。
- 缺口分析维度：README 缺哪些关键章节、构建产物该不该入库、
package.json 有无自包含安装命令、
有没有把宿主核心包误写进 dependencies（会遮蔽宿主、导致插件批量加载失败）、Skill 的 description 够不够用
- 安全审核维度：
pull_request_target / workflow_run 是否检出并执行 fork 代码、GITHUB_TOKEN 是否最小权限、
可疑 eval / 拼接执行的 spawn、依赖线索。按「文件 + 行号」给发现，按置信度排序，每条附「可采纳 / 可拒绝」
已知限制（如实说明，不夸大）
- 安装 / 升级 / 卸载插件与 Skill 不归本插件管（刻意如此）：装东西走
dsh-plugin-installer
（install_hub_search_plugins / install_hub_submit_request / install_hub_status）或官方 plugin_manager。
本插件只做清点、判据、处置清单、对账、导出。★ 曾计划过一个 catalog_import，评估后主动不做：
两套安装路径会各写各的快照与回滚，出问题时谁也没法证明是哪一套写的。两边的关系是"它装、我核"——
装完回面板看 loadState 是否 loaded、进了 catalog_mcp / catalog_list 没有。
R35 的卡片动作是例外，且只走面板：卸载 / 停用 / 删 Skill / 删 MCP 由人点、服务端两段式确认；
它们没有注册成工具（模型拿不到"删用户东西"这个动作）。
0b. R35 动作层的三条边界：MCP 只处置 profile 自己那两份组合文件（bundle 自带的 patch 层阻断）；
插件卸载不删源码（junction 只去掉依赖与入口）；随插件安装的 Skill 不给删。详见「运行期真相与卡片操作（R35）」。
0c. 运行期真相依赖宿主 pluginManager.listPlugins()：没有它的老宿主上这一层退化为「读不到」
（面板与工具都会如实说原因），其余功能不受影响。fiberPhase=failed 只能告诉你"它失败了"，
具体错误仍在宿主日志 / plugin_manager set_plugin 的 diagnostic 里。
- 私有仓拿不到平台级安全扫描：GitHub 的 Secret Scanning / Dependabot / Push Protection 需要付费 GHAS。
所以「依赖已知高危」只能靠本地规则与模型常识，准确度低于平台级扫描。
- Skill 的调用统计只能到「次数 + 最近一次时间」，无法细分到会话 —— 这是机制限制，界面上有标注。
- 个人免费账户的私有仓没有「只读分享」档位：要么私有（仅本人/受邀协作者），要么公开（所有人可读）。
需要精细权限得建 Organization。
- 工具归属是推断，但实测覆盖率很高（196 个工具里 193 个靠描述指纹唯一命中，覆盖 85.2% 的调用量；
歧义 0、未归属 0）。剩下 2 个判为宿主核心（
plugin_manager / exit_plan_mode），
仍可在面板手工指定工具归属覆盖。
- 星标/下载量等生态数据不采集（本插件不联网，只读本机事实）。
- 官方包（asar 内）的磁盘体积量不到：它们在宿主安装包里，没有独立目录，所以列表与合计都按"不参与"处理。
要知道它们占多少，只能看 DSH 安装包本身的大小。
- 体积快照是"上次量的时候"：装/删/升级插件后，面板不会立刻知道变化 ——
超过 24 小时自动重量一次，也可以随时点「重量体积」（量完覆盖快照）。
- 体积有预算：单个目录最多 2 万文件 / 1.5 秒。超过的条目报下限（界面上带「+」，本机实测 1 条）。
这是为了不让一个巨型目录把整次测量拖住。
- 「无人依赖」是启发式：只读 profile 里
node_modules 下一层嵌套的 package.json，
更深的嵌套（a/node_modules/b/node_modules/c）或运行时 require 出来的包可能漏判成"没人依赖"。
所以它只做候选，界面上永远带"用 npm ls / pnpm why 确认"。本机实测 220 个包里 2 个候选
（dpi-probe-bundle、dsh-toolfold），都被更深的依赖链排除过一轮。
- 依赖图不区分 devDependencies：装进 profile 的包本来就不该有 dev 依赖，这里只按运行时声明判断。
- pnpm 的
.pnpm 虚拟仓库不展开（本机 nodeLinker: hoisted，不存在该目录）；换成 isolated 链接模式时，依赖图会退化。
排错：插件装了、面板也出来了，但没有工具/路由
这是本插件真实踩过一次的故障形态，先按这个顺序查：
plugin_manager action=list_plugins（或工具 plugin_diagnose）看 include:plugin-catalog 的
fiberPhase：
active = 正常；failed = apply() 抛了（这时客户端半边通常照常渲染，因为 client bundle 与 host 半边
是两条加载路径 —— 别被"图标在"骗了）；null = 没被启用。
- 拿错误原文：
plugin_manager action=set_plugin target=include:plugin-catalog enabled=true
—— 回包的 diagnostic 里直接写 TypeError: ...。
- 看
<数据目录>/logs/apply-trace.log（每次 apply 的分步留痕：走到哪一步一目了然）
与 apply-error.json（只有初始化失败才会写）。
- 端到端确认路由活没活：在 GUI 控制台或
client_eval 里
fetch('/plugin-catalog/health').then(r=>r.json()) —— 正常应返回 200 与构建标记；
404 空体说明路由没注册（对比：/plugin-installer/health 应恒为 200）。
已知导致 failed 的两种形态（都在真机上踩过，按"最贵"排序）：
apply 是 async 却 return 了值 ← 真正的元凶，隐蔽度最高。
cordis 的 Fiber._execute() 把 apply 的返回值当成 effect disposer 收 ——
safeCollect：不是 function 又不是 null/undefined 就 throw TypeError("Invalid effect")，
而 async apply 走的是 effect.then(safeCollect)。于是整段 apply 全部成功
（工具注册了、路由挂了、后台任务也起来了）之后，promise 一 resolve 就抛，
_reload 的 catch 把 fiber 标成 INACTIVE → 已注册的工具与路由被整体回滚。
症状：apply-trace.log 里每一步都是 OK，却"did not activate"，工具全无、路由 404，
而且宿主只写 console 不写日志文件。
→ async apply 一律 return;；要暴露服务请走 ctx，不要走返回值。ctx.effect(...) 建议在 apply() 的同步阶段注册（本插件把 cleanup 放在第一行，
用可变变量收集路由/工具的 disposer）。这条是防御性约定 —— 真机上 Invalid effect
的实证原因见上一条，别只盯 effect 时序。
另一类同样静默的坑：直接读 ctx.xxx 但没在 inject 里声明。cordis 的上下文是 Proxy，
会抛 cannot get property "llm" without inject（可选链 ctx?.llm 救不了，throw 发生在 get 陷阱里）。
读可选服务一律用 ctx.get(name)（cordis 注释原文：Read a service from the store without the
inject requirement），本插件的 lib/ai.mjs::readService() 就是这么做的。
模型调用：推理档位和 maxTokens 共用一份预算
deepseek-flash 默认 reasoningEffort: high，而推理 token 与正文共享同一个 maxTokens。
长文本任务（把整篇 README 翻成英文）会把预算花在推理上 → 正文要么空流、要么被
max-tokens 截断（文本看着有内容但残缺，英文版章节对不上就是这么来的）。askLlm 只累积
text-delta，推理段本来就丢弃，所以从文本侧完全看不出来。
本插件的做法：翻译类任务传 reasoningEffort: "off"，并把 finish.kind 与
usage.reasoningTokens 记进失败原因。FinishReasonMap 只有
stop / tool-calls / max-tokens / aborted / error —— 截断是 max-tokens，别猜成 length。
（实测：24 个仓里 11 个英文 README 因此静默缺失；降到 off 后剩余 5 个全部一次成功。）
另一个自激：英文 README 的新鲜度判据是 mtime(en) >= mtime(zh)，而流程是「先写英文、
再给中文补互链」—— 中文随即变新，下次 plan 又要求翻译。修法见 lib/publish.mjs
（补完互链后 utimes 刷新英文时间戳）。
自救（界面出问题时）
本插件是独立客户端插件，禁用即回官方界面：
- 在 profile 的
package.json 里从 dsh.profile.bundles 去掉 "dsh-plugin-catalog"，重启 DSH；
- 或者用插件安装面板把它停用。
它不隐藏也不改动官方插件入口：官方「插件」页仍在 sidebar.panellist 原位置，本站只是新加一项。
自检
发版 / 交接前只跑这一条（三层自检 + 17 个独立探针（498 条） + 副本同步 + 版本一致性 + git，约 60~90 秒）：
node dev/ship.mjs # 结论写进 .cache/ship-<时间戳>.md；面板头部「自检」按钮走同一条路
五项检查：
| 项 | 内容 | 红了会怎样 |
|---|
audit | 自洽契约（默认值/工具契约/样式与行为契约） | 算失败 |
render | 界面渲染（真渲染组件树后断言） | 算失败 |
hosttest | 宿主行为（假 ctx 真跑 apply() 与路由） | 算失败 |
probes | 17 个独立探针（加载路径 / 处置清单 / 删除预演 / 处置对账 / 批量打标 / 变化追踪 / 副本判据 / 配置层 / 交接单 / CSV 导出 / MCP 判据 / 单件卸载 / 留存与陈旧 / 运行期真相 / 卡片动作判据 / 开源发版就绪 / 工具中文说明，共 498 条，约 6 秒） | 算失败 |
staging | 副本同步：<ws>/.dsh/skills 与 staging 里同名 SKILL.md 有几个不一致 | 只报不拦 |
probes 这一项是 R18 补的：这几个探针以前只写在交接文件里（「有人记得就跑」），
不变式从来没进过发版体检 —— R16/R17 两轮都是靠人手动补跑才发现回归的。
现在它们由 dev/run-probes.mjs 串起来；清单本身在 dev/ship-checks.mjs（单一来源），
面板的 POST /preflight {dry:true} 报的就是它（此前硬编码四项，收进探针后 dry 仍只报四项）。
staging 这一项为什么只报不拦：它报的是这台机器的状态，不是代码缺陷 ——
中途改 Skill 时 staging 落后是常态（可能正在写、可能还没发布）。把它算失败会让这条命令
在最该用的时候变成噪音，与「git 脏只报不拦」同一条口径。它仍然值得看一眼：
R6 那次「12 个 Skill 发出去的都是旧版」就是靠人翻对话才发现的，现在交接前一条命令就能看见；
面板上同样能看见，并且能就地同步（公告条上的「同步 staging」）；同步后发现不对，
浮窗里的「还原到 <时间戳>」可以把它撤销（R20）。
它会拦下三类「发出去了但其实没上」：自检有红、package.json 版本与 client.js 的 BUILD 对不上、
（只报告不拦）工作区有未提交改动 / 本地 HEAD 与 origin/main 不一致。
分项跑：
node dev/deliver.mjs --base http://127.0.0.1:<GUI端口>
# ★ R29：**换会话/交付前的最后一条命令**。只消费 ship 与 live-check 的结论（不重算判据）；
# 判据三条：ship 全绿 / 运行中与磁盘一致 / 没有悬空项（未提交 / 未推送 / staging 旧了 / 该重启）。
# 退出码 0 = 可以换会话；报告 `.cache/deliver-<时间戳>.md`；--skip-ship 省 40 秒。
# ★ 不提交、不推送、不同步 —— 写盘动作一律由人显式发起。
node dev/audit.mjs # 自洽（697 项）：默认值冻结/工具契约/规则覆盖/去重/命名/门禁/双语 README 流程 + 客户端样式与行为契约 + staging 判据单源 + 加载态四态判据 + 探针不变式 + **处置清单（分类/分组/别名键/只生成不执行）+ 删除预演（纯函数/按目录算/revived 恒等）/ 写盘计划跳过 60 秒漂移缓存 / 变化追踪（纯函数/指纹 12 位/第一条不报新增/正文哈希与升级迁移/确认基线/时间线相邻相减与基线不产出行）/ 副本判据（正文哈希 / 同字数漏判 / 退回口径 / 备份名与路径校验 / 还原只写 staging）/ 配置层声明（块标量 / disabled 三语义 / 按 id 合并 / 条目五类 / 解析五档 / 只有 bundles 缺才算 bad / 三组计数守恒）/ 真机核验脚本（只读 / 不出现 confirm:true）/ health 时间线摘要 / 发版体检清单单源 + 运行中版本与磁盘版本**（沙箱可跑；R31 起多 22 条：探针清单单源、文档数字与真值对账（工具数/探针数/live-check 条数/交接单项数/三处「共 N 条」一致）、`dev/` 顶层探针都在登记表里、MCP 停用片段只出文本、gzip 分支与 `measure-state` 脚本还在、`/state` 字节数经 `noteTransport` 进 health；R29 起多 5 条：deliver 只消费判据不重算 / 不执行写盘动作 / 三条结论判据 / 沙箱 EPERM 与断言红分开报；R28 起多 13 条：CSV 转义是 RFC 4180 那三条 + BOM / 事实只有一份实现（Markdown 只加装饰）/ CSV 与 Markdown 同一批 picked / 工具与路由同一条链路 / pickBackupByName 按全名比对 / 写盘带同一份备份 / 两个 CSV 入口都真挂了按钮；R22.1 起多两条：浮层脚注给出缓存年龄、health 摘要带 at；R23 起多 14 条：配置层签名只解析声明 / 指纹折进快照 / 单列 composition 桶 / 单边缺不判 / 面板与导出同一措辞；R24 起多 4 条：bundleNames 去重排序 / 可点行只限 profile 与 asar / 跳转清筛选 / 交叉引用与徽标；R25 起多 5 条：签名身份表 / 明细点名到 id / 单边缺不伪造 / 面板与报告同一措辞 / 历史截断；R27 起多 14 条：对账是纯函数 / 白删三来源 / 组内声明不算失守 / presence 缺失时保守 / planPath 只限 reports 下 / 对账结论不进 state / 措辞单源 / 探针 V1–V15 与注册）
node dev/render-check.cjs # 界面（264 项，无需 DSH）
node dev/preview.mjs # 版式：生成静态预览（真实组件树 + 真实 CSS），供浏览器截图看
宿主侧（不需要重启 DSH）：
node dev/hosttest.mjs # 假 ctx 真跑 apply()：路由 / 工具契约 / 统计 / 标签 / AI 路径 / 门禁 / effect 同步约束 / async apply 返回值校验 / 列表项字段 / 体积递归与缓存 / 体积快照（含 asar 与 Skill 口径）/ 批量体积 / 依赖图四字段 / 加载态四态与 enabled 的独立性 / 导出的加载路径与「不会被加载」一节 / **发版体检路由（dry，五项）/ /skillsync 计划与 confirm 门禁 / staging 判据与单向复制 / ship 的副本同步项 / 处置清单（工具 + /uninstall 路由 + 跑完 node_modules 一个没少）+ 删除预演（整份清单必判安全 / 单删父包必报孤儿 / 未知包不瞎猜 / 路由直接回结果 / 文案写清三行风险）+ **处置对账（工具读回计划并逐目录 stat / 四态计数 / 文案四段齐 / 路由直接回结果且默认不写盘）**+ **变化追踪（快照落盘 / 指纹不重复 / 只留 20 条 / 导出报告有「变化」一节）+ 正文哈希进快照 + 确认窗口（无 confirm 被拒 / 写基线 / 清零 / health 报得出）+ 时间线进 /state（total + items）+ /health 只给时间线摘要 / 副本哈希判据 / 还原计划与 confirm 门禁 / 真还原 + pre-restore 备份 / 备份列表 + 运行中版本与磁盘版本 + **配置层（/state.composition 形状 / 三组计数守恒 / 每条带 file+line / bundles 缺口守恒 / 工具 view / health 只给摘要 / 导出「配置层」一节）** + **R35：运行期与动作层（/state.runtime 读不到时给原因 / /runtime 只读 / 动作层 journal 与 trash 位置 / 两段式 token 一次性 / Skill 删除→回收站→还原 / MCP 删除与停用真改临时文件且留 .bak / 留痕）** / 导出落盘 / 副本漂移判据 / skill_sync 计划与 confirm 门禁（宿主里 351 项；普通 node 里 345 通过 + 6 条 SKIP —— 沙箱禁止带管道 spawn + 读不到 app.asar）
node dev/live-check.mjs --base http://127.0.0.1:<GUI端口> # 对**运行中的面板**只读核验（≈0.7 秒，21 条）：
# 版本一致 / 工具与目录在 / 时间线形状 / drift 带哈希与备份 / 还原计划只读 / 不带 confirm 的还原被拒
# ★ 端口每次重启都会变；走 host_selfcheck 跑（args 传 --base），不写任何文件
node dev/probe-loadstate.mjs # 独立重算加载路径：自己扫 profile + 两份组合文件 → 四态 → 与 cache/catalog.json 对账；
# 七条不变式（计数守恒 / bundle 口径 / via 指得回入口 / dormant 与入口无交集 /
# disabled 不算入口 / 快照与重算一致 / dormant 对加载中的声明封闭），破一条退出码 1；--json 可机读
node dev/probe-uninstall.mjs # 处置清单自检：四条不变式（I8 覆盖与不重叠 / I9 体积口径 / I10 钉住键安全 /
# I11 不误伤加载路径），破一条退出码 1；--json 可机读
node dev/run-probes.mjs # **17 个探针串成一条**（发版体检的第 5 项，共 498 条，约 6 秒）：
node dev/probe-runtime.mjs # ★ R35：运行期真相（31 条）。fiberPhase 六相位 / moduleName 带子路径按包名归一 /
# 同包多条取 failed 优先 / 读不到一律 unknown（绝不猜 active）/ declared-absent 只在
# "声明会加载"时成立 / 三类问题分开数 / 摘要读不到要如实说。纯函数不碰盘、不碰宿主
node dev/probe-actions.mjs # ★ R35：卡片动作判据（44 条）。YAML 条目块切分（顶层 + insert 块 + 行号提示失效）/
# 删后校验（目标少一条、别的不少、总数只少 1）/ 停用幂等 / Skill 三阻断（随插件安装 /
# 没目录 / 不在已知根）/ 路径前缀不误判兄弟目录 / MCP bundle 层阻断 / 已关掉不重复写
node dev/probe-release.mjs # ★ R36：开源发版就绪（28 条）。版本↔BUILD / 包元数据（repository·keywords·engines·files）/
# 双语 README（GitHub 安装·卸载·开源说明·工具表逐个点名·探针数）/
# 密钥与文件名扫描（工作树、不 spawn git、只给掩码）/ 交付代码不写死本机绝对路径
node dev/runtime-live.mjs --base http://127.0.0.1:<GUI端口>
# ★ R36：**运行期真相的真机取证**（只读）。打 `GET /plugin-catalog/runtime`：
# Loader 计数 / 三类问题 / bundle 健康（missing·error·可选未装）。
# `--expect-clean` 有任何问题退出码 1；`--json` 给脚本读
node dev/actions-live.mjs --base http://127.0.0.1:<GUI端口>
# ★ R36：**卡片动作的真机闸门核验**（只出计划、绝不执行）。四件事：
# 未知 id → unknown-entry / apply 不带 confirm → 400 / 回收站可读 /
# 对一条 Skill 出删除计划（含回收站与 token），再拿真 token 发一次不带 confirm
# 的 apply 仍 400。★ 计划 5 分钟后自动过期，脚本不执行它
node dev/probe-retention.mjs # ★ R34：留存与陈旧（19 条）。快照「旧在哪」拆成 factStale（profile 变了 ⇒ 结论可能已错、
# 值得重建）与 ageStale（只是旧 ⇒ 结论仍有效）；每周任务全失败不许伪装成跑过（0 仓 ≠ 全失败）；
# reports/ 保留策略（只动自己五种前缀 / md+json 同组 / 留最新 N 组 / 脏输入不抛）。纯函数不碰盘
# 兼容两种收尾格式（`passed N / failed M` 与「N 条不变式全部成立」）；
# 沙箱里 spawn 被拒时会明说「要在宿主里跑」，不会误判成探针坏了
node dev/inspect.mjs --base http://127.0.0.1:<GUI端口> --name dsh-diag
# ★ R33：**装完核对的人工入口**（只读）。直接打 `GET /plugin-catalog/inspect?name=`，
# 回答「这个包在目录眼里会不会被加载」：loaded / installed-not-loaded / not-installed /
# host-owned / self。--name 可逗号多个；--expect loaded 可当断言用。
# ★ 走 node:http 而不是 fetch（undici keep-alive 在 process.exit 会撞 libuv 断言；
# 本机还有 undici 流断开打死宿主的先例）。
node dev/measure-layers.mjs # ★ R33：**组合层取证**（只读）。宿主每次换组合模型时先跑它：
# 层清单（role / source profile|asar / 条目数）、模型（flat / bundle-layers / empty）、
# 合并口径（解析 → 生效）、以及**旧判据（只读 profile 两份文件）会读到多少**的对照。
# rc.3 实测：43 层（纯 node）→ 54 条 vs 旧判据 24 条（差 125%）；宿主里是 51 层 → 232 条。
# 退出码：0 = 层齐全或有如实原因（asar 在纯 node 读不到属正常）；1 = 明显读少了。
node dev/measure-storage.mjs # ★ R33：**留存现状取证**（只读）。数据目录 7 份状态文件的体积/条数 +
# 两份预算判定：`history.json`（240 KB）与 `cache/catalog.json`（2 MB）。
# 实测：history.json **988 KB / 20 条 / 条均 49 KB → 超预算 4.1 倍**，
# 原因是每条快照都存全量 decls → 处置写在输出里（紧凑编码或按字节裁剪）。
node dev/probe-removal.mjs # 单件卸载自检（R32/R33）：66 条（声明形态 npm/link/file/git / 自己·宿主自带·不属于 profile
# 三条阻断 / 加载态与依赖者只算警告 / 回执翻人话且 unknown-plugin 不算失败 /
# 「宿主回 applied 但依赖行还在」必须判失败 / 计划过期与 token 一次性 / 留痕 50 条封顶），
# 全程用假宿主，**不真卸载**
node dev/ship-checks.mjs # 发版体检的**清单单一来源**：ship 真跑它、面板 POST /preflight{dry} 报它
# （此前两处各写一份 → 收进探针后 dry 仍只报四项，hosttest 抓到过）
node dev/probe-simulate.mjs # 删除预演自检：14 条（空删除不改态 / dormant 判安全 / transitive 会点名 /
# bundles 与配置入口指空 / dangling / 掉回 dormant / 摘边不能点亮谁 /
# 未知包与去重 / 包数守恒 / 同名两份目录只删一份不算删掉），破一条退出码 1
node dev/probe-csv.mjs # CSV 导出自检（R28）：20 条（逗号 / 双引号双写 / 换行 / 前后空格都加引号 /
# null 与 0 是两件事 / 默认带 BOM / CRLF / 空输入只出表头 / 自定义列里未知 key 变空 /
# 事实层不带 Markdown 装饰 / 0 次调用写「—」而 0/40 报错写 0% / asar 内与没量过分开 /
# 一行成品的列数与表头一致），破一条退出码 1
node dev/probe-verify.mjs # 处置对账自检：15 条（空计划不叫干净 / 全在盘上报 intact 且不虚报已回收 /
# 已删但被 profile 钉住 / 还在 bundles / 未关掉的配置条目 / 组外仍有包声明它 → 白删 /
# 今天才被加载或组外才声明 → 计划过期 / 组内声明不算失守 / 字节账不重叠且链接恒 0 /
# presence 缺失时保守 / 重复目录只算一次 / 计划龄 / 结论优先级 / 边界四条），破一条退出码 1
node dev/probe-history.mjs # 变化追踪自检：32 条（指纹稳定且与顺序无关 / 新增消失能倒过来 / 版本与来源变 /
# 同一条多处变化 total 去重 / Skill 描述有无 / 正文哈希（改一字就变 + 升级迁移不算编辑）/
# 裁剪留最近 N / 坏历史当空 / 第一条快照 0 处变化 / 确认基线 normalizeAck /
# 时间线（基线不产出行 / 相邻相减 / 新的在前 / cap / 同指纹跳过）），破一条退出码 1
node dev/probe-staging.mjs # 副本判据与还原自检：16 条（正文哈希稳定 / 同字数改一字必须 differs / 哈希优先于 mtime /
# 读不到哈希退回 size+mtime / 备份名排序与 latest / 还原 + pre-restore 备份 / 一致时 skipped /
# 路径穿越与非备份名被拒 / 端到端同字数漏判），破一条退出码 1
node dev/probe-composition.mjs # 配置层（声明）自检：36 条（顶层条目与块标量 / disabled 三语义 / 按 id 合并 /
# 条目五类与包名去子路径 / 解析五档 / bundles 缺口 / 计数守恒 / 严重度 /
# asar 读不到只算 unjudged / 摘要与紧凑视图 / 导出文案），纯函数、不读 profile
node dev/probe-gitops.mjs # 在临时仓真跑 init/commit/push 失败/ignore（23 项，不碰真实仓、不联网）
node dev/probe-asar.mjs # 官方插件能不能从 app.asar 读出来（Electron 的 asar 是"目录"）
node dev/measure-attrib.mjs # 用真实工具 schema 量归属覆盖率
node dev/probe-publish.mjs # 只读预演上传计划（不建仓、不提交、不推送）
node dev/probe-export.mjs # 用真实数据导出一份 Markdown 快照到 reports/
node dev/probe-init.mjs # 量启动成本（init/state/entryDetail 的毫秒数）
node dev/measure-state.mjs --base http://127.0.0.1:<端口> # 量 `/state` 的**线上**字节（R31：357 KB → 85 KB，≈4.2×；
# 判据三条：都 200 / 真回了 content-encoding: gzip / ≤ 原始 60%。必须用 node:http，
# fetch 会自动解压 —— 那样量到的永远是解压后的长度）
node dev/warm-cache.mjs # 预热真实数据目录，让第一次打开就有数据
node dev/rm.mjs # 救火：删工作区里的文件/目录（工具沙箱不让 unlink；经 host_selfcheck 执行）
node dev/ship.mjs # 发版体检（上面那条）；--json 供面板 /preflight 调用
★ dev/ship.mjs 在普通 node 里跑时，hosttest 的 asar 断言会标 SKIP（读不到 app.asar），
所以数字比面板点「自检」少一条；两者都如实打出来，不静默。
「在链」与「旧一代」两类探针（R31 起明确区分）：上面这一串是发版体检链上的 15 个
（清单只有一份：dev/probe-list.mjs 的 PROBES）；dev/ 里另有一批 R1–R9 的探索脚本
（probe-asar / probe-export / probe-gitops / probe-init / probe-publish / probe-catalog /
probe-dupe / probe-multifile / probe-stats），它们不在链上、多数只是打印而非断言，
其中两条在沙箱里天然是红的（probe-asar 读不到 asar → mode none；probe-gitops 的 git 子进程
→ spawn EPERM）。它们登记在 dev/probe-list.mjs 的 LEGACY_PROBES 里，各自写了"被谁接管"；
audit 会核对 dev/ 顶层的每个 probe-*.mjs 都在这两张表之一 —— 新写的探针忘了挂链，红的是 audit。
dev/preview.mjs 为什么存在：无头自检只能验结构/文案，验不了版式（浮窗是否居中、
卡片网格会不会被挤成一列、窄卡片里徽章是否溢出）。它把组件树序列化成 HTML 并注入同一份 CSS，
用任意静态服务器打开即可截图；本机实测用它抓到过「纯文本里漏出 markdown 星号」这种只在渲染后可见的问题。
dev/probe-gitops.mjs 为什么存在：上传是最难在沙箱里验的一段（子进程 spawn 被禁），
而真实仓不能拿来试 —— 所以在临时仓里真跑一遍，涵盖「还没第一次提交的新仓」这种边界。
开源版说明（R35 收口）
这个仓库按"别人 clone 下来能装、能跑、能自检"的标准整理过：
- 许可证：MIT（见
LICENSE）。可商用、可修改、可再分发，保留版权与许可声明即可。
- 不联网、不上传：除你自己点的「上传备份到 GitHub」「缺口分析」「安全审核」「AI 分类 / 生成简介」这些显式动作外，
插件只读本机。统计数据只含会话 ID / 昵称 / 时间 / 工具名 / 计数，没有任何对话文本。
- 没有内置密钥：AI 走宿主
llm 服务；上传走本机 gh / SSH 凭据。仓库里没有 token（dev/ghbackup-scan 那类夹具用了假密钥）。
- 代码结构：
index.js（宿主入口 / 路由 / 工具注册）· lib/（判据层，多数是纯函数）· client.js（面板）·
dev/（自检与探针）。判据与执行分开是刻意的：能在合成数据上钉死的，就不靠"在真机上试一下"。
- 自检：宿主里跑
node dev/ship.mjs（一条命令）；换手前跑 node dev/deliver.mjs --base <GUI端口>。
面板头部「自检」按钮走同一条路。
- 开源前自查：
node dev/probe-release.mjs（版本↔BUILD / 包元数据 / 双语文档 / 工具表 / 密钥与绝对路径扫描，28 条）；
真机侧两条只读入口 dev/runtime-live.mjs（Loader 对账，--expect-clean 可当断言）与
dev/actions-live.mjs（动作闸门，只出计划不执行）。
- 贡献：提 PR 前请跑
node dev/audit.mjs、node dev/render-check.cjs、node dev/hosttest.mjs、
node dev/run-probes.mjs。新增判据请配一个纯函数探针（写法见 dev/probe-actions.mjs / dev/probe-runtime.mjs）；
动写盘路径的，必须同时覆盖"写前备份 / 写后校验 / 校验失败回滚"。
- 不要在这里加安装逻辑：「装」归
dsh-plugin-installer / plugin_manager，关系是"它装、我核"。
许可证
MIT。
