gigo-lobster-doctor 综合评估
核心用法
gigo-lobster-doctor 是 GIGO（Garbage In, Garbage Out）框架下的预检诊断工具，专为「龙虾」系列测评任务设计。用户通过自然语言触发（如「龙虾体检」「check lobster environment」），系统将自动定位 wrapper 脚本 run_doctor.py 并执行 Python 环境扫描。命令遵循 python3 /absolute/path/to/run_doctor.py --lang zh|en 的严格格式，避免使用 cd && python 组合以兼容 OpenClaw 预检机制。
诊断覆盖四大维度：
- Gateway 连通性：验证网络层与 API 入口可达性
- Python/运行时依赖：检查解释器版本、关键包完整性
- 题包链路：确认任务数据集（task-bundle）下载与解析通道
- PNG 证书能力：检测图形渲染证书生成环境（优先 PNG，支持 SVG fallback）
显著优点
1. 零侵入预检：不执行完整 benchmark（15-25 分钟），15 秒内完成环境基线确认，节省用户时间。
2. 多语言自适应：依据触发语言自动追加 --lang 参数，降低国际化使用门槛。
3. 流式反馈：执行期间通过 process poll + tail -n 50 实时回传进度，避免大日志淹没对话窗口。
4. 灵活 Persona 配置：支持 --lobster-name/--lobster-tags 自定义、环境变量注入及 SOUL.md 回退，满足品牌化需求。
潜在缺点与局限性
- 非全面测评：仅做「体检」不做「试吃」，无法暴露运行时性能瓶颈或算法正确性问题。
- 路径硬约束：要求绝对路径调用，相对路径或
cd前缀可能触发 OpenClaw 拦截。 - 平台依赖：虽声明支持 darwin/linux/win32，但
python3/python/py优先级策略在 Windows 下可能因 PATH 配置差异而失效。 - 日志监控盲区：长运行时依赖外部轮询，若
gigo-run.log轮转或权限异常，可能误判静默为卡死。
适合人群
- 测评任务开发者：在正式提交前快速验证 CI/CD 环境配置。
- GIGO 平台新用户：首次配置 lobster 工作流，需确认本地环境就绪。
- 运维/技术支持：排查「题包下载失败」「证书生成异常」等前置环节故障。
常规风险
| 风险点 | 说明 |
|--------|------|
| 路径注入 | 若 `--output-dir` 接收未校验的用户输入，可能导致目录遍历。建议仅接受白名单路径或强制沙箱内运行。 |
| 日志敏感信息 | `gigo-run.log` 可能包含 API key、本地路径等，需确保 `~/.openclaw/workspace/outputs` 权限 700。 |
| 长进程误杀 | 用户或上层系统可能因 stdout 静默而强制中断，违背「15-25 分钟不 kill」原则，需明确提示等待。 |
| 依赖冲突 | 系统级 `python3` 与虚拟环境版本差异可能导致检查通过但正式运行失败，建议优先使用 containerized 环境。 |
> 安全等级说明：技能本身为只读诊断，无网络外连上传（--skip-upload 为默认），无代码执行权限扩大，风险可控。