Codex 806cc0b24a
Some checks failed
ci / python (pull_request) Has been cancelled
ci / typescript (pull_request) Has been cancelled
test(sim): independent SIM-R2 suite (AT-038..041) + final verdict evidence
Test-agent authored: unit (templates/virtual_api/program/verifier_image),
contract (host sim RPC frame round-trips), integration (sim_run incl. bpu
approval flow and crafted-manifest fail-closed), golden sim_r2 section
(SIM-R1 section byte-unchanged), acceptance AT-038..041. Final verdict:
SIM-R2 acceptance passed; D1/D-SIMR2-1/D-SIMR2-2 closed via 1132760/59130c7/
7b85af6. 836/836, core branch coverage 96.35%.
2026-08-27 18:50:25 +08:00

RDK Agent

RDK Agent 是一个面向高校学生和个人开发者、基于 Pi coding agent 的 下一代 RDK 开发环境。产品目标是替代 RDK Studio:从系统准备、设备连接、项目开发和调试,到 Agent 编程、结果验证和作品复用,都可以在同一产品中完成。

同一个 Pi Agent Runtime 同时提供四种一等入口:GUI 完整工作台、TUI 终端交互、CLI 脚本化任务,以及供 Claude Code、Codex 等其他 Agent 调用的 MCP stdio Server。Desktop Alpha 优先适配 macOS arm64 和当前网线直连的 S100P;Linux 先用于 CI/headless 验证,Windows/Linux GUI 后续补齐。

它首先运行在用户电脑上,连接个人 RDK 开发板;用户既可以像使用完整开发环境一样编辑代码、管理文件、打开终端/串口和发起烧录,也可以描述想做的作品,让 Agent 根据实际硬件边做边讲:

  • 自动发现开发板、系统、BPU、Camera/USB 与机器人软件能力;
  • 推荐“现在就能做”的项目,并说明缺少哪些外设;
  • 编写、解释、同步、运行和调试 Python/RDK 程序;
  • 直接展示图片、推理结果和状态,用验证器说明为什么成功;
  • 把成功作品保存成可再次运行、可修改和可分享的 DIY Project Pack;
  • 在非 root、不改系统、不碰无安全工装执行器的边界内探索真实硬件。

用户只需提供设备连接方式并核验首次 SSH host key,不需要维护硬件清单。Agent 会通过受控只读 Inventory Engine 自主盘点板型、系统、BPU、USB/Camera、驱动与软件栈;所有结论都引用探针证据,未知项不会由模型猜测。

核心体验是 Prepare → Connect → Discover → Build → See → Learn → Remix:完整承接传统桌面工作台,再用可信盘点、Agent 闭环、结果验证和作品复用形成代际差异。

本仓库处于 Specification First 开发方式:文档是规范来源。M0 实现中(第二轮评审后):仓库骨架、rdk_agent_core 领域/协议/策略层、host/device/CLI 包、fake device 全链路、钉版 Pi SDK(@earendil-works 0.84.1)TS 运行时、ScriptedModel 确定性闭环。当前唯一执行目标是确定性 fake device,尚不构成可运行产品能力;状态与证据见 M0 验收证据。

目标代码仓库:D-Robotics Gitea / rdkagentsun。本地 main 基于目标仓库现有历史维护,禁止强推或覆盖远端提交。

构建与验证(M0)

uv sync                                   # Python 工作区(3.10+,uv 管理)
uv run pytest                             # 全部单元/契约/集成/验收/属性测试
uv run ruff check packages plugins tests  # lint
uv run mypy packages/*/src plugins/rdk_s100/src  # 类型检查(strict)
cd packages/rdk-agent-pi && npm ci && npm run build && npm test  # TS 包(Node >=22.19.0)

# fake device 演示(rdkctl,JSON envelope 输出)
uv run rdkctl agent ping
uv run rdkctl device inventory --device-id fake-001
uv run rdkctl run plan --device-id fake-001 --workspace ws1 \
  --manifest '{"name":"hello","entrypoint":{"type":"python","path":"src/main.py"}}'
uv run rdkctl run start --request-id demo-1 --plan-id <plan_id>
uv run rdkctl run events --run-id <run_id>

推荐阅读顺序

  1. 产品需求
  2. RDK Studio 替代范围与差异化
  3. 与其他 RDK 项目的定位和边界
  4. 系统架构
  5. 领域模型与协议
  6. 技能生命周期
  7. 安全设计
  8. 实现计划
  9. Pi Agent 运行时设计
  10. 测试策略
  11. 当前 S100P 硬件基线
  12. 桌面产品体验设计
  13. 验收用例
  14. Claude Code 实施交接
  15. CLI/TUI/GUI/MCP 接口规范

完整索引见 文档地图。Claude Code 的工程约束见 CLAUDE.md。

分阶段范围

  • 首个完整目标设备:当前已连接的 RDK S100P 裸板;非端侧主机通过网线直连,设备的精确 RDK OS/内核/BPU runtime 由首次只读快照冻结,不凭文档预设;
  • Agent 框架:Pi coding agent SDK + 受审查的项目本地 Pi package;
  • 产品形态:CLI、TUI、GUI 和 MCP 共用一个 Pi Runtime;rdkctl 保留为底层诊断/恢复工具;
  • Agent 边界:local-first、单用户、单设备优先;核心 Runtime 位于非端侧,PC 与云不形成两种 Agent;
  • 连接拓扑:个人电脑通过局域网直连 SSH;托管、多租户和 relay 不进入当前产品路线;
  • 接入方式:SSH stdio/文件传输,不要求设备开放新的网络端口;
  • 语言:Pi Agent/Extension 使用 TypeScript,RDK 控制与设备侧使用 Python 3.10+;
  • MVP 作品:系统健康卡、静态输入 BPU 示例推理、USB 摄像头快照;当前无舵机,GPIO/PWM/执行器在具有明确安全套件前保持不可用;
  • Alpha 垂直切片:macOS arm64 + S100P + SSH,跑通 GUI/TUI/CLI/MCP、可信盘点和 Agent 项目闭环;
  • 替代版本:补齐 Windows/macOS/Linux、主流 RDK 板型,以及 SSH/Type-C/串口、烧录、网络、项目、编辑器、文件、终端、远程观察和模型配置;
  • MVP 复用资产:本地 DIY Project Pack,只做 draft → verified-local → shareable;社区市场、签名和集中审核后移。

非目标

不包含 Agent 自主烧录、无人值守修改 bootloader、Agent 任意 apt/systemd/网络修改、直接驱动无安全套件的 GPIO/舵机/电机/机械臂、模型训练平台、多 Agent、托管多租户、远程中继,以及自动发布未验证经验。用户显式发起的烧录、网络配置、人工终端和文件操作属于替代产品的必要能力,与 Agent 权限分离。

项目状态

实现按 S0–S6 计划推进。当前先完成 S0 的生产入口和原子幂等修复,再进入桌面垂直切片与 S100P 真机连接;通过 替代矩阵前只称 Alpha/Preview。真实硬件动作必须遵守 安全策略。

Description
No description provided
Readme 3 MiB
Languages
Python 85.4%
TypeScript 14.4%
JavaScript 0.2%