文档 · 04

对话与 Agent

Agent 主循环

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

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

中断与恢复

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

交流与工作模式

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

追问与定位

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

项目 Skill

你可以让 Agent 把本书反复使用的任务方法整理成项目专属 Skill,例如固定的章节交稿检查或人物语气核对流程。Agent 会先提出文件修改建议,经你审批写入项目后,本项目后续回合即可使用。

项目 Skill 是普通项目文件,不会获得额外权限,也不能绕过现有的工具和审批边界。