理解 AI 原子级修改
只修改指定内容，保留范围外的数据，并通过编辑器自身的事务提交。
本页内容
AI 原子级修改是把自然语言任务转成编辑器能验证的局部操作。例如“把选中标题改成蓝色”，应该只改变该标题的颜色，而不是生成一份新文档覆盖原文。
“原子级”包含两层意思
目标足够精确。 可以定位到文字范围、单元格、内容块或幻灯片对象。目标引用由当前编辑器生成，模型不能凭文字、坐标或自己拼接的 ID 获得编辑权限。
提交有事务边界。 在支持的操作范围内，一个补丁整体校验、整体提交；失败不应留下半份修改，成功进入编辑器原有的撤销流程。不同编辑器的操作组合和事务范围不同，以各自能力接口为准。
一次修改怎样发生
- 用户选择范围。 在编辑器中选择内容，冻结 AI 目标。切换到聊天框后，目标仍然明确。
- 宿主授予权限。 指定哪些内容可读、哪些目标可写、哪些操作允许执行。读取整篇不意味着可以修改整篇。
- 读取当前内容与能力。 Bridge 返回真实目标、当前版本和可用 Schema；长内容按预算分段读取。
- 模型生成结构化补丁。 例如更新文字、设置颜色或修改某个单元格公式，不能把整个文档当作随意替换的输出。
- 预览与校验。 对支持预览的接口先检查变化范围，宿主按产品流程决定是否让用户确认。
- 提交并保存。 通过 Bridge 写入当前编辑器；宿主另行把新版本保存到自己的文件或数据库。
四个具体例子
| 请求 | 合理的修改范围 | 应保留的内容 |
|---|---|---|
| “把合同这一句写得更简洁” | Word 中冻结的文字范围 | 其他条款、页眉、表格和页面设置 |
| “给这一列金额加上两位小数” | Excel 中选定的数据区域 | 其他工作表和未选中的值 |
| “把这个标题改成‘季度计划’” | PPT 当前文字目标 | 其他对象、页面和备注；当前接口仍需按状态验收 |
| “把这段文字标成红色” | 富文本选区上的颜色标记 | 段落结构、附件和其他内容块 |
这些是能力用法说明。模型实际能否执行，取决于当前版本、目标权限及工具是否注册。
组件、Bridge、Skill、宿主各做什么
| 层次 | 职责 |
|---|---|
| 编辑器组件 | 内容显示、选择、原生命令、撤销和数据更新 |
| AI Bridge | 绑定真实实例，捕获目标，校验补丁并执行局部操作 |
| AI 协议 | 工具定义、参数 Schema、版本和约束 |
| Skill | 告诉模型怎样使用这些工具，提供工作流与参考资料 |
| 宿主应用 | 模型调用、聊天界面、用户权限、资源上传、取消请求和持久化 |
只安装 Skill 不会自动连上编辑器。 只显示 AI 按钮也不会调用模型。宿主需要注册真实的工具处理函数，并把授权范围传给 Bridge。
处理失败，而不是覆盖全文
- 目标失效： 用户或协作者修改了内容，重新捕获目标并重新读取；不要重放旧补丁。
- 权限不足： 保持文档不变，由宿主说明原因；不能自行扩大授权。
- 任务取消： 取消模型请求和未提交的上下文，防止迟到的结果继续写入。
- 资源不可用： 图片、附件需要可信资源解析；临时 Blob URL 不能作为长期文件地址。
- 提交成功但保存失败： 告知用户仍有未保存内容；不能把内存中的成功回执当作落盘成功。
按编辑器继续
内容依据组件公开文档 · 2026-10-25常见问题