知识库使用手册
本页说明 SkillFlaw 知识库模块的入口、界面结构与主要操作路径。 内容覆盖知识库开发页、知识库广场页、知识库服务商维护与知识条目生命周期操作。
入口位置
用户通过主菜单 知识库 进入该模块。 页面包含两个一级页签：
- 知识库开发：维护知识库服务商与知识条目
- 知识库广场：浏览可读范围内的知识资源
页面截图
下图为知识库入口页面截图，包含“知识库开发 / 知识库广场”页签与知识库服务商卡片区域。
下图为 知识库开发 页签下的知识库服务商管理工作台。
这张页面主要体现了：
- 知识库开发 / 知识库广场 页签切换入口
- 与范围、业务域相关的知识库服务商筛选区
- 作为第一层容器选择入口的知识库服务商卡片列表
- 只有先创建知识库服务商，后续才能继续创建其下知识条目的 创建知识库服务商 入口
页面并不是“所有知识条目平铺列表”，而是先维护或选中知识库服务商，再进入该服务商下的知识条目列表。
知识库开发页签
“知识库开发”页签是知识资源的主维护界面。 操作围绕两层对象展开：
- 知识库服务商
- 所选知识库服务商下的知识条目
知识库服务商操作
知识库服务商是知识条目的容器。 支持的用户动作包括：
- 新增知识库服务商
- 编辑知识库服务商元数据
- 查看知识库服务商详情
- 删除知识库服务商
知识库服务商的范围需要显式选择，范围口径为：
- 租户
- 业务域
- 个人
下图为 创建知识库服务商 弹窗。
弹窗中可见的关键字段包括：
- 范围
- 知识库驱动
- 服务商名称
- 服务商地址
- 服务商 API 地址
- Logo
- 备注
界面行为要点：
- 知识库服务商创建是独立弹窗流程，不是表格内联编辑
- 范围需要在弹窗内显式选择，并决定资源归属边界
- 驱动类型必须先选择，知识库服务商才能保存
- 用户需要先完成知识库服务商元数据录入，后续才能继续该服务商下的知识条目维护
知识库服务商的创建与编辑都受权限控制。只有用户具备相应写入权限，且当前写入租户与资源租户一致时，才可编辑或删除。
知识条目操作
知识条目必须创建在已选中的知识库服务商下。 支持的用户动作包括：
- 在所选知识库服务商下新增知识条目
- 编辑知识条目
- 查看知识详情
- 发布知识条目
- 将已发布知识下线
- 删除知识条目
- 恢复已删除知识条目
页面中的关键限制：
- 未选中知识库服务商时，不能创建知识条目
- 已删除的知识库服务商下不能继续新增知识条目
- 已删除知识必须先恢复，才能再次编辑或发布
- 已上线知识必须先下线，删除动作才会开放
筛选与范围行为
“知识库开发”页签提供以下筛选：
- 范围
- 业务域
- 驱动 / 知识库服务商类型
- 访问类型
- 上下线状态
- 删除状态
- 关键字
页面会区分“资源范围”和“页面上下文”。业务域筛选来自业务树，写操作也不是仅凭本地租户是否相等做粗略判断。
知识库广场页签
“知识库广场”页签是偏只读的浏览界面，用于查看可读语义下的知识资源。
支持的筛选包括：
- 租户
- 范围
- 业务域
- 知识库服务商
- 访问类型
- 关键字
广场以浏览与查看详情为主。创建、编辑、删除等维护动作仍在“知识库开发”页签中完成。
权限与边界
知识库模块遵循平台权限与范围规则：
- 新增 / 编辑 / 删除 / 发布 / 下线 / 恢复都依赖权限校验
- 写操作还会校验当前写入租户是否与资源租户一致
- 系统租户资源的写操作，必须先切换到系统租户上下文
- 广场与详情读取复用资源本身的可读语义，而不是再叠加更严格的页面本地判断