# 知识库

组织共有的知识库：按「知识库」分树存放页面，多人同时写、实时合并，没有保存按钮；可按成员、部门、角色或全员授权，也可单独限制某页的访问。

## 谁能用

能否使用知识库由功能权限点与页面或知识库上的访问名单级别共同决定，两者同时生效，缺一不可。

组织未自管业务角色时的默认权限分配如下（管理员始终可以调整授权）：

| 权限点 | 默认持有角色 | 可操作内容 |
|---|---|---|
| 「使用知识库」 | 成员、分析员、审计员 | 打开、搜索、导出自己能看到的页面 |
| 「编辑页面」 | 成员 | 在自己拥有「编辑」级别的页面上修改正文、新建子页面、调整页面排序 |
| 「管理页面」 | 成员 | 在自己拥有「管理」级别的页面或知识库上修改权限、移动、移到回收站、恢复 |
| 「新建知识库」 | 无（仅管理员；可授予业务角色） | 新建知识库，新建者自动成为该知识库的管理者 |
| 「知识库管理员」 | 无（仅管理员） | 查看并管理全部知识库与页面 |

页面与知识库设有四级访问名单：

| 访问级别 | 界面显示 | 可操作内容 |
|---|---|---|
| 查看 | 「可查看」 | 打开页面、搜索、复制链接、复制为 Markdown、打印 |
| 评论 | 「可评论」 | 名单中若已有此级别会显示；邀请下拉中未提供此选项；行内评论界面暂未提供 |
| 编辑 | 「可编辑」 | 修改标题与正文、添加或更换图标与封面、新建子页面、套用模板 |
| 管理 | 「可管理」 | 修改访问权限、移动、移到回收站、恢复、彻底删除、修改知识库设置 |

特殊情况说明：
- 组织管理员或持有「知识库管理员」权限的成员：可以打开不在自己权限名单中的页面；此时顶栏会显示提示「你以管理员身份查看这个页面（你不在它的权限名单里），这次查看会记入审计。」。助手在代为查询时不会越权。
- 审计员：持有「使用知识库」权限，但仍受具体页面名单限制，不会越权查看未授权页面。
- 助手：在对话中代你打开页面时仅为只读，不能直接写入正文，且不会产生「最近访问」记录。
- 页面打不开时：系统一律提示「页面不存在，或你没有查看权限」，不区分是不存在还是无权限。知识库首页打不开时同样提示「知识库不存在，或你没有查看权限」。

## 怎么打开

1. 进入[工作台](/guide/workspace)，在左侧进入「知识与文件」套件，点击「知识库」标签（知识库为套件内的必装应用，只有一个标签入口）。
2. 在浏览器中直接输入地址访问：`https://wiki.apps.{你的域名}/`。

进入应用后，可从侧栏打开主页、某个知识库、某篇页面、搜索或回收站。手机与窄屏上，分享弹窗会改成从底部滑出的「分享」面板；封面与图标的「更换」和「添加」在触屏上常显，不必悬停。

## 界面一览

![「知识库」的「主页」](/shots/wiki-home.webp)

图：「知识库」的「主页」

1. 侧栏「主页」：回到知识库总览
2. 「新建文档」：选知识库和上级页面后创建
3. 知识库卡片：点开进入该知识库首页
4. 按标题筛选当前列表
5. 「最近编辑」：刚写过的页面

![知识库首页与侧栏页面树](/shots/wiki-space.webp)

图：知识库首页与侧栏页面树

1. 知识库名称：概况、页面列表与最近编辑
2. 「新建文档」：在这个知识库顶层新建

