9e6f1c4481
- src/muse 新版全模块（装配/共享/上下文/任务运行/作品规划/故事世界/正文写作/审校修订/知识方法/作者经验/效果评测/交付连载/资料研究/正式变更/元数据/接入/基础设施/编排）+ 测试树（单元/契约/集成/架构/迁移/端到端/夹具） - 129 项功能全部实现与自动验证（功能覆盖.json/矩阵），含 W31 补齐的规则与代价/节奏安排/伏笔与承诺 - 旧实现按处置清单退出（702 条中 324 删，保护合同与未迁移条目留存有据）；web/app.py 旧工作台退役，新工作台为唯一写入口 - 数据库/旧库迁移：真实旧库内容批次迁移链（端点守卫/PG作品正文映射/质量资产缺省投影） - 运行手册 docs/运行手册.md；W30 本机服务阶段一已运行（infra PG 为正式内容权威） - R2 执行证据与私有运行材料在 .agents.local/改造/R2-20260909/（不入库）
11 lines
1.3 KiB
Markdown
11 lines
1.3 KiB
Markdown
# 文档与资源生成规则
|
||
|
||
> 权威合同：`docs/系统架构/新版设计/文件设计/工程配置与部署.md`；机械门禁：`工具/维护索引.py --检查`、`工具/构建资源包.py`。
|
||
|
||
1. **生成物只由登记输入产生**：`src/muse/资源/运行资源.zip` 与 `清单.json` 只从 `工具/资源登记.json` 打包；`docs/接口契约/生成/*` 只从 `工具/生成输入.json` 生成。改生成物先改登记。
|
||
2. **生成物不手改**：`src/muse/资源/`、生成 Schema 与 OpenAPI 是产物；直接编辑会被下次生成覆盖并视为违规。
|
||
3. **索引一致**：所有 `目录.md` 表内相对链接必须可达；技能分组索引与磁盘技能一一对应。编辑期检查受影响链接与索引，文档交付批次稳定后集中运行 `make 检查`，全绿才算完成；不为每次文字修改重复全量检查，未影响目录信息时不改索引。
|
||
4. **资源带发布身份**：资源包必须有 `发布身份` 与逐文件 sha256；生产加载只认安装包内清单，不读未审工作树。
|
||
5. **声明即验证**：写入 README/Makefile/工作流的命令必须先在本地真实执行通过；未验证的命令不得声明。
|
||
6. **单一权威**：正文性定义只在所属权威文档修改；索引、投影和引用不复制第二份定义。
|