dsh-plugin-panel 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；基本兼容但装前注意：未发布到 npm registry，仅可从源码安装

dsh-plugin-panel 兼容性怎么样？

基本兼容但装前注意：未发布到 npm registry，仅可从源码安装

dsh-plugin-panel 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-plugin-panel 还在维护吗？

GitHub 2 星。最近一次上游提交在 2026/10/26。

插件面板 Dylan37670/dsh-plugin-panel

DeepSeek 客户端

Dylan376708 天前有提交已提供中文文档扫描：含敏感能力兼容 / 相关生态

在 GitHub 查看 ↗

插件面板 v6.16插件面板

31.5/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/10/26 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

相关生态插件（非 dsh 原生，按其对应运行时安装）

git clone https://github.com/Dylan37670/dsh-plugin-panel.git

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：已验证

是什么

生态插件

可安装，未声明 dsh 能力

装得上吗

本站已在 dsh 0.2.1-rc.5 下真实安装成功

非静态推断

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

活跃：最近一次提交在 8 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安装兼容性检查⚠ 装前注意

未发布到 npm registry，仅可从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✗npm 包@dsh-community/plugin-panel（未发布到 npm，仅可源码安装）

✓Node 引擎未声明 engines.node

✓dsh CLI 依赖未声明 dsh 版本约束

✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/11 06:57:40

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件读取剪贴板或密钥环境变量发起外部网络请求

查看扫描证据（共 82 处，展示前 82 条）

