ima 知识库仪表板生成器

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install kb-dashboard
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 kb-dashboard。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

ima 知识库仪表板生成器通过 ima-mcp 读取你的 ima 资料库，并生成可浏览的 HTML 仪表板，帮助你一目了然地检查知识库的结构和状态。视图可以包括可折叠文件夹树、KPI 仪表、顶层文件夹图表、四阶段方法卡片图表，以及文件夹级知识图谱。
此 Openclaw Skills 功能刻意设为只读：它会获取结构并生成快照，不会创建文件夹、修改标签或将内容写回 ima。你可以为一个资料库生成仪表板，也可以在带标签页的全局视图中比较个人、公司和素材资料库。生成的 HTML 是快照，不是实时或自动刷新的仪表板。

应用场景

当你希望直观概览而不是手动浏览文件夹时，检查个人、公司或素材知识库。
定期查看文件夹结构、文档数量、空文件夹以及可能需要关注的区域。
使用全局范围和资料库标签页并排比较多个 ima 资料库。
生成可分享、可在浏览器中查看的 HTML 快照，用于知识库审查。
当文件夹级可视化不够详细且你明确请求高级模式时，探索卡片之间的知识关系。

工作原理

确定请求的范围：默认使用个人主资料库；也可以按指定使用公司、素材或所有资料库。如果所有资料库的数据总量可能很大，获取前先确认。
使用 ima-mcp 的 get_knowledge_base_list 查找用户实际的资料库 ID；不要重复使用技能中作为作者示例的 ID。
获取每个资料库的根条目，并通过 get_knowledge_list 递归获取文件夹内容。持续跟进分页游标，直到收集完所有结果，并遵守工具每次请求最多 50 条的限制。
将文件夹名称、文档数量、子文件夹、空文件夹标记和适用的方法阶段统计汇总到仪表板数据结构中。
将准备好的 JSON 传递给 build_dashboard.py，该脚本会验证数据并将其插入 HTML 模板，生成独立的仪表板文件。
在浏览器预览中展示生成的 HTML。说明它反映的是生成时的数据，要显示之后的更改，必须重新生成。

配置指南

此技能依赖已提供 ima-mcp 工具且安装了技能渲染器和模板资源的环境。技能未指定单独的软件包安装步骤。首次运行前，请启用或连接 ima-mcp，然后让代理使用 get_knowledge_base_list 查找你自己的资料库 ID；切勿用作者的示例 ID 替代你账户的 ID。
代理获取资料库结构并准备好所需的 JSON 数据后，使用附带脚本渲染仪表板。请根据你的安装位置和目标路径调整技能路径或输出文件名：
python3 ~/.workbuddy/skills/kb-dashboard/scripts/build_dashboard.py \ --data /tmp/kb_main.json \ --out ./ima-dashboard-$(date +%Y-%m-%d).html --data 文件必须遵循仪表板架构。--out 选项接受相对或绝对路径；如果省略，渲染器会在当前工作目录中写入带日期的 HTML 文件。渲染器还支持使用 --template 指定其他模板，不过通常使用默认模板即可。代理可以通过 present_files 展示完成的文件。 ima 知识库仪表板生成器 数据架构与分类体系
渲染器使用一个 JSON 对象，其中包含生成时间戳、请求范围和一个或多个资料库。每个资料库包含其身份信息、可选备注、摘要 KPI、文件夹树、图表系列、方法阶段计数和图谱数据。
字段 用途
generated_at 此仪表板快照的时间戳。
scope 请求的视图，例如 main、company、material 或 all。
libraries 资料库对象数组；全局范围可以包含多个资料库。
libraries[].id、libraries[].name 用户查找到的 ima 资料库 ID 和显示名称。
libraries[].kpis 摘要值，例如顶层文件夹数量、文档总数、方法卡片、元层级数量、空白区域和 Express 状态。
libraries[].tree 文件夹层级和计数；条目可以包含文件名、子文件夹和 empty 标记。
libraries[].topCounts 用于顶层文件夹图表的名称和计数对。
libraries[].methodStage 主资料库的四组方法阶段名称和计数对；其他资料库类型可以使用空数组。
libraries[].graph.nodes 文件夹级图谱节点，每个节点包含名称、计数和类别：0 表示资料库根目录，1 表示顶层文件夹，2 表示子文件夹。
libraries[].graph.links 由源节点和目标节点索引表示的父子连接。
生成的产物是一个嵌入仪表板数据的 HTML 文件；JSON 可以暂存，例如放在 /tmp/kb_main.json。默认图谱表示文件夹层级，而非单张知识卡片之间的语义链接。ECharts 从 CDN 加载，因此没有互联网连接时图表可能无法显示，但文件夹树和 KPI 内容仍可用。