| 区域 / 页面 | 主要内容与功能 |
|---|---|
| 侧栏 | 顶部展示标题「知识库」与「快速查找（⌘K）」按钮；在拥有可写知识库时提供「+」新建下拉（包含「空白文档」「Word 文档」「新建 Excel 表格」「新建 PowerPoint 演示文稿」「从模板…」「导入 Word 文档…」「导入 Excel 表格…」「导入 PowerPoint 演示文稿…」「新建知识库」）；包含「主页」、可折叠的「最近」与「收藏」区、知识库目录树（拥有权限时树底显示「新建知识库」按钮）；知识库根节点菜单提供新建、导入、模板以及「知识库设置」（无管理权时显示「成员」）；页面行提供「+」（在此下新建子文档）与「…」菜单（包含「重命名」「复制链接」「复制页面」「移动到…」「收藏」/「取消收藏」「移到回收站」）；父级不可见时提示「上级不可见」；底部提供「回收站」与「设置」。 |
| 「主页」 | 标题为「知识库」，右上角提供「新建文档」按钮与「更多新建方式」下拉；展示知识库卡片（无简介时显示「还没有简介」，提供虚线卡片「新建知识库」）；提供「最近访问」「最近编辑」（上限提示「只显示最近 100 条」）与「收藏」三个页签；提供「按标题筛选」输入框与「全部知识库」筛选下拉；列表项展示知识库名称与访问时间；空态下提供新建文档或新建知识库的指引按钮。 |
| 知识库首页 | 展示知识库概况；打不开时提示「知识库不存在，或你没有查看权限」并提供「返回」按钮；已归档知识库显示「已归档」徽标；提供「新建文档」按钮及「…」菜单（管理者显示「知识库设置」，普通成员显示「成员」）；展示「页面」列表与「最近编辑」区块，列表项标注子页面数量；空库时按权限展示新建第一篇文档或只读提示。 |
| 富文本页面 | 顶栏提供「分享」、星标「收藏」/「取消收藏」以及「…」菜单（包含「页面历史」「复制链接」「复制为 Markdown」「打印」、版面宽度切换「标准宽度」/「全宽」、「新建子文档」「移动到…」「移到回收站」）；标题占位显示「无标题」；正文为空时显示「用模板开始」及对应模板名；正文下方包含「子页面」与「被提及于」区块；没有保存按钮，支持多人同时编辑与实时合并；页面内容超限时提示「这个页面已达到大小上限，现在只能查看。请把内容拆到子页面。」；已归档知识库页面展示归档只读横幅；权限被移除时提示「你已没有这个页面的访问权限」与「权限已调整，或页面被移到回收站。」。 |
| Word / Excel / PowerPoint 页面 | 顶栏提供「下载」（可下载为 `.docx`、`.xlsx`、`.pptx` 文件），PowerPoint 页面额外提供「放映」按钮；「…」菜单包含「重命名」与「移到回收站」，只读状态显示「只读」；提供专业表格与幻灯片右键操作菜单；编辑不支持的内容时提示「这部分内容暂不能协同编辑，改动只在你这里可见」或「有内容太大或链接地址不被允许，没有共享给其他人」；Excel 菜单提示「图片和图表暂不能协同编辑」；部分写操作不被支持时提示暂不支持该操作。 |
| 快速查找（⌘K） | 浮层标题为「快速查找」，搜索框占位显示「搜索页面标题和正文…」；按「最近」「操作」「页面」「正文」四个分组展示搜索结果；无匹配时提示「没有找到匹配的页面」；提供快捷动作「新建文档」「新建知识库」「全文搜索」「打开回收站」；底部提示操作快捷键「↵ 打开」「⌘↵ 在新标签打开」「查看全部结果」。 |
| 「搜索」 | 标题为「搜索」，输入框占位显示「输入关键词」，支持在「全部知识库」中检索；提示「输入关键词后按回车。也可以在任何地方按 ⌘K 快速查找页面标题。」；无结果时提示没有找到关键词，并提供「在全部知识库中搜索」按钮；检索成功显示找到的页面数量，支持点击「显示更多」（最多展示 50 条）。 |
| 「回收站」 | 标题为「回收站」，说明保留 30 天，之后自动彻底删除；提供「搜索回收站」搜索框；空态提示「回收站是空的」；列表项展示包含子页面数量、「删除于」时间以及彻底删除倒计时（「即将彻底删除」「明天彻底删除」或具体剩余天数）；提供「恢复」与「彻底删除」操作按钮。 |

## 常用操作

### 新建空白文档

![「新建文档」对话框](/shots/wiki-new-doc.webp)

图：「新建文档」对话框

1. 「知识库」：放到哪一个知识库
2. 说明：选知识库和父页面；不选页面则放在顶层
3. 「筛选页面」：按标题缩小上级页面
4. 「上级页面」：不选则放在该知识库顶层
5. 「新建文档」：创建后光标停在标题

