Skip to content

AI Agent 智能助手

学习如何使用 All Writer 的 AI Agent 功能,提升写作效率。

AI Agent 概览

All Writer 提供统一的 AI Agent 写作助手,位于界面右侧面板

快速导航

如果你想按任务直接查看:

核心特性

  • 🤖 统一助手 - 一个 Agent 适配所有写作场景
  • ReAct 模式 - AI 推理 + 工具调用
  • 🔧 11 个工具 - 浏览、读取、写入、搜索、记忆
  • 🔀 双阶段工作流 - 写作(writing)/ 审阅(review)可切换
  • ⚙️ 双工具调用模式 - 支持 Tool Use / XML(依模型能力)
  • 🔍 @ 指令 - @文件 引用、@web 搜索、@base 知识库
  • ✏️ 消息编辑 - 点击历史消息编辑,支持回滚重新对话

💡 提示:使用 AI 功能需要登录账户,按金额(元)计费。

写作 Agent 与审阅 Agent

同一个 AI Agent 支持两种工作阶段:

阶段适合任务典型动作
writing(写作)生成初稿、续写、扩写、改写调查信息 → 生成内容 → 写入文件
review(审阅)校对事实、找逻辑问题、统一风格、直接修订分段阅读 → 核查问题 → 局部修正 → 汇报结果

你可以在同一会话中先写再审,不需要新开对话。

建议:日常流程用“模板创建 → 写作 Agent → 审阅 Agent”三步走,效率和稳定性最高。

基本使用

打开 AI 面板

AI 面板位于界面右侧,是三栏布局的一部分:

  • 左侧:文件树
  • 中间:编辑器
  • 右侧:AI Agent 面板

发送指令

  1. 在 AI 面板底部输入框输入你的需求
  2. 按 Enter 发送
  3. AI 会自动分析并执行任务

阶段与模式切换

  • 阶段切换:可在输入区切换 写作 / 审阅(按消息生效)
  • 工具模式切换:当模型支持 both 时,可切换 Tool Use / XML。Tool Use 即通过 API 的 tool_calls 调用工具;XML 即模型在回复中用 XML 标签描述工具调用,兼容仅支持文本输出的模型。详见 AI Agent 功能 - 工具调用模式
  • 提示:如果当前模型只支持单模式,会显示只读模式标签

什么时候用审阅阶段(review)

建议切到审阅阶段的场景:

  1. 你已经有草稿,需要事实核验或纠错
  2. 文稿前后风格不统一,想统一语气和术语
  3. 需要检查结构和逻辑链条是否完整
  4. 准备发布前做质量把关

一句话记忆:写作阶段负责“产出”,审阅阶段负责“把关和修订”。

常用指令示例

创建大纲:

帮我创建一个关于机器学习的教程大纲

撰写内容:

帮我写第一章的内容

续写:

继续写这一章,写 2000 字

优化内容:

优化第一章的内容,让它更生动

搜索:

搜索所有提到"主角"的文件

工具调用确认

默认只有删除操作会请求确认。写入操作会进入 Diff 队列,支持审阅后回退。

确认流程

  1. AI 显示待执行的操作和 Diff 预览(删除前会进入确认)
  2. 你可以查看变更内容
  3. 选择操作:
    • 执行 - 确认执行
    • 跳过 - 跳过此操作
    • 取消 - 取消整个任务

Diff 预览

  • 🟢 绿色 - 新增内容
  • 🔴 红色 - 删除内容
  • 灰色 - 未变更内容

审阅 Agent 详细使用

审阅标准(建议检查清单)

审阅阶段建议按以下顺序检查:

  1. 事实准确性:时间、数字、人物关系、引用是否正确
  2. 逻辑连贯性:结论是否由前文支撑,是否自相矛盾
  3. 结构完整性:开头-主体-结尾是否完整,段落分工是否清楚
  4. 表达质量:句子是否啰嗦、重复、含混
  5. AI 腔调控制:是否出现空泛套话和模板化表达
  6. 风格一致性:是否符合 @system 中的风格设定
  7. 格式规范:标题层级、列表、标点、术语格式是否统一

长文审阅推荐流程

对章节、长报告、长技术文,建议按“分段审阅”执行:

  1. 先让 AI 读取目标文件并拆分审阅范围
  2. 每次只审一段,先找问题,再给出修订
  3. 优先局部改动(edit_file),避免全篇重写
  4. 全部段落完成后做一次全局复扫(术语、风格、前后呼应)
  5. 最后让 AI 输出“问题清单 + 已修改内容 + 剩余风险”