高级特性

多资料库范围：
为单个资料库生成仪表板，或在带标签页的全局视图中展示个人、公司和素材资料库。用户未指定范围时，默认使用个人主资料库。
分页感知检索：
每页获取最多 50 个文件夹条目；只要返回游标就继续获取，避免较大资料库的计数不完整。
结构诊断：
通过图表和 KPI 显示空文件夹及内容分布，更容易发现缺口和失衡。
可选的卡片级关系图：
在用户明确请求时，读取方法卡片内容或 front matter，提取关联卡片字段并构建卡片网络。这需要为每张卡片额外调用检索，默认不启用。
可复用的渲染流程：
Python 渲染器会验证 JSON，将其嵌入 HTML 模板，并支持自定义输出路径和模板路径。
只读边界：
此技能只检索和渲染数据；不会修改 ima 资料库，也不提供实时刷新。重新运行即可创建更新后的快照。

name: kb-dashboard description: This skill should be used when the user wants a visual dashboard of their ima knowledge base — triggered by phrases like "知识库看板", "生成知识图谱", "ima 看板", "知识库可视化", "看板", or "知识库结构图". It pulls the current structure from ima (read-only, via ima-mcp) and renders a self-contained HTML dashboard with a collapsible folder tree, KPI gauges, layer bar/pie charts, and a folder-level knowledge graph. Supports per-library or global scope. version: 1.0.0
author: 宗宗（戴宗宗）
triggers:

• 知识库看板
• 生成知识图谱
• ima 看板
• 知识库可视化
• 知识库结构图
• 看看我的库长啥样 tags:
• ima
• 知识库
• 可视化
• 看板 agent_created: true

ima 知识库看板生成器（kb-dashboard）

Overview

为宗宗的 ima 知识库生成一份全局快照看板——双击即看的 HTML，包含结构树（根→子目录，可折叠）、KPI 仪表、分层柱状图、方法卡四环节饼图、folder 级知识图谱。解决「ima 个人版无原生结构/图谱可视化看板」的缺口，让宗宗随时用「上帝视角」看见整个库的状态、哪里空、哪里堵。

特性：

纯只读拉取 ima 数据，绝不动库。
自包含单文件 HTML（内嵌 ECharts，亮/暗双主题，右上角切换）。
支持单库（个人主库 / 公司库 / 资料收集）或三库全局（tab 切换）。
触发条件（When to use）
用户说「知识库看板」「生成知识图谱」「ima 看板」「知识库可视化」「知识库结构图」「看看我的库现在长啥样」。
用户想定期巡检知识库结构、空壳夹、Express 缺口。
不做：实时自动刷新（个人版无开放 API，见诚实边界）、写库、改结构。
提示词模板（可直接复制）

把下面的指令直接发给 WorkBuddy 即可触发本 skill；scope 可替换。

个人主库看板：请生成我的 ima 知识库看板（个人主库），让我用上帝视角看看结构、空壳夹和 Express 缺口。
全局三库看板：生成 ima 全局看板，把个人主库 / 公司库 / 资料收集库并排对比。
公司库看板：生成区别品牌知识库（公司）的看板。
输出格式
产物：一份自包含单文件 HTML 看板（内嵌 ECharts，亮/暗双主题可切换），输出到当前工作目录或 --out 指定路径（如 ima看板__.html）。
展示：通过 present_files 自动在浏览器预览；并告知用户「这是快照，想看最新状态随时重跑」。
内容页：结构树（可折叠）+ KPI 仪表 + 顶层夹柱状图 + 方法卡四环节饼图 + folder 级知识图谱；all 模式额外生成三库并排 tab。
边界：本 skill 只读拉取与渲染，不建夹、不改标签、不写任何内容。
范围解析（先确认，再拉取）
用户表述 scope 目标库
「知识库看板」「我的库看板」（默认） main 个人主库
「全局看板」「整体看板」「所有库」 all 三库并排 tab
「公司库看板」「区别库看板」 company 区别品牌知识库（公司）
「资料库看板」「收集库看板」 material 资料收集库

