文档 · 03

对话与 Agent

Agent 主循环

InkCraft 的对话不是一次性问答，而是多步 Agent 循环：

1. 理解意图：分析你的请求，决定是否需要读取文件、搜索或修改。
2. 使用工具：列目录、读文件、搜索、运行受控命令、提出修改。
3. 请求审批：高风险写入前先给你看修改内容。
4. 解释过程：每一步做了什么、为什么这样做，都留在对话与 trace 中。

中断与恢复

• 长任务可以随时中断；Agent 会停在当前步骤并保留现场。
• 会话持久化在本地，关闭应用后重新打开，对话历史与工作状态仍在。
• 长会话会自动进行上下文压缩，保留关键结论，避免超出模型上下文。

交流与工作模式

对话支持不同的工作模式（由你切换），控制 Agent 是只交流讨论，还是可以动手修改文件。云端响应不会替你改变本地模式，模式主权始终在你手里。

追问与定位

• 对话中引用的文件、行号可以点击定位到编辑器对应位置。
• 你可以随时追问「你刚才改了哪些文件」，Agent 会列出修改清单。