01 · Octos 最小工具闭环与目录验收
日期：2026-07-19
一、背景
本轮工作的目标不是直接验证真机动作，而是为“杨铮负责的 Octos 编排层”先拿到一个可信的最小成功样本：确认 Octos 可以在本机跑通一次从中文请求到本地工具调用的真实闭环，并梳理这个 demo 对后续技能接口设计的意义。
本次实际验收工作区为：
/Users/ken/robot-octos-demo
最终归档目录位于：
/Users/ken/chaofeng/docs/src/yangzheng/
二、核查过程
1. 先确认项目形态
核查后确认：
/Users/ken/robot-octos-demo顶层不是 Git 仓库；- 顶层存在本地技能目录
.octos/skills/robot-pick-skill； - 系统安装了
octos 2.0.0，命令位于/opt/homebrew/bin/octos； - 顶层还附带嵌套源码副本
octos-src。
这说明它是一个“系统 Octos + 本地 skill + 嵌套源码”的 demo 验收目录。
2. 先验证技能入口本身
直接执行：
printf '{"object":"ball","location":"floor"}' | skills/robot-pick-skill/main pick_object
返回：
success: true
Simulated robot successfully picked up ball from floor.
因此可以先排除“技能入口脚本损坏”的可能。
3. 再验证真实 octos chat
第一次在项目内使用新的 --data-dir 运行 octos chat 时，遇到错误：
no LLM provider configured
随后显式追加：
--config "$HOME/.config/octos/config.json"
第二次运行成功，模型调用了：
pick_object(object="球", location="地上")
最终返回中文答复“已经帮你把球从地上捡起来了！”。
4. 最后补一层源码检查
在 octos-src 中执行：
cargo check --locked -p octos-cli
检查通过，说明 demo 附带的上游源码副本至少在 octos-cli 维度是可构建的。
三、当前结论
1. 这次成功说明了什么
已经可以确认：
- 本机 Octos 环境可用；
- 本地 skill 发现机制可用；
- 中文自然语言到本地工具的最小闭环可用；
- 这个 demo 可以作为后续接口规范设计的起点。
2. 这次成功不说明什么
仍不能据此宣称：
- 真机移动编排已经完成；
- 真实 VLA 推理已经接入；
- 视觉判定与重试闭环已经完成；
- 复合任务 planner 已经稳定可用。
这次只是把“编排能不能起得来”这件事先做实了。
四、对后续工作的直接影响
后续更值得推进的方向有三项：
- 从
pick_object这种最小 schema 出发，设计移动 / 操作 / 复合任务三类接口； - 规范项目级
data-dir、config、profile 和 skill 安装关系； - 为未来 mock -> 仿真 -> 真机替换保留统一的工具输入输出契约。
五、相关证据
/Users/ken/robot-octos-demo/reports/evidence/environment.txt/Users/ken/robot-octos-demo/reports/evidence/project-initial-audit.txt/Users/ken/robot-octos-demo/reports/evidence/octos-chat-robot-pick-config.txt/Users/ken/robot-octos-demo/reports/evidence/cargo-check-octos-cli.txt