主题
AI Agent 智能助手
学习如何使用 All Writer 的 AI Agent 功能,提升写作效率。
AI Agent 概览
All Writer 提供统一的 AI Agent 写作助手,位于界面右侧面板。
快速导航
如果你想按任务直接查看:
- 写作 Agent 指南:聚焦初稿生成、续写、扩写
- 审阅 Agent 指南:聚焦核查、修订、终审
- 模板创建指南:聚焦目录骨架、
@system和提示词模板
核心特性
- 🤖 统一助手 - 一个 Agent 适配所有写作场景
- ⚡ ReAct 模式 - AI 推理 + 工具调用
- 🔧 11 个工具 - 浏览、读取、写入、搜索、记忆
- 🔀 双阶段工作流 - 写作(writing)/ 审阅(review)可切换
- ⚙️ 双工具调用模式 - 支持 Tool Use / XML(依模型能力)
- 🔍 @ 指令 -
@文件引用、@web搜索、@base知识库 - ✏️ 消息编辑 - 点击历史消息编辑,支持回滚重新对话
💡 提示:使用 AI 功能需要登录账户,按金额(元)计费。
写作 Agent 与审阅 Agent
同一个 AI Agent 支持两种工作阶段:
| 阶段 | 适合任务 | 典型动作 |
|---|---|---|
writing(写作) | 生成初稿、续写、扩写、改写 | 调查信息 → 生成内容 → 写入文件 |
review(审阅) | 校对事实、找逻辑问题、统一风格、直接修订 | 分段阅读 → 核查问题 → 局部修正 → 汇报结果 |
你可以在同一会话中先写再审,不需要新开对话。
建议:日常流程用“模板创建 → 写作 Agent → 审阅 Agent”三步走,效率和稳定性最高。
基本使用
打开 AI 面板
AI 面板位于界面右侧,是三栏布局的一部分:
- 左侧:文件树
- 中间:编辑器
- 右侧:AI Agent 面板
发送指令
- 在 AI 面板底部输入框输入你的需求
- 按 Enter 发送
- AI 会自动分析并执行任务
阶段与模式切换
- 阶段切换:可在输入区切换
写作/审阅(按消息生效) - 工具模式切换:当模型支持
both时,可切换Tool Use/XML。Tool Use 即通过 API 的tool_calls调用工具;XML 即模型在回复中用 XML 标签描述工具调用,兼容仅支持文本输出的模型。详见 AI Agent 功能 - 工具调用模式。 - 提示:如果当前模型只支持单模式,会显示只读模式标签
什么时候用审阅阶段(review)
建议切到审阅阶段的场景:
- 你已经有草稿,需要事实核验或纠错
- 文稿前后风格不统一,想统一语气和术语
- 需要检查结构和逻辑链条是否完整
- 准备发布前做质量把关
一句话记忆:写作阶段负责“产出”,审阅阶段负责“把关和修订”。
常用指令示例
创建大纲:
帮我创建一个关于机器学习的教程大纲撰写内容:
帮我写第一章的内容续写:
继续写这一章,写 2000 字优化内容:
优化第一章的内容,让它更生动搜索:
搜索所有提到"主角"的文件工具调用确认
默认只有删除操作会请求确认。写入操作会进入 Diff 队列,支持审阅后回退。
确认流程
- AI 显示待执行的操作和 Diff 预览(删除前会进入确认)
- 你可以查看变更内容
- 选择操作:
- 执行 - 确认执行
- 跳过 - 跳过此操作
- 取消 - 取消整个任务
Diff 预览
- 🟢 绿色 - 新增内容
- 🔴 红色 - 删除内容
- ⚪ 灰色 - 未变更内容
审阅 Agent 详细使用
审阅标准(建议检查清单)
审阅阶段建议按以下顺序检查:
- 事实准确性:时间、数字、人物关系、引用是否正确
- 逻辑连贯性:结论是否由前文支撑,是否自相矛盾
- 结构完整性:开头-主体-结尾是否完整,段落分工是否清楚
- 表达质量:句子是否啰嗦、重复、含混
- AI 腔调控制:是否出现空泛套话和模板化表达
- 风格一致性:是否符合
@system中的风格设定 - 格式规范:标题层级、列表、标点、术语格式是否统一
长文审阅推荐流程
对章节、长报告、长技术文,建议按“分段审阅”执行:
- 先让 AI 读取目标文件并拆分审阅范围
- 每次只审一段,先找问题,再给出修订
- 优先局部改动(
edit_file),避免全篇重写 - 全部段落完成后做一次全局复扫(术语、风格、前后呼应)
- 最后让 AI 输出“问题清单 + 已修改内容 + 剩余风险”
审阅指令示例
事实核验并修订:
text
请切到审阅模式,检查《第一章.md》的事实错误和逻辑冲突,直接修正并汇总修改点。风格统一:
text
请用审阅模式统一《第二章.md》语气,保持冷静克制风格,减少空泛形容词,并直接修改文件。发布前终审:
text
请审阅《产品方案.md》,按“事实-逻辑-结构-表达-格式”给出问题清单;可直接修正中高优先级问题,再输出剩余风险。@system 项目设定
什么是 @system
@system 是特殊的系统文件夹,用于存放项目设定。AI 会自动读取这些设定,生成更符合预期的内容。
配置示例
小说项目:
@system/
├── 写作风格.md # 叙事风格、语言特色
├── 人物设定.md # 角色信息
├── 世界观.md # 背景设定
└── 审阅标准.md # 检查清单技术文档:
@system/
├── 文档规范.md # 写作规范
├── 术语表.md # 专业术语
└── 代码风格.md # 代码示例规范使用技巧
- 先配置 @system - 好的设定能让 AI 生成更符合预期的内容
- 明确写作风格 - 在设定中描述期望的风格
- 提供示例 - 可以在设定中包含示例内容
@ 指令系统
在对话中使用 @ 指令增强 AI 能力:
| 指令 | 说明 | 示例 |
|---|---|---|
@文件 | 引用文件内容作为上下文 | @人物设定 帮我写主角的场景 |
@web | 启用网络搜索,AI 自动搜索 | @web 帮我写关于2026春节的描写 |
@base | 启用知识库搜索,查找项目内容 | @base 这个角色的性格是什么样的 |
消息编辑与回滚
对后续回答不满意?可以编辑历史消息重新对话:
- 点击消息 - 直接点击历史消息进入编辑
- 修改内容 - 修改后点击发送
- 确认回滚 - 系统提示删除后续消息
- 重新生成 - 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_search | RAG 语义搜索知识库 | ❌ |
| 记忆 | update_notes | 更新对话便条 | ❌ |
计费说明
金额计费
AI Agent 功能按实际 Token 消耗折算金额(元)扣费:
- 新用户注册赠送一定余额
- 按实际使用量扣费
- 余额不足时会提示充值
查看余额与消费
在「设置 → 账户」查看当前余额与消费记录。详见 计费与套餐说明。
最佳实践
1. 配置好 @system
好的项目设定能让 AI 生成更符合预期的内容。
2. 提供清晰指令
✅ 好的指令:
"帮我写第一章的内容,要求 2000 字左右,使用第一人称叙述"
❌ 模糊的指令:
"写点东西"3. 分步完成大任务
对于长文档,建议分多次生成:
- 先创建大纲结构
- 逐章撰写内容
- 审阅和优化
4. 善用 Diff 预览
在确认执行前,仔细查看 Diff 预览,确保变更符合预期。
5. 先写后审,质量更稳
推荐流程:
- 用
writing先快速产出可用初稿 - 再切到
review做事实核查和结构优化 - 对关键内容可再做一轮终审
常见问题
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 设定,提供清晰的指令,能获得最佳效果!