ait-native

1.2.0 · 开发中 · 尚未发布

1.2.0 开发指南

准备仓库、了解审查与恢复，并在发布前规划迁移。

1.2.0 · 开发中 · 尚未发布

本草稿说明 1.2.0 开发契约，不代表已有公开软件包、下载、渠道或完成的资格验证。稳定版安装仍为 1.1.4；仅源代码具备的行为需要已准备好的当前开发版可执行文件。

搜索本开发草稿

开发版快速上手

先备好开发版可执行文件。以下是语法参考，不是 1.2.0 安装步骤。使用开发命令前，确认可执行文件身份与 help；仅凭版本字符串不足以证明其源代码功能。

ait --version
ait init --help
ait team contacts --help

在要修改的仓库初始化，查看返回的启动准备状态，并阅读生成的 AGENTS.md：

cd <your-repository>
ait init
ait team contacts --json

首次 init 启用 Teams，并尝试准备 PM Newton。仍需要支持的 agent 主机及返回的激活步骤。已有仓库 init 保留 Teams 配置；显式开关与等待配置的处理方式见上方参考。

向 coding agent 说明结果、限制与验收条件。准备 session 不会开始工作；PM 另行分配范围、sprint 卡与独立 Reviewer。遵循生成的仓库流程；首次构建、测试或捕获 Snapshot 前，先在返回的 Task edit root 检查 .aitignore。AIT 不会导入 .gitignore。

就绪、审查与收尾

Local 与 Remote 是不同操作范围，Teams 与 sprint 绑定都不会选定范围。sprint-on 仓库用卡上的确切开放条目启动 Task，同步卡片并取得 edit root：

ait task start --from docs/sprints/example.md#example/item --intent "Implement the agreed result" --local

卡片与确切条目必须已存在。只在返回的 edit root 工作，运行适用检查，再冻结 Snapshot 交独立 Reviewer。初始工作不需要 Change。Local 收尾由 Reviewer 在干净工作区执行 ait task finish <TASK_ID> --local；未捕获的改动需要 --message "<message>"。原生命令成功才证明应用、完成、清理与确切绑定条目的自动关闭。

Remote 准备中，<REMOTE> 是指定远端名称，<TASK_ID> 是所属 Task。以下仅示范语法，不是对本网站草稿执行的命令：

ait workflow ready <TASK_ID> --remote <REMOTE>
ait workflow ready <TASK_ID> --apply --remote <REMOTE>
ait workflow finish <TASK_ID> --apply --remote <REMOTE>

没有 --apply 的 ready 只检查就绪状态；显式 apply 才准备候选内容并推进实际 CI。保留返回的 Repository、软件包 hash/Job 与 base/final Snapshot 身份；正式候选使用确切 Patchset 身份。不可从软件包响应臆造正式 Patchset。受保护的 finish 前仍须通过真实 CI、必要的独立代码审查、Task 批准与强制 Policy。由指定 Reviewer 收尾；手动 --tests pass 不会提供 CI 证据。即使 exit zero，pending/stopped 也不代表完成。

恢复执行与 Server 重启

情况必要行为
只有 CLI 退出，Server 执行仍有效沿用原候选、Job、模式与身份。当前默认值改变不会重新定义已封存候选。
正式接受前实际重启 Server先恢复已有原生事务以确认提交或回滚。使未完成执行失效、停止旧 Runner/下载使用，只清理已无使用者的自有 CI 资源，否则报告待清理。保留唯一可用的封存来源。
准入的原始 pin 重新准备通过已有 ready apply 与原始完整 --expected-identity <path>／操作上下文重新准备。验证返回的新 Job、相同封存内容/base/revision 与原模式。重新运行真实 CI 与必要独立审查及治理。拒绝过期身份、租约与结果，不可沿用已失效批准。
正式接受已提交，但响应丢失核对匹配的原接受结果，再重试未完成收尾。保留原 ID、接受与一次应用，不新增 Job、CI、审查或重复应用。

未固定身份的全新 ready 无法保证旧封存内容。只读状态与 finish 不会执行重置或重新准备。未知、缺失或矛盾证据必须停止恢复。实际的正式化前 Server 重置不保证同 Job 持续；只有 CLI 重启是另一种情况。这些是必要契约，不代表集成重启或平台验证已通过。

退役与迁移

规划中的公开 1.2.0 家族排除聊天集成可执行文件 ait-agent 与 ait-agent-worker。保留源代码、测试、许可证与历史，Agent Teams 及核心 Python/Node bindings 仍受支持。保留的旧聊天 binding 接口通过已有错误渠道明确报告退役，不提供可运行的聊天功能。

升级前检查实际旧包的文件清单，由原渠道的原生包管理负责升级／卸载。已检查的 1.1.4 Homebrew、APT、WinGet 拥有 ait、ait-server、ait-runner；PyPI 拥有 CLI/server/binding，npm 拥有 command/binding。历史源代码组件列表不证明该渠道安装过退役聊天文件。

只有确实属于软件包的退役文件，才可按该渠道已有所有权规则移除。保留配置与用户数据。GitHub 压缩包与手动安装没有可授权任意删除的包收据：保留其文件，并区分命令来源与所选新候选。不可按文件名直接删除或扫荡 PATH。并排压缩包检查不能证明原生包升级覆盖。

发布说明草稿 · 1.2.0 尚未发布

以上是开发变更与要求。必要的 Community/安全、原生六平台、语言、并行 agent、安装升级、binding 与发布渠道验证，仍需实际候选绑定结果。本轮推迟 Personal 专属协议、当前／旧版兼容与 UI 验收，不代表公开支持 Personal。1.1.4 旧结果与归档手册仅证明原始字节，不代表 1.2.0 已验证、发布或切换 stable/latest。

权威与版本边界

本地草稿依据 Core 已审查的 Agent Teams、init、config、Task 与 workflow 参考，以及 Native 当前 distribution 与 release SOP。这些开发变更尚非已发布手册。定版的 1.1.4 发布来源仅支持稳定版基准；归档技术手册与 PDF 保留原版本及证据。