128 lines
14 KiB
Markdown
128 lines
14 KiB
Markdown
<!-- 导航元信息: {"内容描述": "B07 作者经验", "使用场景": "设计、实现或评审对应主题", "使用要求": "与阅读指南的主题权威分工一致"} -->
|
||
# B07 作者经验
|
||
|
||
## 职责与对象
|
||
|
||
作者偏好、反馈观察与具体改进提案，不接管其他模块的生效状态。
|
||
|
||
实例归属以[总体架构](../总体架构.md)为准；结构、状态和公开外壳分别引用数据模型与接口契约。
|
||
|
||
## 公开接口
|
||
|
||
| 用例 | 输入责任 | 输出与后果 |
|
||
|------|----------|------------|
|
||
| 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任务、指定尝试及可选的具名业务来源 | 作者与用途核验后的技术摘要、版本和哈希；只读，不生成观察 |
|
||
| 记录运行观察 | 上述确切来源定位、具名现象、原话、背景和可选问题键 | 只追加运行观察；同命令和同来源现象幂等，改内容拒绝 |
|
||
| 读取运行观察 / 列出运行观察 / 检索重复问题 | 当前作者、观察或任务身份、可选问题键 | 历史观察与按实际任务计数的重复问题，不生成效果判断 |
|
||
| 记录参考挑选反馈 | 检索回执引用、领域标签、选中与拒绝的方法版本清单 | 只追加参考挑选反馈；进入数值信号轨，不直接生成文本偏好 |
|
||
| 读取挑选信号 | 作者、可选领域与方法版本范围 | 选用/拒绝计数与位次聚合，供 B09 偏好重排消费；只读，不改台账 |
|
||
| 汇总推断偏好建议 | 作者、可选领域 | 确定性聚合的只读建议（含真实原话依据与内联证据）；不落库，采纳走既有保存→确认链 |
|
||
| 读取复利度量 | 作者 | 台账统计：首稿采纳率、点踩率等；分母为零保持空值，不构成因果结论 |
|
||
|
||
所有接口在本模块的接口.py 暴露。输入输出类型由同一公开表面导出，外部不导入私有模型或 SQL。
|
||
|
||
## 内部职责
|
||
|
||
| 文件 | 职责 |
|
||
|------|------|
|
||
| 接口.py | 作者经验公开用例和可导入合同 |
|
||
| 模型.py | 作者经验稳定对象、外壳及内部状态 |
|
||
| 存储.py | 作者经验所属记录的 SQL 与版本读写 |
|
||
| 作者偏好.py | 捕获、确认、范围、冲突和撤回 |
|
||
| 反馈对.py | 原稿、改稿、作者原话及决策；参考挑选反馈与挑选信号读取 |
|
||
| 推断偏好.py | 确定性推断建议聚合与复利度量统计 |
|
||
| 观察记录.py | 真实反馈对上的作者自报观察 |
|
||
| 运行观察.py | 实际运行来源、业务回执核对、运行观察与重复问题检索 |
|
||
| 改进提案.py | 具体目标变更、版本及内容哈希 |
|
||
| 验证申请.py | 方法实验或规则专用验证与原结果定位关联 |
|
||
| 启用回执.py | 目标模块启停意向、既有审阅定位及原回执 |
|
||
| 长期观察.py | 人审时间、返工、误杀与退化 |
|
||
|
||
当前入口见[作者经验源码](../../../../src/muse/作者经验/)。原[目标文件清单](../项目目录与文件职责.md)和[文件合同](../文件设计/后端-B07-作者经验.md)保留历史设计意图；其中 `提示词/整理偏好与改进建议.md` 未实现。当前改进提案核对已有目标及反馈，不提供自动生成偏好或分析质量短板的提示词执行链。
|
||
|
||
## 实现约束
|
||
|
||
### 偏好与反馈的当前实现合同
|
||
|
||
偏好以作者、主题和作者/作品/任务作用域确定适用范围。内容和作者原话原样保存；主题只是作者给出的比较键，不从一次拒绝推断长期偏好。临时要求仅绑定一个真实任务；长期偏好可属于作者或作品。明确长期要求经作者保存生效；从反馈推断的偏好先保存待确认版本，采纳走S01审阅、当前版本核对与同事务回执。
|
||
|
||
同主题且作用域重叠的不同内容是可见冲突，不按范围宽窄静默覆盖。确认时必须点名全部冲突偏好的确切版本；同事务撤回这些版本并保存新版本。原版本、原话和回执保留。每位作者的共享读取锁与变更排他锁保护创建、替换、撤回和模型发送，首次新增也使此前明确为空的快照过期。
|
||
|
||
反馈对只接受B05已存在的确切正文或候选版本，核对作者、作品、章节、分支及内容哈希后保存引用、作者原话和决定；不复制正文或修改原候选决定，不把自报反馈当S01采纳证明。反馈幂等键改变内容时拒绝。B07通过公开读取接口恢复版本对；缺失来源不得伪造。
|
||
|
||
反馈台账是通用只追加 payload 账本，按 payload 内 `种类` 字段判别：`改写对照`（默认；存量无该字段的记录按改写对照兼容读取）与 `参考挑选`。改写对照沿用下述版本对合同；参考挑选记录作者在方法检索结果上的挑选与点踩：检索查询、领域标签、检索回执引用（含索引代次与有序结果）、选中与拒绝的 method_version_id 清单及挑选时可从回执恢复的位次。位次用于标记位置偏置。参考挑选反馈不引用正文版本、不构成 before/after 对照，幂等键、不可变守卫与评测角色隔离同改写对照。
|
||
|
||
物理迁移使用追加的V0044承接原预留V0011，已执行的其他迁移保持不变。偏好、反馈、改进与观察版本由数据库不可变守卫（V0044–V0046、V0055 的 BEFORE UPDATE OR DELETE 触发器）保证只追加；读路径按已存内容返回，不重算内容哈希——内容身份在写入与边界核对时确认，只报警不恢复的读时重算不进入读路径。该段工程完成不代替具体改进评测、目标owner启停、长期观察或完整经验闭环验证。
|
||
|
||
### 偏好双轨关系
|
||
|
||
作者偏好双轨并行，职责不互串：
|
||
|
||
- **文本偏好轨**（muse_preference）：topic/text/scope 的人可读语句，经偏好材料注入写手提示词，由作者裁决生命周期（pending→active→withdrawn），以偏好绑定进入冻结快照。文本轨不参与检索排序。
|
||
- **数值信号轨**（参考挑选反馈与 B04 消费统计的聚合）：仅供 B09 方法检索的偏好重排产生偏好分，权重经人工审查版本化。数值轨不冒充作者偏好，不自动生成生效文本。
|
||
|
||
推断偏好是数值轨到文本轨的受控翻译：确定性聚合（不调用模型）从参考挑选台账生成偏好建议；建议是只读呈现面，不自动落库，采纳经既有保存→审阅→确认链成为 origin=inferred 的 pending 偏好，确认沿用既有冲突管理合同，不自动长期生效。护栏：单版本 ≥5 个支撑事件才提出；每次至多返回 5 条，按证据强度降序；建议必须携带一条真实作者反馈原话作依据，保存时校验原话与该反馈一致；v1 不做权重自动调参——重排权重只经人工审查的版本号变更，作者主权延伸到排序策略。复利度量是台账的确定性统计（首稿采纳率、点踩率等）：比率分母为零保持空值不混算零，只作趋势呈现，不构成因果结论。语义归纳升级（模型抽象偏好）须另立受控提案，产物同样只进 pending。
|
||
|
||
### 具体方法改进与用途交接
|
||
|
||
方法改进先引用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 对具体目标版本评测。
|
||
|
||
偏好冲突交作者；无具体目标、评测缺项或哈希不符不能启用；资源未发布不能伪造回执。
|
||
|
||
## 验收行为
|
||
|
||
- 推断偏好不自动长期生效。
|
||
- 撤回阻止后续消费。
|
||
- 评测后内容变化拒绝启用。
|
||
- 目标生效状态只有一个维护者。
|
||
|
||
验收入口和替换条件见[迁移与验收](../迁移与验收.md)；这些条目是目标行为，不是已通过测试的声明。
|