1. 在左侧侧栏点击顶部「+」并选择「空白文档」，或在知识库根行点击「…」选择「新建文档」，或在主页点击右上角「新建文档」，或按 ⌘K 选择快捷动作「新建文档」。若需要在某篇文档下创建子文档，也可在侧栏页面行尾点击「+」（在此下新建子文档），或在页面正文输入 `/` 选择「新建子页面」。
2. 若在主页点击「新建文档」且未预选位置，系统会弹出「新建文档」对话框（说明「选知识库和父页面；不选页面则放在顶层。」）：
   | 字段 | 必填 | 说明 |
   |---|---|---|
   | 「知识库」 | 是 | 选择要存放新文档的目标知识库 |
   | 「筛选页面」 | 否 | 输入关键词筛选上级页面 |
   | 「上级页面」 | 是 | 选择具体的父级页面；选择顶层项则直接放在该知识库根目录 |
3. 点击「新建文档」（或点击「取消」）。
4. 目录树中生成新页面，光标自动定位在标题输入框，标题占位显示「无标题」。
5. 直接开始输入内容。页面没有保存按钮，所有修改实时自动合并与保存。

### 新建 Word、Excel 或 PowerPoint 页面

1. 在主页右上角点击「新建文档」旁的「更多新建方式」下拉菜单，或在侧栏顶部点击「+」。
2. 点击「Word 文档」、「新建 Excel 表格」或「新建 PowerPoint 演示文稿」。创建过程中主按钮会显示「正在创建…」。
3. 创建完成后进入对应编辑器。
4. 如需将文件导出到本地，点击顶栏右上角「下载」，可下载为对应的 `.docx`、`.xlsx` 或 `.pptx` 文件；PowerPoint 页面还可在顶栏点击「放映」。

### 从模板新建文档

1. 在侧栏顶部「+」菜单中选择「从模板…」，或在知识库根节点「…」菜单中选择「从模板新建…」，或在空白页面正文中点击「用模板开始」旁的模板选项。
2. 系统弹出「从模板新建文档」对话框，说明新页面将继承所在位置的权限（若当前账号没有任何可写知识库，对话框提示「你还没有可以新建文档的知识库。」）。
3. 点击需要使用的模板卡片（卡片显示「正在新建…」）：
   | 模板名称 | 预置结构与内容说明 |
   |---|---|
   | 「会议纪要」 | 包含时间、参会人、议题、结论与待办 |
   | 「项目主页」 | 包含目标、范围、里程碑、成员与风险 |
   | 「操作手册」 | 包含适用范围、前置条件、步骤与回滚 |
   | 「制度」 | 包含目的、适用范围、条款与生效日期 |
   | 「常见问题」 | 包含问题与解答 |
   | 「复盘」 | 包含背景、过程、做得好的、可改进的与行动项 |
4. 页面创建成功后，模板内容会自动载入正文。

### 导入 Word、Excel 或 PowerPoint 文件

1. 在侧栏顶部「+」下拉菜单或知识库根行「…」菜单中，点击「导入 Word 文档…」、「导入 Excel 表格…」或「导入 PowerPoint 演示文稿…」。
2. 在本地文件选择器中选择文件并确认上传。
3. 导入完成后自动打开新页面，可进行在线协同编辑，也可点击顶栏「下载」重新导出。

> **注意**
>
> 导入文件有严格的大小与格式限制：
> - Word 文档大小上限为 40 MB。超限提示「文件太大，Word 文档最大 40 MB」；格式不正确提示「这个文件读不出来，可能不是 Word 文档（.docx）」；加密文件提示「受密码保护的文档暂不能导入」。
> - Excel 表格大小上限为 40 MB。超限提示「文件太大，Excel 表格最大 40 MB」或「表格太大，暂不能导入」；格式不正确提示「这个文件读不出来，可能不是 Excel 表格（.xlsx）」；加密文件提示「受密码保护的表格暂不能导入」。
> - PowerPoint 演示文稿大小上限为 100 MB。超限提示「文件太大，PowerPoint 演示文稿最大 100 MB」或「演示文稿太大，暂不能导入」；格式不正确提示「这个文件读不出来，可能不是 PowerPoint 演示文稿（.pptx）」；加密文件提示「受密码保护的演示文稿暂不能导入」。

### 新建知识库

