dsh-web-plugin-explain

Readme

# dsh-web-plugin-explain

Web 设置 → 插件 里的"插件列表"标签页增强：每个插件卡片展开后显示**插件包自身 `package.json` 的 `description` 原文**，第三方插件在名字后面带一个小标签，搜索框支持**按描述搜索**。

## 它做什么

![功能](image.png)

- **统一描述来源**：内置插件与第三方插件一视同仁，展开卡片都只显示该插件模块 `package.json` 的 `description` 原文（解析不到时显示 `—`）。
- **第三方标签**：不属于 DeepSeek / Cordis 的插件（模块名不以 `@deepseek-ai/`、`cordis:` 开头）在卡片名字后面显示「第三方」小标签；`@deepseek-ai/*` 与 `cordis:*` 内置行即使字典未覆盖也绝不误标。
- **按描述搜索**：搜索框匹配 **id、模块名、描述**（第三方行还匹配「第三方」标签文本）。
- **尽力而为**：描述解析失败（如 Remote 不可用）只影响描述行，插件列表本身始终正常渲染。

## 安装（一行搞定）

插件已发布到 npm，无需克隆仓库或本地构建：

```sh
dsh plugin --profile web add dsh-web-plugin-explain
```

装完**重启 `dsh web`**（typert-loader 会在启动时注册本插件的 strict 端点），打开 设置 → 插件 → 「插件列表」，展开任意插件卡片即可看到描述。

`dsh plugin add` 会自动识别包里的 `dsh.bundle` 声明，把它追加为 web profile 的一层；`zod` 与 `@deepseek-ai/dsh-client-*` 等依赖由 pnpm 自动安装。

## 从源码安装（开发 / 改代码时）

```sh
git clone https://github.com/2710165659/dsh-web-plugin-explain.git
cd dsh-web-plugin-explain
npm install
npm run build          # 构建 lib/（index.js + client.js + typert.host.js）

dsh plugin --profile web add ./dsh-web-plugin-explain
```

同样重启 `dsh web` 生效。

## 卸载

```sh
dsh plugin --profile web remove dsh-web-plugin-explain
```

重启 `dsh web` 后恢复内置的插件列表。

## License

[MIT](LICENSE)