配置文件

Seed 使用 .maw/ 下的结构化文件描述项目事实。配置文件的目标是让 AI、脚本和维护者看到同一份事实，而不是从对话里猜。

核心配置

文件	说明	常见更新时机
.maw/project.yaml	项目身份、默认分支、协作模式和基础策略。	初始化项目、改名、迁移默认分支。
.maw/components.yaml	组件清单、源码路径、文档入口和发布引用。	新增前端、后端、脚本或移动端。
.maw/modules.yaml	模块树、模块档案、路径和验证边界。	页面/API/表/配置归属变化。
.maw/app-runtime.yaml	本地运行、调试、测试和服务入口。	调整启动方式或测试入口。
.maw/capabilities.yaml	可复用能力和治理协议索引。	新增公共脚本、服务、组件或规则。
.maw/project-signals.yaml	风险、澄清、缺口、口径变化和 AI 前置提示。	发现会影响后续任务的信息。
.maw/repository-identity.yaml	仓库角色、公开边界和交付约束。	仓库用途、同步方式或公开策略变化。

环境和发布

文件	说明
.maw/environments.yaml	环境清单和运行位置。
.maw/environments.dev.yaml	共享开发环境覆盖。
.maw/environments.pro.yaml	共享生产环境覆盖。
.maw/releases.yaml	发布环境、发布别名、组件候选和版本记录策略。
.maw/repositories.yaml	仓库同步、公开发布镜像和外部仓库配置。

真实凭证不应写入这些文件。使用引用、占位、示例或本机覆盖。

安全和本机覆盖

文件	说明
.maw/secrets.yaml	密钥引用或示例结构，不放真实值。
.maw/secret-bindings.yaml	密钥用途和绑定关系。
.maw/policies.yaml	脱敏、提交边界和公开策略。
.maw/*.local.yaml	本机覆盖，通常不提交。
.local/.maw/*.yaml	本机私有覆盖，不能进入公开仓库。

读取方式

优先使用脚本读取聚合配置：

python3 ops/scripts/maw-config-merge.py components --format json
python3 ops/scripts/maw-config-get.py components components.0.key --format text

这样可以避免只读单个文件导致遗漏 profile、片段或本机覆盖。

修改后检查

bash ops/scripts/check-local-boundary.sh
bash ops/scripts/check-ai-framework-consistency.sh
bash ops/scripts/check-template-module-docs.sh

如果修改了公开发布或仓库同步配置，再运行对应 readiness 检查。

公开注意事项

• 公开文档只写仓库相对路径。
• 不写开发模式仓库地址。
• 不写真实账号、token、私钥、连接串。
• 不把本机覆盖当作默认配置。
• 不把私有环境能力写成 Seed 开源能力。

下一步

阅读 命令索引，了解这些配置如何被脚本读取和检查。