1. 确认账号拥有「新建知识库」权限。在左侧侧栏底部点击「新建知识库」，或在主页知识库卡片区点击虚线卡片「新建知识库」，或在全局空态点击「从模板开始」。
2. 系统弹出「新建知识库」对话框（说明「页面默认继承这里的权限。」）。
3. 填写知识库信息：
   | 字段 / 选项 | 必填 | 说明 |
   |---|---|---|
   | 「名称」 | 是 | 填写知识库名称，字数在 1–60 字之间，占位提示「例如：产品部」 |
   | 图标 | 否 | 默认显示像素书本图标，点击可自定义更换 |
   | 「说明」 | 否 | 填写知识库简介，最多 500 字，占位提示「简介（可选）」 |
   | 「谁能看到」 | 是 | 访问范围三选一：<br>1. 「全员可查看」（所有人可看，你和你添加的人可编辑）<br>2. 「指定部门可编辑」（该部门包含下级成员可编辑，需进一步选择「部门」）<br>3. 「仅受邀成员」（仅你可见，之后可添加成员） |
   | 「从模板开始」 | 是 | 选择知识库结构模板：可选「空白」「产品知识库」「制度与流程」「新人手册」 |
4. 点击「新建知识库」（或点击「取消」）。
5. 创建成功后弹出提示「已新建知识库……」，新建者自动成为该知识库的管理者。

### 编辑正文与设置图标封面

![一篇制度页面](/shots/wiki-page.webp)

图：一篇制度页面

1. 面包屑：回到知识库首页
2. 「分享」：改谁能看、能编辑
3. 侧栏当前页面所在的树
4. 页面标题：没有保存按钮，改了即合并

1. 呼出斜杠菜单：在富文本正文空行输入 `/`，可按分组插入内容：
   - 「基础」：可选择「正文」「标题 1」「标题 2」「标题 3」「无序列表」「有序列表」「待办」「折叠块」「引用」「提示」「分隔线」。
   - 「插入」：可选择「表格」「图片」「代码块」。
   - 「引用」：可选择「提及…」「链接到页面」「业务对象卡片」「新建子页面」。
2. `@` 提及：在正文任意位置输入 `@`，可选择并引用页面、人员、业务对象或日期。
3. 添加与更换图标：
   - 将鼠标悬停在标题上方（触屏设备上常显），点击「添加图标」；已有图标点击后可「更换图标」。
   - 可以在搜索框输入关键词（占位提示「搜索图标，例如 文档、成长、财务」或「搜索，或粘贴任意 emoji」）；未找到时提示「没有找到，换个词试试」或「没有找到，换个词试试，或直接粘贴一个 emoji」。
   - 可以切换类型页签：「像素」「医疗」「Emoji」；包含「搜索结果」与「最近使用」分组（Emoji 底部包含「最近」分类）；支持点击「随机」选取图标，或点击「移除」删除图标。
4. 添加与更换封面：
   - 将鼠标悬停在标题上方，点击「添加封面」；已有封面悬停后可点击「更换封面」或「移除」。
   - 选择器提供场景预设分组，包含像素场景、医疗场景、「渐变」以及「组织封面」。
   - 可以在底部点击「上传图片」（上传中显示「正在上传…」）。单张图片最大 10 MB；上传失败提示「封面没有上传成功」。

### 分享与设置访问权限

1. 在页面顶栏点击右上角「分享」按钮。
2. 搜索并邀请成员：
   - 在「搜索成员、部门、角色…」输入框中查找成员、部门或角色。
   - 选择授予的访问级别：「可查看」「可编辑」或「可管理」（若历史已有条目为「可评论」会予以展示，但邀请下拉中不包含该选项）。
   - 点击「邀请」。
3. 访问名单在页面上展示为「有权访问」（在知识库设置中展示为「成员」），标明来源「来自……」，部门会显示「（含下级）」。
4. 独立权限开关：
   - 页面默认继承上级权限。若需要单独管控，开启「仅以下成员可访问」开关（说明「打开后不再继承上级的权限」）。
   - 开启后页面不再继承上级权限；关闭该开关后重新恢复继承上级。
5. 权限变动预演：修改权限影响访问范围时，系统会预先提示谁将能看到或不再能看到这些页面，核对后点击「确认」生效（或点击「取消」）。
6. 点击面板底部的「复制链接」可复制页面链接，成功提示「已复制链接」，失败提示「没能复制，请手动复制地址」；亦可点击「了解权限」查看权限规则。

### 移动与复制页面

- 移动页面：
  1. 在侧栏页面行点击「…」或在页面顶栏点击「…」，选择「移动到…」（也可在侧栏目录树中直接拖动）。
  2. 对话框说明「子页面一并移动，权限随新位置继承（已限制访问的页面保持原名单）。」。
  3. 若移动会导致页面访问权限发生变化，系统弹出提示「移动后，能看到这些页面的人会变化」，点击「仍然移动」确认。
