Figma 是设计与原型协作工具，ONES Wiki 支持通过 Figma 分享链接在文档中嵌入并查看设计内容。当嵌入内容只对部分成员不可见时，需要先分清是嵌入链接配置问题，还是成员对 Figma 源文件的访问权限问题。本文依据 ONES 国内版公有云产品手册中的 Wiki 嵌入流程撰写，私有部署环境按文中条件参考；受限分享与企业登录场景下的实际显示表现尚待核验，文中会明确标注。
要点总览（TL;DR）
- 先看影响范围：所有成员都看不到，优先查嵌入链接来源与插入方式；只有部分成员看不到，优先查 Figma 源文件权限与登录状态。
- ONES Wiki 的 Figma 嵌入是查看型集成，展示的是源文件内容，源文件权限依然生效，嵌入不会绕过受限分享或组织访问规则。
- 用“同一链接换人验证”和“同一人换链接验证”交叉定位：换人后仍不可见指向链接，换链接后仍不可见指向成员身份或账号。
- 处置按风险从低到高：先复核链接并重新插入，再确认成员登录与访问权，最后由文件所有者评估是否调整分享范围。
- 受限分享与企业登录场景下的嵌入显示尚待实测，排查结论应保留待确认标注，不把某一种浏览器设置当作确定解法。
症状与范围：先分清“全员不可见”还是“部分成员不可见”
排查的第一步是确定影响范围。同一个 Wiki 页面里的 Figma 嵌入，是所有人都看不到，还是只有部分成员看不到，这两类现象指向的方向不同。范围判断清楚，后面的验证才有针对性，避免一上来就改分享设置，把权限范围扩大。
需要先建立一个基本认识：ONES Wiki 中的 Figma 嵌入是查看型集成，用于在文档中嵌入并查看 Figma 设计内容。嵌入展示的是 Figma 源文件的内容，源文件权限依然生效，嵌入不会绕过 Figma 的受限分享或组织访问规则，部分场景下还可能要求成员登录 Figma。因此“Wiki 页面能打开”与“嵌入内容能看到”是两个层面的问题。
| 现象 | 可能方向 | 下一步验证动作 |
|---|---|---|
| 所有成员打开同一 Wiki 页面，嵌入区域都为空或无法显示 | 嵌入链接来源或插入方式有问题 | 复核链接是否为 Figma 文件分享链接，按 Wiki 工具栏 Figma 方式重新插入 |
| 部分成员能看到，部分成员看不到 | 看不到的成员缺少 Figma 源文件访问权，或未登录 Figma | 让不可见成员确认登录状态与源文件访问权 |
| 同一成员在不同时间看到的结果不一致 | 登录状态变化，或源文件分享范围被调整 | 核对源文件当前分享范围与组织访问规则 |
| 成员能看到部分 Figma 文件，另一些看不到 | 不同源文件的分享范围不同 | 逐个核对对应源文件的分享设置 |
本文适用前提为 ONES 国内版公有云产品手册所述的 Wiki 嵌入流程，私有部署环境按文中条件参考。文中未对目标环境做实测，涉及受限分享、企业登录的具体显示表现，需要在自身环境中验证后再下结论。
原因假设与排除证据：链接问题与权限问题各看什么
区分链接问题与权限问题，核心是看证据落在哪一层。链接问题表现为嵌入本身没有正确建立，与谁来看无关；权限问题表现为嵌入已建立，但个别成员因 Figma 侧的身份或授权不足而看不到内容。下面按三类假设分别列出验证证据。
假设一：链接来源或粘贴方式不对
按手册流程，正确做法是复制 Figma 文件分享链接，在 Wiki 编辑工具栏选择 Figma，粘贴链接并确认。如果嵌入时粘贴的是浏览器地址栏中的其他地址、文件内部某个视图的地址，或者没有通过工具栏的 Figma 入口插入，嵌入就可能无法正常显示。这类问题的特征是全员不可见，与成员身份无关。
验证证据：检查嵌入块中保存的链接是否来自 Figma 分享入口；用同一链接重新按工具栏 Figma 方式插入一次，观察是否恢复。若重新插入后所有人可见，问题在链接配置，不在成员权限。
假设二：成员缺少 Figma 源文件访问权或未登录
嵌入文件仍遵循 Figma 源文件权限，可能要求用户登录。这意味着 Wiki 页面的访问权限不能替代 Figma 源文件的访问权限。成员能打开 Wiki 页面，但如果其 Figma 账号没有被授予该源文件的查看权，或者当前浏览器会话未登录 Figma，嵌入区域就可能不显示内容。这类问题的特征是部分成员不可见，且不可见成员往往集中在未参与该设计文件协作的人群。
验证证据：让不可见成员确认自己已登录 Figma，并确认其账号在源文件的分享范围内；对照可见成员与不可见成员在 Figma 侧的权限差异。
假设三：组织访问规则或受限分享设置拦截
Figma 侧的受限分享设置或组织访问规则，可能限制特定账号、特定域名或企业外成员查看文件。嵌入不会绕过这些规则。这类问题的特征是同一文件对某些群体整体不可见，例如外部协作者全部看不到。
验证证据：由文件所有者查看源文件当前的分享范围设置，确认不可见成员是否落在被限制的范围内。需要注意，受限分享与企业登录下的嵌入显示尚待实测，不能把某一种浏览器设置当作必定有效的解决方案。
交叉验证：换人、换链接、换登录状态
把三类假设放在一起，可以用两组交叉验证快速定位：
- 同一链接换人验证：让一位确认有源文件权限的成员和一位不可见成员，分别打开同一 Wiki 页面。若前者可见、后者不可见，方向指向权限或登录；若两人都不可见，方向指向链接。
- 同一人换链接验证：让不可见成员分别打开一个已知正常的 Figma 嵌入和一个出问题的嵌入。若前者可见、后者不可见，方向指向该嵌入的链接或该源文件的分享设置；若都不可见，方向指向该成员自身的 Figma 登录或账号状态。
| 原因假设 | 验证证据 | 判定结论 |
|---|---|---|
| 链接来源或粘贴方式不对 | 重新按工具栏 Figma 方式插入后全员可见 | 链接问题，修正嵌入即可 |
| 成员缺少源文件访问权或未登录 | 有权限成员可见、无权限成员不可见；登录后恢复 | 权限问题，需在 Figma 侧授权 |
| 组织访问规则或受限分享拦截 | 同一群体整体不可见，分享范围设置中可查到限制 | 权限问题，需文件所有者调整分享范围 |
按顺序处置：从链接复核到权限核对
处置顺序按风险从低到高安排：先做不影响任何人的链接复核，再让成员自查登录与访问权，最后由文件所有者评估是否调整分享范围。每一步都有明确的操作者和停止点，避免在未确认原因前扩大可见人群。
第一步：复核嵌入链接并重新插入
操作者为 Wiki 页面编辑者。打开出问题的 Wiki 页面，检查嵌入块中的链接来源，确认它是 Figma 文件分享链接。然后按手册流程重新操作：复制 Figma 文件分享链接，在 Wiki 编辑工具栏选择 Figma，粘贴链接并确认。完成后请一位原本不可见的成员刷新页面查看。
停止点：若重新插入后全员可见，问题已解决，无需进入后续步骤；若仍全员不可见，继续排查链接是否来自正确的分享入口，以及该 Figma 文件本身是否可正常打开。
第二步：确认成员 Figma 登录状态与源文件访问权
操作者为不可见成员本人，必要时由设计文件所有者协助核对。不可见成员先确认当前浏览器已登录 Figma，且登录账号就是被授权访问该源文件的账号；再确认该账号在源文件分享范围内。若成员使用多个账号，容易出现在 Wiki 中登录的是 A 账号、被授权的是 B 账号的情况。
停止点：成员登录并确认有访问权后重新打开 Wiki 页面，若恢复可见，问题已解决；若仍不可见，进入第三步核对分享范围与组织规则。
第三步：核对源文件分享范围与组织访问规则
操作者为 Figma 源文件所有者。查看源文件的分享设置，确认不可见成员是否被受限分享或组织访问规则排除在外。这一步涉及权限变更，风险边界需要明确：调整分享范围会扩大可见人群，必须由文件所有者确认后再操作，并记录调整前后的范围。若组织规则由管理员统一配置，应先与管理员确认规则内容，再决定是否申请例外。
停止点：分享范围调整后，请原不可见成员重新验证。若仍不可见，且受限分享或企业登录场景尚未排除，应记录该场景并在自身环境中做一次对照实测，不把某一种浏览器设置当作确定解法。
需要说明的是，上述处置围绕嵌入查看展开，不涉及工作项与设计内容的双向同步，也不改变 Figma 源文件本身的协作方式。
验证恢复与复发预防
处置完成后，验证要以最初报告问题的成员为准，而不是以编辑者自己的视角判断。让原不可见成员重新打开同一 Wiki 页面，确认嵌入区域能正常显示设计内容，并请其确认看到的是当前版本的源文件。若涉及多位成员，逐一确认，避免只验证了个别账号就宣布恢复。
恢复验证清单：
- 原不可见成员使用日常账号重新打开同一 Wiki 页面，嵌入内容可见；
- 可见成员再次打开，确认未因分享范围调整出现异常；
- 记录本次问题的原因归类（链接、登录、访问权或分享范围），便于同类问题快速对照；
- 若调整过分享范围，记录调整前后的范围与确认人。
复发预防可以从两个约定入手。其一，嵌入时在 Wiki 页面或协作说明中记录源文件名称与当前分享范围，让后续维护者知道这个嵌入依赖哪份文件、面向哪些人。其二，源文件分享范围发生变更时，由文件所有者同步通知使用该嵌入的 Wiki 页面维护者，提前评估是否会影响已有读者。
仍有待核验的部分：跨企业登录、受限分享场景下的嵌入显示表现，需要在自身环境中实测确认。在这些场景得到验证之前，排查结论应保留“待确认”的标注，不把推测写成定论。
常见问题
所有成员都看不到嵌入内容，还需要逐个核对 Figma 权限吗？
不需要先做权限核对。全员不可见更可能出在嵌入本身：链接是否来自 Figma 文件分享入口、是否通过 Wiki 编辑工具栏的 Figma 入口插入。按手册流程重新插入一次，若全员恢复可见，问题就在链接配置，与成员权限无关。重新插入后仍全员不可见，再检查该 Figma 文件本身能否正常打开。
成员能打开 Wiki 页面，为什么看不到嵌入的 Figma 内容？
Wiki 页面访问权限与 Figma 源文件访问权限是两个层面。嵌入文件仍遵循 Figma 源文件权限，可能要求用户登录，嵌入不会绕过受限分享或组织访问规则。成员能打开页面，但其 Figma 账号未被授予该源文件查看权，或当前会话未登录 Figma，嵌入区域就可能不显示内容。
调整 Figma 源文件分享范围前要注意什么？
调整分享范围会扩大可见人群，属于权限变更，应由文件所有者确认后操作，并记录调整前后的范围与确认人。若限制来自组织统一配置的访问规则，先与管理员确认规则内容，再决定是否申请例外。调整后请原不可见成员重新验证，而不是由编辑者自己判断。
受限分享或企业登录场景下排查不出结论，怎么办？
这类场景下的嵌入显示表现尚待实测，不能把某一种浏览器设置当作必定有效的解法。建议在自身环境中做一次对照实测：用同一链接分别在有权限与无权限账号、登录与未登录状态下打开同一 Wiki 页面，记录差异。在结论得到验证前，保留“待确认”标注，不把推测写成定论。
嵌入查看正常后，如何减少同类问题再次出现？
嵌入时在 Wiki 页面或协作说明中记录源文件名称与当前分享范围，让后续维护者知道这个嵌入依赖哪份文件、面向哪些人。源文件分享范围变更时，由文件所有者同步通知使用该嵌入的 Wiki 页面维护者，提前评估是否影响已有读者。需要说明的是，这属于查看型集成，不涉及工作项与设计内容的双向同步。
官方参考资料
- 插入 Figma（ONES）
- Embed files and prototypes（Figma）
