forcegraph-exporter

用途

Force Graph Exporter 用于把思维导图 JSON 大纲转换为可交互的力导向图网页。输出为单个 HTML 文件，可直接在浏览器中打开，无需服务器。由于 force-graph 库从 CDN（unpkg.com，固定版本）加载，打开该页面时需要互联网连接。

输入格式

输入是一个符合标准思维导图大纲格式的 JSON 文件（与 generate-mindmap 的输出格式相同）：

{
  "root": "Central Theme",
  "branches": [
    {
      "text": "Branch One",
      "color": "#ff6b6b",
      "children": [
        { "text": "Sub-concept A", "children": [...] }
      ]
    }
  ]
}

使用流程

第 0 步：检查输入

如果没有可用的思维导图 JSON（没有文件路径、没有先前的 generate-mindmap 输出、对话中也没有内联 JSON），则先调用 learning:generate-mindmap 技能完成头脑风暴并生成 JSON 大纲，再继续第 1 步。

第 1 步：定位思维导图 JSON

找到思维导图大纲 JSON——可以是用户提供的文件路径、先前 generate-mindmap 调用的输出，或内联 JSON。

第 2 步：运行导出脚本

python scripts/generate_forcegraph.py --input outline.json --output /path/to/mindmap.html --max-depth 6

或从标准输入读取：

cat outline.json | python scripts/generate_forcegraph.py --output /path/to/mindmap.html

选项：

--max-depth N：根节点以下的最大深度层数（默认 6，最大 10）

脚本会执行以下操作：

将思维导图 JSON 树转换为扁平的 nodes/links 结构
在 HTML 中从 CDN（unpkg.com，固定版本）加载 force-graph 库
按 L2 分支颜色为节点和连线着色
按深度设置节点大小（根节点最大，叶子节点最小）
添加标签、悬停提示和点击聚焦
生成单个 .html 文件

第 3 步：交付

将生成的 .html 文件呈现给用户，并说明它可以在任何浏览器中直接打开。

交付前检查清单

HTML 文件在浏览器中打开无报错
思维导图 JSON 中的所有节点都出现在图中
根节点视觉上突出（更大、居中）
分支颜色与原始大纲一致
图形可交互（拖拽、缩放、悬停）
具备互联网连接（force-graph 库依赖 CDN）