muse-agent-example/docs/系统架构/新版设计/模块设计/B07-作者经验.md

B07 作者经验

职责与对象

作者偏好、反馈观察与具体改进提案，不接管其他模块的生效状态。

实例归属以总体架构为准；结构、状态和公开外壳分别引用数据模型与接口契约。

公开接口

用例	输入责任	输出与后果
capture_feedback	版本对、决定、原话与范围	反馈对和观察
confirm_preference	显式要求或待审偏好	范围化偏好版本
revoke_preference	偏好当前版本和作者决定	撤回版本与后续消费变化
propose_improvement	具体目标变更、依据和哈希	待测提案
request_validation	提案版本与实验范围	关联实验
request_activation	已测版本与作者批准	目标模块返回的启用回执
提出规则改进	B06确切候选rule/version/hash与非空B05反馈	V0045只追加规则提案；不改变旧方法请求字节
申请规则验证	同库评测身份、确切规则数据集与同一目标	调用B10专用确定性验证，只保存实际run_id、target与结果哈希
请求规则启停	确切改进、B06激活基线、既有review_id/hash及规则凭据	保存意向并交B06原S01决定；不代开审阅、不自建状态
读取运行观察来源	真实S02任务、指定尝试及可选的具名业务来源	作者与用途核验后的技术摘要、版本和哈希；只读，不生成观察
记录运行观察	上述确切来源定位、具名现象、原话、背景和可选问题键	只追加运行观察；同命令和同来源现象幂等，改内容拒绝
读取运行观察 / 列出运行观察 / 检索重复问题	当前作者、观察或任务身份、可选问题键	历史观察与按实际任务计数的重复问题，不生成效果判断

所有接口在本模块的接口.py 暴露。输入输出类型由同一公开表面导出，外部不导入私有模型或 SQL。

内部职责

文件	职责
接口.py	作者经验公开用例和可导入合同
模型.py	作者经验稳定对象、外壳及内部状态
存储.py	作者经验所属记录的 SQL 与版本读写
作者偏好.py	捕获、确认、范围、冲突和撤回
反馈对.py	原稿、改稿、作者原话及决策
观察记录.py	真实反馈对上的作者自报观察
运行观察.py	实际运行来源、业务回执核对、运行观察与重复问题检索
改进提案.py	具体目标变更、版本及内容哈希
验证申请.py	方法实验或规则专用验证与原结果定位关联
启用回执.py	目标模块启停意向、既有审阅定位及原回执
长期观察.py	人审时间、返工、误杀与退化

当前入口见作者经验源码。原目标文件清单和文件合同保留历史设计意图；其中 提示词/整理偏好与改进建议.md 未实现。当前改进提案核对已有目标及反馈，不提供自动生成偏好或分析质量短板的提示词执行链。

实现约束

偏好与反馈的当前实现合同

偏好以作者、主题和作者/作品/任务作用域确定适用范围。内容和作者原话原样保存；主题只是作者给出的比较键，不从一次拒绝推断长期偏好。临时要求仅绑定一个真实任务；长期偏好可属于作者或作品。明确长期要求经作者保存生效；从反馈推断的偏好先保存待确认版本，采纳走S01审阅、当前版本核对与同事务回执。

同主题且作用域重叠的不同内容是可见冲突，不按范围宽窄静默覆盖。确认时必须点名全部冲突偏好的确切版本；同事务撤回这些版本并保存新版本。原版本、原话和回执保留。每位作者的共享读取锁与变更排他锁保护创建、替换、撤回和模型发送，首次新增也使此前明确为空的快照过期。

反馈对只接受B05已存在的确切正文或候选版本，核对作者、作品、章节、分支及内容哈希后保存引用、作者原话和决定；不复制正文或修改原候选决定，不把自报反馈当S01采纳证明。反馈幂等键改变内容时拒绝。B07通过公开读取接口恢复版本对；缺失来源不得伪造。

物理迁移使用追加的V0044承接原预留V0011，已执行的其他迁移保持不变。偏好、反馈、改进与观察版本由数据库不可变守卫（V0044–V0046、V0055 的 BEFORE UPDATE OR DELETE 触发器）保证只追加；读路径按已存内容返回，不重算内容哈希——内容身份在写入与边界核对时确认，只报警不恢复的读时重算不进入读路径。该段工程完成不代替具体改进评测、目标owner启停、长期观察或完整经验闭环验证。

具体方法改进与用途交接

方法改进先引用B04已确认且尚待效果验证的确切版本，并至少绑定一份真实反馈。B07从owner读取版本、内容及投影哈希，保存只追加提案版本；标题或理由变化也需要新版本，不接受调用方自报promoted状态。

验证申请使用显式同库同作者的评测用途服务：先保存固定提案、完整请求哈希及幂等命令，再由B10创建实际实验。B07只保留实验身份、目标和条件哈希，不将答案或匿名分配复制到生产。已有真实B10命令可恢复关联，未实际登记不得显示实验已创建。生产默认装配不推导评测连接或凭据。

