autos 库模块帮助文档

AA(aardio autos) 在 aardio IDE 环境内运行，禁止发布为独立程序。

基础概念

• 长期记忆（Memories）：AI 主记忆 → 项目 HANDOFF.md → ADR 。
• 会话（Session）：AA 当前窗口的 AI 对话、上下文、记忆。
• 对话（Chat）：当前会话从开始到当前的多轮对话以及上下文。
• 一轮对话（Turn）：用户发送一条消息，AI 回复一条消息的一个完整来回。在 AA 设置中的最大 上下文轮数 指的就是一次对话流（Chat）可以容纳的最大轮次（这通常是一个近似值，AA 需要为固定插入的上下文预留位置）
• 思维链（Chain-of-Thought，CoT）： AI 深度思考时执行的推理过程
• 思考内容（Reasoning Content）：思考内容指 AI 推理过程中生成的内容（输出文本或思考签名）。
• 交错思考（Interleaved Thinking）：指的是 AI 在开启思考模式以后，一边思考（推理）一边调用工具。 在一轮对话内 AI 可连续地、交错地执行思考或调用工具多次。工具调用结束会回传工具调用结果，因此连续调用工具就会自动向服务器发送多次请求。

运行规则

• 一轮对话内部默认保持完整思维链，除非服务器因上下文过长而明确拒绝。一轮对话结束丢弃思考内容，仅记录回复正文。
• 中断与恢复交错思考时，不允许切换 API 协议，部分验证思考签名的大模型可能不允许切换接口。
• AA 交错思考未结束时异常退出后重启，将自动恢复到最后一次工具调用成功后的检查点到内存（会话界面不会显示被恢复的推理过程），点「继续」可恢复会话。
• AA 在每轮对话结束都会丢弃思维链（推理过程），并且允许自由变更 API（可变更模型与 API 协议）。
• 清除对话时，不会清除记忆。新对话将重新读取并锁定主记忆的内容与路径，会话进程中主记忆将只写不读。

库模块

• AA 基于标准库 web.rest.aiChat 创建 AI 对话，基于 web.rest.aiChat.messages 管理对话消息队列
• AA 工具实现与定义基于标准库 autos.tools.handlers, autos.tools.schemas
• AA 技能包由标准库的 autos.skills 命名空间的库实现
• AA 的 MCP 支持由标准库 autos.mcp 实现
• AA 设置界面: autos.ui.setting 实现; 记忆管理界面: autos.ui.memories; 技能包管理界面: autos.ui.skills; AI 与图像接口: web.rest.aiChat.settingForm