帮助

打开与新建

支持打开哪些格式？

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 能做什么？

打开并阅读（滚动、缩放、搜索），添加评论和文字批注，再下载为保留这些批注的 PDF。可填写的表单可以直接填。

能像 Word 一样改写 PDF 里已有的正文吗？

不能像流式文本那样改写——PDF 是固定版式格式。要改措辞，请打开原始的 DOCX / XLSX / PPTX，再从它导出新的 PDF。两步都在你的设备上完成。

只读与嵌入

能以只读方式打开吗？

能。在 /editor?file= 链接后加 &readonly=1，或通过嵌入 API 发送 document:set-readonly。只读可以在运行时随时开关，不需要重新加载文档。

能把编辑器放进我自己的网站吗？

能——编辑器就是为 iframe 嵌入设计的，用 postMessage 驱动：你的页面自己（带鉴权）取文件，发进 iframe，再收回编辑后的 File 上传到你想要的地方。见 Embed API 参考 与在线 demo。

离线与安装

离线能用吗？

离线编辑要求浏览器已缓存并保留应用、编辑引擎、转换器及所需字体和格式资源。访问一次或安装 PWA 不保证所有资源可用。 远程文件 URL 需要联网。

怎么拿到最新版本？

站点会在下次访问时自动更新。如果页面像是卡在旧版本，强制刷新（Ctrl+Shift+R / ⌘⇧R），或在浏览器的站点设置里注销 Service Worker。

隐私

我的文档会被上传吗？

核心的打开、编辑和格式转换在浏览器本地运行，不要求上传文档。写作助手只把它发往你指定的终点：本机服务让文本留在设备上，而你用自己 API Key 配置的云端端点会收到选中的文本和指令。嵌入宿主可以接收导出文件，并按自己的策略上传。

页面会从网络加载什么？

页面会加载应用代码、编辑器资源、字体及 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 文档助手

选一段文字，让助手帮你改写、总结或翻译。生成内容先审阅，满意后再写入文档。 默认关闭 · 仅此浏览器. 使用说明.