muse-agent-example/docs/系统架构/新版设计/模块设计/B04-知识方法.md

B04 知识方法

职责与对象

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

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

公开接口

用例	输入责任	输出与后果
propose_method	来源、范式类别、适用范围与结构	方法候选
confirm_method	已审版本与证据	已确认方法版本
bind_method	作品或规划、具体方法版本	固定绑定与影响
change_method_state	预期生效版本、验证和作者批准	启用、停用或撤回回执
record_usage	上下文、实际片段与结果引用	不可变消费关联

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

内部职责

文件	职责
接口.py	知识方法公开用例和可导入合同
模型.py	知识方法稳定对象、外壳及内部状态
存储.py	知识方法所属记录的 SQL 与版本读写
方法卡.py	六类范式、条件、去重与冲突
证据反例.py	来源、样例、例外及反例
方法版本.py	确认、修订、启用、停用和撤回
方法绑定.py	作品与规划固定方法版本
消费记录.py	实际上下文使用与结果关联
提示词/提炼写作方法.md	跨作品方法候选模板

完整路径及运行模板见目标文件清单。逐文件意图、边界与目标见文件合同。

实现约束

• 保留场景、套路、技法、节奏、情绪、战斗等既有范式语义；这些是内置分类，结构共用 S04 的版本机制，同生命周期的新方法类型可以登记扩展。
• 绑定记录具体版本，不默默追随 active；变更绑定使相关候选重新判断依赖。
• 范式价值不能仅由被检索到或任务运行成功推断；实际使用与效果分开。
• 方法的实际生效状态只在本模块维护。

协作与失败

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

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

验收行为

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

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