kb-mindmap
Generate a local multi-level mind map from knowledge-base documents (NotebookLM-style hierarchical JSON for tree visualization), powered by the configured local model with no cloud upload. Use for 生成脑图/思维导图, 梳理文档结构/要点, or when the user opens the mind-map action in the knowledge-base Q&A panel. Do not use when the request targets a single conversation message instead of KB materials, or when no KB documents are selected.
- License 许可
- MIT
- 所属仓库
- bonc-ai/cogseed
- 最近更新
- 2026-11-13
- Stars
- ★ 19
- Forks
- 10
01 前言 Front Matter
- name
- kb-mindmap
- description
- Generate a local multi-level mind map from knowledge-base documents (NotebookLM-style hierarchical JSON for tree visualization), powered by the configured local model with no cloud upload. Use for 生成脑图/思维导图, 梳理文档结构/要点, or when the user opens the mind-map action in the knowledge-base Q&A panel. Do not use when the request targets a single conversation message instead of KB materials, or when no KB documents are selected.
02 资源文件 2
- 参考文档_meta.json64 B
- 参考文档references/skill-spec.md3.0 KB
03 SKILL.md 正文
kb-mindmap — 知识库多级脑图(本地化 notebooklm mind-map)
改造自
NotebookLM相关skill/notebooklm:保留其 mind-map 产物协议(层级 JSON, 供可视化工具),执行引擎从 Google NotebookLM 云换为 CogSeed 本地—— 基于知识库文档要点,由本地 LLM(DeepSeek,auth.listModels已配置模型)生成 3–4 层思维导图,全程不上云(符合 CogSeed「本地推理 · 资料不上云」)。
激活
- 知识库问答区「🧠 生成脑图」按钮(整库作用域);或对话中意图「生成/梳理脑图 / 思维导图」。
- 知识库文件右键 / 「…」菜单「生成脑图(本文档)」:文档级作用域,根主题 = 这一份文档。
能力
| 能力 | 本地实现 | 产物 |
|---|---|---|
| 多级思维导图 | IPC kb.mindmap(features/kb_mindmap.ts):库内 ready 文档要点 → 本地 LLM → 层级 JSON |
层级 JSON(协议对齐 NotebookLM mind-map) |
| 渲染 | renderer _mmTreeSvg:多级水平树,渐变圆角节点、曲线连线、hover 高亮 |
对话区可交互 SVG |
产物协议(层级 JSON)
{
"root": {
"label": "中心主题",
"children": [
{ "label": "分支1", "children": [ { "label": "子节点1a", "children": [ { "label": "叶子1a-1", "children": [] } ] } ] },
{ "label": "分支2", "children": [] }
]
}
}
- 一级分支 2–8 个、3–4 层、节点总数 ≤120;每个节点仅
label与children两个字段 (source可选,用于溯源); - 与
notebooklm download mind-map ./map.json的层级结构同构,可直接被第三方可视化工具消费。
数据源与缓存
- 输入作用域三档(
kb.mindmap的text>doc>dir/spaceId):dir/spaceId:整库 ready 文档要点(根主题 = 这个库是什么,多文档库里一级分支 容易退化成"按文件分");此时mindKey为dir:<目录>/space:<空间>;doc:单文档(根主题 = 这份文档的主题,一级分支 = 它的章节),mindKey为doc:<相对路径>; 共享库文件需同时传spaceId;库里查不到该 ready 文件 → 降级原因not-found;- 三档都复用
kb_summary.collectReadyDocs(标题块优先 + 全文等距取样,单文件 ≤12k 字、整库 ≤40k 字);
- 作用域回执:返回值带
scope(doc/dir/space/text)与files(实际纳入的文件), 渲染层必须校验"请求 doc ⇒ scope=doc 且 files 恰好是那一份",不匹配就丢弃结果—— 防止主进程版本未重启/参数被忽略时,把整库脑图冒充成"本文档脑图"; - 库指纹缓存(rel_path/mtime/chunks 哈希),同指纹不重复调模型;
- 无文档或模型失败 → 降级为单节点
{label:"知识库",children:[]},不报错卡死。
边界
- 只读管线:不写 chats / artifacts;模型调用
disableTools: true仅生成结构; - 不依赖 Google NotebookLM 云 / OAuth / 网络。
04 同仓库更多 Skills
sample-supply-chain
供应链样本:安装钩子 + 拼写伪装 + 源覆盖。
sample-prose-only
纯散文安全守则样本:禁止某行为的说明不等于该行为。
sample-obfuscated
混淆载荷样本:解码与执行共现。
sample-hidden-content
隐藏内容载荷样本:用于回归「不可见字符不做上下文降权」这一不变量。
sample-evasion
反规避样本:危险内容只以「不可见字符切断」与「编码后」两种形式出现。
sample-agentic
代理运行时风险样本:配置篡改 + 隐蔽指令。