# 插件安装、更新与分享

本页描述当前 DSH **0.2.0-rc.2** 的 DSHA 入口。具体应用版本和本轮已执行的验证范围见 [README](../README.md) 与对应交付报告；旧设备报告不能作为新包的验收回执。

在插件市场粘贴链接、从系统文件选择器导入本地包，或使用网站提供的 DSHA 唤起链接。应用解析实际包，核对格式、路径、包名/版本、实际依赖与摘要，再由插件事务提交并启用。现行正式插件无需原生审阅确认。网站浏览本身不会安装插件；只有用户主动打开安装入口才会继续安装。启停和更新后按应用提示重启 Web。

## 支持的来源与包契约

- GitHub 仓库简写 `owner/repo`、仓库 URL、SSH 地址、tree/blob 子目录链接，以及 archive/codeload/Release 附件。
- Release 页面仅有一个支持的压缩包时可直接解析；有多个候选时选择实际附件链接。
- HTTPS ZIP、TAR、TAR.GZ、TGZ，以及 npm 插件包名；包含多个链接的分享文字须先选择目标。
- 本地导入按实际内容识别格式；文件扩展名和 Provider MIME 不能代替内容核验。系统 DocumentsUI 不可用时可选择其他文件选择器。

`package.json` 必须有合法 npm 名称与版本，符合当前 bundle 声明，并有实际存在的 patch 和入口。普通 npm 库不会因名称包含 dsh 自动成为插件。归档不得通过越界路径、包外链接、同名冲突或缺失入口绕过检查。展开及下载限额以当前应用实际检查为准，超限会报告原因。

优先使用作者构建好的 Release 或 npm pack 发布包。Android 容器为 Linux arm64/glibc；依赖包含原生模块时，需要适配该运行环境。声明兼容版本、作者测试和本机实测分别记录，不能把作者说明当作依赖内容或设备可用性证明。

## 依赖、脚本与实际权限

正式依赖安装允许未锁定重解析，使用随包 pnpm 10.34.5 的生产依赖安装；依赖的 `postinstall`、build 等生命周期脚本以及 pnpmfile 可以运行。安装会保存实际锁与目录摘要，后续复用/恢复检查真实历史内容。旧锁不会强制种入新的在线候选；离线恢复不在原件中重新解析依赖。

拉取 npm 包时的 `npm pack --ignore-scripts` 只是只读下载阶段的限制。通常使用只含依赖声明的临时 manifest 准备依赖，这时不执行插件源码自身的 scripts；复用作者原生锁的路径会使用原 manifest。因此不能笼统承诺“不执行安装脚本”，也不能把包下载阶段的参数当作最终安装权限。

插件、脚本和普通终端均在应用 UID 下运行，可读取和修改该 UID 可访问的内容；proot/proroot 不是第三方恶意代码的独立沙箱。包与事务检查提供内容和回切保证，不是对作者代码的安全认证。实际设备操作仍经当前原生能力授权和执行侧策略。请依据真实来源选择第三方代码。详细边界见[安全模型](security-model.md)。

## 提交、失败和用户意图

安装先准备候选，记录原件、固定目标、前后摘要与实际依赖，再切换安装目录。未提交日志受维护门禁保护；恢复必须按本次记录核对进程退出和目录身份。已提交的旧日志不能回滚后来修改的用户数据。失败候选、未知原件和历史依赖不会由临时目录清理隐式删除。

生命周期脚本已经运行后发生网络错误，不自动改源重放安装。取消、超时或无法确认退出时保留对应现场和屏障；完整断电、Android 文件系统和设备行为仍按独立验收记录声明。

同名更新保留用户主动禁用和安全模式意图；升级只移除旧版自动审阅标记。系统插件从当前签名 APK 的受管证明重建，与用户源码和依赖分层。启停、来源信息和实际加载结果以插件管理及启动诊断为准。

## 导出、删除与终端

插件导出包含所选用户插件的真实源码、已有依赖和绑定关系。系统插件字节由当前 APK 提供，用户备份只保留其启停意图。内容未完整、未知或有依赖警告时如实报告，不能改成“完整通过”。

删除第三方插件会移除该插件安装与登记，保留聊天、配置、其他插件、共享依赖与外部导入源。需留存时先导出。内置可选组件使用开关，官方核心由受管环境更新，不由第三方包替换。

普通终端可以使用 `npm` / `npx`，与插件安装共用随包 CA 和 RuntimeTools 环境：

```sh
npm install 包名
npm install -g 工具包名
dsha-plugin install @作者/插件@1.0.0
```

普通 `npm install` 不自动修改 DSH 启用列表；`dsha-plugin` 通过当前插件入口处理实际候选。不要用裸 shell 修改事务现场来绕过维护屏障。

## 验证入口与限度

相关宿主回归包括 `tools/test-plugin-dependencies.py`、`tools/test-plugin-transactions.py`、`tools/test-plugin-downloads.py` 和真实锁定运行时的原生插件管理测试；完整门禁入口见[接手指南](接手指南.md)。每次交付报告记录实际运行命令和结果。本页不宣称已完成所有远程源、第三方代码、手机覆盖安装或掉电矩阵。