ait-agent：可選的傳輸管理器
瞭解可選的 1.1.1 傳輸管理器邊界、它的四類 worker、生命週期命令，以及它與 coding client 和原生 worker 可執行檔案的關係。
適用對象： Agent 維運、整合維護者與 Repository 所有者
在 ait-native 裡的角色#
ait-agent 是個可選的原生管理器，管的是 Repository 範圍內的 Telegram、LINE、Discord 和 Slack worker。它是獨立的可執行檔案，和 主 ait CLI 分開：1.1.1 沒有 ait agent 這個頂層名稱空間，所以要 裝和守著傳輸面，維運得直接用 ait-agent。
它不是主力的編碼應用。日常的互動式工作，還是留在那個已經握著使用者 對話和 Repository 會話的 coding client 裡。只有當你確實需要一個 無介面的傳輸端點時，才裝這個元件。
管理器與 worker 的邊界#
| 元件 | 職責 |
|---|---|
ait-agent | 新增、列出、檢視、啟動、停止、重啟、讀日誌、刪除具名的 worker 設定。Telegram 還額外暴露一套 supervisor 生命週期。 |
ait-agent-worker | 跑起選定的原生傳輸，驗證入站請求，呼叫有界的回覆 provider，把回覆送出去。 |
| Coding client | 擁有主要的互動式編碼體驗，並決定什麼時候執行獲授權的 AIT 工作流程命令。 |
ait-server | 擁有可選的遠端 Repository 權威、異地儲存、恢復狀態和 Worker Job。 |
啟動一個傳輸 worker，本身不會建立 sprint card、Task、Snapshot、 Patchset，也不會 Land。這些仍然是由獲授權的客戶端明確執行的儲存庫 工作流程操作。
公開的命令族#
四種傳輸都暴露這幾組生命週期命令：
add list status start stop restart logs removeTelegram 還多出一組：
supervisor status supervisor start supervisor run
supervisor stop supervisor restart只讀的上手示例是這些：
ait-agent telegram list --json
ait-agent telegram status main --json
ait-agent telegram logs main --lines 100
ait-agent telegram supervisor status --jsonadd 系列命令收傳輸憑據和生命週期路徑。各個傳輸要求的選項並不一樣； 查自動生成的獨立 `ait-agent` 參考， 別把 Telegram、LINE、Discord、Slack 之間的選項互相抄。
設定與金鑰邊界#
管理器命令會在 .ait/agent-workers.json 裡寫入具名條目，並維護它們 的執行時後設資料。憑據必須當金鑰對待：命令要傳 token 時別讓它留在 shell 歷史裡，收緊 worker 的環境和執行時檔案，不做脫敏就別把日誌或 設定副本發出去。
逐欄位的清單說明、憑據優先順序、傳輸預設值、回覆 provider 和沙箱開關， 都寫在 Agent-worker 設定。 執行程序的契約和簽名的一次性命令，寫在 ait-agent-worker。
要不要用它#
當一個受管的外部傳輸，確實能實打實幫維運夠到某個 Repository 時， 才用 ait-agent。別只為了復刻一個 coding client 的介面，或者為了 把訊息功能塞進核心架構，就把它加進來。本地 CLI、原生繫結、Task 隔離、Binary DB，加上可選的 server/runner 路徑，沒有這個管理器 照樣是完整的。