M0/S0 base + S1-A non-GUI slice (docs/S1-PLAN.md, docs/12):
- s100-readonly Helper profile (rejects run.*, real S100 inventory)
- device registration + SSH transport + host-key TOFU (OpenSSH-standard fingerprint, cross-process candidate)
- rdk-agent-host serve --stdio rename; packages/rdk-agent-surface (CLI device + MCP stdio, 2 tools)
- atomic cross-process approval consumption + idempotency flock takeover + approval crash recovery
Evidence: docs/testing/evidence/{M0,S1-A}.md
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>
推荐阅读顺序
- 产品需求
- RDK Studio 替代范围与差异化
- 与其他 RDK 项目的定位和边界
- 系统架构
- 领域模型与协议
- 技能生命周期
- 安全设计
- 实现计划
- Pi Agent 运行时设计
- 测试策略
- 当前 S100P 硬件基线
- 桌面产品体验设计
- 验收用例
- Claude Code 实施交接
- 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。真实硬件动作必须遵守 安全策略。