gabrielmoreira/agent-skills-mirror/install-acp-agent

在本机安装 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 对话/工具通过”“重启通过”。未执行、失败和待真机验证明确列出；版本输出或模拟器成功不能替代真机验收。