发布到 Wiki 应用站点
巴克励步
概述
知识库中的文档保存在 内容源;访客在前台 Wiki 站点看到的内容,须通过 发布 将知识库同步到已绑定该库的 Wiki 应用。一篇知识库可绑定多个 Wiki 应用(如中文站、英文站、内网预览站),应用发布 页会列出所有引用本库的应用及其同步状态。
操作步骤
步骤一:保存知识库文档
- 在 文档编辑器中完成撰写或修改。
- 点击右上角 保存,或等待自动保存成功提示。
- 可选:切换 阅读模式 预览渲染效果(见 文档编辑器功能参考)。
预期结果:文章已写入知识库;此时前台 Wiki 尚未 必然更新。
步骤二:进入应用发布页
- 在知识库左侧边栏底部点击 发布。
- 进入 应用发布 页面。

页面自上而下包括:
- 顶部 绿色引导区:标题为「应用发布:让知识库对外可访问」,说明可将本知识库同步到一个或多个 Wiki 站点,对外提供文档、FAQ、帮助中心等访问。
- 下方 已发布的站点:列出当前已绑定本知识库为内容来源的 Wiki 应用卡片。
预期结果:若已有绑定应用,已发布的站点 中显示各 Wiki 卡片;若尚无应用,主要见引导区与 前往应用市场创建 Wiki 站点 按钮。
步骤三:首次绑定 Wiki 应用
若 已发布的站点 为空,需按页内引导完成首次绑定。
- 阅读绿色引导区 第一步 说明:先在 应用市场 创建一个 Wiki 站点并选择模板,然后在站点中将 本知识库 选为内容来源。
- 点击引导区右侧 前往应用市场创建 Wiki 站点,进入应用库安装 Wiki 模板(亦见 创建您的第一个应用)。
- 创建应用时选择 数据源 为本知识库,或于应用 基本设置 中指定知识库(见 应用基本设置)。
- 返回知识库 应用发布 页,已发布的站点 中应出现新创建的 Wiki 应用卡片。
💡
提示:一个 Wiki 应用通常对应一个对外站点;中文与英文可分别创建两个应用并绑定不同知识库空间,见 多语言多站点配置。
预期结果:已发布的站点 至少有一条 Wiki 应用记录。
步骤四:查看已发布站点与同步状态
在 已发布的站点 列表中,每张卡片通常展示:
信息 | 说明 |
|---|---|
应用名称与 WIKI 标签 | 如 AI Chat、Product Wiki V3.0 |
最近同步于 | 上次成功同步的时间;知识库有变更未推送时,可能显示为数月前 |
数据已过期(红色) | 知识库内容已更新但尚未同步到该 Wiki 应用 |
立即同步 | 卡片底部按钮,将知识库内容推送到该应用 |
可点击卡片进入对应站点后台,查看访问情况或调整站点设置。
预期结果:能识别哪些站点 数据已过期、各自 最近同步于 何时;无过期提示表示该站点与知识库内容一致(以界面状态为准)。
步骤五:立即同步
- 在目标 Wiki 应用卡片上点击 立即同步。
- 等待任务完成;数据量大时可在后台继续,稍后刷新 应用发布 页查看 最近同步于 是否更新。
- 同步成功后,数据已过期 提示应消失;通过应用 前台访问 或已绑域名验证页面内容。
预期结果:最近同步于 更新为近期时间;前台 Wiki 可见最新目录与正文。
步骤六:验证前台与预览
- 在应用后台打开 前台访问(见 访问与预览),或访问已绑定的自定义域名。
- 抽检刚修改的页面:标题、正文、图片、内链是否正常。
- 若站点启用了 访问控制,用访客账号或无登录状态分别验证授权逻辑(见 访问控制与授权)。
预期结果:前台内容与知识库一致;未同步前的草稿不会泄露到公开站点(以访问控制配置为准)。
步骤七:多应用与变更管理
同一知识库绑定多个 Wiki 应用时,每次内容变更后需对 各应用分别点击立即同步(或按产品当前支持的批量操作),方可使所有站点同步。
场景 | 建议 |
|---|---|
仅内网预览站更新 | 只同步绑定内网域名的应用 |
生产与 staging 双应用 | 先在 staging 同步验证,再同步生产 |
大规模目录调整 | 同步前 导出备份,见 导入与导出 |
AI 翻译后的语言站 | 译文保存后,同步对应语言的 Wiki 应用,见 AI 翻译 |
预期结果:各站点内容与预期环境一致;重大变更可追溯操作日志(应用侧见 事件统计与操作日志)。
常见问题
Q:保存了为什么前台没变?
A:保存 只更新知识库;必须完成 立即同步 且目标 Wiki 应用绑定的是该知识库,前台才会更新。若卡片显示 数据已过期,说明尚未同步。
A:保存 只更新知识库;必须完成 立即同步 且目标 Wiki 应用绑定的是该知识库,前台才会更新。若卡片显示 数据已过期,说明尚未同步。
Q:「数据已过期」是什么意思?
A:表示知识库内容比该 Wiki 应用上的数据新,访客看到的仍是旧版;点击 立即同步 即可更新。
A:表示知识库内容比该 Wiki 应用上的数据新,访客看到的仍是旧版;点击 立即同步 即可更新。
Q:发布会影响 URL 吗?
A:多数 Wiki 模板按文档 ID 路由,移动目录树通常不改变 URL;换模板或改 slug 规则时请以当前主题为准,同步后务必点验链接。
A:多数 Wiki 模板按文档 ID 路由,移动目录树通常不改变 URL;换模板或改 slug 规则时请以当前主题为准,同步后务必点验链接。
Q:CMS 应用也需要从知识库发布吗?
A:CMS 类应用 在应用后台直接管理页面,不经过知识库发布流;本章仅适用于 Wiki 类应用。
A:CMS 类应用 在应用后台直接管理页面,不经过知识库发布流;本章仅适用于 Wiki 类应用。
Q:与「应用后台发布」有何区别?
A:知识库 应用发布 是将内容 推送到 已绑定 Wiki 应用的数据源;部分模板在应用侧还有缓存刷新或静态化步骤,以应用文档为准。
A:知识库 应用发布 是将内容 推送到 已绑定 Wiki 应用的数据源;部分模板在应用侧还有缓存刷新或静态化步骤,以应用文档为准。
相关阅读
- 文档编辑器发文 — 撰写、保存与发布概要
- 创建与管理知识库空间 — 创建空间与绑定关系
- 文档目录树 — 目录树与移动复制
- 知识库设置 — 知识库成员与 Webhook
- 导入与导出 — 批量迁入与备份
- AI 翻译 — 多语言正文翻译
- 创建您的第一个应用 — 创建 Wiki 应用
- 访问与预览 — 验证前台效果
- 多语言多站点如何配置? — 多语言 FAQ