AI Agent 智能助手
学习如何使用 All Writer 的 AI Agent 功能，提升写作效率。本文覆盖面板位置、阶段切换、工具与 **@system** 协作；更细的功能说明见 AI Agent 功能。
AI Agent 概览
All Writer 提供统一的 AI Agent 写作助手，位于界面右侧面板。
和普通聊天框不同，AI Agent 不是只回答一句话。它会在你授权的范围内理解项目结构、读取 @system 设定、检索文件和资料、生成修改方案，并把写入类改动交给你做 Diff 审阅。更推荐把它当作「会使用工具的写作搭档」：你给目标、范围和标准，它负责分解任务、调用工具、产出可审阅结果。
快速导航
如果你想按任务直接查看：
- 写作 Agent 指南：聚焦初稿生成、续写、扩写
- 审阅 Agent 指南：聚焦核查、修订、终审
- 模板创建指南：聚焦目录骨架、
@system和提示词模板
核心特性
- 🤖 统一助手 - 一个 Agent 适配所有写作场景
- ⚡ ReAct 模式 - AI 推理 + 工具调用
- 🔧 多类工具 - 浏览、读取、写入、搜索、记忆
- 🧭 只读子代理 - 复杂摸底、资料研究和项目审阅可拆到独立子会话
- 🔀 多阶段工作流 - 规划（planning）/ 写作（writing）/ 审阅（review）可在消息前切换
- ⚙️ 工具调用 - AI 可按任务读取、搜索、写入和整理项目内容
- 🔍 资料检索 -
@文件引用、@web搜索、@base知识库、URL 转 Markdown - 🧩 自定义模型 - 在设置中添加 OpenAI 兼容 Chat 模型，发送前可在模型选择器中切换
- ✏️ 消息编辑 - 点击历史消息编辑，支持回滚重新对话
- 📈 图表辅助 - 适合流程、结构、依赖和时序关系时，AI 可输出 Mermaid 图表
💡 提示：使用 AI 功能需要登录账户，按金额（元）计费。
规划 / 写作 / 审阅 与「设定抽取」
同一个 AI Agent 在对话里可切换阶段（以界面下拉里实际选项为准，常见为 planning / writing / review）：
| 阶段 | 适合任务 | 典型动作 |
|---|---|---|
planning（规划） | 出提纲、章节目录、分步计划 | 先定结构，再让写作/审阅落地到章节 |
writing（写作） | 生成初稿、续写、扩写、改写 | 调查资料 → 生成内容 → 写入文件 |
review（审阅） | 校对事实、逻辑、风格与局部修订 | 分段阅读 → 检索核查 → 局部修正 → 汇报结果 |
设定抽取（从上传的成稿/参考生成 @system 文件）是单独入口的专用任务，见项目创建向导、项目列表或 Agent 面板的「抽取到 @system」等入口；与日常多轮对话里切换 planning / writing / review 不是同一类操作。详见 @system 与 Agent 总览 与 首稿/材料流程。
你可以在同一会话中规划/写作/审阅组合使用，一般不需要新开对话（设定抽取通常会进入专用任务会话，以产品内实际提示为准）。
建议：长文用「规划/写作 → 审阅」；从材料沉淀设定时走「设定抽取」。
基本使用
打开 AI 面板
AI 面板位于界面右侧，是三栏布局的一部分：
- 左侧：文件树
- 中间：编辑器
- 右侧：AI Agent 面板
发送指令
- 在 AI 面板底部输入框输入你的需求
- 按 Enter 发送
- AI 会自动分析并执行任务
阶段切换
- 阶段切换：可在输入区在
规划/写作/审阅之间选择（以界面为准，按消息生效） - 模型切换：模型选择器会把官方模型和自定义供应商模型分组展示。自定义模型需要先在「设置 → AI 功能」中添加并拨测通过。
- 工具调用：AI 会按任务需要读取文件、检索资料、写入修改或更新记忆。详见 AI Agent 功能 - 工具调用。
什么时候用审阅阶段（review）
建议切到审阅阶段的场景：
- 你已经有草稿，需要事实核验或纠错
- 文稿前后风格不统一，想统一语气和术语
- 需要检查结构和逻辑链条是否完整
- 准备发布前做质量把关
一句话记忆：规划阶段负责“定结构”，写作阶段负责“产出”，审阅阶段负责“把关和修订”。
常用指令示例
创建大纲：
帮我创建一个关于机器学习的教程大纲撰写内容：
帮我写第一章的内容续写：
继续写这一章，写 2000 字优化内容：
优化第一章的内容，让它更生动搜索：
搜索所有提到"主角"的文件教会 Agent 做好事
一条好指令包含什么
如果只写「帮我优化一下」，Agent 需要猜测目标和边界。更稳的写法是把任务拆成 5 个要素：
| 要素 | 说明 | 示例 |
|---|---|---|
| 目标 | 这次要完成什么 | 生成第一节、审阅第三章、重排目录 |
| 范围 | 处理哪些文件或章节 | 当前文件、@第一章.md、@base 搜索到的材料 |
| 标准 | 按什么判断好坏 | 保持 @system 风格、术语统一、不要剧透 |
| 动作 | 只给建议还是直接修改 | 先列问题、直接写入、只改中高优先级问题 |
| 输出 | 最后希望看到什么 | Diff、修改摘要、风险清单、下一步建议 |
可以直接套用这个模板：
请用【阶段】处理【范围】。
目标：
- ...
参考：
- 读取 @system
- 需要时使用 @base / @web / URL 资料
要求：
1. ...
2. ...
3. ...
执行方式：
- 先简要说明计划；
- 需要改文件时直接修改，但只改必要内容；
- 结束后输出：修改摘要、未解决问题、下一步建议。按任务选择阶段
不要所有需求都用同一种说法。阶段选对，Agent 的工具使用和回答重点会更贴近任务。
| 你想做的事 | 建议阶段 | 推荐说法 |
|---|---|---|
| 还没有结构 | planning | “先基于 @system 设计 3 层目录，不写正文。” |
| 需要初稿 | writing | “扩写当前文件到约 1200 字，保持第三人称限制视角。” |
| 需要继续写 | writing | “从当前结尾续写，不重复前文，结尾留下新冲突。” |
| 需要改稿 | review | “只修正逻辑断裂和重复表达，不重写整体风格。” |
| 准备发布 | review | “按事实、逻辑、结构、表达、格式做终审，并列剩余风险。” |
让 Agent 正确使用上下文
Agent 能读上下文，但你仍然要告诉它「优先看哪里」。
@system：项目设定、风格、术语、审阅标准。写作前先补好它。@文件：明确引用目标文件，适合让 Agent 按指定内容续写、改写或审阅。@base：让 Agent 在项目知识库里找相关片段，适合长项目里查设定、伏笔、术语。@web：需要最新信息或外部资料时使用。- URL：直接贴网页链接，Agent 可把正文转成 Markdown 后总结或沉淀为资料。
示例：
请用写作阶段处理 @第二章-进入实验室.md。
参考 @system 的人物设定和写作风格；如果不确定前文伏笔，请用 @base 搜索“蓝色门禁卡”和“周宁”。
目标：
- 续写约 1000 字；
- 让主角发现新的矛盾证据；
- 不揭示幕后人物身份。
执行方式：
- 直接写入当前文件；
- 结束后说明新增伏笔和需要后续回收的点。把大任务拆给 Agent
长文项目里，最稳定的节奏是「规划 → 写作 → 审阅 → 固化设定」：
planning：让 Agent 先给目录、章节目标和资料缺口，不急着写正文。writing：每次只写一个文件或一个小节，要求明确字数、视角和结尾效果。review：让 Agent 只处理事实、逻辑、节奏、术语或风格中的 1-2 类问题。@system：把反复出现的规则沉淀进@system，减少后续重复提示。
写入前后的控制权
Agent 可以调用 write_file / edit_file 修改文件，但写入类结果会进入 Diff 审阅队列。建议养成这个流程：
- 让 Agent 明确「会改哪些文件」。
- 先看 Diff，不要只看回答摘要。
- 小改动可直接接受；大改动可以拒绝后要求「只改第 2、4 段」。
- 接受后再让 Agent 做一轮审阅，避免新增内容和旧设定冲突。
让子代理先调查
当任务范围不清、涉及多个目录，或你希望先得到证据路径再动笔时，可以让 Agent 先使用子代理：
explore_project：先摸清目录、关键文件和上下文，再把摘要回传主对话。review_project：只读审阅项目内容，输出问题清单、证据路径和缺口。research_context：收集项目内外部资料，适合带来源的背景研究。
子代理结果会以工具卡片展示执行统计、外层迭代和“打开子代理会话”入口；如果生成参考报告，会保存到 @system/@subagent/。这些报告是参考资料，不会自动覆盖你的 @system 设定。
更好用的提示词示例
从零规划长文：
请切到规划阶段，基于 @system 为这篇长篇技术文章设计目录。
要求：
1. 目录最多 3 层；
2. 每章写清目标读者、核心问题、需要的图表；
3. 不写正文，先输出结构和写作顺序。把资料变成设定：
请读取这个网页并整理成项目资料：https://example.com/article
输出要求：
1. 先总结 5 个可用于正文的事实；
2. 再建议应该写入 @system 的术语或背景设定；
3. 不直接改文件，等我确认后再写入。生成带图表的技术段落：
请用写作阶段扩写 @系统架构.md 的“任务调度”小节。
要求：
1. 解释队列、Worker、Diff 审阅之间的关系；
2. 加一个 Mermaid sequenceDiagram；
3. 如果涉及成本估算，用 LaTeX 公式表达；
4. 直接写入文件，结束后说明新增图表的含义。严格审阅一章：
请用审阅阶段检查 @第三章.md。
只处理：
1. 人物动机前后矛盾；
2. 重复信息；
3. 不符合 @system 风格的句子。
执行方式：
- 中高优先级问题直接修改；
- 低优先级只列建议；
- 最后输出“已修改 / 未修改 / 需要我决定”的清单。工具调用与 Diff 审阅
默认只有删除操作会请求执行确认。写入和编辑会进入 Diff 审阅队列，你可以接受保留，也可以拒绝并回退。
删除确认
- AI 显示待删除的文件或文件夹
- 你可以查看目标是否正确
- 选择操作：
- 执行 - 确认删除
- 跳过 - 跳过此操作
- 取消 - 取消整个任务
Diff 预览
- 🟢 绿色 - 新增内容
- 🔴 红色 - 删除内容
- ⚪ 灰色 - 未变更内容
审阅 Agent 详细使用
审阅标准（建议检查清单）
审阅阶段建议按以下顺序检查：
- 事实准确性：时间、数字、人物关系、引用是否正确
- 逻辑连贯性：结论是否由前文支撑，是否自相矛盾
- 结构完整性：开头-主体-结尾是否完整，段落分工是否清楚
- 表达质量：句子是否啰嗦、重复、含混
- AI 腔调控制：是否出现空泛套话和模板化表达
- 风格一致性：是否符合
@system中的风格设定 - 格式规范：标题层级、列表、标点、术语格式是否统一
长文审阅推荐流程
对章节、长报告、长技术文，建议按“分段审阅”执行：
- 先让 AI 读取目标文件并拆分审阅范围
- 每次只审一段，先找问题，再给出修订
- 优先局部改动（
edit_file），避免全篇重写 - 全部段落完成后做一次全局复扫（术语、风格、前后呼应）
- 最后让 AI 输出“问题清单 + 已修改内容 + 剩余风险”
审阅指令示例
事实核验并修订：
请切到审阅模式，检查《第一章.md》的事实错误和逻辑冲突，直接修正并汇总修改点。风格统一：
请用审阅模式统一《第二章.md》语气，保持冷静克制风格，减少空泛形容词，并直接修改文件。发布前终审：
请审阅《产品方案.md》，按“事实-逻辑-结构-表达-格式”给出问题清单；可直接修正中高优先级问题，再输出剩余风险。@system 项目设定
什么是 @system
@system 是特殊的系统文件夹，用于存放项目设定。AI 会自动读取这些设定，生成更符合预期的内容。
配置示例
小说项目：
@system/
├── 写作风格.md # 叙事风格、语言特色
├── 人物设定.md # 角色信息
├── 世界观.md # 背景设定
└── 审阅标准.md # 检查清单技术文档：
@system/
├── 文档规范.md # 写作规范
├── 术语表.md # 专业术语
└── 代码风格.md # 代码示例规范使用技巧
- 先配置 @system - 好的设定能让 AI 生成更符合预期的内容
- 明确写作风格 - 在设定中描述期望的风格
- 提供示例 - 可以在设定中包含示例内容
@ 指令系统
在对话中使用 @ 指令和链接增强 AI 能力：
| 指令 | 说明 | 示例 |
|---|---|---|
@文件 | 引用文件内容作为上下文 | @人物设定 帮我写主角的场景 |
@web | 启用网络搜索，AI 自动搜索 | @web 帮我写关于2026春节的描写 |
@base | 启用知识库搜索，查找项目内容 | @base 这个角色的性格是什么样的 |
| URL 链接 | 读取网页正文并转为 Markdown | 总结这个网页适合放入背景资料的要点：https://... |
URL 转 Markdown 适合把资料页、新闻、博客、产品文档等网页正文变成可引用上下文。需要长期保留时，可以继续让 AI 写入项目文件或 @system。
消息编辑与回滚
对后续回答不满意？可以编辑历史消息重新对话：
- 点击消息 - 直接点击历史消息进入编辑
- 修改内容 - 修改后点击发送
- 确认回滚 - 系统提示删除后续消息
- 重新生成 - AI 根据新消息重新回复
自定义 Chat 模型
如果你已经有兼容 OpenAI API 的模型服务，可以在设置中添加自己的 Chat 模型：
- 打开「设置 → AI 功能 → 自定义 Chat 模型」
- 填写模型名称、Base URL、API Key 和模型 ID
- 点击拨测，确认 Base URL、Key 和模型流式响应可用
- 回到 Agent 输入区，在模型选择器里选择该模型
拨测失败时，设置页会展示脱敏请求与响应摘要。优先检查 Base URL 是否到 /v1、API Key 是否有效、模型 ID 是否支持 Chat Completions 和流式输出。
长对话稳定性
Agent 面板会使用服务端返回的稳定时间线序号排序消息。刷新、加载更多历史、编辑回滚或流式输出时，消息顺序不再依赖本地时间戳；如果你看到标题仍是临时标题，前端会在首轮回答完成后短暂重试拉取真实标题。
可用工具
AI Agent 拥有多类工具。常见工具示例：
| 类别 | 工具 | 说明 | 需确认 |
|---|---|---|---|
| 浏览 | list_folder | 列出文件夹内容 | ❌ |
| 浏览 | get_system_context | 获取 @system 设定 | ❌ |
| 读取 | read_file | 读取文件内容 | ❌ |
| 读取 | grep | 搜索关键词 | ❌ |
| 写入 | write_file | 创建或覆盖文件 | ❌（Diff 审阅可回退） |
| 写入 | edit_file | 编辑文件 | ❌（Diff 审阅可回退） |
| 文件夹 | create_folder | 创建文件夹 | ❌ |
| 文件夹 | delete_item | 删除文件/文件夹 | ✅ |
| 搜索 | web_search | 网络搜索 | ❌ |
| 搜索 | rag_search | RAG 语义搜索知识库 | ❌ |
| 搜索 | url_to_markdown | 获取网页正文 Markdown | ❌ |
| 子代理 | explore_project | 只读探索项目结构和上下文 | ❌ |
| 子代理 | review_project | 只读审阅并输出证据路径 | ❌ |
| 子代理 | research_context | 资料研究并标注来源 | ❌ |
| 记忆 | remember | 写入用户长期记忆 | ❌ |
finish_agent 是内部静默收口工具，只负责结束本轮任务，不会作为用户工具显示。
长文和图表体验
- 长消息采用 Markdown 分段缓存与流式节流，减少长对话滚动和更新时的卡顿。
- Mermaid 图表会延迟到进入视口后渲染，适合在长文中展示流程图、时序图、结构图。
- 工具调用展示有局部错误边界，单个工具结果渲染失败时不会影响整个 AI 面板。
计费说明
金额计费
AI Agent 功能按实际 Token 消耗折算金额（元）扣费：
- 新用户注册赠送一定余额
- 按实际使用量扣费
@web网络搜索和 URL 转 Markdown 均按 0.01 元/次计费- 余额不足时会提示充值
查看余额与消费
在「设置 → 账户」查看当前余额与消费记录。详见 计费与套餐说明。
最佳实践
1. 配置好 @system
好的项目设定能让 AI 生成更符合预期的内容。
2. 提供清晰指令
✅ 好的指令：
"帮我写第一章的内容，要求 2000 字左右，使用第一人称叙述"
❌ 模糊的指令：
"写点东西"3. 分步完成大任务
对于长文档，建议分多次生成：
- 先创建大纲结构
- 逐章撰写内容
- 审阅和优化
4. 善用 Diff 预览
在接受改动前，仔细查看 Diff 预览，确保变更符合预期。
5. 先规划再写审，质量更稳
推荐流程：
- 用
planning先确定结构、任务边界和验收标准 - 用
writing快速产出可用初稿 - 再切到
review做事实核查和结构优化 - 对关键内容可再做一轮终审
常见问题
Q: AI 功能需要网络吗？
A: 是的，AI 功能需要网络连接。但编辑、保存等功能可以离线使用。
Q: AI 会存储我的文档吗？
A: AI 只在你主动发起请求时处理相关文本。为完成一次生成，必要的上下文会经 All Writer 转发到已配置的模型网关或上游模型。对话、任务状态和服务运行所需的元数据/日志会按产品需要保留。AI 写入和编辑会进入 Diff 审阅队列，你可以接受保留，也可以拒绝并回退。上游服务商如何处理内容，以对应服务条款为准。更完整的用户向说明见 常见问题 与 English FAQ。
Q: 如何取消正在执行的任务？
A: 点击 AI 面板中的"取消"按钮即可停止当前任务。
Q: 网页版和桌面版 AI 功能有区别吗？
A: 核心 AI Agent 能力一致。网页版依赖云端项目与账号同步；桌面版的本地项目不会后台暗传云端，使用 AI 前可先上传为云端项目。
Q: 审阅 Agent 会不会重写太多内容？
A: 审阅阶段默认优先局部修订。你也可以在指令里明确要求“只做必要修改，不改写整体风格”。
Q: 审阅阶段会自动联网查证吗？
A: 当你使用 @web 或指令中明确要求“核验最新事实”时，AI 会调用网络搜索工具进行核查。
相关资源
💡 提示：AI Agent 是强大的写作助手。配置好 @system 设定，提供清晰的指令，能获得最佳效果！