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

Overview

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

特性：

• 纯只读拉取 ima 数据，绝不动库。
• 自包含单文件 HTML（内嵌 ECharts，亮/暗双主题，右上角切换）。
• 支持单库（个人主库 / 公司库 / 资料收集）或三库全局（tab 切换）。

触发条件（When to use）

• 用户说「知识库看板」「生成 ima 知识库图谱」「ima 知识库结构图」「ima 看板」「知识库可视化」「看看我的库现在长啥样」。
• 用户想定期巡检知识库结构、空壳夹、Express 缺口。
• 严格范围：本 skill 只服务于 ima 知识库的结构可视化。用户如果只是说「给我做个看板」「画个 dashboard」「生成知识图谱」（未指明 ima 知识库），不应触发——那可能是 BI/前端/其它需求，需先确认是否针对 ima 库。
• 不做：实时自动刷新（个人版无开放 API，见诚实边界）、写库、改结构、非 ima 库的图表。

提示词模板（可直接复制）

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

• 个人主库看板：请生成我的 ima 知识库看板（个人主库），让我用上帝视角看看结构、空壳夹和 Express 缺口。
• 全局三库看板：生成 ima 全局看板，把个人主库 / 公司库 / 资料收集库并排对比。
• 公司库看板：生成你的品牌知识库（公司库）的看板。

输出格式

• 产物：一份自包含单文件 HTML 看板（内嵌 ECharts，亮/暗双主题可切换），输出到当前工作目录或 --out 指定路径（如 ima看板_<库名>_<日期>.html）。
• 展示：通过 present_files 自动在浏览器预览；并告知用户「这是快照，想看最新状态随时重跑」。
• 内容页：结构树（可折叠）+ KPI 仪表 + 顶层夹柱状图 + 方法卡四环节饼图 + folder 级知识图谱；all 模式额外生成三库并排 tab。
• 边界：本 skill 只读拉取与渲染，不建夹、不改标签、不写任何内容。

范围解析（先确认，再拉取）

若用户未指定，默认 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 即可，无需硬编码。

下表作为默认示例保留，仅作占位说明；使用者请按上面自动探测流程替换为自己的库 ID。

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：

1. 先拉顶层（参数 {knowledge_base_id, limit:50}，不带 folder_id）→ 得到 root 的子节点列表（folder + 散文件）。
2. 对每个 folder 节点，再拉其子层（{knowledge_base_id, folder_id, limit:50}）统计 count 与 children。
3. 翻页：单次 limit 上限 50，返回 cursor 非空时继续拉下一页，直到取完。
4. 散文件（无 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": "<你的主库ID>",
    "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% 真实，但只到文件夹）。若要真正「知识图谱/关系链」，需读方法卡的「挂接卡」字段：

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

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

注意事项（诚实边界，必须向用户说明）

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

Resources

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