Tldraw Slide Board 使用指南

English Privacy Policy · 简体中文隐私政策 · English User Guide · 中文使用指南

1. 安装与打开

从 Tldraw Slide Board 的 Chrome Web Store 页面安装扩展。
可在 Chrome 工具栏的扩展菜单中固定本扩展，方便以后打开。
点击扩展图标。Tldraw Slide Board 会在当前窗口的 Chrome 侧边栏中打开。

本地白板不需要 Google 账号。只有启用可选的 Google Drive 同步时才会请求 Google 授权。

2. 创建与编辑白板

在白板列表右上角点击 新建白板（加号）。
新白板会以“未命名白板”创建并直接打开。
使用画布底部或侧面的 tldraw 工具添加自由绘图、形状、箭头、文本、便签和其他支持的内容。
点击顶部的保存图标可立即保存。编辑内容也会大约每 3 秒自动保存；返回列表、隐藏侧边栏或页面退出时会再次尝试保存。
点击左上角返回箭头回到白板列表。

如果出现“保存失败”，请保持编辑器打开并点击重试。在确认已保存或完成导出备份前，不要卸载扩展或清除浏览数据。

3. 按日期浏览和管理

白板按照创建日期显示。点击顶部日期区域打开日历。
使用上个月、下个月和“今天”按钮浏览日期；日期下方的标记表示当天存在白板。
点击列表中的白板标题区域可重新打开白板。
将鼠标移到白板条目上，点击铅笔图标进行 重命名。
点击垃圾桶图标并确认，可删除该白板。删除操作会进入同步队列；如果已启用云同步，也会传播到其他设备。

删除白板前建议先执行一次全量导出。删除确认后，界面不提供本地回收站。

4. 导出与导入

导出全部白板

点击右上角的 全量导出（下载图标）。浏览器会下载名称类似 tldraw-slide-board-2026-08-19.json 的文件，其中包含全部白板和快照。

请把导出文件视为私人内容妥善保管。任何能够读取该文件的人都可能看到其中的白板内容。

合并导入

点击导入（上传图标）。
选择 合并导入。
选择由 Tldraw Slide Board 导出的 JSON 文件。

扩展会先验证文件。有效白板会加入现有资料；如果导入文件中包含相同白板 ID，则导入版本会更新该白板。

覆盖导入

点击导入。
选择 覆盖导入。
阅读确认提示后继续，并选择 JSON 文件。

覆盖导入会先验证整个文件，验证成功后替换当前全部本地白板。操作前请导出现有资料。若已启用云同步，导入结果也会排队同步。

5. 连接 Google Drive

在白板列表右上角点击云朵图标，打开 Google Drive 同步。
阅读提示：白板将保存在你的 Google Drive 私有应用数据目录中，并且不提供端到端加密。
点击 连接 Google Drive。
在 Google 授权页面选择账号并同意访问应用专用数据目录。
等待状态从“正在连接/正在初始化”变为“已同步”。首次连接会同时上传本机白板并合并该账号中已有的扩展数据。

扩展请求的 OAuth 权限为 drive.appdata。它不会获得普通 Drive 文件列表的访问权，也不会读取浏览历史或当前网页。

如果 Google 显示“应用正在测试”，只有被列入测试用户的账号才能继续。公开发布前，开发者应完成 OAuth 同意屏幕配置并将应用切换到适当的生产状态。

6. 在第二台设备启用双向同步

在另一台设备或 Chrome Profile 中安装同一个商店版本。
登录同一个 Google 账号。
打开扩展的云同步面板，点击 连接 Google Drive 并授权。
等待状态变为“已同步”，再检查两边的日期和白板列表。
在任一设备修改白板并保存。扩展会排队上传更改；另一设备在下一次同步后合并更改。

侧边栏打开时，扩展通常约每 20 秒检查一次；本地保存还会安排一次较快的同步。后台也约每分钟安排一次尝试。Chrome 可能暂停 Service Worker、设备可能离线或受配额限制，因此这些时间不是保证。需要立即检查时使用 立即同步。

7. 离线编辑与冲突

断网时仍可创建和编辑本地白板。
保存的更改保留在本地待上传队列中；重新联网后扩展会再次尝试同步。
不同设备修改不同白板或不同记录时，扩展会合并这些修改。
两台设备同时修改同一条记录时，扩展使用向量时钟和稳定的确定性规则选择结果，使设备最终收敛。
未采用的记录版本会显示在 冲突历史 中。点击 恢复此版本 会把该记录版本恢复为新的修改并再次同步；它不是整个白板的一键回滚。

Tldraw Slide Board 不是多人实时协作服务。不要把它用于需要同步光标、实时共同编辑或严格事务锁定的场景。

8. 同步面板说明

最近同步：本机最后一次成功完成同步的时间。
待上传：仍在等待处理的本地更改数量。
冲突：当前保存的记录级冲突历史数量。
立即同步：立刻尝试推送和拉取更改。
断开账号：停止本机同步并清除 Chrome 缓存的授权令牌；本地白板和 Drive 云端数据都会保留。
删除云端数据：删除该 Google 账号 appDataFolder 中由 Tldraw Slide Board 标记的副本，清除本机同步状态并断开账号；本地白板保留。

如果要永久停止所有设备的云同步，先在其他设备上执行 断开账号，最后在一台设备上执行 删除云端数据。否则仍保持连接的另一台设备可能再次上传数据。

9. 常见同步错误

`403 access_denied`

OAuth 应用仍处于测试状态，而当前 Google 账号不在测试用户列表中；或
OAuth 客户端与已安装扩展 ID 不匹配；或
用户/管理员拒绝了授权。

使用正确账号，确认开发者的 OAuth 配置后重新连接。

`Google Drive API has not been used ... or it is disabled`

开发者需要在 OAuth 客户端所属的 Google Cloud 项目中启用 Google Drive API。启用后等待几分钟，再点击 立即同步 或重新连接。

“需要重新授权”或 401

打开同步面板，先断开账号，然后再次连接。如果问题持续，可在 Google 账号的第三方连接页面移除授权后重试。

“离线”或网络错误

确认网络和 Google API 未被防火墙阻止，然后点击 立即同步。本地白板不会因为一次网络失败而自动删除。

10. 删除数据与卸载

只删除本地白板

在列表中逐个删除白板，或使用经过验证的覆盖导入替换全部资料。删除前先导出备份。

删除 Drive 云端数据

打开云同步面板，点击 删除云端数据 并确认。该操作不会删除本地白板。

撤销 Google 授权

在扩展中执行 断开账号，并可前往 Google 账号的第三方连接页面移除 Tldraw Slide Board 的访问权。撤销授权本身不会删除已经存储的本地或云端白板。

卸载扩展

如果需要保留内容，请先全量导出。若也要删除 Drive 数据，应在卸载前使用 删除云端数据。卸载会移除本机扩展及其本地存储，但不会自动清理 Google Drive appDataFolder 中的副本。

11. 支持与隐私

隐私政策：查看中文隐私政策
问题反馈：GitHub Issues
隐私联系：pdai3892@gmail.com

提交问题时不要附上 OAuth Token、Cookie、账号密码或包含私人白板内容的完整导出文件。