Brain DB · Brain Database
面向职场人士的循证脑科学工作台
An evidence-based brain-science workspace for working professionals.
Brain DB 把"循证脑科学内容"和"AI 思维工具"绑在了一起：
- 72 张学术级知识卡片 — 覆盖 11 个脑科学领域（含 2025–2026 新增的神经递质全景、HPA 轴、神经胶质、血脑屏障、神经发生、神经炎症、神经神话破除、ADHD/AD/PTSD 病理锚点、脑间耦合等），每张都带中英学术引用与方法学局限标注
- 9 条结构化学习路径 — 按目标串好的卡片序列（如"压力管理大师""高效能""心理健康 360"）
- 6 套脑科学模板 — 决策、复盘、SOP 写作、专注会话等高频场景
- 8 套 AI 操作 — 通用动作（展开 / 精炼 / 整理 / 总结 / 发散）+ 脑科学专属（解读 / 实践 / 自测题）
- 4 种平台模式 — 脑科学百科、思维导图、专注训练、脑力测评
不是一个普通的"AI 脑图工具"——它是有内容底蕴的脑图工具。
最近一次整体评估：2026-09-08
| 维度 | 数据 |
|---|---|
| 知识卡片 | 72 张（11 个领域） |
| 学习路径 | 9 条 |
| 模板 | 6 套 |
| Prompt | 6 套 |
| 内容字数 | ~21 万字（v2.0 扩建后） |
| 前端代码 | 5301 行（22 个 .ts/.tsx 文件） |
| 测试 | Vitest 单元测试（treeUtils / prompts / mindmapStore）+ Playwright 5 条 e2e 烟雾 |
| Phase 完成度 | Phase 1–7 全完（51/51）；Phase 8 完成 5/10（50%） |
| 协议 | MIT |
根目录 *.md (YAML frontmatter + 双语正文)
│
│ npm run build:corpus ← 自研极简 YAML 解析 + schema 校验
▼
corpus/*.json + web/src/data/brainKnowledge.ts
(JSON 索引) (前端 import 的 TS，自动生成)
- 唯一内容真源是 markdown frontmatter + 双语正文
scripts/build-corpus.ts同时生成corpus/JSON 与web/src/data/brainKnowledge.ts- 校验先于落盘：domain 不在枚举、必填字段缺失、id 重复、非空字符串、数组元素非字符串 →
process.exit(1)，零坏数据入仓 - 卡片生产管线：文献 → 结构化卡 → 社区共创审核 → 周更节奏
src/
├── store/mindmapStore.ts (720 行 · Zustand)
│ ├── mindmap tree + selection + history（post-snapshot 栈 · 50 步）
│ ├── platform mode + selectedBrainCard
│ ├── focusSessions + assessments
│ └── customActions + syncStatus
├── services/
│ ├── llm.ts (OpenAI 兼容 + Ollama 双轨 · SSE 流式 · AbortController)
│ ├── localDb.ts (idb · IndexedDB 持久化)
│ └── cloudSync.ts (last-write-wins 简化同步)
├── utils/ (treeUtils / templates / prompts / share)
├── hooks/ (markmapContext + useMarkmap)
└── components/
├── MindMap/ (Canvas + Search + SessionHistory + TemplateGallery)
├── BrainPedia/ (Panel + KnowledgeCard)
├── FocusTraining/ BrainAssess/ NodeActions/ Settings/ Toolbar/
| 维度 | 评分 | 备注 |
|---|---|---|
| 内容深度 | ⭐⭐⭐⭐⭐ | 真正的科研级内容 |
| 架构清晰度 | ⭐⭐⭐⭐ | 内容/前端/状态/服务分层干净，store 略胖 |
| 工程纪律 | ⭐⭐⭐½ | 最近修复都在收紧（dead code 删除、undo/redo 重写、e2e locale 稳定） |
| 测试覆盖 | ⭐⭐⭐ | 核心纯函数覆盖好，CI 没接测是扣分项 |
| 功能完整度 | ⭐⭐⭐⭐ | Phase 1–7 全完 + Phase 8 一半，超出 MVP 不少 |
| 综合 | ⭐⭐⭐⭐（4/5） | "内容驱动 + 工具完整"型项目 |
brain-database/
├── fundamentals/ # 🧠 大脑基础 25 cards（含 17 张 2025-2026 新增）
├── attention/ # 🎯 注意力管理 5 cards
├── memory/ # 💾 记忆技巧 5 cards
├── decision/ # ⚖️ 决策优化 6 cards
├── creativity/ # 💡 创造力激发 4 cards
├── emotion/ # 💚 情绪管理 4 cards
├── stress/ # 🌊 压力管理 4 cards
├── sleep/ # 🌙 睡眠与大脑 4 cards
├── learning/ # 📖 学习科学 6 cards
├── collaboration/ # 🤝 团队脑科学 5 cards
├── pathology/ # 🏥 神经病理锚点 3 cards (ADHD/AD/PTSD)
│
├── learning-paths/ # 🚀 学习路径 9 paths
├── templates/ # 📋 脑科学模板 6 templates
├── prompts/ # 🤖 AI Prompt 系统 6 prompts
│
├── schema.md # 数据模型说明
├── corpus/ # 生成的 JSON 索引（.md → JSON）
├── scripts/ # 构建脚本（build-corpus）
├── GTM/ # Go-to-Market 策略页（GTM/index.html 单文件可直接打开）
│
├── web/ # Web UI（React 19 + Vite 8 + Markmap）
│ ├── src/
│ │ ├── components/
│ │ │ ├── BrainPedia/ # 脑科学百科
│ │ │ ├── MindMap/ # 思维导图画布 + 搜索 + 会话历史 + 模板
│ │ │ ├── FocusTraining/ # 专注训练
│ │ │ ├── BrainAssess/ # 脑力测评
│ │ │ ├── NodeActions/ # 右键 AI 菜单
│ │ │ ├── Settings/ # 设置 + 导出
│ │ │ └── Toolbar/ # 顶部工具栏 + 键盘快捷键
│ │ ├── store/ # Zustand 状态（撤销/重做 50 步）
│ │ ├── services/ # LLM 客户端（OpenAI 兼容 + Ollama 本地）
│ │ ├── hooks/ # Markmap 生命周期
│ │ ├── utils/ # 树结构工具 + prompt 模板
│ │ └── types/ # TypeScript 类型
│ ├── e2e/ # Playwright 烟雾测试
│ └── public/ # 静态资源 + PWA manifest
│
├── package.json # Monorepo 编排（workspaces: [web]）
└── README.md
每个领域目录包含：
_index.md— 领域概述{card-id}.md— 知识卡片（含 YAML frontmatter 元数据 + 中英正文）
# 1. 装依赖（根目录 npm install 即可，workspaces 会自动装 web/）
npm install
# 2. 启动开发服务器
npm run dev # → http://localhost:5173
# 3. 从 .md 重新生成 corpus JSON + 前端数据（修改了卡片后跑）
npm run build:corpus
# 4. 生产构建
npm run build # → web/dist/
# 5. 跑测试
cd web && npm test # Vitest 单元测试
cd web && npm run test:e2e # Playwright 烟雾测试第一次跑记得在网页右上角点 ⚙️ Settings 配 LLM：
| 预设 | Base URL | 备注 |
|---|---|---|
| Kimi K2.5 | https://api.moonshot.cn/v1 |
国内可用 |
| OpenAI GPT-4o | https://api.openai.com/v1 |
海外 |
| Ollama（本地） | http://localhost:11434/v1 |
无需 API Key |
| 自定义 | 任意 OpenAI 兼容端点 | 填 Base URL + Key |
API Key 只存在浏览器 localStorage，不上云。
| 模式 | 说明 |
|---|---|
| 🧠 脑科学百科（BrainPedia） | 左侧卡片浏览 + 右侧导图联动；点卡片看详情，导图自动定位关联节点 |
| 🗺️ 思维导图（MindMap） | 沉浸式全屏导图，AI 扩展开启头脑风暴 |
| ⏱️ 专注训练（Focus） | 基于神经科学的番茄钟，附专注度自评 |
| 🧪 脑力测评（Assessment） | 工作记忆 / 注意力 / 决策倾向自测 |
通用（思维导图右键菜单）：
| Action | 说明 |
|---|---|
| Expand | 给当前节点生成子主题 |
| Refine | 优化文字表述 |
| Reorganize | 合并 / 排序 / 重分类子节点 |
| Summarize | 把子树压成精炼摘要 |
| Brainstorm | 自由联想发散 |
脑科学专属（知识卡片侧栏）：
| Action | 说明 |
|---|---|
| Explain | 从脑科学角度解读当前主题 |
| Apply | 生成脑科学实践建议 |
| Quiz | 出几道自测题巩固知识 |
支持流式响应 + 取消（点 streaming 卡片上的 ⏹ 按钮）。配置 Ollama 后无需 API Key 即可用。
---
id: fund-prefrontal
domain: fundamentals
title: "前额叶皮层：你的CEO"
titleEn: "Prefrontal Cortex: Your Inner CEO"
difficulty: beginner
icon: "🎓"
relatedCards: [fund-amygdala, stress-response, emo-cognitive-reappraisal]
---
# 🎓 前额叶皮层：你的CEO
## 核心概念
...
> PFC handles executive functions: decision-making, planning, and self-control
## Core Concepts
...各领域 .md 文件是唯一内容真源。修改 .md → 跑 npm run build:corpus → 同时产出 corpus/ JSON 索引和 web/src/data/brainKnowledge.ts（前端直接 import 的卡片数据，自动生成、勿手改）→ 前端重新构建即可看到新内容。构建时会对卡片做 schema 校验（域枚举、必填字段、难度取值），校验失败则拒绝写入并以非零码退出。
- React 19 + TypeScript 5.9（strict + noUnused*）
- Vite 8 — 构建
- Markmap — 思维导图渲染（SVG + D3）
- Zustand 5 — 状态管理（post-snapshot undo/redo 栈，50 步；localStorage 持久化）
- Tailwind CSS 4 — 样式
- Lucide React — 图标
- Vitest 4 + Playwright — 单元 / E2E 测试
- idb — IndexedDB（本地优先存储）
- 基础脚手架 · Zustand store · LLM 流式服务 · Markmap 引擎
- 关键 bug 修复（节点 ID 注入、双击编辑、Toolbar 缩放、AI Summarize 误清空等）
- UX 打磨（节点选中态、流式预览、撤销/重做、节点拖拽、搜索面板）
- 进阶功能（节点颜色、多选、自定义 prompt action、会话历史、分享链接）
- 质量（ARIA · 响应式 · ResizeObserver · 单元测试 65+ · E2E 5 条 · PWA · 错误边界）
- 增长（GitHub Pages · OG 图 · 插件系统 · 模板画廊）
- 代码质量（删除
countNodes/getMaxDepthdead code · undo/redo 重写为标准 post-snapshot 栈）
| # | 任务 | 状态 |
|---|---|---|
| 8.1 | Ollama 本地 AI | ✅ Done |
| 8.2 | 性能优化（deepClone 削减 + 节点虚拟化） | ✅ Done |
| 8.3 | 节点附件（图片 / URL / 笔记） | ✅ Done |
| 8.4 | Immer migration | ⏳ TODO（无 immer 依赖；store 仍用 deepCloneTree，见 web/src/store/mindmapStore.ts） |
| 8.5 | CRDTs + IndexedDB 协同 | ⏳ TODO |
| 8.6 | 云同步（Supabase / Firebase） | ⏳ TODO |
| 8.7 | VS Code 插件 | ⏳ TODO |
| 8.8 | 插件市场 | ⏳ TODO |
| 8.9 | Open API（REST / GraphQL） | ⏳ TODO |
| 8.10 | 撤销/重做重构 + 取消 skipped 测试 | ✅ Done |
详细见 web/DEVELOPMENT.md。商业化策略见 GTM/index.html（单文件策略页，含品类定位、ICP、定价、90 天发布计划）。
按优先级排列，详见
web/DEVELOPMENT.md与各 commit message。
| 优先级 | 项 | 说明 |
|---|---|---|
| P2 | Immer 文档对齐 | ✅ 已对齐（2026-09：Phase 8.4 改回 TODO，README 同步；未来要真做时再装包使用） |
| P0 | CI 不跑测试 | .github/workflows/deploy.yml 只 npm run build 不跑 npm test。建议加 npm test + npm run build:corpus 校验 |
| P1 | lockfile 体系混乱 | 根 package-lock.json + web 内 pnpm-lock.yaml 共存。建议统一到 npm 或 pnpm workspace |
| P1 | 自研 YAML 解析脆弱 | build-corpus.ts:23-48 不支持嵌套对象 / 多行字符串 / 转义。建议改用 gray-matter |
| P1 | API Key 安全提示 | localStorage 明文存 Key，Settings 页应明示"DevTools 可见" |
| P2 | cloudSync 实现与文档脱节 | Roadmap 列 CRDT + IndexedDB 为 TODO，但代码已写 last-write-wins 简化版 |
| P2 | 测试覆盖盲区 | SSE 流式解析、组件快照、localDb mock 缺覆盖 |
| P3 | detail 字段兜底 | 67/72 卡片走 detail = summary，内容密度可继续提 |
| P3 | 引用校验脚本 | 100+ 引用全是裸字符串，无脚本验证 DOI/PMID/URL 真实性 |
详见
GTM/index.html的商业化策略；这里聚焦产品工程方向。
- CI 加测试 stage：卡死"修了 store 但忘了跑 e2e"的情况，5 分钟搞定
- Immer 文档对齐：✅ 已完成（2026-09）— Phase 8.4 改回 TODO，README/DEVELOPMENT.md 同步；若未来要做，再装包 + 在 store 使用
build-corpus.ts改用gray-matter：去掉自研 YAML 解析，最大潜在故障点
- 启用「文献 → 结构化卡 → 社区共创审核」流水线，72 → 150 张卡片目标
- 增加引用校验脚本（DOI/PMID 真实性 + URL 可达性）
- glossary 翻译术语表，保证中英术语一致
完整策略见
GTM/index.html
- Phase 0–1（W1–6）：Landing Page + 50 人种子群 + 激活链路 P50 < 5min
- Phase 2（W7–10）：公测发布 + GitHub 1k stars + Product Hunt 英文试水
- Phase 3（W11–13+）：Pro ¥25/月灰度 + 模板画廊 UGC + 3 家企业 POC
- 北极星指标：周学习会话数（90 天目标 1,200/周）
- Yjs + IndexedDB 协同编辑：让"个人脑图工具"升级为"团队脑图工具"
- VS Code 插件：开发者场景 = 学习路径 × IDE 集成
- Open API + 插件市场：把"内容飞轮"开放为生态
5 张高质量知识卡片，覆盖职场脑科学的前沿议题：
| 卡片 ID | 域 | 主题 | 难度 |
|---|---|---|---|
fund-predictive-processing |
大脑基础 | 预测处理 / 主动推断理论（Karl Friston 框架） | 进阶 |
fund-gut-brain-axis |
大脑基础 | 肠脑轴与认知表现——"第二个大脑"的神经科学 | 中级 |
learn-ai-augmented-learning |
学习科学 | AI 辅助学习对记忆巩固的重塑与风险 | 中级 |
collab-social-baseline |
团队脑科学 | 社会基线理论——远程工作的隐性认知代价 | 中级 |
dec-interoception |
决策优化 | 内感受与决策——身体信号如何塑造每个决定 | 进阶 |
新增 21 张深度卡片，按"地基层 → 应用层 → 病理层 → 协作层"递进：
- 神经化学地基层（6 张）：神经递质全景 / GABA / 谷氨酸 / 血清素 / 乙酰胆碱 / 去甲肾上腺素
- 结构与系统地基层（4 张）：神经胶质 / 血脑屏障 / HPA 轴 / 成人神经发生
- 网络与系统层（3 张）：三网络模型（DMN/CEN/SN）/ 神经炎症 / 昼夜节律分子机制
- 方法学 + 批判性思维层（2 张）：神经成像方法学 / 神经神话破除
- 跨域健康应用层（2 张）：运动与脑 / 营养与脑
- 神经病理锚点（新领域
pathology，3 张）：ADHD / 阿尔茨海默早期 / PTSD - 协作高阶层（1 张）：脑间耦合 Hyperscanning
关键研究亮点：
- 2017 诺奖（Hall, Rosbash, Young）：分子时钟机制
- 2023 NEJM Lecanemab 首个 AD 阳性 DMT RCT
- 2017 PNAS 神经科学 1000 个脑 MRI 形态参考
- 2014 诺奖 STED/PALM 超分辨显微镜
- 2017 诺奖 PET-MRI 多模态融合
- 2020s NLRP3 炎症小体在抑郁/AD 中的核心地位
- 2022 ENIGMA 大规模脑结构 GWAS（50+ 万人）
每张卡片按"最高标准"质量：循证医学引用、标注研究方法局限、区分基础/临床研究、引用经典教科书 + 近期权威综述。
MIT