- 复制页面：
  1. 在侧栏页面行点击「…」，选择「复制页面」。
  2. 系统复制当前页面的正文与图标（不包含子页面），新副本的访问权限与原页面保持相同。

### 收藏、搜索与导出

1. 收藏页面：点击页面顶栏的星标按钮，或在侧栏页面行点击「…」选择「收藏」或「取消收藏」。侧栏与主页的「收藏」区同步展示，最多可收藏 200 条。
2. 快速查找：在任何界面按下快捷键 ⌘K（或点击侧栏搜索按钮）唤起「快速查找」浮层，输入关键词搜索标题与正文；按回车键打开，按 ⌘↵ 在新标签页打开；也可点击「新建文档」「新建知识库」「全文搜索」或「打开回收站」。
3. 全文检索：在「搜索」页输入关键词后按回车执行搜索；若当前知识库无结果，可点击「在全部知识库中搜索」；结果列表支持点击「显示更多」（最多展示 50 条）。
4. 复制为 Markdown 与打印：在页面顶栏点击「…」，选择「复制为 Markdown」（提示「已复制为 Markdown」）或选择「打印」。富文本页面不提供导出 Word 按钮；Office 页面通过顶栏「下载」导出。
5. 调整版面宽度：在页面顶栏点击「…」，可自由切换「标准宽度」或「全宽」。

### 查看页面历史与恢复版本

1. 在页面顶栏点击「…」，选择「页面历史」。系统说明每个页面最多保留 100 个版本。
2. 手动保存版本：在「版本名称（可选）」输入框中填写版本名称，点击「保存版本」。版本类型包括「自动保存」「手动保存」「恢复前」「应用 Agent 草稿前」「回滚」。
3. 查看与对比历史版本：在「全部版本」列表中点击历史版本可进行查看（历史版本显示提示「这是过去的版本，只能查看。」），点击「对比上一版本」可对比变动内容。
4. 恢复版本：在选中版本的历史详情中，点击「恢复此版本」。系统弹出确认提示恢复到指定版本，并说明「当前正文会先存为一个版本。正在打开页面的人会立即看到恢复后的内容。」，点击确认后页面立即回滚到该版本。

### 移到回收站

1. 确认你拥有「管理页面」权限以及该页面或知识库的「可管理」级别。在侧栏页面行点击「…」或在页面顶栏点击「…」，选择「移到回收站」。
2. 系统弹出确认弹窗，提示「所有人立即无法打开；30 天内可恢复。」（若页面下包含子页面，提示若干个子页面一并移入）。
3. 确认后提示「已移到回收站」。若该页面被其他页面提及，提示「已移到回收站。它被……个页面提及，那些引用会显示为已删除。」。

### 从回收站恢复与彻底删除

1. 在左侧侧栏底部点击「回收站」。
2. 恢复页面：在列表中找到页面，点击「恢复」。恢复成功后提示「已恢复」或提示恢复了若干个页面；若原上级页面已被删除，系统提示「已恢复。原来的上级页面不在了，它放在了」「知识库的顶层」「。」。
3. 彻底删除页面：
> **危险**
>
>    在回收站列表中点击「彻底删除」，弹出确认弹窗，提示「页面、历史版本和图片将被删除，无法恢复。」（若含有子页面，提示连同子页面一并彻底删除）。确认后提示「已彻底删除」。任何对该页面拥有管理权的成员均可执行彻底删除（不限于页面创建者），彻底删除后数据无法恢复。

### 知识库设置与归档

1. 确认你为该知识库的管理者。在侧栏知识库根行点击「…」，选择「知识库设置」（普通成员在此处仅显示「成员」）。
2. 修改常规信息：在「常规」页签下修改知识库图标、「名称」（1–60 字）以及「说明」（简介，最多 500 字），修改后点击「保存」（提示「已保存」）或点击「还原」。
3. 管理成员名单：在「成员」页签下添加或移除成员、部门或角色，配置默认访问级别。修改时会预演权限影响，确认后生效。脚注提示「页面默认继承这份名单（限制过访问的页面除外）；部门包含下级部门。」，拥有管理权时显示「知识库至少要保留一位管理者。」。
4. 归档知识库：在「常规」页签下的归档区（说明「不再使用时可以归档：页面全部保留，只是不能再编辑。」），点击「归档」。系统弹出确认弹窗，提示「归档后从侧栏消失，页面变为只读，管理者可随时恢复。」。确认后提示「已归档」，知识库从侧栏隐藏，知识库首页打上「已归档」徽标，页面显示归档只读提示。
5. 恢复知识库：进入已归档的知识库设置，归档区显示「这个知识库已归档：页面只能查看。」，点击「恢复」，弹出确认弹窗提示「恢复后可继续编辑。」。确认后提示「已恢复」，知识库恢复正常编辑状态。

