dsh-market

目录与来源

市场从 https://awesome-dsh-plugin.com/plugins.json 读取目录，内容包括 curated 条目、npm 映射和 Star，每日由 CI 刷新；网络不可用时使用内置快照。只有 registry 中列出的来源可以安装。若插件发布到 npm，市场优先使用 tarball，并与源码仓库校验；仅有 GitHub 来源的插件取决于到 GitHub 的连接。

安装与更新

设置页支持搜索、分类筛选、Star 数、top/new 排序、双语说明和截图。打开安装对话框后，截图才从 GitHub 加载；截图可由作者通过 registry 提供，也可从 README 提取。安装前会确认来源并显示进度。多数插件在刷新页面后生效；本次会话安装的插件可实时卸载。

更新检查支持 npm version，或比较固定的 commit 与 HEAD，可逐个更新，也可全部更新。pnpm 10 及以上版本默认阻止 build scripts；是否放行由每个 package 单独确认。缺少 pnpm 时，界面可检测并提供自动设置。

备份与诊断

可把 profile 的插件列表和配置导出为可读 JSON，或从另一台机器导入；也可使用 WebDAV 每日自动备份。恢复会先校验，写入失败时回滚。备份可能含有 credentials。WebDAV 只接受 HTTPS，拒绝 private-network 地址，且不会把密码存入浏览器。

诊断页展示插件加载顺序、bundle stack、官方或社区标记、重复 loader、依赖版本不一致、多个 core package 版本、overrides 和无效配置项。日志导出为脱敏纯文本，会遮盖 home 路径和 credential 形状，不会发送到其他地方。

重启行为

无法热加载的变更会显示待处理提示，并可能提供重启操作。重启请求必须是 same-origin POST，且客户端必须直接来自 loopback；转发请求会被拒绝。替代进程沿用原有 DSH entry、arguments、environment 和 working directory。若由 systemd、launchd 或 pm2 管理，应设置 allowRestart: false。