本文档由英文原版机器翻译而成。如果翻译版本与英文原版之间存在任何冲突，请以英文原版为准。 阅读英文原版

Slate：代码与文档的实时 AI 协作

Slate 是 Caiioo 用于与 AI 共同编辑代码和文档的工作区。无需来回复制文本，即可通过行内差异对比、注释和版本历史记录进行实时协作。

Slate 的功能

  • 代码、JSON、CSV 和 HTML 编辑 — 编写并编辑带有语法高亮的代码，逐行审查 AI 提出的修改建议，并对每处更改点击 Accept 或 Reject。
  • 富文本和 Word (.docx) 编辑 — 创建带有格式、标题、表格和列表的文档，或打开 .docx 文件，完整支持修订与批注，并可无缝往返兼容 Microsoft Word。
  • 批注与发送（图像、视频帧和音频） — 在 Slate 中打开任意图像、视频或音频文件，点击 Annotate & send 为 AI 进行标注：
    • 图像： 在图像上绘制带编号的高亮区域，为每个区域添加备注，并直接发送到聊天中。
    • 视频： 在任意帧暂停，标记特定点或区域，附上针对该精确时间戳的问题或指令，然后发送。
    • 音频： 在波形图上高亮标记时间戳时刻或范围，为每个片段添加备注，然后发送。
  • CSV 可视化表格视图 — 在原始文本视图旁，以整洁分页的 Visual 表格视图（每页 100 行 × 50 列）打开 CSV 文件，并通过 Accept / Reject 审查建议的单元格修改。
  • 支持外部库的交互式 HTML Slate — HTML Slate 可以从 cdnjs.cloudflare.com 加载脚本和样式表（Three.js、D3、Chart.js、KaTeX 等），以实现交互式 3D 场景、数据可视化和计算器。包含交互式表单的 Slate 在通过 Share to web 发布时仍能保持交互功能。
  • 统一的工作区控制 — 通过悬浮控制栏在 Explore、Edit 和 Code 视图之间切换，执行 Lock / Unlock 防止文档被意外编辑，或展开至 Full screen。
  • 可见即可调的 SVG 绘图 — 打开 SVG（徽标、图表或架构图），通过一键切换在源代码和渲染图像之间来回切换。AI 会在工作时同步渲染绘图，查看结果，并在同一步对话中持续迭代。
  • 支持数学公式排版的 LaTeX 文档 — 打开 LaTeX 文档即可查看公式排版工整的预览效果，同时源码在代码视图中保持安全可编辑状态。
  • 持久化 PDF 标记 — 让 AI 在 PDF 上绘制：手写墨迹、文本备注和图章签名图像。在切换视图时，您的编辑和批注始终保持可见，并会直接写入下载的 PDF 本身。（图章签名仅为视觉标记 — 不属于具有法律约束力的电子签名。）
  • 编辑已连接文件夹中的文件 — 在 macOS、Windows 和 Linux 上，直接从已连接的文件夹中打开文本文件或 Word 文档并在 Slate 中进行编辑。在您选择 Save file 之前，不会向磁盘写入任何内容。
  • 直接在聊天中展示页面 — 任何 HTML Slate 都可以直接在对话内渲染呈现，而无需隐藏在链接之后。

如何使用 Slate

当您要求创建代码或文档时，AI 会自动打开 Slate：

  • “编写一个抓取产品评论的 Python 脚本”
  • “起草一篇关于机器学习的博客文章”
  • “创建一个带有联系表单的 HTML 页面”
  • “编辑此文档并改进语气”

当 AI 打开 Slate 时，您可以：

  1. 阅读代码或文档 — 它以完整格式显示
  2. 审查更改 — 如果 AI 提出编辑建议，查看内联高亮的差异
  3. 接受或拒绝更改 — 点击勾号接受，点击 X 拒绝（一次一个更改）
  4. 进行自己的编辑 — 直接编辑代码或文本
  5. 要求更多更改 — “为此函数添加错误处理”或“使其更简洁”
  6. 查看历史记录 — 点击“历史记录”查看所有编辑，并在需要时还原

