跳转到内容

你的数据

Wedding Computer 围绕开放数据这一原则构建:你的联系人和婚礼以纯文本格式存储,你可以阅读、编辑并随身带走——无需 Wedding Computer 的软件即可访问。这是一个刻意的设计选择,而不是一项需要解锁的功能。

每个联系人和每场婚礼都是一个带有 YAML frontmatter 的 Markdown 文件。下面是一个联系人文件的样子:

---
first_name: Sarah
last_name: Thompson
partner_first_name: James
partner_last_name: Chen
email: sarah@example.com
phone: +61 412 345 678
wedding_date: 2025-11-15
status: booked
source: enquiry_form
---
Notes about Sarah and James go here as plain text.

顶部的 YAML 区块包含结构化字段——与你在 CRM 中看到的字段相同。它下方的所有内容都是你的自由文本笔记。在任何文本编辑器中打开该文件,都可以立即阅读和编辑。

这些文件存放在一个存储桶中(默认是 Cloudflare R2),结构为一个 Markdown 文件文件夹。其结构遵循发布于 wedding.computer/standard 的开放标准。一个婚礼文件夹的样子是:

weddings/
sarah-james-2025/
wedding.md # wedding details + shared notes
todo.md # checklist
timeline.md # run sheet
notes.md # your private notes
vendors.md # generated vendor team list
log.md # generated changelog
files/ # uploaded attachments

wedding.md 保存预订详情和共享笔记。仪式、婚前准备、人像拍摄和招待会的时间与地点只保存在 timeline.md 中,因此同一份日程不会在两个文件里重复。旧版导出中即使这些字段位于 wedding.md,仍然可以导入。

前往你的个人资料 → 导出,即可下载流式生成的 ZIP 归档。Wedding Computer 会在发送下载内容的同时构建归档,而不是先把整个归档组装到内存中。

该归档是一份便携且便于阅读的参考副本,其中包含:

  • 你的账号资料
  • 你目前以活跃成员身份有权访问的每场婚礼
  • 对于供应商账号:供应商资料、联系人、发票、发票付款、日历事件,以及便于迁移的 contacts.csv
  • Wedding Computer 能够确认你有权访问的 Markdown 文件
  • Wedding Computer 能够确认你有权访问的已上传婚礼文档和表单文件
  • 用于说明归档及其结构化记录的清单文件和 JSON 参考文件

归档只包含你有权访问的数据。当你不再拥有某场婚礼的活跃访问权限时,该婚礼不会包含在归档中;其他成员的私密文件也不会包含,除非对方已与你共享。

免费版和 Pro 版均可下载账号归档。它仍是一份便携式参考归档,并不是可以一键完整恢复的备份。对于符合条件的供应商 v1 归档,你现在可以前往账号 → 你的数据 → 预览归档恢复上传原始 ZIP,进行严格检查,然后明确确认恢复缺失的联系人;归档中的其余部分并不是完整的账号导入。

在婚礼时间线中,**导出 → 打印运行表(PDF)导出 → 保存为壁纸(PNG)**可生成独立的运行表文件。这些功能与账号归档相互独立。

如需立即获得 CRM 表格,请打开联系人并选择下载联系人 CSV。系统会导出当前供应商的真实联系人,排除演示数据,格式与归档相同:UTF-8、符合 RFC 4180、对电子表格安全,共 31 列。这是一份账号级联系人清单,不是逐个联系人下载;目前仍不能单独下载某场婚礼的完整文件夹。

供应商账号归档中也会包含 contacts.csv。解压后,通过导入联系人上传该文件,其中 21 个核心联系人字段会自动完成映射;数据来源、标签、丢单信息和表单数据则会保留为结构化的额外详情。

这个 CSV 是迁移联系人的便携方式,并不是完整的账号恢复功能:它不会重新创建所有账号设置或关联记录。较大的归档会自动拆分为编号 CSV 文件;解压后请分别导入每个文件。每个文件都会小于 10 MB,且不超过 16,000 个联系人。由于 CSV 包含 31 列,它会先达到已处理单元格数量的安全上限,而不是通用的 20,000 行上限。

在没有 Wedding Computer 的情况下读取你的数据

Section titled “在没有 Wedding Computer 的情况下读取你的数据”

由于文件是纯 Markdown 格式,你可以在任何文本编辑器中打开它们——记事本、TextEdit、VS Code、Obsidian、iA Writer,或其他任何工具。无需特殊软件,无需文件转换器,无需账号。只要文本编辑器还存在,这种格式就会一直可读。

如果你已经在 Obsidian 中记录工作笔记——为了反向链接、图谱视图,或者只是因为你想把笔记存在自己的磁盘上而不是藏在登录墙后面——那么你不必在 Obsidian 和 Wedding Computer CRM 之间二选一。官方 Obsidian 插件会将你的联系人和婚礼以真实 Markdown 文件的形式镜像到你的 vault 中,这样你在 CRM 中使用的同一份数据,也可以用脚本处理、用 grep 搜索、用你日常的 vault 备份方式备份、纳入版本控制,或者在没有网络的飞机上离线阅读。从 Obsidian 社区插件目录安装它(搜索「Wedding Computer Sync」)。

配置好插件后:

  • 你的联系人和婚礼会以 Markdown 笔记的形式出现在 Obsidian 中
  • 你在 Obsidian 中所做的编辑会同步回 Wedding Computer
  • 在 Wedding Computer 中所做的更改,会在下次同步时出现在 Obsidian 中

