常见问题

这里收集了用户最常问的问题和解决方案。产品支持中文/英文界面（在设置中可切换）。本站文档为中英双语（根路径为中文，English 为英文站）。

安装与配置

如何安装 All Writer？

请参考 安装指南。简单来说：

1. 从 下载页面 下载适合你系统的版本
2. 运行安装程序
3. 按照提示完成安装

或直接使用 网页版，无需安装。

Windows 提示"无法识别的应用"怎么办？

这是正常的。因为应用还未获得微软的代码签名证书。解决方法：

1. 点击"更多信息"
2. 点击"仍要运行"
3. 应用会正常安装

我们正在申请代码签名证书，未来版本将不会出现此提示。

支持哪些操作系统？

目前支持：

• ✅ Windows 10 及以上版本（桌面版）
• ✅ 网页版（Chrome、Firefox、Edge、Safari 等现代浏览器；手机浏览器访问即移动端体验，无独立 App）

即将支持：

• 🚧 macOS（计划 2026 年开始开发）
• 🚧 Linux（计划 2026 年开始开发）

如何卸载 All Writer？

Windows:

1. 打开"设置" → "应用"
2. 找到 All Writer
3. 点击"卸载"

你的文档数据不会被删除，保存在用户目录下。

使用相关

我的数据存储在哪里？

桌面版：文档默认存储在本地数据库中。

网页版：数据存储在云端，自动同步。

支持云同步吗？

• 网页版：自动云端同步，多设备同一账号数据一致
• 桌面版：数据本地存储，暂不支持与云端双向同步

如何备份我的文档？

方法 1：导出项目

• Markdown 包（ZIP）：多文件与 @system 结构完整保留
• AI 分享卡片：从长文中提炼摘要、金句或宣传素材
• Web 包：适合试读、评审与快速分享

方法 2：网页版

• 使用网页版，数据自动云端同步

支持协作编辑吗？

当前版本不支持实时协作编辑。这是我们的重要规划之一，预计在未来版本推出。

AI Agent 功能

All Writer 有哪些 AI 功能？

All Writer 提供统一的 AI Agent 写作助手：

1. AI Agent 智能助手

• 通过自然语言指令完成写作任务
• 支持创建大纲、撰写内容、续写、优化等
• 支持多类工具（浏览、读取、写入、搜索、记忆等）
• 删除操作需用户确认；写入/编辑通过 Diff 审阅可回退

2. @ 指令系统

• @文件名 - 引用文件内容作为上下文
• @web - 启用网络搜索
• @base - 启用 RAG 知识库搜索

3. 网页资料沉淀

• 粘贴 URL 后，AI 可获取网页正文并转为 Markdown
• 适合把资料页、新闻、博客和产品文档整理进项目上下文

4. 消息编辑与回滚

• 点击历史消息直接编辑
• 支持回滚后续消息，重新对话

5. 自定义 Chat 模型

• 可在设置中添加 OpenAI 兼容模型
• 模型选择器按官方模型和自定义供应商分组
• 拨测失败时显示脱敏请求 / 响应摘要，方便排查 Base URL、Key 或模型协议问题

6. 只读子代理

• explore_project 用于项目摸底和多文件摘要
• review_project 用于只读审阅并输出证据路径
• research_context 用于资料研究和来源摘要
• 子代理参考报告可保存到 @system/@subagent/

7. AI 智能补全

• 行内实时补全与代码片段（在桌面与常规视口下体验最完整；窄屏/手机浏览器上界面会简化，以右侧 Agent 与编辑为主，行内补全可能有限或不突出）

8. 规划阶段（planning）

• 在发送消息前可切换到 规划，便于先出提纲、结构或步骤，再切回写作/审阅扩写

9. 设定抽取（@system 抽取）

• 从「创建项目时上传材料」「项目列表/Agent 面板的」入口触发，将成稿/参考内容抽取到 @system/，与日常多轮对话不同；详见 AI Agent 功能 与 写作 Agent 指南

有审阅 Agent 吗？和写作 Agent 有什么区别？

有。同一条 Agent 里可在消息粒度切换阶段（以界面标签为准，常见为）：

