- src/muse 新版全模块（装配/共享/上下文/任务运行/作品规划/故事世界/正文写作/审校修订/知识方法/作者经验/效果评测/交付连载/资料研究/正式变更/元数据/接入/基础设施/编排）+ 测试树（单元/契约/集成/架构/迁移/端到端/夹具）
- 129 项功能全部实现与自动验证（功能覆盖.json/矩阵），含 W31 补齐的规则与代价/节奏安排/伏笔与承诺
- 旧实现按处置清单退出（702 条中 324 删，保护合同与未迁移条目留存有据）；web/app.py 旧工作台退役，新工作台为唯一写入口
- 数据库/旧库迁移：真实旧库内容批次迁移链（端点守卫/PG作品正文映射/质量资产缺省投影）
- 运行手册 docs/运行手册.md；W30 本机服务阶段一已运行（infra PG 为正式内容权威）
- R2 执行证据与私有运行材料在 .agents.local/改造/R2-20260909/（不入库）

2026-09-15 12:47:42 +08:00

6.4 KiB

Raw Blame History

B04 知识方法

职责与对象

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

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

公开接口

用例	输入责任	输出与后果
propose_method	来源、范式类别、适用范围与结构	方法候选
confirm_method	已审版本与证据	已确认方法版本
bind_method	作品或规划、具体方法版本	固定绑定与影响
change_method_state	预期生效版本、验证和作者批准	启用、停用或撤回回执
核对启用	作者、方法ID、B10证明ID	只读核验当前方法、生产/评测材料一致性和证明有效性，供作者查看后明确决定
record_usage	上下文、实际片段与结果引用	不可变消费关联
读取方法评测材料	维护事务、作者、具体确认版本ID	核原确认内容、版本与证据，按S04 generation/evaluation投影；只形成B10受批准的资料快照，不启用方法或写生产消费
核对方法评测投影	同用途元数据连接和已封存材料	重验内容/结构/字段策略哈希；评测不直接读正式方法表

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

内部职责

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

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

实现约束

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

协作与失败

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

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

验收行为

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

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

6.4 KiB Raw Blame History Unescape Escape