my-second-brain1

个人知识库静态站点：将 Obsidian vault 发布为可浏览、可搜索的 Web 应用，并叠加 桌面 OS 壳（壁纸、小组件、控制中心）与 浏览器内交互工具（Python、数学实验室、神经网络、关系图谱等）。

在线演示： my-second-brain1.pages.dev 当前版本： 1.5.0 · 协议： MIT

目录

• 项目概述
• 功能一览
• 技术栈
• 系统架构大纲
• 快速开始
• 仓库结构
• 路由与页面
• 核心模块说明
• UI 皮肤（13 套）
• 桌面小组件
• 常用命令
• 部署
• 模型与体积约束
• 文档索引
• 复现所需知识
• 开源协议
• 贡献

项目概述

本项目采用 静态站点生成（SSG）+ 客户端岛屿（Islands） 架构：

• 知识库 + 个人 OS 壳 共用同一域名与状态持久化
• 3D Gaussian Splatting 作为全屏环境壁纸，而非独立漫游查看器
• 13 套 UI 皮肤，其中 11 套沉浸式主题带 NASA-punk 风格任务 chrome（状态条、CLI 搜索、滚动高度计）
• 统一设计系统：语义 CSS 变量 + 子页面与首页 mac 皮肤对齐（配色 / 字体 / 间距 / 圆角 / 阴影）
• 多种 GPU / Worker 计算栈在同一 SPA 内通过 Tab 级与 visibility 级 资源仲裁 共存

功能一览

知识库（PKM）

• Obsidian Markdown → 静态笔记页（/notes/*）
• Wiki 双链 [[page]]、Callout、![[image]] 嵌入
• KaTeX 数学、Mermaid 图表、GFM 表格
• 反向链接、大纲、标签 / 文件夹浏览
• 构建期双链图 → 关系图谱 Explorer

桌面 OS 壳

• 可拖拽、可缩放、状态持久化的小组件层
• 三模互斥壁纸：视频 / 海报 / 3DGS 点云
• HUD 专属 Canvas 实时壁纸（星场、星云、视差）
• 控制中心：小组件开关、壁纸设置、UI 皮肤切换、Spotlight 搜索
• 氛围层：雨滴、樱花、白噪音、全局静音

笔记页工具（独立于桌面）

在 /notes/*、/folder/*、/tags/* 可通过 FAB 侧栏启用 Python、MATLAB、白板，状态键 second-brain:notes-tools 与桌面小组件分离。

系统架构大纲

详细设计见 docs/TECHNICAL_REPORT.md。

快速开始

注意： 必须使用 --recursive 克隆以拉取 obsidian-vault 子模块；Cloudflare Pages 部署需开启 Include git submodules。

仓库结构

设计系统与主题

子页面（笔记、工具、图谱等）与首页 mac 皮肤共用语义变量与组件类：

详见 docs/subpage-design-sync.md · docs/theme-color-audit.md。

核心模块说明

1. 笔记与 WikiLink

已存在笔记 → 蓝色链接；未创建目标 → 红色「待建链」。