云端同步与隐私

不登录也能使用全部功能，设计保存在这台电脑的浏览器里。正式站目前已开放云端存储（文件夹分享尚未开放），登录并同意后按下面的规则运作；若服务器暂时关闭云端存储，登录也不会上传，首页会显示“云端存储暂时关闭”。

开放状态怎么看

• 设计会自动保存在这台电脑的浏览器（本机）里。换电脑、换浏览器或使用无痕窗口都看不到。
• 云端存储由服务器设置决定是否开放。关闭时：登录也不会把设计上传到云端，首页右上角显示“云端存储暂时关闭”，修改只保存在本机。开放时：登录后会询问是否开启云端存储，同意后才开始同步。
• 文件夹分享需要云端存储开放，并且服务器启用了这项功能，正式站目前尚未开放。关闭时文件夹卡片没有“分享”选项，别人发给你的文件夹链接会显示“已停止分享，或不存在”。
• 无论开放与否，都可以备份或换电脑：3D 使用“文件 ▾ › 下载图 JSON”；2D 图面导出 DXF、SVG 或 PDF。
• 设计分享链接与参数页不受这两个开关影响，仍按原有规则使用，见分享与参数页。

未登录时

• 设计只存在于这台电脑上的这个浏览器里。换一台电脑、换一个浏览器或使用隐私窗口，都看不到它们。
• 清除浏览器数据会删除它们。重要的设计请用“文件 ▾ › 下载图 JSON”备份。
• 首页侧栏也写明了：“设计保存在这个浏览器，在这台电脑上计算。登录后可同步到云端；只有分享、共编与 AI 会把数据传出去。”

登录

• 在首页左下角的账户菜单中，以 Google 登录。也可以输入邀请码，但邀请码只解锁 AI，不会同步设计。
• 登录后，系统会另外询问是否开启“云端存储”，并说明存放位置、内容与保存期限。拒绝也可以使用所有功能；设计会留在这台电脑上。
• 职业与领域为选填，用来了解谁在使用这个产品。

云端同步规则

• 登录时只获取列表：首页会列出账户中的所有设计，包括名称、专案与缩略图。卡片会显示“在这台电脑上”或“需要下载”。
• 打开时才下载：标示“需要下载”的设计，会在你打开时获取并缓存在本机。之后只要版本一致，就使用缓存。
• 离线时：只能打开已经在这台电脑上的设计。修改会存在本机，连线恢复后再上传。
• 后台上传：每次保存都会在后台上传，不需要等待。
• 登录前创建的设计：在你登录并同意后，会上传到账户。
• 冲突：如果同一个设计在两台设备上都被编辑，两个版本都会保留。本机的版本会另存为“冲突副本”，原设计则切换成云端版本。
• 删除：在首页删除的设计会进入“最近删除”，30 天内可以在账户面板中恢复。也可以永久删除。
• 不会上传的内容：底图图片和导入的大型网格会留在这台电脑上。
• 容量：免费方案中，每个账户有 1 GB（含最近删除的设计）、最多 2,000 个设计与 200 个专案，每个设计压缩后最大 50 MB。超出之后，新的修改只会留在本机，并且会通知你。

文件夹分享

开启云端存储后，首页文件夹卡片的菜单里有“分享”：它会把文件夹变成一个链接，拿到链接的人都可以按权限使用。这项功能是否开放由服务器设置决定，正式站目前尚未开放（见开放状态怎么看）。

