打开与新建
支持打开哪些格式？
Word（.docx，以及旧版 .doc）、Excel（.xlsx，以及旧版 .xls）、PowerPoint（.pptx，以及旧版 .ppt）、CSV（.csv）和 PDF（.pdf）。点击打开选择文件、把文件拖到页面上，或用 /editor?file=https://… / /editor?src=https://… 传入网址（文件所在服务器需允许跨域请求）。
怎么新建文档？
核心的打开、编辑和格式转换在浏览器本地运行，不要求上传文档。 启用自动保存时，恢复副本保存在当前浏览器的 IndexedDB 中，在最后一次编辑或打开后保留 7 天。关闭标签页不会删除副本。你可以在 /history 删除副本或关闭自动保存。浏览器存储可能被清理或回收，尚未自动保存的编辑也可能丢失；恢复副本不能替代正式保存文件。
有文件大小限制吗？
没有固定限制。整个文档在本地解析、渲染，实际上限取决于你设备的内存。
编辑与保存
怎么保存修改？
在支持 File System Access API 的 Chrome、Edge 等浏览器中，首次保存会让你选择文件，之后保存直接写回该文件。其他浏览器下载副本。使用“文件 → 下载为”导出其他格式。浏览器内的恢复副本与正式保存的文件相互独立。
保存按钮为什么有时是灰的？
编辑器完整加载文档、且你做过修改后，保存按钮才会点亮。如果编辑后仍是灰色，说明文档没有加载完成——看一下右上角的错误提示，并参考下面的错误码一节。
能在格式之间转换吗？
可以，在你的设备上完成：打开文档，在下载为里选目标格式。Word 可导出 DOCX / PDF / TXT，表格可导出 XLSX / CSV / PDF，演示文稿可导出 PPTX / PDF。CSV 会以表格方式打开，并可存回 CSV。
中文 CSV 在别的工具里乱码，这里呢？
编辑器打开 CSV 前会嗅探编码——先严格 UTF-8，再 GB18030（Excel 导出中文时用的"ANSI"编码），最后 Latin-1——所以在别处乱码的文件这里能正常打开。保存时写入带 BOM 的 UTF-8，Excel 直接双击打开不会乱码。
PDF 能做什么？
打开并阅读（滚动、缩放、搜索），添加评论和文字批注，再下载为保留这些批注的 PDF。可填写的表单可以直接填。
能像 Word 一样改写 PDF 里已有的正文吗？
不能像流式文本那样改写——PDF 是固定版式格式。要改措辞，请打开原始的 DOCX / XLSX / PPTX，再从它导出新的 PDF。两步都在你的设备上完成。
只读与嵌入
能以只读方式打开吗？
能。在 /editor?file= 链接后加 &readonly=1，或通过嵌入 API 发送 document:set-readonly。只读可以在运行时随时开关，不需要重新加载文档。
能把编辑器放进我自己的网站吗？
能——编辑器就是为 iframe 嵌入设计的，用 postMessage 驱动：你的页面自己（带鉴权）取文件，发进 iframe，再收回编辑后的 File 上传到你想要的地方。见 Embed API 参考 与在线 demo。
浏览器 AI 助手（WebMCP）
浏览器里的 AI 助手能操作编辑器吗？
WebMCP 工具在本地编辑和转换，但浏览器代理可以获取文档文本或导出文件，并可能发送给自己的 AI 服务。处理机密内容前，请确认代理的数据策略。
哪些浏览器支持？
WebMCP 是 W3C Web Machine Learning 社区组的提案，目前在 Chrome 的 origin trial 中可用，Firefox 和 Safari 尚未表态。浏览器没有提供该 API 时，什么也不会注册、什么也不会变——它是纯增量能力。
嵌入的编辑器里也能用吗？
按设计不能。工具只在编辑器作为顶层页面时注册。跨域 iframe 需要嵌入方页面授予 allow="tools"，这与嵌入的使用方式冲突——所以如果你嵌入了编辑器，请改用 Embed API 驱动它。
助手能读取文档正文吗？
文字文档可以：get_document_text 会返回正文，助手不必导出就能回答关于内容的问题。表格和演示文稿在当前引擎上没有全文读取接口；工具会明确说明这一点（而不是返回一个看起来像"文件是空的"的空结果），并提示改用导出。
离线与安装
离线能用吗？
离线编辑要求浏览器已缓存并保留应用、编辑引擎、转换器及所需字体和格式资源。访问一次或安装 PWA 不保证所有资源可用。 远程文件 URL 需要联网。
怎么拿到最新版本？
站点会在下次访问时自动更新。如果页面像是卡在旧版本，强制刷新（Ctrl+Shift+R / ⌘⇧R），或在浏览器的站点设置里注销 Service Worker。
隐私
我的文档会被上传吗？
核心的打开、编辑和格式转换在浏览器本地运行，不要求上传文档。 内置 AI 助手尚未完成，不属于已发布的可用功能。 嵌入宿主可以接收导出文件，并按自己的策略上传。
页面会从网络加载什么？
页面会加载应用代码、编辑器资源、字体及 Cloudflare Web Analytics 请求。远程文件 URL 会产生额外请求。嵌入宿主和外部浏览器代理各自决定如何处理数据。
错误
提示里的错误码是什么意思？
- -85——文件内容与扩展名不符（例如把 HTML 页面存成了
.xls，或.docx其实是.doc）。改名或重新导出。 - -82——文件无法转换；可能已损坏、有密码保护，或是引擎不支持的变体。
- -24 / -25——编辑器的某个脚本加载失败，通常是网络抖动或缓存了旧版本。强制刷新后重试。
- 80——转换器内部导出失败。换一个目标格式试试；持续出现请附上文件类型与步骤提 issue。
遇到问题去哪里反馈？
到 GitHub 提 issue，写明浏览器与版本、文件类型，以及——如果不涉密——一个能复现问题的文件。最小复现胜过一切描述。
自托管
能自己部署一份吗？
能。它是纯静态站点，任何 Web 服务器都行：docker run -d -p 8080:80 ghcr.io/ranuts/document:latest，或 pnpm run build 后托管 dist/ 目录。HTTPS 与基础认证选项见 README，每个版本改了什么见更新日志。
关闭标签页后会留下什么？
启用自动保存时，恢复副本保存在当前浏览器的 IndexedDB 中，在最后一次编辑或打开后保留 7 天。关闭标签页不会删除副本。你可以在 /history 删除副本或关闭自动保存。浏览器存储可能被清理或回收，尚未自动保存的编辑也可能丢失；恢复副本不能替代正式保存文件。
目前可以使用内置 AI 助手吗？
内置 AI 助手尚未完成，不属于已发布的可用功能。 嵌入宿主可以接收导出文件，并按自己的策略上传。