dsh-plugin-subitem-status

给 DeepSeek Harness 的插件页（侧栏「插件」，不是设置页）加上子项状态显示： 每张插件卡片上直接标出这个包里有哪些组件没启用、哪些异常，不用点进详情页才发现。

解决什么问题

插件页的卡片只反映 bundle 级的开关。包开着，但里面某个组件其实没跑起来—— 卡片上完全看不出来，必须点进详情页看「包含的组件」那一行才发现。

这个插件把那行状态（● 运行中 / ● 已关闭 / ● 未运行 / ● 异常）原样搬到卡片上：

┌──────────────────────────────────────────────┐
│  ▣  some-plugin-kit                          │
│     一组示例插件                              │
│     主组件   ● 运行中   附属组件  ● 已关闭     │  ← 新增
└──────────────────────────────────────────────┘

• 文案与状态点直接取自官方字典命名空间，与详情页一字不差；官方改措辞这里跟着变。
• 一个包里多个组件就逐条列出，不会只显示第一个。
• 每个组件显示一条状态（包括正常运行），没有组件时不占位。

设置页包名提示

设置中的配置页面导航及「插件」内部选项卡，标题下方显示淡色的提供者 npm 包名。 长包名省略显示，鼠标悬停可查看完整名字。

• 从 Slot 注册来源和实际加载的模块清单核对包名，不用中文标题推测。
• 6.0.1 中大量来源被压缩为 mf；对此使用已逐条核对注册源码的 ID→包名兜底表， 且仍要求包名出现在当前模块清单中。表内覆盖 21 个设置页面、5 个内部选项卡。 未收录的新页面显示「包名未声明」；其他插件覆盖同一 ID 时，此兜底信息可能不再准确。
• 来源未声明或无法确定时，显示「包名未声明」，不输出本机路径。
• 这是排障用的诊断信息，不是提供者身份的安全认证。
• 不读取配置值、聊天记录、账户凭据，不向外部服务发送数据。

把准确包名告诉 AI，减少 token 消耗

用途不只是方便查看：让 AI 修改或排查插件时，可以直接告诉它 npm 包名， 避免 AI 从中文显示名称开始逐个搜索、读源码猜来源，减少定位过程中的 token 消耗。

1. 打开设置，找到需要修改的插件配置选项卡，查看标题下面的包名小字。

2. 需要复制完整名称时，在浏览器中右键小字选择 「检查」，或按 F12 打开开发者工具， 用元素选择器选中这行小字。在 Elements（元素）面板读取或复制该元素的文本； title 属性也包含完整包名，长名称不会因为界面省略显示而丢失。

3. 把完整包名与具体需求一起告诉 AI，例如：

   请检查 dsh-feature-toggles，设置里「余额」页面显示异常。先定位这个包，再排查问题。

不需要调试工具时，也可以直接看小字或悬停查看完整名称。若显示「包名未声明」， 不要把它当作真实包名提供给 AI；应进一步核实来源。

安装

dsh plugin add github:lingmingxi/dsh-plugin-subitem-status --profile <你的 profile>

或用 tarball / 本地路径：

npm pack
dsh plugin add ./dsh-plugin-subitem-status-1.1.0.tgz --profile <你的 profile>

装完重启 DSH（客户端插件生效需要重启，除非 profile 启用了 client-hmr）。

设计要点

纯客户端 DOM 增强，不覆盖 DSH 内核。

插件页的卡片是内核 @deepseek-ai/dsh-client-ui-plugin-manager 里硬编码的 PackageCard， 没有任何卡片级 slot 可用（可用的只有 plugins.item 新增卡片、以及详情页的 plugins.detail.badge/.actions/.section）。所以「在父级卡片上显示子项状态」只能走 DOM 增强：观察已渲染的卡片，往里补一行。

• 数据源与官方插件页同源：remote.pluginManager.listBundles() + listPlugins()。
• 卡片定位只用稳定属性 [data-plugin-package] / [data-plugin-panel]； 类名是 CSS-module 哈希，绝不硬编码。
• 被 React 重渲染抹掉时，由 MutationObserver 自动重放（自身写入的回调会跳过，避免死循环）。
• 卸载时清干净：样式、承载行、observer、订阅、定时器。

关于 inject: []（重要）

本插件的客户端 factory 声明 inject: []，所有服务一律用 ctx.get() 惰性读取。

这不是偷懒，是必须的。cordis 的 ctx 是注入代理：读一个没写进 inject 的属性会直接抛 cannot get property "..." without inject。而 DSH Web 的启动门禁要求每个 entry 的 fiber 都 active， 任何一个不合格就整页打不开（web boot: N entry did not activate）。

两种写法的实测结果：

inject 声明	服务齐全	命名空间缺失	remote 缺失
['remote','locale'] 且直接读 ctx.remote.pluginManager	failed	failed	failed
['remote','locale','remote.pluginManager']	active	pending（照样卡死）	pending
[] + 全部走 ctx.get()	active	active	active

把命名空间写进 inject 看似正确，但该服务尚未挂载时 fiber 会变 pending，同样卡死启动。 只有 ctx.get() 在所有环境下都安全（官方插件页自己也用 this.ctx.get("productAnalytics")?.）。

测试

npm test

五个套件：

文件	覆盖内容
tests/smoke.mjs	纯逻辑：状态合成 vs 官方映射、多组件、文案兜底、注册形态
tests/dom.mjs	DOM 粘合：单/多组件渲染、挂载位置、重渲染重放、实时更新、卸载清理
tests/boot-gate.mjs	启动门禁：用真实 cordis 在 5 种服务组合下断言 fiber 必须 active
tests/lifecycle.mjs	同步异常、迟到响应、卸载后的回调隔离
tests/settings.mjs	包名来源、未知/路径过滤、设置导航与内部 tab 对齐、重放与清理

boot-gate.mjs 需要 @deepseek-ai/cordis。可用 DSH_CORDIS_PATH 指向你自己的 cordis/lib/index.js（支持绝对路径和 file: URL）；找不到或加载失败则测试失败，避免假绿灯。 tests/lifecycle.mjs 另外验证同步异常及卸载后迟到响应不会继续运行。

为什么需要 boot-gate：这类 bug 用普通对象桩测不出来——桩里的 ctx.remote 是普通对象， 读 .pluginManager 不会报错，而真实 ctx 是注入代理。本插件第一版就是这么炸的， 所以补了这个用真实 cordis 的回归测试。

兼容性

• 平台：Web（dsh.client.platform: "web"）
• 无第三方运行时依赖，不 require 任何 Harness Client 包
• 只使用 --dsw-alias-* 主题 token，跟随明暗主题

许可

MIT