2. Confluence核心概念
要真正把 Confluence 用成企业知识库，而不是“另一个网盘”，必须先理解它的对象模型。Confluence 的内容不是散落的文件，而是被组织在一套有层级、有归属、有权限边界的结构里。理解这套结构，后续的建库、迁移、权限设计和自动化才有依据。
空间：知识库的顶层容器
空间（Space）是 Confluence 中最大的内容容器，也是权限、导航和检索的基本边界。每个空间有独立的首页、独立的权限设置、独立的页面树。企业通常按“组织维度”或“主题维度”划分空间：前者如“研发中心”“市场部”，后者如“产品文档”“运维手册”。两种划分各有代价——按组织划分便于权限继承，但跨部门知识容易割裂；按主题划分便于检索，但权限会变复杂。实践中常见做法是“主题为主、组织为辅”，例如建立 DOCS（产品文档）、OPS（运维知识）、HR（人事制度）等空间，再用权限组控制可见范围。
空间分两类：站点空间（Site Space） 和 个人空间（Personal Space）。个人空间以用户名命名，适合草稿和私人笔记，不应作为团队知识沉淀地。团队内容必须放在站点空间，否则人员离职后内容会随账号一起被清理。
页面：内容的基本单元
页面（Page）是 Confluence 最核心的内容载体。页面之间通过“父页面—子页面”形成树状结构，这棵树就是空间内的导航骨架。页面有版本历史，每次保存生成一个新版本，可对比、可回滚。页面还支持标签（Label），用于跨树聚合，例如给多个页面打上 onboarding 标签，就能在一个页面里用宏列出所有新员工必读内容。
页面树的设计直接决定知识库是否好用。一个常见反例是把所有内容平铺在空间首页下，导致导航超过三层、查找困难。推荐做法是：首页只放“入口卡片”，一级子页面按主题划分，二级子页面承载具体文档，单棵树深度控制在 3～4 层。页面标题应遵循统一命名规范，例如 [模块]-[类型]-[主题]，如 支付-接口文档-退款，便于搜索和排序。
博客：面向时间流的内容
博客（Blog）与页面共享同一套编辑器，但组织方式不同：博客按发布时间倒序排列，不进入页面树。它适合发布周报、版本发布说明、阶段性公告等“有时效性”的内容。博客同样可以打标签、加权限，但不应作为长期知识的主载体——因为时间流会不断把旧内容推到后面，不利于沉淀。
模板与宏：复用与增强
模板（Template）是预置的页面骨架，用于统一文档结构。例如“会议纪要模板”固定包含参会人、议题、决议、待办四段；“故障复盘模板”固定包含时间线、影响面、根因、改进项。模板分空间模板和全局模板，前者只在本空间可用，后者全站可用。使用模板能显著降低“每篇文档结构都不一样”的混乱。
宏（Macro）是嵌入页面的功能块，是 Confluence 从“文档工具”变成“知识平台”的关键。常用宏包括：目录宏（自动生成页面内目录）、状态宏（标记“草稿/评审中/已发布”）、信息/警告/提示宏（突出关键说明）、页面属性宏（结构化字段，可被报表宏聚合）、Jira 问题宏（嵌入需求或缺陷列表）、附件宏、子页面宏等。宏让页面具备动态聚合能力，例如用“页面属性报表宏”自动汇总所有标注了“负责人=张三”的页面。
权限模型：从空间到页面的收敛
Confluence 权限是“空间级 + 页面级”两层模型。空间权限决定“谁能进这个空间、谁能读、谁能写、谁能管理”，页面权限则在空间权限基础上做进一步限制。关键规则是：页面权限只能收紧，不能放宽。也就是说，如果某用户没有空间查看权限，即使单独给他某个页面权限，他也看不到该页面。因此权限设计应先定空间边界，再对敏感页面做局部限制。
权限通常授予“用户组”而非个人，便于批量管理。常见角色划分：confluence-users（普通用户）、space-admins（空间管理员）、viewers（只读组）。页面级限制应尽量少用，因为一旦页面被单独限制，其子页面默认继承该限制，容易造成“作者自己都找不到页面”的问题。建议只对薪酬、合同、安全事件等真正敏感的内容做页面级限制，并记录在权限台账中。
整体架构：对象如何协同
把上述对象串起来看：空间是容器，页面树是骨架，博客是时间流补充，模板保证结构一致，宏提供动态能力，权限控制可见与可写。它们共同构成 Confluence 的知识组织架构。下图展示了这一关系：
理解这张架构图后，可以提炼出几条落地原则。第一，先定空间边界，再建页面树。空间划分错了，后期迁移成本极高。第二，页面树深度控制在 3～4 层，超过四层说明分类维度需要重新设计。第三，模板先行。在团队开始大量写文档之前，先把会议纪要、需求文档、故障复盘三类模板建好，能避免后期大规模返工。第四，权限从宽到严。默认给 confluence-users 查看权限，只对敏感内容做页面级限制，并定期审计权限台账。第五，善用宏做聚合。用页面属性宏 + 报表宏自动生成“待办清单”“负责人视图”，比手工维护列表可靠得多。
最后需要强调，Confluence 的对象模型是“空间—页面—博客—模板—宏—权限”六位一体的。单独理解任何一个对象都不难，难的是理解它们之间的约束关系：页面属于空间，博客不属于页面树，模板作用于页面创建，宏嵌入页面内容，权限从空间向页面收敛。把这层关系理顺，后续的建库、迁移、自动化和治理才有稳定的基础。