知识库 Dashboard 设计文档

概述

知识库 Dashboard 用于可视化展示知识库的建设情况，帮助管理者了解：

内容理解的广度和深度（内容树覆盖度）
制作能力的成熟度（任务表成熟度）
工具资源的丰富度（工具库完备性）
知识积累的质量（知识质量评估）

Dashboard 采用三个维度的 Tab 切换设计，每个维度支持三层下钻。

一、内容树覆盖度维度

1.1 第一层：树形结构总览

可视化形式：交互式树状图

节点视觉编码：

颜色（表示成熟度）：
- 🟢 绿色：完整支持（有任务 + 工具已接入 + 有知识）
- 🟡 黄色：部分支持（有任务但工具未完全接入或缺知识）
- ⚪ 灰色：待探索（无任务关联）
角标（表示重要性和状态）：
- 数字角标：关联的帖子数量（如 [23]）

全局指标卡片（页面顶部）：

┌─────────────────────┬─────────────────────┬─────────────────────┐
│ 节点覆盖率           │ 工具支持率           │ Pattern转化率        │
│ 65%                 │ 45%                 │ 78%                 │
│ 有任务的节点/总节点  │ 工具全接入的节点/总节点│ 有任务的Pattern/总Pattern│
└─────────────────────┴─────────────────────┴─────────────────────┘

1.2 第二层：节点详情页

点击某个内容树节点，展开详情面板（侧边栏）。

基本信息区：

节点路径：内容树 > 一级分类 > 二级分类 > 当前节点
关联帖子数：X 个
节点状态：完整支持 / 部分支持 / 待探索

Pattern 列表：

表格展示关联的所有 Pattern
列：Pattern ID、帖子数、归纳任务数、操作（查看详情）
数据来源：用频繁项集API根据内容树节点ID查

原始帖子列表：

表格展示关联的原始帖子
列：帖子标题、账号、发布时间、关联 Pattern、操作（查看原文）
数据来源：通过 Pattern → 帖子的关联关系

制作任务列表：

表格展示从这些 Pattern 归纳出的任务
列：任务描述、成熟度等级（L0-L4）、依赖工具、关联知识数、操作（查看详情）
点击"查看详情"跳转到任务详情页（见 2.3）

知识积累情况：

知识总数：X 条
按类型分布：usecase Y 条、plan Z 条、tool N 条
平均质量评分：M 分
知识列表（简要）：显示 top 5 高质量知识，可展开查看全部

工具支持情况：

列出所有任务依赖的工具
每个工具显示：名称、状态（已接入/未接入/测试中）、关联知识数
高亮显示未接入的工具

1.3 第三层：Pattern / 制作任务 / 知识 / 工具详情页（可使用弹窗展示）

二、任务表维度

2.1 第一层：任务全景矩阵

可视化形式：热力图矩阵

横轴：任务分类

分类方式待定，可能的维度：
- 按内容类型：图文、视频、音频、直播等
- 按制作环节：选题、脚本、拍摄、剪辑、发布等
- 按业务场景：日常更新、活动策划、品牌宣传等
建议：先按任务表中的 task.type 字段分类，如果没有该字段，则需要对任务进行人工标注或 LLM 自动分类

纵轴：成熟度等级

L0 - 待完善：缺少知识和工具
- 判断标准：任务的 knowledge 字段为空且 tools 字段为空
L1 - 初步支持：有知识或有工具
- 判断标准：单次业务执行或单个工具触发的新任务
- 数据标识：任务的 source.category 为 "exp"（单次经验）
L2 - 相对完善：有相对完善的知识和工具
- 判断标准：对任务本身进行过调研
- 数据标识：任务的 source.category 为 "skill"（系统性调研）
L3 - 就绪：涉及工具全都已接入
- 判断标准：任务的 tools 字段中所有工具的 status 都为"已接入"
L4 - 已验证：已支持相关工作完成
- 判断标准：任务的 trace 字段有成功执行记录

热力图单元格：

颜色深度：表示该格子的任务数量
点击单元格：下钻到该分类+等级的任务列表

全局指标卡片（页面顶部）：

┌─────────────────────┬─────────────────────┬─────────────────────┐
│ 任务总数             │ 知识沉淀率           │ 可执行率             │
│ 156                 │ 72%                 │ 38%                 │
│                     │ L1+任务/总任务       │ L3+L4任务/总任务     │
└─────────────────────┴─────────────────────┴─────────────────────┘

2.2 第二层：任务列表页

点击矩阵单元格，展示该分类+等级的任务列表。

筛选和排序：

