附件与图片预览

无论是在发送首条消息前的新建会话输入框中，还是在活跃会话记录中的既有会话输入框中，Kaiwu 都支持将本地文件直接附加到消息中：

• 新建会话输入框：发送首条消息前
• 既有会话输入框：位于活跃的会话记录内

该功能与关联文件（Link file）不同：

• 附件会将本地文件从你的设备发送到会话中
• 关联文件则引用当前工作区中已存在的文件

在需要发送以下内容时，可以使用附件功能：

• 屏幕截图
• 导出的日志
• 设计资源
• 代码仓库外部的 PDF 或文档
• 尚未存在于工作区中的生成输出文件

如何添加附件

根据运行平台的不同，Kaiwu 支持多种附件添加方式：

• **全平台：**通过附件/文件选择器流程选取文件
• **Web 端：**将文件直接拖放至输入框
• **Web 端：**当浏览器将剪贴板内容暴露为文件时，可直接将其粘贴到输入框中

你可以在同一条消息中同时附加图片和非图片文件。

发送前的预览状态

在发送消息之前，Kaiwu 会将附件作为草稿保留在输入框中。

在新建会话流程中，即使你在同一应用流程中切换（例如打开选择器页面后返回输入框），这些附件草稿仍会保留。

但它们仍属于临时的未发送草稿状态，并未持久化存储。刷新整个页面或重启应用仍可能清空未发送的附件。

非图片文件

非图片文件会显示为带有文件名的附件标签条。

图片

图片附件会显示为行内缩略图，而非纯文件名的标签条。

这样更便于确认：

• 选取的文件无误
• 图片顺序正确
• 没有发错截图

发送前移除

发送前你可以随时移除已添加的附件。

上传进度

发送包含附件的消息时，Kaiwu 会先逐个上传文件，并在输入框中显示各文件的独立进度：

• 图片卡片上会显示带有百分比的上传遮罩层
• 非图片标签条内会直接显示百分比进度

同时发送多个文件时这尤为实用，你能清楚地看到哪些文件仍在上传，哪些已经上传完成。

发送前预览图片

点击输入框中的图片缩略图，可以打开大图预览。

预览弹窗专为发送前的快速确认设计：

• 图片铺满弹窗主体区域
• 文件名保留在顶部标题栏中
• 若附加了多张图片，可直接在同一弹窗中前后切换

在 Web 端，将鼠标悬停在图片上时会显示上一张/下一张控制按钮。

在触控/原生应用界面上，由于没有悬停状态，导航控件会保持常驻显示。

发送附件时的处理机制

Kaiwu 的附件流程与具体提供商无关。

发送包含附件的消息时：

1. Kaiwu 首先上传各个文件
2. Kaiwu 将文件保存至预先配置的附件上传位置
3. 发送的消息中会包含带有固定文件路径的附件块
4. 消息会提示智能体在作答前先从磁盘读取这些路径

这意味着附件在会话环境中等同于真实文件，而不是特定提供商专有的“行内二进制数据块”。

这种设计带来了诸多实际优势：

• 同一份消息历史在不同提供商之间保持通用可读
• 智能体可以直接读取指定的精确文件路径
• 图片附件与非图片附件遵循相同的核心工作流

发送后的图片展示效果

已发送的用户消息会在会话记录中保留其附件。

会话记录中的行内图片

如果附件是图片，Kaiwu 会直接在消息内嵌入展示，而不仅仅是列出文件名。

这样在共享以下内容时，会话记录浏览起来会更加一目了然：

• 屏幕截图
• 原型设计图
• 架构与流程图
• 导出的数据图表

共用图片预览弹窗

点击会话记录中的行内图片，会打开与输入框相同的预览弹窗。

这确保了发送前后的看图体验完全一致。

非图片附件

非图片文件仍会显示在消息的附件栏中，并可直接从中打开。

超大图片或无法预览的情况

Kaiwu 不会强行将所有图片都渲染为行内预览。

如果图片尺寸超出了应用内的预览限制预算，或者无法正常加载预览：

• 附件仍会保留在消息中
• Kaiwu 会回退显示占位符或提供打开文件的路径，而不会伪造预览成功状态

这样既保障了底层文件随时可访问，又保护了会话记录的渲染性能。

附件存储位置

你可以自主控制 Kaiwu 存放已上传消息附件的位置。

打开路径：

• Settings
• Attachments

工作区目录（默认）

默认情况下，附件会保存在当前工作区内。

Kaiwu 默认使用的相对工作区路径为：

.Kaiwu/uploads

该路径相对于工作区根目录，使附件能够与当前会话的其余项目上下文存放在一起。

操作系统临时目录

你也可以选择将附件保存在操作系统的临时目录中，而非工作区内。

这适用于以下场景：

• 不希望将附件文件写入代码仓库或工作树
• 附件仅用作临时的会话输入
• 希望使用上传流程，但不产生多余的工作区文件

版本控制忽略策略

启用工作区存储时，Kaiwu 还可以帮助将附件文件排除在日常版本控制流程之外。

附件设置允许你为工作区上传内容选择忽略策略。

如果你既想享受基于工作区存放附件的便利，又不想误将附件当作待提交的项目文件，这一设置便非常关键。

限制与重要注意事项

大小限制

附件上传仍遵循常规的最大附件尺寸设置。

若文件超出该限制，Kaiwu 会跳过该文件并说明原因。

无单独的图片数量上限

在通用附件设置之上，Kaiwu 并未在输入框中人为附加“只能上传少量图片”的特殊限制。

实际的主要限制仍取决于你所配置文件的大小策略。

图片本质仍是文件

尽管图片附件拥有更优秀的界面呈现，但它们与其它文件遵循相同的核心附件模型。

这意味着：

• 图片作为普通文件上传
• 消息中存储的是文件路径引用
• 智能体直接从会话环境中读取该文件

附件与关联文件的区别

当文件原本位于本地设备、需要导入会话中时，使用附件。

当文件已存在于工作区中、只需在提示词中引用它时，使用关联文件。

示例：

• 附件：“这是我刚在桌面上截的图”
• 关联文件：“请查看 src/auth/login.ts 并解释这个 Bug”

结合评审批注使用附件

评审批注与附件彼此独立，但可以在同一次提示词交互中一并发送。

当你需要向智能体同时提交以下两类内容时，可以结合使用两者：

• 针对具体代码行的一组结构化评审批注
• 截图、日志或导出制品等额外的本地文件

在会话中，若当前工作区有已保存的批注，输入框会将其显示为专用的 Review 标签条/附件徽标。

在新建会话流程中，Kaiwu 还能自动检索所选设备及目录中已保存的评审批注。如果保持评审批注标签条处于启用状态，匹配的评审批注将随首条有效消息一同发送。关闭该标签条不会移除已添加的附件草稿。

提供商专属说明

常规会话消息通过 Kaiwu 的通用附件流程支持附件。

对于路由至 Claude 协作智能体的消息，请参阅 Claude 提供商页面了解该流程当前的附件限制。

参见：

• Claude
• Subagents