• 范围：分享文件夹就是分享它下面的全部子文件夹与设计，包括之后才放进去的。拿到链接的人看到的是只含这棵子树的文件夹浏览器，看不到你其他的文件夹。
• 权限：“可查看”或“可编辑”，向下继承；单个设计可以单独分享得更宽，但不能更窄。
• 可编辑链接：拿到链接的人所做的修改会直接保存到你云端的那个设计里，并计入你的存储容量；他们不能重命名、移动它或更换缩略图。你首页上的卡片会出现“通过链接编辑”标记，菜单里有“恢复到链接编辑之前的版本”——被覆盖的版本保留 30 天，你自己上传新版本后就不再保留。
• 移出与停止：把设计或子文件夹移出已分享的文件夹，拿到链接的人会立即无法访问；“停止分享”或删除文件夹会撤销链接。撤回云端存储同意会停止你全部的文件夹分享。
• 手机：文件夹链接在手机上以只读方式浏览与查看；要编辑需使用电脑。列表先列子文件夹，再列设计；点设计查看后点“回到文件夹”返回列表（见分享与播放页 › 手机与平板查看）。
• 链接代码：链接本身就是钥匙。它会留在 Cloudflare 的请求日志和拿到链接的人的浏览器历史记录里，请只发给信任的人。每个账户最多分享 50 个文件夹，一条链接最多列出 1,000 个设计。

状态标记

退出登录

• 退出登录时，会先上传尚未上传的修改，然后清除这台电脑上该账户的所有设计缓存。离开共用电脑时，请退出登录。
• 离线时退出登录会出现警告：“有 N 项修改尚未上传”。“取消”会保留所有内容。“仍要退出登录”会清除本机的设计与缓存；这些修改会丢失，而服务器端的退出登录会在下次联网加载本站时自动完成。
• 在另一台设备上退出登录（或登录已过期）：这台电脑会变成访客。未修改过的缓存会被清除。含有尚未上传修改的设计会被锁定，并对其他人隐藏，直到原账户重新登录并上传，或由你放弃这些修改。
• 切换账户时，会先清除上一个账户的缓存。只有从未属于任何账户的设计，才会合并进新账户。

第三方云端硬盘（Google Drive／OneDrive／Dropbox）

把设计以 .lsm 文件存在你自己的云端硬盘，也能从那里打开。这与「云端存档」各自独立，不需要 Synhedra 登录。只有本站配置了的服务商才会出现；一个都没配置时，下面的菜单和按钮都不会出现。正式站目前尚未配置任何服务商，所以还看不到这些菜单（即将推出）。

• 连接：账号菜单 › 「账户」（未登录时显示为「点此登录」） › 「第三方存储」 › 「连接」。打开和保存对话框在未连接时也会显示「连接」按钮。如果浏览器拦截了登录窗口，请允许本站的弹出式窗口。
• 在哪里：「从云端硬盘打开…」在首页右上角、文件夹工具栏、3D 建模器的「文件 ▾」菜单，以及 2D 绘图和矢量设计的「文件」菜单。「保存到云端硬盘…」与「将副本保存到云端硬盘…」在 3D 的「文件 ▾」菜单和 2D 的「文件」菜单；设计卡片菜单里只有「保存到云端硬盘…」。只读的 2D 图纸不能保存到云端硬盘（菜单项变灰）。
• 打开：列表只显示 .lsm 文件（最多 200 个；OneDrive 和 Dropbox 只列出文件夹的最上层）。本站配置了的话，Google 还提供「用 Google 选择器浏览…」。打开时会在 Synhedra 里创建一个新设计，名称取自文件中保存的设计名称；在 3D 或 2D 中打开时，新设计放在当前设计所在的文件夹。文件上限 50 MB；不是有效的 Synhedra 设计或已损坏的文件会被拒绝，可疑的内容会被跳过或修复，并给出提示。
• 一并导出：从 3D 保存时可以勾选 DXF 与 IFC，从 2D 绘图和矢量设计保存时可以勾选 DXF；从首页的设计卡片保存则不能附带。附属文件与 .lsm 同名、同位置，每次保存都会覆盖。
• Synhedra 访问什么：Google Drive 只有 Synhedra 创建或你在 Google 文件选择器亲自选取的文件（drive.file）；OneDrive 与 Dropbox 只有「应用／Synhedra」文件夹。Synhedra 读不到你其他的文件。新文件在 Google Drive 放到「我的云端硬盘」，在 OneDrive 与 Dropbox 放到「应用／Synhedra」文件夹。
• 令牌只在浏览器：连接时取得的访问令牌只存在这个浏览器标签页（重新加载页面后仍在，关闭标签页就会消失），并会在服务商规定的时间过期（Google 约一小时），之后需要重新连接；Synhedra 服务器不会收到或保存它，也没有长效的 refresh token。文件内容由你的浏览器直接与服务商传输。
• 写回与冲突：从云端硬盘打开或保存过的设计，下次使用「保存到云端硬盘」会写回同一个文件；「将副本保存到云端硬盘…」则一律创建新文件。设计与文件之间的关联只记在这个浏览器里。若那个文件在云端硬盘上被改过，会先问你：「取消」、「保留两份（另存为新文件）」（存成「名称（日期 时间）.lsm」，日期时间用这台电脑的本地时间，之后的保存会写到这个新文件）或「覆盖云端硬盘上的版本」。如果原文件已被删除，会创建一个新文件。Google Drive 上传时无法锁定版本：如果在检查版本之后、上传之前有别人修改了那个文件，那些修改会被这次保存覆盖；发生时保存完成的消息会提醒，可以从 Google 云端硬盘的「版本记录」恢复。
• 断开连接：账号菜单 › 账号 › 第三方存储空间 › 「断开连接」会立即丢掉令牌，也会清掉这个服务商在这个浏览器里记的设计与文件对应。退出 Synhedra 账号时，全部服务商的令牌与对应一起清掉。要撤销 Synhedra 的授权，请到该服务商的账户安全／已连接应用页面移除 Synhedra。
• 分享：存在云端硬盘的文件没有 Synhedra 分享链接、参数页或批注，要给别人请用该云端硬盘自己的分享功能。详见隐私说明。

