用途:为不熟悉终端的用户安装、检查、更新并配置 lessweb/deepcode-cli(命令 deepcode,npm 包 @vegamo/deepcode-cli),这是面向 DeepSeek 模型优化的社区开源 Agent CLI,不是 HKUDS、Snyk 或其他同名 DeepCode 产品。
主要能力:核对项目身份、Node.js 22 与 npm 后安装上游包;从 npm 官方元数据比较版本,明确授权后更新;检查非秘密模型与地址设置并保护 API key;命令不可用时排查 PATH、npm 全局目录和同名命令。
使用方式:Agent 先只读检查 deepcode、Node.js、npm、包来源与版本,再展示计划。安装请求只授权安装缺失 CLI,已有版本默认不更新;模糊「更新」只显示版本,明确「更新到最新」才执行 npm install -g @vegamo/deepcode-cli@latest。未安装时执行 npm install -g @vegamo/deepcode-cli。Node.js 低于 22 时先报告阻塞,不运行安装包。
配置:~/.deepcode 只是默认数据目录,必须同时检查 ~/.deepcode/settings.json;目录存在不代表 API key 已配置。客户在 DeepSeek 官方平台自行创建 key,只在本机填写,不发到聊天。最小非秘密结构为 env 下的 MODEL、BASE_URL、API_KEY。无 key 时 CLI 会提示 API key not found,此时运行状态写「未验证」或「等待本地配置」,不伪报成功。
限制:优先用户级 npm prefix,不默认 sudo;更新前记录旧版本,失败保留旧安装,不自动卸载或降级;安装不得改写项目 package.json 或 lockfile;项目 .deepcode/settings.json 可能进入 Git,禁止写入密钥;不记录 token、key、账号、提示词、代码内容或私有绝对路径。
安装技能本身: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-deepcode-cli-install -y。WorkBuddy 需单独安装。