编辑器 AI 写作辅助

适用读者：Halo 作者、编辑人员

写作辅助嵌入 Halo Tiptap 编辑器，包含选区气泡菜单、多轮 Composer 和大纲生成器。

模型配置

写作辅助通过 Halo AI Foundation 调用模型。写作模型资源名为空时复用 AI Foundation 语言模型；需要隔离费用、风格或权限时，可以在 AI Foundation 中配置独立语言模型，再在 AI 智能套件写作配置里引用对应模型资源名。

编辑器兼容范围

当前版本只支持 Halo 官方默认编辑器。写作辅助通过默认编辑器提供的 Tiptap 扩展点接入，使用第三方编辑器时不会显示“AI 大纲”按钮、选区操作菜单或多轮 Composer。

开启或关闭写作辅助后，如果文章编辑页已经打开，请刷新页面或重新进入编辑器，使扩展加载状态生效。

选区操作

1. 在编辑器中选中文字。
2. 选择润色、续写、扩写、简化或译英。
3. 等待流式回复。
4. 继续输入附加要求，形成多轮修改。
5. 选择应用、复制或重新生成。

应用时会尽量保留外层 block 类型和选区 marks。原文中 marks 混合时，当前实现可能统一沿用首字符 marks，应用后应检查粗体、斜体和链接。

多轮策略

• 首轮输入原文和动作。
• 后续轮使用上一条 AI 输出作为文本，并携带新指令。
• 每一轮都是独立模型调用，不是服务端长期会话。

大纲生成

可以配置章节数、1～3 层深度、编号方式、温度和附加要求。大纲 JSON 越深越容易出现格式错误，因此不支持 4 层以上。

在默认编辑器工具栏点击“AI 大纲”，输入文章主题并生成；确认预览后再应用到当前文章。

输入限制

默认单次输入上限为 6000 字符。超过限制会返回错误，不会静默截断。长文建议分段处理。

验证

• 总开关关闭后，气泡菜单和大纲入口都消失。
• Enter 发送，Shift+Enter 换行。
• SSE 中断后能够重试。
• 应用后标题、段落和常用 marks 保持正确。
• 写作用量记录为 writing_assist。

SSE 格式见 SSE 协议。