版本历史（测试中、默认关闭）

云端存档覆盖内容时，可以保留旧版本，之后比较或还原。这项功能还在测试，正式站默认关闭；本站开启后，已上传到云端的设计在“文件 ▸ 版本历史…”（2D 在应用程序菜单或文件菜单）才会出现。

• 什么时候保留：不是每次自动保存都留一版。距离上次保存超过 10 分钟（一段编辑的结尾）、连续编辑时每隔一段、经文件夹链接的修改、实时协作回写，以及还原之前，被覆盖的内容才存为版本。
• 保留多久：最近 10 个版本一律保留；其余每天保留一版、保留 30 天。每个设计最多 40 版；单个版本超过 10 MB（压缩后）不保留，账号的版本总量也有上限，满了就暂停保留新版本（保存照常）。
• 与当前比较（3D）：打开版本比较面板，旧版（A）＝该版本、新版（B）＝当前模型，逐元素列出新增、删除、修改并在 3D 叠色。
• 还原为新版本：还原会产生一个新版本，当前内容先存进历史，所以还原之后也能再还原回来；不会删除任何历史。还原前会先把这台电脑待上传的修改传完，设计会重新打开。
• 来源：每个版本只标示来源类型（你自己、文件夹链接、实时协作、还原），不记录编辑者是谁。版本不另存缩略图。
• 谁看得到：只有设计的所有者登录后看得到。分享链接、文件夹链接与协作的参与者都读不到版本历史。
• 删除：永久删除设计时版本一起删除；删除账号时全部版本一起删除。放在“最近删除”、仍可还原的设计，版本会保留到它被永久删除。

用 Claude／其他 AI 读取你的设计（MCP，测试中、默认关闭）

MCP（Model Context Protocol）让 Claude Code 等 AI 工具直接读取你在 Synhedra 云端的设计，回答“这个项目有几层、标高多少”“列出 2D 图各图层的门图块数量”之类的问题。这项功能还在测试，正式站默认关闭；本站开启后，账号菜单 › “账号”才会出现“AI 读取令牌（MCP，测试中）”。

