在本机安装 ACP 助手
由已经可用的小万执行安装。使用 skills_read 加载本技能后,通过 terminal_execute 在当前设备的内置 Linux / PRoot 环境执行;不把安装转移到开发者电脑,也不要求尚未安装的目标助手安装自己。
1. 确认目标与环境
用户提供的命令是待核对的安装材料。确认目标助手、官方来源、期望版本;未指定版本时查当前官方支持版,不把本技能编写时的版本固定为永久默认。 通过 terminal_execute 执行本技能 scriptsDir 下的 inspect-runtime.sh,读取实际输出。该脚本只检查系统、架构、包管理器和运行时,不下载或修改配置。另检查目标启动命令是否已存在,保留已有安装、配置和历史。 完成条件:知道实际发行版、CPU、Node/npm 是否可用,以及缺少的依赖;不能把 Android PRoot 当作独立 Linux 内核。
2. 核对官方安装说明
读取目标项目当前官方 README、发布说明及 ACP adapter 文档,确认包名、维护者、版本、Node engines、CPU、musl/glibc 和认证方式。普通聊天 CLI 不一定支持 ACP;必须核对官方 ACP 启动方式,不猜测 --acp 参数。 优先使用官方安装器或包管理器。若官方不支持当前环境,说明具体不兼容项,不伪造兼容成功。DSH 的运行时、ACP profile 和 Cordis 插件是不同层级;需要插件时读取实际安装版本自带的 README,不将其解释为 OmniFlow 函数。 完成条件:有可追溯官方来源和适合当前设备的安装命令。
3. 分步安装并诊断
先补齐缺失的运行时,再安装 ACP adapter。仅在确认发行版后使用对应 apk 或 apt-get;检查现有版本,避免重复安装。每次 terminal_execute 等待真实 exitCode、stdout/stderr/errorMessage,再决定下一步,不并发执行相互依赖的步骤。 下载失败时分别检查目标域名解析、HTTPS 连通性、设备时间、证书和当前代理设置。不要打印完整环境、密钥或认证头。手机不能直接使用电脑的 127.0.0.1 代理地址。连接重置、超时、证书错误、包不存在和架构错误必须分别报告,不能一律要求重装。 不要通过关闭 TLS 校验、清除 App 数据、卸载 App 或默认完全访问来让安装通过。PRoot 不提供独立内核,安装成功也不能证明 Landlock 等隔离能力可用。修复明确原因后再重试,保留失败步骤和脱敏错误。 如果终端工具本身无法启动,明确停在基础环境阶段,引导用户从现有终端环境设置修复;不能声称已经执行安装命令。 完成条件:包管理器成功且实际启动文件存在,或明确报告阻塞阶段和证据。
4. 保存用户可编辑方案
在当前用户工作区保存本次安装记录:官方来源、实际安装版本、发行版/架构、安装命令、启动命令、参数、工作目录、必要环境变量名称、验证结果。不将密钥写入记录;凭据沿用用户已有模型配置。 只在用户指定的独立目录保存可编辑安装脚本,避免覆盖托管安装器或内置技能。重复运行前检查已有版本和配置。不要擅自改 App 私有注册表;如果当前工具没有注册 ACP 助手的能力,提供已验证的启动命令、逐项参数和环境变量名称,引导用户在“Agent mode → +”现有自定义入口保存。明确这一手动边界,不声称已自动注册。
5. 验证后报告
依次验证实际版本、官方 ACP initialize、App 内真实对话及一次无副作用工具调用。复用 App 的现有 Conversation → Session → Turn 生命周期,不建立第二套 Agent loop。 退出并重新打开目标助手,确认启动配置和用户文件保留,重复同一操作。DSH 持久插件必须使用上游支持的 profile/持久机制;动态 Cordis 定义不能当作重启后仍可用。 分别报告“依赖已安装”“ACP 握手通过”“App 对话/工具通过”“重启通过”。未执行、失败和待真机验证明确列出;版本输出或模拟器成功不能替代真机验收。