- 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

3.1 KiB

Raw Blame History

S04 元数据

职责与对象

类型和结构定义、版本、扩展与投影，不拥有业务实例值。

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

公开接口

用例	输入责任	输出与后果
register_type	类型身份、粒度和已登记生命周期族	类型候选
publish_schema	字段结构及兼容检查	不可变结构版本
compose_schema	基础和作品扩展的明确版本	有效结构与哈希
validate_value	有效结构、用途和候选值	结构问题与引用校验需求
project_fields	结构、用途和受控授权摘要	允许字段与剔除原因
activate_binding	被审结构、预期绑定和影响处理	结构绑定回执

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

内部职责

文件	职责
接口.py	元数据公开用例和可导入合同
模型.py	元数据稳定对象、外壳及内部状态
存储.py	元数据所属记录的 SQL 与版本读写
类型登记.py	类型、粒度、业务归属和生命周期族
结构版本.py	不可变结构发布、启用及固定读取
扩展合成.py	基础结构和只增不改的作品扩展
字段校验.py	类型、必填、枚举、嵌套和引用结构
字段投影.py	展示、编辑、检索、导出和 AI 用途
变更影响.py	兼容分类、受影响实例及升级要求
内置导入.py	内置种子幂等登记，保护已存在绑定和扩展

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

实现约束

保留基础字段、开放内容字段和同生命周期新类型；系统身份与原生绑定由代码登记。
基础版本与作品扩展合成可重复，不能随 active 指针变化重新解释历史数据。
结构校验与真实引用校验分工，后者由实例所属模块执行。
内置种子是发布输入；PG 保存生效版本，启动不覆盖作者扩展。
字段消费与结构/策略变更经同一类型级事务锁排序：消费持共享咨询锁，变更持排他咨询锁并保护实际更新行。评测账号只拥有元数据读取权限，不能为消费锁授予表写权限；多个类型按统一顺序保护，锁不跨模型网络调用。

协作与失败

业务模块和 B09 消费；前端通过 owner 投影得到结构和值；结构变更使用 S01 保护。

不兼容变更返回转换要求；结构、投影和实例版本不同步时拒绝；未知处理器和越权字段拒绝。

验收行为

M01 新字段贯通。
M02 新类型贯通。
M03 扩展不能绕过保护。
M04—M08 版本、用途、迁移与并发。

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

3.1 KiB Raw Blame History Unescape Escape