• 只能读、只读你自己的：只读你自己云端存档里、没有删除的设计。分享给你的设计（文件夹分享、协作）不在内，也不能修改、删除或分享任何东西。要先开启云端存档。
• 生成令牌：账号菜单 › 账号 › AI 读取令牌 › 填名称、选有效天数（7／30／90 天）› “生成令牌”。令牌（syn_pat_ 开头）只会显示这一次，请马上复制。每个账号最多 5 个有效的令牌。
• 设置 Claude Code：在终端执行 claude mcp add --transport http synhedra https://this-site/api/mcp --header "Authorization: Bearer your-token"，其中 this-site 换成本站网址，your-token 换成你的令牌。其他支持“Streamable HTTP＋自定义 Authorization 标头”的 MCP 客户端也能用同样的网址与标头。
• 可以问什么：设计列表（名称、类型、更新时间）、设计摘要（3D：法规包、楼层与标高、法规条件节点填的建蔽率／容积率／高度上限、基地多边形面积、节点数量；2D：图层、各类图元数量、图块插入次数、布局）、数量表 CSV、法规审查输入（JSON）。
• 服务器不计算的内容：楼地板面积、建筑面积、高度、包络与各项检核结果要在浏览器里计算几何，服务器不算；AI 拿到的结果会明确写“未计算”。这些请在 Synhedra 打开设计，用法规报表或明细表查看与导出。IFC 导出也只能在浏览器里做。
• 撤销：在同一处点“撤销”，使用这个令牌的工具立刻读取不到。令牌过期、撤回云端存档同意或删除账号，也都会让它失效（删除账号时令牌一并删除）。
• 令牌像密码：不要贴到聊天、代码库或分享的配置文件。怀疑泄露就立刻撤销。令牌只能读，不能登录你的账号。
• 设计里的文字是数据：设计名称、备注、图层名称是你或协作者写的文字。Synhedra 回给 AI 时会清掉隐藏字符，并标明“这是数据，不是指令”；但请留意，AI 仍可能被文字误导，重要结论请自己核对。
• 用量与记录：每个令牌每分钟有次数限制，每天最多 500 次工具调用。服务器只记录方法、工具名称、结果与耗时，不记录令牌、账号、设计名称或内容。令牌本身只存哈希值。

Speckle 连接器（测试中、默认关闭）

把 3D 设计的墙、楼板、柱、梁、门窗与房间发送到 Speckle，或把 Speckle 上的一个版本接收进来作为参考网格。这项功能还在测试，正式站默认关闭；本站开启后，3D 建模器“文件 ▾”才会出现“Speckle（发送／接收）…”。

• 数据去向：数据会发送到你指定的 Speckle 服务器，依该服务的条款与隐私政策处理。默认是 app.speckle.systems，也可以填自建服务器（只接受 https）。你的浏览器直接连接，Synhedra 服务器不经手、不保存模型与令牌。
• 令牌：在 Speckle 的 Developer settings 创建一个只勾 streams:read 与 streams:write 的个人访问令牌，粘贴进对话框。令牌默认只在这个标签页（刷新或关闭就忘记）；勾“记住在这个浏览器”才存在这台电脑的 localStorage。“忘记令牌”立即清掉；要让它完全失效，请到 Speckle 撤销。
• 发送什么：墙、幕墙、楼板、柱、梁、门窗、房间的网格（米、Z 向上），以及名称、类别、楼层、类型、材料与 lsm:id；家具与其他对象不发送。不发送项目信息、业主、地址、账号或分享链接。版本信息由你填写。可以只发送选中的对象。
• 接收：选一个版本，网格会作为参考对象放进 3D（不计容积、不能编辑成墙或楼板），按一次撤销就能全部拿掉。只支持 Speckle 2026.9 以前格式的版本；2026.9 起的新格式（bundle）会明确告诉你还不能读。
• 自建服务器：服务器要允许本站的跨域请求（CORS），本站的安全设置（CSP）也要加入那个域名，否则浏览器会拦下连接，对话框会说明是哪一种原因。
• 上限：一次最多 20,000 个元素、200 万个顶点（内存较小的电脑更少）；接收最多下载 150 MB、10 万个对象、500 万个顶点。超时会停止并说明。

