dsh-plugin-share
Offline DSH plugin set sharing with a compact D1/NP1 code
Who this is for
- people browsing or managing plugins
Install
dsh plugin --profile web add dsh-plugin-share
Sandbox test results
| Stage | Result |
|---|---|
| T0 static check | — |
| T1 install | ✓ |
| T2 list | ✓ |
| T3 mount | ✓ |
| T4 boot | — |
Four stages run in an isolated sandbox: install (network on) → list → mount → boot (last three with no network).
README
<p align="center">
<img src="icon.svg" width="96" alt="dsh-plugin-share icon">
</p>
DSH Plugin Share
[English](README.en.md) | 中文
用分享码或二维码分享你的 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](PLAN.md)。CI 在每次 push 和 PR 时运行测试及打包检查。
相关
License
MIT
Rendered from the README published on npm. Formatted only, not edited.
Embed the badge
Two badges, each using its own site's identity: left is the **standard** (published by DSHIO), right is the **testing organization** (deepseekbase, which ran the inspection). Each links to the standard text and the test report.
Markdown（推荐，两个一起）
[](https://dshio.org/10/) [](https://deepseekbase.com/zh/plugins/dsh-plugin-share/)
Note: this is not a certification. DSHIO/T 32 is not in effect.
Versions
Published on npm:：4，最后更新 2026-10-22
Links
Frequently asked
dsh plugin --profile web add dsh-plugin-share in DSH, or paste the package name into the DSH Desktop plugin page.dsh --version), then look at the first error in the test-results section. If it still fails, open an issue on the repository.dsh plugin --profile web remove dsh-plugin-share.