若用户未指定，默认 main（个人主库，图谱效果最好）。涉及 all 时，先简短确认是否要三库全量（数据量较大），再执行。

scope 只是语义标签；真正的库 ID 由 Step 1 自动探测、或从上方「目标库 ID」表取（作者示例）。使用者切勿套用作者 ID，应先 get_knowledge_base_list 拿自己的库再填。

目标库 ID（使用者须替换为自己库）

⚠️ 去个人化提醒（上架必读）：下表是作者（宗宗）个人的 ima 库 ID，仅作者本人有效。公开上架后，使用者首次运行必须先获取自己的库 ID，不要直接套用下表。

自动探测（推荐）：先调 mcp__ima-mcp__get_knowledge_base_list 列出你账号下全部库（含 knowledge_base_id 与库名）；再用 mcp__ima-mcp__get_knowledge_list（不带 folder_id）拉该库顶层 folder 列表。把返回的真实 ID 填进 DATA JSON 即可，无需硬编码。

下表作为作者默认示例保留，方便作者本人直接复用；他人请忽略、按上面自动探测流程替换。

库（作者示例） knowledge_base_id 关键 folder_id
个人主库·戴宗宗的知识库 001a977664004911 元层 folder_7486327218003432；方法论中枢 folder_7486326815348031；定位/品类 folder_7486327729706110；策略/品牌战略 folder_7486327775845700；识别设计 folder_7486327813594268；营销传播 folder_7486327847149363；项目实战 folder_7488484247880321；案例库 folder_7485620330976627；Areas：创业·商业探索 folder_7490332207890773／理财·财务 folder_7490332254030561／法务 folder_7490332304359838／管理 folder_7490332342110083／哲学·人生意义·价值创造 folder_7490332392442517
区别品牌知识库（公司） 7487406454362519 区别方法论 folder_7492515284393342；元层 folder_7492515234055026
资料收集库 7486067221485638 （按文件夹分组，无需逐子夹枚举）
书籍萃取库 7497955799994204 （元层基座版 v2，独立质检，一般不在看板主视图）

folder ID 可能随 ima 结构微调而漂移。若拉取返回空或异常，用 mcp__ima-mcp__get_knowledge_list（无 folder_id）重新拉顶层确认当前 ID。

拉取与渲染流程（Step-by-Step）
Step 1 · 拉取 folder 树（只读）

先定库 ID（去个人化关键）：若 DATA 里还没有 knowledge_base_id，先调 mcp__ima-mcp__get_knowledge_base_list 列出账号下全部库，让用户选 / 按库名匹配 scope；再把真实 ID 填入。不要写死作者示例 ID。

对每个目标库，调用 mcp__ima-mcp__get_knowledge_list：

先拉顶层（参数 {knowledge_base_id, limit:50}，不带 folder_id）→ 得到 root 的子节点列表（folder + 散文件）。
对每个 folder 节点，再拉其子层（{knowledge_base_id, folder_id, limit:50}）统计 count 与 children。
翻页：单次 limit 上限 50，返回 cursor 非空时继续拉下一页，直到取完。
散文件（无 folder_id 的直接子项）计入父 folder 的 count，文件名进 items。

只统计「结构」即可：folder 名、每层 count、空壳夹（count=0 的 Areas）、方法卡四环节分布（仅主库：4 个子夹计数）、案例库子夹数（subfolders）。

Step 2 · 整理成 DATA JSON

将数据整理为下方 schema（与 scripts/build_dashboard.py 的 docstring 一致）。graph 节点 cat: 0=根·库, 1=顶层夹, 2=子夹；links 为父子索引对。