发起网络请求
lib/client.js:377
return fetch("/api/plugin-panel" + path, init).then(function (res) {
读取密钥环境变量
lib/catalog.js:202
const githubToken = process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN;
发起网络请求
lib/catalog.js:254
const response = await fetch(url, { signal, headers: GITHUB_SEARCH_HEADERS });
发起网络请求
lib/catalog.js:258
const retry = await fetch(url, { signal, headers: GITHUB_SEARCH_HEADERS });
发起网络请求
lib/catalog.js:276
const response = await fetch(bucketSearchUrl({ start: '2000-01-01', end: '2099-12-31' }, page), {
读取本地文件
lib/catalog.js:449
const raw = await readFile(this.bundledCuratedPath(), 'utf8');
读取本地文件
lib/catalog.js:476
const raw = await readFile(this.bundledAllPath(), 'utf8');
读取本地文件
lib/catalog.js:505
const raw = await readFile(this.cacheFile(lens), 'utf8');
写入本地文件
lib/catalog.js:525
await mkdir(this.dir, { recursive: true });
写入本地文件
lib/catalog.js:528
await writeFile(tmp, JSON.stringify(snapshot, null, 2), 'utf8');
写入本地文件
lib/catalog.js:529
await rename(tmp, file);
读取本地文件
lib/catalog.js:534
const info = await stat(this.cacheFile(lens));
发起网络请求
lib/catalog.js:601
const response = await fetch(configuredUrl, { signal, headers: { 'User-Agent': 'dsh-plugin-panel' } });
发起网络请求
lib/catalog.js:635
const response = await fetch(url, { signal, headers });
发起网络请求
lib/catalog.js:695
const response = await fetch(url, { signal, headers: { 'User-Agent': 'dsh-plugin-panel' } });
读取本地文件
lib/state.js:17
const raw = await readFile(this.file, 'utf8');
写入本地文件
lib/state.js:48
await mkdir(dirname(this.file), { recursive: true });
写入本地文件
lib/state.js:50
await writeFile(tmp, JSON.stringify(this.current, null, 2), { encoding: 'utf8', mode: 0o600 });
写入本地文件
lib/state.js:51
await rename(tmp, this.file);
写入本地文件
lib/state.js:53
await chmod(this.file, 0o600);
执行外部命令来自配置/变量
lib/lifecycle.js:35
const child = spawn(file, args, { cwd, shell: false, windowsHide: true, env: safeEnv() });
读取本地文件
lib/translate.js:113
const parsed = JSON.parse(await readFile(this.file, 'utf8'));
写入本地文件
lib/translate.js:132
await mkdir(dirname(this.file), { recursive: true });
写入本地文件
lib/translate.js:134
await writeFile(tmp, JSON.stringify(this.cache), 'utf8');
写入本地文件
lib/translate.js:135
await rename(tmp, this.file);
发起网络请求
lib/embeddings.js:45
const response = await fetch(embeddingEndpoint(config.baseUrl), {
读取本地文件
lib/embeddings.js:119
const parsed = JSON.parse(await readFile(this.file, 'utf8'));
写入本地文件
lib/embeddings.js:131
await mkdir(join(this.file, '..'), { recursive: true });
写入本地文件
lib/embeddings.js:133
await writeFile(tmp, JSON.stringify(index), 'utf8');
写入本地文件
lib/embeddings.js:134
await rename(tmp, this.file);
读取本地文件
lib/operations.js:39
const parsed = JSON.parse(await readFile(this.file, 'utf8'));
写入本地文件
lib/operations.js:71
await mkdir(dirname(this.file), { recursive: true });
写入本地文件
lib/operations.js:73
await writeFile(tmp, JSON.stringify(this.current, null, 2), { encoding: 'utf8', mode: 0o600 });
写入本地文件
lib/operations.js:74
await rename(tmp, this.file);
写入本地文件
lib/operations.js:76
await chmod(this.file, 0o600);
读取本地文件
lib/installed.js:18
text = await readFile(join(dshHome, 'profiles', profile, 'cordis.patch.yml'), 'utf8');
读取本地文件
lib/installed.js:55
return JSON.parse(await readFile(join(dshHome, 'profiles', profile, 'package.json'), 'utf8'));
读取本地文件
lib/installed.js:103
for (const name of await readdir(skillRoot, { withFileTypes: true })) {
读取本地文件
lib/installed.js:108
await access(skillFile);
读取本地文件
lib/self-update.js:27
const manifest = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'));
发起网络请求
lib/self-update.js:62
const response = await fetch(url, { signal, headers: { 'User-Agent': 'dsh-plugin-panel' } });
读取密钥环境变量
src/catalog.ts:249
const githubToken = process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN;
发起网络请求
src/catalog.ts:312
const response = await fetch(url, { signal, headers: GITHUB_SEARCH_HEADERS });
发起网络请求
src/catalog.ts:316
const retry = await fetch(url, { signal, headers: GITHUB_SEARCH_HEADERS });
发起网络请求
src/catalog.ts:333
const response = await fetch(bucketSearchUrl({ start: '2000-01-01', end: '2099-12-31' }, page), {
读取本地文件
src/catalog.ts:514
const raw = await readFile(this.bundledCuratedPath(), 'utf8');
读取本地文件
src/catalog.ts:540
const raw = await readFile(this.bundledAllPath(), 'utf8');
读取本地文件
src/catalog.ts:568
const raw = await readFile(this.cacheFile(lens), 'utf8');
写入本地文件
src/catalog.ts:587
await mkdir(this.dir, { recursive: true });
写入本地文件
src/catalog.ts:590
await writeFile(tmp, JSON.stringify(snapshot, null, 2), 'utf8');
写入本地文件
src/catalog.ts:591
await rename(tmp, file);
读取本地文件
src/catalog.ts:597
const info = await stat(this.cacheFile(lens));
发起网络请求
src/catalog.ts:659
const response = await fetch(configuredUrl, { signal, headers: { 'User-Agent': 'dsh-plugin-panel' } });
发起网络请求
src/catalog.ts:689
const response = await fetch(url, { signal, headers });
发起网络请求
src/catalog.ts:745
const response = await fetch(url, { signal, headers: { 'User-Agent': 'dsh-plugin-panel' } });
发起网络请求
src/client/client.js:377
return fetch("/api/plugin-panel" + path, init).then(function (res) {
发起网络请求
src/embeddings.ts:61
const response = await fetch(embeddingEndpoint(config.baseUrl), {
读取本地文件
src/embeddings.ts:135
const parsed = JSON.parse(await readFile(this.file, 'utf8')) as VectorIndex;
写入本地文件
src/embeddings.ts:147
await mkdir(join(this.file, '..'), { recursive: true });
写入本地文件
src/embeddings.ts:149
await writeFile(tmp, JSON.stringify(index), 'utf8');
写入本地文件
src/embeddings.ts:150
await rename(tmp, this.file);
读取本地文件
src/installed.ts:25
try { text = await readFile(join(dshHome, 'profiles', profile, 'cordis.patch.yml'), 'utf8'); } catch { return registrations; }
读取本地文件
src/installed.ts:61
return JSON.parse(await readFile(join(dshHome, 'profiles', profile, 'package.json'), 'utf8')) as ProfilePackageJson;
读取本地文件
src/installed.ts:107
for (const name of await readdir(skillRoot, { withFileTypes: true })) {
读取本地文件
src/installed.ts:111
await access(skillFile);
执行外部命令来自配置/变量
src/lifecycle.ts:37
const child = spawn(file, args, { cwd, shell: false, windowsHide: true, env: safeEnv() });
读取本地文件
src/operations.ts:41
const parsed = JSON.parse(await readFile(this.file, 'utf8')) as unknown[];
写入本地文件
src/operations.ts:73
await mkdir(dirname(this.file), { recursive: true });
写入本地文件
src/operations.ts:75
await writeFile(tmp, JSON.stringify(this.current, null, 2), { encoding: 'utf8', mode: 0o600 });
写入本地文件
src/operations.ts:76
await rename(tmp, this.file);
写入本地文件
src/operations.ts:77
if (process.platform !== 'win32') await chmod(this.file, 0o600);
读取本地文件
src/self-update.ts:31
const manifest = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8')) as { version?: unknown };
发起网络请求
src/self-update.ts:65
const response = await fetch(url, { signal, headers: { 'User-Agent': 'dsh-plugin-panel' } });
读取本地文件
src/state.ts:21
const raw = await readFile(this.file, 'utf8');
写入本地文件
src/state.ts:52
await mkdir(dirname(this.file), { recursive: true });
写入本地文件
src/state.ts:54
await writeFile(tmp, JSON.stringify(this.current, null, 2), { encoding: 'utf8', mode: 0o600 });
写入本地文件
src/state.ts:55
await rename(tmp, this.file);
写入本地文件
src/state.ts:56
if (process.platform !== 'win32') await chmod(this.file, 0o600);
读取本地文件
src/translate.ts:128
const parsed = JSON.parse(await readFile(this.file, 'utf8')) as Record<string, CachedTranslation>;
写入本地文件
src/translate.ts:147
await mkdir(dirname(this.file), { recursive: true });
写入本地文件
src/translate.ts:149
await writeFile(tmp, JSON.stringify(this.cache), 'utf8');
写入本地文件
src/translate.ts:150
await rename(tmp, this.file);

扫描于 2026/11/4（0 天前） · 范围入口闭包 + 发布文件清单 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/cordis

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

功能亮点

全目录搜索
中文翻译
语义搜索

DSH 插件市场面板，支持全目录搜索、中文翻译、语义搜索、收藏和生命周期管理。

README

由 DeepSeek 最新模型翻译生成

插件面板 v6.16（插件面板） DSH 社区插件市场面板 —— 在 DeepSeek Harness Web GUI 的侧边栏底部提供入口，点击打开右侧抽屉：浏览/搜索社区插件、Skill、客户端 UI 与开发资源，支持中文翻译、收藏与已安装管理，并通过官方 dsh plugin 命令完成安装 / 更新 / 卸载（含确认、备份与失败回滚）。版本 v0.6.17：目录安装信息改用 awesome-dsh-plugin.com/plugins.json 官方公开源；下载会限时重试并严格校验，完整目录任务会在 GitHub 全量抓取前先检查数据源，避免长时间运行后才失败。版本 v0.6.15：设置区新增「作者 / 教程 / 反馈」入口，提供抖音与 B站主页；用于查看教程及反馈插件问题。版本 v0.6.14：修复精选目录的真实在线刷新。GitHub 的 catalog-data 数据分支现在同时发布 catalog.json（全部）和 curated.json（精选）；右上角刷新会下载当前源的在线 JSON，网络不可用才保留随包内置目录。精选标题会显示其生成时间，便于确认刷新是否真的取得新数据。版本 v0.6.13：修复旧的精选缓存遮住新版内置索引的问题；旧的小型缓存不会再覆盖当前精选目录。版本 v0.6.11：面板自更新。

展开完整文档（README 剩余 1 节）

插件面板 v6.16（插件面板）

DSH 社区插件市场面板 —— 在 DeepSeek Harness Web GUI 的侧边栏底部提供入口，点击打开右侧抽屉：浏览/搜索社区插件、Skill、客户端 UI 与开发资源，支持中文翻译、收藏与已安装管理，并通过官方 dsh plugin 命令完成安装 / 更新 / 卸载（含确认、备份与失败回滚）。

版本 v0.6.17：目录安装信息改用 awesome-dsh-plugin.com/plugins.json 官方公开源；下载会限时重试并严格校验，完整目录任务会在 GitHub 全量抓取前先检查数据源，避免长时间运行后才失败。

版本 v0.6.15：设置区新增「作者 / 教程 / 反馈」入口，提供抖音与 B站主页；用于查看教程及反馈插件问题。

版本 v0.6.14：修复精选目录的真实在线刷新。GitHub 的 catalog-data 数据分支现在同时发布 catalog.json（全部）和 curated.json（精选）；右上角刷新会下载当前源的在线 JSON，网络不可用才保留随包内置目录。精选标题会显示其生成时间，便于确认刷新是否真的取得新数据。

版本 v0.6.13：修复旧的精选缓存遮住新版内置索引的问题；旧的小型缓存不会再覆盖当前精选目录。

版本 v0.6.11：面板自更新。抽屉底部设置区新增「面板版本」小字行——显示当前版本 / 最新版本 / 是否需要更新（打开抽屉时自动检查上游 GitHub 仓库的 package.json，结果缓存 10 分钟）；发现新版本时旁边出现「更新面板」按钮（两段式确认），走与其他插件完全相同的受保护生命周期（备份 → dsh plugin add → 校验 → 失败回滚）；更新成功后该行变为「已更新到 vX · 重启 GUI 后生效」的重启提醒。

版本 v0.6.10：重构插件生命周期。完整 GitHub topic 目录只负责“发现”，只有作者/社区登记过准确 npm 包、GitHub 子目录或包源的条目才显示安装按钮；例如 dsh-web-ui 会安装作者指定的 @linxin666/dsh-web-ui-all，不再错误安装仓库工作区根目录。安装后分别校验 Profile Bundle 或兼容的 Cordis 用户层注册，现有手动注册插件会显示“已启用（用户配置）”。用户自己的 patch 不会被面板自动删除。

v0.6.9 的云端向量目录同步与常驻重建按钮继续保留。
v6 新增：语义向量搜索 —— 搜索框旁「语义搜索」开关：关闭 = 关键词搜索；打开 = 向量语义检索（多语言）。默认连接硅基流动 BAAI/bge-m3，模型 / API 地址 / Key 可在设置中修改；目录向量索引构建一次后本地缓存（~/.dsh/plugin-panel/vectors.json），查询按余弦相似度排序。

v6.5 改进按需翻译：仅翻译进入视口的卡片；Harness LLM 使用小批量 JSONL 输出并对缺项逐条重试；结果按原文指纹缓存，目录描述变更后会自动重新翻译；LLM 不可用或仍有缺项时，以社区插件采用的 Google gtx 方式逐条回退。客户端使用持久队列，修复请求进行中因重渲染而漏掉下一批的问题。v6.4 的向量索引并发保护及 v6.3 的全量目录、流式事件和向量兼容修复均保留。

语义搜索（v6）

- 开关：搜索框右侧「语义搜索」勾选框。
- 配置：抽屉底部设置区「嵌入模型（语义搜索）」：API Key（必填）、模型（默认 BAAI/bge-m3）、API 地址（默认 https://api.siliconflow.cn/v1），保存后生效。
- 建立索引：开启开关后，若本地无向量索引且已配置 Key，点击「建立向量索引」——host 端分批嵌入全部目录条目（3109 条，约 32 次请求）并落盘缓存；之后查询只嵌入用户输入（1 次请求）。
- 检索：输入关键词（中/英文均可）→ host 嵌入查询 → 与缓存向量做余弦相似度 → 返回 Top 结果；与关键词搜索一样受分类/收藏/已安装筛选约束。
- 安全：API Key 仅在明确点击“保存嵌入设置”后写入本地 ~/.dsh/plugin-panel/state.json，请求直达配置的 embeddings 端点（默认硅基流动），面板不记录 Key。

功能

版本 v0.6.12：独立目录 v6.12/（旧版本保留）。
v6.12–v6.14：精选目录采用预构建索引 —— scripts/build-catalog.mjs --curated-only 从官方 awesome-dsh-plugin 解析精选列表，生成 catalog/curated.json。该文件随插件发布，且由目录工作流同步到 catalog-data；面板“精选”目录秒级加载，手动刷新下载在线 JSON（当前随上游列表变化，不能把固定条目数当作刷新成功与否的依据）。
v3 架构（预构建离线索引）：scripts/build-catalog.mjs（可续传、可配 token）服务端抓全 dsh-plugin topic 生成 catalog/catalog.json 随插件发布，面板“全部”目录秒级加载；刷新 = 下载一个文件。

覆盖完整性：构建脚本对超过 1000 条的查询自动细分 —— 日期区间 → 单日按 stars: 区间 → 单星标值按 size: 区间，无法细分记入 gaps 并在 manifest 暴露覆盖率。

功能

- 入口：侧边栏底部（设置上方）的 “插件面板” 按钮；窄栏（rail）态显示为图标。
- 右侧抽屉：点击按钮打开固定右侧抽屉，点遮罩或关闭按钮收起。
- 双目录源：搜索框下方「精选 / 全部」切换按钮，鼠标悬停显示两者区别：
- 精选：预构建索引 catalog/curated.json（官方 awesome-dsh-plugin 精选列表），质量优先；启动使用内置/缓存，手动刷新从 catalog-data/curated.json 下载。
- 全部：启动先显示随包目录或本地缓存，再从 catalog-data 数据分支下载一个 catalog.json；GitHub Actions 每小时更新，用户电脑不再运行全量爬虫。
- 目录缓存 + 手动刷新：右上角刷新按钮按当前源拉取并写盘。
- 作者 / 教程 / 反馈：设置区底部提供 抖音主页 和 B站主页 链接。
- 分类：插件 / Skill / 客户端 / 开发资源（含计数）。
- 中英文关键词搜索：标题、描述（中英）、标签、作者、仓库、npm 名均参与匹配。
- 排序（v4）：默认 / 星标最多 / 星标最少 / 名称 A-Z / 名称 Z-A / 最新创建 / 最早创建，持久化到设置。
- 描述中文翻译：精选条目内置人工翻译；一键切换 中文 / EN。
- 收藏管理：星标收藏，持久化于 ~/.dsh/plugin-panel/state.json；可筛选“只看收藏”。
- 操作记录：默认两条、可展开最近 100 条或一键清空；保存在 ~/.dsh/plugin-panel/operations.json，不保存命令原始输出或 API Key。
- 已安装管理：同时读取 profile 的依赖、bundle 列表、cordis.patch.yml 用户层注册以及 ~/.dsh/skills；区分已启用 Bundle、已启用（用户配置）、Skill 和仅下载依赖。
- 安装 / 更新 / 卸载（官方命令）：调用 dsh plugin --profile add|remove 。
- 确认：按钮两段式确认（再点一次才执行）。
- 备份：操作前把 profile 的 package.json / cordis.patch.yml / pnpm-lock.yaml 复制到 ~/.dsh/plugin-panel/backups//。
- 结果校验与回滚：退出码为 0 仍会检查真实包名、入口产物与激活状态；官方 Bundle 校验 patch 与 profile bundles，兼容型 Host 插件校验可加载的 apply 后写入带面板标记的用户层注册。失败自动恢复备份。GitHub/link 更新复用原 spec，卸载使用真实包名。
- 环境自检：抽屉顶部显示 dsh CLI / pnpm 是否可用；pnpm 缺失时一键安装。
- 安全：HTTP API 仅接受 loopback 请求；安装来源为目录中列出的官方仓库 / npm 包（不执行任意命令，只转发到官方 dsh plugin）。

云端目录构建（维护者用）

npm run build # 先构建 lib
node scripts/build-catalog.mjs --reset # 全量重建（可续传，断点续跑）
node scripts/validate-catalog.mjs catalog/catalog.json
可选：GITHUB_TOKEN= node scripts/build-catalog.mjs # 提速（30 次/分钟）产物：catalog/catalog.json（manifest 含覆盖率）

.github/workflows/update-catalog.yml 由 Hermes 在每天 00:17 / 06:17 / 12:17 / 18:17（中国时间）触发，并在每天 08:47 / 20:47 备用运行，也可手动触发。发布前必须满足 schema 正确、ID 唯一、gaps=0，且抓取数相对上一版不异常低于 95%；GitHub Search 的瞬时 total_count 仅供展示，不作为失败门槛。成功后只更新独立 catalog-data 分支中的两份 JSON。

安装/卸载后需要重启 GUI 才加载/卸载插件本体（DSH 的 bundle 机制如此）；面板自身在重启前仍可继续浏览。

安装

使用官方 DSH 插件命令从 GitHub 安装：

dsh plugin --profile web add github:Dylan37670/dsh-plugin-panel

安装或更新后重启 DSH Web GUI，侧边栏底部会出现“插件面板”。

开发者从源码构建：

克隆并进入仓库
git clone https://github.com/Dylan37670/dsh-plugin-panel.git
cd dsh-plugin-panel
npm install
npm run build && npm test

挂载本地源码
dsh plugin --profile web add .

验证挂载
dsh --profile web --dump-config | grep plugin-panel-market

重启 GUI 后，侧边栏底部出现“插件面板”入口

目录结构

dsh-plugin-panel/
├── package.json # bundle 声明（dsh.bundle.patch + dsh.client） ├── cordis.patch.yml # profile 插入行 ├── tsconfig.json ├── src/ │ ├── index.ts # host 入口：注册 /api/plugin-panel 路由 │ ├── catalog.ts # 目录服务：远程拉取 + 解析 + 磁盘缓存 + seed 合并 │ ├── catalog-data.ts # 精选 seed 目录（含中文翻译） │ ├── installed.ts # bundles + dependencies + skills 状态检测 │ ├── state.ts # 收藏 + 深度合并设置持久化 │ ├── operations.ts # 本地操作记录（最多 100 条） │ ├── lifecycle.ts # dsh 插件转发、结果校验、备份、回滚 │ ├── http.ts # HTTP 路由（仅回环） │ ├── types.ts # 共享 JSON 类型 │ └── client/client.js # 客户端半部（模块加载器格式，React 手写） ├── scripts/copy-client.mjs └── tests/ # catalog / lifecycle / register 契约测试

架构

| 端 | 职责 | 通信 |
| Host | 目录缓存/刷新、安装/更新/卸载（dsh plugin）、备份回滚、收藏状态 | 注册 webServer 前缀路由 /api/plugin-panel/*（仅回环） |
| Client | 侧边栏入口 + 右侧抽屉 UI | 同源 fetch 到上述 HTTP API |

插槽使用：sidebar.footer.action（入口，id: plugin-panel-market）；抽屉由同一组件用固定定位渲染（与内置 Cordis 面板同款做法），不占用额外插槽。

测试

npm run build # tsc + 拷贝 client bundle
npm test # catalog 解析/合并、状态持久化、备份回滚、注册契约

真实 Harness 运行验证（v0.1.0）

在隔离的 DSH_HOME 下用官方命令初始化独立 profile panel-runtime 并挂载本插件，启动第二个 dsh web（端口 3081）做端到端验证：

| 验证项 | 结果 |
| dsh plugin add 挂载 + --dump-config 出现 plugin-panel-market 行 | ✅ |
| GET /api/plugin-panel/catalog（seed 64 条） | ✅ |
| POST /refresh 拉取真实 awesome-dsh-plugin 列表 → 538 条、1.7s、分类正确 | ✅ |
| 目录磁盘缓存（plugin-panel/catalog.cache.json） | ✅ |
| /favorite 收藏持久化（plugin-panel/state.json） | ✅ |
| /installed 按 profile 读取 bundles + skills | ✅ |
| 安装 fixture 插件 → bundles 追加 + /installed 反映 | ✅ |
| 卸载 → bundles 还原 | ✅ |
| 失败安装（不存在路径）→ rolledBack: true，备份恢复，bundles 还原 | ✅ |
| client bundle 经 clientModules 由 /plugins/@dsh-community/plugin-panel/client.js 提供（200） | ✅ |
| node --check client bundle 语法 | ✅ |
| npm run typecheck + npm test（14 用例） | ✅ |

侧边栏入口 + 抽屉的浏览器内视觉验证需在重启 GUI（dsh web）后进行：本插件已挂载进真实 web profile，重启后即可在侧边栏底部看到“插件面板”入口。

真实 Harness 运行验证（v0.2.0）

v2 在隔离 DSH 实例（端口 3081）与真实 web profile 双重验证：

| 验证项 | 结果 |
| v1 全部验证项（目录/缓存/收藏/已安装/安装卸载/回滚/client 服务） | ✅（继承） |
| pnpm 检测修复（Windows cmd 解析 pnpm.cmd）→ /env pnpmFound: true | ✅ |
| GET /catalog?lens=curated（538 条，命中磁盘缓存） | ✅ |
| POST /refresh {lens:'all'} GitHub topic 检索 → 1020 条、totalHits 3058、20s | ✅ |
| 全部仓库分类：plugin 672 / client 198 / skill 81 / dev-resource 69 | ✅ |
| client UI 冒烟测试（真实 bundle + jsdom）：入口按钮、抽屉、搜索、5 分类 tab、设置、精选/全部仓库切换按钮 + 悬停 data-tip | ✅ |
| npm run typecheck + npm test（18 用例） | ✅ |

v0.1.0 的原始验证记录见 v1 README。

兼容性

社区星标前十插件与本面板的静态兼容性检查见 COMPATIBILITY.md。v6.10 不再把所有 topic 仓库根目录假定为可安装 Bundle；没有可靠安装目标的候选条目只提供项目链接。

致谢 / Credits

- 目录数据来源：awesome-dsh-plugin（社区精选列表）、awesome-dsh-plugin.com/plugins.json（准确安装目标）与 omdsh-dev 组织仓库的 README 描述。这里只读取并标注数据来源，不复制其他市场的实现代码。
- 参考了同类项目的优秀思路（未复制代码）：dsh-market（一键安装/更新/卸载、重启提示、pnpm 自检）、dsh-store（npm+awesome 双源目录、官方命令安装）、dsh-plugin-workshop（中文关键词映射、双语描述）、dsh-plugin-manager（多源搜索、doctor 审计）、dsh-webui-market-plugin。UI 采用侧边栏入口 + 抽屉的交互形态是原创设计。
- DSH 平台机制参考：DeepSeek Harness 官方仓库与 dsh-plugin-dev 开发档案。

License

MIT（见 LICENSE）。目录条目与其描述归各自项目所有。