编辑器 AI 写作辅助

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

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

模型配置

写作模型地址、Key 和模型名为空时复用 Chat 模型。需要隔离费用、风格或权限时，可以配置独立写作模型。

选区操作

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

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

多轮策略

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

大纲生成

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

输入限制

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

验证

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

SSE 格式见 SSE 协议。