跳到主内容

dsh-plugin-workshop 使用指南

DSH 插件工坊:免服务器,直接在 DSH Web 侧栏浏览/搜索/安装/卸载第三方插件,支持中文关键词、GitHub 趋势窗口与本地插件管理。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-plugin-workshop

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:yyyyukari/dsh-plugin-workshop

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 侧栏常驻入口:官方「新会话」按钮正下方,同款样式(DOM 克隆官方按钮,宽/窄侧栏自适应),刷新、重启都不丢
  • 搜索与排序:关键词搜索(支持中文,自动映射英文)、★最热 / ⏰最新、飙升榜时间窗口(近 7/30/90 天新建 + 热度排序,Steam Trending 近似)
  • 默认只搜 DSH 插件:默认「插件话题」(topic:dsh-plugin);搜索结果自动排除官方 harness 等核心仓库(查询级 -repo: 过滤,不再占据榜首);全站模式自带插件特征验证(检查 package.json 的 dsh 字段 / cordis.yml 等,走 raw CDN 不耗 API 额度),默认过滤无关仓库
  • 已安装管理:工具栏「📦 已安装」视图——合并 profile 依赖/激活行/本地预设展示本机插件(类型、激活状态、安装来源),一键更新(pnpm update / git pull)与卸载
  • 双语体验:描述一键切换原文/中文机翻,README 可整篇翻译(Google 翻译接口,自动缓存)

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装这个插件需要部署自己的服务器吗?

不需要。插件走零服务器路线,目录与搜索全部用浏览器直连 GitHub 搜索 API + raw.githubusercontent.com,只有可选的社区统计徽章才需要自配 Cloudflare Worker。

GitHub Token 必填吗?会被上传到第三方吗?

不必填,匿名也有 10 次/分的搜索额度;填了 PAT 之后可以升到 30 次/分。Token 只存在浏览器 localStorage,只在调用 api.github.com 时随请求发出,不会发往任何其他服务器。

装完之后插件装到哪里去了?

bundle 型插件走 dsh plugin add 进入 profile 依赖;嵌套包先拷到 $DSH_HOME/.agent-presets/<repo>/ 再 link 进去;preset 型直接拷到 .agent-presets/<repo>/。可在「📦 已安装」视图里看到合并后的清单。

一键安装能在 macOS/Linux 上用吗?

浏览器端的浏览/搜索/翻译都能用,但「一键安装/更新/卸载」会通过 Windows 的 cmd 通道调度 dsh 命令;宿主在预检时会把它降级为「有风险/建议手动」并提示,因此 macOS/Linux 上建议走插件详情页给出的手工安装命令。

怎么卸载一个插件?

在工坊的「📦 已安装」视图里选对应插件点卸载;卸载会先按安装方式逆向清理(pnpm remove 失败时不删任何文件以免留失效符号链接),成功后 Windows 命令行版会自带重启 dsh web 让插件表刷新,桌面 App 版需要你手动重启 App。

插件能离线工作吗?

不能。搜索与验证都需要 GitHub 在线访问;机翻走 Google gtx,也需要联网。已安装的本地副本可以离线浏览,但搜索/翻译/安装等动作均需要网络。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 未声明
  • Node: 未声明
  • Platforms: Windows, macOS, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则