diff --git a/.doc/ops/CURRENT.md b/.doc/ops/CURRENT.md index 7daed6fd..52a12429 100644 --- a/.doc/ops/CURRENT.md +++ b/.doc/ops/CURRENT.md @@ -18,6 +18,7 @@ | owner | task | branch | worktree | mutex | status | |---|---|---|---|---|---| +| Cursor | coordination-db-daemon-2026-09-23 | feature/coordination-db-daemon-2026-09-23 | .worktrees/coordination-db-daemon-2026-09-23 | coordination-db-daemon | in_progress | | Cursor | integrate-pi-runner-response-size-r2-2026-09-23 | feature/integrate-pi-runner-response-size-2026-09-23 | .worktrees/integrate-pi-runner-response-size-2026-09-23 | git:dev | done | | Cursor | modular-decouple-residual-b-2026-09-23 | feature/modular-decouple-residual-2026-09-23 | .worktrees/modular-decouple-residual-2026-09-23 | modular-decouple-residual | done | | Cursor | modular-refactor-impl-plan-2026-09-23 | feature/modular-refactor-impl-plan-2026-09-23 | .worktrees/modular-refactor-impl-plan-2026-09-23 | docs-remediation-modular-impl-plan | done | diff --git a/.doc/ops/research/2026-09-23-coordination-db-daemon-research.md b/.doc/ops/research/2026-09-23-coordination-db-daemon-research.md new file mode 100644 index 00000000..1994013d --- /dev/null +++ b/.doc/ops/research/2026-09-23-coordination-db-daemon-research.md @@ -0,0 +1,87 @@ +--- +title: "协调库与 daemon：现状核查与边界核对" +created: 2026-09-23 +owner: Cursor +task_id: coordination-db-daemon-2026-09-23 +policy_revision: "agent-governance-2026-09-21-r1 @ 63e66c6fb35d6b4dd9f3ed92e15acc9933aeb344" +review_state: pending +integration_state: pending +deployment: not_required +cleanup: pending +remote_sync: not_requested +status: done +confidence: high +--- + +# 调研：协调库与 daemon 现状核查 + +## 范围与授权 + +- 用户目标：在本仓库重新落地「协调库 + daemon」方案与研究记录；L1 保持单宿主机，跨机 PostgreSQL 仅登记为 planned 的 L2（需二次授权与 ADR）。并行授权修掉 `agentctl queue` 子解析器重复注册缺陷。 +- 允许写路径（本调研）：`.doc`（只读采样代码与 `.locks` 运行态）。 +- 交付终点：可审的研究记录 + 配套方案；不实施 daemon/PostgreSQL，不改产品业务代码。 +- 非目标：跨机 HA 实施、OS 沙箱、产品容器依赖式协调。 + +## 结论 + +1. `.locks/state.sqlite` 已是本机协调权威库（11 表；采样时 tasks≈105、runs≈653、events≈1406），不是「部分状态」；`scripts/agentctl.py` 已 enforced scope / lease / CAS / 收据 / 候选准入 / `--ff-only`。 +2. 真正缺口是：显式长期 claim、常驻监管入口、策略外部化、CURRENT/MATRIX 稳定 record id；`queue`/`jobs` 在修复前因 CLI 缺陷恒为 0 行（已由 `63e66c6f` 修复 parser）。 +3. 跨机 + 独立 PostgreSQL + systemd 与 [2026-09-21 锁方案](../../remediation/2026-09-21-agent-lock-coordination-plan.md) §3.2 及 [平台深化方案](../../remediation/2026-09-23-platform-deepening-reliability-ha-concurrency-plan.md) §0 冲突，只能作为 L2 planned，开工前另立 ADR。 + +## 证据 + +| 项 | 路径/命令 | 结果 | +|----|-----------|------| +| 权威库存在 | `.locks/state.sqlite`（gitignore:33；dockerignore:24） | 存在；`sqlite3 -readonly … ".tables"` → deployments/documents/events/freezes/jobs/projections/queue_items/receipts/runs/tasks/validations | +| 行数采样（2026-09-23） | `sqlite3 -readonly .locks/state.sqlite` 计数 | tasks 105；runs 653；events 1406；queue_items 0；jobs 0 | +| 无 Go agentctl | `cmd/` 列表 | 无 `cmd/agentctl`；协调 100% Python | +| scope/lease | `scripts/agentctl.py:27` `SHARED_DOCS`；`:589` `class Lease`；`:554+` `check_resources` | 已实现；header 声明 cooperative/advisory | +| 文档 CAS | `docs apply` `:856`；收据 `:954`；hook `:1057-1064` | 已 enforced（相对受控入口） | +| 候选准入 | `admit_candidate` `:1066`；`integrate` `--ff-only` | 已 enforced | +| queue 缺陷（修复前） | 曾于 `:1613` 与 `:1629` 双重 `add_parser('queue')` | 后注册覆盖先注册；handler 读 `args.head`/`args.drain`/`args.task` | +| queue 修复 | 合入 `63e66c6fb35d6b4dd9f3ed92e15acc9933aeb344` | 仅保留一处注册（现 `:1613`）；回归测试 3 例；全套 unittest 103/2 skipped PASS | +| 策略 YAML | `configs/agent-governance.yaml` | **不存在**；策略硬编码于 `agentctl.py` / `agentctl_w4.py` | +| 常驻服务 | `find` `*.service`/`*.plist`；compose 无 agentctl | **0 个**；`queue schedule`/`deploy run-loop` 均为前台调用 | +| 主机 | `uname -s` | Darwin（macOS）；systemd 不能作为本机 L1 默认 | +| 孤儿实现 | `scripts/agentctl_automation.py` | 零导入；schema 含 `operations`/`doc_registry`，活库无这两表 | +| 孤儿文件 | `.locks/state.db` | 0 字节；代码无引用 | +| 既有方案 | `.doc/remediation/2026-09-21-agent-lock-coordination-plan.md` | planned；推荐本机 SQLite，明确拒绝产品 PG/跨机锁服务（本期） | +| INDEX 缺口 | `.doc/remediation/INDEX.md` | 未索引 2026-09-21 锁方案 | +| CURRENT 矛盾 | `.doc/ops/CURRENT.md:5` vs `:15` | 分别写 macOS 租约可用 / 不可用 | +| 操作规范过时 | `.doc/ops/2026-09-21-agent-worktree-workflow.md:3` | 仍写「Linux 本机」；W1-B macOS 已 done | +| 不存在的摘要产物 | `3f14d7fa`；`2026-09-23-coordination-db-daemon-*.md`（合入前） | 对象名无效；路径不存在；本轮为重新落地 | + +## 边界冲突核对 + +| 主张 | 权威来源 | 处置 | +|---|---|---| +| 跨机锁服务 / 产品 PG 协调 | 锁方案 §3.2「当前不采用」 | L2 planned；另立 ADR 前不开工 | +| HA=单宿主机 | 平台深化方案 §0（用户确认） | L1 遵守；跨机不在深化方案范围内 | +| L1 不宣称 OS 沙箱 | 操作规范 `:5`；`agentctl.py:2` | 方案全文保持 advisory | +| systemd 作为非容器运行方式 | 仓库无 unit；主机 Darwin | L1=launchd；systemd 仅 L2 Linux 中央主机 | + +## 机制核验（官方语义，推论） + +- SQLite 短事务可原子完成多资源冲突检查，但不能装入多小时开发。 +- flock 与打开 fd 绑定；TTL 到期不等于进程已停写。 +- 两次 Markdown rename + SQLite 不是跨介质原子事务；发布边界仍是 Git 提交。 +- argparse 同名子解析器后注册覆盖先注册（本轮缺陷根因）。 + +## 开放问题 + +- L2 ADR 的 RPO/RTO、中央主机拓扑与凭证边界待二次授权。 +- `agentctl_automation.py` 收敛或删除的独立实施批次尚未认领。 +- FEATURE-MATRIX 27 行稳定 record id 迁移策略（additive vs 一次性改表）待 U6 开工前确认。 + +## 建议动作 + +1. 合入本调研与配套方案（docs-only）。 +2. 按方案 U1–U7 另立实施 short-term；U1 剩余项（automation 归一、state.db 清理）在 queue 修复之后继续。 +3. L2 仅登记，不排期。 + +## 状态与交接 + +- 被审 SHA：`63e66c6fb35d6b4dd9f3ed92e15acc9933aeb344`（含 queue 修复）。 +- 本文件状态 `done` 指调研可审，不代表方案已实施。 +- 配套方案：[协调库与 daemon 方案](../../remediation/2026-09-23-coordination-db-daemon-plan.md)。 +- 任务主记录：[short-term](../short-term/2026-09-23-coordination-db-daemon.md)。 diff --git a/.doc/ops/short-term/2026-09-23-coordination-db-daemon.md b/.doc/ops/short-term/2026-09-23-coordination-db-daemon.md new file mode 100644 index 00000000..0209a5c7 --- /dev/null +++ b/.doc/ops/short-term/2026-09-23-coordination-db-daemon.md @@ -0,0 +1,69 @@ +--- +title: "协调库与 daemon：方案与研究落地" +task_id: coordination-db-daemon-2026-09-23 +status: in_progress +created: 2026-09-23 +updated: 2026-09-23 +owner: Cursor +task_type: research +task_tier: multi_stage +policy_revision: "agent-governance-2026-09-21-r1 @ 63e66c6fb35d6b4dd9f3ed92e15acc9933aeb344" +branch: feature/coordination-db-daemon-2026-09-23 +worktree: .worktrees/coordination-db-daemon-2026-09-23 +base_dev_sha: "63e66c6fb35d6b4dd9f3ed92e15acc9933aeb344" +write_scope: [".doc"] +allowed_environments: [] +head_sha: "" +mutex: coordination-db-daemon +review_state: pending +integration_state: pending +deployment: not_required +cleanup: pending +cleanup_owner: "独立维护者" +cleanup_trigger: "合入 local_dev 且无进程占用后复查" +remote_sync: not_requested +--- + +# 协调库与 daemon：方案与研究落地 + +## 用户目标与授权 + +- 用户目标：统一认领/状态/执行入口；文档状态化；为多主机预留结构；先落地方案文档。 +- 授权：docs-only 重新落地方案+研究；L1 单宿主机、L2 跨机仅 planned；并行修掉 queue 子解析器缺陷（已合入 `63e66c6f`）。 +- 交付终点：可审的 remediation + research + 本任务文；合入 local_dev；不 push。 +- 禁止：实施 daemon/PostgreSQL；改产品代码；操作未授权环境；晋升 test/main。 + +## 范围与非目标 + +- 允许写入：`.doc`（remediation / ops/research / ops/short-term / remediation INDEX / CURRENT 本人行）。 +- 非目标：U2–U7 代码实施；L2 ADR 以外的跨机工程；FEATURE-MATRIX 状态值变更。 + +## 步骤与验收 + +1. [x] 创建 worktree 并登记 — `base_dev_sha=63e66c6f…` +2. [x] CURRENT 认领行 — `docs apply` request `coordination-db-daemon-2026-09-23-claim-1` +3. [x] 写 research — [2026-09-23-coordination-db-daemon-research.md](../research/2026-09-23-coordination-db-daemon-research.md) +4. [x] 写 plan（U1 回填 queue 修复 SHA）— [2026-09-23-coordination-db-daemon-plan.md](../../remediation/2026-09-23-coordination-db-daemon-plan.md) +5. [ ] 更新 remediation INDEX（含补登 2026-09-21 锁方案） +6. [ ] docs-only 验收（链接/taxonomy/frontmatter） +7. [ ] 候选 validate + integrate 合入 local_dev + +## 验证与证据 + +| 范围 / 被测 SHA | 命令与环境 | 预期 | 实际 / 判定 | 证据 / 脱敏说明 | +|---|---|---|---|---| +| queue 修复 `63e66c6f` | `python3 -B -m unittest discover -s scripts/tests -p 'test_*.py' -v` | 全绿 | 103 ran / 2 skipped / OK | 任务 A 候选 validate 收据 | +| 本任务文档 | 相对链接解析 + taxonomy | 全部可解析；落位正确 | pending | 合入前检查 | + +## 收口与交接 + +- 剩余：INDEX、验收、集成、cleanup。 +- deployment=not_required；remote_sync=not_requested。 +- cleanup_owner=独立维护者；复查触发=合入且无进程占用。 + +## 相关链接 + +- [方案](../../remediation/2026-09-23-coordination-db-daemon-plan.md) +- [研究](../research/2026-09-23-coordination-db-daemon-research.md) +- [既有锁方案](../../remediation/2026-09-21-agent-lock-coordination-plan.md) +- queue 修复合入 tip：`63e66c6fb35d6b4dd9f3ed92e15acc9933aeb344`（`merge: fix/agentctl-queue-subparser-2026-09-23`） diff --git a/.doc/remediation/2026-09-23-coordination-db-daemon-plan.md b/.doc/remediation/2026-09-23-coordination-db-daemon-plan.md new file mode 100644 index 00000000..b377cdff --- /dev/null +++ b/.doc/remediation/2026-09-23-coordination-db-daemon-plan.md @@ -0,0 +1,172 @@ +--- +title: "协调库与 daemon：分阶段设计与实施方案" +status: planned +created: 2026-09-23 +updated: 2026-09-23 +owner: Cursor +task_id: coordination-db-daemon-2026-09-23 +task_type: research +task_tier: multi_stage +policy_revision: "agent-governance-2026-09-21-r1 @ 63e66c6fb35d6b4dd9f3ed92e15acc9933aeb344" +branch: feature/coordination-db-daemon-2026-09-23 +worktree: .worktrees/coordination-db-daemon-2026-09-23 +base_dev_sha: "63e66c6fb35d6b4dd9f3ed92e15acc9933aeb344" +write_scope: [".doc"] +allowed_environments: [] +mutex: coordination-db-daemon +review_state: pending +integration_state: pending +deployment: not_required +cleanup: pending +cleanup_owner: "独立维护者" +remote_sync: not_requested +--- + +# 协调库与 daemon：分阶段设计与实施方案 + +> 本文件是**方案文档（planned）**，不含 daemon/PostgreSQL 实施。配套 [研究依据](../ops/research/2026-09-23-coordination-db-daemon-research.md)。上位约束：[锁协调方案](./2026-09-21-agent-lock-coordination-plan.md)、[操作规范](../ops/2026-09-21-agent-worktree-workflow.md)、[平台深化方案](./2026-09-23-platform-deepening-reliability-ha-concurrency-plan.md) §0。 + +## 0. 用户目标与授权 + +- 用户目标：统一认领、状态与执行入口；文档逐步变为状态输出；为多主机协作预留结构。 +- 交付形态（已确认）：**研究 + 方案**；不实施数据库或 daemon。 +- 边界（已确认）：**分阶段**——L1 单宿主机内（daemon + 现有 SQLite）；跨机 PostgreSQL 仅登记为 planned 的 L2，需二次授权与 ADR。 +- 并行授权：修掉 `agentctl queue` 子解析器重复注册（已合入本地 `63e66c6f`）。 + +## 1. 现状基线（纠正摘要偏差） + +| 摘要原说法 | 实测 | +|---|---| +| SQLite 管理「部分」协调状态 | `.locks/state.sqlite` 已是权威库（11 表；采样 tasks≈105 / runs≈653 / events≈1406） | +| 非容器用 systemd | 本机 Darwin；仓库内 systemd/launchd/协调 compose **0 个** | +| 任务注册无长期排他认领 | 属实：缺显式 claim；scope/lease 已有 | +| 文档 `3f14d7fa` 已合入 | **不存在**；本轮重新落地 | + +已成立能力（不推倒）：`scripts/agentctl.py` 的 scope、flock 租约、三值进程存活、docs CAS+收据、候选准入、`--ff-only`、hooks；`.git/agent-control/dev-integration.lock` 与 `.locks/os/dev-integration.lock` 同 inode。 + +关键缺口：长期 claim、常驻协调入口、`configs/agent-governance.yaml`、CURRENT/MATRIX 稳定 record id、queue/jobs 运维闭环（parser 已修，行仍为 0）、`agentctl_automation.py` 分叉。 + +## 2. 目标架构 + +```mermaid +flowchart TB + subgraph L1 [L1 单宿主机 本方案设计线] + AG1[Agent 与工具调用] --> AC[agentctl CLI 统一入口] + AC --> DB[(.locks/state.sqlite 权威库)] + AC --> OS[.locks/os flock 稳定锁] + CO[常驻协调入口 launchd 本机] --> DB + CO --> PUB[docs apply 收据化发布] + AC --> GI[git:dev 候选验证与 ff-only] + end + subgraph L2 [L2 跨机 仅 planned 需 ADR] + HA[主机 A 执行代理] --> CD[中央协调 daemon] + HB[主机 B 执行代理] --> CD + CD --> PG[(独立 PostgreSQL)] + CD --> EXH[指定主机执行 Git 集成与部署] + end + L1 -.->|L1 验收后另立 ADR| L2 +``` + +### 三种关系（协议核心） + +| 机制 | 作用 | 今日状态 | +|---|---|---| +| scope | 智能体允许修改哪些路径/能力 | `tasks.scopes` + `check_resources`，已 enforced | +| claim | 某项工作当前由谁长期负责 | **缺失**；CURRENT 手工行不是原子认领 | +| lease | 谁正在操作某资源 | `Lease` + flock + 存活核验，已 enforced | + +认领在短事务中完成：检查权限、冲突、冻结、公平排队、登记归属、写审计——全成或全拒。冲突返回持有者、队列票据与 `retry_after`。 + +**执行安全不能只靠数据库锁。** TTL/心跳过期只进入 suspect/quarantine，不立即把资源交给下一个智能体；须核验旧进程与外部操作结果后再交接（见 U7）。 + +## 3. L1 七个实施单元 + +每单元另建 short-term + mutex + 验收 + 回退；合入 local_dev 串行占 `git:dev`。 + +### U1 缺陷收敛与实现归一 + +| 项 | 状态 | +|---|---| +| queue 子解析器重复注册 | **已修复并合入** `63e66c6fb35d6b4dd9f3ed92e15acc9933aeb344`（删后注册块；保留 `--head` / cancel `--task` / schedule `--drain`；回归 3 例；unittest 103/2 skipped PASS） | +| `scripts/agentctl_automation.py` 零导入、schema 分叉 | planned：收敛到 W4 或按记录删除 | +| `.locks/state.db` 0 字节孤儿 | planned：确认无引用后清理（运行态，不入 Git） | + +### U2 治理策略外部化 + +新建 tracked `configs/agent-governance.yaml`（今日不存在），收敛 `SHARED_DOCS`、`PROJECTABLE_DOCS`、`JOB_KINDS`、protocol/policy 版本；fail-closed 加载；旧客户端低于最小协议版本拒写。 + +### U3 显式长期认领 claim + +在 SQLite 增加 claim 表/字段（或等价资源键），与 scope/lease 分离。`BEGIN IMMEDIATE` 短事务内：权限、父子路径重叠、冻结、公平排队、审计。不同资源可并行。不把 Markdown `idle` 当作原子锁。 + +### U4 常驻协调入口（本机） + +- **macOS**：launchd plist（本机默认）。 +- **Linux**：systemd unit。 +- 单实例：`.locks/os/manager.lock`（2026-09-21 方案已规划、今日不存在）。 +- 职责：驱动 `queue schedule`、文档投影发布、心跳过期扫描；**不新增权限**。 +- 不可用时：阻止受保护写入，不静默放行。 + +### U5 CURRENT 状态输出化 + +- `## 并行认领` / 集成槽位：稳定 record id + `docs project` 生成；人工「焦点 / 受控约束」保留。 +- 同批修正：`CURRENT.md:5` 与 `:15` 自相矛盾；操作规范 `:3`「Linux 本机」过时描述。 +- 发布仍走 `docs apply` CAS + 收据 + hook。 + +### U6 FEATURE-MATRIX 分阶段迁移 + +27 模块行加稳定 record id 与结构化状态字段；保留声明范围、审核与证据。`done` 仍需 `docs:approve` + 已提交证据路径；不因任务结束或锁释放自动升 done。`production_ready` 仍只由发布门禁判定。任务完成 ≠ 能力完成 ≠ 发布就绪。 + +### U7 执行代理与安全交接 + +固化：suspect → quarantine → 核验（supervisor/子进程组消失、物理锁可得、外部结果核对）→ 交接。复用并加强 `recover`；补 fencing generation 与 env/git 收据。Git 集成与共享环境部署集中主目录执行入口（`queue_schedule` 已限主 dev）；保留 flock、候选准入、`--ff-only`。数据库管记录与授权，执行入口防实际双写。 + +## 4. L2 登记（planned，不开工） + +前置条件：用户二次授权 + ADR 覆盖锁方案 §3.2 与平台深化 §0。 + +登记内容：中央独立 PostgreSQL（独立配置/数据目录/备份，不依赖产品容器）；中央协调 daemon；各主机执行代理；指定执行主机做 Git 集成与部署；systemd 开机启动与异常重启；单中央节点故障时暂停受保护写入。 + +**待执行验收（不得冒充已测）**：真实双主机并发、断网、旧进程存活、重复 `request_id`、备份恢复。systemd 能恢复进程，不能替代主机容灾与数据库备份。 + +## 5. 文档与状态模型 + +| 内容 | 归属 | +|---|---| +| 任务归属、进度、队列、执行状态 | 数据库（权威） | +| CURRENT 运行表格 | 逐步自动生成；人工焦点/约束保留 | +| FEATURE-MATRIX | 分阶段结构化；证据与审核保留 | +| 规范、方案、验收报告正文 | 继续 Git 管理 | + +## 6. 全局验收门 + +1. 每单元：受影响 `unittest` + 负例（冲突认领、旧 generation、daemon 停写）。 +2. U3/U5/U6：双任务并行写不丢行、同行 CAS 冲突可见。 +3. U4/U7：杀 supervisor 留子进程不得误抢；断心跳后须核验再交接。 +4. L2：未授权不得实施；不得把 planned 写成 enforced。 +5. 红线：不把 L1 宣称为 OS 沙箱；不依赖产品容器启动协调；不接触业务数据库。 + +## 7. 风险与回退 + +| 风险 | 控制 | +|---|---| +| 两套锁各自放行 | 延续 2026-09-21 §10 硬链接/双锁兼容；禁止静默第二锁根 | +| daemon 扩大权限 | 只调度已授权操作；能力仍来自 task register | +| CURRENT 自动覆盖人工焦点 | 仅受控区块机器写；整文需 docs:admin | +| L2 提前开工 | 无 ADR 拒合入跨机代码 | +| 文档与运行态漂移 | CURRENT 标明快照时间；以 doctor/status 核验 | + +每单元独立 revert；迁移 additive；部署清单与代码分提交。 + +## 8. 与既有文档关系 + +- 本方案 = [2026-09-21 锁方案](./2026-09-21-agent-lock-coordination-plan.md) 的**演进版**：L1 补 claim/常驻入口/文档状态化；不推翻 SQLite 权威与 advisory 边界。 +- 不替代 [平台深化方案](./2026-09-23-platform-deepening-reliability-ha-concurrency-plan.md)（产品可靠性/HA）；协调跨机另立 ADR。 +- gap-matrix / FEATURE-MATRIX 状态不因本方案自动变更。 + +## 9. 开工准入（第一批实施前） + +1. 每批 short-term + CURRENT 认领 + mutex。 +2. 从当时 dev tip 建 worktree；重读 policy_revision。 +3. L2 / 共享环境须单独授权。 +4. 本文件保持 planned；首批实施时回填映射，不代填验收。 diff --git a/.doc/remediation/INDEX.md b/.doc/remediation/INDEX.md index 6d79c5d5..57df818b 100644 --- a/.doc/remediation/INDEX.md +++ b/.doc/remediation/INDEX.md @@ -2,6 +2,8 @@ | 文档 | 说明 | |------|------| +| [2026-09-23-coordination-db-daemon-plan.md](./2026-09-23-coordination-db-daemon-plan.md) | 协调库与 daemon 分阶段方案：L1 单宿主机（复用 `.locks/state.sqlite` + claim/常驻入口/文档状态化）；L2 跨机 PostgreSQL 仅 planned（需 ADR）。配套 [研究](../ops/research/2026-09-23-coordination-db-daemon-research.md) · [任务](../ops/short-term/2026-09-23-coordination-db-daemon.md)。U1 queue 子解析器已合入 `63e66c6f`；本文件 planned，不实施 daemon | +| [2026-09-21-agent-lock-coordination-plan.md](./2026-09-21-agent-lock-coordination-plan.md) | Agent `.locks`、共享文档与并行工作流补充方案：本机 SQLite + 会话/租约/CAS；L1a–L1d 设计。配套 [研究](../ops/research/2026-09-21-agent-lock-coordination-research.md)。planned；跨机锁服务本期不采用 | | [2026-09-23-platform-deepening-reliability-ha-concurrency-plan.md](./2026-09-23-platform-deepening-reliability-ha-concurrency-plan.md) | 平台深度完善方案（解耦·通信·总线·可靠性·高可用·高并发）：基于 2026-09-23 四路只读调研，六轨 R1–R6 分批（server 收口/chat 解咬合/bizdev 上收/worker 韧性/并行消费/NOTIFY 唤醒/死信闭环/多副本前置去单点化/PG 本机热备/备份自动化/锁重构/长任务异步化/池调优/app metrics）。planned，不实施代码；HA 边界=单宿主机（用户确认） | | [2026-09-23-modular-refactor-implementation-undertaking-plan.md](./2026-09-23-modular-refactor-implementation-undertaking-plan.md) | 系统整改与重构方案的**实施承接计划**（框架+映射回填）：阶段门禁、工作包模板、防重复施工（对照 A–G/`exceptions=[]`）、产物机器回填与开工准入。配套 [审核清单](../audit/2026-09-23-modular-refactor-plan-review-checklist.md) · [任务](../ops/short-term/2026-09-23-modular-refactor-impl-plan.md)。不代填 17 工作包、不实施业务代码 | | [../system-design/2026-09-22-t20-hardening-design.md](../system-design/2026-09-22-t20-hardening-design.md) | T20 W4 加固设计决策（XFF、锁拆分、timeout、shutdown、SSE POST、前端 generation/cookie、compose non-root/init、backup 调度文档）；F5/I8 见 lowrisk 批。配套 [任务](../ops/short-term/2026-09-22-t20-design-items.md) |