lhk229
53f2ba30c3
CI 上 background_agent_runtime_recovers_stale_running_before_pending_task 在 tokio-rt-worker 栈溢出。根因是 recovery_scan.rs 手写 tauri::async_runtime::spawn 直接 跑 drain_game_creator_agent_background_tasks——正是仓库规定必须上 16 MiB 专用 worker 的那个 future。pitfalls 2026-08-03 按入口枚举了三个（普通后台任务、静态委派子任务、 manifest ready-task 首次执行），恢复重启是第四个，从未被列进去；漏掉一个入口不会产生 任何信号，故判据改写为不变量：所有会进入 Agent 主循环的 future 必须在 agent-runtime-worker-* 专用线程上轮询。 改动： - 统一常量 AGENT_RUNTIME_BACKGROUND_WORKER_STACK_BYTES - spawn_next_*_with_lock 改用专用线程；签名保持 -> ()，8 个调用点不动。该入口是 best-effort 幂等语义（拿不到锁即返回、后续 wake 重试），建线程失败只需记录并随闭包 释放锁，无需交还锁、也就不需要握手 - recovery_scan.rs 两处手写 spawn 收敛为 helper 调用。恢复重启顺带补上首轮轮询握手： 原写法把执行锁 move 进一个无人保证会被轮询的 future，运行时关停时 run 会永远停在 running 且无主 回归钉不变量而非钉余量：drain 入口在 cfg(test) 下记录线程名，用例断言必须以 agent-runtime-worker- 开头。变异验证——改回手写 spawn 且 RUST_MIN_STACK=16MiB（因而不 溢出）时，用例仍以 ["tokio-rt-worker", "tokio-rt-worker"] 失败。 实测（同机、二分 RUST_MIN_STACK，默认栈 2048 KiB）： - started 变体：master 需 1536-1792 KiB，修复前 HEAD 需 2048-2176 KiB - 队列 drain：master 需 1280-1536 KiB，修复前 HEAD 需 1792-1856 KiB，余量已不足 256 KiB - 修复后两条用例在 1024 KiB（半个默认栈）下通过 同过滤器 A/B（runtime_actions + collaboration，同一 skip）： - 修复前 HEAD：19 failed，且在 planning_strategy 处栈溢出 abort - 修复后：289 passed / 0 failed 修复前分支实际有三处溢出点（recovery、response_stream::provider_handoff_*、 planning_strategy::tool_planning::*），CI 只报了最先撞上的那个；三处修复后均通过。 共享 tokio pool 不再被长时间占用，mock LLM 超时类失败同时大幅减少。 需回流 master：master 同样存在恢复重启走默认栈与 drain_next_* 余量偏低，只是尚未触发。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
项目记忆目录
本目录保存可以进入 Git 的项目级长期知识，供开发者和 Agent 读取。.hermes/ 只保留 Hermes 工具专用资源，不再作为项目知识库。
目录结构
docs/project-memory/
├─ README.md
├─ shared-memory/
│ ├─ project-overview.md
│ ├─ team-conventions.md
│ ├─ development-workflow.md
│ ├─ document-map.md
│ ├─ decision-log.md
│ ├─ pitfalls.md
│ └─ handoff-template.md
├─ plans/
└─ todos/
使用原则
- 开发前先读
AGENTS.md；复杂任务继续读取docs/【协作规范】Agent工作入口与执行准则-2026-06-22.md，再按任务读取docs/project-memory/shared-memory/和当前docs/文档。 - 长期有效的架构约定、接口变化、排障经验、开发流程和协作规则写入
shared-memory/。 - 阶段性计划写入
plans/，已确定但暂未实施的共享 TODO 写入todos/。 - 如果本目录内容与代码或最新
docs/冲突，以代码和最新docs/为准，并同步修正过期记忆。 - 禁止写入个人配置、API Key、Token、Cookie、会话记录、认证文件、本地私密路径、构建产物、日志、缓存和数据库 dump。
RAG 索引
本目录是 Agent 本地 RAG 的高权重索引源。RAG 主要用于 Agent 检索上下文，不替代人工阅读入口或正式文档地图。索引脚本位于 scripts/rag/，本地生成的 .rag/ 数据不提交 Git。