RDKCAD 代码优先 CAD Agent
状态:Alpha · FOUNDATION_READY for MVP foundation + CadScript 1.1 tested increment · CANDIDATE / NOT VERIFIED / NOT RELEASED · NOT RELEASE READY
CadScript 1.1 增量已在冻结提交 eeb136a 取得独立 PASS:结论只适用于已测语义、
Host 契约与三条公开 Web 样本。产品仍为 Alpha,不是 release ready;任何工件仍是
DRAFT/CANDIDATE · NOT VERIFIED · NOT RELEASED。
本仓库承载从 rdkrdk 迁出的自然语言 CAD / 仿真建模产品 Agent。产品能力不依赖某一个
Agent harness:Pi 与 DeepSeek Harness 是第一批 adapter,以后可以按同一 versioned runtime
contract 接入其他 harness。
第一版纵向切片
Web UI / CLI → shared RdkAgentService
↓ task-bound Runtime Contract 1.0
┌───┴──────────────┐
Pi adapter DeepSeek adapter
typed RDK tools reviewed Cordis typed tools
│ │
└──── Product Tool / Host boundary
↓
Python Host → restricted CadScript / optional engineering → Run / Artifact / Verifier
默认链路已经改为“自然语言 → CadScript 1.1 → 受限编译 → 源码 + STEP/STL 草稿”。普通建模不再
先要求 DeviceSpec、证据、接口/制造/仿真 Verifier;缺省尺寸可以是明确标记的可编辑 Agent 假设。
成功草稿直接成为 output_ready,统一显示 DRAFT · VERIFICATION NOT RUN · NOT RELEASED。旧的
DeviceSpec/CadProgram/仿真/制造流程保留为用户明确请求时才进入的“工程验证(可选)”。
Pi:接入钉版@earendil-works/pi-coding-agent@0.84.1,禁用 built-in tools,只注册共享 allowlist 中的 typed RDK 工具。真实 S600 Pi Web 任务已经从公共入口运行,保留了 task/session、 6 个 typed tool 调用、CAD Library 绑定和结构化澄清证据;该任务没有 Host Run/Artifact/Verifier, 也未覆盖用户回答、失败恢复和放行链,因此当前仍只能标记为CANDIDATE · NOT VERIFIED。CadScript 1.1:共享rdk_cad_draft_compile只解释 allowlisted AST,不执行 Python,并向后兼容 1.0 源码;除 box/cylinder、平移/旋转、union/cut、线性阵列和二维孔阵列外,新增沿局部 X 的 胶囊形slot、fillet、chamfer,后两者只接受all/parallel_x/parallel_y/parallel_z/top/bottom语义 selector。top/bottom按当前 B-Rep 全局 Z 极值选边,不暴露 OpenCascade edge index。每 turn 最多两次编译,单次 Host 上限 45 秒;解析、 几何或必要导出失败仍保留源码和精确诊断。独立增量验收已确认 1.0 兼容、 language/version-aware asset identity、完整 per-Run link、语义 media type 与 current-CAD lineage 契约在冻结样本中成立。DeepSeek Harness:接入官方@deepseek-ai/dsh-sdk-client@0.1.1-rc.2的显式 subprocess start/run/event/close 路径。独立 Cordis 插件把同一份共享 RDK allowlist 注册为 typed tools, 只转换 Harness 协议和生命周期;只有领域插件、生命周期入口、完整 Cordis composition、版本和 共享 allowlist 都通过本机 review preflight 时才 admissionsimulation_modeling。否则仍只允许runtime_probe,且其普通文本绝不能当作仿真完成。生命周期入口组合官方 JSONL persistence 与 checkpoint policy;SDK wire 没有 mid-turn cancel,因此“停止本轮”只终止该 task-owned runtime process,下一轮从最后一个官方 durable boundary 恢复,且不接受被终止 turn 的部分输出。该恢复 会在 spawn 前用官方 JSONL snapshot/inspect 核对 session/cwd/log,并只允许 pinned officialdsh-jsonrpc-agent启动形态。review/admission 与伪造 lineage 的确定性独立定向测试已通过;首次 live DeepSeek Web Journey 暴露了无总时限、失败 Run 表述和运行中状态投影缺陷。 后续 fresh live 的 route/deadline/无虚假成功均成立;五旅程 J5 又发现一次 malformed CadScript 返回精确 Host 诊断后没有真实纠错、第二模型步骤耗尽 480000ms 的缺口。当时的插件 0.2.6 / runtime 0.2.3 已把失败压缩为带 Run/Artifact 血缘的correction_required,在同一 Harness session 内只给 一次带 remaining budget 的真实纠错机会,并以 240000/240000/60000ms native-turn phases 防止无 进展循环;相同 compile action 在 Host 副作用前拒绝。独立 J5 定向复测已用重新审核的 plugin 0.2.6 / lifecycle 0.2.3 完成 1/1 fresh public-Web 样本:同一个官方 Harness session 在首个有效 CadScript 后产生 STEP/STL,绑定 reviewedbattery_tray,运行 MuJoCo 3.12.0 1000/1000 步,并由cad.target_identity:1.1.0的四项 evidence-only 断言确认对象身份;刷新恢复了 54 events、16 artifacts、trajectory 与 lineage,结果仍为CANDIDATE · NOT VERIFIED。由于本样本首个 CadScript 有效,conditional correction、changed retry fingerprint 和 identical-actionno_progress_rejected均未触发,不能声称这些分支已有 live 证据,也不能据此升级 FOUNDATION_READY 或发布状态。 CadScript 1.1 的模型指令与 reviewed plugin 入口字节变化后,领域插件版本已升为 0.2.8(runtime 仍为 0.2.3);旧 review 必须重新生成。重新审核后的冻结样本已独立验证 DeepSeek 创建、 同 task 编辑及 CAD→MuJoCo 公开 Web 链路。- Runtime 在任务创建时绑定;本版不支持同一私有 session 原地切换 harness,也没有 handoff。
RdkToolDefinition、Host NDJSON client、工具 allowlist、Host policy 与 Verifier 都只有一份共享 事实源,不在 adapter 内复制领域规则。- Web UI 使用稳定的
/tasks/:taskId地址,任务、消息、canonical events 和 Artifact 都从本机 Gateway / Host 的服务端事实恢复;右侧成果看板默认折叠,明确区分候选输出与 Verifier 放行。 MuJoCo 实验:产品 Agent 可把一个新生成器件与已有器件的固定装配交给共享 typed tool;Host 自动绑定当前 task 最新 CAD Run,直接消费其原始 STEP,并以parent_run_id、cad_artifact、mujoco_target.json、接纳后的 DeviceSpec、lineage 和 evidence-only identity Verifier 保留同一受测 对象血缘。钉版mujoco==3.12.0和真实mj_step生成 MJCF、组合 STL、solver trajectory、接触/ 稳定性指标。Web 只从 task-owned Artifact 回放这些状态,统一标为CANDIDATE · NOT VERIFIED,不把一次求解称为物理校准、结构验证或发布放行。d-cloud/rdk-agent等外部仓库永远只读参考。本仓库通过自己的公共 API / plugin contract 与 它们配合,不在外部仓库内落代码、文档、测试或集成修改。
安装与构建
需要 Node.js >=22.19.0、Python >=3.10,以及 uv。
npm install
uv sync
npm run build
uv run ruff check packages plugins
uv run mypy
这些静态检查不能替代产品真实旅程。不同于开发 Agent 的独立测试 Agent 已在新仓重新建立并 保留定向测试资产,而不是从旧仓复制测试、Fixture、eval 或历史成功证据。Harness 迁移证据见 迁移独立测试报告;Web UI 的首次 失败、产品修复与独立复测见 Web UI 独立验收报告; 设置中心的凭据安全、桌面/移动真实旅程和一次 P1 修复复测见 设置中心独立测试报告。
公共入口
Web UI(首选演示与调试入口)
启动仅监听本机回环地址的 Gateway;命令会先构建 Web 所需 workspace,终端需要保持运行:
npm run web
浏览器打开 http://127.0.0.1:4173。开发模式可运行 npm run web:dev,前端地址为
http://127.0.0.1:5173,API 仍由本机 Gateway 提供。
需要一个长期运行、可在局域网分享、但不自动刷新浏览器的开发入口时,运行:
npm run web:share
它默认使用稳定端口 4174,打印本机 URL 与带随机访问令牌的局域网分享 URL。源码变化后会在
后台串行重建并重启 Gateway;已经打开的页面不会被 HMR 或 reload 打断,用户在合适时手动刷新
同一 URL 才加载新版本。分享 token 会换成 HttpOnly/SameSite=Strict cookie 并从地址栏移除;
停止并重新运行命令会轮换 token,使旧链接和旧 cookie 失效。共享认证和共享写请求的脱敏审计
保存在 $RDK_STATE_DIR/audit/web-share.ndjson。这是局域网能力,不是公网发布方案。
当前 Web UI 包含任务列表、稳定任务 URL、主 Chat、依据 runtime capability 投影的停止本轮/继续,
以及非运行、未取消会话菜单中的“取消整个任务”。后者经确认后保留会话与全部证据,将任务置为
不可继续的 terminal cancelled;它与永久清理 Agent 会话记录的“删除会话”是两个独立操作。
中间工坊会同时显示 CadScript 源码与最新 3D STL 候选;代码/Artifact/Evidence/Activity 看板按需
展开。
左下角“设置”可打开稳定 /settings 页面配置
Base URL、API 协议、API Key、主模型、备用模型和新任务默认 Agent Runtime;Runtime 选择只在
设置中心出现,任务入口不重复放置配置控件。密钥由本机 Gateway 写入 ~/.rdk/.env(0600),
Runtime 默认项写入服务端 settings/runtime.json(0600),读取接口不回显密钥。两类设置均只
对之后的新 Agent 会话生效,已有 task-bound session 和正在运行的 turn 不热切换。它是 Alpha
入口:web:share 只提供局域网令牌分享,不是多用户权限系统或公网发布能力;也不能把任何
DRAFT/CANDIDATE · NOT VERIFIED/UNKNOWN 当作制造放行。
任务行的三点菜单可以删除 Agent 会话。删除会先停止活动 runtime,再清理本地对话、选择回执、
canonical runtime events 和 task-private Pi session;持久 tombstone 让旧 API 返回 410 Gone。
Host Task、Run、Artifact、CAD Library、任务工作区 outputs 与已发生的外部副作用继续保留。任务
创建支持 clientRequestId 幂等;Web 自动生成,CLI 可用 --client-request-id 在重试时复用。
CAD Library 默认持续保存在 ~/.rdkcad/state/cad-library:files/<asset-id>/ 是供用户直接使用
的 STEP/STL/报告目录,内部 objects/ 保存内容寻址原件。每次 Agent 生成的完整 CAD bundle 还会
同步到该任务的 workspaces/<workspace-id>/outputs/<asset-id>/runs/<run-id>/,同 asset 的不同 Run
不会互相覆盖;顶层 asset.json 只记录全局首次来源。Web 的 CAD Library 可以统一搜索
Agent 生成与联网发现/导入的 CAD、下载原始文件,并把内容寻址引用交回 Agent 使用。可通过
RDK_CAD_LIBRARY_DIR 和 RDK_WORKSPACE_DIR 改变两个根目录;Web、CLI 与 Host 必须使用同一配置。
左侧“MuJoCo 实验”工作区显示当前任务最新的完整 MuJoCo Run:新生成/已有器件角色、真实 solver
轨迹播放/暂停与时间轴、接触峰值、稳定性和倾角,以及只读 CAD target/DeviceSpec/assembly 标识、
参数假设与局限。IDENTITY BOUND 只表示原始 STEP 身份已绑定,不表示物理可信。刷新稳定 task URL 后会从
Host Artifact inventory 恢复,而不是依赖浏览器临时状态。第一版只支持固定装配整体作为自由刚体
的下落/接触/稳定性模板;每个部件使用 AABB 碰撞近似。首次安装或升级后必须重新运行 uv sync
以安装 MuJoCo 原生 Python wheel;DeepSeek 操作方还需按新插件版本和共享 allowlist digest 重新
生成 review,旧 review 不会静默继承新增工具权限。
CLI
先查看 adapter 的真实能力:
npm run describe-runtimes
Pi 仿真任务需要配置真实模型凭据(环境或 ~/.rdk/.env)并完成 Python 安装:
npm run agent -- run --runtime pi --profile simulation \
--workspace-root /absolute/workspaces \
"生成一个 40x20x3 mm、四角带孔的可编辑支架草稿"
DeepSeek 的互操作探针只要求显式 JSON-RPC runtime 命令;仿真建模还要求匹配当前插件与完整 Cordis composition 的审核清单。命令使用 JSON 数组传递,不经过 shell 拆词:
export RDK_DEEPSEEK_COMMAND_JSON='["/absolute/path/to/rdkcad/node_modules/.bin/dsh-jsonrpc-agent","/absolute/reviewed-cordis.yml"]'
export DEEPSEEK_API_KEY='...'
npm run agent -- run --runtime deepseek --profile runtime-probe "确认 harness 会话可工作"
完整的 Cordis row、review manifest、摘要生成、失败关闭矩阵和仿真配置见
DeepSeek Cordis typed-tool 插件配置。review 完全匹配后可从与
Pi 相同的 Web 新任务入口选择 DeepSeek,也可用 CLI --runtime deepseek --profile simulation。
Web 与 CLI 调用同一个 RdkAgentService。服务在创建持久任务前检查 profile admission 和配置,
避免一个被拒绝的 simulation 请求产生持久副作用;canonical events 写到权限收窄的
task-owned event log,输出明确区分 typed product result 与 harness probe。
文档
- Requirement Brief
- 架构
- DeepSeek Cordis typed-tool 插件配置
- DeepSeek Cordis typed-tool 插件定向测试报告
- DeepSeek Cordis live Web Journey 首次失败报告
- DeepSeek Cordis live Web Journey 第二轮失败报告
- DeepSeek Cordis live Web Journey 第三轮失败报告
- DeepSeek Cordis normalized-claim live Web 配置漂移报告
- DeepSeek Cordis final fresh public-Web E2E 失败报告
- 五旅程首次公共审计报告
- J1/J3/J4 独立定向复测报告
- DeepSeek J5 独立定向复测报告
- 2026-09-05 五旅程 FOUNDATION 审计
- Foundation P1 第一轮定向复测
- Foundation P1 第二轮定向复测
- Foundation P1 第三轮定向复测
- Foundation P1 第四轮定向复测
- CadScript 1.1 增量最终独立复测
- ADR-001:harness-neutral runtime
- 迁移清单
- 独立测试报告
- Web UI 独立验收报告
- 许可证与第三方声明
2026-09-06 CadScript 1.1 增量验收
最终独立复测在 eeb136a 的冻结产品内容上给出 PASS,已测范围包括:
- CadScript 1.1 的
slot实体/cutter/旋转/圆形退化、fillet/chamfer语义 selector、 负例诊断与 1.0 源码兼容; - Host Library 的 language/version asset identity、per-Run link、Artifact media type、current-CAD lineage,以及慢终态唯一 identity Verifier 和四进程 JSON 并发原子写;
- Pi 公开 Web RT-12 壳体样本,DeepSeek 公开 Web 创建+同 task 编辑样本,以及同一 DeepSeek
task 的固定装配 CAD→MuJoCo 样本。后者使用 MuJoCo 3.12.0 完成 200/200 steps,
sim.cad_target_identity以evidence_only通过四项 lineage 断言,刷新后恢复任务、两版 CAD、 trajectory、metrics 和身份信息。
FF-004、FF-005、RF-002、RF-003 和 RF-004 的首次 FAIL 仍保留在分阶段独立证据中;它们分别由
后续产品提交与复测逐项关闭,没有被最终 PASS 覆盖。几何与公开产品旅程已在上述样本边界内
验证,但工件本身没有经过工程或制造验证;MuJoCo identity Verifier 只证明 CAD parent/digest/
DeviceSpec/solver lineage,不证明物理真实性、适配、强度、可打印性、可制造性或真机行为。
2026-09-05 FOUNDATION_READY 证据摘要
首次五旅程审计保留了原始 PARTIAL/FAIL,随后四轮独立定向复测逐项关闭 P1。当前组合证据为:
R-A 覆盖 Pi 的澄清、用户选择、停止、同 session 恢复、两版 CAD 与刷新;R-B 覆盖安全输出与放行分离;
R-C2 覆盖 DeepSeek 私有未截断 observation 到 Host 权威 cad_draft.json 的结果投影;R-D4 覆盖能力缺口
候选可见与中英文 trust-claim 失败关闭;R-E 覆盖当前 CAD、已有 reviewed component、MuJoCo Run 和
evidence-only identity 血缘。由此,首个 MVP Agent 基座达到最小 FOUNDATION_READY。
这里的 FOUNDATION_READY 只表示上述样本和契约证明公共 Web 入口、Pi/DeepSeek runtime、任务/会话、
介入恢复、Artifact、轨迹、Host 重校验和安全候选输出已形成可用闭环。所有成果仍是
CANDIDATE · NOT VERIFIED · NOT RELEASED;它不等于发布、制造、HIL、物理校准、全量回归或多样本稳定。
明确未完成
- DeepSeek JSONL/checkpoint 冷恢复、停止本轮后继续以及 review/config/route/cwd 漂移门禁尚未完成 独立定向测试和 Web 重启旅程,不能因开发静态检查通过而声称可发布。
- 跨 harness handoff。
- Web UI 仍缺少独立用户身份、细粒度资源授权、TLS 公网分享和审批/用户选择的完整入口;当前
web:share只有可轮换的局域网会话令牌。TUI/MCP 尚未重新接线。 - 发布门禁与全量回归、HIL/真机和制造资格、经认证的公网分享与多用户授权、多样本模型稳定性仍未完成; TUI/MCP 也尚未接入当前共享基座。
- MuJoCo 的物理参数可信校准、复杂非凸碰撞分解、紧固件失效/结构破坏、关节控制/RL 和发布级 验证均未实现。J4 Pi 与 J5 DeepSeek 各有 1/1 定向 public-Web CAD→MuJoCo 样本,但这不是物理、 制造、稳定性矩阵或发布级验收。
- 已迁入
plugins/rdk_s100,让 Device Helper 的s100-readonly动态入口与静态类型闭包 自洽。它仍只是 S100/S100P probe 与 capability provider,尚未完成真机验证,不能用其 仓库存在、可导入或静态检查结果声称真机能力成立。
当前结论来自分阶段且不替换首败的证据:2026-09-04 的 J1/J2/J3/J4/J5 样本提供前置覆盖,
2026-09-05 的 R-A/R-B/R-C2/R-D4/R-E 关闭最小基座门禁。它们足以支持样本边界内的
FOUNDATION_READY,但没有覆盖 J5 conditional correction/no-progress、release suite、制造/HIL、
authenticated public sharing、完整 TUI/MCP/handoff、物理参数校准、全量回归或多样本稳定性。因此
仍不能声称完整产品验收或 release ready,也不能把任何 STL、STEP、预览、MuJoCo 轨迹或模型文本
称为可制造、物理可信或已验证结果。