概览

kidai-plugin-market-hub

Kidai Plugin Market Hub (纪代插件市场 Hub) for DeepSeek Harness: a 纪代市场 launcher above the Settings button on the home sidebar that opens a standalone page (插件市场 / 已安装) with one-click local install and an immediate-restart button on top.

README / ZH

插件文档

🐋 Kidai Plugin Market Hub（纪代插件市场）

一键安装 · 统一管理 · 安全护航 — DeepSeek Harness 的插件市场中心

简体中文 · English

✨ 为什么用它

DeepSeek Harness（DSH）的插件生态越来越大,但找插件、装插件、管插件分散在好几个地方。纪代插件市场把这些全部收进一个独立的全屏页面,侧边栏一键直达:

🗂️ 海量目录,一处逛完 — 聚合 GitHub dsh-plugin 话题、npm 注册表与社区精选 awesome 列表,1700+ 插件可搜索、可排序、可分类;
⚡ 一键安装 — 点一下就在当前 DSH 配置里装好,自动收敛 bundles,重启即生效;
🛡️ 装上就能用,不会装崩 — 市场在安装时自动做安全审计、入口校验、运行时兼容检查、keyed-slot 修补、@local 链接、源码子包构建——伪插件和"必崩"插件在安装环节就被拦下;
🧹 已装管理 + 孤儿清理 — 启用 / 禁用 / 更新 / 卸载,连"文件残留但没挂载"的孤儿插件都能在列表里直接启用或删除;
🚀 顶部立即重启 — 装完、更新完、切换完,一键重启 DSH。

无需懂任何技术细节 — 普通用户打开即用;开发者也能享受完整的安装安全网。

🚀 快速开始

在 DSH 命令行中执行(Desktop 用 desktop,Web 用 web):

dsh plugin --profile desktop add kidai-plugin-market-hub

然后重启 DSH,主页侧边栏「设置」按钮上方会出现「纪代市场」入口,点击进入全屏市场页。

卸载:

dsh plugin --profile desktop remove kidai-plugin-market-hub

需要本机可用的 pnpm(或 DSH 自带的 pnpm),并确保能访问 api.github.com(目录)与 registry.npmjs.org(安装校验)。

🎯 功能一览

逛市场

多源目录 — GitHub / npm / awesome 三个来源合并,实时抓取,5 分钟缓存 + 离线兜底;
搜索排序 — 按名称、描述匹配;按最近更新 / 星标 / 名称排序;
插件卡片 — 头像、简介、标签、星标、更新时间一目了然,点击直达 GitHub 发布页。

装插件

一键本地安装 — 自动解析 npm 包名或 GitHub 仓库,pnpm add + bundles 收敛;
安全审计 — 静态扫描高危风险(动态执行、网络请求、密钥读取等),高危拦截;
可加载性校验 — 缺入口的伪插件(如把部署脚本伪装成插件)在安装时被拒绝;
运行时兼容 — 旧版 DSH 插件自动修补已知差异,确认后安装,成功附带风险提示;
自动构建 — TypeScript 源码包子包缺构建产物时自动编译,失败即回滚。

管插件

启用 / 禁用 / 更新 / 卸载 — 已安装页集中操作;
孤儿插件 — 扫描未挂载的残留文件,灰色卡片可直接启用或删除;
打开本地目录 — 一键在文件管理器里定位插件安装位置。

立即重启

Hub 顶部常驻「立即重启」,两步确认后即时生效。

🖥️ 支持的部署形态

部署形态	启动方式	状态
Desktop 应用(内嵌 Web 界面)	启动 DSH Desktop	✅ 完整可用
独立 Web 部署	`dsh --profile web --port 8080`	✅ 完整可用

两种形态功能完全一致,唯一差异:独立 Web 部署无 Electron,"立即重启"降级为手动重启提示。

⚙️ 工作原理(技术细节)

组成部分	文件	说明
Host 半	`lib/index.js`	Cordis 插件,`PluginMarketGateway`(`TypertRemoteService`,命名空间 `pluginMarketHub`),通过 SRC 标记暴露 `listPublished` / `installed` / `installPlugin` / `setEnabled` / `openLocal` / `cancelEnabled` / `checkUpdates` / `updatePlugin` / `fetchReadme` / `auditPackage` / `restartApp` / `uninstallPlugin` / `scanOrphanPlugins` / `mountOrphan` / `removeOrphanFiles`。
组合层	`cordis.patch.yml`	插入插件行;因包声明 `dsh.client`,同一行同时进入浏览器模块清单。
Client 半	`lib/client.js`	浏览器 bundle:注册侧边栏启动器(`sidebar.footer.action`)与全屏 Hub 页(`shell.overlay`),挂载 Remote 描述符(手写严格 codec),渲染双页签 UI。
安装通道	Host `installPlugin(spec)`	校验 spec → 解析 pnpm → `pnpm add` → 收敛 `dsh.profile.bundles`。
重启通道	Host `restartApp()`	检测部署形态并请求重启;Hub 头部两步确认。

目录数据源

按顺序尝试,第一个成功即采用(页签下方显示来源):

GitHub API(官方) — topic:dsh-plugin 仓库搜索;
GitHub API 镜像 — ghfast.top / ghproxy.net;
npm 官方搜索 — registry.npmjs.org/-/v1/search;
npmmirror 搜索 — registry.npmmirror.com(国内最快最稳);
awesome-dsh-plugin 精选 — 社区维护列表,CDN 优先链路抓取,不耗 API 配额。

GitHub 不可达时自动走 tarball 下载链(codeload → ghproxy → ghfast → gh-proxy),避免 git 协议挂起数分钟。全部失败回退离线缓存。

📚 更多

更新记录:CHANGELOG.md
开发与发布:修改 lib/index.js(Host)重启生效;lib/client.js(浏览器)重启或走 dsh-client-hmr 热更。语法检查 node --check lib/index.js && node --check lib/client.js;测试套件见 scripts/。

License

MIT

kidai-plugin-market-hub