最佳实践

WIKI：Confluence 与语雀选型、权限和知识交接

对候选知识平台建立统一内容责任、敏感分级、导出抽验和迁移验收，不承诺自动双向同步。

WIKI：知识责任、候选选型与交接

原图列出 Confluence 和语雀，本方案将其解释为 WIKI 候选，不要求同时购买或部署，更不承诺自动双向同步。站点本身的知识与项目文档仍是当前可阅读的内容入口；外部 WIKI 是否选用，需要根据协作方式、部署要求、权限、导出能力及许可决定。

Confluence 需区分 Cloud 与其他实际部署形态，不能把 Cloud 的导出方法套给自管理服务。语雀官方介绍将其定位为团队文档与知识管理工具，具体企业空间权限和可导出内容还需在所选套餐及实际账号中验证。语雀空间介绍

先指定知识平台负责人、空间或知识库所有者、文档维护人及备份责任人。按公开知识、团队内部、受限操作和敏感审计划分内容，真实口令、令牌、私钥、生产日志原文及客户数据不得进入通用运行手册。

确定每类内容的权威来源：代码和配置以仓库为准，需求状态以禅道为准，API 契约以已批准来源为准，WIKI 保存背景、操作流程和证据索引。相同文档在多平台出现时标明主副本与更新方式，不能让两处都可编辑却没有冲突处理规则。

先选择一个非敏感项目建立试点知识库，创建概览、架构依赖、日常巡检、故障处置、备份恢复和交接六类文档。每篇至少写明适用环境、负责人、前置条件、操作风险、验收证据、停止条件、更新时间和下次复核触发事件。

接入过程验证普通阅读者、维护者、外部协作者和无权限用户的不同视图。共享链接必须明确受众与有效期；嵌入图片、附件及子页面分别检查权限，不能只检查正文。跨产品的登录、成员同步和外部链接访问都保留待验证状态。

检查过期手册、失效链接、离职维护人、无人负责知识库以及公开分享变动。发布后更新实际制品、配置和恢复约束，重大事故后把临时处置结论转化为可复用步骤，同时保留适用范围和未验证项。

值班交接必须能从服务入口找到当前告警、关键依赖、应急联系人和最近一次变更。审阅运行命令时核对目标环境及副作用，标记哪些检查只读、哪些必须批准，不让旧文档的生产写操作在新环境里被误执行。

用户看不到文档先核对空间权限、页面限制、成员状态和分享入口，不通过全库公开来解决。正文可见而附件失效时检查附件来源、授权和迁移映射。多个副本内容冲突则暂停自动覆盖，回到权威来源与变更记录逐项对账。

外部 WIKI 不可用时，值班应有经过批准的最小应急资料副本，包含联系人和恢复索引但不夹带明文密钥。知识迁移中发现内容截断、图表丢失或权限扩大，保留原平台只读入口并停止切换，而不是删除原文后再修补。

Confluence Cloud 的内容导出支持的格式、权限和范围有明确约束，导出结果不能默认等同完整站点灾备。Confluence Cloud 导出说明

本方案要求分别核对正文、附件、目录层级、内部链接、评论、历史版本和权限是否可导出及恢复。语雀对应能力需在目标空间实际验证，未验证项明确记录，不宣称任何格式保留全部特性。自管理系统还要单独设计数据库、附件和配置的备份；托管平台则确认供应方恢复责任及团队自行保存的范围。

以一组含长文、表格、附件、内部链接和受限页面的样本验证查找、阅读、编辑、拒绝访问和导出恢复。让未参与编写的值班人员按手册定位一次模拟故障，记录无法理解或缺少前提的步骤。出现敏感内容外泄、权限迁移不明、核心附件不可恢复或权威副本不清时，停止扩大迁移。

选型时使用上述官方说明并在目标产品形态上补齐证据，本手册未购买服务、创建外部知识库或同步任何真实组织内容。可返回企业运维平台总览，按交付链和事件证据链检查全部 14 项能力的文档责任是否完整。