Show HN: 让您的代理能够可视化您的 gbrain 和 Obsidian

一句话看懂：开发者 vladignatyev 发布了一款开源工具 brain-map-skill，可将 Obsidian 知识库或 gbrain 导出的 Markdown 笔记文件夹，一键生成为一个交互式 HTML 知识图谱。该项目凭借零配置、离线可用、一目了然的时间轴与主题着色能力，迅速成为 Hacker News 24 小时热门。

事件核心：发生了什么

brain-map-skill 的核心是一个 Python 脚本（build_map.py），它读取一个 Markdown 笔记文件夹（支持 YAML 头部中的 tags 与 created 字段及 [[wikilinks]] 双向链接），输出一个自包含的 HTML 文件。该文件包含三大部分：一个按主题着色的力导向知识图、一个可按月份滑动或自动播放的时间线，以及一个点击节点查看详情的侧边面板。

项目提供了预构建的演示文件 demo/brain-map.html，内含 992 条虚构笔记，涵盖工作、学习、生活三个主题，用户无需任何 Python 或笔记即可直接双击打开浏览。对于真实使用，只需运行 python3 scripts/build_map.py <notes_dir> out.html。

工具的核心依赖极轻：纯 Python 标准库即可生成图谱（布局由浏览器端 Cytoscape 的 cose 算法计算）；若安装了 NetworkX、NumPy、SciPy，布局预处理会使图谱更整洁且支持千节点瞬间打开。它不需要任何向量嵌入或服务器，完全离线工作。

项目还以 SKILL.md 的形式提供了一份 Agent Skill 文件，可直接安装到 Claude Code、OpenAI Codex、Cursor、Gemini CLI 等 AI 编程工具中，使 AI 代理能主动生成此类知识图谱。

为什么重要

在大语言模型（LLM）和 RAG 应用遍地开花的今天，大多数笔记可视化方案要么依赖云端 API、要么需要复杂的数据管道（如嵌入、向量数据库）。brain-map-skill 反其道而行：它回归到本地 Markdown 文件本身，利用简单的文件结构（文件夹作为主题、子文件夹或标签作为类型、双向链接作为边）直接生成图谱，门槛低到只需一条命令。这降低了个人知识库可视化的工程成本，尤其适合那些不愿把笔记数据上传到第三方服务器的用户和团队。

此外，将图谱生成封装为 Agent Skill（SKILL.md）是一个有意义的生态动作——它让 AI 编程工具（如 Codex、Claude Code）不再仅仅是代码补全器，而是能主动生成可视化知识结构的“第二大脑”助手。这种“AI 代理 + 本地笔记”的轻量组合，或许比云优先的嵌入方案更符合知识工作者的实际工作流。

对用户/开发者/创作者的影响

个人知识工作者（Obsidian / gbrain 用户）：你现在可以零网络、零配置地从自己的笔记文件夹中生成一份交互式知识地图，用于回顾知识树、发现领域关联，或制作一个可分享的“第二大脑”演示页面。
AI 应用开发者：可以借鉴 brain-map-skill 的做法：将生产力工具的特性封装为 Agent Skill，让 Agent 在对话中直接触发文件生成，而不只是文本回复。这对构建自主工作流代理（从思考到交付可见产物）有很好的启发。
开源社区与低资源场景：该项目纯 Python+HTML，不依赖 GPU、嵌入模型或数据库，可在任何能运行 Python 的环境（如服务器、树莓派、Docker 容器）中快速部署，适合知识管理系统的轻量可视化需求。

值得关注的后续

Skill 生态扩展：当前 SKILL.md 只匹配 Claude Code 与 Codex 等少数代理，未来是否会适配更多 Agent 框架（如 AutoGPT、TaskWeaver）或者提供 MCP 工具接口，将决定其作为 Agent 能力的覆盖范围。
大语言模型支持的增强：目前图谱仅解析 created 字段和文件时间戳。如果后续能引入简单的 LLM 摘要（如让 AI 给笔记自动打标签或提取关键节点），图谱的智能性会进一步提升。
竞品跟进：Obsidian 官方已有 Graph View，但缺少跨文件夹主题可视化与时间轴回放。brain-map-skill 是否会在社区中催生更丰富的插件或工具链整合，值得长期观察。