1.1.1
附錄：設定檔案
把每一個公開的 1.1.1 AIT 設定檔案對應到它的用途、歸屬、寫入邊界和詳細 schema 參考。
適用對象： 開發者、維運、整合方與發布工程師
設定檔案一覽#
1.1.1 用一小組儲存庫檔案來承載持久的使用者設定。這些檔案各自是獨立的 約定：一個檔案裡的值，不會悄悄取代另一個檔案所擁有的權威。
| 檔案 | 用途 | 常規歸屬 |
|---|---|---|
.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.1.1 裡，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 自身的使用者設定。它們各有 歸屬，不能從這份附錄裡推斷出來。