• 规划（planning）：先出大纲、章节目录或分步计划，再让写作/审阅落地
• 写作（writing）：生成、续写、扩写与改写
• 审阅（review）：核查事实、逻辑、风格并做局部修订

另有 设定抽取 任务，用于从上传文稿生成 @system 文件，属于独立的一次性工作流，不是「再聊一句」就能切换到的普通阶段。

推荐在同一会话里「规划/写作 → 审阅」，效率和质量都更高。

什么是子代理？会改我的正文吗？

子代理是主 Agent 派出的只读小任务，用来先调查再回传摘要。当前可见子代理包括：

• explore_project：摸清目录、关键文件和项目上下文。
• review_project：只读审阅，列出问题、证据路径和信息缺口。
• research_context：收集项目内外部资料并标注来源。

子代理本身不直接写入正文或删除文件；如果生成参考报告，会保存到 @system/@subagent/。真正修改正文仍通过写入/编辑工具进入 Diff 审阅。

@ 指令怎么使用？

文件引用（@文件名）：

1. 在对话输入框中输入 @
2. 弹出文件选择器，选择要引用的文件
3. 文件内容会作为 AI 的上下文
4. 可以同时引用多个文件：@人物设定 @世界观

网络搜索（@web）：

1. 在消息开头添加 @web
2. AI 会自动搜索相关信息
3. 网络搜索按 0.01 元/次计费；搜索结果会缓存，避免重复计费

知识库搜索（@base）：

1. 在消息开头添加 @base
2. AI 会在项目文档中进行语义搜索
3. 自动找到最相关的内容

网页正文（URL 转 Markdown）：

1. 在消息里粘贴完整 URL
2. 让 AI 总结、改写或提取其中对项目有用的信息
3. URL 转 Markdown 按 0.01 元/次计费；需要保留时，让 AI 写入资料文件或 @system

AI 功能需要付费吗？

AI 功能采用 金额（元）计费 模式：

• 新用户注册赠送一定余额
• 按实际使用量折算金额扣费，账户余额会随使用扣减
• 可在账户中心充值余额继续使用

详细说明见：计费与套餐说明。

可以使用自己的模型 API Key 吗？

可以。在「设置 → AI 功能 → 自定义 Chat 模型」里添加兼容 OpenAI API 的 Base URL、API Key 和模型 ID。保存前建议先拨测；如果失败，优先检查 Base URL 是否填写到 /v1、Key 是否有权限、模型是否支持流式 Chat Completions。

自定义模型本身的费用由你的上游供应商结算；网络搜索和 URL 转 Markdown 均按 0.01 元/次消耗 All Writer 账户余额，知识库搜索、AI Word 等平台能力仍按实际调用消耗账户余额。

如何使用 AI Agent？

1. 打开右侧 AI 助手面板（点击工具栏的 AI 图标）
2. 在输入框中输入你的需求，例如：

• "帮我创建一个关于机器学习的教程大纲"
• "帮我写第一章的内容"
• "继续写这一章，写 2000 字"

3. AI 会自动分析并执行任务
4. 需要确认时，查看 Diff 预览后决定是否执行

如何用审阅模式检查长文？

建议这样做：

1. 切换到审阅阶段（review）
2. 让 AI 先分段审阅，再逐段修正
3. 最后让 AI 汇总“问题清单 + 已修改内容 + 剩余风险”

如果你不希望大改，可以在指令里加上“仅做必要修改，不重写整体风格”。

什么是 @system 文件夹？

@system 是特殊的系统文件夹，用于存放项目设定（写作风格、人物设定、格式要求等），AI 助手会自动读取。详见 @system 项目设定。

模板创建到底有几种？详细规则在哪看？

模板创建的统一详述文档是：

• 模板创建指南

该页面统一维护模板类型、系统预设模板数量、创建方式和质量检查清单。
其他页面只保留简版说明，避免口径不一致。

AI 功能需要网络吗？

是的，AI Agent 功能需要连接到服务器。但其他功能（编辑、保存、导出）在桌面版可以完全离线使用。

AI 会存储我的文档内容吗？

