Document Editor

帮助

帮助

使用编辑器的实用解答。一切都在你的浏览器标签页内运行,文件永远不会被上传。

打开与新建

支持打开哪些格式?

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

打开并阅读(滚动、缩放、搜索),添加评论和文字批注,再下载为保留这些批注的 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 助手,它的请求会从你的浏览器直接发往你选择的服务商,不经过本站。

错误

提示里的错误码是什么意思?

遇到问题去哪里反馈?

GitHub 提 issue,写明浏览器与版本、文件类型,以及——如果不涉密——一个能复现问题的文件。最小复现胜过一切描述。

自托管

能自己部署一份吗?

能。它是纯静态站点,任何 Web 服务器都行:docker run -d -p 8080:80 ghcr.io/ranuts/document:latest,或 pnpm run build 后托管 dist/ 目录。HTTPS 与基础认证选项见 README,每个版本改了什么见更新日志

来源:仓库中的 content/zh-CN/help.md · GitHub