前言¶

DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。随着插件数量增多，在 Web 界面中查看插件状态、分类和元数据变得繁琐。传统的插件列表往往依赖静态数据文件，更新滞后且维护成本高。

下面介绍 dsh-plugin-live-catalog。这是一个只读插件目录插件，它直接读取当前 Loader 和插件包的元数据，在 DSH Web 设置中按来源和模块类别进行分组展示。

插件定位¶

该插件由 vivi77-max 维护，类别为客户端。它不修改 DeepSeek Harness 源码，零依赖，旨在提供实时的插件清单视图，替代或增强原有的静态列表功能。

实时读取与缓存：插件清单实时读取，不生成静态插件分类数据文件。插件启停状态每次读取；包描述和类别按 package.json 修改时间缓存，文件未变化时不重复读取，修改后下次打开自动更新。
来源分类：将插件来源分为三类：
- 官方内置：模块名以 @deepseek-ai/ 或 cordis: 开头。
- 我的插件：包名符合 dsh-plugin-* 或 @scope/dsh-plugin-*。
- 未知：其他模块。
模块类别：将插件按九个固定类别分组：
- 核心与启动、会话、模型与凭证、执行环境、智能体能力、交互与权限、宿主与传输、浏览器 UI、工作区。
界面交互：每类默认展示四个插件，其余可展开。支持搜索、筛选、启停统计、类别数量展示及卡片详情。

使用官方 CLI 安装：

dsh plugin --profile web add github:vivi77-max/dsh-plugin-live-catalog

安装完成后，启动或重启 DSH Web。进入「设置 → Plugins → 插件目录」，该插件会替换内置的「插件列表」页签，但保留「插件配置」功能。

分类的顺序和映射统一配置在 lib/categories.js 中。数组顺序即为界面顺序。修改该文件后，服务端归类和前端显示会同时更新。

在个人插件的 package.json 中，使用 dsh.category 字段指定分类。该字段的值应与 lib/categories.js 中的 key 对应。

目录仅展示 Loader 中的配置条目。若要保留旧插件但不运行，应在 Profile Patch 中插入该插件配置并设为 disabled: true，不要删除其配置条目。

DSH 社区目录与 DeepSeek / 幻方无官方从属关系，本插件同样属于社区项目。