代码功能

  • 语法高亮 支持 Python, JavaScript, TypeScript, Java, C++, CSS, HTML, SQL 等
  • 行号 和括号匹配
  • 行内差异 (diffs) —— 逐行查看具体更改
  • 逐项接受/拒绝 —— 对每次编辑进行细粒度控制
  • SVG 代码 ↔ 视图切换 —— 对于 SVG 绘图，只需点击一下即可在原始标记和渲染预览之间切换；编辑代码并实时观察图片更新

富文本功能

  • 格式化工具栏 — 粗体、斜体、链接、列表、表格
  • 标题与块 — 使用结构进行组织
  • 评论 — 留便签而不修改文本
  • 修订跟踪 — 通过彩色高亮显示添加、删除和修改内容。逐个接受或拒绝更改、一键全部接受或拒绝，或者**选择一个区域并使用“✓ 选”/“✗ 选”**来接受或拒绝您所选内容之内的所有修订——就像在 Word 中选择段落一样。
  • 电子表格修订跟踪 — 电子表格（.xlsx）编辑也支持单元格级别的修订跟踪。AI 会逐个单元格提出更改建议，您可以像在文档中一样接受或拒绝每个更改。
  • 查找和替换 — 在整个文档中搜索并替换匹配项

在 Word 文档中审阅更改

  1. 在 Slate 中打开 .docx 文件
  2. 如果您想将自己的编辑记录为建议的更改，请点击 跟踪，然后在 您的姓名 中输入您的名字
  3. 使用 ↑ 和 ↓ 在更改之间移动
  4. 使用 ✓ 或 ✗ 接受或拒绝当前的更改，或者选择文档的一部分并使用 ✓ 选 或 ✗ 选
  5. 准备好在 Microsoft Word 中继续时，将文档下载为 Word

当您将文档下载为 Word 时，您的修订跟踪和评论会被直接写入 .docx 文件本身，因此 Word 会将其作为本地修订打开，并使每个作者的工作保持独立。再次将文件上传到 Caiioo 时，这些内容也会得以保留。

在对话中内联查看 Slate

当 AI 以 HTML 文档形式构建可视化内容（信息图、仪表板、摘要卡片、对比表）时，它可以直接在对话中呈现，而无需让您点击链接打开。

随时均可要求内联显示。 如果文档已存在，而您想直接在对话中查看，只需说*“内联显示”、“在对话中显示”或“在这里显示”*。展示的是同一个文档而非副本：内容不会被重写，库中也不会多出重复项。

出现的位置经过专门设计。 AI 会将文档链接放置在回复中它希望卡片出现的位置，因此卡片可以位于解释文字的中间，而不总是置于顶部。

点击卡片上方的标签可打开完整的 Slate，您可以在其中编辑、查看历史记录或导出。卡片会自动展开以贴合内容，最高可达窗口高度。

仅 HTML 文档支持此种渲染方式。任何其他 Slate（代码、Word 文档、电子表格）仍保持为可点击的链接。

编辑已连接文件夹中的文件

在 macOS、Windows 和 Linux 上，Slate 可以打开位于已连接文件夹中的文件并就地编辑。有关如何连接文件夹，请参阅工作区文件。

该功能适用于文本文件（代码、Markdown、配置文件、纯文本）以及 Word 文档（.docx），编辑时将保留格式、书签和文档结构。

何时保存完全由您决定。 随心输入即可——在您点击保存文件之前，磁盘上的文件不会受到任何改动。文档上方的状态行会显示当前进度：处理时显示草稿已保存在本机。文件尚未保存。，写入完成后显示已保存到文件。

如果底层文件被外部更改，Slate 会提示磁盘文件已更改并提供查看最新更改选项，您可以在其中对比原始版本、您的文本和磁盘文本，并针对每处差异选择保留我的或使用磁盘。互不冲突的编辑会自动合并；有重叠的编辑则等待您手动决定。

撤销单次保存。 保存后立即点击撤销上次保存可将文件恢复原状——只要磁盘上的内容仍然匹配，即使关闭并重新打开文件，撤销状态依然有效。

遭遇意外时您的工作成果不会丢失。 如果应用异常关闭、连接中断或保存受阻，您的编辑内容会保留为可恢复草稿。重新打开文件并点击恢复已保存的草稿即可。您还可以对恢复的草稿执行以下操作：

  • 下载草稿——在 Caiioo 外部保留一份副本
  • 将草稿重新链接到已移动的文件——在移动或重命名文件后将其重新指向该文件（前提是该文件仍保留原始内容）
  • 重新创建缺失的文件——如果原文件丢失，可将草稿作为新文件写回原路径。绝不会覆盖现有文件。

