AI Agent 智能助手
All Writer 提供统一的 AI Agent 写作助手,通过 ReAct(推理 + 行动)模式,理解项目结构、遵循项目设定,协助用户系统化地完成各类写作任务。适用于博客、邮件、技术教程、报告、小说与论文等长文场景。
💡 近期新特性:用户长期记忆(
remember)、自定义 Chat 模型、模型拨测诊断、只读子代理、子代理参考报告、增强搜索工具、URL 转 Markdown、Mermaid 图表回答和长文渲染优化,让 AI 更懂你的项目,也让长对话更稳定。
功能概览
统一的 AI 写作助手
一个 Agent 适配所有写作场景:
- 📝 博客文章:生成、续写、优化博客内容
- 📧 邮件文案:撰写专业邮件和商务文案
- 📚 技术教程:编写技术文档和教程
- 📊 工作报告:生成报告和分析总结
- ✍️ 创意写作:小说、剧本、故事创作
- 📖 学术论文:论文撰写和格式规范
核心特性
ReAct 模式
AI 采用推理(Reasoning)+ 行动(Acting)的工作模式:
- 理解意图:分析用户指令,理解任务目标
- 规划步骤:制定执行计划
- 调用工具:执行具体操作(浏览、读取、写入等)
- 反馈结果:根据结果调整策略
时间感知
AI 能感知当前时间,在进行网络搜索时会自动获取最新内容。例如:
用户:帮我搜索一下最近的 AI 新闻
AI:(知道当前是 2026年1月,会搜索最新的 2026年 AI 新闻)删除确认与 Diff 审阅
高危操作需要用户确认,安全可控:
- 需要确认:删除文件/文件夹(
delete_item) - 无需高危确认:浏览目录、读取文件、搜索、记忆更新等
- 写入/编辑保障:变更进入 Diff 队列,支持审阅与回退
规划 / 写作 / 审阅(三阶段协作)
AI Agent 支持三种日常阶段协作完成任务:
- 规划阶段(planning):先梳理目标、结构、资料缺口和执行步骤
- 写作阶段(writing):偏生产,快速产出内容
- 审阅阶段(review):偏质量,核查并修正文稿
推荐使用方式是“先规划、再写作、最后审阅”:
planning先确定大纲、章节目标和任务边界writing生成初稿或完成扩写review核查事实、逻辑和风格- 在 Diff 中接受需要保留的修改并完成终稿
流式响应
实时查看 AI 的思考过程和生成内容:
- 思考内容实时显示
- 生成内容流式输出
- 工具调用状态实时更新
- 会话内部使用稳定时间线序号对齐消息、思考块和工具结果,刷新或长对话加载时不依赖时间戳排序
三阶段工作流(规划 / 写作 / 审阅)
AI Agent 支持按消息切换工作阶段:
planning:澄清目标 → 设计结构 → 拆解任务writing:调查 → 创作 → 保存review:阅读 → 核查 → 修改 → 汇报
三个阶段复用同一会话历史,适合“先规划、再写作与审阅”的连续流程。设定抽取和 AI 文档导入由创建向导、项目列表或 Agent 面板入口触发,不是日常输入区里的阶段选项。
审阅阶段的七项检查维度
审阅阶段常用检查项:
- 事实准确性(人名、时间、数据、引用)
- 逻辑连贯性(论证链条、因果关系)
- 结构完整性(章节组织、段落分工)
- 表达质量(是否冗余、是否清晰)
- AI 腔调检测(空话套话、模板化语言)
- 风格一致性(与
@system设定一致) - 格式规范(标题、术语、标点、清单)
工具调用
- 结构化工具调用:AI 会把“读取文件、搜索资料、写入修改”等动作作为明确步骤执行,而不是把操作混在普通回复里;这样更便于展示进度、审阅结果和处理失败。
- 局部错误边界:单个工具调用展示异常时,会降级显示原始信息,不会拖垮整个 AI 面板。
- 子代理卡片:当任务需要先摸清结构、审阅多文件或收集资料时,Agent 可以调用只读子代理;卡片会展示执行统计、外层迭代、子会话入口和参考报告路径。
只读子代理与参考报告
子代理是在独立只读子会话中运行的小型 Agent,用于把“先调查清楚”这类任务从主对话中拆出来,避免长目录、搜索结果或多文件摘要挤占主对话上下文。
| 子代理工具 | 适合任务 | 可用能力 | 写入行为 |
|---|---|---|---|
explore_project | 多目录摸底、梳理项目结构、先读再写前的上下文压缩 | 列目录、读文件、grep、RAG、网络搜索等只读探索 | 不直接改正文;可保存参考报告 |
review_project | 只读审阅项目内容,输出问题清单、证据路径和信息缺口 | 列目录、读取、grep、RAG | 不写入、不删除、不联网、不记忆 |
research_context | 收集项目内外部资料,形成带来源摘要 | 网络搜索、URL 转 Markdown、RAG、读文件 | 不写入、不删除、不记忆 |
子代理完成后,主对话会收到摘要;工具卡片可打开对应子会话查看完整步骤。若本次运行生成参考报告,会保存到 @system/@subagent/,文件名包含日期和任务标题,例如 @system/@subagent/2026-05-22-检查第一章人物动机.md。这些报告只是参考材料,不会自动覆盖项目设定或用户即时指令。
自定义 Chat 模型
在「设置 → AI 功能」中可以添加 OpenAI 兼容的自定义 Chat 模型:
- 按供应商分组:模型选择器会先显示官方模型,再按自定义供应商分组展示个人模型。
- 保存前拨测:可验证 Base URL、API Key、
/models响应和指定模型的流式 Chat Completions 能力。 - 脱敏诊断:拨测失败时显示请求方法、URL、脱敏
curl、HTTP 状态和响应预览,方便定位 Base URL 写错、权限不足或模型不支持流式输出。 - 模型运行参数:可为自定义 Chat 模型配置展示名、启用状态、温度、最大输出和思考模型标记。
自定义模型适合已有个人或团队模型 Key 的用户。模型请求会走你配置的上游供应商;涉及
@web或 URL 转 Markdown 时均按 0.01 元/次计费,涉及@base、AI Word 等平台能力时仍按对应能力的实际消耗计费。
会话与排序稳定性
长对话里,消息、思考内容、工具调用和最终回答不再只依赖创建时间排序。服务端为每条消息维护稳定的 message_sequence 和 timeline_sequence,前端恢复、分页和流式续写时以时间线序号对齐,减少以下问题:
- 刷新后流式回复接到上一轮气泡。
- 工具结果和最终回答顺序偶发错位。
- 编辑历史消息后重新发送,旧分支与新分支显示混在一起。
@system 项目设定
什么是 @system 文件夹
@system 是一个特殊的系统文件夹,用于存放项目的元数据和配置,让 AI 更好地理解你的项目:
我的项目/
├── @system/ # 系统文件夹(项目设定)
│ ├── 写作风格.md # 写作风格指南
│ ├── 人物设定.md # 角色信息(小说类)
│ ├── 世界观.md # 世界观设定(小说类)
│ └── 格式要求.md # 格式规范
├── 第一卷/ # 普通文件夹(卷/章节)
│ ├── 第一章.md # 内容文件
│ └── 第二章.md
└── 第二卷/
└── ...配置示例
小说项目:
@system/写作风格.md- 定义叙事风格、语言特色@system/人物设定.md- 角色信息、性格特点@system/世界观.md- 背景设定、时代背景@system/审阅标准.md- 检查清单
论文项目:
@system/写作规范.md- 学术写作要求@system/引用格式.md- 引用规范(APA、MLA 等)@system/审阅清单.md- 检查项
技术文档:
@system/文档规范.md- 技术写作规范@system/术语表.md- 专业术语定义@system/代码风格.md- 代码示例规范
@ 指令系统 (v0.5.x 新功能)
文件引用 (@文件名)
在对话中使用 @文件名 可以将文件内容作为上下文:
@人物设定 帮我写主角参加比赛的场景- 输入
@后弹出文件选择器 - 支持多文件引用:
@人物设定 @世界观 - 引用后文件内容会注入到 AI 上下文
网络搜索 (@web)
启用网络搜索能力,AI 自行决定搜索什么:
@web 帮我写一段关于2026年春节的描写- AI 会自动搜索相关实时信息(网络搜索)
- 搜索结果会作为上下文提供给 AI
- 支持本地缓存,相同搜索不重复调用
- 计费:网络搜索按 0.01 元/次 计费,缓存命中通常不重复扣费
URL 转 Markdown
当你粘贴网页链接,或让 AI 总结/改写某个网页时,Agent 可以调用 url_to_markdown 获取页面正文并转成 Markdown:
请阅读这个网页,总结对我的论文有用的观点:https://example.com/article- 适合把资料页、新闻、博客、产品文档等网页内容沉淀进项目。
- 返回内容会作为本轮上下文使用;需要长期保留时,可以让 AI 写入项目文件或
@system。 - 计费:URL 转 Markdown 按 0.01 元/次 计费。
知识库搜索 (@base)
启用 RAG 语义搜索,在项目知识库中查找相关内容:
@base 这个角色的性格是什么样的- 基于向量相似度的语义搜索
- 自动在项目文档中找到相关内容
- 支持增量索引,文档保存时自动更新
- 计费:按金额计费,知识库搜索消耗通常较低
消息编辑与回滚 (v0.5.x 新功能)
功能说明
对后续回答不满意?可以编辑历史消息重新对话:
- 点击消息:直接点击历史消息进入编辑模式
- 修改内容:修改后点击发送
- 确认回滚:系统会提示删除后续消息
- 重新生成:AI 根据修改后的消息重新回复
交互流程
消息列表:
├── [用户] 帮我写一段武侠场景 ← 点击进入编辑
├── [AI] 好的,这是一段武侠场景...
├── [用户] 再加点对话
└── [AI] 好的,加入对话后... ← 对这些不满意
↓ 编辑第一条消息后
├── [用户] 帮我写一段仙侠场景,要有飞剑 ← 修改后
└── [AI] 正在生成... ← 重新生成可用工具
AI Agent 拥有多类工具,覆盖浏览、读取、搜索、编辑、项目探索和长期记忆等任务:
浏览类工具
| 工具名 | 说明 | 需要确认 |
|---|---|---|
list_folder | 列出文件夹内容 | ❌ |
get_system_context | 获取 @system 项目设定 | ❌ |
读取类工具
| 工具名 | 说明 | 需要确认 |
|---|---|---|
read_file | 读取文件内容(支持多文件) | ❌ |
grep | 搜索关键词(支持多目录和正则表达式) | ❌ |
搜索类工具
| 工具名 | 说明 | 需要确认 |
|---|---|---|
web_search | 网络搜索 | ❌ |
rag_search | RAG 语义搜索知识库 | ❌ |
url_to_markdown | 获取网页正文并转为 Markdown | ❌ |
子代理工具
| 工具名 | 说明 | 需要确认 |
|---|---|---|
explore_project | 独立只读探索子代理,适合先摸清结构、多文件压缩摘要 | ❌ |
review_project | 独立只读审阅子代理,输出问题、证据路径和缺口 | ❌ |
research_context | 独立资料研究子代理,收集项目内外部资料并标注来源 | ❌ |
写入类工具
| 工具名 | 说明 | 需要确认 |
|---|---|---|
write_file | 创建或覆盖文件 | ❌(Diff 审阅可回退) |
edit_file | 编辑文件(追加/前置/按行替换) | ❌(Diff 审阅可回退) |
文件夹类工具
| 工具名 | 说明 | 需要确认 |
|---|---|---|
create_folder | 创建新文件夹 | ❌ |
delete_item | 删除文件或文件夹 | ✅ |
记忆类工具
| 工具名 | 说明 | 需要确认 |
|---|---|---|
remember | 写入用户维度长期记忆,新会话自动注入上下文 | ❌ |
finish_agent是内部静默收口工具,用于结束本轮任务;它不会作为用户可操作工具显示在工具清单中。
使用方法
界面位置
AI Agent 面板位于界面右侧,是三栏布局的一部分:
- 左侧:文件树
- 中间:编辑器
- 右侧:AI Agent 面板
基本交互
- 在右侧 AI 面板的输入框中输入你的需求
- AI 会自动分析并执行任务
- 写入或编辑时,查看 Diff 预览后决定接受或回退
阶段切换与建议
你可以按消息切换阶段:
- 需要“先规划结构、拆任务”时用
planning - 需要“生成内容”时用
writing - 需要“检查和修订”时用
review - 同一会话中可反复切换,历史上下文共享
system-extraction(设定抽取)和 document-import(AI 文档导入)是由创建向导、项目列表或 Agent 面板入口触发的一次性任务,不是日常输入区里的阶段选项。
对长文建议每完成一个章节就进行一次 review,避免错误累积到最后集中修复。
示例指令
生成大纲:
帮我创建一个关于机器学习的教程大纲撰写内容:
帮我写第一章的内容续写章节:
继续写这一章,写 3000 字优化内容:
优化第一章的内容,让它更生动搜索内容:
搜索所有提到"主角"的文件典型工作流程
AI 倾向于在行动前先了解情况,这让它能写出更符合项目风格的内容。
1. 撰写新章节
用户:帮我写第二章
AI 执行步骤:
1. list_folder() → 看看项目结构
2. get_system_context() → 了解写作风格和人物设定
3. read_file(["第一章.md"]) → 读一下前情
4. write_file(...) → 开始写作(进入 Diff 审阅)2. 修改内容
用户:修改第一章开头
AI 执行步骤:
1. read_file(["第一章.md"]) → 先看当前内容
2. edit_file(...) → 进行修改(进入 Diff 审阅)2.1 审阅并修正内容(review)
用户:请用审阅模式检查第一章,优先修正事实错误和逻辑断裂,保持原风格不变。
AI 执行步骤:
1. read_file(["第一章.md"]) → 读取原文
2. grep(...) / web_search(...) → 定位问题并核查事实
3. edit_file(action="replace_lines", ...) → 局部修正
4. 输出“问题清单 + 已修改项 + 剩余风险”3. 搜索内容
用户:找找哪里提到了张三
AI 执行步骤:
1. grep({ keyword: "张三" }) → 直接搜索4. 网络搜索
用户:@web 帮我写一段关于 2026 年春节的描写
AI 执行步骤:
1. web_search(...) → 搜索 2026 春节相关信息
2. get_system_context() → 了解写作风格
3. write_file(...) → 写入内容(进入 Diff 审阅)5. 网页资料沉淀
用户:请阅读这个 URL,总结适合放进“背景资料.md”的要点:https://example.com/article
AI 执行步骤:
1. url_to_markdown(...) → 获取网页正文 Markdown
2. get_system_context() → 对齐项目设定
3. write_file(...) → 写入背景资料或引用文件(进入 Diff 审阅)确认机制与 Diff 审阅
Diff 审阅流程
当 AI 提出写入/编辑结果时:
- 预览变更:显示 Diff 对比,清晰展示新增/删除/修改的内容
- 用户决策:
- 接受:保留这次修改
- 跳过/拒绝:回退这次修改,继续后续任务
- 取消:取消整个任务
删除操作(delete_item)会单独触发高危确认。
Diff 预览说明
- 🟢 绿色:新增内容
- 🔴 红色:删除内容
- ⚪ 灰色:未变更内容
用户长期记忆
为什么需要长期记忆?
传统 AI 对话结束后,本轮上下文会丢失;与个人相关的稳定偏好需要跨会话保留。All Writer 通过 remember 工具保存 用户维度 的长期记忆,并在新对话开始时作为上下文参考。
工作原理
AI 在适当时机调用 remember(单条短小,有槽位与长度限制,详见桌面端 Agent 文档):
用户:我的写作风格偏向冷峻克制,不要用太多形容词
AI 执行:
1. remember → 保存「用户偏好:冷峻克制,少形容词」
2. 之后任意新对话启动时自动加载这些记忆典型使用场景
- 风格偏好:叙事风格、用词习惯
- 交互偏好:希望直给修改、少追问等
- 稳定身份/职业信息:在合规前提下由用户主动透露时记录
与 @system 的区别
| 特性 | @system 文件夹 | remember 用户记忆 |
|---|---|---|
| 存储位置 | 项目内 Markdown | 用户账号维度 |
| 管理方式 | 用户手动编辑为主 | AI 工具写入为主;可在客户端「设置 → AI 功能 → 长期记忆」中查看与编辑 |
| 适用范围 | 当前项目设定 | 跨项目、跨对话的个人偏好 |
| 内容类型 | 世界观/角色/术语 | 个人习惯与偏好摘要 |
在客户端查看与管理
登录 All Writer 桌面端或网页端 后,打开 设置 → AI 功能,在 长期记忆 分区可浏览、编辑或删除当前账号下的条目。官方网站仅作功能说明,不提供记忆数据的查看或编辑界面。
模型管理 (v0.5.1+)
场景化模型配置 (v0.5.2 新功能)
不同的 AI 功能场景可以配置不同的默认模型:
| 场景类型 | 说明 | 推荐模型类型 |
|---|---|---|
| Agent | AI Agent 对话 | 高质量推理模型 |
| 补全 | 编辑器智能补全 | 快速响应模型 |
| 搜索 | @web/@base 搜索 | 搜索增强模型 |
配置方式:
- 打开「设置 → AI」
- 在「场景模型配置」中查看各场景
- 为每个场景选择默认模型
- 账号级配置会保存到云端,供 Web/云端项目跨设备使用
模型显示控制
你可以在设置页面控制哪些模型出现在 AI 对话的模型选择列表中:
- 打开「设置 → AI」
- 在「模型管理」部分查看所有可用模型
- 点击模型左侧的 👁️ 图标切换显示/隐藏
功能说明:
- 启用的模型(默认):在 AI 对话中可选
- 禁用的模型:不会出现在模型选择列表
- 支持多类型模型管理(Agent、补全、搜索等)
- 账号级设置会保存到云端,供 Web/云端项目跨设备使用
模型使用统计
设置页面还提供模型使用统计:
- 近 30 天统计:显示各模型的调用次数和金额消耗
- 活跃度热力图:类似 GitHub 贡献图,展示 AI 使用活跃度
- 写作日历:按月查看每日使用情况
模型同步与清理
- 模型列表更新:账号可用模型列表会随服务端配置更新,新增模型自动可用
- 智能清理:已下线的模型自动标记,不影响历史记录
- 账号偏好:云端账号的模型偏好跨设备生效,不代表桌面本地项目数据自动上云
长文、图表与渲染稳定性
近期版本对长文场景做了多项稳定性优化:
- Markdown 分段缓存:长消息和长章节按稳定块缓存,减少重复渲染。
- 流式渲染节流:AI 流式输出时降低不必要的重排,长对话更顺。
- Mermaid 懒渲染:图表进入视口后再渲染,减少长文档初始负载。
- Mermaid 回答支持:当解释流程、结构、依赖、状态转换或时序关系时,AI 可输出 Mermaid 图表辅助理解。
- 工具调用错误边界:工具结果展示异常时显示局部降级内容,避免整个 AI 面板不可用。
使用技巧
- 精简模型列表:禁用不常用的模型,减少选择时的干扰
- 按场景配置:为不同场景选择最适合的模型
- 关注统计:通过统计了解自己的使用习惯
计费(金额)说明
计费原则
所有 AI 功能按金额(元)计费,模型调用按普通输入、缓存输入和输出 Token 折算扣费:
| 功能 | 计费说明 |
|---|---|
| AI Agent 对话 | 按对话 Token 数折算金额(输入+输出) |
| AI 自动补全 | 按补全 Token 数折算金额 |
| @web 网络搜索 | 0.01 元/次(缓存命中通常不重复扣费) |
| @base 知识库搜索 | 按金额计费,消耗通常较低 |
| URL 转 Markdown | 0.01 元/次 |
| 上下文总结 | 长对话自动总结时按 Token 折算金额 |
| AI Word 导出 | 规划、重写/润色和渲染过程中涉及的 AI 调用按金额计费 |
详细计费示例与套餐说明见:计费与套餐说明。
余额获取
- 新用户注册:赠送一定初始余额
- 充值:在账户中心购买余额套餐
- 促销活动:关注官方活动可能获得额外余额
余额与消费记录
- 在「设置 → 账户」查看当前余额与消费记录
- 余额不足时会提示充值,不会中断操作
节省消耗技巧
- 配置好 @system 设定:减少反复修改
- 使用 @文件名 精准引用:避免 AI 读取不相关内容
- 善用 @base 知识库:比让 AI 重新阅读文档消耗更少
- 分步完成大任务:避免单次对话过长
使用技巧
1. 配置好 @system 文件夹
好的项目设定能让 AI 生成更符合预期的内容:
- 写作风格:明确叙事风格、语言特色
- 格式要求:定义章节结构、标题格式
- 检查清单:列出审阅标准
2. 提供清晰的指令
✅ 好的指令:
"帮我写第一章的内容,要求 2000 字左右,使用第一人称叙述"
❌ 模糊的指令:
"写点东西"3. 分步完成大任务
对于长文档,建议分多次生成:
第一步:创建大纲结构
第二步:逐章撰写内容
第三步:审阅和优化4. 善用 Diff 预览
在接受改动前,仔细查看 Diff 预览:
- 确认变更内容符合预期
- 检查是否有误删/误改
- 必要时选择跳过或取消
5. 审阅指令要写清边界
为了让审阅更可控,建议在指令里明确:
- 是否允许重写(还是仅局部修订)
- 优先级(先事实,再表达)
- 输出格式(问题清单、修改摘要、待确认风险)
请用审阅模式处理《第三章.md》:
1) 只做必要修正,不大改叙事风格;
2) 优先修正事实和逻辑问题;
3) 最后输出高/中/低优先级问题清单。常见问题
AI 功能需要网络吗?
是的,AI Agent 功能需要连接到服务器。但其他功能(编辑、保存、导出)可以完全离线使用。
AI 会存储我的文档内容吗?
AI 功能只在你主动发起请求时处理相关文本。All Writer 作为 AI 转发与编排服务,会把完成请求所需的上下文发送给已配置的模型网关或上游模型服务:
- AI 写入会进入 Diff 队列,你可以接受保留,也可以拒绝并回退
- 上游模型服务如何处理请求内容,以对应服务商或网关的政策为准
- 对话、任务记录和服务日志会按产品运行需要保留必要信息
生成内容质量如何?
AI 生成的内容质量取决于:
- 项目设定:@system 文件夹中的配置
- 指令清晰度:明确告诉 AI 你的需求
- 上下文信息:已有的文件内容和结构
可以取消正在进行的任务吗?
可以!点击"取消任务"按钮,AI 会停止当前任务。已经执行的操作不会回滚。
审阅阶段和写作阶段会互相影响吗?
会共享同一会话历史与项目上下文,这是预期行为。这样审阅 Agent 能理解写作阶段的背景并做更精准修订。
支持自定义 AI 写作风格吗?
支持!通过 @system 文件夹自定义:
- 创建
@system/写作风格.md文件 - 详细描述你期望的写作风格
- AI 会在生成内容时参考这些设定
下一步
- 📖 快速开始 - 学习基本操作
- 📝 文件管理 - 了解结构化写作
- ✍️ 写作 Agent 指南 - 产出初稿的推荐流程
- ✅ 审阅 Agent 指南 - 终稿前质量把关
- 🧩 模板创建指南 - 模板创建唯一详述文档
- ❓ 常见问题 - 查找更多问题解答