参考资料¶
本页提供中文索引。具体 API、配置字段和维护细节仍以英文 reference 页面为准。
配置¶
Configuration 记录可信 YAML 配置面,包括:
llmprovider、model、API key 环境变量和 token 限制;MCP servers;
context compaction;
Skills 目录;
Embodiment Profile 文件;
safety 和 base clearance;
Evaluation 的
required_tools、segment_tools、post_conditions。
API¶
API 按责任划分公开 Python 接口,包括:
Harnesscomposition 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 配置 问题会在发布前失败。