本指南中所用术语的快速参考，以及对常见问题的解答。
术语表与常见问题
术语表
| 术语 | 定义 |
|---|---|
| Agent | 执行某个 Pipeline 步骤的 AI“工作者”，配置有特定的提供商和模型。参见 Settings。 |
| Archive | 每个已完成 Task 的可搜索记录，含完整的结果详情。已归档的 Task 可通过 Restore 放回队列。参见查看结果与 Archive。 |
| Auto-merge | Task 选项 autoMergeDev，会将已完成并通过测试的 Task 自动合并到 dev。参见创建 Task。 |
| Branch / Worktree | 为每个 Task 创建的隔离 Git 分支和独立工作文件夹，使其不会影响其他工作。参见 Pipeline。 |
| Brainstorm | 用于与 AI 进行开放式探索和规划、而不编辑代码的面板。参见 Brainstorm。 |
| Chat | 每个项目的对话面板，用于快速的、感知 Contract 的提问和讨论。参见 Chat。 |
| Contract | 一份保存下来的事实说明，描述项目中某一特定部分的行为，并自动保持同步。参见 Knowledge Sharing。 |
| Dashboard | AITM 的主工作区视图，显示项目标签页、卡片和 Task 队列。 |
| Dev Panel (AITM Dev Panel) | 由 AITM 服务器提供的可注入 JS 工具栏（aitm-dev-panel.js），它会叠加显示已标记的 UI 元素，提供实时事件计数器和检查器，并将 DOM 交互回报给 AITM，使其能够构建并维护项目的 DOM 元素地图。参见 DOM map + Dev Panel。 |
| dev branch | 每个 Pipeline Task 合并进入的默认/集成分支。参见合并、合并后修复与 Scope Gate。 |
| DOM Explorer | 针对带有前端的项目，登记项目真实 UI 元素以及“什么触发什么”的注册表。参见 Variable Explorer & IntelliSense。 |
| E2E (End-to-End) | 像用户那样在浏览器中操作真实运行的应用的自动化测试。参见 Testing。 |
| Hint | 一条简短、可复用的规则，AI 会在今后的 Task 中自动应用，无需重复说明。参见 Knowledge Sharing。 |
| Integration branch (defaultBranch) | 每个项目的设置，指明该项目的 Task 合并到哪个分支（默认为 dev）；可在项目设置中编辑，并带有“Verify remote”检查。参见合并、合并后修复与 Scope Gate。 |
| Knowledge Graph | 由项目的变量、Contracts、UI 元素和文档相互连接而成的地图。参见 Knowledge Sharing。 |
| License slot | 一个项目槽位：许可证规定了 AITM 可以管理多少个项目。它不限制同时运行多少个 Task—那是 Pipeline 中单独的设置 Max concurrently running tasks。参见许可与项目槽位。 |
| Lite mode | 一个 Task 选项，在编码模型足够强大时跳过 Architect 规划步骤。参见创建 Task。 |
| main branch | 稳定的发布分支，仅在发布时通过 dev → main 合并进行更新。参见合并、合并后修复与 Scope Gate。 |
| Merge queue | 将合并到 dev 的操作逐个串行化，并尝试自动解决冲突的机制。参见 Pipeline。 |
| Pipeline | 由 12 个步骤（branch → architect → code → compliance-check → review → fix → test → e2e → verify → snapshot → docs → chain-audit）组成的自动流程，将 Task 的提示词转化为完成的更改，随后由 Merge queue 将其合并到 dev。参见 Pipeline。 |
| Priority | Task 在队列中位置的提示：low、medium 或 high。参见创建 Task。 |
| Project | 已接入 AITM、可为其创建 Task 的代码库。参见概览与入门。 |
| Provider | 执行 Pipeline 步骤的底层 AI 服务（Claude、Gemini、OpenAI、DeepSeek、NVIDIA、Ollama）。参见 Settings。 |
| Status (task) | Task 的当前状态：pending、running、awaiting_input、waiting、finished、failed、stopped、conflict 或 archived。awaiting_input 表示 AI 正在等待您的回答或批准；waiting 表示 Task 正在等待修复 E2E 测试发现的 Bug。参见创建 Task。 |
| Task | 一个交付给 Pipeline 的单个工作单元。参见创建 Task。 |
| Turn | 大致相当于 AI Agent 思考/行动的一个步骤（例如读取或编辑文件）。参见 Settings。 |
| Verdict | 测试步骤的通过/失败（或更详细的）结果，尤其是 E2E 判定。参见查看结果与 Archive。 |
| Watchdog | 检测停滞的 Pipeline 步骤并自动恢复它们的后台进程。参见 Pipeline。 |
常见问题
如果 Task 失败会怎样？
Pipeline 会在失败的步骤停止，Task 状态变为 failed，并记录原因。在弄清出了什么问题之后，通常可以从该步骤（或更早的步骤）恢复—参见查看结果与 Archive。
可以同时运行多个 Task 吗？
可以，跨不同项目即可。在单个项目内，Task 一次只运行一个，以避免两个 Task 争用同一个分支；不同项目则完全并行运行。
AITM 会自行推送到远程或生产分支吗？
不会。自动合并只会合并到本地的 dev 分支。推送到此之外的任何位置，始终是您自己有意进行的单独操作。
如果 AI 在 Task 中途卡住了怎么办？
Watchdog 会发现停滞的步骤并自动恢复 Pipeline，最多尝试有限的次数。如果仍然无法恢复，Task 会被标记为 failed，并保留原因，以便您决定下一步怎么做。参见 Pipeline。
我的数据存储在哪里？
存储在本地，包括项目级数据库、Task 文件夹和自动生成的文档。完整地图请参见 AITM 存储哪些数据。
需要写出完美的提示词吗？
不需要，但提示词越具体，需要的修复循环越少。请参见创建 Task中的提示词写作技巧。
Chat、Brainstorm 和 Task 有什么区别？
Chat 和 Brainstorm 用于讨论和规划—它们绝不会触及您的代码。Task 是唯一真正更改代码的方式，并且始终要走完经过审查和测试的完整 Pipeline。参见 Chat 和 Brainstorm。
“License blocked (session-mismatch)”横幅是什么意思？
许可证服务器发现同一个密钥同时从两个地方发送心跳—可能是第二个 AITM 实例、克隆的虚拟机，或与原实例并行运行的已恢复备份。在该状态解除之前，队列不会接纳任何 Task。请停止重复的实例，然后点击横幅中的 Retry（或 Settings → License 中的 Refresh from server）。如果确定只存在一个实例，则该封锁属于误报，可以从同一横幅中解锁。参见许可与项目槽位。
为什么 Task 合并后页眉会显示“Restart”按钮？
AITM 合并了对其自身代码的更改，在默认的 manual 模式下，会等待您操作后再重启，以免中断正在运行的队列。请等待运行中的 Task 完成，然后点击页眉菜单中的 Restart。对于无人值守的服务器，请将 Settings → Git & Storage → Server restart after self-merge 设置为 auto。
为什么没有任何 Task 在运行，Task 却一直停留在 pending？
可能是并发限制为 0、出现了许可证横幅，或资源守卫因 RAM/CPU 低于空闲百分比阈值而暂缓了 Task。请检查状态栏（RAM/CPU）、许可证横幅以及 Settings → Pipeline → Max concurrently running tasks。Monitor 栏的 Queued 标签页会显示每个作业为何在等待。