探索浩瀚的博客宇宙，寻找彼此之间的联系。每个节点是一个博客，每条连线是一段友链关系。
法律合规说明： 网站所有者和投稿者必须确保其发布内容及网站运营遵守中华人民共和国以及适用情况下的美利坚合众国法律法规。
请确保： 你的站点使用 https 并可以在中国大陆访问。
在 links/{你的域名}.yml 中填写：
site:
name: 我的博客
description: 分享编程和技术相关的文章
url: https://example.com
color: "#ff6600" # 可选，自定义节点颜色（16 进制）
links: /links # 友链页面路由（必填）
friends:
- name: 编程小站
url: https://codehub.example.com提交 PR 即可。
友链页面路由常见值：
/links、/link、/friends、/friend、/links.html等。
- 自定义 ShaderMaterial — 菲涅尔 rim 光照，比 MeshStandardMaterial 轻 20 倍+
- 果冻透明球体 — 中心透明、边缘半透发光，无多边形感
- Points 光晕层 — 径向渐变纹理 + AdditiveBlending，节点外围发光
- 度数驱动大小 — 连接越多的博客节点越大（
deg^0.38缩放） - 12×8 球体分段 — 与 MeetBlog 一致的平滑度
- 24 色明亮调色板 — HSL 调亮保持高饱和度，黑色背景下清晰可见
- 贝塞尔曲线 — 每条边二次贝塞尔插值，6 段细分，曲率自然
- 颜色渐变 — 从源节点颜色渐变到目标节点颜色
- AdditiveBlending — 加法混合发光，非普通灰色线条
- 流动粒子 — 500 个粒子沿边运动，形成能量流动效果
- UnrealBloomPass — 可调节泛光强度（0~2，默认 0.08）
- 渲染节流 — 空闲自动降帧（60→30→15→8fps），减少 GPU 压力
- BFS 最短路径 — Rust NAPI-RS 原生加速计算
- 金色贝塞尔管道 — 沿曲线分段圆柱，步进导航
- 高亮覆盖 — 聚焦/悬停使用节点本色而非固定颜色
| 操作 | 效果 |
|---|---|
| 左键点击节点 | 在新标签页打开网站 |
| 右键点击节点 | 聚焦该节点（相机拉近、光晕连线） |
| 拖拽 | 旋转 3D 视角 |
| 滚轮 | 缩放 |
| 顶部搜索框 | FlexSearch 模糊搜索（毫秒级） |
URL ?local=域名 |
自动聚焦指定节点 |
| 参数 | 范围 | 默认值 | 说明 |
|---|---|---|---|
| 连线透明度 | 0~1 | 0 | 基础线网透明度（加法混合发光不受影响） |
| 飞船速度 | 5~100 | 15 | 飞船模式 WASD 飞行速度 |
| 泛光强度 | 0~2 | 0.08 | UnrealBloomPass 泛光强度 |
| 节点辉光 | 0~3 | 1.0 | 节点光晕亮度倍数 |
| 线条辉光 | 0~3 | 1.0 | 边颜色亮度倍数 |
| 节点标签 | 开/关 | 开 | 3D 文字标签显隐 |
所有参数自动持久化到 localStorage，刷新页面保持上次设置。
| 按键 | 功能 |
|---|---|
| WASD | 前后左右飞行 |
| R / F | 上升 / 下降 |
| Q / E | 横滚 |
| Shift | 加速 3× |
| Space | 自动驾驶切换 |
| 技术 | 说明 |
|---|---|
| InstancedMesh | 37K+ 节点单次 draw call |
| LineSegments | 76K+ 边合并为单一 BufferGeometry |
| Points | 光晕 / 粒子 / 背景星群各单次 draw call |
| Bloom 后处理 | threshold=0.3 仅亮部泛光，暗部不受影响 |
| 光晕像素上限 | clamp(1.5, 48.0)，密集区不叠加为白色 |
| 光晕透明度 | 0.60，加法混合叠加柔和 |
| 空闲降帧 | 1秒无操作 → 30fps，3秒 → 15fps，10秒 → 8fps |
总 draw calls：~6 次（节点×1、光晕×1、连线×1、粒子×1、背景星群×1、后处理×1）
| 端点 | 格式 | 说明 |
|---|---|---|
/graph-core.bin |
msgpack + zstd 二进制 | 核心图数据（节点、边、邻接表），首屏优先加载 |
/graph-bezier.bin |
msgpack + zstd 二进制 | 贝塞尔曲线数据，核心图加载后异步获取 |
/all.json |
JSON | 完整站点数据（外部使用） |
links/*.yml → Content Collection (校验) → build-graph.ts (力导布局+贝塞尔预计算)
→ graph-core.bin.ts (msgpack+zstd) → /graph-core.bin
→ graph-bezier.bin.ts (msgpack+zstd) → /graph-bezier.bin
→ 客户端 fetch → msgpackr 解码 → zstd 解压 → Three.js 3D 渲染
项目使用 Bun 管理依赖：
# 安装依赖
bun install
# 启动开发服务器
bun run dev
# 构建生产版本
bun run build
# 代码检查与格式化
bun run lint
bun run fmtsrc/
├── pages/
│ ├── graph-core.bin.ts # msgpack+zstd 核心图数据端点
│ ├── graph-bezier.bin.ts # msgpack+zstd 贝塞尔曲线数据端点
│ ├── all.json.ts # 完整站点数据端点
│ ├── stats.json.ts # 统计端点
│ └── index.astro # 主页面
├── scripts/
│ ├── graph3d/ # 3D 渲染模块
│ │ ├── index.ts # 初始化、交互、控制面板、API
│ │ ├── renderer.ts # Three.js 渲染管线（节点/连线/光晕/粒子/Bloom）
│ │ ├── interaction.ts # Raycaster 交互层
│ │ ├── pathfinder.ts # BFS 路径查找
│ │ └── utils.ts # 调色板、颜色工具、标签工厂
│ └── index-client.ts # 客户端入口
├── components/
│ └── starwind/ # Starwind UI 组件（Button/Dialog/Spinner）
├── utils/
│ ├── build-graph.ts # 图构建（力导布局+贝塞尔预计算，模块级缓存）
│ ├── sites.ts # Astro Content Collection 站点加载
│ ├── compress.ts # zstd 压缩
│ ├── bezier.ts # 贝塞尔曲线工具
│ ├── sample.ts # DEV 模式确定性采样
│ └── progress.ts # 构建进度条
├── css/ # 样式文件（base/topbar）
├── styles/ # Tailwind CSS v4 + Starwind 主题变量
├── lib/ # 工具函数（cn/clsx）
links/ # 友链 YAML 源文件（核心数据）
types/ # TypeScript 类型定义
24 色明亮调色板，节点颜色由其域名哈希决定。可在 YAML 中通过 color 字段自定义。
#FF6B6B #4ECDC4 #45B7D1 #96CEB4
#FFEAA7 #DDA0DD #98D8C8 #F7DC6F
#BB8FCE #85C1E9 #F0B27A #82E0AA
#F1948A #7FB3D8 #AED6F1 #A3E4D7
#FAD7A0 #D2B4DE #FF8C94 #96E6A1
#81ECEC #FFA07A #C8A2C8 #87CEEB
| 层级 | 技术 |
|---|---|
| 框架 | Astro 7 + Tailwind CSS v4 |
| UI 组件 | Starwind UI（Button/Dialog/Spinner） |
| 3D 引擎 | Three.js (r185) + EffectComposer + UnrealBloomPass |
| 力导布局 | d3-force-3d + Rust NAPI-ROS native addon（@xingwangzhe/force-rs） |
| BFS 路径 | Rust NAPI-RS native addon（@xingwangzhe/bfs-rs） |
| 搜索 | FlexSearch |
| 数据序列化 | msgpackr |
| 包管理器 | Bun |