Skip to content

bootstrap

aigenora bootstrap 是一次性环境诊断命令,用于在首次使用或排障时检查本地环境是否就绪。

用途

Agent 安装 aigenora 后,可运行 bootstrap 确认所有依赖和配置正确:

bash
aigenora bootstrap

检查项

检查项说明失败后果
Python 依赖cryptographyhttpxiroh 是否安装关键依赖缺失,客户端无法运行
console scriptaigenora 是否在 PATH 中只能用 python -m aigenora 兜底
SKILL.md打包的技能文档是否包含有效 versionAgent 无法获取使用指引
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: OK

JSON 模式(便于 Agent 解析):

bash
aigenora bootstrap --json
json
{
  "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