1.0.0
文档修订 2
Technical Documentation
查阅版本化的 ait-native 技术指南、命令参考、集成、运维与发布契约。
适用人群： Developers, integrators, and operators
找一个技术答案
搜索当前文档
搜索页面标题、命令名、适用人群和技术主题。下面的目录不依赖 JavaScript，随时可以直接浏览。
开始
工作流
CLI · 使用与查看
- ait init创建或重新初始化 AIT 仓库权威与生效的 agent 指令。
- ait config查看生效的工作流路由，并应用明确的仓库配置改动。
- ait status查看当前 Line、仓库状态、工作区状态、远程以及 worktree 健康状况。
- ait diff用有界的路径过滤条件，比较当前工作区与当前 Line head。
- ait blame在修复之前，把某个文件或行区间追溯到对应的 Snapshot 与 Plan 修订。
- ait doctor在不改动仓库权威的前提下，找到定向的诊断入口。
CLI · Agent 工作流
- ait plan记录带版本的 Markdown 沿革，并在配置的范围内同步确切的 sprint 条目。
- ait task启动绑定 Plan 的工作，查看就绪状态，并按配置好的范围完成 Task。
- ait snapshot记录不可变的仓库状态，并查看 Snapshot 内容或父级沿革。
- ait queue查看进行中的工作、评审、远程与 worktree 健康状况的精简清单。
- ait workflow对有界改动分类，准备远程就绪证据，并查看收尾状态。
CLI · 完整 1.0.0 参考
- 完整 1.0.0 CLI 参考浏览每一个公开的 1.0.0 ait 命令与命令组，包含确切的输出语法、选项、默认值、冲突关系和作用边界。
- ait init — 完整参考创建或重新初始化本地 AIT 仓库权威，并刷新生效的仓库指令。
- ait plan — 完整参考记录 Markdown Plan 沿革，查看修订版本，并在选定范围内同步确切的原始 Markdown。
- ait task — 完整参考启动绑定 Plan 的工作，查看并审计 Task 状态，落地已接纳的工作，或放弃未完成的 Task。
- ait blame — 完整参考把某个路径或行区间归因到已记录的 Snapshot 与 Plan 沿革，并提供一个明确的有界恢复选项。
- ait doctor — 完整参考针对配置的 memory 根目录、runtime 根目录或 Plan 权威运行定向诊断。
- ait queue — 完整参考以摘要形式查看进行中的工作、评审、远程和 worktree 清单。
- ait remote — 完整参考注册并列出远程权威，或从一个确切的远程 Repository 权威重建本地 Line head。
- ait release — 完整参考创建并查看发布档案，构建并打包原生产物，发布这些产物，并晋级已接纳的发布。
- ait repo — 完整参考查看或管理已注册的远程 Repository 及其 CI 任务、能力和运行记录。
- ait config — 完整参考查看生效的仓库配置，或设置一个明确的受支持配置值。
- ait external — 完整参考查看、物化、固定、链接、解除链接并诊断外部仓库依赖。
- ait status — 完整参考查看当前的 Line、仓库、工作区、远程和 worktree 状态。
- ait diff — 完整参考用可选的有界路径和输出过滤条件，比较当前工作区与已记录的状态。
- ait pull — 完整参考导入远程 Line 的 Snapshot 历史，判定 head 之间的关系，并可选地物化选定的结果。
- ait push — 完整参考上传已记录的 Snapshot 历史，并推进一条确切的远程 Line。
- ait gc — 完整参考查看、校验并清理符合条件的原生存储包。
- ait stash — 完整参考记录、查看、应用并删除本地未完成工作的 stash 条目。
- ait change — 完整参考在一个 Task 内创建、查看、更新、取消以及以其他方式管理 Change 的生命周期。
- ait snapshot — 完整参考创建并查看不可变的仓库状态，遍历它的父级历史，并重放或恢复已记录的内容。
- ait tag — 完整参考创建、查看、列出并删除指向已记录状态的本地 AIT Tag 引用。
- ait patchset — 完整参考发布并查看 Change 候选，选定当前候选，并管理它的 CI 请求状态。
- ait review — 完整参考为选定的 Patchset 请求、查看并记录评审决定。
- ait attest — 完整参考创建并查看挂在选定 Patchset 上的带类型证据。
- ait policy — 完整参考对选定的 Patchset 评估、查看并显式豁免受支持的策略检查。
- ait worktree — 完整参考查看、诊断、恢复、迁移并清理由 AIT 持有的 Task worktree 及其元数据。
- ait workflow — 完整参考对有界改动分类、校准工作流状态、准备远程就绪条件，并推动配置好的收尾决策。
- ait line — 完整参考查看并管理 Line，切换或恢复工作区状态，合并已记录的历史，并清理符合条件的 Line 记录。
- ait git — 完整参考在 Git 与 AIT 原生仓库模型之间导入、导出并镜像历史。
CLI · 完整 1.0.0 组件参考
- ait-agent — 完整参考配置、查看并管理可选的 Telegram、LINE、Discord 和 Slack 传输 worker。
- ait-agent-worker — 完整参考运行一个已接纳的原生传输 worker，或一次有界的签名请求事务或应答提供方事务。
- ait-server — 完整参考初始化、探测或运行持久的远程 Repository 权威以及 Worker Job 协调。
- ait-runner — 完整参考诊断、执行、认领或提供由服务端持有的带类型 CI 工作。
基础设施与集成
- 并行 Task 隔离通过隔离的 worktree、AIT_RAM 扇出、不可变证据和原子 Land，并行跑多个 coding agent 的 Task。
- 远程基础设施部署明确的 ait-server 与 ait-runner 边界，用于远程权威、异地恢复和仓库自有的 CI。
- ait-server：远程权威与恢复了解 ait-server 的远程工作流权威、Snapshot 保存、灾难恢复、runner 边界与运维职责。
- ait-runner：原生 CI 执行面通过确切的 Worker Job 认领、Snapshot 物化、隔离的执行尝试、有界证据、租约和部署控制，运维 1.0.0 原生 runner。
- ait-server REST API 参考调用每一个 1.0.0 ait-server HTTP 操作，包含与实现对齐的请求字段、响应、错误、恢复流程和安全边界。
- ait-agent：可选的传输管理器了解可选的 1.0.0 传输管理器边界、它的四类 worker、生命周期命令，以及它与 coding client 和原生 worker 可执行文件的关系。
- ait-agent-worker：消息与应答运行时通过它经过验证的命令面、四种传输、Codex 应答提供方、运行时准入和安全边界，运维可选的原生消息 worker。
- Python 集成使用 ait-native PyPI 发行版里自带的、直接在进程内工作的 Python 绑定。
- Node.js 集成使用受支持的 npm 包提供的、直接的 Node-API JavaScript 与 TypeScript 接口。
Binary DB v0 Schema
- Binary DB v0：格式与权威查看 Binary DB v0 的文件格式、整数与偏移规则，以及存储根边界。
- Binary DB v0：工作流记录展开 Task、Change、worktree、Line、Stash、Tag、Land 以及内联工作流链接记录的布局与不变量。
- Binary DB v0：Snapshot 与内容记录展开 Snapshot 父级沿革、Snapshot 链接、Tree、Blob、对象包、manifest 以及可选的文件缓存布局。
- Binary DB v0：Git 互操作记录展开可选的 Git 仓库、generation、身份、commit、文件、ref、Tag 与 checkpoint 映射布局。
- Binary DB v0：服务端与策略记录展开 Patchset、attestation、Actor、评审、策略、豁免、Plan、Repository 注册表与 Worker Job 权威。
- Binary DB v0：payload、索引与编码展开每一类带类型的 payload、可重建索引记录、元数据位分配、enum 以及保留值规则。
- Binary DB v0：身份、恢复与转换展开公开句柄的作用域、原子写入与恢复边界、转换的接纳条件、容量与排除项。
参考
附录
- 附录：配置文件把每一个公开的 1.0.0 AIT 配置文件对应到它的用途、归属、写入边界和详细 schema 参考。
- 附录：.ait/config.json当前 1.0.0 持久化 Repository 配置的完整约定，包含归属、默认值、生命周期写入方、worktree 覆盖项与恢复边界。
- 附录：策略与忽略规则用确切接受的字段和匹配规则，在 .ait/policy.yaml 里配置 1.0.0 的接纳要求，在 .aitignore 里配置仓库可见性。
- 附录：Patchset CI 配置定义规范的 1.0.0 Patchset CI 套件目录、支持的 runner、检查项、产物，以及有界的本地定位器。
- 附录：外部 Repository 配置通过三份 1.0.0 TOML 约定声明、锁定、物化、绑定并在本地覆盖外部 Repository。
- 附录：Agent worker 配置配置具名的 Telegram、LINE、Discord 和 Slack worker，以及凭据优先级、运行时路径、传输模式和本地应答行为。
- 附录：发布 manifest展开通用命令适配器与专用 AIT 原生家族发布 manifest 的 schema、边界与归属规则。
- 附录：环境变量已安装 1.0.0 环境的规范化 31 条约定，明确写出归属、设置方式、机密性与进程边界行为。