AI 对话

AI 对话是 Knodo 的核心功能，让您可以通过自然语言与 AI 助手交流。本文档介绍如何有效地使用 AI 对话功能。

对话界面

错误提示与恢复操作

对话异常时，卡片会用易懂的说明告诉您发生了什么以及下一步怎么做，并直接提供可用的操作按钮，无法识别的异常会在卡片内直接显示原始错误内容，方便排查；已识别的异常只显示说明，分享页不显示原始内容。

发送类按钮只在系统确认原执行已结束、没有活动执行且卡片仍对应最新回复时可用；提交期间禁用，避免重复执行工具。旧卡片不能再次执行过时操作。

「重新」只对最新一次失败的回复可用，发送的是会话中最新一条消息的原文（含正文里已有的文件引用），模型、权限等参数使用当前输入框的设置，不会单独保存原请求的参数；如果最新一条是中途补充的消息，重发的也是这条。没有文字内容的消息无法重发，请手动重新发送。对话更新后，旧的错误卡片不再提供操作。

提交前置失败、网关返回纯文本错误或网络断开时，错误显示在独立的提交提示中，不会伪装成 AI 回复。自动重连耗尽时，会提示已暂停重连，并提供「重新连接」按钮。分享页面只提供只读的错误说明，不开放执行动作或原始错误内容。

界面布局

工作空间详情采用单层空间壳层：左侧选择空间，右侧围绕当前空间展示 Header、会话工作区和资源工作区。桌面端可在“会话 + 资源”“资源 + 会话”“纯会话”“纯资源”四种布局间切换；AI 对话不再固定为右侧边栏。

• 左侧空间列表：在“最近”和“全部”空间之间切换，快速进入不同工作空间。

• 当前空间 Header：显示空间信息、执行环境、布局切换、任务/知识高频入口、「更多」、成员和设置等操作。

• 会话工作区：AI 对话区域，包含：

  • 会话标签：管理多个对话会话

  • 消息区域：显示对话历史

  • 输入区域：输入消息和工具栏

• 资源工作区：通过统一资源 Tab 打开文件预览、任务、Diff、视图、自动化和自定义 Panel。选择任务、知识、变更等资源时，会在资源内容区左侧按需浮出对应子导航。

移动端界面

Knodo 也支持移动端使用，在手机上可以随时与 AI 对话：

开始对话

在输入框中输入您的问题或需求，按回车发送：

在新对话中指定 AI 助手

当一个工作空间里有多个 AI 助手时，你可以在发起新对话前先选定最适合当前问题的助手。例如问人事制度时选择 HR 助手，咨询产品功能时选择产品助手，处理代码问题时选择研发助手。这样不需要在每次提问里重复交代背景，AI 会用更贴近场景的方式回应。

助手选择只在新对话开始前生效。会话创建后会固定使用当时选择的助手，输入框工具栏会展示当前助手名称；未选择助手时，则按默认空间聊天继续。

如果当前空间没有可选 AI 助手，你仍然可以直接发起默认聊天。需要某个特定角色或专业能力时，可以联系管理员邀请对应的 AI 助手加入空间。

输入方式

文字输入

直接在输入框中输入文字：

• 支持多行输入（Shift + Enter 换行）

• 支持 Markdown 格式

• 支持表情符号

粘贴 Excel 表格

从 Excel、WPS 表格或网页表格复制区域后，在输入框直接粘贴：

• 会优先生成可编辑的 GFM Markdown 表格源码，并按显示宽度自动对齐列。
• 单元格中的竖线、Markdown 控制符会被转义；单元格内换行会转换为安全的表格换行表示。
• 输入框中的表格源码使用等宽字体并支持横向滚动，方便检查行列对应关系。
• 粘贴普通文本、代码、截图或文件时仍使用原有处理方式；无法识别的表格不会被转换。
• 超过长文本阈值时，会沿用自动转存为文件的处理流程，不会截断表格内容。

输入历史搜索

在聊天输入框中按 Ctrl + R 可以打开输入历史搜索，快速找回自己之前发送过的消息，再次使用常见指令或补充相似需求。

