SuperAPI AI 工具集

soia-env-opencode-cli-install

部署与运维

查看项目

更新于 10-16 08:43

技能介绍

用途:帮助新手安装、检查、配置或按明确授权更新 OpenCode CLI(命令 opencode),并处理命令不可用、登录与配置问题。

主要能力:只读检测 opencode 的版本、来源、安装目录、配置覆盖路径及配置文件实际存在状态;从 anomalyco/opencode 官方 GitHub latest release 获取最新版;未安装时优先官方独立渠道,客户选择 npm 时使用 npm install -g opencode-ai,选择 Homebrew 时使用官方 tap;明确授权更新到最新后优先用当前绝对路径执行 opencode upgrade 并保持来源;验证 --version、--help 和无副作用启动;首次配置启动 opencode auth login,由客户在供应商官方页面完成 OAuth 或输入凭据,完成后运行 opencode auth list。

使用方式:客户说“安装 OpenCode”等即可,无需复制终端命令。Agent 先只读检查并展示计划;安装缺失 CLI 不授权更新已有 CLI;模糊“更新 OpenCode”只显示当前版与最新版,明确“更新到最新”才执行升级。回复以固定十列表格开头,只输出一行 OpenCode CLI。

限制:不接收、不回显 API key;不读取或记录 token、cookie、账号、私有路径;默认不调用产品自动更新器,只读检查不得修改 autoupdate 设置;优先用户级安装,不默认使用 sudo;更新失败保留原安装,不自动卸载、降级或重置配置;最新版取得失败写“未取得”,不猜测。~/.config/opencode 是配置候选目录,凭据通常由 opencode auth login 写入 ~/.local/share/opencode/auth.json,两者分开检查;默认配置文件不存在不等于安装失败。

安装命令:claude plugin marketplace add soia-team/soia-open-skills;claude plugin install soia-env@soia;或 npx skills add soia-team/soia-open-env-skills -g -a '*' -s soia-env-opencode-cli-install -y。WorkBuddy 需单独安装。