SuperAPI AI 工具集

soia-env-pi-cli-install

编程与开发

查看项目

更新于 10-16 08:49

技能介绍

用途:安装和验证 Pi(@earendil-works/pi-coding-agent,命令 pi)。该工具是极简终端编码助手,可在本地运行 AI agent,管理多个 AI CLI 的凭据、执行历史与并行协作。需注意它不是 Qwen/DeepCode 或其他同名工具。

主要能力:核对项目身份、Node.js 与 npm 环境后安装上游包;从 npm 官方元数据比较版本,在客户明确授权后沿 pi update --self 更新;检查 ~/.pi/agent/settings.json 的 provider/model 设置;命令不可用时排查 PATH、npm 全局目录与同名命令冲突。

使用方式:Agent 先确认为 @earendil-works/pi-coding-agent,再只读执行 python3 scripts/inspect_cli.py --json 检测 pi、版本、路径与来源,执行 python3 scripts/check_latest.py --json 获取最新版;未安装时执行 npm install -g @earendil-works/pi-coding-agent,明确要求更新到最新时才执行 pi update --self(或 npm install -g @earendil-works/pi-coding-agent@latest),最后验证 --version 与 --help。安装请求仅授权安装缺失 CLI,已有版本默认不更新;模糊的“更新”只显示版本。npm 全局目录需管理员权限时优先用户级方案,不默认 sudo;不使用 Git 仓库开发安装。

凭据与限制:settings.json 只保存非秘密配置,API key 不写入该文件,应通过环境变量(如 DEEPSEEK_API_KEY)或 pi auth 在本机安全配置,不发送到聊天或日志。项目内 .pi/settings.json 可能进入 Git,禁止写入密钥。首次启动不会生成含凭据的 settings.json,目录存在不代表 provider 已配置;未配置凭据时运行状态写“未验证”,不伪报正常。安装不得改写项目 package.json 或 lockfile,失败时保留旧安装,不自动卸载或降级。

安装本技能可参考:npx skills add soia-team/soia-open-env-skills -g -a '*' -s soia-env-pi-cli-install -y;整域安装用 claude plugin marketplace add soia-team/soia-open-skills 与 claude plugin install soia-env@soia。WorkBuddy 需单独安装,见 docs/install/workbuddy.md。