前言¶
在 DeepSeek Harness(DSH)里装插件,常见做法是翻 GitHub、记仓库地址、手动执行 dsh plugin add。社区目录站点能集中展示插件,但安装仍要回到命令行。另一类方案是部署中心化市场平台,需要额外基础设施和账号体系。
dsh-plugin-workshop(维护者 yyyyukari)走另一条路:把插件浏览、搜索、安装整合进 DSH Web UI 侧栏,数据全部来自 GitHub 搜索 API 与 raw CDN,不部署控制平面。下面介绍它的定位、能力与使用方式。
这是什么¶
dsh-plugin-workshop 是 DSH Web UI 的创意工坊式插件浏览器,单包开箱即用,内置在侧栏「新会话」按钮正下方。与中心化市场平台路线不同,它采用零基础设施方案:目录、搜索、热度、发布时间由 GitHub 免费提供,装进 profile 即可使用。
- 维护者:yyyyukari
- 分类:客户端
- 许可证:MIT
- 当前版本:1.6.2(package.json)
- GitHub 星标:25
核心功能¶
侧栏入口与界面挂载¶
激活后,侧栏「新会话」下方出现「插件工坊」入口,样式与官方按钮一致(DOM 克隆,宽/窄侧栏自适应)。浮层通过 shell.overlay 打开;设置 → 插件区也有「插件工坊」标签页。刷新或重启后入口不丢失。
搜索、排序与过滤¶
默认只搜 DSH 插件,查询使用 topic:dsh-plugin。支持关键词搜索,中文词(如「天气」「翻译」)会自动映射为英文关键词。排序选项包括最热、最新,以及飙升榜时间窗口(近 7/30/90 天新建 + 热度排序)。
搜索结果自动排除官方 harness 等核心仓库(查询级 -repo: 过滤)。全站模式下会做插件特征验证:检查 package.json 的 dsh 字段、cordis.yml 等,通过 raw CDN 拉取,不消耗 GitHub API 额度。
已安装管理¶
工具栏「已安装」视图合并 profile 依赖、激活行与本地预设,展示本机插件的类型、激活状态与安装来源。支持一键更新(pnpm update / git pull)与卸载。
双语体验¶
描述可一键切换原文/中文机翻;详情页 README 可整篇翻译(Google 翻译接口,自动缓存)。
智能一键安装与卸载¶
详情页会预检仓库结构,给出三级评级:可直接安装、有风险、建议手动。标准 bundle/nested/preset 结构支持一键安装;特殊结构(多包 monorepo、非插件仓库、带构建脚本等)会降级为从 README 提取的安装命令,仅可复制,不自动执行。
卸载按安装方式逆向清理:pnpm remove 失败则不改动文件;成功后自动重启 dsh web 刷新插件表。本机缺少 git 时界面会明确提示。
详情页与额度透明¶
详情页展示星数、fork、语言、许可证、创建时间,轻量渲染 README,并提供手动安装命令与 GitHub 直达链接。工具栏实时显示 GitHub 搜索剩余额度与恢复倒计时;可选填 GitHub Personal Access Token(30 次/分,仅存本机浏览器 localStorage)。
可选统计服务¶
可选接入统计服务后解锁社区装机徽章与真·飙升榜(参考实现见仓库 remote/README.md)。不部署时零影响。
安装与启用¶
以 web profile 为例,一条命令安装:
# 本包在 package.json 声明了 dsh.bundle.patch,
# dsh plugin add 会自动把它加入 profile 的 dsh.profile.bundles,
# 启动时 cordis.patch.yml 作为 bundle 补丁层自动激活。
dsh plugin --profile web add "github:yyyyukari/dsh-plugin-workshop"
# 重启 dsh web 并刷新浏览器
手动接入旧流程:把本包加进 profile dependencies,并在 $DSH_HOME/profiles/web/cordis.patch.yml 添加:
- insert:
- id: plugin-workshop
name: '@dsh-external/dsh-plugin-workshop'
典型用法¶
| 需求 | 操作 |
|---|---|
| 找 DSH 插件 | 默认即「插件话题」列表(topic:dsh-plugin 收录的仓库) |
| 看飙升榜 | 时间下拉选近 7 天/近 30 天/近 90 天飙升 + 最热 |
| 中文搜索 | 直接输入中文词,自动映射英文关键词 |
| 看中文描述 | 工具栏「描述中文」;详情页「翻译 README」 |
| 安装/更新/卸载插件 | 详情页「一键安装(订阅)/ 更新到最新 / 卸载」,需要本机 git |
| 提高搜索额度 | 工具栏设置 → 填入 GitHub Personal Access Token |
适用场景与注意¶
适合谁: 经常在 DSH Web UI 里浏览、搜索、安装社区插件的开发者;希望用 GitHub 作为唯一数据源、不想自建市场后端的用户。
架构要点: 宿主侧(lib/index.js)在 webServer 上注册 /dsh-plugin-workshop/api/{status,install,update,uninstall} 路由;浏览器侧(lib/client.js)用 React 实现界面。数据流为 GitHub 搜索 API(匿名 10 次/分)→ raw CDN 特征验证 → Google 机翻。不执行任何第三方代码。
安全提醒: 插件以当前 dsh 进程权限运行。一键安装前建议查看目标仓库源码与许可证;对「有风险」或「建议手动」评级的仓库,按 README 给出的命令自行判断后再执行。
DSH 生态理念是「一切皆插件」;SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系。dsh-plugin-workshop 不是官方应用商店,而是把 GitHub 上的 DSH 插件生态接到 Web UI 里的客户端工具。
链接¶
- 目录页:https://www.skillhub.cn/plugins/yyyyukari/dsh-plugin-workshop
- GitHub:https://github.com/yyyyukari/dsh-plugin-workshop