• 输入关键词可以筛选历史输入内容。

• 使用方向键选择记录，按回车将记录回填到当前输入框。

• 再次按 Ctrl + R 可以在匹配结果中继续切换。

• 按 Esc 关闭历史搜索。

输入历史保存在当前浏览器本地，按当前用户维度记录，不按工作空间拆分。相同内容会自动去重，重复发送时移动到最新位置。

语音输入

点击麦克风按钮进行语音输入：

1. 点击麦克风图标
2. 开始说话
3. 点击停止或等待自动停止
4. 语音转文字后显示在输入框

详细了解：语音输入

文件上传

可以上传文件让 AI 分析：

拖拽上传

直接将文件拖入对话界面

点击上传

点击附件按钮选择文件

粘贴上传

截图或复制本机文件后，在输入框直接粘贴（Ctrl/Cmd + V），会自动上传文件而不是插入文件名。

上传限制：

• 单个文件最大 50MB
• 不限制文件扩展名
• 图片仍会校验扩展名、MIME 类型与文件内容是否匹配
• 超过空间存储上限时，需要清理文件或由空间管理员在“空间设置-存储管理”中调高存储上限

更多配置

输入框工具栏中的更多配置用于调整当前对话的发送偏好：

• 展开文件修改：默认展开 AI 返回的文件创建、编辑、删除结果，便于直接检查变更内容。

• 折叠过程详情：开启后，AI 回复中已完成的工具步骤（如思考、读取文件、执行命令）以及步骤之间的过程说明会合并为一行“已完成 N”，回复默认只保留这一行和最终回答，长任务也能一眼看到结论。

  • 正在执行的步骤会展开显示参数和进度，完成后自动收起并并入“已完成”行。
  • 点击“已完成”行可按原顺序展开全部过程，每个步骤仍可单独展开查看参数和结果；您手动展开过的步骤不会被自动收起。
  • 需要您确认权限、回答问题的步骤，以及紧挨在它们前面的说明文字，始终单独显示，不会被折叠。
  • 中途执行失败或已取消、但 AI 已继续处理的步骤属于过程细节，会一起并入“已完成”行，行上会标出“失败 N”，展开即可查看；只有最后一个工具步骤失败或取消时才单独显示，便于您了解结果受到的影响。
  • 同时开启“展开文件修改”时，文件创建、编辑、删除结果及其前面的说明文字保持展开显示，不会被合并进“已完成”行。
  • 开关只影响显示方式，对当前会话的历史消息同样生效，不会改变对话内容。

• 任务通知：进入聊天对话通知设置，用于在长时间对话完成、需要回答问题或需要确认权限时提醒您。

• 思考强度：在支持的运行时中选择自动、低、中、高等模式。自动表示使用模型默认推理强度；更高强度适合复杂代码、深度分析和长链路任务，但响应时间可能更长。

• 压缩会话：压缩当前会话上下文，适合对话过长但仍希望在原会话中继续推进时使用。

• 克隆会话：无损复制当前会话上下文到新会话，适合保留原对话并开启一个新的处理分支。

• 压缩并克隆：先基于历史内容生成压缩上下文，再在新会话中继续，适合上下文很长且希望开启新分支时使用。

这些配置会按工作空间和运行时保存为本地默认值，新消息、快捷命令和表单类命令都会沿用当前选择。“展开文件修改”“折叠过程详情”等开关切换后作用于当前对话；点击右侧星标可将当前值设为该工作空间的默认值，刷新页面或新建对话后依然生效。

聊天对话通知

当 AI 对话需要等待较长时间时，您可以开启聊天对话通知。这样在切到其他应用、其他浏览器标签页、其他工作空间，或收起对话面板后，对话完成、需要您回答问题、需要您确认权限时，Knodo 会通过浏览器通知或 IM（钉钉、飞书、企微等）通知提醒您。

聊天输入区的“更多配置”只提供通知配置入口，实际偏好、通知列表、投递状态和诊断说明统一在 通知中心 查看。

