7.1 KiB
Raw Blame History

B04 知识方法

职责与对象

跨作品写法、证据反例、版本、绑定及实际消费。

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

公开接口

用例 输入责任 输出与后果
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逐文件设计保留历史目标,不承担当前文件位置镜像。

实现约束

  • 保留场景、套路、技法、节奏、情绪、战斗等既有范式语义;这些是内置分类,结构共用 S04 的版本机制,同生命周期的新方法类型可以登记扩展。
  • 方法提案不能改动已确认方法的标题、内容身份和当前版本。方法类型须与所选结构一致;同一方法修订不改换类型,提案不得夹带不可编辑字段。
  • 确认内容身份包含类型、标题、可编辑内容、参数上限、有效结构哈希和证据。仅修改证据也形成独立版本;复用既有版本不绕过 S01 当前来源复检,后续版本号按历史最大号递增。
  • 版本标题和证据以其确认提案为准,绑定、检索与回查不混入后续提案。历史无确认提案的版本可回查,但不能新绑定或作为模型消费材料。
  • 绑定检查作者对作品与方法的归属,记录具体版本,不默默追随 active;变更绑定使相关候选重新判断依赖。
  • 方法取材显式接收任务的内容用途与运行用途,按 S04 aiContext 投影;首次授权只返回该用途允许的字段,冻结后按结构哈希与投影版本复检。来源证据同时核对用途授权和具体版本实存。
  • 范式价值不能仅由被检索到或任务运行成功推断;实际使用与效果分开。
  • 方法的实际生效状态只在本模块维护。
  • 启用命令的“启用凭据”必须指向B10导出的具体目标证明;旧“验证对象”消费记录不能替代效果。当前仅接写手用途证明,方法状态与enablement消费审计在S01同事务写入;证明绑定来源、版本、材料、资源、策略与期限。状态依赖使用真正的FOR UPDATE当前行锁,禁止仅查版本却声称持有指针锁。
  • 由新证明启用的方法只开放generation用途,其他用途明确拒绝;既有绑定仍固定原版本,不因新版本启用而默换。证明来源停止、过期或当前投影不同后阻止新消费,旧交付和启用记录保留。历史启用的迁移边界继续保留,不把旧消费记录补造为新证明。
  • 模型消费登记须同时核对 S02 当前尝试的授权派发回执、完整输入/响应证据、有效交付状态及已登记消费处理器;派发与输入证据的请求哈希相同,任务、作者、用途、调用、用户输入哈希必须一致。单有自报引用或没有派发授权的旧调用不能登记;已有历史记录可回查,不补造授权。生产消费入口只写生产消费表,其他用途返回 USAGE_SCOPE_UNSUPPORTED,不得借此入口将隔离评测结果写入生产。
  • 实际模型输入须携带 上下文快照ID 与 装配材料;由 B09 核对同任务快照、派发时的快照指纹、入选版本、来源绑定和逐键片段,不以当前方法重新渲染的文字替代历史输入。用于校验的模型输入仅瞬时传递,不写入消费表或延长原文保留。
  • 任务与尝试仍有效时,合法派发并取得有效完整交付的消费按历史事实登记;交付后、登记前的方法停用不阻止该次登记。停用继续阻止新派发与正式采纳,任务取消或旧尝试迟到不能绕过 S02 交付有效性。
  • 消费记录说明有效模型交付时确有方法输入,不证明整条任务完成、方法有效或版本已测。后续步骤失败不擦除已经发生的消费;没有有效模型交付的任务不能补写消费。
  • 方法版本、类别、快照、片段、任务与调用共同形成不可变消费键。同一真实调用返回幂等回执;同快照的不同真实调用分别留痕,不覆盖或冒充前次回执。旧无任务或调用的记录保留历史约束,不升级为真实消费证明。

协作与失败

B03 提供参考分析,B07 提出具体改进,B10 返回已测版本判据,B09 记录实际消费。

证据不够、绑定越界、版本停用或验证对象不一致时停止新消费或拒绝启用。

验收行为

  • 绑定不追随最新版本。
  • 停用后新任务不再消费旧方法。
  • 源和反例可以定位。
  • 启用回执对应实际已测版本。

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