5a10d9680b
- 冻结修订检查点记录装配入选的参考清单（版本与材料哈希），旧任务无键向后兼容 - 模型修订真实交付后与候选保存同事务按 kind=review 登记消费，幂等由既有合同保证 - B04 消费流程白名单登记 审校修订×revision.generate；_核对材料片段 扩至 references 节 - B04/B06 契约同步；新增集成用例 a10023/a10024（登记与不登记两路）
76 lines
7.4 KiB
Markdown
76 lines
7.4 KiB
Markdown
<!-- 导航元信息: {"内容描述": "B04 知识方法", "使用场景": "设计、实现或评审对应主题", "使用要求": "与阅读指南的主题权威分工一致"} -->
|
||
# B04 知识方法
|
||
|
||
## 职责与对象
|
||
|
||
跨作品写法、证据反例、版本、绑定及实际消费。
|
||
|
||
实例归属以[总体架构](../总体架构.md)为准；结构、状态和公开外壳分别引用数据模型与接口契约。
|
||
|
||
## 公开接口
|
||
|
||
| 用例 | 输入责任 | 输出与后果 |
|
||
|------|----------|------------|
|
||
| propose_method | 来源、范式类别、适用范围与结构 | 方法候选 |
|
||
| confirm_method | 已审版本与证据 | 已确认方法版本 |
|
||
| bind_method | 作品或规划、具体方法版本 | 固定绑定与影响 |
|
||
| change_method_state | 预期生效版本、验证和作者批准 | 启用、停用或撤回回执 |
|
||
| 核对启用 | 作者、方法ID、B10证明ID | 只读核验当前方法、生产/评测材料一致性和证明有效性，供作者查看后明确决定 |
|
||
| record_usage | 上下文、实际片段与结果引用 | 不可变消费关联 |
|
||
| 读取方法评测材料 | 维护事务、作者、具体确认版本ID | 核原确认内容、版本与证据，按S04 generation/evaluation投影；只形成B10受批准的资料快照，不启用方法或写生产消费 |
|
||
| 核对方法评测投影 | 同用途元数据连接和已封存材料 | 重验内容/结构/字段策略哈希；评测不直接读正式方法表 |
|
||
| 读取消费统计 | 作者、方法版本范围 | 按版本聚合的实际消费计数，供 B09 偏好重排的强信号路；只读，不改消费台账，不把被检索或任务成功当作消费 |
|
||
| 读取参考材料 | 作者、确切方法版本清单、两种用途 | 当前且已确认或启用版本的参考材料渲染与哈希，供参考改写冻结与依赖复检；不查启用凭据、不写消费 |
|
||
| 读取版本头 | 方法版本清单 | 版本→标题/类型/状态/是否当前的只读窄头，非法或缺失身份跳过；供 B07 推断建议渲染标题，不展开材料 |
|
||
|
||
所有接口在本模块的接口.py 暴露。输入输出类型由同一公开表面导出，外部不导入私有模型或 SQL。
|
||
|
||
## 内部职责
|
||
|
||
| 文件 | 职责 |
|
||
|------|------|
|
||
| 接口.py | 知识方法公开用例和可导入合同 |
|
||
| 模型.py | 知识方法稳定对象、外壳及内部状态 |
|
||
| 存储.py | 知识方法所属记录的 SQL 与版本读写 |
|
||
| 方法卡.py | S04 method 实例族、条件、去重与冲突 |
|
||
| 证据反例.py | 来源、样例、例外及反例 |
|
||
| 方法版本.py | 确认、修订、启用、停用和撤回 |
|
||
| 方法绑定.py | 作品与规划固定方法版本 |
|
||
| 消费记录.py | 实际上下文使用与结果关联 |
|
||
| 提示词/提炼写作方法.md | 跨作品方法候选模板 |
|
||
|
||
上表列关键职责；当前公开能力以接口.py及其行为测试为准。[R2逐文件设计](../文件设计/后端-B04-知识方法.md)保留历史目标，不承担当前文件位置镜像。
|
||
|
||
## 实现约束
|
||
|
||
- 保留场景、套路、技法、节奏、情绪、战斗等既有范式语义；这些是内置分类，结构共用 S04 的版本机制，同生命周期的新方法类型可以登记扩展。
|
||
- 方法提案不能改动已确认方法的标题、内容身份和当前版本。方法类型须与所选结构一致；同一方法修订不改换类型，提案不得夹带不可编辑字段。
|
||
- 确认内容身份包含类型、标题、可编辑内容、参数上限、有效结构哈希和证据。仅修改证据也形成独立版本；复用既有版本不绕过 S01 当前来源复检，后续版本号按历史最大号递增。
|
||
- 版本标题和证据以其确认提案为准，绑定、检索与回查不混入后续提案。历史无确认提案的版本可回查，但不能新绑定或作为模型消费材料。
|
||
- 绑定检查作者对作品与方法的归属，记录具体版本，不默默追随 active；变更绑定使相关候选重新判断依赖。
|
||
- 方法取材显式接收任务的内容用途与运行用途，按 S04 `aiContext` 投影；首次授权只返回该用途允许的字段，冻结后按结构哈希与投影版本复检。来源证据同时核对用途授权和具体版本实存。
|
||
- 范式价值不能仅由被检索到或任务运行成功推断；实际使用与效果分开。
|
||
- 方法的实际生效状态只在本模块维护。
|
||
- 启用命令的“启用凭据”必须指向B10导出的具体目标证明；旧“验证对象”消费记录不能替代效果。当前仅接写手用途证明，方法状态与enablement消费审计在S01同事务写入；证明绑定来源、版本、材料、资源、策略与期限。状态依赖使用真正的FOR UPDATE当前行锁，禁止仅查版本却声称持有指针锁。
|
||
- 由新证明启用的方法只开放generation用途，其他用途明确拒绝；既有绑定仍固定原版本，不因新版本启用而默换。证明来源停止、过期或当前投影不同后阻止新消费，旧交付和启用记录保留。历史启用的迁移边界继续保留，不把旧消费记录补造为新证明。
|
||
- 模型消费登记须同时核对 S02 当前尝试的授权派发回执、完整输入/响应证据、有效交付状态及已登记消费处理器；派发与输入证据的请求哈希相同，任务、作者、用途、调用、用户输入哈希必须一致。单有自报引用或没有派发授权的旧调用不能登记；已有历史记录可回查，不补造授权。生产消费入口只写生产消费表，其他用途返回 `USAGE_SCOPE_UNSUPPORTED`，不得借此入口将隔离评测结果写入生产。只接受已实现的真实消费步骤，流程白名单随实现登记：generation×生成正文、planning×生成规划、review×完整审校、review×审校修订（入选参考在修订候选真实交付后登记）；新流程接入须先扩白名单，不默认放行。
|
||
- 实际模型输入须携带 `上下文快照ID` 与 `装配材料`；由 B09 核对同任务快照、派发时的快照指纹、入选版本、来源绑定和逐键片段，不以当前方法重新渲染的文字替代历史输入。用于校验的模型输入仅瞬时传递，不写入消费表或延长原文保留。
|
||
- 任务与尝试仍有效时，合法派发并取得有效完整交付的消费按历史事实登记；交付后、登记前的方法停用不阻止该次登记。停用继续阻止新派发与正式采纳，任务取消或旧尝试迟到不能绕过 S02 交付有效性。
|
||
- 消费记录说明有效模型交付时确有方法输入，不证明整条任务完成、方法有效或版本已测。后续步骤失败不擦除已经发生的消费；没有有效模型交付的任务不能补写消费。
|
||
- 方法版本、类别、快照、片段、任务与调用共同形成不可变消费键。同一真实调用返回幂等回执；同快照的不同真实调用分别留痕，不覆盖或冒充前次回执。旧无任务或调用的记录保留历史约束，不升级为真实消费证明。
|
||
|
||
## 协作与失败
|
||
|
||
B03 提供参考分析，B07 提出具体改进，B10 返回已测版本判据，B09 记录实际消费。
|
||
|
||
证据不够、绑定越界、版本停用或验证对象不一致时停止新消费或拒绝启用。
|
||
|
||
## 验收行为
|
||
|
||
- 绑定不追随最新版本。
|
||
- 停用后新任务不再消费旧方法。
|
||
- 源和反例可以定位。
|
||
- 启用回执对应实际已测版本。
|
||
|
||
验收入口和替换条件见[迁移与验收](../迁移与验收.md)；这些条目是目标行为，不是已通过测试的声明。
|