docs(v3): 进度表同步 — T06–T17 全 ✅,M1/M2/M3 全落
Some checks are pending
CI / quality-gate (push) Waiting to run
CI / type-drift (push) Waiting to run

P1+P2 12 模块开发完成后的文档对齐(doc-sync 精神):
- 进度表 T06–T17 ⏳ → ✅,各填落地说明 + 测试数
- 里程碑 M1 可长跑 / M2 可维护 / M3 可扩展 全 ✅
- 头部进度行更新至 2449 单测全绿

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
d-robotics 2026-08-14 15:39:29 +08:00
parent 6d6a805d46
commit 68d8567ad9

View File

@ -3,7 +3,7 @@
> 项目:`@d-robotics/physical-byte-agent`(pi 二开嵌入式硬件闭环 Agent)
> 路径:`/Users/d-robotics/Desktop/physical_byte_agent`
> 当前版本:v2 重构完成(commit 06a19a6,21 域扩展,732 单测,tsc 0 错,离线装配冒烟 21 工厂)
> v3 P0 进展(2026-08-14):**T01-T05a + T05b 全部落地**;1044 单测全绿,tsc 0 错。详见第七部分进度表。
> v3 全程进展(2026-08-14):**P0(T01–T05b)+ P1(T06–T11)+ P2(T12–T17)全部落地**;39 测试文件 2449 单测全绿(1044 baseline + ~1400 模块 + 10 系统集成),tsc 0 错,68 workflow agent 并行开发。M0/M1/M2/M3 全 ✅。详见第七部分进度表。
> 本版本:v3——嫁接 dsh 八条工业骨架到 pi 扩展底座,补齐致命差距,迈向"能安全跑通嵌入式闭环"
> 文档日期:2026-08-14
> 文档目的:从顶层架构一路拆解到一堆具体的、可执行、可验证的开发任务,并在底部维护进度
@ -748,27 +748,27 @@ T11(类型漂移) ────────────────────
| T04 五段工具流水线 | P0 | T07 | ✅ (①②wired/④⑤tested) | (本批) | `src/core/tool-pipeline.ts`(ToolPipeline 五段+单调 guards+decide();24 测试,含单调不变式元蜕变);safety-gate tool_call 钩子委托 pipeline.decide()(stage①②真 wired);flash finalizeFlashContent 导出(content-only);注:stage ④⑤全 agent-loop wiring 受 pi 扩展 API 在 tool_call 仅能 block 之限,pipeline 自身已实现+测试,未假装 |
| T05a board-side 沙箱(脚本模拟) | P0 | T08 | ✅ | (本批) | `src/core/sandbox-policy.ts`(probeSandbox full/partial/unusable + applySandboxToArgv + shouldRunCommand,Object.freeze 单一 home);board-link makeExec 包 argv + fail-closed(unusable→exitCode126 不 spawn);159 测试(EP/边界/决策表/状态转换/变异/对抗/元蜕变) |
| T05b board-side 真 landlock-run | P0 | T05a | ✅ 源码+契约验证 / ⏙ 待交叉编译 | (本批) | `native/landlock-run/landlock-run.c`(C11,raw syscall self-restrict-then-exec,fail-closed exit126,--probe exit 0/1/2 映射 capability)+ Makefile(cross-aarch64 musl 静态)+ README;sandbox-policy.ts 加 probeViaBinary + board-link resolveBoardSandbox 接真二进制优先;macOS stub 编译+--probe exit2 + -- exec 契约测试通过;aarch64 真二进制需 toolchain(本机无 aarch64-linux-musl-gcc/docker)跑 `make cross-aarch64` |
| T06 PbaSession 事件溯源 | P1 | 无 | ⏳ | - | - |
| T07 PbaEventBus + ScopeKey | P1 | 无 | ⏳ | - | - |
| T08 能力接缝三角色(board-link+flash) | P1 | 无 | ⏳ | - | - |
| T09 compaction 完整工程 | P1 | T06 | ⏳ | - | - |
| T10 CI 质量门 + snapshot + doc-sync | P1 | T01 | ⏳ | - | - |
| T11 类型镜像漂移检测 | P1 | 无 | ⏳ | - | - |
| T12 子代理 + 工作流编排 | P2 | T07/T08 | ⏳ | - | - |
| T13 上下文注入三段 | P2 | T06/T07 | ⏳ | - | - |
| T14 plan/goal/todo logged state | P2 | T06 | ⏳ | - | - |
| T15 profile/bundle 分层 | P2 | T08 | ⏳ | - | - |
| T16 多 LLM provider 适配 | P2 | 无 | ⏳ | - | - |
| T17 审批/LSP/credentials/settings | P2 | 按需 | ⏳ | - | - |
| T06 PbaSession 事件溯源 | P1 | 无 | ✅ | 2026-08-14 | `src/core/pba-session.ts`(PbaSessionEventMap + append 唯一提交点 lossless-JSON+深冻结+seq 连续+重入 guard + deriveMessages 增量缓存 + replayFromEntries 推广自 hardware-state + assertModelVisibleLogged 不变量);74 测试 |
| T07 PbaEventBus + ScopeKey | P1 | 无 | ✅ | 2026-08-14 | `src/core/pba-event-bus.ts`(PbaListener(args,next) + waterfall 链委托/短路 + emit 并行广播 + ScopeKey 单向冒泡子→父不串 + KNOWN_EVENTS typed 名);79 测试 |
| T08 能力接缝三角色(board-link+flash) | P1 | 无 | ✅ | 2026-08-14 | `src/capabilities/{board-link,flash}/{types,index,providers/*}.ts`(BoardLinkProvider/FlashProvider Definition + Registry register/resolve fail-closed + 3 板 provider + 4 烧录 provider 抽自原扩展);321 测试 |
| T09 compaction 完整工程 | P1 | T06 | ✅ | 2026-08-14 | `src/compaction/{token-meter,tool-result-pruner,summarizer,spill}.ts`(estimateTokens + i2cdump/gdb/dmesg prune 寄存器地址不丢 + KV prefix reuse 标记 + SpillStore branded 句柄 recall/evict);113 测试 |
| T10 CI 质量门 + snapshot + doc-sync | P1 | T11 | ✅ | 2026-08-14 | `.github/workflows/ci.yml`(per-file 覆盖门+doc-sync+type-drift)+ `scripts/{e2e-snapshot,doc-sync}.ts`(compareSnapshot 结构化 diff + checkDocSync 锚点对齐,readFile/grepSymbol 注入);135 测试 |
| T11 类型镜像漂移检测 | P1 | 无 | ✅ | 2026-08-14 | `tsconfig.realpi.json`(paths 指真 pi 源码)+ `scripts/type-drift-check.ts`(checkTypeDrift 跑 tsc 分流 pbaErrors vs piInternalErrors,runTsc 注入);79 测试 |
| T12 子代理 + 工作流编排 | P2 | T07/T08 | ✅ | 2026-08-14 | `src/capabilities/{subagent,workflow}/index.ts`(InlineSubagentProvider spawn-in-process + SubagentRegistry + parallel barrier/null-on-throw + pipeline 无 barrier stage 抛错落 null + MAX_CONCURRENCY);102 测试 |
| T13 上下文注入三段 | P2 | T06/T07 | ✅ | 2026-08-14 | `src/core/context-injector.ts`(inject 不唤醒 / steer 换板 next-step 唤醒 / followup next-turn 唤醒 + deriveActiveContext 最新 snapshot 取代更早);82 测试 |
| T14 plan/goal/todo logged state | P2 | T06 | ✅ | 2026-08-14 | `src/core/checkpoint-state.ts`(CheckpointRecorder record 写 checkpoint-change 事件 + current/rebuild 从 log 重建 + fork;look-ahead 状态机 passed 推进下一 pending 步,done passed 置终态);92 测试 |
| T15 profile/bundle 分层 | P2 | T08 | ✅ | 2026-08-14 | `src/profiles/{base,repair-diagnosis,embedded-dev,index}.ts`(BASE_PROFILE 共享 + 两 profile 叠差异 + mergeProfiles/diffProfiles + resolveProfile fail-closed 防 prototype 污染);114 测试 |
| T16 多 LLM provider 适配 | P2 | 无 | ✅ | 2026-08-14 | `src/core/provider-registry.ts`(ProviderDescriptor + buildProviderConfig 泛化 glm/deepseek + ProviderRegistry + DEFAULT_GLM_DESCRIPTOR + KNOWN_PROVIDERS);115 测试;换模型改配置不改扩展 |
| T17 审批/LSP/credentials/settings | P2 | 按需 | ✅ | 2026-08-14 | `src/capabilities/{approval,credentials,settings,lsp}.ts`(ApprovalGate fail-closed 无人值守 auto-deny + CredentialsStore env/memory 不落盘+redact + SettingsStore typed + NoopLspBridge stub);94 测试 |
## 里程碑
| 里程碑 | 范围 | 目标 | 状态 |
|---|---|---|---|
| M0 安全跑通 | T01/T02/T03/T04/T05a/T05b | 能 boot(真 createAgentSession 离线✅) + 不砖板(devmem 硬门+hex 联动+reg 工具) + 安全门结构化(五段流水线①②wired) + 板侧沙箱(landlock-run C 源+契约✅) | ✅ P0 全落(T05b aarch64 真二进制待 toolchain 编译) |
| M1 可长跑 | T06/T07/T08/T09 | session 事件溯源 + typed events + 接缝 + compaction | ⏳ |
| M2 可维护 | T10/T11 | CI 门 + snapshot + 漂移检测 | ⏳ |
| M3 可扩展 | T12-T17 | 子代理 + profile 分层 + 多 provider | ⏳ |
| M1 可长跑 | T06/T07/T08/T09 | session 事件溯源 + typed events + 接缝 + compaction | ✅ 全落(74+79+321+113 测试) |
| M2 可维护 | T10/T11 | CI 门 + snapshot + 漂移检测 | ✅ 全落(135+79 测试;ci.yml 接 type-drift + doc-sync) |
| M3 可扩展 | T12-T17 | 子代理 + profile 分层 + 多 provider | ✅ 全落(102+82+92+114+115+94 测试) |
## 下一步动作