AIS-OS /3d-brain完全指南:把散落笔记变成可探索的3D知识星球
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 演示模式和"知识生长"动画回放
上面的预览来自官方示例演示 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):
- 你的大脑叫什么名字? —— 例如 "Atlas Brain"、"我的第二大脑",这个名字会显示在页面中央
- 想展示哪些分类? —— 系统会列出它实际找到的分类和对应文件夹路径,你可直接采用、改名或增删;为了画面清爽,建议选 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 工作流
推荐的完整路径是:
- Day 1:
/onboard完成 7 问访谈,生成你的 Day-1 文件集 - 日常:用
/link把新项目、新资料"路由"进来 - Day 7:
/audit验证系统可用性 - Day 14 起:每周
/level-up,配合 Three Ms 框架 持续改进 - 随时:
/3d-brain看看你的知识星球又长大了多少 🧠
技能完整资料(源码、浏览器端、配置文档与验证脚本)都放在 .claude/skills/3d-brain/,动手试试,让"Every idea. Connected." 成为你自己的工作台。