注意——对于 Caiioo 无法安全编辑的文件（二进制格式，或您标记为只读的文件），将以只读模式打开，避免您向无法保存的文件中输入内容。

助理知晓您当前打开的内容

在桌面端应用中，AI 可以获知您正在查看的文档、打开您已在查看的 Slate，并通过名称或内容搜索查找以往对话中的 Slate。因此，输入*“继续编辑我打开的文档”或“找出上周的价格草案”*即可直接生效，无需您翻找链接。

将 Slate 发布到 Web

任何 Slate 都可以转换为任何拥有链接的人都能打开的网页——对方无需拥有 Caiioo 账户。

  1. 打开 Slate 的共享菜单，选择 共享至 Web
  2. 在 发布至 Web 中，在 谁可以打开？ 下，选择 任何拥有链接的人（公开）。默认选项 特定人员 则仅与您指定的人员共享，且不会生成公开页面或预览图
  3. 设置 公开标题，选择 保留期限（包括直到您将其删除），并决定是否 允许搜索引擎收录——该选项默认关闭，因此您发送给三个人看的链接不会变成搜索结果
  4. 在 链接预览图 下，如果您希望链接卡片上显示捕获的图像，请选择 使用此预览（见下文）
  5. 点击 发布

您将看到 公开链接已创建 以及一个 打开页面 按钮。

此链接无法被推测，但并不保密。请像对待密码一样对待它：任何拥有该链接的人都可以打开该页面，将其粘贴到聊天应用中会显示包含标题以及链接预览图（如果您选择了预览图）的预览卡片。您可以随时通过 设置 > 数据 > 共享页面 或共享菜单中的 撤下公开页面 来撤下页面。移除过程大约需要一分钟。

选择链接预览图

在 链接预览图 下，Caiioo 会捕获 Slate 当前的呈现效果。当有人将您的链接粘贴到聊天或贴文中时，卡片上显示的就是这张图片。在您做出选择之前，不会随页面发布任何内容：

  • 使用此预览 会随页面一起发布捕获的图像
  • 重新捕获 会再次进行捕获——例如，在 Slate 完成绘制之后
  • 无图片 则会在发布页面时不附带图片——不做选择也是如此

如果捕获失败，对话框会说明原因，您仍然可以在没有图片的情况下发布：打开 Slate 的预览以捕获其图像。（打开 Slate 的预览，然后点击 重新捕获）、Slate 没有响应。、捕获内容为空白。 或 无法在此设备上捕获该 Slate。

替换已发布的 Slate，或将其发布为新链接

当您共享一个已发布的 Slate 时，对话框会显示该页面当前的链接，并在 该 Slate 已发布 下询问您的意图：

  • 替换已发布版本（相同链接）——拥有现有链接的所有人都会看到此版本，包括其预览图。除非您进行更改，否则该页面将保留其有效期和 允许搜索引擎收录 设置；要保留结束日期，请将 保留期限 保持为 保留当前结束时间，后接具体日期。按钮显示为 更新公开页面，随后您将看到 公开页面已更新。
  • 发布为新链接——现有页面将保留在其链接上，直到到期或您在 共享页面 中将其移除。按钮显示为 发布。

打开对话框时，默认选中 替换已发布版本（相同链接）。如果 Caiioo 无法检查该 Slate 是否已发布，则会提示 无法检查该 Slate 是否已发布，因此将发布为新链接。

提示

  • 您可以在 AI 工作时进行编辑——更改会同步
  • 版本历史记录保留每一次编辑。您绝不会丢失任何内容
  • 通过将 Slate 链接粘贴到聊天中来将 AI 指向任何文档（“这是我想要更新的文件：……”）——它会解析到正确的文档，即使该链接来自不同的对话
  • 以适合您工作流的格式导出：Word (.docx)、PDF、HTML、Markdown、富文本 (.rtf)、用于表格数据的 CSV，或文档的原生格式
  • 下载的 Word 文档会保留其未完成的修订和评论。Markdown 和富文本导出将读取为最终文档，不包含作为动态内容被删除的文本

This guide is maintained by the Caiioo team using Slate, our built-in editor.