## 状态说明

### 页面状态流转

```
正常 ⇄ 回收站（保留 30 天，可恢复） → 彻底删除（不可恢复）
```

- **正常**：页面可正常被有权限的成员查看或编辑。
- **回收站**：移到回收站后，所有人立即无法打开该页面及其全部子页面。在回收站中保留 30 天，期间拥有管理权的成员可随时恢复；若原上级页面已被删除，恢复后的页面会自动置于知识库顶层。
- **彻底删除**：在回收站中超过 30 天自动彻底删除，或由管理者手动点击「彻底删除」。彻底删除后，页面正文、历史版本和图片将被永久清除，无法恢复。

### 知识库状态流转

```
正常 ⇄ 已归档（页面变为只读，管理者可随时恢复）
```

- **正常**：知识库展示在侧栏，页面可按权限正常编辑。
- **已归档**：知识库从所有人侧栏隐藏，内部所有页面变为只读状态，正在编辑的成员立即变为只读。管理者可随时在设置中点击「恢复」。

### 访问继承状态

```
继承上级 ⇄ 仅以下成员可访问（独立名单，不再继承上级）
```

- **继承上级**：默认状态。页面的访问名单自动继承所在知识库或父页面的配置。
- **仅以下成员可访问**：手动开启该开关后，页面与上级断开继承，仅保留面板中显式指定的成员名单。关闭开关后重新恢复继承。

### 协同连接与同步状态

多人协作过程中，当连接或同步发生异常时，顶栏会实时显示协同状态：

| 状态文字 | 含义与说明 |
|---|---|
| 「正在连接…」 | 正在与协同服务建立网络连接 |
| 「正在重新连接…」 | 网络中断，正在尝试重新建立连接 |
| 「正在同步…」 | 正在将本地修改与远端协同内容进行同步合并 |
| 「离线，修改保存在本机」 | 当前处于离线状态，编辑内容暂存在当前设备浏览器中 |
| 「离线，请勿关闭页面」 | 离线且存在未同步的数据，切勿关闭或刷新浏览器标签 |
| 「只读」 | 页面处于只读状态，不可输入或修改 |
| 「页面太大，只读」 | 页面内容超出系统大小上限，已被强制限制为只读，需将内容拆分至子页面 |
| 「有新版本，请刷新」 | 远端已生成新版本，需刷新页面加载最新内容 |
| 「同步出错，正在重新加载」 | 协同数据合并出现冲突或错误，系统正在自动重新加载 |
| 「已断开（权限变化）」 | 当前账号的访问权限已被调整或移除，协同连接已断开 |
| 「页面已移到回收站」 | 当前页面已被移入回收站 |
| 「页面已删除」 | 当前页面已被彻底删除 |
| 「应用已停用」 | 知识库应用已被组织停用 |

点击协同状态可展开弹层，查看「最后保存」时间、「待保存」状态以及未保存的修改处数，并可点击「复制未发送的修改」备份本地内容。

## 让助手帮你做

你可以在对话中让助手协助处理知识库的常见事务。根据操作的风险等级，助手的执行方式有所不同：

- **起草后确认**：对于新建或修改类操作，助手会先为你生成[草稿](/agent/drafts)，由你在平台 Agent 应用中审阅并确认后应用：
  - 新建页面
  - 修改页面正文
  - 修改页面图标、封面与版面宽度
  - 从模板新建文档
  - 修改个人通知偏好
  - 新建知识库
  - 修改知识库常规设置
- **执行前需确认**：涉及访问权限变更、删除或结构变动的高风险动作，助手不会直接执行，会弹出确认提示由你确认：
  - 移动页面：提示「移动后，能看到这些页面的人可能会变化（随新位置继承权限）。」
  - 分享页面与修改页面权限：提示「修改后，名单之外的人会失去访问，降低的人只能按新级别使用这些页面；限制访问的页面不再继承所在位置的权限。」，由你勾选具体授权对象
  - 移到回收站：提示「移到回收站后，这个页面和它的全部子页面立即对所有人不可见；30 天内可以从回收站恢复，之后自动彻底删除。」
  - 归档知识库：提示「归档后，这个知识库从所有人的侧栏消失，全部页面只能查看、不能编辑，正在编辑的人立即变为只读。」
  - 恢复历史版本
  - 修改知识库成员名单
  - 清理引用中的旧标题（管理员操作）