审阅指令示例

事实核验并修订:

text
请切到审阅模式,检查《第一章.md》的事实错误和逻辑冲突,直接修正并汇总修改点。

风格统一:

text
请用审阅模式统一《第二章.md》语气,保持冷静克制风格,减少空泛形容词,并直接修改文件。

发布前终审:

text
请审阅《产品方案.md》,按“事实-逻辑-结构-表达-格式”给出问题清单;可直接修正中高优先级问题,再输出剩余风险。

@system 项目设定

什么是 @system

@system 是特殊的系统文件夹,用于存放项目设定。AI 会自动读取这些设定,生成更符合预期的内容。

配置示例

小说项目:

@system/
├── 写作风格.md     # 叙事风格、语言特色
├── 人物设定.md     # 角色信息
├── 世界观.md       # 背景设定
└── 审阅标准.md     # 检查清单

技术文档:

@system/
├── 文档规范.md     # 写作规范
├── 术语表.md       # 专业术语
└── 代码风格.md     # 代码示例规范

使用技巧

  1. 先配置 @system - 好的设定能让 AI 生成更符合预期的内容
  2. 明确写作风格 - 在设定中描述期望的风格
  3. 提供示例 - 可以在设定中包含示例内容

@ 指令系统

在对话中使用 @ 指令增强 AI 能力:

指令说明示例
@文件引用文件内容作为上下文@人物设定 帮我写主角的场景
@web启用网络搜索,AI 自动搜索@web 帮我写关于2026春节的描写
@base启用知识库搜索,查找项目内容@base 这个角色的性格是什么样的

消息编辑与回滚

对后续回答不满意?可以编辑历史消息重新对话:

  1. 点击消息 - 直接点击历史消息进入编辑
  2. 修改内容 - 修改后点击发送
  3. 确认回滚 - 系统提示删除后续消息
  4. 重新生成 - AI 根据新消息重新回复

可用工具

AI Agent 拥有 11 个工具:

类别工具说明需确认
浏览list_folder列出文件夹内容
浏览get_system_context获取 @system 设定
读取read_file读取文件内容
读取grep搜索关键词
写入write_file创建或覆盖文件❌(Diff 审阅可回退)
写入edit_file编辑文件❌(Diff 审阅可回退)
文件夹create_folder创建文件夹
文件夹delete_item删除文件/文件夹
搜索web_search网络搜索
搜索rag_searchRAG 语义搜索知识库
记忆update_notes更新对话便条

计费说明

金额计费

AI Agent 功能按实际 Token 消耗折算金额(元)扣费:

  • 新用户注册赠送一定余额
  • 按实际使用量扣费
  • 余额不足时会提示充值

查看余额与消费

在「设置 → 账户」查看当前余额与消费记录。详见 计费与套餐说明

最佳实践

1. 配置好 @system

好的项目设定能让 AI 生成更符合预期的内容。

2. 提供清晰指令

✅ 好的指令:
"帮我写第一章的内容,要求 2000 字左右,使用第一人称叙述"

❌ 模糊的指令:
"写点东西"

3. 分步完成大任务

对于长文档,建议分多次生成:

  1. 先创建大纲结构
  2. 逐章撰写内容
  3. 审阅和优化

4. 善用 Diff 预览

在确认执行前,仔细查看 Diff 预览,确保变更符合预期。

5. 先写后审,质量更稳

推荐流程:

  1. writing 先快速产出可用初稿
  2. 再切到 review 做事实核查和结构优化
  3. 对关键内容可再做一轮终审

常见问题

Q: AI 功能需要网络吗?

A: 是的,AI 功能需要网络连接。但编辑、保存等功能可以离线使用。

Q: AI 会存储我的文档吗?

A: 不会。我们只在使用 AI 时临时处理文本,不会永久存储。

Q: 如何取消正在执行的任务?

A: 点击 AI 面板中的"取消"按钮即可停止当前任务。

Q: 网页版和桌面版 AI 功能有区别吗?

A: 功能完全一致,都支持完整的 AI Agent 功能。

Q: 审阅 Agent 会不会重写太多内容?

A: 审阅阶段默认优先局部修订。你也可以在指令里明确要求“只做必要修改,不改写整体风格”。

Q: 审阅阶段会自动联网查证吗?

A: 当你使用 @web 或指令中明确要求“核验最新事实”时,AI 会调用网络搜索工具进行核查。

相关资源


💡 提示:AI Agent 是强大的写作助手。配置好 @system 设定,提供清晰的指令,能获得最佳效果!