按成熟度等级筛选
按任务类型筛选
按关联知识数排序
按执行次数排序

任务列表表格：

列：
- 任务描述（task 字段）
- 成熟度等级（L0-L4）
- 来源 Pattern（source.itemset_id）
- 依赖工具（tools 字段，显示工具名称和状态）
- 关联知识数（knowledge 字段，按 case/process 分类统计）
- 执行记录（trace 字段，成功/失败次数）
- 操作（查看详情）

2.3 第三层：单任务详情页

点击某个任务，展开详情。

任务基本信息：

任务描述：task 字段
成熟度等级：L0-L4
来源信息：
- 来源 Pattern：source.itemset_id
- 来源类型：source.type（itemset/tool/...）
- 来源分类：source.category（exp/skill/...）

工具清单：

表格展示依赖的所有工具（从 tools 字段）
列：
- 工具名称
- 工具状态（已接入/未接入/测试中）
- 工具版本
- 关联知识数（从 Resource.metadata.knowledge_ids 统计）
- 操作（查看工具详情）
高亮显示未接入的工具

知识清单：

按知识类型分组展示（从 knowledge 字段）
Case 知识（types 包含 "usecase"）：
- 列表展示，每条显示：task、content 摘要、质量评分、操作（查看详情）
Process 知识（types 包含 "plan"）：
- 列表展示，每条显示：task、content 摘要、质量评分、操作（查看详情）
Tool 知识（types 包含 "tool"）：
- 列表展示，每条显示：task、content 摘要、质量评分、操作（查看详情）
每条知识显示质量徽章（见第四章）

改进建议（自动生成）：

如果 L0：建议补充工具和知识
如果 L1：建议进行系统性调研
如果 L2：建议接入相关工具
如果 L3：建议进行实际验证

三、工具能力维度

3.1 第一层：工具库全景

可视化形式：工具卡片墙 + 分类统计

分类统计（页面顶部）：

按 Resource.metadata.category 分类：
- image_gen：X 个
- image_process：Y 个
- model：Z 个
- plugin：N 个
- workflow：M 个
- other：K 个
按 Resource.metadata.status 分类：
- 已接入：X 个
- 未接入：Y 个
- 测试中：Z 个

全局指标卡片：

┌─────────────────────┬─────────────────────┬─────────────────────┐
│ 工具总数             │ 工具可用率           │ 工具成熟度           │
│ 48                  │ 62%                 │ 35%                 │
│                     │ 已接入/总数          │ 有完整知识/总数      │
└─────────────────────┴─────────────────────┴─────────────────────┘

工具卡片墙：

每个工具一个卡片
卡片内容：
- 工具名称（Resource.title）
- 工具分类（metadata.category）
- 工具状态（metadata.status）- 用颜色标识
- 知识积累度：
- Case 知识：X 条
- Process 知识：Y 条
- Tool 知识：Z 条
- 业务支持度：
- 被 N 个任务依赖
- 关联 M 个内容树节点
- 操作：查看详情

筛选和排序：

按分类筛选
按状态筛选
按知识数量排序
按任务依赖数排序

3.2 第二层：工具卡片详情

点击某个工具卡片，展开详情面板。

工具元信息：

基本信息：
- ID：Resource.id
- 名称：Resource.title
- 分类：metadata.category
- 状态：metadata.status
- 版本：metadata.version
- Slug：metadata.tool_slug
描述信息：
- 功能描述：metadata.description
- 使用方法：metadata.usage
- 应用场景：metadata.scenarios（列表）
- 输入类型：metadata.input
- 输出类型：metadata.output
- 来源链接：metadata.source

知识积累情况：

从 metadata.knowledge_ids 获取关联的知识列表
按知识类型分组展示：
- Case 知识（types 包含 "usecase"）：
- 数量统计
- 列表展示（task、content 摘要、质量评分）
- Process 知识（types 包含 "plan"）：
- 数量统计
- 列表展示（task、content 摘要、质量评分）
- Tool 知识（types 包含 "tool"）：
- 数量统计
- 列表展示（task、content 摘要、质量评分）
知识来源分布：
- Agent 生成：X 条
- 人工审核：Y 条
- 外部导入：Z 条
知识时效性：
- 最近更新时间
- 最近使用时间

业务支持情况：

关联任务列表：
- 从任务表的 tools 字段反查
- 表格展示：任务描述、成熟度等级、执行次数、成功率
关联内容树节点：
- 通过任务 → Pattern → 内容树节点的路径
- 列表展示：节点路径、关联帖子数

改进建议（自动生成）：

