将一个Markdown笔记文件夹（一个Obsidian保险库或gbrain导出）转换为一个自包含的交互式HTML知识地图——一个按主题着色的力导向图，一个可以拖动的时间轴来观看基础的增长，以及一个点击查看的面板。适用于：Claude Code · OpenAI Codex · Cursor · Gemini CLI · OpenClaw · 或者直接运行脚本。5秒内查看（无需设置）一个预构建的演示包含在这个仓库中——不需要生成笔记，不需要嵌入，不需要gbrain，也不需要Python。打开文件：打开 demo/brain-map.html # macOS xdg-open demo/brain-map.html # Linux start demo/brain-map.html # Windows 992个虚构的笔记分为三个主题（工作 · 学习 · 生活）。拖动时间轴，按▶播放增长，点击节点，切换过滤器。从您自己的笔记中构建 python3 scripts/build_map.py <notes_dir> out.html --title "我的第二大脑" 打开 out.html <notes_dir> = 您的Obsidian保险库，或gbrain导出 --dir <out> 目录。地图读取普通的Markdown：YAML前言（标签，创建） + [[wikilinks]]。依赖项是可选的 设置结果 无（只需stdlib Python） 在任何地方构建；浏览器计算布局（Cytoscape cose）。pip install -r requirements.txt （networkx, numpy, scipy） 布局预计算 → 1000节点地图即时打开并看起来更干净。构建器自动检测networkx并选择更好的路径。无论如何，无需gbrain，无需嵌入，无需服务器。它读取的内容 主题 = 顶级文件夹（工作/，学习/，生活/）→ 节点和边缘颜色。类型 = 子文件夹/标签 → 节点形状（人，会议，日记，讲座，项目，链接，待办事项，索引，笔记）。边 = 解析的 [[wikilinks]]。节点大小根据链接数量缩放；集线器获得标签。时间轴 = 创建时间戳，按月分组，按主题堆叠。您交叉链接的丰富程度（人物卡片，会议参与者，索引页面），地图就越易读。设计成与save-note技能配对，该技能写出正好这种形状。在HTML中 拖动/播放时间轴 → 图表显示截至该月的笔记；播放动画显示整个基础从空到今天的增长。按主题和类型筛选（实时计数）；搜索突出显示匹配项。点击一个节点 → 使其他节点变暗，照亮它的邻域，打开详细面板（摘要，标签，日期，连接的笔记）。响应式设计适应手机。作为代理技能安装 Claude Code git clone https://github.com/vladignatyev/brain-map-skill ~/.claude/skills/brain-map OpenAI Codex git clone https://github.com/vladignatyev/brain-map-skill ~/.agents/skills/brain-map Cursor / 其他 — 将 SKILL.md 粘贴到您的代理指令中；它是自包含的。重新生成演示语料库 python3 scripts/generate_demo_notes.py /tmp/demo-vault # 992个虚构的笔记 python3 scripts/build_map.py /tmp/demo-vault demo.html 所有演示中的人物、组织和事件均为虚构——没有真实数据。目录 brain-map-skill/ ├── SKILL.md # 代理技能规范 ├── scripts/ │ ├── build_map.py # 构建器（Markdown目录→交互式HTML） │ └── generate_demo_notes.py # 编写虚构的演示保险库 ├── demo/ │ ├── brain-map.html # 预构建 — 打开它，无需设置 │ ├── vault/ # 992个源Markdown笔记 │ └── preview.png ├── requirements.txt # 可选：networkx, numpy, scipy └── LICENSE 许可证 MIT