主题
AI Agent 智能助手
All Writer 提供统一的 AI Agent 写作助手，通过 ReAct（推理 + 行动）模式，理解项目结构、遵循项目设定，协助用户系统化地完成各类写作任务。
💡 v0.5.x 新特性：对话记忆持久化（update_notes）、场景化模型管理、增强搜索工具，让 AI 更懂你的项目。
功能概览
统一的 AI 写作助手
一个 Agent 适配所有写作场景：
- 📝 博客文章：生成、续写、优化博客内容
- 📧 邮件文案：撰写专业邮件和商务文案
- 📚 技术教程：编写技术文档和教程
- 📊 工作报告：生成报告和分析总结
- ✍️ 创意写作：小说、剧本、故事创作
- 📖 学术论文：论文撰写和格式规范
核心特性
ReAct 模式
AI 采用推理（Reasoning）+ 行动（Acting）的工作模式：
- 理解意图：分析用户指令，理解任务目标
- 规划步骤：制定执行计划
- 调用工具：执行具体操作（浏览、读取、写入等）
- 反馈结果：根据结果调整策略
时间感知
AI 能感知当前时间，在进行网络搜索时会自动获取最新内容。例如：
用户：帮我搜索一下最近的 AI 新闻
AI：（知道当前是 2026年1月，会搜索最新的 2026年 AI 新闻）工具调用确认
高危操作需要用户确认，安全可控：
- 需要确认：删除文件/文件夹（
delete_item） - 直接执行：写入、编辑、浏览目录、读取文件、搜索、记忆更新
- 写入/编辑保障：变更进入 Diff 队列，支持审阅与回退
写作 Agent + 审阅 Agent（双阶段协作）
AI Agent 支持两种阶段协作完成任务：
- 写作阶段（writing）：偏生产，快速产出内容
- 审阅阶段（review）：偏质量，核查并修正文稿
推荐使用方式是“先写后审”：
writing生成初稿或完成扩写review核查事实、逻辑和风格- 在 Diff 中确认修改并完成终稿
流式响应
实时查看 AI 的思考过程和生成内容：
- 思考内容实时显示
- 生成内容流式输出
- 工具调用状态实时更新
双阶段工作流（写作 / 审阅）
AI Agent 支持按消息切换工作阶段：
writing：调查 → 创作 → 保存review：阅读 → 核查 → 修改 → 汇报
两个阶段复用同一会话历史，适合先写后审的连续流程。
审阅阶段的七项检查维度
审阅阶段常用检查项：
- 事实准确性（人名、时间、数据、引用）
- 逻辑连贯性（论证链条、因果关系）
- 结构完整性（章节组织、段落分工）
- 表达质量（是否冗余、是否清晰）
- AI 腔调检测（空话套话、模板化语言）
- 风格一致性（与
@system设定一致） - 格式规范（标题、术语、标点、清单）
工具调用模式（Tool Use / XML）
- 模型为
both时可在 Tool Use / XML 之间切换 - 模型仅支持单模式时显示只读标识
- 切换后会在发送前做兼容性校验，避免无效请求
XML 与 Tool Use 的区别
- Tool Use（Function Calling）：模型通过 API 的
tool_calls字段返回工具名与参数，不把工具调用写在正文里。优点：结构清晰、解析稳定、与 OpenAI 等接口一致；多数新模型支持。 - XML 模式：模型在 assistant 的文本内容中输出
<tool_call>...</tool_call>等 XML 标签，由服务端解析后执行工具。优点：兼容仅支持纯文本输出的模型；部分开源/自托管模型仅支持此方式。 - 使用建议：模型配置为
both时，用户可在输入区切换；切换后发送前会做兼容性校验。仅支持单模式的模型，界面显示当前模式为只读。
@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
- 支持本地缓存，相同搜索不重复调用
- 计费：搜索调用按金额计费，缓存命中通常不重复扣费
知识库搜索 (@base)
启用 RAG 语义搜索，在项目知识库中查找相关内容：
@base 这个角色的性格是什么样的- 基于向量相似度的语义搜索
- 自动在项目文档中找到相关内容
- 支持增量索引，文档保存时自动更新
- 计费：按金额计费，知识库搜索消耗通常较低
消息编辑与回滚 (v0.5.x 新功能)
功能说明
对后续回答不满意？可以编辑历史消息重新对话：
- 点击消息：直接点击历史消息进入编辑模式
- 修改内容：修改后点击发送
- 确认回滚：系统会提示删除后续消息
- 重新生成：AI 根据修改后的消息重新回复
交互流程
消息列表:
├── [用户] 帮我写一段武侠场景 ← 点击进入编辑
├── [AI] 好的，这是一段武侠场景...
├── [用户] 再加点对话
└── [AI] 好的，加入对话后... ← 对这些不满意
↓ 编辑第一条消息后
├── [用户] 帮我写一段仙侠场景，要有飞剑 ← 修改后
└── [AI] 正在生成... ← 重新生成可用工具
AI Agent 拥有 11 个工具，分为以下类别：
浏览类工具
| 工具名 | 说明 | 需要确认 |
|---|---|---|
list_folder | 列出文件夹内容 | ❌ |
get_system_context | 获取 @system 项目设定 | ❌ |
读取类工具
| 工具名 | 说明 | 需要确认 |
|---|---|---|
read_file | 读取文件内容（支持多文件） | ❌ |
grep | 搜索关键词（支持多目录和正则表达式） | ❌ |
搜索类工具
| 工具名 | 说明 | 需要确认 |
|---|---|---|
web_search | 网络搜索 | ❌ |
rag_search | RAG 语义搜索知识库 | ❌ |
写入类工具
| 工具名 | 说明 | 需要确认 |
|---|---|---|
write_file | 创建或覆盖文件 | ❌（Diff 审阅可回退） |
edit_file | 编辑文件（追加/前置/按行替换） | ❌（Diff 审阅可回退） |
文件夹类工具
| 工具名 | 说明 | 需要确认 |
|---|---|---|
create_folder | 创建新文件夹 | ❌ |
delete_item | 删除文件或文件夹 | ✅ |
记忆类工具 (v0.5.2 新增)
| 工具名 | 说明 | 需要确认 |
|---|---|---|
update_notes | 持久化对话记忆，跨对话保存关键信息 | ❌ |
使用方法
界面位置
AI Agent 面板位于界面右侧，是三栏布局的一部分：
- 左侧：文件树
- 中间：编辑器
- 右侧：AI Agent 面板
基本交互
- 在右侧 AI 面板的输入框中输入你的需求
- AI 会自动分析并执行任务
- 需要确认时，查看 Diff 预览后决定是否执行
阶段切换与建议
你可以按消息切换阶段：
- 需要“生成内容”时用
writing - 需要“检查和修订”时用
review - 同一会话中可反复切换，历史上下文共享
对长文建议每完成一个章节就进行一次 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）
text
用户：请用审阅模式检查第一章，优先修正事实错误和逻辑断裂，保持原风格不变。
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 审阅）确认机制与 Diff 预览
确认流程
当 AI 执行写入/编辑操作时：
- 预览变更：显示 Diff 对比，清晰展示新增/删除/修改的内容
- 用户决策：
- 执行：确认执行此操作
- 跳过：跳过此操作，继续后续任务
- 取消：取消整个任务
删除操作（delete_item）会单独触发高危确认。
Diff 预览说明
- 🟢 绿色：新增内容
- 🔴 红色：删除内容
- ⚪ 灰色：未变更内容
对话记忆持久化 (v0.5.2 新功能)
什么是对话记忆？
传统 AI 对话结束后，所有上下文信息都会丢失。All Writer 的 update_notes 工具让 AI 可以跨对话保存和回忆关键信息。
工作原理
AI 在对话中遇到重要信息时，会主动使用 update_notes 工具将其持久化保存：
用户：我的写作风格偏向冷峻克制，不要用太多形容词
AI 执行：
1. update_notes() → 保存"用户偏好冷峻克制风格，减少形容词使用"
2. 后续对话中自动加载这些记忆典型使用场景
- 风格偏好：记住你喜欢的叙事风格、用词习惯
- 角色关键信息：保存角色间的复杂关系、重要设定
- 写作习惯：记录你对章节长度、结构的偏好
- 修改反馈：记住你之前不满意的方面，避免重复犯错
与 @system 的区别
| 特性 | @system 文件夹 | update_notes 对话记忆 |
|---|---|---|
| 存储位置 | 项目文件 | 对话记忆库 |
| 管理方式 | 用户手动编辑 | AI 自动更新 |
| 适用范围 | 项目级别 | 对话级别 |
| 内容类型 | 正式的创作规范 | 临时的偏好和上下文 |
模型管理 (v0.5.1+)
场景化模型配置 (v0.5.2 新功能)
不同的 AI 功能场景可以配置不同的默认模型：
| 场景类型 | 说明 | 推荐模型类型 |
|---|---|---|
| Agent | AI Agent 对话 | 高质量推理模型 |
| 补全 | 编辑器智能补全 | 快速响应模型 |
| 搜索 | @web/@base 搜索 | 搜索增强模型 |
配置方式：
- 打开「设置 → AI」
- 在「场景模型配置」中查看各场景
- 为每个场景选择默认模型
- 配置自动同步到云端
模型显示控制
你可以在设置页面控制哪些模型出现在 AI 对话的模型选择列表中：
- 打开「设置 → AI」
- 在「模型管理」部分查看所有可用模型
- 点击模型左侧的 👁️ 图标切换显示/隐藏
功能说明：
- 启用的模型（默认）：在 AI 对话中可选
- 禁用的模型：不会出现在模型选择列表
- 支持多类型模型管理（Agent、补全、搜索等）
- 设置自动保存到云端，跨设备同步
模型使用统计
设置页面还提供模型使用统计：
- 近 30 天统计：显示各模型的调用次数和金额消耗
- 活跃度热力图：类似 GitHub 贡献图，展示 AI 使用活跃度
- 写作日历：按月查看每日使用情况
模型同步与清理
- 自动同步：模型列表从后端自动同步，新增模型自动可用
- 智能清理：已下线的模型自动标记，不影响历史记录
- 跨设备同步：模型偏好设置跨设备生效
使用技巧
- 精简模型列表：禁用不常用的模型，减少选择时的干扰
- 按场景配置：为不同场景选择最适合的模型
- 关注统计：通过统计了解自己的使用习惯
计费（金额）说明
计费原则
所有 AI 功能按金额（元）计费，按实际 Token 用量折算扣费：
| 功能 | 计费说明 |
|---|---|
| AI Agent 对话 | 按对话 Token 数折算金额（输入+输出） |
| AI 自动补全 | 按补全 Token 数折算金额 |
| @web 网络搜索 | 按金额计费（缓存命中通常不重复扣费） |
| @base 知识库搜索 | 按金额计费，消耗通常较低 |
| 上下文总结 | 长对话自动总结时按 Token 折算金额 |
详细计费示例与套餐说明见：计费与套餐说明。
余额获取
- 新用户注册：赠送一定初始余额
- 充值：在账户中心购买余额套餐
- 促销活动：关注官方活动可能获得额外余额
余额与消费记录
- 在「设置 → 账户」查看当前余额与消费记录
- 余额不足时会提示充值，不会中断操作
节省消耗技巧
- 配置好 @system 设定：减少反复修改
- 使用 @文件名 精准引用：避免 AI 读取不相关内容
- 善用 @base 知识库：比让 AI 重新阅读文档消耗更少
- 分步完成大任务：避免单次对话过长
使用技巧
1. 配置好 @system 文件夹
好的项目设定能让 AI 生成更符合预期的内容：
- 写作风格：明确叙事风格、语言特色
- 格式要求：定义章节结构、标题格式
- 检查清单：列出审阅标准
2. 提供清晰的指令
✅ 好的指令：
"帮我写第一章的内容，要求 2000 字左右，使用第一人称叙述"
❌ 模糊的指令：
"写点东西"3. 分步完成大任务
对于长文档，建议分多次生成：
第一步：创建大纲结构
第二步：逐章撰写内容
第三步：审阅和优化4. 善用 Diff 预览
在确认执行前，仔细查看 Diff 预览：
- 确认变更内容符合预期
- 检查是否有误删/误改
- 必要时选择跳过或取消
5. 审阅指令要写清边界
为了让审阅更可控，建议在指令里明确：
- 是否允许重写（还是仅局部修订）
- 优先级（先事实，再表达）
- 输出格式（问题清单、修改摘要、待确认风险）
text
请用审阅模式处理《第三章.md》：
1) 只做必要修正，不大改叙事风格；
2) 优先修正事实和逻辑问题；
3) 最后输出高/中/低优先级问题清单。常见问题
AI 功能需要网络吗？
是的，AI Agent 功能需要连接到服务器。但其他功能（编辑、保存、导出）可以完全离线使用。
AI 会存储我的文档内容吗？
**不会！**我们承诺：
- 仅在使用 AI 功能时临时处理相关文本
- 不会永久存储文档内容
- 处理完成后立即删除数据
生成内容质量如何？
AI 生成的内容质量取决于：
- 项目设定：@system 文件夹中的配置
- 指令清晰度：明确告诉 AI 你的需求
- 上下文信息：已有的文件内容和结构
可以取消正在进行的任务吗？
可以！点击"取消任务"按钮，AI 会停止当前任务。已经执行的操作不会回滚。
审阅阶段和写作阶段会互相影响吗？
会共享同一会话历史与项目上下文，这是预期行为。这样审阅 Agent 能理解写作阶段的背景并做更精准修订。
支持自定义 AI 写作风格吗？
支持！通过 @system 文件夹自定义：
- 创建
@system/写作风格.md文件 - 详细描述你期望的写作风格
- AI 会在生成内容时参考这些设定
下一步
- 📖 快速开始 - 学习基本操作
- 📝 文件管理 - 了解结构化写作
- ✍️ 写作 Agent 指南 - 产出初稿的推荐流程
- ✅ 审阅 Agent 指南 - 终稿前质量把关
- 🧩 模板创建指南 - 模板创建唯一详述文档
- ❓ 常见问题 - 查找更多问题解答