选择正确的安装方式。

通过链接安装社区插件

1. 在插件作者页面选择已构建的固定版本发布包，优先复制 Release 附件的 HTTPS 下载链接。
2. 打开 DSHA → 插件市场 → 粘贴链接，检查识别出的来源。
3. 点击安装，等待下载、包校验和依赖准备完成；有错误时点开完整错误信息。
4. 安装成功后到启动页重启 Web，再回到插件管理检查状态并验证实际功能。

支持 GitHub 仓库、分支/子目录、Release 附件，以及 ZIP、TAR、TAR.GZ、TGZ 压缩包。复制时只保留一个链接。普通源码仓库不一定包含可安装产物。

网络受限时

先下载插件包，再在 DSHA 的插件市场选择“导入插件包”，通过系统文件选择器读取文件。已安装插件可以导出，供备份或另一台 DSHA 导入。

npm 发布的插件

在 DSHA 终端使用下面格式，并将作者、插件名和版本替换为真实发布值：

普通 npm install 不会自动登记 dsh 插件。安装器不执行包的 prepare、build、install 脚本，发布包必须事先构建。

添加 Agent Skill

技能是带 SKILL.md 的目录。请先下载并解压本站技能包，再通过 DSHA 可访问的文件管理入口放入以下位置：

例如手机命令操作技能的完整路径是 /root/.agents/skills/device-shell/SKILL.md。项目专属技能也可以放在实际项目根目录的 .agents/skills/ 中。

1. 保持“技能名称/SKILL.md”这一层目录结构，避免重复嵌套压缩包文件夹。
2. 使用支持技能的 Agent preset，例如 standard；自定义或 minimal preset 可能没有技能提供器。
3. 目录通常自动更新。新建会话，要求 Agent 使用该技能先做只读验证；未发现时检查路径、文件格式与 preset。

技能包不能通过“导入插件包”安装。不要把手机内的目录路径当作 Windows 电脑上的文件路径。

管理已经内置的插件

rc1.1 包含设备操作引导、任务完成通知、实时悬浮状态与移动端界面四个内置插件。

1. 进入 DSHA → 插件管理，按名称查找需要调整的插件。
2. 使用开关启用或禁用。系统通知、悬浮窗、ADB 等授权需分别完成。
3. 到启动页重启 Web，再验证对应功能。

内置插件通过开关管理；官方核心随 dsh 环境更新。当前网站不会读取你手机的插件状态或桥 token。