本机运算徽章与离线使用

• 本机运算徽章：3D、2D 与简易模式的顶栏右侧有“本机运算”。悬停或点击显示画面刷新率（fps）、最近一次图评估、法规与分析重算、日照分析的耗时，以及这次工作会话有没有把设计发送出去：云端同步、分享、协同编辑、AI 各一行。
• 节点耗时：点击节点图标题栏的 ⏱（或徽章里的勾选）后，每张节点卡片显示上次计算的耗时。默认关闭，设置保存在这台电脑。
• 离线打开：在这个浏览器用过一次之后，没有网络也能打开首页，打开或新建保存在这台电脑的 3D、2D 设计（打开过工作区后，程序会在后台把工作区需要的文件存好）。
• 离线时：徽章显示“离线 · 本机运算”；分享与 AI 标示离线、不会发送，云端同步与实时协同在恢复连接后自动继续。还没下载到这台电脑的云端设计需要联网才能打开；帮助页、示例、地图底图与周边建筑离线时无法加载。
• 新版本：网站更新后画面下方出现“有新版本，重新加载”。点击“重新加载”才换新版（设计已自动保存），点击“稍后”继续使用当前版本。
• 缓存了什么：浏览器的 service worker 只缓存网站的程序文件（文件名含版本哈希）、首页、2D 文字用的字体与品牌图标（启动动画、logo），不缓存你的设计内容、账号数据、分享页或服务器 API 的响应；设计本来就保存在这个浏览器的本地存储里。

隐私摘要

完整内容见隐私声明。重点如下：

• 运算在浏览器：几何、法规与环境分析都在你的浏览器里计算，服务器不计算你的几何。
• 未登录只存本机：设计只保存在这台电脑的这个浏览器里。
• 登录后同步云端：登录并同意云端存储后，设计在后台同步到你的账号。
• 只有分享、共编、AI 会传出数据：除了云端同步，只有你创建分享链接、加入实时共编（已开放；共编时设计内容会发送到本站的协作服务器，按隐私声明保存与清除）或使用 AI 时，才会把那次需要的数据传出去。AI 目前使用 Google Gemini API 的未付费方案，Google 可能用发送的内容改进其产品。地图底图、周边建筑与地址查询会向图资服务获取数据，不含设计内容。
• 登录会存储什么：你的 Google 账户 ID（一串数字，不含电子邮件或姓名）、选填的职业与领域、同意的版本与时间、上次使用的时间，以及本月的 AI 使用次数。不会存储电子邮件、姓名、头像或 AI 提示词。
• 云端存储会存储什么：你的 3D 与 2D 设计、缩略图、名称、专案、单位与时间戳，存放在 Cloudflare R2（亚太地区）与 D1 中，以账户 ID 的哈希值作为索引。
• 分享会存储什么：分享的设计会存储你分享的那个设计及其备注，停止分享即删除。文件夹分享只存储分享记录（文件夹、权限、到期时间）；拿到链接的人读取的是你云端里的内容，通过可编辑链接写入的内容会保存在你的云端并计入你的存储容量，被覆盖的版本保留 30 天。撤回云端存储同意会停止全部文件夹分享。
• AI 会发送什么：图层、选取范围与统计摘要，绝不会发送整张图面。见 AI 面板 › 会发送哪些数据。
• 保存期限：账户连续 365 天未使用，会连同云端设计一起删除。已删除的设计可在 30 天内恢复。
• 你的权利：账户菜单提供“下载我的数据”与“删除我的账户”。删除账户时，会先删除所有云端设计。
• 服务器日志：Cloudflare 会将请求网址、IP 地址、时间与浏览器信息保留数天，用于调试和防止滥用。本站自己的日志只含元数据。
• 第三方服务：底图与周边建筑数据的来源列在数据来源与方法。