muse-agent-example/docs/系统架构/新版设计/研究依据/主体重写依据.md

原主体重写依据

原研究快照：对应旧架构研究的提交及工作树，本次整理不重跑业务测试。新版取舍以总体架构及元数据与结构演进为准。

本轮直接核对 agent-example@671984fd1ab24f0810c96469d1dd62e9b8229beb 加当前工作树。此前会话提供的测试结论只作历史背景，本轮没有重跑其测试，也没有连接数据库。

当前对象	本轮源码可确认的事实	新版处理
框架执行协议	请求、事件、结果已与作品和数据库分离	保留协议能力，统一进入宿主适配接缝
运行执行入口	运行函数直接构造 PiAgentRunner	在启动装配处选择并注入宿主；业务侧不识别 Pi
派发实现	路径注入、任务包、宿主、PG 证据及 SQLite 留痕在同一入口汇合	按任务执行、模型治理、证据持久化与业务编排重写
正文采纳	有事务、候选状态检查、版本条件更新、批准的事实增量与投影登记；部分参数可省略	保留不变量，把审阅身份、预期版本和幂等标识设为必需合同
网页决策	接受调用只传部分参数，没有完整使用底层保护	所有作者入口调用同一完整提交用例
SQLite 认可	本地 adopt 只记录 review，不产生正式正文	迁为历史审查记录；退出“第二种采纳”的运行路径
两阶段写手、读取工具	回放使用工具清单参数；工具读取尚未强制绑定当前任务的完整来源范围	范围由服务端任务装配并贯穿预组装、探索、回放与再次采纳检查
章节生产入口	作品 12 的第 2、3 章专用门锚；生产提示与配置取自回放配置	以通用写作任务合同取代；样本只保留在评测夹具
规划确认	确认主要执行状态更新	确认时重验结构、来源版本、依赖和目标版本
去味修订	有受控 patch；经验登记仍按旧相邻目录寻找脚本	保留纯规则，接入正常包依赖和统一经验模块
经验登记、SQLite 存储	PG 升格主要记录状态和目标引用；本地存在另一套经验处理	统一“观察—提案—评测—变更—启用—退役”
榜单导入	CSV 样本关联最近 run，不形成可靠效果归因	保留解析思路，重写榜单快照及稿件版本关联
表映射	大量表沿用主仓列，另叠 example_*；存在两类运行态存储	新版独立建模，通过迁移映射承接旧数据
holdout 函数	消费外部汇总，不执行完整独立数据集实验	保留校验，补逐例执行、隔离、结果来源和启用判据

这里的“保留”指保留已确认有价值的行为与证据，不要求保留现有文件路径、表名或函数签名。历史测试中确实保护业务的反例也属于迁移资产。