如果 case 知识 < 3 条：建议补充用例
如果 process 知识 = 0：建议补充流程
如果 status = "未接入" 且被多个任务依赖：高优先级接入
如果最近 90 天无使用记录：建议评估是否保留

3.3 第三层：知识详情页

点击某条知识，展开知识详情（见第四章）。

四、知识质量（横切面）

知识质量作为横切面，贯穿上述三个维度。每条知识都需要标注质量属性。

4.1 质量维度定义

1. 评分（Score）

数据来源：Knowledge.eval.score（1-5 分）
展示方式：星级 ⭐⭐⭐⭐⭐

2. 验证度（Validation）

数据来源：Knowledge.eval.helpful vs Knowledge.eval.harmful
计算方式：验证度 = helpful - harmful
展示方式：+5/-1（绿色/红色）

3. 可信度（Credibility）

分级：
- 🟢 高可信：人工审核通过 + 有使用验证（helpful > 3）
- 🟡 中可信：Agent 生成 + 有使用验证（helpful > 0）
- 🔵 待验证：Agent 生成 + 无使用验证（helpful = 0）
- 🔴 低可信：有负面反馈（harmful > 0）

判断逻辑：

if harmful > 0:
  可信度 = 低可信
elif source.submitted_by != "" and helpful > 3:
  可信度 = 高可信
elif helpful > 0:
  可信度 = 中可信
else:
  可信度 = 待验证

4. 时效性（Recency）

数据来源：Knowledge.updated_at 或最近使用时间（从 eval.helpful_history 提取）
分级：
- 🟢 新鲜：< 30 天
- 🟡 一般：30-90 天
- 🔴 陈旧：> 90 天
展示方式：显示距今天数（如"15 天前"）

5. 挂载状态（Attachment）

判断逻辑：
- ✅ 已挂载到工具：通过 Resource.metadata.knowledge_ids 反查
- ✅ 已挂载到任务：通过任务表的 knowledge 字段反查
- ⚠️ 孤立知识：两者都无
展示方式：图标 + 文字说明

4.2 质量等级计算

综合质量等级：A / B / C / D

计算公式：

质量分数 = 评分 × 验证度权重 × 可信度权重 × 时效性权重 × 挂载权重

其中：
- 评分：1-5 分，直接使用
- 验证度权重：
  - helpful - harmful > 5: 1.2
  - helpful - harmful > 0: 1.0
  - helpful - harmful = 0: 0.8
  - helpful - harmful < 0: 0.5
- 可信度权重：
  - 高可信：1.2
  - 中可信：1.0
  - 待验证：0.8
  - 低可信：0.5
- 时效性权重：
  - 新鲜：1.0
  - 一般：0.9
  - 陈旧：0.7
- 挂载权重：
  - 挂载到工具或任务：1.0
  - 孤立知识：0.8

质量等级：
- A：质量分数 >= 4.5
- B：质量分数 >= 3.5
- C：质量分数 >= 2.5
- D：质量分数 < 2.5

4.3 知识详情页

点击任何地方的知识条目，展开知识详情。

基本信息：

知识 ID：Knowledge.id
任务场景：Knowledge.task
知识内容：Knowledge.content
知识类型：Knowledge.types（可多选）
标签：Knowledge.tags
可见范围：Knowledge.scopes
所有者：Knowledge.owner

质量评估：

综合质量等级：A / B / C / D（大号徽章）
详细质量维度：
- 评分：⭐⭐⭐⭐⭐ (4.5 分)
- 验证度：+5/-1
- 可信度：🟢 高可信
- 时效性：🟢 15 天前
- 挂载状态：✅ 已挂载到 2 个工具、3 个任务

来源信息：

资源名称：source.name
来源类别：source.category
参考链接：source.urls
创建者：source.agent_id
提交者：source.submitted_by
创建时间：source.timestamp
溯源消息：source.message_id（可点击跳转）

关联资源：

从 resource_ids 获取关联的 Resource
列表展示：资源 ID、资源标题、资源类型、操作（查看资源）

使用历史：

Helpful 案例（eval.helpful_history）：
- 表格展示：任务描述、结果、时间
Harmful 案例（eval.harmful_history）：
- 表格展示：任务描述、结果、原因、时间

关系网络：

从 relationships 字段获取与其他知识的关系
展示：关系类型（duplicate/subset/superset/conflict/complement）、关联知识 ID

操作按钮：

更新评分
添加 Helpful 案例
添加 Harmful 案例
触发知识进化（提供改进建议）

dashboard-design.md 15 KB History Raw