ait-agent：可选的传输管理器
了解可选的 1.0.0 传输管理器边界、它的四类 worker、生命周期命令，以及它与 coding client 和原生 worker 可执行文件的关系。
适用人群： Agent 运维、集成维护者与 Repository 所有者
在 ait-native 里的角色#
ait-agent 是个可选的原生管理器，管的是 Repository 范围内的 Telegram、LINE、Discord 和 Slack worker。它是独立的可执行文件，和 主 ait CLI 分开：1.0.0 没有 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 路径，没有这个管理器 照样是完整的。