该插件使用你在设置 → 日历与联系人 → 高级集成中生成的集成令牌进行身份验证。请在令牌仅显示一次时复制并安全保存。冲突检测基于 etag:如果 Wedding Computer 和你的库同时编辑了同一个文件,两个版本都会被保留,并标记一个冲突供你手动解决。

vault 同步 API 是 Pro 专属功能。

Wedding Computer 使用版本标识符,防止一个编辑版本在没有提示的情况下覆盖另一个。如果应用尝试保存 Markdown 文件时,其连接存储中的副本已经发生变化,两个候选版本都会被保留,冲突也会加入存储冲突。如有冲突等待处理,供应商仪表盘会显示提示横幅。

打开冲突后,你可以比较:

  • 应用版本 —— Wedding Computer 当时尝试保存的内容。
  • 存储版本 —— 连接存储中当前最新的内容。

之后有三种选择:

  • 保留应用版本会把应用中的候选内容写入存储,并通过正常导入流程应用。
  • 保留存储版本会保留存储中的最新内容,并据此更新 Wedding Computer 的索引。
  • 合并版本会在原始 Markdown 编辑器中打开应用候选内容。合并你需要的部分,然后保存合并后的内容。

决定前请阅读整个文件。保留任一版本都会从当前文件中舍弃另一版本;YAML 区块格式错误也可能导致合并后的文档无法应用。如果你打开比较页面后存储再次变化,Wedding Computer 会拒绝覆盖;请重新加载冲突并检查新版本。

当前应用会把新的供应商 vault 存储在 Wedding Computer 私有的 Cloudflare R2 中。目前不提供连接新的个人 GitHub 仓库的设置。旧有的内部或遗留存储记录不会改变当前上线行为。

如果你离开,或 Wedding Computer 停止运营会怎样

Section titled “如果你离开,或 Wedding Computer 停止运营会怎样”

如果你决定离开,请在账号和婚礼访问权限仍然有效时下载便携式账号归档。其中的 Markdown 文件可以在任何文本编辑器中打开,JSON 文件会保留结构化参考数据,而你有权访问的上传文件会保留原始格式。随后,你可以把其中的内容手动迁移到自己选择的工具中。

该 ZIP 仍是参考归档,并不是可以一键完整恢复 Wedding Computer 或其他服务的文件。如果你准备关闭账号,请把最新副本保存到由你掌控的位置。

打开账号 → 你的数据 → 预览归档恢复,选择 Wedding Computer 导出的原始 ZIP。请保持压缩包未解压、未修改。浏览器会将它拆成可安全重试的小段,上传到 Wedding Computer 的私有存储中。随后,Wedding Computer 会严格检查整个归档:拒绝不安全或不支持的 ZIP 结构,并把清单与归档中声明的文件、大小和校验和清单逐一核对。

预览会显示归档格式和导出时间、记录数量、归档报告的问题,以及哪些条目仍仅供参考。上传和检查绝不会创建、替换或删除账号记录。 如果预览将联系人标为符合条件,并且创建与保留数量无误,请选择恢复联系人并确认。开始恢复前必须完成这项单独确认。

联系人自动恢复仅适用于供应商账号现有的 wedding-computer-portable-v1 归档,且联系人不得超过 1,000 个、每个联系人 CSV 分片不得超过 4 MiB、联系人 CSV 数据总量不得超过 8 MiB。整个 ZIP 必须通过验证,所有声明的联系人分片必须存在,导出不得报告缺失、不完整或带警告的条目,并且联系人必须通过当前账号的安全检查。

确认后,恢复会使用归档中稳定的标识,只创建供应商账号中缺失的联系人。它会检查当前账号及其连接的 Markdown 存储,并原样保留所有现有联系人;不会替换、合并或删除联系人。婚礼、发票、发票付款、日历事件、Markdown、已上传文件、成员关系和账号设置仍只用于参考,不会被恢复。

确认后,恢复会异步运行,因此你可以安全地离开或关闭页面,稍后再回来查看状态。ZIP 上传期间仍可取消。开始检查另一个归档时,系统会替换之前尚未完成或预览已就绪的上传,确保你的账号只保留一项活动检查。

如果恢复显示失败,可能已经创建了一些新联系人。请重新上传同一个原始归档:恢复会重复使用这些稳定标识且只创建缺失项,因此会保留这些联系人,只补充仍然缺失的联系人。当恢复完成或达到最终失败状态后,私有 ZIP 和暂存的联系人数据都会被删除;如果无法立即删除,持久清理记录会继续安全重试。

如果无法上传完整 ZIP,请展开高级:仅检查 manifest.json,自行解压归档并选择 manifest.json。这一备用方法只检查清单声明的内容,不会检查 ZIP 中的其他文件,也不能判断联系人是否符合恢复条件。

密码和其他账号凭据、活跃会话、付款凭据、OAuth 密钥,以及日历或联系人订阅令牌将被永久排除在归档恢复范围之外,绝不会被重新创建。外部服务必须手动重新连接。

Wedding Computer 使用的文件格式以开放规范的形式发布于 wedding.computer/standard。任何应用都可以实现它——无需许可费,无需审批流程。如果另一个工具能读写相同的格式,你的数据就可以在它们之间无需任何转换地自由迁移。