muse-agent-example/docs/系统架构/新版设计/文件设计/后端-B04-知识方法.md

后端-B04-知识方法：文件合同

本页从目标文件清单投影，共 12 个目标条目。测试身份与行为合同在现行用例清单；文件和目标合同不代表实现或验收已完成。

返回目录 · 完整项目树 · 现行用例清单

本部分文件树

agent-example/
└── src/
    └── muse/
        └── 知识方法/
            ├── __init__.py  # Python 包身份
            ├── 存储.py  # 方法本体、确认版本、提案、证据、绑定与消费的SQL读写；不写派生索引
            ├── 接口.py  # 知识方法公开用例和可导入合同
            ├── 提示词/
            │   └── 提炼写作方法.md  # 跨作品方法候选模板
            ├── 方法卡.py  # 六类范式、条件、去重与冲突
            ├── 方法启用.py  # 核对已测方法、生产投影和启用凭据，状态只由B04维护
            ├── 方法版本.py  # 确认、修订、启用、停用和撤回
            ├── 方法绑定.py  # 作品与规划固定方法版本
            ├── 模型.py  # 知识方法稳定对象、外壳及内部状态
            ├── 消费记录.py  # 核对真实模型输入与交付、快照入选版本及片段后不可变登记；严格区分幂等与不同调用冲突
            ├── 证据反例.py  # 来源、样例、例外及反例
            └── 评测材料.py  # 确认版本评测投影、原字节及字段策略复核

逐文件合同

src/muse/知识方法/接口.py

• 归属与种类：B04；源码。
• 意图：让调用方通过稳定用例操作知识方法，隐藏模块内部组织。
• 职责：知识方法公开用例和可导入合同。
• 边界：唯一跨模块表面；导出输入输出合同，不暴露私有 SQL 或任意处理器。
• 目标：HTTP、CLI 和编排对相同用例得到一致验证、失败与结果。
• 合同依据：业务公开接口。

src/muse/知识方法/模型.py

• 归属与种类：B04；源码。
• 意图：把知识方法的稳定数据骨架与执行实现分开。
• 职责：知识方法稳定对象、外壳及内部状态。
• 边界：纯模型和状态合同；不联网或写库，不把题材属性写死为类字段。
• 目标：稳定外壳可校验，动态内容携带结构绑定并在所属校验链验证。
• 合同依据：稳定模型。

src/muse/知识方法/存储.py

• 归属与种类：B04；源码。
• 意图：将知识方法的数据访问与版本写入局限在本模块。
• 职责：知识方法所属记录的 SQL 与版本读写。
• 边界：只操作本模块记录并使用调用方事务；不跨 owner 写表或调用模型。
• 目标：版本读写及回滚可验证，不产生第二个独立事务结果。
• 合同依据：模块存储。

src/muse/知识方法/方法卡.py

• 归属与种类：B04；源码。
• 意图：把写法整理成可复用且有边界的资产。
• 职责：六类范式、条件、去重与冲突。
• 边界：维护方法候选与语义；不把本书事实或一次采纳当通用规律。
• 目标：每张卡能说明条件、证据、反例及与邻类区别。
• 合同依据：专属业务职责。

src/muse/知识方法/证据反例.py

• 归属与种类：B04；源码。
• 意图：防止方法只有结论而没有适用依据。
• 职责：来源、样例、例外及反例。
• 边界：维护引用与例证关系；不伪造来源，不代替实际效果评测。
• 目标：方法的正例、反例和例外均可回查固定来源。
• 合同依据：专属业务职责。

src/muse/知识方法/方法版本.py

• 归属与种类：B04；源码。
• 意图：让方法启用和退役只有一个生效维护者。
• 职责：确认、修订、启用、停用和撤回。
• 边界：只改变方法自身版本状态；启用核对已测内容与作者批准。
• 目标：新任务不消费停用版本，启用回执指向实际同一版本。
• 合同依据：专属业务职责。

src/muse/知识方法/方法绑定.py

• 归属与种类：B04；源码。
• 意图：保护作品已经选择的具体写法版本。
• 职责：作品与规划固定方法版本。
• 边界：固定版本而非 latest；换绑产生影响，不在写作阶段重新海选。
• 目标：方法升级不静默改变旧绑定，旧候选在依赖变化时失效。
• 合同依据：专属业务职责。

src/muse/知识方法/消费记录.py

• 归属与种类：B04；源码。
• 意图：区分检索到的方法与真正进入上下文的方法。
• 职责：实际上下文使用与结果关联。
• 边界：记录实际消费及结果引用；不把使用次数等同文学增益。
• 目标：每次消费可定位任务、版本、片段和结果。
• 合同依据：专属业务职责。

src/muse/知识方法/提示词/提炼写作方法.md

• 归属与种类：B04；源码。
• 意图：为知识方法的“提炼写作方法”任务提供可版本化表达。
• 职责：跨作品方法候选模板。
• 边界：仅定义本任务提示；角色身份、字段结构、权限和预算从各自权威装配。
• 目标：模板可随发布包加载且记录哈希，不含固定作品内容或测试答案。
• 合同依据：业务提示资源。

src/muse/知识方法/__init__.py

• 归属与种类：工程；源码。
• 意图：明确安装包和模块的导入身份。
• 职责：Python 包身份。
• 边界：只声明包及必要公开导出；不读取运行数据、连接网络或启动任务。
• 目标：正常安装后可从任意 cwd 导入，导入无运行副作用。
• 合同依据：Python 包身份。

src/muse/知识方法/评测材料.py

确认版本评测投影、原字节及字段策略复核。合同见效果评测。生产生效版本仍由B04与作者批准控制，隔离消费不能直接启用。

src/muse/知识方法/方法启用.py

• 归属与种类：B04；源码。
• 职责与目标：核对已测方法、生产投影和启用凭据，状态只由B04维护。
• 边界：只交接确切已测写手方法；生产不读答案，B04维护状态，合成结果不作生产批准。
• 合同依据：目标启用凭据。