上下文窗口使用率

使用 Claude Code 或 Codex 运行时的会话，输入框底部工具栏会在模型选择器右侧显示一个环形进度和百分比，表示当前会话已占用的模型上下文窗口比例。数值来自 CLI 自身的统计口径，与本地 Claude Code /context、Codex 终端底栏看到的值保持一致。

• 颜色提示：低于 70% 为常规颜色，70%–90% 为警示色，90% 及以上为危险色。接近上限时，CLI 会自动压缩上下文，您也可以通过“更多配置”中的“压缩会话”主动压缩，或新建对话。

• 查看明细：鼠标悬停在指示器上即可预览明细，移开后自动关闭；点击指示器可固定浮层，再次点击、点击页面其他位置或按 Esc 关闭。也可以用键盘 Tab 聚焦后按 Enter / 空格打开。

• 明细内容：包括使用率进度条、已用 tokens / 窗口大小、自动压缩阈值（CLI 提供时显示）以及数值的更新时机：

  • 执行中：AI 正在回复时实时刷新，每次模型调用后更新；
  • 上一轮结束时：打开或刷新会话时显示的是上一轮回复结束时保存的值。

• 何时不显示：新会话在首次获得数据前（Claude Code 首次响应前、Codex 首次模型调用前）不显示；执行 /clear 或切换到新的 CLI 会话后，旧值会被清空，直到新数值到达。部分模型未提供窗口大小时，只显示已用 tokens。

• 移动端：只显示环形图标，点击即可打开同样的明细浮层。

访客、分享链接、只读查看和嵌入式对话场景不显示该指示器。

浏览器自动化

输入框工具栏中的地球图标用于连接桌面版 Chrome。安装并连接 Knodo Browser Connector 后，AI 可以在您的浏览器中打开网页、点击、输入、滚动、截图并读取页面信息，协助完成网页操作任务。每个对话第一次真正执行浏览器自动化前，AI 会先在对话中展示自动化风险提示；部分站点可能触发风控、验证码或账号限制。

详细了解：浏览器自动化

Codex 子代理过程

使用 Codex runtime 时，AI 可能会把复杂任务委托给子代理。子代理会在对话中显示为 Agent 任务卡片，卡片中包含委托内容、执行过程和任务结论。

• 委托内容：展示主代理交给子代理的目标或提示词，可展开查看。

• 执行过程：聚合子代理内部的命令、文件读取、搜索和 MCP 工具调用。

• 任务结论：展示子代理完成后的摘要或结果。

• 失败原因：当子代理失败或被取消时，卡片会区分渠道凭据、环境变量、工具权限、工作目录和普通任务错误。

Codex 子代理继承主会话的模型渠道、工作目录、插件/MCP 和权限边界。对话界面和日志不会展示渠道 Key、Token 等敏感值明文。

引用知识库

使用 @ 引用

在消息中使用 @ 引用知识库文件：

引用步骤

1. 输入 @ 符号
2. 出现文件选择器
3. 搜索或浏览文件
4. 点击选择文件
5. 文件引用添加到消息中

AI 自动检索

AI 会根据对话内容自动检索相关文档：

• 无需手动引用

• 自动匹配相关内容

• 回答中标注来源

使用命令

使用 / 命令

在输入框中输入 / 触发命令选择器：

• Claude Code 与 Codex 的 Skill 命令会在名称下方展示 SKILL.md 中的描述，便于在执行前区分技能用途。

• 没有描述的命令只展示名称，不重复显示同一名称。

• 使用方向键浏览，输入关键词搜索

• 点击或按回车选择

可用的命令取决于工作空间绑定的 Plugin，不同的 Plugin 提供不同的命令。

如果想要更显现的表达，可以查看：快捷工具栏

对话管理

执行中断与恢复

对话执行期间短暂断线时，会从当前会话最后收到的事件继续订阅，并刷新历史确认执行状态；无需重新发送原消息。如果 Rust Chat Runtime 暂时不可用，请稍后重试；已发送的消息是否继续执行，以刷新后的会话记录为准。恢复可能因执行材料缺失而出现部分内容缺口。

