2026-09-14 15:40:10 +08:00
## 2026-09-14 — Excel 排产模板与数据采集模板合同收口
- **类型**： （ ； ）
- **排产工作簿合同**：新增 `server/aps_domain/report_contracts.py` ，用数据结构声明 `schedule-plan.v1` / `schedule-order.v1` / `schedule-equipment.v1` / `schedule-blocked.v1` 的工作表、中文表头、类型与单位、表头行、数据起始行、冻结窗格、筛选区域与每列取值来源；`build_plan_report`、工单导出、设备导出和阻断工作簿统一引用同一合同，并在生成后用 `validate_workbook_contract` 复核，合同不一致直接失败而不是产出看似正常的文件。
- **边界与确定性**：无柔性版本时保持显式空态（`xlsxBytes`/`filename` 为 `None` ）；有版本、无工单时产出阻断清单；工作计划表补上 ZIP 归一化，使同一输入重复导出字节一致。导出返回值新增 `templateId` /`templateSchemaVersion`，既有字段与 Sheet 位置不变。
- **采集模板**：新增 `server/importers/template_workbook.py` ，由当前工作簿配置生成 `intake-template.v1` ： ， ； `requiredColumns` ，配置错误显式拒绝，旧配置省略该字段时按“全部可选”加载。新增 `GET /api/import/template` （带 `ETag` 与 profile/template 头，未注册 profile 返回 404） ； `profileId` 时模板跟随 `APS_WORKBOOK_PROFILE_DIR` 的兼容默认配置，唯一 `compatibilityDefault` 优先、目录仅一份配置时直用、默认标记缺失或重复时显式报错。
- **主对话排产合同**： `readiness.query` 复查，资料已采用时必须调用 `flex.schedule` 出草稿试排」；只给齐备度结论、补齐建议或「暂不建议排产」记为错误回答；真实阻断项必须写进试排假设与未安排说明，不得改写成「资料未通过检查，不能排产」。合同由 `test_primary_brief_pins_explicit_scheduling_contract` 锁定。
- **失败可诊断与超时预算**：闸 1 默认 90s → **180s** （ `APS_FALLBACK_*` 说明）——真实 LLM 多步工具调用实测 45~80s， ， ） ， ， `harness_error` 原语义。
- **采集模板条件请求**： `If-None-Match` 返回 304， ； （ `test_intake_template_contract_matches_the_authorized_workbook` 校验。
2026-09-14 20:34:48 +08:00
- **排产模板定义可下载**：新增 `build_contract_template` 与 `GET /api/reports/schedule-template` ，把 `schedule-plan.v1` / `schedule-order.v1` / `schedule-equipment.v1` / `schedule-blocked.v1` 直接导出成表头骨架（标题行、表头行、冻结窗格、筛选区域，无业务行），生成后仍由 `validate_workbook_contract` 复核，现场下载的模板与真正导出的文件共用同一份声明；响应带 `ETag` / `X-APS-Template-Id` / `X-APS-Contract-Digest` ，支持 304，
- **采集说明补全填写定义**： ， （ ， ； ） ， ； `intake_definition_rows` 从配置生成，模板与解析器不得各写一套。
- **导出下载鉴权修复**：柔性工作台的「订单方案」「设备方案」原先用 `href` 直开 `/api` 链接，浏览器带不上鉴权头；现与采集模板一致改走 `downloadAuthenticatedFile` ，下载失败时显示后端原因而不是 401 页面。
2026-09-14 15:40:10 +08:00
- **验证**： `test_schedule_exports.py` + `test_workbook_profiles.py` + `test_fallback_lane.py` 共 **56 passed** ； **2382 passed / 53 skipped** （ ， `ROUND87_SOURCE` ） ； **103 passed** ； （ ） ；
2026-09-14 20:34:48 +08:00
- **模板定义复核（同轮追加）**：排产模板与采集说明改为可校验定义后重跑——`test_schedule_template_contract.py`（含 4 份合同骨架、模板接口 304/404、采集说明取值定义） ， `test_schedule_exports.py` + `test_workbook_profiles.py` 共 **41 passed** ，导入/主数据/合同相关 9 个文件 **85 passed / 2 skipped** ，配置可移植性与文档漂移 **500 passed** ； **2386 passed / 53 skipped** （ ， ） ； **105 passed** （新增 `tests/node/schedule-template-download.test.mjs` ） ； ； （ ， ） ： **1 passed** 、新增的排产模板下载 **1 passed** （ ） ， ，
- **真实工作簿闭环**：外部指定的参考工作簿（`湖南锐扬APS精简演示数据.xlsx`，路径只由调用方提供，不写入仓库）跑真实 Pi/LLM E2E **1 passed** （ ， （ （ ） ， **1 passed** （ **429 账号欠费** （
- **真实 Pi 验收补跑（仅切换模型端点）**：工作区 `.env` 的 Moonshot key 仍欠费停用（ ） ， `.env` **，只在调用方进程环境把 `LLM_BASE_URL` /`LLM_API_KEY`/`LLM_MODEL` 指向本机另一把可用的 OpenAI 兼容端点（ `Pro/moonshotai/Kimi-K2.6` ）复跑：真实 Pi CLI + 真实工作簿 E2E **1 passed** （ `planning-schedule-entry.spec.ts` **3 passed** （桌面 2.6m、移动 2.1m、新项目导航 1.1m）——导航用例的明细按钮断言原写前端兜底文案「产品和材料」，真实 Pi 路径来自服务端口径「产品和物料」，已改为两者兼容；模板下载 `intake-template-download.spec.ts` 、`schedule-template-download.spec.ts` 各 **1 passed** 。默认 `.env` 是否切到该端点需交付方确认，本轮未替用户改配置。
- **导出下载回归用例**：新增 `apps/web/e2e/flex-export-download.spec.ts` ——用真实接口铺「导入 → 采用 → 排产」，再点柔性工作台「订单方案 / 设备方案」， `X-APS-Visitor-ID` 头（旧的 `href` 直开导航给不出该头，桌面/头鉴权部署只会拿到 401） **1 passed（ ） ， **1 passed** 。
- **意图识别确已下线**： `assistant.reply` + `_piPrimary` ， （ `tests/golden/test_pi_primary_chat.py -k routes` **2 passed** （「分析一下数据文件」「根据这些数据排产」两条真实说法都直达 Pi）
2026-09-14 15:40:10 +08:00
2026-09-08 00:07:26 +08:00
## 2026-09-04 — Pi Agent 外向接入 P0/P1 真实接通（/api/agent/* + Agent Token + Pi E2E）
- **类型**： （ ）
- **服务端**：新增 `server/gateway/agent_api.py` ，注册 `GET /api/agent/intents` 、`GET /api/agent/intents/{name}`、`POST /api/agent/invoke`；目录收口为显式 19 项只读白名单（含 `query.kpi` ；排除会写主干/知识库/报告的 `data.analyze` /`folder.analyze`/`report.generate`），不再自动投影 `_POWER_MAP` P0； `CONFIRM_REQUIRED` ， `POWER_DENIED` ，未登记返回 `INTENT_NOT_REGISTERED` ，全部 fail-closed 并写 AGENT DENIED 审计。
- **凭证**：新增 `server/auth/agent_tokens.py` 与 `scripts/pi_agent_token.py` （ ） ； ， `/api/agent/*` 的 Bearer 先行鉴权。
- **Pi 客户端**： `~/.pi/aps.json` 、`< PI_CODING_AGENT_DIR > /aps.json`、`APS_CONFIG_FILE` 与环境变量优先级，
- **验证**： `33 passed` ；隔离 APS（ ） `APS_E2E_CONFIG_FILE_ONLY=1` E2E： ， `/api/agent/*` 在 `APS_AUTH_ENABLED=0` 且无 Bearer 时返回 `AGENT_TOKEN_REQUIRED` ，只读目录不再暴露 `data.analyze` /`folder.analyze`/`report.generate`。
- **边界**： ） ，
## 2026-09-04 — Pi Agent P4/P5 协同收口（ ；
- **类型**： （ ； ）
- **做了什么**：
文档，保持既有治理边界。
- **验证**： （ ） ；
`test_fallback_p4_injection.py` （ ） ；
`test_fallback_p4_offline.py` （ ） ；
**197 passed / 1 skipped in 51.87s** ； **All checks passed** 。
唯一 skip 为 Windows junction/symlink 环境显式跳过。
- **收口**： （ ） ；
FB-03-BUG-1 修复记录转 GO。真实 S6 24/24/S7 12/12 未在本轮重跑，依据
CHANGELOG 顶部修复记录与 smoke 结果文件复核。
- **边界**： `LLM_*` /`APS_FALLBACK_*`；
PENDING_SYNC 自动补推、per-step/token 指标、runId 过滤等另立后续任务。
- **发布动作**：无 commit/push/merge/publish；
---
## 2026-09-04 — FB-03-BUG-1 修复： （
- **类型**：
- **做了什么**：修复 P3 验证判定的唯一卡点 FB-03-BUG-1（ ） ： `offlineBooking: true` ，出卡闸与执行端双重实时探测（`_probe_mes_connectivity() == "failed"`）核验断连事实后，`apply_report(offline_booking=True)` 跳过 post_report 本地落账， `syncStatus=PENDING_SYNC` 可识别标记；确认卡摘要明示「⚠ MES 断连：本地落账待同步」（审批人知情）；恢复后对账报告逐行呈现 PENDING_SYNC（ ） （ ，
- `mes.py` `apply_report` +keyword-only `offline_booking=False` （默认）：在线路径（未声明）语义逐字节不变——先推 MES 后落账，断连即显式失败回滚；调用方 rg 实测 4 处（ ） ， （ ）
- `fallback_lane.py` ：
- `fallback_verify.py` ： （ ） ；
- `fallback_highrisk.py` ： （ ）
- **验证**：新建 `tests/golden/test_fallback_offline_booking.py` （ ： （ ； （ ） **25 passed** ； （ ， ： – ， ； ） **PASS** ，
- **冒烟设施修复登记**（非产品）：`smoke_s6_reconcile.py` D4 检查数据源修正——原实现读 `approvals.json` 的 `history[].record.params` ，但历史条目只存 paramsHash 不存 params（ ） ， ； `steps.params` （唯一事实源），对账口径不变。
- **影响分析**： （ ） ； （ ， ） ； （ ，
- **文档同步**： ）
- **边界**： ； （
- **发布动作**：无 commit/push/merge/publish。
---
## 2026-09-04 — FB-03 智能兜底 P3（
- **类型**：
- **做了什么**： ） `fallback-highrisk.json` 白名单（ ， ） ；
- `server/agent_core/fallback_highrisk.py` （ ， ） ： （ ） （ （ ）
- `fallback_lane.py` （ ） ： ； （ ） ； （ ； ； ） ；
- `fallback_verify.py` += `verify_sandbox_no_main_writes` （前后指纹相等 + 执行区间零 WORLD_WRITE 物理断言）/ `reconcile_external` （ `build_reconcile_report` （对账永远不写）。
- `pi_bridge.py` （ ） ： （ ） （ `_redact_ops_line` 行级脱敏） ）
- `workflow.py` `execute_confirmed` +2 分支： （ （ ） ； `_backup_config_file` 工具函数。
- `harness.py` ：权力矩阵 +2 意图（+4 行）；**缺陷修复** `refresh_confirmation_world_fingerprint` 推进 beforeFingerprint 时同步重算 envelopeHash（ ）
- **验证**： ； （ ） ； （ ； （ ） （ ） **1501 passed / 18 failed / 10 errors** （ **25 passed** ；偏差⑦⑧攻击面专项 `test_fallback_p3_attack.py` （新建 7 例：第二张卡信封回归/旧卡伪造/参数篡改/重放/跨 run 重锚边界/非兄弟改动拦截/伪造兄弟）**7 passed**，联合 **72 passed** ；真实 S6 冒烟（真实 server+Pi+kimi-k2.6+真实 MES HTTP 适配器）**19/24**——断连注入/S6 归类/真实 Pi 计划/逐笔卡/恢复后对账三档+证据冻结+纯读断言/对照组全过，**但抓到产品缺陷 FB-03-BUG-1： （ ， ； **12/12 全过** （脱敏实测/非 ops 物理不可见实测/双人链 H-20 覆盖登记）。
- **影响分析**： （ ） ； （ ） ； ；
- **文档同步**：
- **边界**：真实 MES HTTP 链路对账（ ， ） ； `_probe_mes_connectivity` /`_fetch_external_wo`； （
- **发布动作**：无 commit/push/merge/publish。
---
2026-09-03 23:29:43 +08:00
## 2026-09-03 — FB-02 智能兜底 P2（ ）
- **类型**：
- **做了什么**：
- Harness： （ （ ， ，
- `server/agent_core/fallback_lane.py` （ （ ） `plan_fingerprint` （ ， ） `validate_plan` 出卡前五段校验（ ） ； （ ，
- `server/integrations/pi_bridge.py` （ ） ： `fs_write` （限 work/outbox） `aps_invoke` （ ， ） ； `render_plan_task_brief` （
- `server/agent_core/fallback_verify.py` （ ， ） ： （ ） ）
- `workflow.py` `execute_confirmed` +1 分支（~50 行，证据校验后、既有全部 action 分支逐字节不变）：调 `execute_plan` → 分支写 `WORLD_WRITE agent.fallback.execute` 审计（成败都写；失败总账在 restore 之后补写）→ store.save() → 返回显式文案；分支体全异常归并显式失败（绝不抛出）。
- 确认卡零前端改动：复用 `confirm-card` 块 + `/api/actions/confirm` 唯一执行通道； （
- 新增环境变量：`APS_FALLBACK_EXEC_TIMEOUT_SEC`（ ） `APS_FALLBACK_EXEC_MAX_STEPS` （ ） `APS_FALLBACK_MAX_PLAN_STEPS` （ ）
- **验证**： ） `test_fallback_lane.py` （ ： `test_feature_flags.py` 共 **41 passed** ； （ ； **24 passed** ；全量黄金两批 **1090 passed / 3 failed / 14 errors** （ ， ） ； `All checks passed!` （
- **影响分析**：按 P2-DESIGN §9（ ） ； （ ， ） ； ；
- **文档同步**：
- **边界**： （ ） ； ； （ ） ； （ ）
- **发布动作**：无 commit/push/merge/publish。
---
2026-09-03 13:48:03 +08:00
## 2026-09-02 — FB-01 智能兜底 P1（ ）
- **类型**：
- **做了什么**：意图未识别（`assistant.reply`/`unknown` 分支）时不再只回固定话术，而是拉起 Pi headless 做**一次只读分析兜底**（方案 S1/S5 进产品路径，草稿语义，不写主干世界）。
- `server/agent_core/fallback_lane.py` （ ， ） ： （ ） （ ） `PI_CODING_AGENT_DIR` 配置圈禁 + taskkill 进程树回收、模型端点协商（ ， ） （
- `server/integrations/pi_bridge.py` （ ， ） ： （ ） （ ） ； （ ， ） ； （ ） ； （
- Harness： `agent.fallback.propose = P1` （ ， ，
- FF-01 开关：`FEATURE_CATALOG` 追加 `fallback` ；新增 `_DEFAULT_OFF_KEYS={"fallback"}` ——文件缺失/损坏/未配置/非 bool 时 fallback 默认 **False** （会拉起外部 LLM 子进程产生 token 成本，与其余键 fail-open 相反，有意取舍）；`/api/features` 响应追加 `defaultOff` 字段显式标注。
- 接线：`workflow.py` `assistant.reply/unknown` 分支 +8 行——开关开且意图未识别 → `propose_reply` ；返回 None（ ） ；
- **设计张力处置（简报层）**： ： ， ； ，
- **验证**： `test_feature_flags.py` **19 passed** （ ） ； （ （ ） **1084 passed / 1 failed** （ ， `git diff` 均为零， ， ） ； （ `All checks passed!` ，修改文件零新增告警）。**冒烟复证（ ， ） ， `node.exe` + 新增 `test_write_guard_extension_real_template_format` 防回归）后原样代码复跑 `poc/pi-fallback/smoke/smoke_e2e.py` 七条判据全 PASS（ ， ， ， ， ， `poc/pi-fallback/P1-SMOKE.md` §7，
- **影响分析**： ； `/api/features` （响应纯增量），三条 all-enabled 既有断言同轮修复 MED； （ ：
- **文档同步**： `/api/features` 条目 + 变更记录、新建 docs/architecture/fallback.md（
- **边界**： ， ） ； （ ）
- **发布动作**：无 commit/push/merge/publish。
---
2026-09-02 02:46:18 +08:00
## 2026-08-26 — FF-01 功能开关（ ）
- **类型**：
- **做了什么**：用一个 JSON 配置文件控制哪些功能上线可见、哪些隐藏不用。
- 后端 `server/agent_core/feature_flags.py` （ ） ： （ ， ） ； `server/data/features.json` 、`APS_FEATURES_PATH` 可覆盖；格式 `{"version": 1, "features": {"drawing": false, ...}}` 。
- 语义：可用性/可见性开关，**不是权限边界**（ `source/error` ，未知键列入 `unknown` ，非 bool 值该键回退默认开启并记录错误，绝不因配置问题锁死界面。
- 网关：`GET /api/features`（
- 前端 `apps/web/src/features/flags.ts` + 接线：右侧导轨 7 个工具按钮、左侧栏 6 个快捷入口（ ） （ ， ）
- **验证**： **6 passed** （默认全开/配置生效/损坏 fail-open+error/非 bool 回退/env 覆盖/端点契约） ； （ ） **1071 passed / 1 failed** （ （ ） ； （
- **影响分析**： ， ； （
- **文档同步**：
- **边界**：开关只隐藏入口，不拦截后端业务端点（如需端点级下线需另行设计，且不得替代 Harness 门禁）；桌面端与 Web 端共用同一配置；`server/data/features.json` 为现场数据不入库。
- **发布动作**：无 commit/push/merge/publish。
---
2026-08-20 10:09:04 +08:00
2026-08-26 00:25:46 +08:00
## 2026-08-20 — Round 84 经父进程验证的 CP 时间直接物化
- **类型**：
- **直接物化**：可行 CP/HYBRID `operationSlots` 经父进程重验后绑定 `_cpOperationTiming` ； ，
- **写前门禁**：
- **诊断兼容**：父校验器识别 C2/C12 整约束移除与 C12 RHS 正增量的合法反事实，避免把诊断可行解误拒，同时不放宽生产求解。
- **元数据**： ； `cpTimingApplied=true` ， `start-day-full-duration.v1` 。
- **浏览器**：隔离 CP `V20260820-001` 与 HYBRID `V20260820-002` 均 FEASIBLE， ； ， ，
- **回归**：初跑暴露 13 项累积失败； ， `1540 passed / 5 warnings` ；
- **边界**：主项目 V006 因 0 个标准排产条目为 TRIVIAL， ； ，
## 2026-08-20 — Round 83 C3 班次日历分段 CP 模型
- **类型**：
- **CP 模型**：新增 `cp-calendar-segmented.v1` ；班次扣休息形成有效窗口，长工序只在窗口边界暂停/续作。C1 使用逻辑工序包络， ，
- **C3 诊断**： `calendar-boundary-only` ，整约束 removal 为互斥 `continuous` ； ，
- **求解与输出**： ； ，
- **物化边界**： ； `CALENDAR -> C3_calendar` 硬冲突，关闭发布/MES 下发但不覆盖 CP solve status。C7 继续保持 start-day 整笔分钟语义。
- **回归收口**：全量测试发现累积工作区 `PoolEngine` 把 `KITTING_FIRST/SKILL_FIRST` 回落为 BOTTLENECK； ，
- **验证**： `1522 passed / 5 warnings` ； ； ； `[0,489000]` 、API 模式与拓扑一致、console0；
- **边界**：下一本地优先级为直接消费经验证的 CP 时间进行物化；真实现场费率/罚则、MySQL 多主机、厂商联调、签名/Defender/干净离线机仍需外部输入；未 commit/push/merge/publish。
## 2026-08-19 — Round 82 C7 产线/日容量 CP 硬约束与实例增量
- **类型**：
- **CP 模型**：新增 C7 line/day start-day 整笔分钟约束；
- **日历失败关闭**：自然日容量来自显式 shiftCalendar 有效分钟；缺覆盖、跨午夜/重叠班次、非法休息段拒绝，非工作日为 0。
- **诊断协议**： `C7_line_day_capacity_minutes` 单实例扰动；
- **成本/API/UI**： `instanceCostRates` 严格 422； ，
- **物化复核**： ；
- **验证**： ； ； ；
- **GitNexus**： ； （ ）
- **边界**：跨班暂停/续作、CP 日历窗口和 CP 时间直接物化仍未完成；未 commit/push/merge/publish。
## 2026-08-18 — Round 81 CP RHS 参数增量重解与现场成本口径
- **类型**：
- **协议隔离**： ； ，
- **模型语义**： ；
- **结果口径**： ，
- **成本校准**：无显式费率时所有货币字段为 null；
- **异步/UI**：新增 `cp-rhs.recompute` 严格 422、认证作用域绑定、取消边界、C8/C12 参数输入和按资源结果抽屉。
- **验证**： ； ； ；
- **边界**：真实现场费率/罚则、C7 产线/日产能模型和外部验收仍未完成；未 commit/push/merge/publish。
## 2026-08-18 — Round 80 CP 整约束 one-at-a-time 重解
- **类型**：
- **协议隔离**： ；
- **模型语义**： ；
- **结果口径**： ； ；
- **异步/UI**：新增 `cp-marginal.recompute` 严格 422 和结果表，租户/项目/并发/取消复用 JobQueue。
- **冻结验收**： ，
- **验证**： **1435 passed / 5 warnings** ；专项 36、扩展 144、Node 60、Web build； ； ； `AUDIT PASS` 。
- **GitNexus**： ； （ ）
- **边界**：下一项为 RHS 参数增量重解和现场成本校准；未 commit/push/merge/publish。
## 2026-08-18 — Round 79 诊断 LP 局部边际率与归因校准
- **类型**：
- **双口径保留**：原日志代理继续标“近似影子价”；新增 GLOP 诊断 LP，
- **诚实边界**：只支持 C4/C7/C8 分钟 RHS；
- **失败关闭**： ；
- **UI/冻结**：
- **验证**： **1399 passed / 5 warnings** ；专项 26、扩展 108、Node 60、Web build； ； ； `AUDIT PASS` 。
- **GitNexus**： ； （ ）
- **边界**：原调度变量级 LP 松弛/CP 目标重解仍待后续；未 commit/push/merge/publish。
## 2026-08-18 — Round 78 Sobol 全局敏感性与冻结 Sidecar
- **类型**：
- **Sobol/Jansen**：独立 `run_sobol_sensitivity` 保持旧敏感性契约不动； ；
- **确定性与取消**：日期只来自请求或 `world.businessDate` ；逐评估调用 JobRecord 取消检查。零方差返回不可识别 `null` ，不伪装为无影响。
- **异步安全/UI**： ， ；
- **冻结依赖**： ； `_sobol_direction_numbers.npz` 漏打包，冻结 EXE probe 显示 `scipy=1.18.0` 且健康冒烟通过。
- **验证**： **1381 passed / 2 warnings** ； ； ； ； `AUDIT PASS` 。
- **GitNexus**： ； （ ）
- **边界**：下一本地项为真实 LP/CP 对偶影子价与归因校准；外部环境项保持 Partial；
## 2026-08-18 — Round 76 康尼真实数据 Web 全流程试排
- **类型**：
- **10 单导入**： `工时.xlsx` 规范工序序列安全匹配； ， ；
- **Web 真实路径**：创建项目 -> 上传 9 份 XLSX -> “分析一下数据文件” -> “根据这些数据排产” -> P2 卡 -> 候选世界 trial。冻结 bytes、source manifest、payload、project/session/world/snapshot 和摘要全部绑定；
- **诚实边界**：试排版本为 10 VL / 72 WO / 10 DELAY， ； ，
- **策略/MPS/导出**： ； `TRIAL_ONLY` 。MPS 草稿支持 JSON 数字稳定哈希、保存 trace、精确关联本地柔性版本及 gap 复算；订单/设备 XLSX 显式绑定 `versionId` ，
- **验证**： **136 passed / 2 warnings** ；最终 full golden **1352 passed / 2 warnings** ； **60 passed** ； ； `AUDIT PASS` 。
- **GitNexus/风险**： ； （ ） ；
## 2026-08-17 — Round 75 CP-SAT 原生不可行核心 solverMeta
- **类型**：
- C1/C2/C10/C11/C12 约束族增加 assumptions；
- INFEASIBLE 时通过 OR-Tools `SufficientAssumptionsForInfeasibility()` 输出 `nativeIis` ，约束 ID 与目录一致。
- 明确标注 sufficient assumption core、`isMinimalIis=false`，不宣称数学最小 IIS或真实影子价。
- **验证**： ； ；
- **GitNexus**： ； （ ）
- **边界**：下一本地项为 Sobol/生产级敏感性；未 commit/push/merge/publish。
## 2026-08-17 — Round 74 归因 API 与冲突中心接线
- **类型**：
- 新增 `/api/attribution` ，
- 修复 flex 延误误引用 fixed 产能冲突； `iisId` ，
- FlexPanel 冲突页展示主控约束、IIS、证据引用与原始证据；
- 项目/会话切换触发重载，请求开始/失败清空旧报告，避免跨项目陈旧归因。
- **验证**： ； ； ； ； `AUDIT PASS` 。
- **GitNexus**： ； （ ）
- **边界**：下一本地优先级为 CP-SAT IIS solverMeta 与 Sobol/生产级敏感性；未 commit/push/merge/publish。
## 2026-08-17 — Round 73 Automation G4 授权载荷绑定与真实确认接线
- **类型**：
- **完整授权**： `automation-authorization.v1` ，包含完整 Rule、harnessAction、power、BusinessActionBinding；
- **持续绑定**： ； ，
- **执行边界**：删除 G4 P2/P3 进程内 handler 直通；只有完整 Binding + business_bridge 可执行，缺失按 P3 DENIED。ruleId 替换与一次性 executionGrant 重放均拒绝。
- **真实 API**： `automation.gear.escalate` ；第一重保留待办，第二名审批人后铸造绑定 grant。TestClient 两身份正向验证后真实业务桥把 DRAFT 版本发布为 PUBLISHED。
- **验证**： **24 passed / 1 warning** ；审批/治理相邻回归 **92 passed / 1 warning** ；全量黄金 **1300 passed / 2 warnings** ； ； `AUDIT PASS` 。
- **GitNexus**：最终索引 13,217 nodes / 59,833 edges / 580 clusters / 300 flows； （ ）
- **边界**： ； ；
## 2026-08-17 — Round 72 工程目录排产 P2 冻结信封与 TOCTOU 关闭
- **类型**：
- **P2 边界**：删除 SQL 完整数据的 `folder.schedule.sql_direct` 直通；所有工程目录排产都只生成 P2 确认卡，
- **同源冻结**：工程目录表格/SQL 一次读取为 immutable bytes； ， ，
- **信封门禁**：全 P2/P3 记录新增 `envelopeHash` ，与 `paramsHash` 一起在 file/database 决策回调内重算；
- **原子失败**： ； ， ；
- **审计修复**：首轮发现 SQL 绕 P2、stage 污染、失败非原子；复审追加“临时 ORD1→ORD2→ORD1”换源攻击。全部修复后最终 `AUDIT PASS` 。
- **验证**：专项 **14 passed** ；审批/folder 相邻回归 **108 passed / 1 warning** ；全量黄金 **1290 passed / 2 warnings** ， ； **60/60** 、8003/5173、浏览器和 `git diff --check` 通过。
- **GitNexus**：最终索引 13,220 nodes / 59,755 edges / 607 clusters / 300 flows； （ ） ，
- **边界**：下一本地 P0 为 Automation G4 payload 绑定；真实 MySQL 多节点、MES/WMS/SAP、模型服务和发布环境仍需外部输入；
## 2026-08-17 — Round 71 最终安全收口与真实运行验收
- **类型**：
- **安全收口**：治理 CRUD/启停统一走真实 P2 与认证 actor； ； ， `PENDING_REVIEW` 与证据审核；主数据确认绑定显式 world hash， ；
- **确定性与契约**：订单/设备 XLSX 归一化 ZIP 元数据；固定方案 7 策略、柔性对比 5 模式、公开意图 9 策略；康尼固定轨保留实测/工时表/推断来源。
- **独立审计修复**：首轮 4 个 P1 全部关闭：显式项目不再被 `APS_DRAWING_ALLOWED_ROOTS` 扩权；同名上传在元数据/文件替换失败时补偿恢复； `KITTING_FIRST` /`SKILL_FIRST`。最终复审 `AUDIT PASS` 。
- **验证**：四个审计修复文件 focused **37 passed / 1 warning** ，相邻回归 **74 passed / 1 warning** ；全量黄金 **1276 passed / 2 warnings** ， ； **60/60** 、隔离图纸 Playwright **3/3** 、`git diff --check` 通过。
- **真实运行**：当前代码重启后 8003/5173 和前端代理健康检查均 HTTP 200； ， （ ）
- **边界**：真实 MES/WMS/SAP、ASR/VLM/OCR、冻结 Sidecar、签名/信创/CI、MySQL 多主机、WORM/HSM-KMS 与现场 39 缺工艺/67 缺能力仍需外部输入或环境；未 commit/push/merge/publish。
## 2026-08-17 — 多智能体阶段 A 剩余切片（
- **类型**：
- **做了什么**：
- 多智能体协作： ， ； ， ）
- MPS 计划台： ） ； `createdBy` 契约限定 `LLM/USER/SYSTEM` 。
- 排产对比：柔性 `compare_sort_modes` 扩展为五模式（正排/倒排/瓶颈锚/齐套优先/技能优先），对话与矩阵文案同步五模式。
- 导出：新增工单角度/设备角度调度方案 xlsx（
- 康尼数据验证：生成/更新 `康尼/数据` 两份映射表并跑通保守验证（ ） ；
- 集成修复：解析器兼容带括号说明的模板表头；主订单完整路线文件回填 `工时.xlsx` 真实值；五模式文案同步。
- **验证**：相关黄金测试 82 passed / 1 warning；
2026-08-20 10:09:04 +08:00
2026-08-26 00:25:46 +08:00
## 2026-08-17 — 康尼设备/模具映射导入与齐套/技能优先策略
- **类型**：
- **做了什么**：
- `kangni_intake.py` 新增「设备能力映射模板」「模具适配映射模板」识别与解析（`parse_equipment_capability_map` / `parse_mold_adaptation_map` ），有表时用真实设备能力、单件工时、可动率、移动耗时、模具寿命与适配设备排产；缺表回退合成共享工位/不占模具槽。
- 康尼订单补充 `kitStatus` 与 `requiredSkillLevel` ，为齐套优先/技能优先策略提供数据。
- 新增策略模板 `KITTING_FIRST` （齐套优先）与 `SKILL_FIRST` （ ） ：
- **验证**：康尼导入/柔性/规则引擎/方案对比相关黄金测试 36 passed；
## 2026-08-14 — 康尼工时表接入与 MPS 计划台 Web 接线
- **类型**：
- **做了什么**：
- `kangni_intake.py` 新增「工时.xlsx」识别与 `parse_std_time_sheet/load_std_time_map` ：按订单 sheet 读取 `标准工时/分钟` 真实值，工艺路线标准工时空值优先回填，来源写入 `stdTimeSource=工时表` ，无值时才走推断兜底；`build_flex_bundle` 与 `load_site_into_world` 同源订单导入同步启用。
- Web 计划台接入 MPS： （
- **验证**：康尼导入与 MPS 相关黄金测试 19 passed；
2026-08-20 10:09:04 +08:00
2026-08-26 00:25:46 +08:00
## 2026-08-12 — 排产缺口傻瓜式引导与 Web 向导渲染
- **类型**： （
- **做了什么**：新增 `scheduling_data_guide()` 排产数据缺口步骤引导（缺订单/产品/工艺/设备/班次/工时/物料，逐项给出人话说明、怎么补和一键口令）；`guidance.next`、`readiness.query` 与柔性排产阻断分支自动附带引导块； `readiness/wizard/clarify` 块，引导卡支持步骤清单与按钮，非专业人员可跟着「带我排一版」一步步补数据。
- **验证**：新增黄金测试 3 项（空世界缺口清单、最小完整数据 ready、guidance.next 引导块）；`test_guidance.py` 全绿。
## 2026-08-12 — Round 71 未完成功能补齐（
2026-08-20 10:09:04 +08:00
- **类型**：
- **做了什么**：
2026-08-26 00:25:46 +08:00
- R71.1：上传白名单支持 `.dxf` ； ； `GET /api/projects/{id}/drawing-files` 与 `POST /api/drawings/inspect-batch` ，每张图纸独立候选变更集；权限/类型/超限错误改中文可读提示。
- R71.2：新增 `drawing_understanding.py` ，标题栏/图框/BOM 表区域聚类识别、图号/版本交叉验证、候选带置信度与证据；`workflow` 审核通过后生成 `drawingLink` 证据；版本 diff 触发重排建议。
- R71.3：新增工位/设备 CRUD（ ） `/api/masterdata/*` 与 `MasterDataPanel` ，写动作走 P2 审计。
- R71.4：新增 `mps_planning.py` 与 `/api/mps/*` ：
- R71.6：新增 `/api/governance/rules` 规则 CRUD/启停/审计轨迹、`/api/gov/audit/stats` 审计聚合与 `GovernancePanel` 。
- **验证**： ； ； ； ； ；
- **PDF 补充**：上传白名单与面板支持 `.pdf` ；新增 `inspect_pdf()` /`render_pdf_preview()`，项目图纸清单与批量解析同时识别 DXF/PDF， ； `drawing-master-candidates.v1` 与 P2 门禁。
- **PDF 验证**：新增 PDF 黄金测试 5 项（ ）
- **图纸体验与准确性**：图纸预览支持全屏查看整图；修正比例文本 `M1:1` 被误识别为螺纹规格 `M1` 的问题，标题栏/比例/格式字段回归测试补齐。
- **工艺/工序识别**：新增 `drawing_process.py` ，从图纸文本与 BOM 零件名识别车削/铣削/钻孔/磨削/螺纹/焊接/热处理/涂装/装配等工艺候选，以及表面粗糙度、公差、螺纹规格、深度、材料等细节；全部 `PENDING_REVIEW` ，标准工时/资源不推断。
- **图纸管理与 AI 精确解析**：新增单张删除与项目清空接口和前端按钮；新增 `/api/drawings/{id}/ai-analyze` ，配置 LLM Provider 后执行 AI 结构化精确提取，未配置/失败时 fail-closed 回退确定性解析，绝不编造。
- **中文工艺文档结构化**：新增 `recognize_process_text()` 与 `/api/drawings/analyze-text` ，可把分段建造说明解析为分段/组立/工序/场地/装配顺序候选；图纸详情新增“工艺关键信息”页签展示分段、组立、场地与顺序。
- **AI 返回容错**：模型返回 markdown 围栏/双重编码 JSON 时自动解析；`chat_json` 失败后用 `chat_text` 兜底重试；不可用时前端显示中文原因，不再裸展示 `provider-invalid-json` 。
- **Web 上传 413 修复**：新增 `deploy/nginx-aps.conf` （
2026-08-11 00:54:05 +08:00
## 2026-08-04 — Round 69 北海造船场景 SYNTHETIC APS 完整数据包
- **类型**：
- **做了什么**：实现确定性船厂 APS 数据生成器和 full 数据包，覆盖 4 项目、WBS/工程发布、EBOM/PBOM/MBOM、库存/MRP、MAKE/BUY/OUTSOURCE、12,000 工序有限排产、质量返工、MES 执行、7 方案、15 异常、20 Skill、20 类 RAG。
- **审计整改**：关闭委外前后工序/供应商/运输/月产能、manifest/world 闭包、附件委外 19 字段、15 类异常逐项、WorldStore 甘特、硬约束空覆盖、返工无产能、场景假变化、validation 占位与日期语义问题。
- **硬约束**： ；
- **输出**： ； `21838055715c587fa3b76dc4b640d5627cdb1626f993941c6f982c6a298594d3` ； `d908718e...a49fe7` ； `0f7fcdb3...991d` ；
- **验证**： ； ； ； ； ； `AUDIT PASS` 。
- **性能**： ， ，
- **运行/保护**： ， `server/data` 受保护文件哈希未变化。
- **边界**：全部数据为 SYNTHETIC， ；
---
## 2026-08-03 — Round 67 审批迁移 Fail-Closed 与 Grant Digest 归一化
- **类型**：
- **做了什么**： ； ； ； ； ； ； ；
- **审计修复**：首轮计划审计 6 项阻断全部纳入；首轮代码审计发现 existing payload 身份未校验，补 request/grant payload immutable gate 与 legacy consume-once 回归后最终 `AUDIT: PASS` 。
- **验证**： ； ； （ ） ；
- **真实运行**：临时 ApprovalStore -> SQLite 迁移， ；
- **数据保护**：现场 approvals/world/MOM hashes 前后不变；`server/data/**` 与 `.env` 无 Git 状态。
- **遗留**： ； ；
- **交付边界**：未 commit、push、merge 或 publish。
2026-08-20 10:09:04 +08:00
---
## 2026-08-03 — Round 66 Windows 求解器进程隔离与 Fail-Closed
- **类型**：
- **做了什么**：
- CP/HYBRID native 优化迁入独立 child， `aps.solver-process.v1` ；
- fatal/timeout/非法响应均 `UNAVAILABLE` 、0 PO/WO、不可发布； ，
- runtime probe 增加来源、版本、user-site、fatal+exit0 与内部 timeout 门禁；默认 PATH Anaconda 稳定拒绝，`.venv`/`.sidecar-venv` 各连续 5 次通过。
- 源码 Sidecar `--solver-child -I` 真实冒烟首次发现隔离 Python 移除源码 import root； ， `test_source_solver_child_entry_runs_under_isolated_python` 。修复后 CP `OPTIMAL` 、1 PO/10 WO/10 slots、协议 v1、`runtimeSafe=true`。
- **真实运行**：复制 `world.json` 的 CP/HYBRID 均 `OPTIMAL` 、1 PO/10 WO/10 operationSlots； `OPTIMAL` ，但受现有主数据阻断为 0 PO/WO、1 slot/1 conflict， ；
- **验证**： ； （ ） ； ；
- **复审补强**：大请求改用自动清理临时文件作为 child stdin，
- **首轮审计修复**： `OPTIMAL + 空 entries` 假绿；现强制重算 `responseDigest` ，校验条目完整排列/业务字段、pipeline/status 和可行槽位覆盖，新增 16 个负向用例。
- **服务/UI**： ；
- **数据保护**： `C6E7FF090719DB505AF5C3B0D8ADD376CBA7843D6E6982A68C1BA02C342052FA` 、MOM SHA-256 `6B64ADF6F29A43A518D89718610EE71FAD60E86D3F38CD5CFF26F1740CC53F7D` 前后不变；`server/data/**`、`.env` 无 Git 状态。`master.db` 可能更新 license `last_seen` 等运行元数据，不用文件 hash 冒充业务不变。
- **遗留/边界**：现有冻结 EXE 仅旧 `--probe-child` 通过，未重建，不能宣称新 `--solver-child` 已打包；仍需构建后冒烟、干净 Windows、签名/Defender/真实 CI。下一 P0 为全量 P2/P3 evidence 封套与审批迁移可靠性。
- **最终独立复审**： ；
- **文档同步**：
- **发布动作**：无 commit/push/merge/publish。
---
## 2026-08-03 — Round 65 端到端闭环 APS 排产内核
- **类型**：
- **做了什么**：统一商务订单/BOM/库存/供应/工艺/设备/班组/模具/层级负荷准入与 V2 校验；
- **证据门禁**：
- **前端/E2E**： ；
- **验证**： ； ； ；
- **现场保护**：旧版订单 GET 曾在 2026-08-03 10:10:24 写现场 world； `6b64adf6...53f7d` 在隔离验收前后保持一致，未擅自回退。
- **文档同步**：
- **遗留**： `AUDIT: PASS` ；未提交、未合并、未发布。
2026-07-21 11:05:57 +08:00
> **大管家的账本。** 每次改代码、加功能、改功能、修缺陷，同一轮必须追加一节。
> 写法见 [docs/README.md §2.2](./README.md)。旧名：`PROGRESS.md`（已迁入本文件）。
---
2026-08-20 10:09:04 +08:00
## 2026-08-02 — 锐扬 Excel 结构化诊断与真实行号收口（ ）
- **类型**：
- **解析纠偏**：设备编码别名采用“最后一个非空值优先”，后续空列不再覆盖已有编码；补 `固定资产编号` 别名。47 行原解析噪声恢复为有效设备行。
- **结构分类**： `ignorable_section` ；非排产整块归为 `NON_SCHEDULING_BLOCK/ignored` 。
- **诊断契约**： `diagnostics` 、`diagnosticCounts`、`diagnosticsVersion=1`，每条含 sheet、真实 Excel 行号、parserIndex、kind、code、severity、classification、message、rawSummary；
- **现场结果**：锐扬目录（主表 + `订单-样例.csv` ）为 **有效 1404 / blocking 1 / skippedRows 974** ； `07-设备模型` Excel 第 130 行“3.8吨锂电叉车”，三个业务编码均空；出厂编号不冒充设备编码。
- **用户可读输出**：文件问题列直接显示真实 Excel 行号；
- **回归**：结构化 XLSX 缩比测试、folder 聚合契约、日期稳定性与既有导入/指导测试通过；全量黄金基线随 round-64 一并验证为 910 passed。
## 2026-08-02 — MRP 多层 BOM 自制/采购纠偏 + 分阶段界面（ ）
- **类型**： （ ）
- **根因**：旧逻辑把“有默认工艺路线”错误等同于“自制”，并要求 `MAKE && hasRouting` 才继续展开；锐扬 MOM 导入又只为前 80 个自制候选生成模板路线，导致缺路线半成品被改写为采购并停止下钻。前端同时隐藏 `make` 、把 DRAFT 建议标成“采购订单”，分解后还自动跳采购页。
- **后端修复**：显式 `procurementType` 优先； ， `missingRouting` 阻断提示并继续多层展开；同订单同物料聚合后只扣一次库存/在途；持久化独立 `makeSuggestions` ，不写入/伪造 `productionOrders` ；路线进一步区分 READY / TEMPLATE / MISSING。
- **前端修复**：新增“自制建议”页签，分解后默认打开；“生产订单”改为“已排生产”，“采购订单/委外订单”改为“采购建议/委外建议”；模板工艺、缺工艺分别标识，明确建议与真实生产订单的阶段边界。
- **真实验证**： **106 项唯一自制建议 / 124 条采购建议 / 0 委外** ；其中 **67 项仅模板工艺待确认、39 项缺工艺路线** ； `RAW_MATERIAL` ，采购中半成品为 0； `C0030800-04179` 。
- **回归**： **10 passed** ； `npm run build` 通过； ；
- **边界**：当前 67 条路线来自导入模板， ， ；
## 2026-08-01 — trace_chain 接入 schedule.run
## 2026-08-01 — trace_chain 跨引擎可复算（
## 2026-08-01 — EXTERNAL 引擎接入 trace_chain + 前端追溯 UI（ ）
## 2026-08-01 — 对话状态与世界状态成对快照（ ）
## 2026-08-01 — 审计完整性告警通知渠道（ ）
## 2026-08-01 — 审计完整 Merkle 树（ ）
## 2026-08-01 — 审计 append-only 守护：跨进程锁 + 清理策略（ ）
## 2026-08-01 — 偏好学习升级：项目隔离/解释/重置/冷启动（ ）
## 2026-08-01 — Explore 与 Runtime 数据边界（ ）
## 2026-08-01 — L0-L3 Plan 重放能力（ ）
## 2026-08-01 — 统一工具运行时（ ， ）
## 2026-08-01 — 分支树：项目->会话->分支三级树（ ）
## 2026-08-01 — 分支切换自动恢复锚定检查点（ ）
## 2026-08-01 — 偏好解释 UI + stub 可复算修复（ ）
## 2026-08-01 — 主数据工艺树升级为树形表格 + 物料分类/来源修复（ ，
## 2026-08-01 — L0-L3 Plan 批准/驳回审计（ ）
## 2026-08-01 — Agent 自动编排： （ ）
## 2026-08-01 — 偏好时间衰减加权模型（ ）
## 2026-08-01 — Explore 通道扩展：敏感性/鲁棒性接入统一边界（ ）
## 2026-08-01 — 多智能体并行交付：会话引用/四层上下文/自动化G0-G4/分支树UI/时间线微观层（ ，
## 2026-08-02 — 多智能体并行交付·第二批： （ ，
- **类型**： （ ， ）
- **做了什么**（三个智能体并行，写范围互不重叠）：
- **方向 D（ ） ： （ ） （ ） （ ） （ ） ；
- **方向 E（ ） ： （
- **方向 F（ ） ： （ ；
- **为什么**：按 plan.md 蓝图继续拆分边界并行推进矩阵 Missing/Partial 项。
- **验证**：三方向黄金测试 32 项（ ） ； `npm run build` 通过；
- **边界**：
---
## 2026-08-02 — 多智能体并行交付·第三批： （ ，
- **类型**： （ ， ）
- **做了什么**（三个智能体并行，写范围互不重叠）：
- **方向 G（ ） ： ， `windowOuterMovedCount=0` ），扰动度量 movedOrderCount/shiftedHours/tardinessDelta/disturbanceRatio； `impact.lns` （ （ （ ） （ ） ；
- **方向 H（ ） ： （ ） （ `hard_blocking_conflicts` /`get_constraint_profile`，未改既有接口；`test_attribution.py` 7 项。
- **方向 I（ ） ） ； × ： ，
- **为什么**：按 plan.md 蓝图继续把 Missing/Partial 矩阵项分发给并行智能体，保持写范围互不重叠、智能体可互相沟通。
- **验证**：新增黄金测试 16 项（ ） `618 passed` （隔离 `APS_KNOWLEDGE_PATH` 规避知识库环境污染）；后端 8003 以新代码重启健康、前端 5173 构建通过。
- **边界**：真实 LP/CP 对偶影子价需线性化模型重解； ； `GET /api/checkpoints/{pairId}` （前端已降级展示）；分支合并世界 diff、@知识 引用、滚动摘要 LLM 压缩、策略特征规则归纳留待后续轮。
- **类型**： （ ， ）
- **做了什么**（三个智能体并行，写范围互不重叠）：
- **方向 A（ ） ： （
- **方向 B（ ） ： （
- **方向 C（ ） `BranchPanel.tsx` 分支树 UI（ `TimelineRail.tsx` 时间线微观层（ ）
- **为什么**：按 plan.md 蓝图拆分边界分发多智能体并行推进矩阵 Missing/Partial 项。
- **验证**：三方向黄金测试 20 项（ ） ； `npm run build` 通过；浏览器实测分支树 fork/merge/discard 与微观层正常。
- **边界**：接线（上下文到对话链路、自动化到网关定时/真实动作、引用自动触发）、`@知识` 引用、调度器持久化、两世界 diff 留待后续轮。
---
## 2026-08-02 — 多智能体并行交付·第四批：检查点投影/`@知识`引用/滚动摘要LLM/偏好特征规则（ ， ）
- **类型**： （ ， ）
- **做了什么**（三个并行智能体写范围互不重叠 + 主控实现矩阵 66） ：
- **方向 J（ ） ： （ `GET /api/checkpoints/{pairId}` （缺失 404 中文）与 `GET /api/checkpoints?pairIds=&branchIds=&sessionId=` （分支锚定批量投影）；前端 `fetchCheckpointWorld` + `WorldDiffView` 检查点 B 侧优先投影逐字段全量 diff，
- **方向 K（ ） ： `@知识` 引用（强制命中：命中→正文+出处+证据 ref， ） ； `knowledge_lookup` （既有 4 类零破坏） ； `handle_intent` 入口自动解析注入（`_refs` + SESSION 审计 evidenceRefs， ） ；
- **方向 L（ ） ： ， （ ） ； （ ， `test_context_policy.py` +3 项。
- **L66（ ） ： `induced_rules` （ ； `record()` 调用点接线 features；
- **为什么**：按 plan.md 蓝图继续把矩阵剩余 Partial 项收口，保持多智能体并行、写范围互不重叠。
- **验证**： `656 passed` （隔离 `APS_KNOWLEDGE_PATH` 规避知识库环境污染）；前端 `npm run build` 无类型错误；后端 8003 新代码重启健康。
- **边界**： ， ） ；
- **类型**：
- **做了什么**： `run_monte_carlo` 改为经 `explore_boundary.run_explore` 统一通道执行（ ， ） ； （ ）
- **为什么**：矩阵 55 行「Explore 与 Runtime 数据边界」剩余项「敏感性/鲁棒性等其他 Explore 工具逐一接入统一通道」。
- **验证**： （ ） ； ： ；
- **边界**：前端 Explore 与 Runtime 视觉分区留待后续轮。
---
## 2026-08-02 — 多智能体并行交付·第五批： （ ， ）
- **类型**： （ ， ）
- **做了什么**（三个并行智能体写范围互不重叠 + 主控实现矩阵 88） ：
- **方向 M（ ） ： ， ） ； （ ， `test_plan_branch_restore.py` 5 项。
- **方向 N（ ） ： （ ） ； （ ） ； ： （ ） ） （ ） （ ） （ `GET /api/wms/replay` + `GET /api/wms/inventory` ； `test_wms_replay.py` 3 项。
- **方向 O（ ） ： ； ， ； ） ； （
- **L88（ ） ： （ ） （ ， （ ）
- **为什么**：按 plan.md 蓝图继续把矩阵 Missing/Partial 项收口， （
- **验证**： `683 passed` （隔离 `APS_KNOWLEDGE_PATH` 规避知识库环境污染）；前端 `npm run build` 无类型错误；后端 8003 新代码重启健康（/api/wms/* 已注册）。
- **边界**： ） （ ） ； （ ） ； （ ） ；
- **类型**：
- **做了什么**： （ ） × （
- **为什么**：矩阵 66 行「偏好学习影响默认策略」剩余项「偏好模型升级为权重回归/规则归纳」的权重回归部分。
- **验证**： （
- **边界**：策略特征规则归纳（多特征回归：订单结构/客户等级/约束 → 策略）留待后续轮。
---
## 2026-08-02 — 多智能体并行交付·第六批： （ ， ）
- **类型**： （ ， ）
- **做了什么**（三个并行智能体写范围互不重叠 + 主控实现矩阵 86） ：
- **方向 P（ ） ： （ ） （ ） （ ； （ ） `mes.cancel_dispatch` /`cancel_work_order` 幂等补偿；`/api/saga/*` 列表/详情/retry/compensate/takeover； `test_saga_wms_closure.py` 6 项。
- **方向 Q（ ） ： （ ， ） `constraint_catalog()` ； （ ） （ （ `test_engine_constraint_semantics.py` 19 项。
- **方向 R（ ） ： （ ） （ `/api/gov/audit` traceAlerts + `GET /api/gov/trace/verify` + GovConsole ⚠断链徽标/顶部提示条；**EXTERNAL 真实 HTTP skill 端到端验收**（ `test_trace_external_http.py` 。
- **L86（ ） ： （ ） （ ） ； （
- **为什么**：按 plan.md 蓝图继续把矩阵 Missing/Partial 项收口， ）
- **验证**： `755 passed` （隔离 `APS_KNOWLEDGE_PATH` 规避知识库环境污染； `npm run build` 无类型错误；后端 8003 新代码重启健康（/api/saga/*、/api/gov/trace/verify 已注册）。
- **边界**： （
- **类型**：
- **做了什么**：新增 `server/agent_core/plan_orchestration.py` ： ， ， （ ， ） ； `_load` 的 regenCount 校验（状态流转版本 regenCount 不变，原校验要求连续递增会误判 corrupt）
- **为什么**：矩阵 110 行「L0-L3 Plan」剩余项「接入 Agent 自动编排（
- **验证**： ） ； ： （ ） ；
- **边界**：
---
## 2026-08-02 — 多智能体并行交付·第七批：自动化网关驱动/NSGA-II多目标/可重生流水线/桌面壳决策（ ， ）
- **类型**： （ ， ）
- **做了什么**（三个并行智能体写范围互不重叠 + 主控决策收口）：
- **方向 S（ ） ： （ （ ， ） ； `test_automation_gears.py` +2。
- **方向 T（ ） ： （ ） （ ） （ ） （ ） （ ） ； `test_registry.py` 6 项。
- **方向 U（ ） ： （ ） `solve_nsga2` 、`nsga2_solutions_to_cards` 衔接 rank_scenarios、大算例基线（ < 15s 不劣于单目标 GA ） ； 时间预算确定性修复 （ 小预算跑满固定代数与 GA 口径一致 ） ； algolib nsga2 条目翻转为可用 ； test_nsga2_engine . py ` 11 项 。
- **L98（ ） （ ） ， （
- **L110（ ） ： ）
- **为什么**：按 plan.md 蓝图继续把矩阵剩余项收口， ， ）
- **验证**： `791 passed` （隔离 `APS_KNOWLEDGE_PATH` 规避知识库环境污染；
- **边界**：自动化规则 CRUD UI、NSGA-II 冲突目标物化层对齐、rebuild 激活版本物理替换、真实 MES/WMS 适配器、信创/CI-CD/WORM 等外部环境依赖项留待后续。
- **类型**：
- **做了什么**： ： （ ） ， （ ） ， `status:<新状态>` 、note 写入 payload._note（ ） ； `PlanTransitionError` ； `/reject` 端点。
- **为什么**：矩阵 110 行「L0-L3 Plan」剩余项「批准/驳回审计」。
- **验证**： ） ；
- **边界**： （
---
## 2026-08-02 — 多智能体并行交付·第八批： （ ， ）
- **类型**： （ ， ）
- **做了什么**（三个并行智能体写范围互不重叠 + 主控实现矩阵 112） ：
- **方向 V（ ） ： （ ： ， ， ， ） ； （ （ < 30s ） ； test_cp_cumulative . py ` 8 项 。
- **方向 W（ ） ： （ ） （ ， ； ） ； `test_param_opt.py` +5。
- **方向 X（ ） （ @playwright/test ， ， ） ； （ （ ） ；
- **L112（ ） ： ）
- **为什么**：按 plan.md 蓝图继续把矩阵剩余项收口； （
- **验证**： `818 passed` （隔离 `APS_KNOWLEDGE_PATH` ）；前端 `npm run test:e2e` 3 passed + `npm run build` 通过； ；
- **边界**：签名/SBOM 上链/Defender 入 CI 与干净离线机安装冒烟（需外部证书/验证机） ； （ ） ； （ ） ；
- **类型**：
- **做了什么**：主数据「工艺路线」由 antd Tree 改为 **树形表格** （列：名称/编码/类型/来源/用量/图号，行展开折叠）；后端 `build_process_tree` 修复三缺陷——BOM 去重（ ） （ ） ； `typeLabel` /`sourcingLabel`（自制/委外/采购）/`operationName` 等字段（契约只增不删）。
- **为什么**：现场计划员反馈——要树形表格而非纯树；物料必须分原材料/半成品/成品；来源必须分生产(自制)/委外/采购，否则无法排产判断。
- **验证**： （ ； ；
- **边界**：无工艺路线的推导半成品来源按既有规则显示采购（若现场确认为厂内自制需在 infer_material_sourcing 增加按 typeLabel 覆盖）；默认展开策略可按现场反馈收紧。
---
## 2026-08-02 — 多智能体并行交付·第九批：多模态低置信确认/WORM归档模拟/前端StrictMode修复/roadmap对齐（ ，
- **类型**： （ ， ）
- **做了什么**（三个并行智能体写范围互不重叠 + 主控 roadmap 对齐）：
- **方向 Y（ ） ： （ ， **低置信确认门禁** （不完整显式拒绝、高置信直通、低置信 P2 确认卡，确认前绝不写世界状态）+ 审计（ ） ； ；
- **方向 Z（ ） ： ： ， `verify_archive()` （篡改/缺失/merkle 复算不一致检出 + summary） ； `POST /api/gov/archive/run` ；
- **方向 AA（ ） ： `alive` ref 永久置 false（ ） `captureSessionResult` 在 setWorld 更新器内（ ） ； ： ；
- **主控·文档收口**： （ （
- **为什么**：按 plan.md 蓝图继续推进矩阵剩余项；修复 E2E 发现的真实前端缺陷（
- **验证**： `846 passed` （隔离 `APS_KNOWLEDGE_PATH` ）；前端 `npm run build` 通过 + E2E preview/dev 双路径 3 passed；
- **边界**：真实 ASR/VLM 模型服务、物理 WORM 介质、加密/密钥管理、MySQL 实机、签名/Defender/离线机安装与真实 GitHub CI 跑通（均需外部环境）；低置信卡复用 import.commit 动作名（专用 multimodal.apply P2 卡需登记 _POWER_MAP 并同步 harness.md， ）
- **类型**：
- **做了什么**：设置中心「个人偏好」页新增偏好学习卡片：当前默认策略、置信度（高/中/冷启动）、原因文案、得分明细、重置按钮；后端新增 `GET /api/settings/preferences` （ ， ） `POST /api/settings/preferences/reset` ；修复 `algo_skill_stub._stub_input_fingerprint` 误纳含时间戳的 problemId 导致同输入两次运行 runId 不同、EXTERNAL trace 链不可复算（矩阵 114 行可复算性回归缺陷）。
- **为什么**：矩阵 66 行剩余项「UI 展示偏好解释」；全量回归偶发 `test_trace_external::test_external_flex_trace_recomputable_same_input` 失败，定位为 problemId 时间戳污染 runId。
- **验证**： ； ； ：
- **边界**：偏好模型升级为权重回归/规则归纳留待后续轮。
---
## 2026-08-02 — 多智能体并行交付·第十批：审计归档加密/Defender冒烟+离线包校验/桌面升级回滚/测试门禁修复（ ，
- **类型**： （ ， ）
- **做了什么**（三个并行智能体写范围互不重叠 + 主控测试门禁修复）：
- **方向 BB（ ） ： （ ， ） ， （ ）
- **方向 CC（ ） ： （ ， `scripts/offline-install-check.mjs` （ `docs/development/packaging-smoke.md` 。
- **方向 DD（ ） ： `build-upgrade-manifest.mjs` （清单生成/校验）+ `apps/desktop/updater.cjs` （校验→备份 copy/listing→NSIS 静默安装→健康检查→失败自动回滚+本地审计 JSONL， ） （ ） ； `updater-smoke.mjs` 4 项。
- **主控·测试门禁修复**： （ （
- **为什么**：按 plan.md 蓝图继续推进矩阵剩余项；根治每个全量轮次唯一的既有失败（知识库漂移）。
- **验证**： （ `858 passed` （隔离 `APS_KNOWLEDGE_PATH` ， ） ； ；
- **边界**：签名 Authenticode/SBOM 上链/provenance、WORM 物理介质、HSM/KMS 密钥管理、Defender for Endpoint CI 门禁与实时防护演练、干净离线机实机安装、真实 GitHub CI 跑通、NSIS 真装冒烟（均需外部环境/证书/验证机）。
- **类型**：
- **做了什么**： ： （ ） ， （ ） ；
- **为什么**：矩阵 52 行剩余项「分支切换时自动恢复锚定 checkpoint（ ） ；
- **验证**： （ ） ； ：
- **边界**： （
---
## 2026-08-02 — 多智能体并行交付·第十一批： （ ，
- **类型**： （ ， ）
- **做了什么**（三个并行智能体写范围互不重叠 + 主控收口）：
- **方向 EE（ ） ： `node-tests` job（ ） ； `cryptography>=42` ；根 `package.json` 新增 `test:node` （本地 npm run test:node 34/34）
- **方向 FF（ ） ： `version` （ ， （ ） `resolveAuditOptions` → updater Bearer+nonce 客户端链路闭环；
- **方向 GG（ ） ： ， ： `tests/node/nsis-smoke.test.mjs` 13 项 + `docs/development/nsis-smoke.md` 。
- **主控·收口**： （ ） ； ；
- **为什么**：按 plan.md 蓝图收口矩阵剩余本地可做项，把桌面升级/审计/打包链路与 CI 门禁衔接闭环。
- **验证**：全量回归 `861 passed` （隔离 APS_KNOWLEDGE_PATH） ； `npm run test:node` 34/34 + nsis-smoke 13/13 + updater 27 + sidecar 冒烟 5/5； ； ； （
- **边界**： （
## 2026-08-01 — 主数据工艺路线树产品升级（ ，
- **类型**：
- **做了什么**：主数据「工艺路线」页签树重做：根=选中工艺路线的成品（金色「成品」徽标+自制+用量× `build_process_tree` 只增不减补充展示辅助字段（ ） ； `processTreeNodeTitle` /`processTreeToNodes` 与 `.pt-badge--*` /`.pt-src--*` 样式。
- **为什么**：现场计划员需要一眼看清「成品 → 半成品 → 每层各自生成哪些工序」，此前树全部平铺无层级语义。
- **验证**： ； ；
- **边界**：空态 Alert 未在真实数据触发验证；更深层 BOM 子件默认折叠，可在产品迭代中调整默认展开深度。
---
## 2026-08-02 — 多智能体并行交付·第十二批：审计上报端点/HTTP MES适配器/图片元数据提取/信创依赖矩阵（ ， ）
- **类型**： （ ， ）
- **做了什么**（三个并行智能体写范围互不重叠 + 主控实现矩阵 102） ：
- **方向 HH（ ） ： （ （ ） ，
- **方向 II（ ） ： （ ） （ ） ； （ ） ； （ ， ） ； `test_mcp_bus.py` +1。
- **方向 JJ（ ） ：
- **L102（ ） ： （ `scripts/platform-deps-check.py` （ ）
- **为什么**：按 plan.md 蓝图收口矩阵剩余本地可做项（
- **验证**：全量回归 `888 passed` （隔离 APS_KNOWLEDGE_PATH） ； ； ； （
- **边界**：真实 MES 工厂对接（填配置+现场联调）、真实 ASR/VLM/OCR、麒麟/统信四组合实机安装、签名/SBOM 上链、Defender for Endpoint 门禁、干净离线机实机、真实 GitHub CI、main.cjs 新 nonce 传递接线（均需外部环境/证书/后续轮）。
- **类型**：
- **做了什么**：新增 `server/state/branches.py` （ ） ： （ ） ， （ ， ， （ ） ， ； `/api/sessions/{id}/branches` 系列端点（ ） （ ） ； `conversationSide` 纳入分支树。
- **为什么**：矩阵 51 行「项目 -> 会话 -> 分支三级树及分支生命周期」（ ）
- **验证**： （ ） ；
- **边界**：前端分支树 UI、分支合并世界差异 diff、分支切换自动恢复锚定 checkpoint 留待后续轮。
---
## 2026-08-02 — 多智能体并行交付·第十三批： （ ，
- **类型**： （ ， ）
- **做了什么**（三个并行智能体写范围互不重叠 + 主控基线同步）：
- **方向 KK（ ） ： （ （ ） ； （ ）
- **方向 LL（ ） ： （ ） ； ；
- **方向 MM（ ） ： （ ：
- **主控·基线同步**：矩阵「当前验证基线」更新为 round-45 取证（
- **为什么**：按 plan.md 蓝图收口矩阵最后本地可做项；
- **验证**：全量回归 `895 passed` （隔离 APS_KNOWLEDGE_PATH） ； （ ） ； ； `npm run build` 通过；
- **边界**：真实 MES 工厂对接/端点路径现场联调、applyUpdate 途中重启竞态根治（ （
- **类型**：
- **做了什么**：新增 `server/agent_core/tool_runtime.py` ： `_POWER_MAP` 、只读类白名单），未登记意图拒绝执行并写 TOOL 审计（`tool.denied`/P3） ， `handle_intent` （ `tool.run` 审计； `_run_intent` 改为经 `run_tool` 执行。
- **为什么**：矩阵 111 行「LLM 只有提议权」剩余验收「所有 LLM 工具调用都经统一工具运行时；不能通过未登记 API 或直接 store 写入绕过」。
- **验证**： ） ； `unknown` 拒绝、`schedule.run` 直通且双审计落盘。
- **边界**：其余 gateway 直连端点（
---
## 2026-08-02 — 升级链路竞态根治： （ ， ）
- **类型**： （
- **做了什么**： （ `{ok:false, deferredVerification:true, reason:'NONCE_MISMATCH'}` + 审计 `upgrade.health-pending` （ ） ， （ ） ； ） ，
- **为什么**：
- **验证**： `45/45` ；根 node 门禁（ ） ； `895 passed` （隔离 `APS_KNOWLEDGE_PATH` ） ；
- **边界**：跨进程持久化 nonce 续接（应用重启即丢 pending）
- **类型**：
- **做了什么**： `node_at` （时间线按版本取不可变节点，越界/不存在抛 PlanNotFoundError） `replay_verify` （ ） ； `GET /{plan_id}/versions/{version}` （时间线回放）与 `POST /{plan_id}/versions/{version}/replay-verify` （动作级重放校验）。
- **为什么**：矩阵 110 行「L0-L3 Plan」剩余项「时间线回放和 L2 单节点/L3 动作级重放」。
- **验证**： （ `test_plan_runtime.py` 8 项全绿。
- **边界**： （
---
## 2026-08-02 — 升级 pending 跨进程持久化（ ， ）
- **类型**： （
- **做了什么**： `statePath` 持久化——setPending/markInstalled/settle/clear 均原子写 `upgrade-state.json` （ ， ） ； （ ） `{APS_HOME}/upgrade-state.json` ；测试 3 项（持久化往返/过期丢弃/settle 清空） ，
- **为什么**： ）
- **验证**： ； ； ； ，
- **边界**：签名/SBOM 上链、真实 GitHub CI、真实 MES/信创/离线机、WORM 物理介质、HSM/KMS、MySQL 实机等外部项维持矩阵标注。
- **类型**：
- **做了什么**：新增 `server/aps_domain/explore_boundary.py` ： ） ， （ ， （
- **为什么**：矩阵 55 行「Explore 与 Runtime 数据边界」； ，
- **验证**： `test_scenario_compare_does_not_mutate_world` 等 18 项场景/边界测试全绿。
- **边界**：敏感性/鲁棒性等其他 Explore 工具逐一接入统一通道、前端 Explore 与 Runtime 视觉分区留待后续轮。
---
## 2026-08-02 — 外部验收执行手册（ ， ；
- **类型**： （ ；
- **做了什么**：新建 `docs/product/external-acceptance.md` ——按剩余行逐项给出前置条件/验收步骤/验收标准/代码锚点：真实 MES（ （ ） （ ） （ ） （ ） （ （ ） （ ） （ ）
- **为什么**： （ ） ； ， ，
- **验证**：文档门禁 4 passed；
- **边界**：矩阵 10 个 Partial 行状态不变（仍需外部环境）；无代码改动。
---
## 2026-08-02 — 最终验证 + 交付总览（ ， ；
- **类型**： （ ； ）
- **做了什么**：全量黄金测试最终复跑 **895 passed** （隔离 `APS_KNOWLEDGE_PATH` ，确认 round-15~49 十五批累积工作树全绿）；新建 `docs/product/delivery-summary.md` ——总览指标（ ） （ ） （ ）
- **为什么**： （
- **验证**：全量回归 895 passed； ；
- **边界**：矩阵状态不变（仍需外部环境/提交授权）；无代码改动。
- **类型**：
- **做了什么**： ： `project_id` 维度（样本落 projectId） ； `explain` （得分明细 + cold/medium/high 置信 + 依据条数 + 原因文案）与 `reset` （按项目清样本）；样本不足 3 条标记冷启动、并列最高分标记不确定； `schedule.run` 与 gateway `scenario.apply` 调用点传入 `world_key` 实现项目隔离。
- **为什么**：矩阵 66 行「偏好学习影响默认策略」；
- **验证**： `test_m3_knowledge.py` 6 项全绿；端到端 schedule.run 带 world_key 冒烟通过。
- **边界**：前端偏好解释 UI、权重回归/规则归纳模型留待后续轮。
---
## 2026-08-02 — 现场数据保护与文档基线收口（ ，
- **类型**： （ ）
- **做了什么**：按当前工作区重新固化发布前证据口径：① 隔离测试环境下全量 `pytest` **907 passed** ，现场 `master.db` 验证前后各表计数完全不变；② Playwright 默认目标 `127.0.0.1:8003` 时 fail-closed， `E2E_ALLOW_LIVE_BACKEND=1` 才允许连接现场后端；③ `folder.schedule` 富卡显示 **有效 1357 / 问题 53 / 跳过 974** ，跳过行明确不计入问题行；④ Web build 通过，
- **为什么**： ，
- **验证**：全量 `pytest` 907 passed； `master.db` 前后计数完全一致； ； ， `skippedRows` 不计入 `totalErrors` 。
- **边界**： `docs/CHANGELOG.md` 、`docs/product/plan-completion-matrix.md`、`docs/product/delivery-summary.md`、`docs/product/external-acceptance.md`；不修改代码/测试，不提交。矩阵仍为 **50 Done / 10 Partial / 0 Missing** 。
## 2026-08-02 — 目录分析区分「非排产块」：问题行噪声收敛 1027→53（ ， ）
- **类型**： （ ）
- **做了什么**： `_MOM_SKIP_BLOCKS` （生产模型/质检方案/仓储模型/人力资源/客户管理/供应商管理），`analyze_work_dir` 把命中非排产块的 sheet 问题行单独计入 `skipRows/skippedRows` ，不再混入 `errorCount/totalErrors` ； `skippedRows` 。
- **为什么**：锐扬 MOM 收集表的工厂/质检/仓储/人力/客户/供应商块本就不导入，此前 1027 问题行里 974 行来自这些块， ； （ ）
- **验证**：真实目录实测 `totalErrors 1027→53` 、`skippedRows 974`； `904 passed` 。
- **边界**：跳过逻辑按 sheet 名匹配（锐扬模板名），其他模板同名块同样受益；不影响 okRows/确认卡语义。
## 2026-08-02 — 全链路排产就绪验证： （ ， ）
- **类型**：验证（现场排产端到端闭环）
2026-09-08 00:07:26 +08:00
- **做了什么**：将 `订单-样例.csv` （订单号/客户/产品编码/数量/交期/优先级/加急，示例行 SO-RY-20260801） `RUIYANG_DEMO_DIR` 指向的工程目录后，浏览器实测「给我模拟排产一下」：目录分析识别订单 1 有效行，**排产必备全齐（ ） ， ， ： ， ， ） `docs/product/ruiyang-data-runbook.md` 排产必备状态与验证记录。
2026-08-20 10:09:04 +08:00
- **为什么**：证明用户下一步（替换真实订单 → 带我排一版/根据这些数据排产 → P2 确认）端到端可用，现场数据接入全部打通。
- **验证**：浏览器实测如上；无代码改动；全量黄金 `904 passed` 基线不变。
- **边界**：样例行需替换为真实订单（产品编码须在 02/04 表内、交期非空）；问题行 1027 多为非排产块（工厂/质检/仓储/人力等） ； （
## 2026-08-02 — 外部验收手册增补资源清单收集表（ ， ）
- **类型**： （
- **做了什么**： （ ） ， ； （ ）
- **为什么**：外部资源是剩余矩阵项的唯一阻断；把「找谁要什么」固化成表，用户/现场可先行收集，资源到位即可按第 1-10 节执行。
- **验证**：文档渲染核对通过；无代码改动（不需要跑测试）。
- **边界**：资源到位后按单执行并回写矩阵状态；现场用户当前仍等订单表（订单-样例.csv）
## 2026-08-02 — 订单导入支持「加急」列 + 锐扬数据接入手册/订单样例（ ， ）
- **类型**： （ ）
- **做了什么**：① `importers.py` 表头别名新增 `加急→isRush` （订单表常用列，导入后订单带急单标记）；② 在工程目录放置 `订单-样例.csv` （列：订单号/客户/产品编码/数量/交期/优先级/加急，示例行改数即可用）；③ 新增 `docs/product/ruiyang-data-runbook.md` ： （
- **为什么**：现场排产唯一缺口是订单表；给计划员可直接填写的样例与手册，减少来回确认。
- **验证**：新增 `test_order_csv_rush_column_maps_to_is_rush` （ ） ； `903 passed` ；订单样例 CSV 已按 utf-8-sig 落盘（
- **边界**： （ ） ，
## 2026-08-02 — 锐扬 02-工艺模型「制造流程」列提取为工艺路线（ ， ）
- **类型**： （ ）
- **做了什么**： `_rows_from_xlsx` 检测「制造流程/工艺代码/工艺流程」列（锐扬 MOM 02-工艺模型第 17 列起，表头后次行为 01..12 序号），为每个数据行合成 `routing` 视图：`{productCode=ERP品号, seq=序号, operationCode/operationName=工艺代码}`（如 `ZP01组装` →ZP01/组装、`LM01POP拉铆`→LM01POP/拉铆），随 preview_file 按 routing 批校验入库。
- **为什么**：上一轮目录分析显示「工艺路线/工时 ×
- **验证**：真实文件 `totalOk 910→1356` （ `A0050101-00280 seq=1 op=ZP01/组装` ）；浏览器实测「给我模拟排产一下」→ 物料 ✓1356 / 工艺路线 ✓446 / 设备 ✓87 / **仅缺订单** ， `test_xlsx_mom_template_multiblock_headers_soft_preview` （ `903 passed` 。
- **边界**： （ ） ， （ ， `MOM--00280` 交期为空）。
## 2026-08-02 — JMS 无角色用户默认 planner， （ ， ）
- **类型**： （
- **做了什么**： （ `roles` （真实平台实测无该字段）时，默认注入 `planner` 角色（可用 `JMS_AUTH_DEFAULT_ROLE` 覆盖，留空关闭）；`.env` 增加 `JMS_AUTH_DEFAULT_ROLE=planner` 。
- **为什么**：审批角色默认集为 planner/approver/admin，
- **验证**： `roles:["planner"]` ；浏览器端「给我模拟排产一下」→ 目录分析（ **P2 确认卡正常生成** （导入工程目录并试排 · 批准执行/驳回）；`test_jms_auth_provider.py` 新增 3 项（无角色默认 planner / env 覆盖 / 有角色不被覆盖）；全量黄金回归 `903 passed` 。
- **边界**： ；
---
## 2026-08-02 — 锐扬 MOM 收集表模板导入：多行标题/分块表头自动识别（ ， ）
- **类型**： （
- **做了什么**： `_rows_from_xlsx` 改为**表头行自动探测**——按规范化后命中已知字段映射最多的行（序号/编码/名称/单位/数量…）作为表头，跳过「物料清单」等标题行与分块模板（物料组块 + 物料主数据块），平铺表第 1 行即表头时行为不变；② 新增别名：
- **为什么**：现场 `湖南锐扬MOM主数据收集表.xlsx` （ （ （ ）
- **验证**：真实文件实测 `totalOk 0→910` （ ， ） ， （ `test_xlsx_mom_template_multiblock_headers_soft_preview` + `test_xlsx_flat_header_row_0_behavior_unchanged` ；相关 14 项测试通过；全量黄金回归 `903 passed` ；浏览器端「给我模拟排产一下」→ 目录分析显示 910 有效行并出 P2 确认卡。
- **边界**： （
## 2026-08-02 — 「模拟排产」类口令落空修复： （ ， ）
- **类型**： （ ， ）
- **做了什么**： `_is_imperative_schedule` 尾缀正则只支持 `排/排产/排一下/排程` 结尾，`排产一下`、`排产一版`、`模拟排产(一下)` 等口语全部漏匹配，落到 LLM 降级 → `assistant.py` 的「我先按你的话理解一下…想开排说带我排一版」通用引导（现场实测复现）。修复：正则扩展为 `(模拟|试)?排(产|程)?(一下|一版)?` 并加入 `模拟排产` 、`试排一版/一下`、`排一下` 等独立词条；命中后走既有祈使排产路径（工程目录有表 → `folder.schedule` ，否则 `flex.schedule` ）。
- **为什么**：现场用户输入「给我模拟排产一下」得到的是四选一引导而非执行，是「竟然不理解」的直接根因；同批修复 `帮我排产一下` 等同类漏匹配。
- **验证**：快路实测 10 个新/旧祈使句全部 `flex.schedule` /`folder.schedule`；负向守护：`带我排一版`→wizard、`怎么排产`→wizard、`模拟报工`→mes.report、`帮我看看现在能不能排`→assistant.reply、`解析项目文件夹`→folder.analyze 均不被误吞；`test_assistant.py` 扩展祈使句清单 + 新增 `test_simulate_schedule_does_not_hijack_other_intents` ；浏览器实测「给我模拟排产一下」→ 真实解析工程目录 `锐扬` （ `898 passed` 。
- **边界**：若工程目录存在 Excel 但行校验不过，排产口令按产品规则走 `folder.schedule` 数据门禁（提示补齐数据）；真实数据补齐后即可开排。矩阵状态不变。
## 2026-08-02 — OpenAPI 生成回归门禁（ ， ）
- **类型**： （
- **做了什么**：新增 `tests/golden/test_openapi_schema.py` （
1. `test_openapi_schema_generates_without_forward_ref_error` ——`create_app().openapi()` 必须完整生成，且 12 个受影响路由（/api/import/commit、/api/templates/apply、/api/rag/query、/api/rebuild/*、/api/knowledge/import、/api/skills/*、/api/mcp/plugins/*、/api/jobs）
2. `test_affected_request_models_are_module_scope` ——12 个请求模型必须可从 `server.gateway.app` 模块级导入，且 `__qualname__` 不含 `create_app` （直接编码 round-52 修复前的状态，修复前必失败）。
- **为什么**： `/openapi.json` 500 的缺陷，但当时没有回归测试；本测试把该约束固化为黄金门禁，防止后续把模型类再写回函数局部。
- **验证**：新增 2 项通过（ `test_contract_sync` + `test_health_version` 17 项全绿； `GET /openapi.json` 200 不变。
- **边界**：矩阵状态不变（剩余 10 个 Partial 仍依赖外部资源）。
## 2026-08-02 — 修复 /openapi.json 500： （ ， ）
- **类型**： （
- **做了什么**：定位 `GET /openapi.json` 返回 500（ ： `create_app()` 函数体内定义了 12 个路由请求模型类（ ） ， ） ：
- **为什么**：
- **验证**： （ ， ） ； `GET /openapi.json` 200（ ） `/docs` 200； （ ， `APS_KNOWLEDGE_PATH` ） ； `895 passed` **（隔离 `APS_KNOWLEDGE_PATH` ，与 round-50 基线一致） ； （ ） ； （ ）
- **边界**：未改任何路由逻辑；矩阵状态不变（剩余 10 个 Partial 仍依赖外部资源：真实 MES/WMS、ASR/VLM、信创实机、干净离线机、代码签名证书、真实 GitHub CI、WORM 介质、HSM/KMS、MySQL 多主机）。
## 2026-08-02 — 侧栏乱码会话清理 + E2E 测试卫生预防（ ， ）
- **类型**：
- **做了什么**：
1. **修复** ：侧栏出现 `????` / `???????` 乱码任务——定位为早期 E2E 探针残留的空会话（ ， `?` ， `ProjectStore.delete_session` 正规删除， （
2. **预防** ： （
- **为什么**：本地 E2E 冒烟（ ）
- **验证**： （ ） ；
- **边界**： （ ，
- **类型**：
- **做了什么**：新增 `server/agent_core/audit_filelock.py` ： `locked_append` （进程内锁 + Windows msvcrt 区域锁，可配 `APS_AUDIT_LOCK_RETRY_SECONDS` ） ， `audit_mirror.append_event` 均切换接入，防多进程并发写行交错损坏证据；`audit_ledger.archive_old` 清理策略：超过保留窗口（`APS_AUDIT_LEDGER_KEEP_LAST`，默认 10000） `archive/<yyyy-mm>.jsonl` 目录，分级存储而非删除，证据不丢失。
- **为什么**：矩阵 116 行「审计 append-only」剩余项「清理策略、跨进程锁强化」。
- **验证**： （ × ） ；
- **边界**：
---
- **类型**：
- **做了什么**：新增 `server/agent_core/audit_merkle.py` ：完整二叉树 Merkle 树（叶子=事件 hash， `merkleRoot` （与本地复算一致）。
- **为什么**：矩阵 104 行「全审计」剩余项「完整 Merkle 树」； （ ） ，
- **验证**： ） ；
- **边界**： （ ） ；
---
- **类型**：
- **做了什么**：新增 `server/agent_core/audit_notify.py` ：按配置渠道（`APS_AUDIT_ALERT_CHANNELS`， < path > /webhook:< url > ， ） ； `APS_AUDIT_ALERT_DEDUP_SECONDS` （默认 300s） ；
- **为什么**：矩阵 104 行「全审计」剩余项「告警通知渠道」；此前 build_alerts 只聚合、无投递。
- **验证**： （ （ ）
- **边界**： ，
---
- **类型**：
- **做了什么**： `CheckpointStore.create()` 新增可选 `conversationSide` 完整对话侧快照参数（ ） ； `_create_checkpoint` 统一建档入口（自动收集对话侧）、`_restore_conversation_side`（回滚时成对恢复对话侧），全部 23 处 P2 写前建档与回滚分支接入；`test_m2_state.py` 增至 6 项（成对快照往返逐字段一致、不传对话侧向后兼容）。
- **为什么**：矩阵 52 行「对话状态与世界状态真正成对快照、成对切换和成对回滚」；此前仅存 world + conversationNote 摘要。
- **验证**： ； ： （ ）
- **边界**： （
---
- **类型**：
- **做了什么**： `_build_external_trace` /`_external_audit_evidence`/`_external_inputs_hash`， `flex.schedule.external` 审计携带 traceChainHash/traceCount/traceSummary（ ， `GovConsole.tsx` AuditView 新增「可追溯链」列展示 traceChainHash/traceCount/traceSummary（
- **为什么**：矩阵 114 行剩余「EXTERNAL 引擎接入、前端追溯 UI」； ，
- **验证**： （ ） ；
- **边界**：
---
- **类型**：
- **做了什么**： `solveTimeSec` （改为保留在 ALGO_RUN 审计 rationale 顶层字段），使 CP/HYBRID 真实求解（墙钟 > 0） ； `_run_audit_evidence` 把 `schedule-version:<id>` 引用并入审计 `evidence` （对齐 round-15 计划假设 2） ；
- **为什么**：
- **验证**： ；
- **边界**：
---
- **类型**：
- **做了什么**： `_run_schedule` 求解后经 `_build_run_trace` 构造 EvidenceItem 链（ ， `_run_inputs_hash` 输入包指纹） ， `schedule.run` 审计 rationale 新增 `traceChainHash` /`traceCount`/`traceSummary`；
- **为什么**：矩阵 114 行剩余「各引擎实际写入 trace_chain」首个落地（
- **验证**： ；
- **边界**：
---
## 2026-08-01 — 审计完整性告警
- **类型**：
- **做了什么**：新增 `server/agent_core/audit_alerts.py` （ ） ； `alerts` ；前端 `AuditAlert` 类型 + AuditView 按 severity 展示告警条（样式 `.gov-alert-*` ）。
- **为什么**：矩阵 104 行剩余「异常告警」；审计闭环最后一块。
- **验证**： ； ；
- **边界**： ）
---
## 2026-08-01 — 审计合规导出与保留脱敏
- **类型**：
- **做了什么**：新增 `server/agent_core/audit_export.py` ： （ `export_events` （ ， ） ； `GET /api/gov/audit/export?format=json|csv` 导出当前作用域审计事件（脱敏）+ 链/锚定摘要。
- **为什么**：矩阵 104 行剩余「保留脱敏、合规导出」；审计闭环的收尾能力。
- **验证**： （ ； `worldKey` 等含 "key" 子串字段。
- **边界**：
---
## 2026-08-01 — 审批转派（ ）
- **类型**：
- **做了什么**： ， `harness.transfer_confirmation()` + 网关 `POST /api/actions/transfer` ； ） ， `TRANSFERRED` 记录 from/to。
- **为什么**：矩阵 P3「外部副作用二次确认」剩余项（ ） ；
- **验证**： （ ；
- **边界**：批量转派、委托撤销、转派 UI 展示、MySQL 实机故障注入留待后续轮。
---
## 2026-08-01 — 统一 EvidenceItem 可追溯链
- **类型**：
- **做了什么**：新增 `server/agent_core/evidence.py` ： （ ： ） （ < kind > :< id > ` 语法，
- **为什么**：矩阵 114 行剩余「统一 EvidenceItem； ；
- **验证**： （ ；
- **边界**：各引擎实际写入 trace_chain、前端追溯 UI 留待后续轮。
---
## 2026-08-01 — 审批委托（ ）
- **类型**：
- **做了什么**： ； ） ，
- **为什么**：矩阵 P3「外部副作用二次确认」剩余项之一；
- **验证**： （ ；
- **边界**：
---
## 2026-08-01 — 契约生成自动化与差异检查门禁
- **类型**：
- **做了什么**：新增 `scripts/generate_contract_types.py` ：从 `shared/schemas/*.json` 生成 TS 类型声明（ ， `tests/golden/test_contract_generation.py` 5 项门禁（生成器对全部 7 个 schema 可执行、必填字段/枚举与 schema 一致、手写 types.ts 关键面 ⊆ schema、生成确定性）
- **为什么**：矩阵 117 行剩余「契约生成自动化（ ） ；
- **验证**： ；
- **边界**： （
---
## 2026-08-01 — 审计事件独立介质镜像（ ）
- **类型**：
- **做了什么**：新增 `server/agent_core/audit_mirror.py` （ ， ） ； `write_audit` 同步镜像每条审计事件（尽力而为，失败只记日志不阻断业务）；`/api/gov/audit` 有镜像时以镜像为事件源（响应含 `source: mirror|world` ），业务进程修改 world 无法抹掉独立介质证据。
- **为什么**：矩阵 116 行剩余「业务进程无法修改历史事件；独立介质」——此前审计事件只存世界内，改 world 即抹掉。
- **验证**： ； （
- **边界**：镜像默认关闭（`APS_AUDIT_MIRROR=1` 显式启用）；`_mirror_event` 全异常兜底（ ） ；
---
## 2026-08-01 — 文档技术选型漂移门禁
- **类型**：
- **做了什么**：修订 `docs/architecture/overview.md` 与 `docs/product/positioning.md` 的桌面技术选型描述——从「Tauri（ ） （ ， ； ） ， （ `tests/golden/test_doc_drift.py` 门禁：桌面描述必须含 Electron 或「待决策」标注、禁止孤立 Tauri 绝对描述、Hybrid 引擎描述与代码一致。
- **为什么**：矩阵 117 行点名「Hybrid、Tauri/Electron 文档描述漂移」；此前 overview/positioning 与 desktop.md 自相矛盾。
- **验证**： ；
- **边界**：
---
## 2026-08-01 — 审计独立介质锚定（ ）
- **类型**：
- **做了什么**：新增 `server/agent_core/audit_ledger.py` ： `AnchorLedger` （按租户/项目隔离的 append-only JSONL 账本，原子追加 + fsync） ； `anchor` 状态（已锚定/根/事件数/ok） ， `POST /api/gov/audit/anchor` 显式锚定；与既有 `verify_audit_chain` 链式校验互补（事件体篡改由链校验捕捉、哈希序列/账本行删改由锚定捕捉）。
- **为什么**：矩阵「全审计 / 审计 append-only 且可检测篡改」P0 剩余项——此前审计只存世界内，无独立介质与外部锚定证明。
- **验证**： `test_audit_anchor_api.py` 1 项（ ： ；
- **边界**： （ ） ，
---
## 2026-08-01 — 审批意见 UI 输入框（单条+批量）
- **类型**：
- **做了什么**： `note` 参数透传（接口能力此前已就绪，本次补齐前端入口）；审批历史「意见」列由此真正可用。
- **为什么**：页面巡检员 WARN——接口支持 note 但 UI 无输入框，意见列恒显示「—」。
- **验证**： ； ；
- **边界**：无。
---
## 2026-08-01 — 批量审批（ ）
- **类型**：
- **做了什么**：新增 `POST /api/actions/confirm-batch` 批量确认端点（ ， ： ） ； `postConfirmBatch` 与类型同步。
- **为什么**：矩阵 P3「外部副作用二次确认」剩余项之一；
- **验证**： ） ； ； ； （
- **边界**：委托/转派审批、文件→DB 存量迁移、WORM 归档、MySQL 实机故障注入留待后续轮。
---
## 2026-08-01 — 审批意见（ ）
- **类型**：
- **做了什么**： `ConfirmRequest` 支持可选审批意见 `note` ； `DatabaseApprovalStore.decide` 将意见写入 approvals 记录与审批历史事件（驳回路径同样落库）；管理台审批历史新增「意见」列展示；前端 `ApprovalActor.note` 类型同步。
- **为什么**：矩阵 P3「外部副作用二次确认」剩余验收项首个子项；
- **验证**：双后端聚焦 46 passed（ ； `tsc -b` 通过； （
- **边界**：委托/转派/批量审批、文件→DB 存量迁移、WORM 归档、MySQL 实机故障注入留待后续轮。
---
## 2026-08-01 — 契约漂移门禁补全：公共排产契约纳入三方校验链
- **类型**：
- **做了什么**：把 `scheduling_problem` / `scheduling_solution` / `plan_node` 三个公共排产契约纳入 `tests/golden/test_contract_sync.py` 三方校验链（ `orders/routings/resources` （ ） `operations` （ ） `evidenceRefs` 按 schema required 去掉空默认值（ ） ；
- **为什么**：矩阵 P0 批次点名「三层契约漂移门禁」；此前 4 个契约有校验，
- **验证**： （ ） ； ； ；
- **边界**：契约生成自动化与 Hybrid/Tauri 文档漂移门禁留待后续轮次。
---
## 2026-08-01 — 证据链 v1：
- **类型**：
- **做了什么**：把 `mes.dispatch` 的「确认令牌 + 版本证据 + 写前快照、缺项拒绝」统一为全 P2/P3 执行协议。`stage_confirmation` 出卡时冻结 `evidenceRefs` （显式或按 `versionId` 派生 `schedule-version:<id>` ）、`beforeSnapshot` 与 `beforeFingerprint` （输入快照指纹）；`execute_confirmed` 在最终批准后、写世界前执行 `verify_pending_evidence` （版本证据绑定 / 前置快照存在 / 版本可解析， ， ） ； `beforeSnapshot` +`evidenceRefs`。
- **为什么**：完成度矩阵 P0 批次点名「把强关联扩展到其余 P2/P3， ；
- **验证**：新增 `tests/golden/test_evidence_contract.py` 9 项（ `424 passed` （原 397 + 新增） ；
- **边界**：漂移检测采用对象域版本一致性（世界带版本表才解析），不做全局 world 指纹硬拒绝，避免审批期间 P0/P1 合法改世界的假阳性。
---
## 2026-07-31 — 跨主机共享审批存储首切片
- **类型**：
- **做了什么**：保留默认文件审批后端，新增显式 `APS_APPROVAL_BACKEND=database` ；共享模式复用 MySQL `APS_DATABASE_URL` ，以规范化 request/grant/event 表和 revision CAS 协调批准/驳回终态、P3 grant 签发及全局一次消费。最终批准、grant 和审批事件同事务提交，数据库只保存 token SHA-256； `APS_APPROVAL_PATH` 冲突、缺少 URL、方言不符或连接失败均失败关闭且不回退文件。Harness 外部 API、P2/P3、职责分离、TTL 和角色策略语义保持不变。
- **涉及路径**：
- **验证**：
- **文档同步**：
- **遗留**：执行副作用仍存在批准状态提交后、真实执行前的崩溃窗口；待补 outbox/幂等执行状态机、文件存量迁移器、MySQL 多主机故障注入和 WORM 审计归档。
## 2026-07-31 — 按动作与等级细分审批角色策略
- **类型**：
- **做了什么**：新增 `APS_APPROVAL_ROLE_POLICIES` 严格 JSON 配置，可分别按精确 action 和 P2/P3 设置发起、批准、历史查看角色；每种能力按 action > power > 既有全局环境变量确定性解析；未知字段/action/等级、重复键和非法角色结构使整份配置失败关闭；待办、确认解析、批准和历史四条路径统一按动作授权；治理策略 API 保留原字段并追加角色、来源和配置校验状态；
- **涉及路径**：
- **验证**：角色策略专项 `10 passed` ；审批/Harness/MES 聚焦回归 `45 passed` ；最终在全新 `APS_DB_PATH` 的全量黄金 `397 passed in 168.33s`
- **文档同步**：
- **遗留**：审批意见、委托/转派/批量审批、跨主机共享存储和 WORM 审计归档仍待后续切片。
## 2026-07-31 — 固定 CPython Desktop Sidecar 与安装态守护
- **类型**：
- **做了什么**：桌面安装态不再调用系统 Python； ， ； ， ， ， ， ， ； ， `brace-expansion` 5.0.9；根构建引擎同步要求 Node >=22.12.0。
- **涉及路径**：
- **验证**： `33 passed` ； `7 passed` ； ； ；
- **遗留**：当前安装包未签名、使用默认 Electron 图标；尚未在无 Python/无网络的干净 Win10/11 x64、中文和空格安装路径上完成 20 次冷启动、Defender、升级/回滚与真实 APS 大算例验收；`plan.md` 的 Tauri 目标与当前 Electron 实现仍需产品/架构决策。
## 2026-07-31 — CycloneDX SBOM 与本地制品完整性清单
- **类型**：
- **做了什么**：新增固定版本的 CycloneDX npm/Python 生成器，为 Web、Desktop 和冻结 Sidecar 依赖生成可重复、校验通过的 CycloneDX 1.6 SBOM； `signed=false` ，不把本地哈希清单冒充签名 provenance。
- **涉及路径**：
- **验证**： `dist/sbom/release-manifest.json` 。
- **遗留**：尚未接入 CI、签名服务、透明日志或 SLSA provenance； ，
## 2026-07-31 — 审批队列持久化、TTL 与 P3 双人职责分离
- **类型**：
- **做了什么**：新增原子 JSON 审批存储，持久化待审批动作、决策历史和一次性执行凭据；审批与凭据分别支持可配置 TTL， ； ； `worldKey` ，防止第二审批人的个人空间劫持执行目标；全部审计 actor 从认证身份派生，客户端原值仅作为 `requestedActor` 证据；冻结参数摘要和一次性消费语义跨进程重启保持不变；同机文件锁与落盘前刷新阻止多个 worker 重复签发；损坏或非法记录文件隔离为 `.corrupt-*` 并告警；治理台新增审批历史，待办/历史展示发起人、审批进度、等待/停留时长与到期时间。
- **涉及路径**：
- **验证**：审批存储定向含真实 `spawn` 多进程竞争；审批/MES/租户隔离/审计链定向 `41 passed` ， `npm run build:web` 成功。
- **遗留**：跨主机或不保证文件锁语义的网络文件系统仍需事务共享存储；按动作/等级细分角色策略、审批委托/转派/批量审批和 WORM 审计归档仍待后续切片。
## 2026-07-31 — 独立审计 P1/P2 整改
- **类型**：
- **做了什么**： `track/versionId/evidenceRefs` 会被拒绝且不消耗合法凭据； `schedulingVersionId` 反查工单；跨租户查询已知令牌不再泄漏第二确认状态。方案 UI 完全服从后端 `recommendationId` 并禁用 `HARD_REJECTED` ； `createdBy` ，来源固定为 `USER` 。ScheduleResult 的 `EXTERNAL` 、必填字段和求解元数据同步到 JSON Schema/TypeScript。
- **涉及路径**：
- **验证**：首轮审计整改跨模块定向 `43 passed` ；参数替换/81 条边界整改专项 `14 passed` ；最终全量黄金 `337 passed in 148.01s` ；
- **遗留**：审批队列/执行凭据仍为单进程内存态；
## 2026-07-31 — Windows 求解器发布探针
- **类型**：
- **做了什么**：新增隔离子进程探针，重复导入 NumPy/Pandas/OR-Tools 并运行最小 CP-SAT 求解；同时扫描标准输出和错误输出中的 `Windows fatal exception` 、`Fatal Python error`、`0xc0000139`，避免原生加载异常被退出码 0 掩盖。
- **涉及路径**：
- **验证**：仓库 `.venv` 直接五轮探针通过；探针黄金用例通过；包含该用例的最终全量黄金 `337 passed in 148.01s` 。PATH 首位 Anaconda Python 首轮以 `0xc0000139 / WinError 127` 被正确阻断，不属于可发布运行时。
- **遗留**：探针是发布阻断器，不替代对 Anaconda/Python 3.13 与二进制 wheel 组合的根因治理；正式打包环境应使用固定、可复现的 CPython sidecar。
## 2026-07-31 — SC-14 方案优选与蒙特卡洛鲁棒性首切片
- **类型**：
- **做了什么**：
- **涉及路径**：
- **验证**：定向回归 `15 passed` ； `325 passed` ；相关 Python 文件 Ruff 与 `git diff --check` 通过。算法 agent 的独立运行曾打印 OR-Tools→pandas/pyarrow 的 Windows `0xc0000139` 环境异常栈，但主代理最终全量回归未复现，仍保留为发布环境风险。
- **文档同步**：
- **遗留**：
## 2026-07-31 — L0-L3 PlanNode 可重生运行时首切片
- **类型**：
- **做了什么**：新增 L0-L3 共用的不可变 `PlanNode` 契约与项目隔离的追加式 JSON 版本仓；重生保持同一 `planId` 、递增 `version/regenCount` 并保留旧版；规范化 `inputsHash` 校验阻断输入漂移，默认重生 3 次后熔断；提供创建、最新版本、版本历史和重生四个最小 API。
- **涉及路径**：
- **验证**： `8 passed` ；加治理/认证/租户/会话回归集 → `40 passed`
- **文档同步**：
- **遗留**：尚未接入 Agent 自动分解、时间线 UI、审计事件写入与跨进程文件锁；
## 2026-07-31 — P3 外部副作用二次确认
- **类型**：
- **做了什么**： ； ， ； ； `confirmId` 、自动检查点 `beforeSnapshot` 和排产版本 `evidenceRefs` ， ；
- **涉及路径**：
- **验证**： `13 passed` ，覆盖 Gateway 0→1 外部副作用次数、重复令牌不刷新、缺少门禁/快照/证据时拒绝；`npm run build:web` 成功。
- **文档同步**：
- **遗留**：
## 2026-07-31 — 跨层契约版本与漂移门禁
- **类型**：
- **做了什么**： `interfaceVersion=1.0` ；把 `intent.schema.json` 的封闭枚举同步到当前运行时意图全集；增加黄金测试阻断 Pydantic、JSON Schema 与 TypeScript 的版本及 UIBlock/ViewportCommand 枚举漂移； `/api/health` 现在返回同一版本，前端 `InterfaceGate` 在认证和业务界面挂载前完成握手，不兼容或服务不可用时显式阻断。
- **涉及路径**：
- **验证**：契约+认证握手定向 `11 passed` ；
- **文档同步**：
- **遗留**：其余公共排产契约仍需逐步纳入统一生成链；多版本兼容窗口和灰度升级策略尚未建立。
## 2026-07-31 — SC-03 GA 真实求解首切片
- **类型**：
- **做了什么**：新增固定种子的 `GeneticAlgorithmEngine` ，联合搜索订单顺序与具备完整工位映射的候选产线；精英保留保证 RULE 顺序/首选线基线进入种群；代数预算由时限确定性推导，避免墙钟截断破坏固定种子复算；通过统一 `solverMeta` 留存种群、代数、目标值、耗时与种子；`get_engine("GA")` 不再由 RULE 代跑。
- **涉及路径**：
- **验证**： `24 passed`
- **文档同步**：
- **遗留**：方案层 Pareto 已落地；工序级 GA、NSGA-II 种群进化、LNS 和大算例性能基线仍待后续切片。
2026-07-21 11:05:57 +08:00
2026-07-28 02:12:46 +08:00
## 2026-07-24 — 桌面/Web 双形态与 ~/.aps（ ）
- **类型**：
- **背景**：
- **交付**：
- `server/aps_home.py` ： `~/.aps/{skills,sessions,data,…}` ； `server/data`
- Skill 改为目录布局 `skills/<id>/manifest.json` （
- Electron 壳 `apps/desktop/` ；根脚本 `npm run dev:web|dev:desktop` 、`build:web|build:desktop`
- `GET /api/system/paths` ；管理台展示 skills 目录
- 文档：`docs/architecture/desktop.md`
- **测试**：
## 2026-07-23 — 通用机加工排产平台（
- **类型**：
- **背景**：康尼数据硬编码在代码里、工时缺失被引擎默默按 1 分钟兜底、UI 无组件库、Skill 只读、RAG 无管理页且外部算法无法消费、低置信直接拒识不追问。目标：升级为面向整个机加工行业的通用排产平台。
- **交付**：
- **M-A 数据库地基**： （ `master.db` ，多项目隔离）+ world 双向投影（引擎零改动）；康尼口径全部搬进 `server/importers/profiles/kangni.json` （代码零硬编码）；演示数据 → `server/data/packs/demo.json` 数据包（日期按 baseDate 平移重放）
- **M-B 工时闭环**： `TIME_UNMAINTAINED` /`TIME_INFERRED` 冲突；`readiness.query` P0 / `flex.time.update` P2； （ ）
- **M-C UI 改版**： （ #F97316 ）；订单/主数据/柔性面板全面 Table/Drawer/Form/Tabs/Modal 组件化，
- **M-D Skill 管理台**： ） ； `version/capabilities/ragScopes` （旧配置自动升级）；契约 `schemaVersion` ；
- **M-E RAG 平台**： （ ） ； `meta.knowledgeRefs` ；索引状态/重建 API
- **M-F 对话智能**： `schedule.wizard` （缺路线推荐模板/缺工时追问/缺日历给默认，写入全走 P2）
- **M-G 收尾**： `test_e2e_acceptance` （入库→工时维护→向导排产→外部 skill 试排→知识问答）
- **测试**： `tsc --noEmit` 零错误 + vite build 通过
## 2026-07-23 — RAG 知识库 + 外部算法排产 Skill
- **类型**：
- **背景**：知识库仅 bigram 吐原文、无文档导入；排产引擎不可插拔外部算法。
- **交付**：
- RAG： （ ）
- Skill： `SchedulingProblem/Solution` DTO、`ExternalEngine`、`SkillRegistry`、`algo.stub`、口令与 harness 权力登记
- API：
- 文档：`docs/architecture/rag.md`、`skills.md`；
- **测试**：
2026-07-23 13:38:43 +08:00
## 2026-07-23 — 排产方案下载改为 Excel 工作计划表
- **类型**：
- **背景**：用户要求下载应是完整 Excel 工作计划表，而非 Markdown。
- **交付**：
- `build_plan_report` 产出 xlsx（
- 聊天报告块与柔性排产结果块：「下载 Excel 工作计划表」
- `GET /api/reports/files/{id}` + `GET /api/reports/plan?format=xlsx`
- **测试**：
## 2026-07-23 — 委外追问可答 + 排产方案报告可下载
- **类型**：
- **背景**：排产后问「这个订单有委外订单吗」低置信拒识；日报只覆盖固定轨，柔性排产方案无法下载。
- **交付**：
- `master.query` entity=`mrp`：委外/采购/分解建议问答，支持「这个订单」指代
- `report.generate` type=`plan`：柔性排产方案报告（概览+交期+工序明细表），聊天块「下载 .md」
- 口令：生成排产方案报告 / 下载排产 / 导出排产方案；快捷指令同步
- **测试**：
## 2026-07-23 — 「把这个订单排产」指代修复
- **类型**：
- **背景**：刚查到订单后说「给我把这个订单进行计划排产」走 LLM 低置信拒识，未走排产。
- **交付**：
- 快路识别「这个/该订单…排产」「计划排产」「给订单 xxx 排产」→ `flex.schedule` （有 flex 单时）
- `session_focus` ： `orderIds`
- 无焦点且多单时明确提示先查单，不瞎排全池
- **测试**：
## 2026-07-23 — 对话检索订单/主数据 + 机加工工艺知识库
- **类型**：
- **背景**：自然语言无法检索现场订单/主数据；知识库缺机械加工工艺路线生成模式。
- **交付**：
- `master.query` P0：
- `server/knowledge/machining_patterns.py` ：车铣钻磨钣金焊接装配热处理等工艺路线生成模式 + 城轨机构装配模板
- 「知识清单」列出全部资产；口令「机加工工艺怎么生成」「车削工艺模式」等
- **测试**：
## 2026-07-23 — 现场 Excel 同步写入主数据页/订单池（清演示）
- **类型**：
- **背景**：此前只写 `flex*` ，主数据页与订单池仍读固定轨演示表，界面像「垃圾数据」。
- **交付**：
- `load_site_into_world(clear_all=True)` 清空固定轨+柔性轨演示，写入工厂/产线/工位/工序/物料/BOM/路线/`salesOrders` + flex*
- 默认只导入 `订单102285668_完整生产路线.xlsx` 主单
- `ensure_flex_seed` 在现场清空后不再回填 HV/PDU 假数据
- 柔性工作台下拉改为读现场成品/设备，去掉 PDU/HV/PRESS 硬编码
- **验证**： ；
## 2026-07-23 — 康尼现场完整生产路线导入（替换演示 flex*）
- **类型**： （
- **背景**：引擎与文档口径对齐柔性能力池，但默认仍是 HV-HARNESS/PDU 演示假数据；用户要求用现场真实 Excel 把康尼排产流程跑通。
- **交付**：
- `server/aps_domain/kangni_intake.py` ：解析「完整生产路线」+ 同源订单/工艺/BOM；
- `scripts/load_kangni.py` ：清空演示 flex* → 写入现场 → PoolEngine 排产
- `flex.site.load` P2（ `POST /api/flex/site/load`
- 验证：订单 102285668 → 10 工序 VL/WO；
- **已知缺口**：源表标准工时/设备/模具均为「待维护」→ 部装45′ ′ `flexParams.siteInferences` ）
- **测试**：
- **文档**：
## 2026-07-23 — IND-02 SOP→约束规则包
- **类型**： （
- **背景**：知识库可存 SOP， ；
- **交付**：
- `sop.compile` P0 / `sop.apply` P2； `POST /api/sop/stage`
- 换线 SOP→启用 C10 + 跨族默认 60 分 + 16:00 宵禁；齐套 SOP→C6；
- 约束 `C13_sop` ；世界 `rulePacks` / `changeoverPolicy` ；宵禁冲突 `SOP_CHANGEOVER_CURFEW`
- 设置→约束配置「编译并应用」；
- **测试**：
- **顺带**： `mrp.release` 下达
## 2026-07-23 — SC-03 HYBRID 管线（ ）
- **类型**： （
- **背景**：
- **交付**：
- `HybridEngine` ：策略序收集 → RULE 选线 hint → CP-SAT `AddHint` 改良 → 班次占槽
- `solverMeta.pipeline=RULE→CP-SAT→shift-slot` 、`warmStart=RULE`
- 缺 ortools 时 `DEGRADED_RULE` 诚实降级（仍标 HYBRID）
- 口令「混合引擎试排」「HYBRID试排」；
- **测试**： `test_cp_engine.py` / `test_rule_engine.py`
- **验收**： ；
## 2026-07-23 — SC-03 CP-SAT 真求解首切片
- **类型**： （
- **背景**： ，
- **交付**：
- `CpSatEngine` （ ） ：
- `ScheduleResult.solveStatus|solveTimeSec|optimalityGap` ；版本 `solverMeta`
- 排产参数：默认引擎 / CP 时限；
- GA/HYBRID 仍 RULE 代跑并明确注释；缺 ortools → `ENGINE_UNAVAILABLE`
- **依赖**：
- **测试**：
- **验收**： ； ；
## 2026-07-23 — SC-06 主控参数敏感性分析
- **类型**： （
- **背景**：排产参数可改，但缺少 one-at-a-time 扰动与 Tornado 摆幅，难以判断「改哪项最敏感」。
- **交付**：
- `scenario.sensitivity` P1；
- 因子：展望期 / VIP 权重 / 交期缓冲比 / 冻结窗口 / 产线效率
- `EngineParams.deliveryBufferRatio` 、`freezeWindowHours`（显式传入才挂钩 RuleEngine）
- 设置→排产参数「敏感性分析」；
- **测试**：
- **验收**：主干不变；摆幅降序；更紧缓冲延期不降
## 2026-07-23 — SC-08 批次/战役合并
- **类型**： （
- **背景**：同产品近交期订单仍各自 PO， ；
- **做了什么**：
- 策略 `CAMPAIGN` ：交期窗 7 天同品合并；插单/预测单排；
- `campaign.preview` P0； `poSaved`
- 口令「战役合并预览」「战役合并试排」
- **验证**： `test_m2_state` 五卡；全量 golden；
---
## 2026-07-23 — SC-07 换型最小化策略
- **类型**： （
- **背景**： ，
- **做了什么**：
- 策略 `CHANGEOVER_MIN` （
- 方案对比增加换型卡与 `totalChangeoverMin` KPI
- 口令「换型最小化试排」；插单面板可选该策略
- **验证**： `test_m2_state` 四卡；全量 golden；
---
## 2026-07-23 — MD-06 换型矩阵主数据
- **类型**： （
- **背景**：引擎仅有标量 setupTime， × ，
- **做了什么**：
- `changeoverMatrix` + 物料 `productFamily` ； `master.changeover.upsert`
- RuleEngine 同线跨族叠加首道准备；约束中心 C10 可关
- 主数据「换型」页；口令「查看换型矩阵」「设置换型 …」
- **验证**： ；
---
## 2026-07-23 — PL-06 产供方向决策
- **类型**： （
- **背景**：削峰后仍超载时，缺加班/扩线/外协的结构化产供选项（此前仅靠叙事）。
- **做了什么**：
- `plan.supply` ：先削峰，残留缺口按加班→扩线→外协覆盖；`verdict` + options/gaps
- `GET /api/plan/supply` ；分桶视口「产供」；口令「产供决策」「加班建议」「外协建议」
- **验证**： ；
---
## 2026-07-23 — PL-05 产能平衡 / 削峰
- **类型**： （
- **背景**：排产层有 CAPACITY_BALANCE，
- **做了什么**：
- `plan.leveling` ：有限分桶上先提前后延后挪动；输出建议+前后负荷对照
- `GET /api/plan/leveling` ；分桶视口「削峰」；口令「削峰」「产能平衡」
- **验证**： ；
---
## 2026-07-23 — PL-04 库存投影
- **类型**： （
- **背景**：计划层缺随时间库存曲线，断料只能在齐套/MRP 事后发现。
- **做了什么**：
- `plan.inventory` ：期初+在途+成品交期/BOM 毛需求+采购到货；日/周投影；断料/安全库存告警
- `GET /api/plan/inventory` ；分桶视口「库存投影」；口令「库存投影」「库存投影 CTRL-A」
- **验证**： ；
---
## 2026-07-23 — PL-03 可行性分析
- **类型**： （
- **背景**：延期只能在详细排产后看见，缺计划层前置「能否按期 + 缺口在哪」。
- **做了什么**：
- `plan.feasibility` ：交期排序累计需求 vs 累计粗能力；
- `GET /api/plan/feasibility` ；分桶视口「可行性」页；口令「可行性分析」「能否按期」
- **验证**： ；
---
## 2026-07-23 — PL-02 有限/无限产能粗评估
- **类型**： （
- **背景**：分桶计划仅有限产能视角，缺西门子式无限产能粗评估与双模式对照。
- **做了什么**：
- `capacityMode=FINITE/INFINITE` ：无限不卡能力、给所需日产 + 有限参照；`plan.rccp` 对照摘要
- `GET /api/plan/rccp` ；分桶视口有限/无限切换；口令「有限产能粗评」「无限产能粗评」「粗能力对比」
- **验证**： ；
---
## 2026-07-23 — PL-01 时间分桶计划
- **类型**： （
- **背景**：计划层缺日/周/月时段建模，中长期需求与粗能力只能看排产后负荷。
- **做了什么**：
- `plan.buckets` P0： ；
- `GET /api/plan/buckets` ；视口「分桶计划」；口令「时间分桶」「分桶计划」「混合分桶」
- **验证**： ；
---
## 2026-07-23 — OR-05 预测 / 长周期订单
- **类型**： （
- **背景**：计划层缺独立预测需求台账；销售订单与预测混排会污染正式承诺。
- **做了什么**：
- `forecastOrders` + `forecast.upsert` /`delete`/`convert` P2、`forecast.query` P0；
- RuleEngine `includeForecast` ：
- 订单面板预测视图；口令「查看预测」「新建预测」「预测纳入试排」「预测转正」
- **验证**： ；
---
## 2026-07-23 — AG-08 项目 / 会话服务端化
- **类型**： （
- **背景**：项目/会话/消息只存浏览器 localStorage， ，
- **做了什么**：
- `server/data/projects.json` + `ProjectStore` ；
- `GET/PUT /api/workspace` 、项目/会话/消息 API； `message.*` / `workspace.replace` P1
- 前端启动拉取/本地迁移；防抖同步；消息优先服务端；删项目不碰世界
- **验证**： ；
---
## 2026-07-22 — OR-04 紧急插单专用流
- **类型**： （
- **背景**：急单仅能勾 `isRush` 或走柔性 `flex.rush` ，缺少固定轨「先快评再采用」专用流。
- **做了什么**：
- `rush.evaluate` P1 双沙盒对比（受影响订单/延迟/冲突差分）；主干零接触
- `rush.apply` P2：
- 订单面板插单向导；口令「插单快评」「紧急插单 200件控制器A」「采用插单」；
- **验证**： ；
---
## 2026-07-22 — OR-03 订单池 / 审核 / 变更
- **类型**： （
- **背景**：销售订单无审核态，新建即进排产，缺少业务台账泳道。
- **做了什么**：
- 状态机 DRAFT→SUBMITTED→APPROVED/REJECTED； ；
- `order.submit` P1、`order.approve`/`order.reject` P2； ；
- 订单面板泳道 + 提交/批准/驳回/批量批准；口令「订单池」「提交审核」「批量批准」
- **验证**： ；
---
## 2026-07-22 — SC-04 约束注册表 + 配置中心
- **类型**： （
- **背景**：冲突检测内嵌引擎，无法配置硬/软与启停；发布不区分硬约束。
- **做了什么**：
- `ConstraintDef` 目录 + `constraintProfile` ；版本快照约束配置
- RuleEngine/PoolEngine 读齐套软硬与维保/产能/班组/模具/滚动窗开关
- 发布前硬约束门禁；设置 → 约束配置；口令「关闭物料齐套」「齐套改为硬约束」
- **验证**： ；
---
## 2026-07-22 — OR-02 优先级与客户等级权重配置
- **类型**： （
- **背景**：策略排序只用 `priority` /`deliveryDate`，主管无法配置 VIP 相对权重；设置页无排产参数。
- **做了什么**：
- `scheduleParams.customerLevelWeights` ； ）
- `params.query` P0 / `params.update` P2；
- 设置 → 排产参数滑杆；
- **验证**： ；
---
## 2026-07-22 — AG-07 主动引导（空态 / 冲突 / 知识未命中）
- **类型**： （
- **背景**：欢迎页与空态仍是静态文案；冲突高/知识未命中缺少可点击下一步。
- **做了什么**：
- `build_guidance` + `guidance.next` P0 + `GET /api/guidance`
- 对话 `guidance` 块、欢迎页动态 starter、甘特空态；
- 口令「下一步建议」
- **验证**： ；
---
## 2026-07-22 — EX-06 资源利用率增强（设备热力 + 班组并发）
- **类型**： （ ） （
- **背景**：负荷热力只覆盖固定产线；柔性设备/班组利用率缺独立视口；
- **做了什么**：
- `build_utilization_report` + `GET /api/analytics/utilization` ：
- 视口「利用率」；口令「打开资源利用率」；柔性工作台展示班组清单
- 文档：
- **验证**：
---
## 2026-07-22 — OR-06 订单钉扎（柔性链）+ SC-12 文档对齐
- **类型**： （ ） （ ）
- **背景**：固定轨 `plan.trace` 已有；康尼需 FO→BOM/路线→虚拟产线→工单/设备钉扎；
- **做了什么**：
- `flex_plan_trace` + `plan_trace(track=flex|auto)` ；
- 柔性工作台「钉扎」页；口令「钉扎 FO-2601」「追溯柔性订单」
- implementation-spec：
- **验证**：
---
## 2026-07-22 — EX-07/08 方案对比表 + KPI 仪表盘
- **类型**： （ ）
- **背景**：视口仅有迷你 KPI 卡与方案卡，缺独立仪表盘与逐项 diff 表。
- **做了什么**：
- `build_kpi_dashboard` / `GET /api/analytics/kpi` ：固定+柔性+MES+冲突聚合；
- `build_compare_table` / `GET /api/analytics/compare` ：策略/三模式逐项最优高亮与 delta；
- `query.kpi` / `scenario.compare` / `flex.compare` 联动切换视口
- **验证**： ；
---
## 2026-07-22 — EX-05/09 MES 下发与报工回流（ ）
- **类型**： （
- **背景**： ；
- **做了什么**：
- `MockMesClient` + `mes.dispatch` （ `mes.report` （
- 柔性版本下发后标 `DISPATCHED` ；工序进度与订单整单完工联动
- API： ； ；
- **验证**： ；
---
## 2026-07-22 — MD-05 SAP 集成桩（入站拉单 / 出站回写）
- **类型**： （
- **背景**：康尼验收需 SAP↔APS 双向同步；本期用进程内 Mock，
- **做了什么**：
- `MockSapClient` （ ） `sap_sync` 入站写柔性订单/库存、出站幂等回写
- 意图：`sap.status` P0； ；
- API： ；
- **验证**： ；
---
## 2026-07-22 — EX-04 固定轨甘特拖拽调程
- **类型**： （
- **背景**：柔性甘特已可拖；固定轨仍只读。
- **做了什么**：
- `schedule.adjust.preview` / `commit` ：工位占槽、同 PO 工序先后、维保窗口校验；提交复制 PO/WO 为新草稿
- API：
- **验证**：
---
## 2026-07-22 — EX-04 柔性甘特拖拽调程
- **类型**： （
- **背景**： ；
- **做了什么**：
- `flex.adjust.preview` （ ） ：
- `flex.adjust.commit` （ ） ： ，
- API：
- **验证**： ；
---
## 2026-07-22 — EX-03 冲突解决工作流（建议 + 一键修复）
- **类型**： （
- **背景**：冲突此前只能在排产结果里「看见」，无法按建议修复。
- **做了什么**：
- `conflict.list` / 冲突中心：最新版本未解决冲突 + 按类型的可执行建议
- `flex.conflict.resolve` ：
- API：
- 柔性工作台「冲突」页；对话「查看冲突」「解决冲突」
- **验证**： ；
---
## 2026-07-22 — 故障优先 L1 + EX-10 预测预警 + 实时分钟窗
- **类型**： （
- **背景**：故障一律全量重排过粗；产能池缺短中长期预测；滚动层缺实时分钟精度。
- **做了什么**：
- **DY-01**： ， （ ） ； ；
- **EX-10**：产能分析补 4h/1d/1w 负荷利用率与 ≥85%/95% 预警列表；视口产能池展示预测芯片与告警条
- **SC-12**： （ ） ； ；
- **验证**：相关 golden + 全量；`tsc`
---
## 2026-07-22 — DY-01 真·L1 局部换机 + L2/L3/L4 升 P2 确认卡
- **类型**： （
- **背景**：窗内重排此前直通执行；局部换机此前靠故障缩池整单重排，非真 L1。
- **做了什么**：
- **L1**： `local_swap_equipment` — 池内空闲备机接手，只改目标工单，他单时段与设备不变，不新建版本；口令「局部换机 PRESS-01」； ；
- **L2/L3/L4**： **P2** ；对话与 `POST /api/flex/reschedule` 只出确认卡，批准后 `execute_confirmed` 执行并自动建档
- 柔性工作台分级重排走确认卡 UI
- **验证**： `test_reschedule_is_p2_and_preview` + golden；
---
## 2026-07-22 — 康尼 SC-12 滚动窗 + DY-01 L2/L3 + SC-11 班组约束
- **类型**： （ ）
- **背景**：验收剧本仍缺滚动分窗与窗内重排、班组人力未进引擎。
- **做了什么**：
- **SC-12**： （ ） ，
- **DY-01**： ；
- **SC-11**： `teamCode`
- 柔性工作台增加滚动排产与 L2/L3/L4 按钮；对话「短窗重排」「滚动排产」
- **验证**： ；
---
## 2026-07-22 — 康尼需求 P0 闭环：交期三区间 / 模具寿命 / 故障插单 / 柔性工作台
- **类型**： （ ）
- **背景**：用户要求先完善康尼相关能力；此前引擎有、产品面板与 DY/PL 缺口大。
- **做了什么**：
- **PL-08**：交期承诺补悲观区间 + `gaps` 资源缺口建议；对话块与柔性工作台询价
- **MD-07/SC-10**：排产消耗模具寿命，到限自动 LOCKED；
- **DY-01**：
- **SC-13**：
- **EX-10**：柔性工作台「资源 What-if」停机/调区即时重算产能
- 右侧「柔性工作台」：排产 / 交期 / 异常 / What-if 四页签
- **验证**： ； `tsc`
---
## 2026-07-22 — MD-04 导入管线 + 柔性主数据页 + EX-10 产能池仪表盘
- **类型**： （
- **背景**：
- **做了什么**：
- **MD-04**： `POST /api/import/preview|commit` （ `flex*`
- **MD-08/09**：主数据「柔性资源」页签（设备/模具/工序池/区域只读 + 导入联动）；`master.clear` 增 `flex` 范围
- **EX-10**：视口「产能池」模式 + `PoolCapacityView` （负载色标）；口令 `flex.capacity` 联动切池并刷新
- 订单/主数据面板挂载 `ImportBar` ；黄金测试 `test_importers.py`
- **验证**： `tsc`
---
## 2026-07-22 — 主数据一键清理改为真正清空
- **类型**：
- **背景**：资源页点「一键清理」后工厂/产线仍在——原实现是回种种子，不是清空。
- **做了什么**：
- **验证**：
---
## 2026-07-22 — 订单/主数据一键清理
- **类型**： （ ）
- **背景**：订单与主数据录入后缺少板块级清空，演示/试错不便。
- **做了什么**：
- 订单面板「一键清理」→ `order.clear` ：清空销售订单 + 采购/委外建议（ ）
- 主数据面板「一键清理」→ `master.clear` ：按当前页签（资源/工艺模型/日历维保）回种到种子基线（订单与历史排产不碰）
- 对话口令：「清空全部订单」「清理工艺模型主数据」
- **验证**： `tsc`
---
## 2026-07-22 — 订单删除 + 自然语言新增/批量导入（订单与主数据）
- **类型**： （ ）
- **背景**：订单面板只有取消没有删除；主数据/订单虽可表单维护，但缺少对话侧自然语言新增与批量导入。
- **做了什么**：
- `order.delete` ：物理删除销售订单，同步清该单草稿采购/委外；面板「删除订单」+ 口令「删除订单 SOxxxx」
- `data.import` ：口令「导入订单 / 导入物料」解析多行 CSV 或口语行，
- `master.material.upsert` 对话新建物料；订单 `order.upsert` 继续支持自然语言建单
- 快捷指令与欢迎语补充录数示例；`intake.py` 解析模块
- **验证**： `tsc`
---
## 2026-07-22 — 工艺模型 CRUD 起步（对齐聚制云主数据分层）
- **类型**： （ ）
- **背景**： ，
- **做了什么**：
- `masterdata.py` ：物料新建/全字段/停用； `operations` /`lineProducts`
- 发号器补 material/bom/operation/routing/lineProduct； `master.operation.upsert` / `master.lineProduct.upsert`
- 前端主数据「工艺模型」拆页签：物料 / BOM / 工序 / 工艺路线 / 产线绑定
- 黄金测试 M6：
- **验证**： `tsc`
---
## 2026-07-22 — 对齐聚制云：计划追溯链 + 主数据/排产依据可查
- **类型**： （
- **背景**：对照 `demand/聚制云…操作手册 V1.1` ，当前主数据维护无分层顺序、排产结果无法沿 SO→BOM/路线→采购委外→PO/WO→负荷/库存追溯，用户感知“混乱、找不到依据”。
- **做了什么**：
- 产品文档 `docs/product/master-data-and-plan-chain.md` ：手册主数据分层、计划链、与现状缺口、目标追溯模型
- 后端 `server/aps_domain/trace.py` + `GET /api/plan/trace` + 意图 `plan.trace` ：一单给出主数据依据、分解、排产工单、负荷分钟、库存缺口与缺失项
- 订单面板「追溯」页 + 聊天 `plan-trace` 块；快捷口令「追溯订单依据」
- 知识库补种：主数据录入顺序 / 工艺路线配置 / 订单排产与追溯 / 库存齐套口径 / 柔性轨说明（旧库幂等补齐）
- **验证**：进程内分解+试排后追溯可见 BOM 缺口、工单、产线负荷；`pytest`/tsc 见本轮末
---
## 2026-07-22 — 外围功能补齐（只留核心算法待调）：柔性可视化 / 对话建单 / MRP 下达 / 视口细节
- **类型**： （ ， ）
- **背景**：核心算法（固定产线 RuleEngine、柔性 PoolEngine） ； ， ， ， （
### 批次 A — 柔性排产可视化闭环
- **后端** `server/aps_domain/flex.py` + `server/gateway/app.py` ：新增 `flex_gantt_view` 与 `GET /api/flex/gantt` （行=设备按区域分组，条=柔性工单，含换型/移动/加工分解、瓶颈/超期/冲突标记）
- **前端**： `FlexGanttData` /`fetchFlexGantt`；新增 `viewport/FlexGanttView.tsx` ； ； `WorldData` 扩展 `flexGantt` ，
- **联动**： `viewport.mode=flex` +`world.refresh`，右侧自动切到柔性甘特并 capture 会话结果 —— 解决「柔性排产完了看不到工单」
### 批次 B — 对话/写入闭环
- **order.upsert 对话建单**：
- **text UIBlock**： `TextBlock` 渲染（标题+正文+要点），不再静默丢弃
### 批次 C — MRP 建议单确认下达（ ）
- `mrp.py` ： `apply_mrp_release` （ ，
- `harness` 注册 `mrp.release` =P2； `execute_confirmed` 执行（写前自动建档）；`intent` 加「下达」快路 + LLM 提示
- `POST /api/mrp/release` 出确认卡；`OrderPanel` 分解视图加「确认下达全部/只采购/只委外」按钮与 DRAFT/已下达状态徽标
### 批次 D — 视口细节
- 视口工具栏「时间粒度」徽标改为可点切换（天⇄小时）
- 负荷热力视图响应产线聚焦（`load_view` 行补 `lineCode` ，
- **验证**： `tsc --noEmit` 通过、`vite build` 成功；进程内实测 order.upsert（ ） （ ）
---
## 2026-07-22 — 柔性排产结果可下钻：每条产线给出工单级依据 + 冲突原因
- **类型**： （ ）
- **背景**：用户反馈「排产结果很混乱，要每条结果都有数据可依据」。原 flex-schedule 块只给完工时间与准时/超期标签，看不到时间是怎么算出来的。
- **做了什么**：
- **后端** `server/aps_domain/workflow.py` 的 `_run_flex` ：结果块新增两部分依据——
- 每条虚拟产线携带 `steps` （工单级明细：序/工序/设备+区/模具/换型min/移动min/加工min/起止时段/是否瓶颈）
- 顶层 `conflicts` （
- **前端** `apps/web/src/chat/ChatPanel.tsx` 的 `FlexScheduleBlock` ：行可点击展开，内嵌工单明细表 + 表尾说明「完工时间 = 各工序(换型+移动+加工)沿工艺顺序跨班次累加」；底部列出冲突依据清单
- **样式** `apps/web/src/styles.css` ：新增 `.flex-line-row/.flex-detail/.flex-step-table/.flex-conflicts` 等
- **验证结果**（ ） ： ） ；
- **回归**： （ ） ， （ ）
---
## 2026-07-22 — 柔性演示数据重做：对齐康尼芜湖 4 产品共线场景
- **类型**： （ ）
- **背景**：原柔性种子只有 2 产品（线束/PDU） ，
- **做了什么**（ `_seed_flex` ，忠实吸收 demand §3.2/§3.3/§6.1） ：
- **4 类产品**：高压线束总成 HV-HARNESS、PDU 配电单元 PDU-UNIT、充电枪总成 CHARGE-GUN、高压连接器 HV-CONN
- **10 道工序**，四类瓶颈与方案 §6.1 对齐：压接端子(线束)、激光焊接(PDU·全厂最紧)、控制盒装配ESD(充电枪)、插拔力测试(连接器)
- **22 台设备 / 4 区域**： × × × × × × × × × ×
- **5 副压接模具**家族（代表 50+ 套）、**12 项物料 + 8 条 BOM**（
- **10 张多品种小批量订单**（ ， ）
- 班组扩到 5 个覆盖新工序
- **验证结果**（进程内核对）：跑一版柔性排产 → 10 条虚拟产线 / 56 工单；瓶颈识别 = 压接(4台)·焊接(1台)·ESD(2台)·插拔力(1台)；瓶颈产能法：限制性瓶颈=激光焊接≈88件/天、ESD≈182、插拔力≈228、压接≈1795（
- **同步更新**： （ ；
- **涉及路径**： `tests/golden/test_pool_engine.py`
- **验证**：全量 `pytest` **51 passed** ；
- **注意**：旧 world.json 会被 `ensure_flex_seed` 幂等补种为旧结构——要看新数据需**重启后端并「重置数据」**（或删除持久化 world.json）
- **文档同步**：本文件
---
## 2026-07-22 — 修复：对话气泡样式塌陷 + 柔性回复图文表格化
- **类型**： （ ）
- **背景（缺陷）**：
1. 右侧用户气泡出现「短中文一字一行竖排」——根因是 `.bubble` 的 `word-break: break-all` 遇上 `.msg.user .msg-content` 的 `align-items:flex-end` ，令气泡塌陷到"单字符最小宽度"
2. 左侧柔性排产/瓶颈产能/交期承诺回复**全是纯文字**，可读性差
- **做了什么**：
- `apps/web/src/styles.css` ：修 `.bubble` → `width: fit-content; max-width: 100%; overflow-wrap: break-word; word-break: normal` （ ， ） ； （
- `server/contracts.py` + `apps/web/src/api/types.ts` ： `flex-schedule` / `flex-capacity` / `flex-due`
- `server/aps_domain/workflow.py` ：三个柔性处理分支改为「一句话结论文案 + 结构化 UIBlock」——排产结果给 KPI 指标格 + 虚拟产线表（产品/数量/工序数/完工/交期/准时标签）+ 瓶颈标签；瓶颈产能给各能力池日产能条形图（瓶颈池橙→黄高亮）；交期承诺给乐观/预计双卡
- `apps/web/src/chat/ChatPanel.tsx` ：新增 `FlexScheduleBlock` / `FlexCapacityBlock` / `FlexDueBlock` 三个渲染组件；快捷指令加「跑一版柔性排产 / 瓶颈产能 / PDU 500套什么时候能交」
- **涉及路径**： `apps/web/src/chat/ChatPanel.tsx` · `apps/web/src/api/types.ts` · `server/contracts.py` · `server/aps_domain/workflow.py`
- **验证**： `pytest` **51 passed** ；
- **注意**：需**重启后端** + 前端热更新（或刷新页面）生效
- **文档同步**：本文件
---
## 2026-07-22 — 修复：柔性排产接入对话意图管线（不再降级乱答）
- **类型**：
- **背景（缺陷）**：柔性排产此前只有 `/api/flex/*` REST 接口，**未进意图管线**。用户在对话里说「走一个全流程排产」时，既不命中固定产线 `schedule.run` （其要求"试排/重排/跑一版"动词），就降级到 LLM/知识库，
- **做了什么**：
- `server/contracts.py` ： `flex.schedule` / `flex.capacity` / `flex.simulate_due` （并补登此前遗漏的 `order.decompose` ，修掉其经对话触发时的契约校验隐患）
- `server/agent_core/intent.py` ：一级规则快路新增柔性触发词——柔性/能力池/虚拟产线/多品种小批量/全流程排产，以及方向词 正排(ASC)/倒排(DESC)/瓶颈锚(BOTTLENECK)（方向词在本系统仅 PoolEngine 实现，故归柔性）；交期问句（何时/多久能交 + 产品 + 数量）→ `flex.simulate_due` 并抽出 `productCode` /`quantity`；同步补 LLM 意图枚举
- `server/aps_domain/workflow.py` ：新增 `flex.schedule` （回执版本/虚拟产线/瓶颈/准时率/各单完工）、`flex.capacity`（瓶颈产能法各池日产能 + 限制性瓶颈）、`flex.simulate_due`（乐观/预计完工）三个处理分支与文案；`_HELP` 增列柔性口令
- `server/state/seed.py` ：新增幂等 `ensure_flex_seed()` ；柔性领域服务在读写前调用，**旧 world.json（
- `server/agent_core/harness.py` ：登记 `flex.capacity` /`flex.simulate_due` 为 P0（ ）
- **涉及路径**： `server/agent_core/intent.py` · `server/aps_domain/workflow.py` · `server/aps_domain/flex.py` · `server/state/seed.py` · `server/agent_core/harness.py` · `tests/golden/test_pool_engine.py`
- **验证**：新增意图路由护栏 F12（ `pytest` **51 passed** ；
- **注意**：需**重启后端**加载新代码；旧世界首次触发柔性口令会自动补种（无需 `重置数据` ）
- **文档同步**：本文件
---
## 2026-07-22 — 柔性排产全流程操作手册 + 自然语言流程描述
- **类型**：
- **做了什么**：
- 新增 [`docs/product/flex-simulation-guide.md` ](./product/flex-simulation-guide.md )：第一部分「自然语言全流程描述」（设备虚拟化→能力池→虚拟产线→瓶颈产能→交期承诺→动态重排，用大白话讲一遍）；第二部分走法 A 一键脚本；第三部分走法 B 逐接口（ `Invoke-RestMethod` 示例 + 端点速查）；第四部分走法 C 换真实数据；第五部分验收清单 + 常见问题
- 在 `docs/product/README.md` 与大管家 `docs/README.md` 导航登记本手册与数据采集模板
- **涉及路径**： `docs/product/README.md` · `docs/README.md` · 本文件
- **验证**：文档交叉引用自检；命令与端点签名对照 `server/gateway/app.py` / `scripts/flex_simulation.py` ；未改运行代码
- **文档同步**： `docs/README.md` · 本文件
---
## 2026-07-22 — 柔性排产全流程模拟 + 瓶颈产能法 + 三模式差异化
- **类型**：
- **做了什么**：
- 新增端到端模拟脚本 `scripts/flex_simulation.py` ：一次跑通「主数据/产能池 → 瓶颈锚排产+虚拟产线甘特 → 瓶颈产能评估 → 正/倒/瓶颈锚三模式对比 → 交期承诺(PDU 500套) → 动态重排(紧急插单 / 设备故障)」全链路，全中文可读输出
- 新增 `capacity_analysis` （瓶颈产能法 PL-07） `GET /api/flex/capacity` ：按能力池算日产能=池可用工时÷单件工时，标出限制性瓶颈（本演示=单机激光焊接池 88件/天，对照台账法压接池虚高 1920件/天）
- 修 `PoolEngine` 倒排（ ） ： ， （ ； ）
- `PoolEngine` 结果新增 `makespan` （最晚完工）与 `onTimeCount` （准时单数）
- 动态调度双案例：可移动压接机故障（池化韧性、日产能 1795→1344 仍有冗余） ，
- **涉及路径**： `server/engines/pool_engine.py` · `server/aps_domain/flex.py` · `server/gateway/app.py` · `tests/golden/test_pool_engine.py` · `docs/**`
- **验证**： **48 passed** （原 46 + 新 F10/F11） ；
- **文档同步**： （ ） `product/implementation-spec.md` · `architecture/harness.md` （
- **遗留**：前端虚拟产线甘特 + 产能池仪表盘（ ） ； （ ） （ ， ）
---
## 2026-07-22 — 柔性排产首切片：设备能力池 + 虚拟产线（ ）
- **类型**：
- **做了什么**：
- 新增柔性排产引擎 `server/engines/pool_engine.py` （ ， ） ： （ ； **ASC 正排 / DESC 倒排 / BOTTLENECK 瓶颈锚** 三模式（吸收 `排产逻辑.ppt` ）
- 种子追加 `flex*` 数据（`server/state/seed.py` 的 `_seed_flex` ） ： × `HV-HARNESS` /`PDU-UNIT` 及工艺/BOM/订单/参数；与固定产线层**并行独立键**，不进 RULE 引擎与既有计数
- 新增领域服务 `server/aps_domain/flex.py` ：能力池投影 `capability_pools` 、`flex_overview`、`run_flex_schedule`（ `harness.guard` +审计）、`simulate_due`（交期承诺模拟雏形，深拷贝沙盒）
- 端点：`GET /api/flex/world` · `POST /api/flex/schedule` · `POST /api/flex/simulate-due` ； `flex.schedule` P1
- 产出数据采集模板 `docs/product/demand-data-intake.md` （ ）
- 黄金测试 `tests/golden/test_pool_engine.py` （ – ：
- **涉及路径**： `server/engines/__init__.py` · `server/aps_domain/flex.py` · `server/state/seed.py` · `server/state/store.py` · `server/agent_core/harness.py` · `server/gateway/app.py` · `tests/golden/test_pool_engine.py` · `docs/**`
- **验证**： **46 passed** （原 37 + 新 9， ）
- **文档同步**： （ ） `product/implementation-spec.md` · `product/demand-data-intake.md` · `architecture/harness.md` · `architecture/modules.md` · 本文件
- **遗留**：前端虚拟产线甘特 + 产能池仪表盘（ ） ； （ ） ； （ ） ； ； （
---
## 2026-07-22 — 吸收 demand/ 真实需求进产品文档
- **类型**：
- **做了什么**：
- 解析 `demand/` ： （ ） （
- 新增 `docs/product/demand-kangni-wuhu.md` ：抽象为行业无关能力，并与现有编号映射；明确非绑定客户工厂
- `features.md` 登记 MD-08/09、SC-12~14、PL-07/08、EX-10、DY-01、IND-03；
- 同步 `implementation-spec` 编号总表、`positioning` 需求输入声明、product/大管家索引；`.gitignore` 忽略本地提取目录
- **涉及路径**： `docs/product/features.md` · `docs/product/implementation-spec.md` · `docs/product/positioning.md` · `docs/product/README.md` · `docs/README.md` · `docs/product/aps-benchmark-siemens.md` · `.gitignore`
- **验证**：文档交叉引用自检；未改运行代码
- **文档同步**：
- **遗留**：新编号落地规格卡随 M4/M5 开工补齐；柔性场景种子数据与引擎实现另开切片
---
2026-07-21 11:05:57 +08:00
## 2026-07-16 — 订单分解 MRP 首切片 + BOM/工艺路线可维护（对标西门子）
- **类型**：
- **做了什么**：
- 新增 MRP 领域服务 `server/aps_domain/mrp.py` ：订单按 BOM/工艺路线分解为 自制（进排产）/ **采购建议** （净需求=毛需求−库存−在途，建议下单日按采购前置期倒排）/ **委外建议** （ `purchaseOrders` /`outsourceOrders` DRAFT 建议表，重复分解幂等替换
- `order.decompose` 登记 P1； `POST /api/mrp/decompose` ；对话口令「分解订单 SOxxx / 生成采购建议 / MRP」走同一动作
- MD-02 深化：新增 `master.bom.upsert` （明细用量/关键料）与 `master.routing.upsert` （准备/单件时间/外协标记）两个 P2 动作；主数据面板选中成品后可直接编辑 BOM 与工艺步骤
- 订单面板新增「分解建议」视图与「分解此单」按钮，展示采购/委外建议（含来源订单、建议下单日、前置期）
- 黄金测试 `tests/golden/test_mrp.py` ：缺料出采购建议+前置期倒排、充足物料零建议、外协往返、指定订单幂等、BOM 用量联动
- **涉及路径**： `server/aps_domain/masterdata.py` · `server/aps_domain/workflow.py` · `server/agent_core/harness.py` · `server/agent_core/intent.py` · `server/gateway/app.py` · `server/state/seed.py` · `server/state/store.py` · `apps/web/src/orders/OrderPanel.tsx` · `apps/web/src/master/MasterPanel.tsx` · `apps/web/src/api/*` · `tests/golden/test_mrp.py` · `docs/**`
- **验证**： **37 passed** ；
- **文档同步**： （ ） `product/journeys.md` （旅程 A4） `product/implementation-spec.md` · `product/aps-benchmark-siemens.md` · `architecture/harness.md` · `architecture/modules.md` · 本文件
- **遗留**：建议单确认下达（转正式采购/委外， ）
---
## 2026-07-16 — MD-01/02/03 主数据维护模块首切片
- **类型**：
- **做了什么**：
- 新增主数据领域服务 `server/aps_domain/masterdata.py` ：资源树/物料BOM/日历维保只读投影 + `master.line.upsert` （产线编辑停启用）/ `master.material.upsert` （库存在途安全库存）/ `master.maintenance.upsert` （维保新增取消）三个 P2 写动作
- 新增 `GET /api/master` 与 `POST /api/master/stage` ；页面只暂存确认卡，批准统一走 `/api/actions/confirm` ，写前自动 Checkpoint + 审计链
- 引擎联动修复：`find_product_lines` / `find_workstation_for_operation` 补 ACTIVE 过滤（停用资源不进新排产）；维保冲突检测忽略 CANCELLED 窗口
- 前端新增主数据面板 `MasterPanel` （资源/物料与BOM/日历与维保三页签），侧栏与右侧工具栏、命令面板均可进入
- `WorldStore` 发号器支持 maintenance 表
- 黄金测试 `tests/golden/test_master_data.py` ：停用产线排除、库存调零缺料增加、维保窗口冲突往返、确认卡校验、审计链完整
- **涉及路径**： `server/gateway/app.py` · `server/aps_domain/workflow.py` · `server/agent_core/harness.py` · `server/engines/queries.py` · `server/engines/rule_engine.py` · `server/state/store.py` · `apps/web/src/master/MasterPanel.tsx` · `apps/web/src/App.tsx` · `apps/web/src/projects/ProjectPanel.tsx` · `apps/web/src/api/*` · `tests/golden/test_master_data.py` · `docs/**`
- **验证**： **33 passed** ；
- **文档同步**： `product/journeys.md` （旅程 A3） `product/implementation-spec.md` · `architecture/harness.md` · `architecture/modules.md` · 本文件
- **遗留**：工位/设备编辑、BOM/工艺路线版本发布、周日历模板、Excel 导入（ ） ； （ ）
---
## 2026-07-16 — 对标西门子 Opcenter APS 完善产品功能清单
- **类型**：
- **做了什么**：
- 新增 `docs/product/aps-benchmark-siemens.md` ：以西门子 Opcenter APS（ ）
- `features.md` 扩充：新增「计划层 Advanced Planning」章节（ ） （ ） ， ×
- `implementation-spec.md` 编号总表同步新增 25 个功能编号
- 更新 product 索引与大管家导航
- **涉及路径**： `docs/product/features.md` · `docs/product/implementation-spec.md` · `docs/product/README.md` · `docs/README.md`
- **验证**：文档编号一致性自检；未改运行代码
- **文档同步**： `docs/README.md` · 本文件
- **遗留**： （ ） ；
---
## 2026-07-16 — Codex 式工作台布局与会话节点导航
- **类型**：
- **做了什么**：
- 将左侧从图标轨/项目面板改为 Codex 桌面端式工作区侧栏：快捷入口、项目列表、当前项目任务、底部设置
- 去掉顶栏重复项目/任务标题，中央区域回归沉浸式对话；无结果数据时对话区铺满主工作区
- 订单管理、检查点/版本、会话结果收敛到右侧工具入口，结果视图按当前会话快照展示
- 新增会话节点导航：对话区最右侧生成消息节点，悬停显示节点摘要，点击滚动到对应消息
- 修复上一版左侧新结构缺少样式导致原生控件裸露的问题
- 修复右侧工具展开后的大面积空白：右侧工作区改为吃满剩余空间，竖向工具栏固定贴最右侧
- **涉及路径**： `apps/web/src/projects/ProjectPanel.tsx` · `apps/web/src/chat/ChatPanel.tsx` · `apps/web/src/styles.css`
- **验证**： **28 passed**
- **文档同步**：本文件
- **遗留**：左侧快捷入口后续可继续绑定真实“知识库管理”页面；当前先复用设置/集成入口
---
## 2026-07-16 — 首屏引导与操作口径专业化
- **类型**：
- **做了什么**：
- 将对话首屏从口号式说明改为“排产工作流 / 方案评估 / 版本治理 / 视图分析”的业务化引导
- 快捷指令与命令面板改为计划员工作台口径，
- 甘特空态、时间线空态、后端帮助和无版本提示统一为专业表达
- 增加旧欢迎语本地缓存迁移，命中“左边说，右边动”时自动替换新版欢迎语，不清空其他消息
- **涉及路径**： `apps/web/src/App.tsx` · `apps/web/src/viewport/GanttView.tsx` · `apps/web/src/timeline/TimelineRail.tsx` · `server/aps_domain/workflow.py` · `server/aps_domain/reports.py`
- **验证**： **28 passed**
- **文档同步**：本文件
- **遗留**：项目/任务默认名称后续可随真实项目模板继续行业化
---
## 2026-07-16 — OR-01 订单管理首切片 + 审计契约修复
- **类型**：
- **做了什么**：
- 新增订单领域服务：订单只读投影、成品校验、`order.upsert/cancel/complete` P2 写入逻辑
- 新增 `GET /api/orders` 与 `POST /api/orders/stage` ，订单页面只暂存确认卡，批准仍统一走 `/api/actions/confirm`
- 前端新增订单管理面板：列表、编辑表单、新建/编辑/取消/完成、内嵌确认卡与批准/驳回
- 修复审计事件时间契约：新增 `at` ，保留 `ts` ，治理页与旧数据兼容
- 黄金测试新增 OR-01 覆盖：新增订单进入排产、取消订单排除、确认卡摘要、审计双字段
- 同步门禁矩阵、模块登记、产品状态、业务旅程与落地规格
- **涉及路径**： `server/aps_domain/workflow.py` · `server/gateway/app.py` · `server/agent_core/audit.py` · `apps/web/src/orders/OrderPanel.tsx` · `apps/web/src/App.tsx` · `apps/web/src/api/*` · `tests/golden/test_order_management.py` · `docs/**`
- **验证**： **28 passed** ；
- **文档同步**： `product/journeys.md` · `product/implementation-spec.md` · `architecture/harness.md` · `architecture/modules.md` · 本文件
- **遗留**： ；
---
## 2026-07-16 — 产品功能落地规格补全
- **类型**：
- **做了什么**：
- 新增 `docs/product/implementation-spec.md` ，按主数据、订单、排产、执行、对话治理拆出功能落地卡
- 为每个功能点补充用户目标、最小切片、权力等级、数据对象、API/动作、UI、验收与测试要求
- 在 `features.md` 增加落地规格编号，覆盖当前可演示能力、主数据、订单、排产引擎、结果执行、对话治理
- 更新 product 索引和大管家导航，产品评审可从功能清单跳到落地规格
- **涉及路径**： `docs/product/features.md` · `docs/product/README.md` · `docs/README.md`
- **验证**：文档链接与编号自检；未改运行代码，未跑业务测试
- **文档同步**： `docs/README.md` · 本文件
- **遗留**：后续实现任一功能时仍需同步 `journeys.md` 、`harness.md` 或 `algorithm/*` 的对应落地细节
---
## 2026-07-16 — 文档体系重组（大管家 + 分类落地）
- **类型**：
- **做了什么**：
- 建立 `docs/README.md` 大管家入口与活文档铁律
- 按角色拆分：`product/` · `architecture/` · `algorithm/`
- `PROGRESS.md` → `CHANGELOG.md` ；
- 种子工厂名改为「演示工厂」（去地域硬编码，与产品通用定位一致）
- **涉及路径**： `plan.md` §12.9 · `README.md` · `server/state/seed.py`
- **验证**：文档结构自检；种子仅改展示名，不影响黄金测试键结构
- **文档同步**：本文件 · product/* · architecture/* · algorithm/* · 大管家
- **遗留**： `docs/algorithm/` 与 `product/features.md` 的状态列为准
---
## 2026-07-16 — 产品化整改：缺陷修复 + 设置收敛 + 通用化
- **类型**：
- **做了什么**：
- 修复右侧无数据：`/api/gov/tests?run=true` 改为 `asyncio.to_thread` ；前端 `refreshWorld` 逐端点兜底 + 3s 重试
- 导航收敛：轨道仅 项目/对话/时间线/设置；门禁与重生并入设置
- 前端种子项目改「演示项目（示例数据）」；顶栏「智能排产 · 通用行业版」
- 产出功能清单（后迁入 `product/features.md` ）
- **涉及路径**： `apps/web/src/**` · `docs/`
- **验证**：后端多端点 200；
- **遗留**：订单/主数据管理页等见 `product/features.md` 差距清单
---
## 2026-07-16 — plan.md 深水区五问补全
- **类型**：
- **做了什么**：
- **涉及路径**：
- **验证**：章节编号连贯
- **遗留**：落地以 `algorithm/scheduling-v1.md` 为准；蓝图能力标 🔜
---
## 2026-07-16 — UI 对标 Codex 操作
- **类型**：
- **做了什么**：
- **涉及路径**： `apps/web/src/chat/**` · `apps/web/src/shell/**`
- **验证**：
- **遗留**：任务状态仍前端固定「运行中」
---
## 2026-07-16 — M3 知识与偏好
- **类型**：
- **做了什么**：知识资产库 + bigram 检索带出处；日报/版本对比报告；偏好加权缺省策略；意图与前端 evidence/report 块
- **涉及路径**： `server/aps_domain/reports.py` · `apps/web/**` · `tests/golden/test_m3_knowledge.py`
- **验证**： **24 passed** ； ；
- **遗留**：真向量 RAG、会话树服务端化、上下文四层管理
---
## 2026-07-16 — M2.5 Codex 级产品表面 + 文档体系初建
- **类型**：
- **做了什么**：
- **验证**：黄金测试全绿；`npm run build`
- **遗留**：权力矩阵在线编辑 🔜 M4
---
## 2026-07-16 — M2 前端补完（项目制 + 折叠 + 分隔条）
- **类型**：
- **做了什么**：项目/任务/文件、折叠轨、分隔条、时间线回滚口令
- **验证**：当时黄金测试 15/15；
- **遗留**：项目数据仍在浏览器 localStorage
---
## 2026-07-15~16 — M2 后端（成对状态 + 沙盒 + 时间线）
- **类型**：
- **做了什么**：
- **验证**：
---
## 2026-07-15 — M0 + M1（
- **类型**：
- **做了什么**：
- **验证**：当时 11/11；
---
## 更早 — M-POC
- **类型**：
- **做了什么**：
2026-08-26 00:25:46 +08:00
## 2026-08-18 — Round 77 异步分析任务安全基础设施
- **类型**：
- JobQueue 新增 tenant/project 作用域、认证 actor、并发 2/在途 8 上限和队列饱和拒绝；网关 jobs API 全部按当前作用域过滤。
- 关闭 pending 取消堆积线程、取消后 done/failed 覆盖、thread.start 失败泄漏配额三类竞态。
- **验证**：专项 11 passed； ； ， ； `AUDIT PASS` 。
- **边界**：下一步恢复 Sobol，
2026-08-21 07:32:13 +08:00
## 2026-08-21 — 企业级排产回复文案与状态提示
- **类型**：
- **做了什么**：统一助手系统提示词与离线回复为“结论 → 依据 → 阻断项/风险 → 下一步”；重写数据齐备度、排产向导、目录分析、目录导入和报告空态文案；欢迎页、快捷指令、空态和错误提示改为业务化表达。
- **界面行为**： `VITE_SHOW_INTENT_DEBUG=1` 显式打开调试块。
- **涉及路径**：
- **验证**：核心回复/向导/齐备度/引导测试 `37 passed` ；全量黄金测试 `1156 passed, 20 skipped` ，另有 7 项依赖外部 MES 网络或本机 MOM 文件的环境失败；`npm run build:web` 通过；`server` compileall 通过；本地 `8000/5173` 健康检查通过。
- **文档同步**：新增 `docs/development/response-style.md` 。
- **遗留**：
---
2026-09-14 15:40:10 +08:00
## 2026-09-11 — 自然语言统一交给 Pi Agent（
- **类型**： （ ）
- **删除**： `test_assistant.py` 、`test_context.py`、`test_dialog_clarify.py`、`test_schedule_entry_intent.py`、`test_schedule_wizard.py` 随之删除。
- **保留并重新定义**： ， ； `IntentName` 工具目录，登记 / 齐备度 / P2 确认卡 / P3 白名单门禁不变；`source=RULE_FAST` 仅作历史审计兼容值保留。
- **二次清理（同日）**： `normalize_history` （网关聊天历史收敛）；删除 `resolve_followup` （「是的 / 好 / 那个」短回复改写）、`wants_folder_listing`、`list_project_folder`、`last_agent_text`、`last_user_text`、`format_history_for_llm`、`_AFFIRM/_DENY/_extract_quoted_commands`。同步修正 `/api/settings/llm` 与治理台设置页「大模型（意图解析二级管线）」的陈旧文案——不再宣称未配置模型时降级为规则解析。
- **接线**： `workflow.handle_intent` 的 `assistant.reply/unknown` 分支强制 `_piPrimary` 后只走 `fallback_lane.propose_reply()` ；兜底车道不再调用本地话术，失败显式返回；执行计划未通过校验时，回复保留具体校验原因（白名单缺失、指纹虚报、超步数等阻断项仍对用户可见）。
- **验证**：兜底专项 10 文件 `224 passed / 1 skipped` ；本轮涉及文件聚焦回归 `88 passed` 与 `18 passed` ；二次清理后 chat/gateway 相关 `43 passed` 、聚焦回归 `64 passed` 与 `35 passed / 8 skipped` ； `npm run build:web` （ ） ；
- **边界**：全量 `tests/golden` 为 `86 failed / 2154 passed / 113 skipped / 7 errors` ，失败集中在 CP/solver/DXF/sobol/sidecar 文件，根因是本地环境缺 `scipy` 、`fontTools` 且 OR-Tools 装在用户级 site-packages（
---
## 2026-09-12 — 缺料引导卡去掉重复的「再看还缺什么」
- **类型**： （ ）
- **做了什么**： ） ； （ ） ，
- **验证**： `test_scheduling_entry_workflow.py` / `test_e2e_acceptance.py` / `test_planner_experience.py` / `test_readiness.py` / `test_pool_engine.py` / `test_kangni_flex.py` / `test_pi_primary_chat.py` 共 `58 passed / 5 skipped` ； ；
---
## 2026-09-13 — Pi 参数闭包、只读分析采用、Mesh 审批恢复与 SOP 控制台接线
- **类型**： （ ； ）
- **Pi-only 工具边界**：延续 `intent.py` / `dialog.py` / `assistant.py` 已删除的状态，`server/agent_core/fallback_lane.py` 的 `_PRIMARY_TOOL_PARAM_SCHEMAS` 为已登记工具下发封闭 `paramsSchema` ； `_OPEN_PARAMS_SCHEMA` 。P0 只读、P2 确认卡、P3 人工审批仍由 `harness` 在服务端决定。
- **只读分析 → P2 采用**： `analyze_project_deep(..., apply=False)` 使用 `_project_ctx_readonly()` 与 `copy.deepcopy(world)` ，只预览批次/SQL 并返回 `readOnly` 、`pendingAdoption{mode,filename,sourcePaths,batches,counts}`； `import.commit` 卡并携带 `analysisIngest` ；批准后 `execute_confirmed()` 的 `action == "import.commit"` 分支写入主数据、补首次归属、调用 `ingest_project_analyze_report()` ，注册 profile 与分析派生采用卡统一返回「排产资料已采用，尚未生成方案…」。
- **Mesh 审批恢复**： `resume_goal_after_confirmation(confirm_id, *, approve, actor)` 在批准时把任务置 `DONE` 并恢复 `dispatch_goal()` ，驳回时置 `FAILED` 且 Goal 转 `ATTENTION` ； `matched: False` 。`server/gateway/app.py` 的 `/api/actions/confirm` 、`/api/actions/confirm-batch` 通过 `_resume_mesh_goal_if_needed()` best-effort 接入，不阻断确认结果；`apps/web/src/mesh/MeshPanel.tsx` 将 `AWAITING_APPROVAL` 显示为「待人工审批」并展示 `confirmationIds` 。
- **SOP 控制台**： `compile_sop_by_asset(kb_assets, asset_id)` 只按明确资产精确编译，缺 `SopStageRequest.assetId` 时 fail-closed； `postSopStage(sessionId, assetId)` 调 `POST /api/sop/stage` ，由 `apps/web/src/gov/GovConsole.tsx` 的 `stageSop()` 使用并生成 P2 `sop.apply` 确认卡。
- **文档核对**： ，
- **分析卡首屏摘要（ ： `_analysis_summary_props()` 与 `server/aps_domain/planning_intake.py` 的 `_intake_analysis_summary()` 由后端按实际状态生成 `analysisSummary{headline,status,statusLabel,metrics,issues,issueOverflow,nextStep,recap}` ，前端 `apps/web/src/chat/PlanningDataCard.tsx` 只按该契约渲染：结论 → 关键数 → 最多 3 条关注项 → 折叠明细 → 收束现状（总-分-总），不再把原始字段、文件清单和来源说明铺在首屏；工程目录分析卡与工作簿核对卡共用同一结构，旧会话缺该字段时回落原渲染。待采用状态只保留一个禁用的「开始排产」入口（采用确认仍由下方 P2 卡负责），行数统计与诊断问题移入折叠层。回归：`tests/node/planner-data-card.test.mjs` 的 `adoption review keeps one disabled scheduling entry instead of a second call to action` 、`tests/golden/test_ruiyang_intake_workflow.py` 的 `test_pending_adoption_card_leads_with_conclusion_and_a_locked_scheduling_entry` 。
- **采用通道加固（安全评审 P1） `momPath` ）此前只校验来源、不校验目标世界。现由 `_stage_pending_adoption()` 冻结 `targetWorldFingerprint` （ ） ， ， ； `mom_pack_is_adoptable()` ：结构证据需 ≥2 张模型表（按工作表张数计，复合表名「生产模型-工艺模型」不叠加；与 `is_mom_workbook()` 不靠文件名时的判定同口径），内容证据需主干行 > 0（ `flexOperations` 与车间/设备辅助台账 `flexZones` / `flexEquipment` ） ， `_HEADER_ROW_LABELS` 过滤重复/畸形表头，并用 `_is_placeholder_text()` 过滤模板填写指引行——编码侧认「填写/示例/占位/测试/演示/test/demo」等前缀， ， （ ） ， ； `apply_mom_pack_to_world(replace=True)` 清库（真实 MOM 主数据收集表实测仍准入： ） `orders/materials/equipment/routing/bom` 真实列表长度计，不信任 `stats` ； ： （ ， ） ，
---
## 2026-09-13 — 试排能排出结果 + 主数据两个维护并为一套（用户实测两缺陷）
- **类型**： （ ）
- **排产排不出（根因 1： ） ： `_iso_date()` 。`插单场景` 的 `dueDate` 与订单交期此前按原始字符串比较，用户把该单元格改成真正的 Excel 日期后序列化为 `2026-10-11T00:00:00` ，与订单的 `2026-10-11` 不等 → 误报 `SANDBOX_CONFLICT` （ ） `canCommit=false` ， ， ， （ `YYYY-MM-DD` ）。
- **排产排不出（根因 2： ） ： `TRIAL_ASSUMABLE_ISSUES` 与 `order_execution_issues(..., trial=)` ——试排态下「未登记人员技能」「在制剩余量/结束时间/前序/资源未确认」等在制事实类问题降级为 `assumption` ， `error` 阻断**； ； `solve(..., trial=)` 把假设项写 `severity="ASSUMPTION"` 、描述前缀「试排假设：」，假设到未确认在制的订单整单重排（不把未确认完成量当依据），新增 `assumptionCount` 与 `solveStatus=PARTIAL_WITH_ASSUMPTIONS` ； `workflow.py` 透传并输出「N 项按试排假设处理」。**正式链路语义不变**： `False` ； （
- **前端**： `.conflict-badge.assumption` （中性灰描边，不复用告警橙，避免把假设读成故障）。
- **主数据两个维护并为一套**： `master-r71` 右侧工具/命令面板入口删除——该面板用裸 `fetch` （缺 `X-APS-Client` /设备号/访客头），被全局鉴权中间件拦成 401、列表恒空。能力并入 `MasterPanel` 唯一入口下的「工位·版本·日历」页签（子页：工位/设备、版本发布/回滚、班次日历），复用已鉴权的 `/api/master` 与 `/api/master/stage` ； `destroyOnClose` 改为 antd 6 的 `destroyOnHidden` （消掉浏览器验收里的弃用告警）。
- **验证**： **2359 passed / 54 skipped / 0 failed / 0 errors** （ `ROUND87_REQUIRED=1` ）；聚焦 6 文件 `84 passed` ； （ ） ； `1 passed` （ `7a1a8159…` 前后不变；界面实测「已安排 3 张、待补资料 2 张、15 个工单、10 项试排假设」）；浏览器验收 `planner-masterdata-round87.spec.ts` 桌面 1440× × **2 passed** （ `/api/masterdata` 请求、无 401/5xx、无控制台错误） ；
- **测试脚手架**： `install_fake_pi_tool_adapter` （ `APS_E2E_FAKE_PI=1` 显式开关安装同一替身，使浏览器验收不依赖在线模型（真实 Pi 路径仍由 `scripts/run-pi-real-workbook-e2e.ps1` 覆盖）。
- **残留边界**： ， ； （ ， ） ；
---
## 2026-09-13 — 排产 Excel 下载修复（点击后 AUTH_REQUIRED）
- **类型**： （ ）
- **根因**：报告块、柔性结果块和订单页下载分别使用裸 `<a>` 顶层跳转、`window.location.href` 或裸 `fetch` ，未经过 `apiFetch` ，缺少 `aps_session` Cookie 及 `X-APS-Client` /`X-APS-Visitor-ID` 头，被全局鉴权中间件拦成 `401 AUTH_REQUIRED` ，页面直接显示错误 JSON。
- **修复**：新增 `apps/web/src/api/download.ts` 统一鉴权下载（`credentials: include` + 客户端头），从 `Content-Disposition` 解析文件名后用 Blob 临时链接触发下载并释放对象 URL； `OrderPanel.tsx` “排产分析报告”全部接入，失败时显示后端中文原因；订单页原先请求 `format=docx` 却命名 `.xlsx` 的错位改为真实 `format=xlsx` 。
- **验证**： **72 passed / 0 failed** （新增 `tests/node/authenticated-download.test.mjs` 覆盖 RFC 5987 文件名、Cookie/访客头与 Blob 下载）；`npm run build --prefix apps/web` **3185 modules** 通过；隔离真实工作簿浏览器验收 `planning-schedule-entry.spec.ts` 桌面 1440× × **2 passed** （上传→采用→真实试排→点击下载，断言报告接口 200、文件名 `.xlsx` 、文件头 `PK` ）。
- **边界**：本次验证走隔离后端与测试账号，未改现场 8000/5173 服务；工作区仍未 commit/push。
