1.0.0
文档修订 2
附录：配置文件
把每一个公开的 1.0.0 AIT 配置文件对应到它的用途、归属、写入边界和详细 schema 参考。
适用人群： 开发者、运维、集成方与发布工程师
配置文件一览#
1.0.0 用一小组仓库文件来承载持久的用户配置。这些文件各自是独立的 约定：一个文件里的值，不会悄悄取代另一个文件所拥有的权威。
| 文件 | 用途 | 常规归属 |
|---|---|---|
.ait/config.json | 仓库身份、Line 与远程路由、工作流默认值、Task worktree 放置位置，以及有界的运行时提示。 | ait init、ait config、ait remote，以及拥有它的那条 AIT 生命周期。 |
.ait/policy.yaml | 由 Repository 策略档位选定的接纳要求。 | ait init；改动要和 .ait/config.json.policy_profile 一起评审。 |
.aitignore | 面向工作区、status、Snapshot 和 Plan 文件系统发现的仓库相对可见性规则。 | 仓库作者。 |
ci/patch_ci.json | 远程就绪所用的 Patchset CI 套件目录。 | 仓库作者；ait remote add 可以创建一个起步文件，但不会覆盖已有文件。 |
ci/config.contract.json | 可选的本地定位器，指向非默认的 CI 套件目录。 | 仓库作者。它不能替代远程注册时要求的那份规范目录。 |
ait-external.toml | 直接的外部 Repository 声明和语言绑定。 | 仓库作者。 |
ait-external.lock | 解析出的确切外部依赖图和 Snapshot 锁定。 | ait external update；生成结果要提交。 |
ait-external.links.toml | 外部物化的本地开发覆盖项。 | ait external link 和 ait external unlink；不要用于可发布的物化。 |
.ait/agent-workers.json | 具名的 Telegram、LINE、Discord 和 Slack agent worker 实例。 | ait-agent <transport> 命令，或者按 schema 操作的运维人员。 |
ait-release.json | 通用命令适配器的发布包、组件、命令和产物。 | 发布作者。 |
ait-release-family.json | 协调一致的 AIT 原生家族发布矩阵。 | AIT release family 维护者；这是一份专用的 AIT 家族约定。 |
.ait-worktree.json | 一个受管 worktree 的叠加层和绑定元数据。 | 仅由 AIT 维护。 |
1.0.0 里，server 没有单独的公开配置文件 ait-server.json、 ait-server.toml 或 .ait/server.*。它支持的运维输入是命令行选项和 写明的环境变量约定。
我该改哪个文件？#
- 优先用拥有该字段的那条命令。它能校验取值，并保住生命周期不变量。
- 只手改作者持有的清单文件，比如
.aitignore、ci/patch_ci.json、ait-external.toml和各类发布清单。 - 把
ait-external.lock、ait-external.links.toml和.ait-worktree.json当成生成的或由命令托管的产物。 - 只要有写明的流程或 worker 环境文件入口可用，就别把凭据放进纳入版本 管理的文件里。
- 启动 Task 或做远程注册之前，先校验 JSON、YAML 或 TOML 语法。未知 字段的处理方式各约定不同，各自的参考页里都有说明。
哪些东西是有意排除在外的？#
运行时状态、缓存、Binary DB 权威、激活回执、生成的产物、包管理器清单、 构建工具配置和 agent 指令文件，都不属于 AIT 自身的用户配置。它们各有 归属，不能从这份附录里推断出来。