启停请求先保存不可变意向，再交目标owner的S01用例执行。B07保存原目标回执并读回目标状态；owner已经提交而B07结果登记中断时，重放只补原回执，不再次启用。新请求必须满足当前提案、确切目标版本与对应B10最小证明；恢复历史结果不冒充当前有效批准。Skill及其他用途尚无完整owner链时明确保持未实现，不沿用写手方法或规则诊断证明。

具体规则改进与B06交接

规则改进使用独立规则改进请求，点名B06候选rule_id/version/rule_hash并至少绑定一份B05真实反馈。B07经B06公开投影保存完整目标，仍写V0045既有只追加提案；旧改进请求不增加默认字段，原方法命令内容与哈希保持不变。

规则验证使用独立规则验证请求，先通过B10最小只读投影核对数据集版本、完整规则目标及同库同作者评测身份，再调用执行规则诊断验证。B07结果只登记原B10 run_id/target/result_hash，不创建普通实验、不创建S02或模型任务，也不复制逐例、原文或oracle。

规则启停使用独立规则启停请求，调用方必须先在B06打开确切S01审阅，并把review_id/review_hash、当前激活修订和启用凭据原样交给B07。B07不自动打开或批准审阅，只把同一命令交B06决定并保存原S01回执。新启用还要求本改进已有同目标B10验证登记；B06继续核当前版本、凭据与来源停止状态。停用不依赖仍有效的旧凭据。B06先提交而B07登记中断时，原命令只补原回执，即使来源后来停止也不重做启用。

读取规则改进通过B06公开接口恢复当前规则状态、完整启停历史和该精确版本的真实诊断消费。消费只来自保存诊断中的rule_bindings；B07意向、启用事件和验证运行均不冒充消费。B07不读写B06/B10私表。

长期观察

V0046保留作者自报观察及非空真实反馈引用，可关联确切改进历史版本。人审秒数、返工次数、误杀次数和费用各自允许未知；零是已知值，空值不是零。聚合按改进版本分组，同时展示已知与未知数量；没有已知值时总量也保持空，不混算版本。

这些数字明确标为author_report，不冒充S02实际计费或自动计时。原话、反馈和创建时间保留，重复命令不同内容拒绝，评测角色不能读写。记录观察不确认偏好、不启用目标，统计不生成采纳率因果结论。

有来源的运行观察

V0055将运行观察与V0046自报指标分开保存。入口先通过S02同事务只读用例核对作者、连接用途、真实任务与指定尝试，来源定位绑定任务事件序号及完整摘要哈希；事件序号相同但证据补交发生变化时，仍须核对哈希。当前任务状态、当前步骤状态和指定历史尝试的状态分别保留，失败、未知、仅输入证据和已确认模型交付不互相替代。摘要只含技术引用和哈希，不复制冻结输入、正文、原始响应或配置凭据。未绑定运行配置保留空值。

可选业务来源经owner公共读取核验：B01规划候选绑定该尝试的实际交付调用；B06正文检查绑定该尝试的具名检查事件；B06修订结果绑定原交付调用；B03拆书分析绑定真实分析登记尝试。只保存来源版本、内容哈希和结果摘要，完整业务对象仍由owner回查。未承接的Skill、规则、榜单归因或知识升格来源明确拒绝，不以字符串run_id或技能名制造运行事实。

作者提供的现象、原话和背景标为author_report解释，技术来源标为runtime_evidence；记录状态始终为observation，因果为not_established。相同来源集合与现象只产生一条观察，换命令也不能覆盖原话。原命令或原来源内容重放返回原历史观察，不把后来的任务状态改写进去；新定位与当前版本、哈希不符则拒绝。空来源同时受Python和PG约束，生产作者不能读写evaluation来源。

问题键由作者明确给出，检索按键返回原观察及不同任务数；同一任务的多条说明或多次尝试不能充作跨任务重复问题。不合算自报耗时或费用，不自动形成长期偏好、有效方法、规则或启用状态。

• 一次性要求与长期偏好分开；模型推断先候选，作者明确确认的偏好按偏好合同生效。
• 先形成具体目标内容再评测，评测后改变内容必须形成新版本。
• Skill、提示词和代码改进以可审 Git diff 与构建版本参加评测，运行时仅加载已发布资源。
• 长期效果保留人审时间、返工、误杀和成本等观察，不能仅凭采纳率证明因果收益。

协作与失败

使用 B04、B06、S02 及受控资源发布入口的实际启停接口；B10 对具体目标版本评测。

偏好冲突交作者；无具体目标、评测缺项或哈希不符不能启用；资源未发布不能伪造回执。

验收行为

• 推断偏好不自动长期生效。
• 撤回阻止后续消费。
• 评测后内容变化拒绝启用。
• 目标生效状态只有一个维护者。

验收入口和替换条件见迁移与验收；这些条目是目标行为，不是已通过测试的声明。