dsh-plugin-galaxy

Plugin Galaxy · dsh-plugin-galaxy

于万千插件中甄选价值，DeepSeek Harness 扩展更轻盈。 A visual plugin galaxy inside DeepSeek Harness — browse, search, and install community plugins without leaving the app.

装在 DeepSeek Harness（DSH）设置对话框里的插件市场：逛、搜、看排名、一键安装， 更新/启停/卸载/备份恢复/诊断也在同一个面板里完成。它不占侧栏座位， 不往会话里塞命令，也不在后台偷偷跑活儿 —— 只有你打开设置时才出现。

---

1. 为什么值得装

• 排名是真的：面板直接读官网目录的综合推荐榜（ranking.top）， 卡片带 #1、#2… 名次与分档徽标，点开有"为什么推荐"的评分构成。 没有把"下载量最高"包装成"推荐"。
• 装完就能用：安装、更新、启停、卸载、回滚都在面板里，进度/取消/回滚有独立的状态面板； 失败会留下可读原因，而不是让 profile 处于半坏状态。
• 敢动你的 profile：每次破坏性操作前先做 profile 快照（三文件 + 回滚令牌）， 失败自动回滚；写操作走互斥锁 + 原子写（临时文件 + rename），不靠"应该没问题"。
• 两代宿主都能跑：宿主在 0.2.x 改了图标命名、设置卡片座位与插件设置项三处契约， 本插件用运行时解析同时兼容 0.1.5-rc.2 与 0.2.1-alpha.1，不是"只支持最新版"。
• 失败隔离：客户端有 error boundary（面板崩了给恢复面板 + 导出日志）， 服务端每个路由都独立捕获 —— 本插件出问题不会让你的宿主起不来。

2. 功能

2.1 发现与安装

2.2 已安装与生命周期

• 版本、来源类型、bundle 归属一览；启用 / 停用、更新、卸载（本插件自己的卡片不提供自我卸载按钮， 避免把自己卸掉后连界面一起消失）
• 备注与分组：给自己的插件写备注、分组，收藏待装条目
• 更新检查：npm 与 GitHub 两种来源，可强制刷新；本地安装（file: tarball）明确标注不检查更新
• 操作面板：排队 / 运行 / 需要输入 / 完成 / 告警 / 失败，支持取消与回滚
• 更新日志：按插件查看 release notes（来源可配置）

2.3 备份、迁移与自救（设置卡片）

• 快照与预设：把 profile 三文件（package.json / pnpm-lock.yaml / cordis.patch.yml） 存成命名快照或组合预设，一键恢复；保留数量可配（默认 20）
• WebDAV / GitHub Gist 同步：把备份推到自己的存储；只在显式点击时外发
• 下载区域 / 发布通道：选择目录与更新来源的区域与通道
• 一键重启（默认关闭，见权限与安全）、自我卸载
• 诊断：bundle 解析、peer 冲突、重名包清单；脱敏日志导出（token/密码打码）用于反馈问题
• 收藏与主题：收藏待装条目；互斥激活主题型插件 bundle

3. 安装

本插件不在 npm 上（registry.npmjs.org/dsh-plugin-galaxy 不存在）， 所以 dsh plugin add dsh-plugin-galaxy 不会成功。请用下面两条路径之一。

路径 A：从 Release 安装（推荐，免构建）

dsh plugin --profile web add \
  https://github.com/AndyPBI/dsh-plugin-galaxy/releases/download/v0.1.34/dsh-plugin-galaxy-0.1.34.tgz

路径 B：从源码构建（用于自行审计或改代码）

git clone https://github.com/AndyPBI/dsh-plugin-galaxy.git
cd dsh-plugin-galaxy
npm ci                 # 没有 lockfile 的旧版本可用 npm install
npm run build          # 服务端 tsc → lib/，客户端 tsdown → client/client.js
npm pack               # 产出 tarball，文件名即下一行要装的那个

# 装进你的 profile（把 web 换成你的 profile 名；版本号用 npm pack 打印出来的）
dsh plugin --profile web add ./dsh-plugin-galaxy-0.1.34.tgz

装完怎么用

1. 完整重启宿主（退出并重新启动 dsh；只刷新页面不够 —— 插件是在宿主启动时装载的）。
2. 打开设置对话框 → 插件星系：打开即是市场。
3. 卸载：dsh plugin --profile web remove dsh-plugin-galaxy，或在面板里用自我卸载。

环境要求

4. 权限与安全

它读写什么

它访问哪些网络（全部出站，且都有开关）

它执行什么子进程

• dsh plugin --profile <p> add|remove|…：把 pnpm 参数原样转发给宿主 CLI，安装逻辑不自己实现
• Desktop 形态下可选调用宿主提供的 desktopPnpm 服务
• 安装子进程有超时与"杀掉后等待落定"的兜底（DSHG_INSTALL_TIMEOUT_MS / DSHG_KILL_SETTLE_MS）

它暴露什么

• 所有 HTTP 端点挂在 /dsh-galaxy 前缀下（默认只监听宿主已暴露的地址）
• 所有变更路由校验同源（打包桌面版的壳转发请求时会剥离 Origin，故"无 Origin 但来自回环"同样接受，桌面 UI 才能安装/更新）；破坏性路由（重启、自我卸载、备份下载）额外要求 loopback 且拒绝代理转发
• 公开更新 API v1（/dsh-galaxy/api/v1/*）供 CI/脚本使用，稳定性标注为 beta

不会做的事

• 无遥测：不采集使用数据、不上报统计、不发任何"心跳"
• 不落盘凭据：WebDAV/Gist 凭据由宿主设置或环境变量提供，插件不写入自己的状态文件；日志导出会脱敏
• 不默认重启宿主：allowRestart 默认未配置即视为关闭；宿由 launchd（或其它 supervisor）托管时， 只有你显式设为 true 才允许自重启 —— 避免和托管方抢夺进程所有权
• 无 postinstall 脚本；发布物只含 lib/、src/、client/、cordis.patch.yml、LICENSE
• 失败不改宿主：客户端 error boundary + 服务端逐路由捕获，本插件异常不影响宿主启动

5. 常见问题

6. 文档地图

English overview: README.en.md

7. 许可与作者

MIT，见 LICENSE（Copyright © 2026 AndyPBI）。

• 维护者：AndyPBI · dalianyunhai@gmail.com
• 仓库与问题反馈：https://github.com/AndyPBI/dsh-plugin-galaxy
• 第三方归属说明：THIRD-PARTY-NOTICES.md

插件目录与排名由社区站点 https://www.yhaigc.cn 提供；本插件与该站点无隶属关系， 目录地址可用环境变量替换为任何兼容的 catalog。