参考资料

本页提供中文索引。具体 API、配置字段和维护细节仍以英文 reference 页面为准。

配置

Configuration 记录可信 YAML 配置面,包括:

  • llm provider、model、API key 环境变量和 token 限制;

  • MCP servers;

  • context compaction;

  • Skills 目录;

  • Embodiment Profile 文件;

  • safety 和 base clearance;

  • Evaluation 的 required_tools、segment_tools、post_conditions。

API

API 按责任划分公开 Python 接口,包括:

  • Harness composition root;

  • model protocols 和 provider adapters;

  • Tool registry、schemas、Tool Result;

  • Observation、Scene Graph、Evaluation;

  • Memory、Skills、terminal runtime。

部署侧应依赖这些公开接口,而不是导入私有实现细节。

仿真

Simulation 描述可选 LIBERO 和 RoboTwin 2.0 适配器。 Thea 侧提供 Harness 侧适配接口;benchmark 环境、episode 和策略仍由部署侧 安装和管理。

飞书/Lark

Feishu/Lark 描述用户通道、授权、消息路由和交互 Tools。 默认 WebSocket 传输不需要公网 callback URL;Webhook 部署需要额外配置 verification token 或 encrypt key。

故障排查

Troubleshooting 覆盖常见启动和运行失败,例如:

  • 配置文件缺失或 YAML 无效;

  • 模型凭证未设置;

  • Lark app credentials 不完整;

  • 工厂函数导入路径无法解析;

  • evaluated Tool 没有返回 run_id;

  • 评估器或执行后 observation provider 未配置。

文档维护

Maintain the documentation 说明如何本地构建和发布文档站:

python -m pip install -r docs/requirements.txt
make -C docs html

文档构建将 Sphinx warnings 视为 errors,因此导航、include、链接和 theme 配置 问题会在发布前失败。