新建对话

点击"新建对话"按钮开始新的会话。

对话历史

在侧边栏查看历史对话：

• 按时间排序

• 显示对话摘要

• 点击切换对话

编辑会话标题和标签

鼠标悬停在历史会话条目上，会显示编辑和删除图标：

• 编辑（铅笔图标）：点击后打开编辑弹窗，可以修改会话标题和管理标签

• 删除（垃圾桶图标）：点击后确认删除会话（硬删除，不可恢复）

标签功能帮助你快速分类和识别会话：

• 每个会话最多添加 5 个标签

• 每个标签最长 20 个字符

• 支持添加和移除标签

搜索和标签搜索

历史会话面板支持后端搜索，提供两个独立的搜索输入框：

• 关键词搜索：在搜索框输入关键词，匹配会话标题和消息内容

• 标签搜索：在标签输入框中输入标签关键字，精确匹配会话标签

• 组合搜索：关键词和标签可以组合使用，取交集

查看全部会话

对话标签页上点击历史对话，然后在弹出来的会话历史选择框的右侧底部"查看全部"，即可进入我的会话页面，查看和管理你的所有会话记录：

• 搜索会话：通过关键词快速搜索历史会话

• 筛选排序：按时间、工作空间等条件筛选和排序

• 批量管理：支持批量删除不需要的会话

• 跨工作空间查看：集中查看所有工作空间中的会话记录

详细了解：我的会话

删除对话

1. 在 我的会话 提供会话删除能力

对话技巧

1. 提供清晰的背景

2. 分步骤提问

复杂问题分解为小问题：

3. 给出示例

4. 指定格式要求

5. 利用工作规范

确保工作规范中包含项目背景信息，AI 会自动参考。

多模态对话

图片分析

上传图片让 AI 分析：

• 描述图片内容

• 提取图片中的文字

• 分析图表数据

文档分析

上传文档进行分析：

• PDF 报告解读

• 代码文件审查

• 数据文件处理

AI 回复

用户消息显示

用户消息会安全渲染常用 Markdown：表格、代码、标题、列表、引用、粗体、斜体、删除线和链接。单个换行会保留显示效果，原始 HTML 不会执行，危险链接协议会被禁用，外部图片也不会自动加载，而是显示为安全链接。

较长的用户消息默认最多展示 3 个渲染行，超出时可以点击“展开”查看完整内容，再次点击“收起”恢复折叠。折叠和展开只影响显示，不改变发送给 AI 的原始 Markdown 源码。

回复格式

AI 回复支持：

• Markdown 渲染

• 代码高亮

• 表格显示

• 列表格式

操作按钮

AI 回复下方提供操作按钮：

继续对话

可以基于 AI 的回复继续追问：

分享对话

您可以将 AI 对话分享给团队成员：

1. 在对话标签页上右键点击，选择"分享会话"
2. 配置分享选项（有效期、访问密码等）
3. 生成分享链接发送给同事

目前仅支持组织内分享，也不支持选定消息条数。更多分享选项和管理方法，请参阅 资源分享。

中断和重试

中断生成

AI 正在回复时，可以点击"停止"按钮中断生成。

常见问题

Q：提交答案时提示“当前回答已过期”怎么办？

A：当前问题状态已发生变化，这次回答没有提交成功。请点击提示旁的“刷新会话”按钮，刷新当前页面并重新加载会话，再根据最新问题重新回答。系统不会自动将旧答案提交给新问题。

Q：AI 回复不准确怎么办？

A：尝试提供更多背景信息，或使用更具体的描述。

Q：对话记录会保存多久？

A：对话记录永久保存，除非您手动删除。

Q：AI 会记住之前的对话吗？

A：在同一会话中，AI 会记住之前的内容。切换到新会话后，上下文会重置。

Q：可以让 AI 执行操作吗？

A：AI 可以帮助您生成内容和分析信息，但某些操作（如修改文件）需要您确认。

相关文档

• AI 助手

• 模型配置

• 快捷命令

• 语音输入