- **需确认并二次验证身份**：彻底删除页面属于不可恢复的高风险操作，助手会在要求确认的同时，要求再次验证你的身份。
- **低风险动作直接执行**：往页面末尾追加内容、从回收站恢复页面、收藏或取消收藏、调整收藏顺序、复制页面、调整页面排序、套用模板、保存版本、恢复归档知识库、调整知识库排序等，助手会在确认后直接执行。

你可以对助手这样说：
> 在产品部知识库下新建一篇周报
> 把发布流程这篇移到归档文件夹下
> 给产品部开放查看发布清单
> 把这篇移到回收站
> 新建一个叫研发规范的知识库
> 把知识库产品部改名为产品与设计

> **助手限制**
>
> - 助手仅能以只读方式查看页面内容，代为打开时不记入「最近访问」，也不能越权查看权限名单外的页面。
> - 助手不能直接修改正在多人协同的正文，实时协同编辑须由你在页面中进行。
> - 助手不能替你上传图片字节。
> - 助手不能替你从本地导入 Word、Excel 或 PowerPoint 文件（必须在浏览器中手动选择本地文件）。
> - 在 Word、Excel 或 PowerPoint 页面上，助手无法执行大多数写入操作。

## 设置

知识库没有组织级别的全局设置页面。相关设置分为个人通知设置与知识库设置：

| 设置项 | 作用 | 取值范围 | 默认值 | 谁能改 |
|---|---|---|---|---|
| 「被分享」 | 有人把页面或知识库分享给你时是否发送通知 | 开启 / 关闭 | 开启 | 本人，在侧栏底部「设置」中修改 |
| 「被提及」 | 有人在页面正文中通过 @ 提及你时是否发送通知 | 开启 / 关闭 | 开启 | 本人，在侧栏底部「设置」中修改 |
| 知识库「名称」 | 侧栏目录树与主页卡片上显示的名称 | 1–60 字 | 创建时填写 | 该知识库管理者 |
| 知识库「说明」 | 主页卡片与设置中显示的知识库简介 | 最多 500 字 | 创建时填写 | 该知识库管理者 |
| 知识库图标 | 侧栏目录树与卡片上展示的图标 | 自定义选择 | 默认像素书本 | 该知识库管理者 |
| 知识库成员名单 | 默认谁能访问该知识库下的页面 | 成员、部门、角色或全员，分配对应级别 | 创建时预设三选一 | 该知识库管理者（修改需预演确认） |
| 页面版式 | 页面的展示宽度 | 「标准宽度」/「全宽」 | 「标准宽度」 | 拥有该页面编辑权限的成员 |

设置中的「被分享」与「被提及」通知消息会直接推送到[工作台](/guide/workspace)的[消息中心](/guide/messages)。

## 注意事项

- **容量与数量限制**：
  - 组织上限：每个组织最多创建 200 个知识库、100 000 个页面。
  - 知识库上限：每个知识库最多容纳 20 000 个页面。
  - 树形深度：知识库目录树深度上限为 12 层。
  - 子页面上限：同一父级页面下最多容纳 1 000 个子页面。
  - 访问名单上限：单个页面或知识库的访问名单最多添加 100 条规则。
  - 版本上限：单个页面最多保留 100 个历史版本，超出上限后旧的自动保存版本会被覆盖淘汰。
  - 图片规格：单张图片大小不得超过 10 MB，每个页面最多插入 200 张图片。
  - 列表展示上限：侧栏「最近访问」约展示 50 条；「收藏」最多添加 200 条；主页「最近编辑」最多展示 100 条。
  - 页面大小超限：页面内容达到上限时将被锁定为只读状态，系统提示「这个页面已达到大小上限，现在只能查看。请把内容拆到子页面。」。
- **不可恢复与数据安全**：
  - 移到回收站的内容保留 30 天，期满后系统自动彻底删除。
  - 手动执行「彻底删除」后，页面正文、历史版本及附件图片将被立即永久清除，无法撤销与恢复。
  - 知识库归档后，页面仅变为只读状态，管理者可随时恢复。
