用途:把一台机器或容器从零配置为可用且经校验的 coding-agents-kit(ak)环境。适用条件:用户需要安装、配置、检查、修复或升级 ak,或需要运行该套件的 Dockerfile/compose 文件。不用于启动智能体(那是 agentkit 技能)、不修改自身权限、不安装用户未要求的软件。
主要能力:通过只读辅助命令完成探测与渲染,包括 ak setup probe、ak setup verify、ak setup docker。探测返回 os、arch、libc、container.detected、wsl、root、python.ok、tools、install.found、env_file、profiles、clis、posture_hint、problems 等 JSON 字段,据此选择流程:已安装走验证修复或升级;Windows 走 PowerShell 流程;需要容器配方走容器流程;Linux/macOS/WSL 走主机流程。libc 为 musl 时停止;python 低于 3.9 时停止。
使用方式:先克隆固定标签并探测,示例命令:git clone --branch v0.5.0 https://github.com/DailybotHQ/coding-agents-kit;python3 coding-agents-kit/lib/ak.py setup probe --json。主机安装:bash coding-agents-kit/install.sh --no-rc(或经用户同意后去掉 --no-rc)。容器配方示例:python3 coding-agents-kit/lib/ak.py setup docker --ref v0.3.0 --sha256 8c163a81fa31151cd577797f07cfbe3e61dad49ff691de0b6d5de0975f1cc8ca --format dockerfile --cli claude。验证示例:ak setup verify --cli claude --profile claude=@work --keys ZAI_CODING_API_KEY --expect-posture ask。流程以 probe 开始、verify 结束;每项变更前需征求用户同意;密钥只写变量名,存放于 ~/.config/agentkit/env(权限 600)或容器环境/密钥,从不读取、回显或记录密钥值。
限制:仅使用固定发布标签,不用分支或 latest;容器配方需携带发布 tarball 的 SHA256,不凭空生成摘要;容器和脚本使用 --no-rc;一次一个流程,步骤幂等;未获同意不改 shell rc、不装系统包;autonomy 由用户选择,不用 --ask 或 AGENTKIT_PERMISSIONS=ask 之外自行添加标志。平台为 musl、python 过旧、主目录不可写、摘要缺失或不匹配、检查需要用户登录或提供密钥值时,如实说明并停止,不绕过验证。