gigo-lobster-doctor 综合评估
核心用法
gigo-lobster-doctor 是 GIGO 生态中的环境预检工具，采用"体检模式"而非完整基准测试。用户通过自然语言触发（如"龙虾体检""check lobster environment"），系统自动定位 wrapper 脚本并执行诊断。
推荐命令结构：
python3 /absolute/path/to/run_doctor.py --lang zh # 中文环境 python3 /absolute/path/to/run_doctor.py --lang en # 英文环境
诊断覆盖范围：
| 检查项 | 说明 |
|--------|------|
| Gateway 连通性 | 验证与 GIGO 服务端的基础网络通道 |
| Python/运行时依赖 | 检测解释器版本、关键包完整性 |
| 题包链路（task-bundle） | 确认题目资源拉取路径可用 |
| PNG 证书能力 | 验证报告生成所需的图像渲染环境 |
显著优点
1. 零风险预检：不执行正式 benchmark（15-25 分钟跑分），避免误触资源消耗
2. 智能语言适配：自动根据用户提问语言追加 --lang 参数
3. 流式进度反馈：长进程期间通过 tail -n 50 实时追踪 ~/.openclaw/workspace/outputs/gigo-lobster-doctor/gigo-run.log
4. 弹性失败判定：仅当进程非零退出、log 出现 traceback 或用户主动取消时才标记失败
5. 多源 Persona 继承：支持 CLI 参数 → 环境变量 → SOUL.md → 默认值的层级覆盖
潜在局限
- 诊断深度有限：仅验证"能否连通/能否渲染"，不覆盖 benchmark 本身的正确性
- PNG 证书硬依赖：若用户强制
--require-png-cert而环境缺失 Cairo/SVG 后端，体检将失败 - 上传行为静默：默认
--skip-upload，可能让用户误以为已注册设备
适合人群
- 首次配置 GIGO 环境的新用户，避免直接跑长 benchmark 遇阻
- CI/CD 集成场景，作为前置健康检查
- 排查网络/依赖故障的开发者，需快速定位 gateway 或题包链路问题
常规风险
| 风险类型 | 等级 | 说明 |
|----------|------|------|
| 命令注入 | 低 | 要求绝对路径执行，禁止 `cd && python` 模式 |
| 日志膨胀 | 低 | 需用 `tail -n 50` 而非全量读取 |
| 僵尸进程 | 低 | 显式要求 `process poll` 轮询直至 wrapper 退出 |
| 误报通过 | 中 | 体检通过不代表 benchmark 能通过 |
执行纪律要点
- 禁止使用
--help或切换至main.py - 禁止在静默期误杀长进程（15-25 分钟为正常耗时）
- 必须以最终 exit code 和 result files 作为完成判定，不得提前结束对话