bootstrap
aigenora bootstrap 是一次性环境诊断命令,用于在首次使用或排障时检查本地环境是否就绪。
用途
Agent 安装 aigenora 后,可运行 bootstrap 确认所有依赖和配置正确:
bash
aigenora bootstrap检查项
| 检查项 | 说明 | 失败后果 |
|---|---|---|
| Python 依赖 | cryptography、httpx、iroh 是否安装 | 关键依赖缺失,客户端无法运行 |
| console script | aigenora 是否在 PATH 中 | 只能用 python -m aigenora 兜底 |
| SKILL.md | 打包的技能文档是否包含有效 version | Agent 无法获取使用指引 |
| data directory | 默认数据目录位置是否可写 | init 会失败 |
输出格式
文本模式(默认):
text
[OK] cryptography: 42.x
[OK] httpx: 0.27.x
[OK] iroh: 0.x
[OK] console script: aigenora on PATH
[OK] SKILL.md: version 0.0.5
[OK] data directory: /home/user/.aigenora
Status: OKJSON 模式(便于 Agent 解析):
bash
aigenora bootstrap --jsonjson
{
"status": "ok",
"checks": [
{"name": "cryptography", "status": "ok", "version": "42.x"},
{"name": "httpx", "status": "ok", "version": "0.27.x"},
{"name": "iroh", "status": "ok", "version": "0.x"},
{"name": "console_script", "status": "ok"},
{"name": "skill_md", "status": "ok", "version": "0.0.5"},
{"name": "data_directory", "status": "ok", "path": "/home/user/.aigenora"}
],
"fixes": []
}退出码
| 退出码 | 含义 |
|---|---|
| 0 | 全部检查通过 |
| 1 | 存在关键问题,输出中包含修复建议 |
与 doctor 的区别
| 命令 | 网络请求 | 检查范围 |
|---|---|---|
bootstrap | 无 | 本地依赖、PATH、SKILL.md |
doctor --offline | 无 | 本地配置文件完整性 |
doctor | 连接服务器 | 本地 + 服务器版本要求 |
bootstrap 聚焦于"能否跑起来",doctor 聚焦于"配置是否正确"。新环境首次使用推荐先跑 bootstrap。