{
"generated_at": "2026-09-02 15:36",
"scope": "main",
"libraries": [{
"id": "001a977664004911",
"name": "戴宗宗的知识库",
"note": "可选·诚实边界说明（覆盖默认文案）",
"kpis": {"topFolders":9,"totalDocs":172,"methodCards":101,"metaLayer":15,"emptyAreas":3,"express":"薄"},
"tree": [
{"name":"元层","count":15,"items":["蒸馏质量门SOP（批次0）","..."]},
{"name":"方法论中枢","count":101,"children":[{"name":"定位/品类","count":15},{"name":"策略/品牌战略","count":40},{"name":"识别设计","count":20},{"name":"营销传播","count":15}]},
{"name":"哲学·人生意义·价值创造","count":0,"empty":true}
],
"topCounts": [["元层",15],["方法论中枢",101],["项目实战",4],["品牌手册-案例库",54],["哲学",0],["管理",1],["法务",0],["理财·财务",0],["创业·商业探索",1]],
"methodStage": [["定位/品类",15],["策略/品牌战略",40],["识别设计",20],["营销传播",15]],
"graph": {"nodes":[{"name":"戴宗宗的知识库","count":172,"cat":0},{"name":"元层","count":15,"cat":1},{"name":"方法论中枢","count":101,"cat":1},{"name":"定位/品类","count":15,"cat":2}],"links":[{"source":0,"target":1},{"source":0,"target":2},{"source":2,"target":3}]}
}]
}

kpis.express：根据项目实战夹内容判读，如「薄」「丰富」「—」。主库常「薄」（仅模板）。
methodStage：仅主库填 4 项；公司库/资料收集库传空数组 []（饼图自动显示占位）。
note：默认文案已写在模板；如需强调某库边界，可覆盖。
Step 3 · 渲染 HTML

将 DATA 写成临时 JSON（如 /tmp/kb_main.json），调用脚本：

python3 ~/.workbuddy/skills/kb-dashboard/scripts/build_dashboard.py \

--data /tmp/kb_main.json
--out ./ima看板_个人主库_$(date +%Y-%m-%d).html

--out 可省略：默认输出到当前工作目录 kb_dashboard_YYYY-MM-DD.html。使用者可传任意绝对 / 相对路径（如自己的桌面）。 --template 可覆盖模板路径（一般不需）。

脚本读取 assets/template.html，把数据注入 /DATA_PLACEHOLDER/，输出自含 HTML。

Step 4 · 交付与刷新

用 present_files 展示生成的 HTML（自动打开浏览器预览）。告知宗宗：这是快照，想看最新状态随时让我重跑。

进阶模式：卡片级关系链图谱（可选）

默认图谱是 folder 级从属（100% 真实，但只到文件夹）。若要真正「知识图谱/关系链」，需读方法卡的「挂接卡」字段：

拉主库方法卡列表（已落位的 101 张）。
对每张卡调 mcp__ima-mcp__fetch_media_content 或读取其 front-matter，提取「挂接卡 / 链接」字段。
将卡片作为节点、挂接关系作为 links，生成第二张图谱（卡片级网络）。
可并入同一 HTML 的「关系链」tab，或单独输出。

此模式成本较高（需逐卡读取内容），仅在宗宗明确要「关系链/真网络」时启用，不要默认跑。

注意事项（诚实边界，必须向宗宗说明）
ima 个人版无原生图谱数据：看板「知识图谱」= folder 层级从属关系还原（真实）；卡片级「挂接卡」需进阶模式读卡。
快照非实时：数据固定为生成时刻。真·实时需本地服务代理 ima API（配 ~/.config/ima/ 凭证 + 常驻），当前未做。
需联网加载 ECharts：HTML 通过 CDN 引入图表库，离线双击可能图表不渲染（结构树/KPI 仍可用）。
只读：本 skill 只拉取与生成，绝不写库、建夹、改标签。
比例真相：看板如实暴露空壳 Areas、Express 薄、资产 vs 订阅失衡——这是看板的价值，不是缺陷。
不绑定个人库：本 skill 不写死任何个人 ima 库。作者预填的 folder ID 仅为本人便利；使用者须按 Step 1 自动探测替换为自己的库 ID 后才能正确拉取。

Resources

scripts/build_dashboard.py — JSON → HTML 渲染器（含数据校验、默认输出命名）。
assets/template.html — 自含看板模板（ECharts CDN、亮/暗双主题、结构树+KPI+柱状+饼图+folder 图谱、单库/三库 tab）。
UI ROI 审计
ima 知识库 COS 直传