打开与新建
支持打开哪些格式?
Word(.docx,以及旧版 .doc)、Excel(.xlsx,以及旧版 .xls)、PowerPoint(.pptx,以及旧版 .ppt)、CSV(.csv)和 PDF(.pdf)。点击打开选择文件、把文件拖到页面上,或用 /editor?file=https://… / /editor?src=https://… 传入网址(文件所在服务器需允许跨域请求)。
怎么新建文档?
首页的新建 Word / 新建 Excel / 新建 PowerPoint,或直接访问 /editor?new=docx、/editor?new=xlsx、/editor?new=pptx。服务器上不会创建任何东西:空白文档只存在于你的标签页里,直到你下载它。
有文件大小限制吗?
没有固定限制。整个文档在本地解析、渲染,实际上限取决于你设备的内存。
编辑与保存
怎么保存修改?
按 Ctrl+S / ⌘S,或用文件 → 下载为。因为没有服务器,"保存"就是浏览器把文件交还给你:它会以原文件名落到下载目录。在下载为里选别的格式即可转换(如 DOCX → PDF、XLSX → CSV)。
保存按钮为什么有时是灰的?
编辑器完整加载文档、且你做过修改后,保存按钮才会点亮。如果编辑后仍是灰色,说明文档没有加载完成——看一下右上角的错误提示,并参考下面的错误码一节。
能在格式之间转换吗?
可以,在你的设备上完成:打开文档,在下载为里选目标格式。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。
离线与安装
离线能用吗?
能。首次访问后 Service Worker 会缓存编辑器;你可以从浏览器地址栏把它安装为应用(PWA),没有网络也能打开文档。首次打开用了很多字体的文档仍需联网一次去取这些字体,之后它们也会被缓存。
怎么拿到最新版本?
站点会在下次访问时自动更新。如果页面像是卡在旧版本,强制刷新(Ctrl+Shift+R / ⌘⇧R),或在浏览器的站点设置里注销 Service Worker。
隐私
我的文档会被上传吗?
不会。文档从你的磁盘读入浏览器标签页,用 WebAssembly 在本地处理。本站没有任何上传接口。你可以在打开、保存时打开浏览器的网络面板自行核实——源码也以 AGPL-3.0 开源。
页面会从网络加载什么?
只有应用本身:编辑器的 JavaScript、WebAssembly 转换器、字体和页面自己的资源——全部来自本站域名——外加一个注重隐私的 Cloudflare Web Analytics 信标(无 Cookie、无跨站追踪)。如果你用自己的 API key 启用了可选的 AI 助手,它的请求会从你的浏览器直接发往你选择的服务商,不经过本站。
错误
提示里的错误码是什么意思?
- -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,每个版本改了什么见更新日志。