dsh-plugin-store

Plugin Store for DeepSeek Harness (DSH): a graphical app-store inside the Harness Web UI — browse, search, and one-click install GitHub dsh-plugins, with local ratings, dependency impact graphs, audit logging, and a development scaffold

latest

Source

npm

Version: 0.1.0

Version published: 2 months ago

Maintainers: 1

Created: 2 months ago

Source

dsh-plugin-store — DeepSeek Harness 插件商店

一个深度集成于 Harness Web UI 的图形化插件商店：在原生界面中浏览、搜索、一键安装 GitHub 上的 DSH 插件（来源限定为标记 topic: dsh-plugin 或 #dsh-plugin 的仓库），并内置本地评分评论、依赖拓扑评估、操作审计日志与插件开发脚手架引导。

功能总览

功能	说明
主界面入口按钮	侧边栏底部「插件商店」按钮，与常规功能按钮同尺寸（宽 34px / 窄栏 36px 圆形）
图形化商店	卡片式列表：图标、名称、简介、开发者、评分、下载量；支持按工具 / Agent / UI / 数据处理分类筛选，按名称或描述关键词搜索，按评分 / 下载量 / 最近更新排序
插件详情页	完整 README、使用说明、版本历史（GitHub Releases）、依赖信息、截图；一键安装 / 卸载 / 启用 / 禁用，全程无需命令行
GitHub Token 配置	设置页提供私人 Token 配置入口，缓解 GitHub API 限频（匿名搜索 10/min → 30/min，核心 60/h → 5000/h）
定时镜像同步	定期将 `topic:dsh-plugin` / `#dsh-plugin` 仓库元数据同步至本地 SQLite 数据库（`$DSH_HOME/storages/plugin-store/`），搜索加载不受网络与限频影响；支持手动「立即同步」
本地评分与评论	企业内部用户可对插件 1-5 星打分并撰写使用反馈，与 GitHub 数据互补形成内部口碑（仅本机/本企业可见）
依赖拓扑图	详情页可视化展示该插件依赖的底层库（红色入边）与被哪些上层插件依赖（蓝色出边），辅助卸载前评估影响范围
操作审计日志	完整记录谁在什么时间执行了安装、卸载、启用、禁用、评分、Token 配置、镜像同步等操作，可筛选查询，满足企业合规要求
插件开发脚手架	商店内置开发引导入口：插件结构说明、模板与官方文档链接、脚手架命令一键复制，鼓励内部开发者创建插件并打上 `dsh-plugin` 标签回馈生态

架构

Host 端（Node / Cordis）：lib/host/ — PluginStoreService 以 Typert Remote（pluginStore 命名空间）暴露 17 个远程方法；store-db.ts 使用 node:sqlite 持久化；github.ts 负责 GitHub 搜索与镜像同步；installer.ts 通过 pnpm 完成安装/卸载，并写入 profile 的 cordis.patch.yml，由 Cordis HMR 热加载生效（无需重启）。
Client 端（React / 浏览器）：lib/client.js — 单文件 bundle，注册 sidebar.footer.action 入口按钮与 settings.section 设置页，商店主体为 portal 覆盖层，视觉与原生设置对话框一致（复用 --dsw-* 主题变量）。
契约：lib/contracts/remote.js — zod v4 共享 wire 契约，同时导出 TYPERT_REMOTE（客户端挂载）与 TYPERT（host 端注册）。

安装

# 在任意位置构建本包（需要 node >= 22.19 与 pnpm）
pnpm install
pnpm build        # 产出 lib/host/*.js 与 lib/client.js

# 安装到 web profile（dsh plugin 命令），随后刷新浏览器即可看到入口按钮
dsh plugin --profile web add <本包目录>

安装后侧边栏底部会出现「插件商店」按钮。首次使用请先在商店「设置」页点击「立即同步」，将 GitHub 上的 dsh-plugin 仓库镜像到本地数据库。

开发

pnpm build:host   # tsc 编译 host 端
pnpm build:client # esbuild 打包 client bundle
pnpm typecheck

src/
  contracts/remote.ts   # zod 共享契约（TYPERT_REMOTE / TYPERT）
  host/
    index.ts            # PluginStoreService（Typert Remote 服务 + 定时同步）
    store-db.ts         # SQLite 本地数据库（镜像缓存 / 评分 / 审计）
    github.ts           # GitHub 搜索 + 镜像同步管道
    installer.ts        # pnpm 安装/卸载 + profile 补丁热加载
  client/
    index.tsx           # 入口注册（按钮 / 设置页 / locale）
    StoreApp.tsx        # 商店模态框外壳
    views.tsx           # 发现 / 详情 / 已安装 / 设置 / 审计 / 脚手架
    graph.tsx           # 依赖拓扑 SVG
    markdown.tsx        # 轻量 markdown 渲染
    settings-section.tsx# 原生设置页（Token / 镜像）
    store.css           # 样式（--dsw-* 主题变量）