dsh-plugin-share

DSH Plugin Share

English | 中文

用分享码或二维码分享你的 DSH 插件清单。接收方可以逐项安装，并同步启用状态。

安装

dsh plugin --profile web add dsh-plugin-share
dsh --profile web

把 web 换成你使用的 profile 名称。启动后打开 设置 → 内置插件 → 插件分享。分享方和接收方都需要安装本插件。

指定版本时，将包名写成 dsh-plugin-share@0.2.5。也可以从 GitHub 安装：

dsh plugin --profile web add 'dsh-plugin-share@github:HGT158/dsh-plugin-share#main'

请保留 GitHub 安装命令里的 包名@ 前缀，避免依赖名解析错误。

桌面端：点击左上角「插件」，输入包名 dsh-plugin-share 即可安装。

本版已在 DSH 0.2.1-rc.2 的 Web profile 验证；早期版本也曾在 0.2.0-rc.2 验证。CLI 无法修改桌面 profile。

使用

1. **分享：**点「从当前 profile 导出」，勾选要分享的插件（默认全选），再点「生成所选组合码」。点「复制」发给对方，也可以点「展示二维码」，保存为 PNG 或 SVG。未勾选的插件不会写入码中，至少选择一项。
2. **接收：**粘贴分享码，点「解析组合码」。二维码图片可以通过「扫码导入」选择，或直接拖进面板。
3. **安装：**核对插件名称和来源，逐项点「安装」「启用」或「停用」，也可以点「全部可处理项加入队列」。解析本身不会修改插件。

安装期间可以继续点其他插件，按点击顺序排队，每次处理一项。等待项显示排队位置，可以移出队列，也可以「清空等待项」。失败或需要脚本授权时队列暂停，已经完成的项目保留；选择重试、允许脚本，或「跳过并继续」。取消当前安装后，会等后台操作结束再暂停。

队列未结束时，分享码、解析、导出和扫码入口会锁定。关闭设置面板后队列继续运行；刷新或关闭网页会丢失等待项，已经发出的安装仍可能在后台进行，重新进入后请重新解析。连接中断时队列先核对后台结果；提示「重新连接」时，点击它确认原操作后再继续。

面板底部的「逐项结果」会保留本浏览器最近 100 次已返回结果的操作，显示插件、时间、操作类型和结果。每次重试单独记录，重新解析、导出或刷新网页后仍可查看；「清空结果记录」只删除记录，不影响插件或队列。记录仅保存名称、安装规格和简短错误码，不保存分享码、配置或原始安装日志；它不代表插件当前状态，也不恢复刷新时尚未完成的操作。浏览器禁止存储时会提示结果仅在当前页面保留。

安装后重启 DSH；页面没有更新时，按 Ctrl+F5 刷新。

扫码支持清晰、正对的二维码图片。模糊、倾斜或过密的二维码识别失败时，请直接发送分享码。

提示「需手动更新」时

当前 DSH 无法在线替换已安装的插件。出现这个提示时，该条目不会加入队列；「全部可处理项加入队列」仍可处理其他插件。

Web 用户先退出对应的 DSH 实例，按该行显示的完整安装规格执行：

dsh plugin --profile web add "<完整安装规格>"

然后重新启动并解析。桌面用户请在应用内更新插件，再重启应用。

分享码未指定版本时，已安装的插件也会提示手动更新。新装 npm 包按默认标签解析；GitHub 按码里的分支、标签或提交安装，未指定则使用默认分支。

更新本插件

退出对应的 DSH 实例后执行：

dsh plugin --profile web update dsh-plugin-share
dsh --profile web

从 GitHub 安装的版本也使用这条命令更新。

使用须知

• 分享码只包含插件来源、版本和启用状态，不包含配置、API key 或 token。接收方需要自行配置插件。
• 支持 npm、GitHub 和 DSH 官方可选内置插件；导出时会跳过本地路径等不支持的来源，并显示数量。
• 分享码和二维码由浏览器与当前连接的 DSH 实例处理，不发送给第三方服务。扫码时，图片会在浏览器中缩放并转成灰度数据，再发送给该 DSH 实例识别；使用远程实例时，这些数据会传输到远程主机。安装插件时需要联网下载。
• 安装前请核对来源。分享码的校验只能发现数据损坏，不能证明插件可信；第三方插件可以执行代码。需要安装脚本的包会另行请求批准。
• 队列逐项处理，失败后暂停；之前成功安装的插件和启用状态变更会保留。
• 分享接口使用 DSH 的登录鉴权及 Host/Origin 校验，未登录的请求无法读取清单或安装插件。

开发

npm test                       # 自动测试
pnpm pack --dry-run            # 检查发布内容
npm run encode:example         # 生成示例分享码
node src/cli.mjs decode D1...   # 解码分享码

协议、字段和导入流程见 PLAN.md。CI 在每次 push 和 PR 时运行测试及打包检查。

相关

• DSH 插件开发文档
• dsh-market 插件市场

License

MIT