企业知识库操作手册 V2

企业知识库操作手册 V2

企业知识库 · 操作手册

🏢 企业知识库 · 操作手册

📂 所属模块:PF-信息知识(policy-module) 📌 生成日期:2026-06-04 🔗 路由:/agent-studio/policy/enterprise-docs

📋 功能概述

企业知识库是信息知识模块下的文档管理子系统,支持企业级知识文档的创建、编辑、审核、发布全生命周期管理。 采用草稿 → 发布(直接发布)或草稿 → 已发布 → 提交审核 → 待审核 → 审核通过/退回的双版本管理流程。

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 个/文档
  • 已发布文档编辑后需保存草稿 → 提交审核 → 审核通过后才能更新线上版本
  • 草稿状态的文档可直接发布,无需审核