聊天

什么是 AI 助手

AI 助手是 Qritor 的创作中枢。在 Qritor 中，几乎所有创作操作都通过与 AI 对话来完成——您用自然语言描述需求，AI 理解后直接执行。

它不是一个简单的聊天机器人，而是一个拥有工具调用能力的智能体 (Agent)：能读取您的小说数据、创建和修改模块、写作和润色章节、管理剧情线和关系图谱。您只需要说"帮我创建一个亦正亦邪的剑修角色"，AI 就会自动调用相应工具完成操作。

面板位置

AI 助手面板位于编辑器右侧，默认开启。面板宽度可通过拖拽左边缘调整。

面板从上到下分为三个区域：

• 顶部栏：标题、历史对话按钮、新建对话按钮
• 消息区：滚动显示对话内容
• 输入区：文本输入框、工具栏、模式选择、模型选择

Agent 能做什么

在默认的 Agent 模式下，AI 拥有完整的创作能力。以下是 AI 可以执行的操作：

能力	说明	示例指令
章节写作	续写、改写、从零生成整章内容	"帮我续写第三章"、"把这段对话改得更紧张"
章节管理	创建、重命名、删除章节	"创建第四章，标题叫'暗流涌动'"
角色/场景/道具/组织	创建、编辑、删除各类模块	"创建一个亦正亦邪的剑修角色"
关系管理	建立、修改实体间的关系	"把张三和李四设为师徒关系"
剧情管理	创建剧情事件、管理故事线和伏笔	"在第五章标记一个转折点事件"
动态信息	记录实体随剧情发展的状态变化	"记录主角在这章觉醒了血脉"
信息查询	搜索角色、章节、关系等信息	"列出所有出场过的角色"

工具调用可视化

当 AI 执行操作时，消息区会显示工具调用卡片，让您清楚看到 AI 正在做什么：

• 每个工具调用显示为一张可展开的卡片
• 卡片左侧有状态指示灯：橙色（执行中）、绿色（成功）、红色（失败）
• 点击卡片可展开查看详细结果
• 多个工具调用以时间线形式串联显示

确认机制

对于会修改您作品的操作，AI 不会直接执行，而是先展示结果等待您确认：

• 创建/修改模块：AI 生成内容后，工具卡片自动展开，显示预览和 「确认」「拒绝」 两个按钮
• 写入章节：编辑器进入写入模式，您可以预览后选择确认或取消（详见 智能写作工具）
• 修改章节：编辑器进入修改模式，以分栏对比展示改动（详见 智能写作工具）

查询类操作（如搜索角色、查看章节内容）会自动执行，无需确认。

上下文感知

AI 不只是读取您发送的消息——每次对话时，它还会自动获取丰富的背景信息：

• 当前选中项：左侧模块树中高亮的章节或模块，AI 会自动了解您当前的工作对象
• @提及的模块：您在消息中主动引用的角色、场景等（详见 @提及）
• 小说全局信息：设定、模块结构、知识图谱等

这意味着您不需要每次都重复解释背景——AI 始终了解您的小说。

上下文窗口与自动压缩

AI 模型有一个上下文窗口——它能同时"看到"的信息总量。您的聊天记录、小说数据、@提及的模块内容都会占用这个窗口。

输入区左下角有一个饼图图标，实时显示上下文窗口的使用比例。悬停可查看具体的 Token 用量和窗口大小。

当对话积累了大量消息、即将接近窗口上限时，系统会自动触发上下文压缩——将较早的消息压缩为一份摘要，保留最近的消息原文。压缩后 AI 仍然"记得"之前讨论的要点，只是不再逐条保留所有历史消息的细节。这个过程是自动的，您不需要手动操作。

如果对话经过多次压缩后，AI 的回忆开始变得模糊，可以考虑新建对话并用 @提及 引用需要参考的内容。详见 对话管理。

输入区功能

文本输入

• 直接输入文字与 AI 对话
• Enter 发送消息，Shift+Enter 换行
• 输入框高度随内容自动调整

@提及

输入 @ 可引用小说中的模块作为上下文，帮助 AI 更精准地理解您的需求。详细用法见 @提及 页面。

/技能

输入 / 可触发技能命令——这些是预设的专业操作流程，例如生成大纲、提取角色等。技能支持模糊搜索，按回车或点击选择。详见 技能 页面。

快捷操作按钮

输入框左侧提供以下快捷按钮：

• +（添加引用）：手动添加模块引用或文字引用
• AI 生成：一键为当前选中的模块生成 AI 内容（仅支持 AI 生成的模块类型显示此按钮）

消息类型

AI 助手中的消息包含多种内容形式：

• 文本回复：AI 的普通文字回复，支持 Markdown 格式
• 工具调用卡片：AI 执行操作时的可视化展示（见上文）
• 思考过程：如果模型支持，AI 的推理过程会以可折叠的卡片形式展示，帮助您理解 AI 的决策逻辑
• 流式 JSON 预览：提取实体等操作时，实时预览生成的结构化数据

模型选择

输入区右下角的模型选择器让您随时切换 AI 模型：

• 点击显示可用模型列表
• 不同模型在能力、速度和价格上各有特点
• 可以在对话中途切换模型
• 如果某个模型出现问题，错误提示中会提供"切换模型"的快捷入口

详见 模型 页面。

模式切换

输入区左下角的模式选择器用于切换 AI 的工作模式。详见 AI 模式 页面。

使用建议

• 直接说需求：不需要使用特定的指令格式，用自然语言描述您想做什么，AI 会理解并执行
• 善用确认机制：AI 的每个修改操作都需要您确认，不满意可以拒绝并提出调整要求
• 关注工具卡片：展开工具调用卡片可以了解 AI 具体做了什么，帮助您验证结果
• 搭配 @提及：讨论特定角色或场景时，用 @ 引用它们，AI 能给出更精准的回应
• 留意上下文用量：关注饼图指示器的颜色变化，系统会自动压缩过长的对话，但如果 AI 回忆变模糊，可以新建对话重新开始