dsh-plugin-live-catalog

Readme

# dsh-plugin-live-catalog

DSH Web 设置中的只读插件目录。每次打开目录时读取当前 Loader 和插件包元数据，按“来源 → 模块类别”分组。

> 本插件的 UI 改编自 DeepSeek Harness 官方插件列表，分类映射参考其包元数据；上游归属与许可证见 [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md)。

## 特点

- 插件清单实时读取，不生成或维护静态插件分类数据文件；九类结构固定，由一处配置维护。
- 插件启停状态每次读取；包描述和类别按 `package.json` 修改时间缓存，文件未变化时不重复读取，修改后下次打开自动更新。
- 来源分为“官方内置 / 我的插件 / 未知”。
- 模块类别分为“核心与启动、会话、模型与凭证、执行环境、智能体能力、交互与权限、宿主与传输、浏览器 UI、工作区”。
- 每类默认展示四个插件，其余可展开。
- 支持搜索、筛选、启停统计、类别数量和卡片详情。
- 零依赖，不修改 DeepSeek Harness 源码。

## 效果图

改造后：
<img width="1495" height="991" alt="DSH_插件目录_UI改造后_分类折叠" src="https://github.com/user-attachments/assets/2ce75baa-be03-4043-a98b-bb1f46090b4d" />

改造前：
<img width="1312" height="991" alt="DSH_插件目录_UI改造前" src="https://github.com/user-attachments/assets/4dcef725-42a5-43e2-9ca0-90bb1cb8c781" />


## 本机访问限制

插件元数据接口仅供本机使用，只接受来自 127.0.0.1 的连接，其他来源将返回 403。

## 来源规则

| 来源 | 规则 |
|---|---|
| 官方内置 | 模块名以 `@deepseek-ai/` 或 `cordis:` 开头 |
| 我的插件 | 包名符合 `dsh-plugin-*` 或 `@scope/dsh-plugin-*` |
| 未知 | 其他模块 |

来源由运行时模块名判断。官方插件再按 package.json 的 repository.directory 映射到九类，个人插件读取 dsh.category；无法判断时进入“未分类”。

## 修改分类

分类统一配置在 `lib/categories.js`。数组顺序就是界面顺序；`key` 是分类标识，`zh` 和 `en` 是中英文名称，`directories` 是官方仓库目录到分类的映射。修改这里后，服务端归类和前端显示会同时更新。

个人插件的 `package.json` 中，`dsh.category` 应填写对应分类的 `key`。新增或修改分类后请重启 DSH Web；“未分类”是系统兜底项，不属于固定九类。

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

## 安装

```bash
# 从 GitHub 安装
dsh plugin --profile web add github:vivi77-max/dsh-plugin-live-catalog

```

安装后启动或重启 DSH Web，进入“设置 → Plugins → 插件目录”。本插件会替换内置“插件列表”页签，但保留“插件配置”。

## 卸载

```bash
dsh plugin --profile web remove dsh-plugin-live-catalog
```

这是非官方社区插件，与 DeepSeek 不存在隶属或背书关系。