12 模块多 agent 并行开发(dev+test+fix 每,两层 + barrier):
- T06 PbaSession 事件溯源 + deriveMessages + logged 不变量
- T07 PbaEventBus typed event bus + waterfall + ScopeKey 隔离
- T08 能力接缝三角色(board-link + flash Provider/Registry/consumer)
- T09 compaction 完整工程(token-meter/pruner/summarizer/spill)
- T10 CI 质量门 + snapshot + doc-sync
- T11 类型镜像漂移检测(tsconfig.realpi + type-drift-check)
- T12 子代理 + 工作流编排(parallel/pipeline/InlineSubagentProvider)
- T13 上下文注入三段(inject/steer/followup)
- T14 plan/goal/todo checkpoint logged state(look-ahead 状态机)
- T15 profile/bundle 分层(维修诊断 vs 嵌入式开发,共享 base)
- T16 多 LLM provider 适配(ProviderRegistry + glm-5.2/deepseek)
- T17 审批接缝(fail-closed auto-deny)+ credentials/settings/lsp
集成(串行):
- src/index.ts 公共 re-export(board-link/flash 具名避 shared/types 重名)
- tests/system-integration.test.ts 跨模块 10 闭环(事件溯源→compaction→bus→
接缝→checkpoint→inject→workflow→approval→provider→profile)
- 全量 tsc=0;vitest 39 文件 2449 passed/5 skipped(1044 baseline +~1400 模块 + 10 系统)
- 密钥铁律:\${DROBOTICS_LLM_KEY} 占位,grep sk- 明文 0
68 workflow agent / 0 error / ~3M token;mutation 测试每模块 3-9 seeded bug 全杀。
Co-Authored-By: Claude <noreply@anthropic.com>
@d-robotics/physical-byte-agent
基于 pi 二开的嵌入式开发 Agent,默认模型 glm-5.2(经 d-robotics 内部网关)。
定位:在 pi 这个极简 agent harness 之上,加一层嵌入式开发场景必需的能力——持久 shell、PDF/datasheet 读取、硬件安全门、交叉编译、安全烧录、外设探测、JTAG 调试、设备树、板链路、物理信号验证、闭环编排——并根治 pi + glm-5.2 组合的两个独家命门。
两个命门
| 命门 | 现象 | 根治点 |
|---|---|---|
| 一·thinking 黑洞 | glm-5.2 默认开 thinking,max_tokens 全被 reasoning 吃光 → 零文本输出 | glm-provider.ts buildGlmModelConfig():thinkingFormat:"qwen" + maxTokens:8192 + thinkingLevelMap 全 null,触发 pi openai-completions 的 enable_thinking:false 分支 |
| 二·hex 强转 | glm-5.2 把寄存器地址 0x40020000 强转成十进制 "1073872896",下游写错地址即砖板 |
glm-provider.ts normalizeHexArg() / makeHexNormalizingPrepareArguments():在 prepareArguments 把寄存器地址范围内的十进制还原成 0x 形式 |
21 个域扩展
glm-provider · safety-gate · persistent-shell · pdf-reader · edit-strict · length-recovery · subprocess-isolation · env-probe · mcp-bridge · server-runtime · hardware-state · cross-compile · flash · peripheral-probe · jtag-debugger · device-tree · board-link · datasheet-rag · hardware-verify · loop-orchestrator · build-tracker
每个扩展文件 = pi glue(export default (pi) => {...})+ 纯逻辑命名导出(供单测)。详见 Docs/F01-F21。
用法
# 1. 装 pi(已 clone 到 ../pi)
cd ../pi && npm install --ignore-scripts && npm rebuild better-sqlite3
# 2. 配 key
export DROBOTICS_LLM_KEY=sk-...
# 3. 作为 pi profile 跑(pi 自动加载 src/extensions/index.ts barrel)
cd ../physical-byte-agent
npx tsx bin/pba.ts # 或 pi --agent-dir .
# 4. 程序化
import { PhysicalByteAgent } from "@d-robotics/physical-byte-agent";
const agent = new PhysicalByteAgent();
const { session } = await agent.launch();
测试
npm test # vitest 全量单测(mock ExecFn,无需硬件)
npx tsc --noEmit # 对真 pi 源码类型检查
设计取舍
- 逻辑/扩展分离 + 测试前置:纯逻辑内联进扩展文件并以命名导出,注入 mock
ExecFn单测,无需真实硬件即可严谨验证。这是 pi 自家coding-agent的同款分层。 - 单一 barrel 装配:pi 只加载
src/extensions/index.ts一个扩展,它依次装配 21 个子扩展——最大化内聚,避免散装。 - fail-closed:硬件判据默认拒绝/失败,不放过任何破坏性或不确定操作。
已知局限
length-recovery的partitionToolCalls需 patch pi agent-loop 源码(pi 扩展 API 够不着),本扩展只做 prompt 注入兜底 + events 握手。- 真板硬件侧集成(烧录/外设/物理信号)逻辑已单测,真 aarch64 板上端到端待跑。
Description
Languages
TypeScript
98%
JavaScript
1.7%
C
0.3%