🏢 企业知识库 · 操作手册
📋 功能概述
企业知识库是信息知识模块下的文档管理子系统,支持企业级知识文档的创建、编辑、审核、发布全生命周期管理。 采用草稿 → 发布(直接发布)或草稿 → 已发布 → 提交审核 → 待审核 → 审核通过/退回的双版本管理流程。
1
进入企业知识库
从左侧二级导航栏中点击 「企业知识库」,或直接访问路由
/agent-studio/policy/enterprise-docs。页面显示文档列表,顶部可筛选状态(全部 / 草稿 / 待审核 / 已发布)。
列表页:文档「企业安全管理规范 V2.0」以「草稿」状态展示,含状态标签、附件数、评论数、创建人、更新时间等元信息。
2
创建新文档
点击右上角 「新建文档」 按钮,弹出创建对话框。输入文档标题后点 「创建」,系统自动创建草稿并跳转到详情页。
新建对话框:输入标题「企业安全管理规范 V2.0」后点击创建,自动进入详情编辑页。
3
文档编辑
详情页采用 左侧内容区 + 右侧信息面板 的分栏布局。内容区支持 Markdown 编辑与实时预览切换;右侧面板展示基本信息、附件管理(最多3个)、讨论评论。
编辑模式:左侧 Markdown 编辑器已写入完整文档内容(标题、表格、引用块等);右侧显示状态「草稿」、创建时间等信息。
4
内容预览
点击工具栏的 「预览」 标签,编辑器自动隐藏,切换为 Markdown 渲染后的富文本预览模式,支持标题、代码块、表格、图片、引用等渲染。
预览模式:Markdown 内容渲染为富文本,标题层级、表格、引用块、图片均正常展示。
🔄 文档生命周期
草稿
→
已发布
→
待审核
→
已发布
直接发布路径:草稿 → 发布 → 已发布
审核路径:已发布 → 保存草稿(新版本) → 提交审核 → 待审核 → 审核通过/退回
删除:任意状态均可删除(软删除),已删除文档可在回收箱恢复。
📝 操作说明(面向 Agent)
API 端点:
GET /admin/enterprise-docs— 列表查询(支持 status/page/page_size)POST /admin/enterprise-docs— 创建文档GET /admin/enterprise-docs/:id— 获取详情PATCH /admin/enterprise-docs/:id— 更新文档DELETE /admin/enterprise-docs/:id— 删除(软删除)POST /admin/enterprise-docs/:id/publish— 发布(草稿→已发布)PATCH /admin/enterprise-docs/:id/draft— 保存草稿版本POST /admin/enterprise-docs/:id/submit-review— 提交审核POST /admin/enterprise-docs/:id/approve— 审核通过POST /admin/enterprise-docs/:id/reject— 审核退回(需 reason)POST /admin/enterprise-docs/:id/restore— 从回收箱恢复
约束:
- 附件最多 3 个/文档
- 已发布文档编辑后需保存草稿 → 提交审核 → 审核通过后才能更新线上版本
- 草稿状态的文档可直接发布,无需审核