AI 功能只在你主动发起请求时处理相关文本。All Writer 作为 AI 转发与编排服务，会把完成请求所需的上下文发送给已配置的模型网关或上游模型服务：

• AI 写入会进入 Diff 队列，你可以接受保留，也可以拒绝并回退
• 上游模型服务如何处理请求内容，以对应服务商或网关的政策为准
• 对话、任务记录和服务日志会按产品运行需要保留必要信息

AI 功能不可用怎么办？

可能的原因：

1. 网络连接问题 - 检查网络连接
2. 余额不足 - 在账户中心充值
3. 服务器维护 - 查看状态页面
4. 账户未登录 - 登录你的账户

如何编辑历史消息？

v0.5.x 新增的消息编辑功能：

1. 点击消息：直接点击任意历史消息进入编辑模式
2. 修改内容：修改消息内容后点击发送
3. 确认回滚：系统会提示是否删除该消息之后的所有消息
4. 重新生成：AI 会根据修改后的消息重新回复

这对于修正指令错误或尝试不同的提问方式非常有用。

网络搜索和知识库搜索有什么区别？

功能	@web 网络搜索	@base 知识库搜索	URL 转 Markdown
数据来源	互联网实时信息	项目内文档	指定网页正文
适用场景	查询最新信息、实时数据	查询项目内容、角色设定	总结、改写或引用某个网页
搜索方式	网络搜索	语义搜索（项目内文档）	读取网页并转为 Markdown
计费	0.01 元/次（缓存命中通常不重复扣费）	按金额计费（消耗相对较少）	0.01 元/次

💡 计费说明：所有 AI 功能按 金额（元） 计费。网络搜索和 URL 转 Markdown 均按 0.01 元/次 计费；相同搜索词命中本地缓存通常可避免重复扣费。知识库搜索也会产生少量消耗，通常低于长对话生成。AI Word 导出按实际调用消耗金额。详见 计费与套餐说明。

如何管理 AI 模型列表？

v0.5.1 新增模型管理功能，可以控制哪些模型出现在 AI 对话中：

1. 打开「设置 → AI」
2. 在「模型管理」部分找到模型列表
3. 点击模型左侧的 👁️ 图标切换显示/隐藏
4. 设置会自动保存并同步到云端

注意：禁用的模型只是不显示在选择列表中，不影响已经使用该模型的对话。

如何查看 AI 使用统计？

在「设置 → 账户」页面可以查看账户余额与消费记录。

在「设置 → AI」页面可以查看：

• 模型使用统计：近 30 天各模型的调用次数和金额消耗
• AI 使用热力图：类似 GitHub 贡献图的活跃度展示
• 写作日历：按月查看每日使用情况

编辑器问题

如何知道文档是否已保存？

All Writer 提供多种保存状态指示：

1. 编辑器工具栏：实时显示当前文件的保存状态

• "保存中..." - 正在保存
• "未保存" - 有未保存的更改
• "已保存" - 所有更改已保存

2. 文件树标记：未保存的文件右侧显示圆点标记
3. 自动保存：编辑后 2 秒自动保存，无需手动操作
4. 退出保护：关闭窗口时如有未保存内容，会弹出提示

支持哪些 Markdown 语法？

All Writer 支持完整的 Markdown 语法，包括：

基础语法：

• 标题、段落、换行
• 粗体、斜体、删除线
• 列表（有序、无序）
• 链接、图片
• 引用、代码块

扩展语法：

• 表格
• 任务列表
• 数学公式（KaTeX）
• 流程图（Mermaid）
• HTML 标签支持
• 高亮文本

如何插入图片？

方法 1：拖拽 直接将图片文件拖入编辑器

方法 2：粘贴 复制图片后，在编辑器中粘贴（Ctrl+V）

方法 3：Markdown 语法

![图片描述](图片路径)

支持数学公式吗？

支持！使用 KaTeX 语法：

行内公式：

$E = mc^2$

块级公式：

$$
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
$$

如何使用代码高亮？

使用代码围栏语法：