- **实时协同与网络离线**：
  - 页面采用多人实时协同合并机制，没有保存按钮。
  - 若网络波动出现「离线，修改保存在本机」或「离线，请勿关闭页面」提示，切勿关闭或刷新浏览器标签，须等待网络恢复并完成同步。
- **权限与审计规则**：
  - 成员必须同时具备相应的功能权限点与访问名单级别，方可进行查看、编辑或管理。
  - 组织管理员或持有「知识库管理员」权限的成员打开未授权页面时，系统会显示提示「你以管理员身份查看这个页面（你不在它的权限名单里），这次查看会记入审计。」，且该次访问行为会被记入审计日志。
  - 无权访问或页面不存在时，系统统一提示「页面不存在，或你没有查看权限」，不向外部暴露页面是否存在。
- **跨应用协同关系**：
  - 与[文档](/apps/doc)：文档为个人独立文档应用，页面互不相通，但支持通过链接互相引用；页面底部的「被提及于」区块会分别按「知识库」与「文档」归类显示引用来源。
  - 与[云盘](/apps/storage)：在知识库正文中输入 `@` 可直接关联与引用云盘文件。
  - 与[审批](/apps/flow)及业务数据：在正文中输入 `@` 可插入「业务对象卡片」，关联单据与审批流程。
  - 与[消息](/guide/messages)：被分享与被 @ 的通知会统一发送至工作台消息中心。
  - 与 [Agent](/agent/overview)：助手起草的内容须在平台 [Agent 草稿](/agent/drafts) 中审阅。

## 目前不支持

- 行内评论（访问级别预留了「可评论」并会展示已有记录，但邀请下拉未提供该级别，正文中未提供评论侧栏）。
- 离线将正文内容缓存至本地设备。
- 将页面导出为 HTML 格式文件。
- 用户自定义新建知识库模板。
- 收藏列表中拖拽调整页面顺序。
- 封面图片显示位置微调。
- 直接将页面拖拽放入回收站或拖拽加入收藏。
- Office 页面（Word / Excel / PowerPoint）的部分协同编辑功能（例如 Excel 中的图片和图表暂不支持多人协同编辑）。

## 常见问题

#### 页面修改后怎么保存？为什么找不到保存按钮？
知识库采用多人实时协同编辑模式，你的每一次输入和改动都会被系统实时合并并保存，因此界面上没有保存按钮。如果遇到网络异常，顶栏会提示「离线，修改保存在本机」或「离线，请勿关闭页面」，此时请勿关闭或刷新浏览器页面，等待网络重新连通并同步完成即可。

#### 为什么打开同事分享的页面时提示「页面不存在，或你没有查看权限」？
为了安全起见，系统在页面不存在或者你没有访问权限时，统一显示「页面不存在，或你没有查看权限」，不区分具体原因。请联系该页面的管理者，在页面右上角点击「分享」，将你（或你所在的部门、角色）添加到访问名单中，并确认你的账号拥有「使用知识库」权限。

#### 把页面移到回收站后可以找回吗？子页面会怎么样？
可以找回。将页面移到回收站后，该页面及其全部子页面会立即对所有人隐藏，并在回收站中保留 30 天。拥有管理权限的成员可在侧栏进入「回收站」，点击「恢复」进行还原。若原父页面已被删除，恢复的页面会自动放置在知识库顶层。若超过 30 天或执行了「彻底删除」，页面及其历史版本和图片将被永久清除，无法恢复。

#### 为什么管理员打开某些页面时会提示记入审计？
组织管理员或持有「知识库管理员」权限的成员拥有全局管理能力，可以查看组织内的全部页面。当管理员打开自己不在访问名单中的页面时，系统会在顶栏明确提示「你以管理员身份查看这个页面（你不在它的权限名单里），这次查看会记入审计。」，且该次访问行为会被完整记入审计日志，防止越权滥用。助手代为查询时不会越权。

#### 在 Word、Excel 或 PowerPoint 页面中协同编辑有什么限制？
目前 Office 页面仅支持部分协同操作。例如在 Excel 表格中，图片和图表暂不支持协同编辑；若编辑了暂不支持的内容，系统会提示「这部分内容暂不能协同编辑，改动只在你这里可见」或「有内容太大或链接地址不被允许，没有共享给其他人」。此外，导入本地文件时，Word 文档和 Excel 表格单文件最大 40 MB，PowerPoint 演示文稿单文件最大 100 MB，且均不支持导入受密码保护的文件。
