前言¶
在 DeepSeek Harness（DSH）里，插件往往通过 dshmarket 或官方插件管理器安装，数量一多，版本、启停状态和设置入口就容易分散在各处。市场负责下载与更新，但「装完以后怎么看、怎么记、怎么查问题」并没有统一界面。下面介绍维护者 LTao96 的客户端插件 dsh-plugin-overview：它不做安装与卸载，只针对当前 profile 里已经存在的依赖，提供列表、备注、分组、健康诊断、启停和设置跳转，并与插件市场搭配使用。
这是什么¶
dsh-plugin-overview 是面向 DSH 已安装插件 的本地总览页。源码与说明见 GitHub，npm 包名为 dsh-plugin-overview（当前资料中版本 0.2.1，MIT 许可）。社区目录页：SkillHub - LTao96/dsh-plugin-overview。
它和插件市场是分工关系：下载、升级、卸载交给 dshmarket 或 Host 插件管理器；整理、查看、诊断交给「插件总览」。DSH 生态强调「一切皆插件」；SkillHub 等社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
入口与数据存放¶
安装并重启 DSH 后，在 设置 → 插件总览 打开（设置项 order 为 130）。
备注、分组及分组顺序保存在：
$DSH_HOME/plugin-overview/state.json
首次启动会尝试从旧路径导入：
$DSH_HOME/plugin-control-center/state.json$DSH_HOME/plugin-dashboard/state.json
核心功能¶
列表与排序¶
列出当前 profile 的已安装依赖，按总览自身的分组顺序和名称排序。状态与版本来自 Host 的 pluginManager 服务；安装时间取包目录创建时间，软链接安装会标记 ≈（pnpm 重装或迁移可能刷新该时间，属近似值）。
备注与 AI 总结¶
详情面板可直接编辑备注。手动备注（source: manual）不会被 AI 覆盖。
安装或更新时的自动 AI 总结默认关闭。需在标题栏勾选「安装时 AI 总结」，Host 才会在新版本出现时向当前默认模型请求一次 {summary, group}；模型失败时回退到包描述，不阻塞安装。「AI 重新总结」可随时手动触发。
分组¶
详情面板可新建分组并移动插件。「分组管理」支持新建、重命名、删除；删除分组时组内插件移到「未分组」，并标记为手动分组，之后 AI 不会自动挪动。
详情与启停¶
点击任意一行打开详情：版本、来源、安装时间、Loader 行、备注、启停、打开设置，以及（匹配到主面板时）打开主面板。
状态单元格通过 pluginManager.setBundleEnabled 启停整个 bundle；无 bundle 行时回退到 setPluginEnabled。
健康诊断¶
「健康诊断」是只读的第一层静态检查，例如：
- 运行状态为 failed
- 已启用但没有 active 的 Loader 行
- 已安装但不在
dsh.profile.bundles中 - 多个皮肤/背景/视觉类插件同时启用（按包名、描述和 keywords 识别）
- 设置入口指向
settings.section台账中不存在的页面
只报告问题并打开详情，不会自动修复或卸载。
设置与主面板入口¶
「打开」在设置导航内部点击匹配项，避免误点其它同名按钮；找不到时复制提示路径（DSH 目前没有公开的设置深链接 API）。
可选「收纳第三方设置项」：读取实时的 settings.section 槽位台账（ctx.slots.entries + ctx.slots.subscribe），列出第三方设置页，可逐项收纳或放出；切换设置页后控制器仍生效，当前打开页即使被收纳也保持可见；关闭开关或插件销毁时恢复。
插件搜索索引 settings.label、settings.navLabel、settings.sectionId 和设置提示。
主面板入口匹配实时的 sidebar.panellist 台账；少量已知面板通过 PANEL_IDS 兜底。「主侧栏顺序」用 CSS order 调整直连面板按钮，顺序保存在 localStorage。
安装与启用¶
Host 要求（来自 package.json）：Node >=20，DSH >=0.2.1-rc.1 <0.3.0-0。
官方安装命令：
dsh plugin --profile <profile> add dsh-plugin-overview
npm 页面：https://www.npmjs.com/package/dsh-plugin-overview
安装后重启 DSH，再在 设置 → 插件总览 使用。
典型用法¶
- 安装并重启后打开「插件总览」，浏览当前 profile 全部已装插件。
- 对常用插件写手动备注或建分组；需要时在标题栏开启「安装时 AI 总结」，或单行使用「AI 重新总结」。
- 运行「健康诊断」，按提示打开有问题的插件详情。
- 在列表中直接启停 bundle，或通过「打开」进入对应设置页；若设置项过多，可开启「收纳第三方设置项」只保留需要的入口。
- 需要调整侧栏直连面板顺序时，使用「主侧栏顺序」控件（依赖
sidebar.panellist实时标签；匹配不到时控件隐藏）。
开发验证时，README 建议用临时 DSH_HOME，避免污染真实 profile：
DSH_HOME=/tmp/dsh-smoke dsh plugin --profile smoke add <插件目录绝对路径>
DSH_HOME=/tmp/dsh-smoke dsh --profile smoke --dump-config
适用场景与注意¶
适合已经通过市场或管理器装了不少 DSH 插件、希望在一个页面里备注、分组、查健康状态并跳转设置/主面板的用户。它不是插件市场，也不负责安装、升级或卸载。
插件在 DSH 进程权限下运行；安装前请自行查看 源码仓库 与 MIT 许可证，确认符合你的环境与安全要求。收纳设置项、AI 总结等能力会读取 Host 提供的台账与模型；行为以 README 与当前 Host 版本为准。
结尾¶
dsh-plugin-overview 把「装完之后」的插件管理收敛到设置里的一个总览页：与市场分工明确，侧重本地状态、备注分组、只读诊断和启停入口。需要进一步了解时可查阅目录页 SkillHub 与 GitHub 仓库。