```javascript
function hello() {
  console.log("Hello, World!");
}

支持 100+ 种编程语言高亮。

## 导出问题

### 支持哪些导出格式？

应用内直接提供的导出能力包括：

- ✅ **Markdown 包（ZIP）** — 多文件、`@system` 与目录结构
- ✅ **AI 分享卡片** — 提炼摘要、金句或宣传素材
- ✅ **Web 包** — 浏览器可打开的静态页面包

**不**在应用内提供内置 PDF 导出；需要 PDF 时，可先导出 Markdown 或 Web 包，再使用下方工具、浏览器打印或本地排版软件转换。

### 如何导出为其他格式？

已导出为 Markdown 后，可使用 Pandoc 等工具转换；Web 包可通过浏览器打印为 PDF。需要 `.docx` 时，请用 Word、WPS、LibreOffice、Pandoc 等外部工具处理导出结果。

```bash
# 从 Markdown 转 PDF（需本机已安装 Pandoc/TeX 等环境）
pandoc chapter.md -o chapter.pdf

# 从 Markdown 转普通 Word
pandoc chapter.md -o chapter.docx

性能问题

编辑大文档时卡顿？

优化建议：

1. 拆分文档 - 将大文档拆分为多个小文件
2. 清理缓存 - 设置 → 高级 → 清理缓存
3. 升级硬件 - 建议至少 8GB RAM 处理超大文档

近期版本已加入 Markdown 分段缓存、流式渲染节流和 Mermaid 懒渲染，长对话和包含图表的长文档会比旧版本更稳定。如果仍然卡顿，优先检查单个文件是否过长或是否包含大量复杂图表。

启动速度慢？

可能的原因和解决方案：

1. 文档过多 - 归档不常用的文档
2. 缓存太多 - 清理应用缓存
3. 杀毒软件拦截 - 将 All Writer 加入白名单
4. 磁盘空间不足 - 释放磁盘空间

账户相关

如何注册账户？

1. 启动 All Writer 或访问网页版
2. 点击"登录"或"注册"
3. 填写邮箱和密码

忘记密码怎么办？

1. 在登录页面点击"忘记密码"
2. 输入注册邮箱
3. 查收重置密码邮件
4. 点击链接设置新密码

可以更换邮箱吗？

可以：

1. 登录账户中心
2. 进入"账户设置"
3. 点击"更换邮箱"
4. 验证旧邮箱后设置新邮箱

更新与反馈

如何检查更新？

All Writer 会自动检查更新。你也可以手动检查：

1. 点击"帮助" → "检查更新"
2. 如有新版本，按提示下载安装

如何反馈问题？

欢迎反馈！可以通过：

1. 提交工单（推荐）

• 打开 社区 页面，在「提交工单」区域填写标题和详细描述，无需登录即可提交
• 我们会尽快查看并在 1–3 个工作日内回复

2. 电子邮件

• 发送至：ypl123698745@qq.com
• 请在邮件中详细描述问题或附截图

如何提交功能建议？

我们欢迎你的建议！

1. 在 社区 提交工单，选择分类「功能建议」
2. 或发送邮件至 ypl123698745@qq.com

数据安全

我的数据安全吗？

All Writer 采用分场景的数据处理方式：

• 桌面版数据默认保存在本地
• 网页版通过账号云端同步，传输走 HTTPS/WSS
• AI 功能仅在你发起请求时处理相关上下文，写入/编辑会进入 Diff 审阅队列，可接受保留或拒绝回退
• 可以随时导出备份

如何备份我的文档？

方法 1：导出项目

• Markdown 包（ZIP）适合完整备份和迁移
• Web 包适合试读、评审和快速分享
• AI 分享卡片适合提炼摘要、金句或宣传素材

方法 2：网页版自动备份

• 网页版数据自动云端同步
• 多设备都可访问

---

还有问题？

如果以上内容没有解决你的问题：

• 📖 查看 完整文档
• 🤖 AI Agent 功能 - 了解 AI 功能
• 📤 导出功能 - 了解导出功能
• 💬 社区 — 提交工单、查看反馈与回复
• 📧 联系技术支持：ypl123698745@qq.com

我们通常在 24 小时内回复。