AIS-OS /3d-brain完全指南:把散落笔记变成可探索的3D知识星球

原创2026-10-11 12:16:091,765 阅读

AIS-OS /3d-brain完全指南:把散落笔记变成可探索的3D知识星球

AIS-OS 是一款免费的 AI Operating System(AI 操作系统)starter kit,专为 Claude Code 和 Codex 打造,能把你散落在各处的本地笔记、项目文档、AI 记忆,快速变成一颗可旋转、可搜索、可"播放生长过程"的3D知识星球。核心技能 /3d-brain 正是这套"个人 AI 操作系统"的可视化入口:零部署、纯本地运行,新手也能在 5 分钟内看到自己的知识宇宙。🌌

/3d-brain 是什么?它能帮你做什么

AIS-OS 包含 5 个技能:/onboard、/audit、/link、/level-up 和 /3d-brain,覆盖"初始化 → 连接知识 → 验证 → 迭代 → 可视化"的完整闭环。而 /3d-brain 解决的是一个很常见的问题:

你的知识明明存了不少,但散落在不同文件夹、不同 AI 的记忆里,平时根本想不起来、串不起来。

运行 /3d-brain 后,它会把你在本地选定的 Markdown / 文本文件变成一颗交互式 3D 知识星球:

  • 每颗"星星"是一条笔记,颜色代表所属分类(业务知识、会议记录、项目笔记、AI 记忆等)
  • 笔记之间真实的 Markdown 链接 / wikilinks 会变成星球间的连线
  • 支持搜索、点击读原文、Cinema 演示模式和"知识生长"动画回放

AIS-OS /3d-brain 生成的3D知识星球预览:深色星空中一颗发光的中央星球,左侧按分类统计笔记数量,底部有 Play demo 与 Cinema 按钮

上面的预览来自官方示例演示 3d-brain-preview.gif,完整高清版演示视频保存在 3d-brain-demo.mp4。

快速上手:3步生成你的3D知识星球

第1步:准备环境与克隆仓库

只需一个前提条件:Node.js 22 或更新版本(渲染器已预构建,无需 npm install)。

将 AIS-OS 克隆到本地工作目录:

git clone https://gitcode.com/gh_mirrors/ai/AIS-OS

第2步:运行 /3d-brain 并回答两个问题

  • Claude Code:输入 /3d-brain
  • Codex:在技能选择器中选 3D Brain,或输入 $3d-brain

技能会依次问你两个问题(流程详见 SKILL.md):

  1. 你的大脑叫什么名字? —— 例如 "Atlas Brain"、"我的第二大脑",这个名字会显示在页面中央
  2. 想展示哪些分类? —— 系统会列出它实际找到的分类和对应文件夹路径,你可直接采用、改名或增删;为了画面清爽,建议选 3~7 个分类(最多支持 12 个)

第3步:启动本地服务

技能会在 apps/3d-brain/ 生成你的专属应用,然后执行:

node serve.mjs

打开浏览器打印出的 localhost 链接(默认端口 4640),你的 3D 知识星球就亮了 ✨

核心功能一览:让知识星球"活"起来

功能 操作 说明
Play demo 按 D 约 29 秒内,看大脑从 1 个核心想法沿真实连接生长成完整星球
Cinema 按 C 隐藏界面进入演示视图,适合投屏向他人展示
搜索 按 / 输入关键词快速定位笔记
交互视角 拖拽 / 滚轮 环绕视角、缩放,播放动画时依然可用
读原文 点击节点 在页面内直接查看笔记内容,原文件只读不改
分类开关 点击来源按钮 切换显示/隐藏分类;Shift+点击可"独显"一个分类

🎬 小提示:生长回放展示的是知识之间的连接关系,而非历史记录时间线——它回答的是"哪些想法彼此相连",而不是"哪条笔记先写"。

支持哪些知识来源?数据格式怎么配

来源 支持方式
Markdown / 文本笔记 ✅ 直接支持,递归扫描 .md 与 .txt,解析 frontmatter(title、tags、updated 等)并识别文件间链接
Codex 记忆 ✅ 专用适配器,读取 curated memory 摘要,自动排除原始会话日志、凭据等敏感内容
Claude 记忆 / 会议纪要 / 视频笔记 ✅ 以选定的 Markdown 文件夹形式接入
Notion、Google Drive、PDF、数据库 ⚠️ 需先导出为本地 Markdown,或自行编写并测试适配器

个性化配置(名称、分类、颜色、路径、端口)全部写在本地 brain.config.json 中,字段含义与默认值可参考 config.md。默认最多扫描 3000 条笔记(上限 10000),超过会给出提示而非静默截断。

隐私与安全性:数据完全留在本地

  • 服务只绑定 127.0.0.1,仅本机能访问,数据不上传任何在线服务
  • 对源笔记只读,原始文件永不修改
  • 个人配置与生成的图数据默认被 gitignore,不会误提交到仓库
  • 本地配置和数据说明见 Your 3D Brain

新手常见问题 FAQ

Q1:端口 4640 被占用了怎么办? 技能会自动挑选一个可用端口并更新本应用的配置,无需你手动改;如果你只改端口不改代码,改完重启服务即可生效。

Q2:我的 AIOS 笔记很少甚至为空,能生成吗? 可以,但空分类会"诚实地"显示为空,而不是用合成内容凑数。建议先跑一轮 /onboard、用 /link 把重要来源登记进来,积累一段时间再运行 /3d-brain,效果最好。

Q3:生长回放是时间线吗? 不是。它按笔记间的真实连接展开分支,用来直观理解"哪些知识彼此关联";没有连接的笔记会如实保持孤立,不会被发明出不存在的连线。

写在最后:把它纳入你的 AI OS 工作流

推荐的完整路径是:

  1. Day 1:/onboard 完成 7 问访谈,生成你的 Day-1 文件集
  2. 日常:用 /link 把新项目、新资料"路由"进来
  3. Day 7:/audit 验证系统可用性
  4. Day 14 起:每周 /level-up,配合 Three Ms 框架 持续改进
  5. 随时:/3d-brain 看看你的知识星球又长大了多少 🧠

技能完整资料(源码、浏览器端、配置文档与验证脚本)都放在 .claude/skills/3d-brain/,动手试试,让"Every idea. Connected." 成为你自己的工作台。

登录后查看全文
AIS-OS