# 架构 · SigmAgent.org · 33 子项目知识图谱实验室 > **2026-06-06 · v1.0.0** — 给新贡献者快速理解整个项目的全貌。 --- ## 一图看全貌 ``` ┌─────────────────────────────┐ │ sigmagent.org (主站枢纽) │ │ - 6 频道 32 分类 SEO 落地 │ │ - 4 语言 zh-CN/en/ja/ko │ │ - 搜索 167 条索引 │ │ - 🎲 随机入口 5 处 │ └──────────┬──────────────────┘ │ 32 topic-card href ┌──────────────┼──────────────┐ ▼ ▼ ▼ ┌────────────────┐ ┌──────────┐ ┌────────────┐ │ sigmagent- │ │ ... │ │ sigmagent- │ │ science- │ │ (32 │ │ tools-quiz │ │ physics │ │ total) │ │ │ │ .pages.dev │ │ │ │ .pages.dev │ └─┬──────────────┘ └──────────┘ └────────────┘ │ │ 每子站独立 git 仓 + CF Pages │ ≈ 620 KB / 1 GB 配额 (0.06%) │ ▼ ┌───────────────────────────────────┐ │ phys/ │ │ ├─ index.html (12 KB · 4 demo) │ │ ├─ 404/index.html / privacy/... │ │ ├─ cases/ (12 案例详情) │ │ │ ├─ demo-01/ │ │ │ ├─ demo-02/ │ │ │ ├─ demo-03/ │ │ │ └─ case-04..12 (9 学习卡) │ │ ├─ engine/ (复制自 sigmagent-engine)│ │ │ ├─ assets/engine.js (2590 行) │ │ │ ├─ assets/style.css │ │ │ ├─ engine-i18n.js / engine-sync │ │ │ ├─ brand/icon-{32,192,256,512} │ │ │ └─ mascots/mascot-piton-physics │ │ ├─ wrangler.jsonc (CF Pages 配置) │ │ ├─ sw.js (cache v3) │ │ ├─ manifest.webmanifest (定制 + maskable)│ │ ├─ sitemap.xml / robots.txt │ │ ├─ _headers (CSP/HSTS/Permissions) │ │ ├─ .github/workflows/deploy.yml │ │ │ └─ push → validate → CF deploy │ │ └─ README/CHANGELOG/CONTRIB/SECURITY/.gitattributes│ └───────────────────────────────────┘ ``` --- ## 闭环导航：用户怎么走也回得来 ``` 主站 任一子站 ├─ topic-card → ────→ ─────→ ├─ 🎲 主站 ──→ 随机 子站 ├─ search-box ──→ 找到子站 └─ 6 频道 anchor ↓ │ │ ← back-home ┘ ← site-nav.logo ← site-nav.主站 ← 6 频道 link ← 🎲 site-nav 随机另一子站 ← 🎲 mobile-dock 随机 ▲ │ topic-path → 兄弟子站 │ ▼ 继续探索 → 又回到这个图 ``` **85+ 处 🎲 入口** + 5 portal + 32 topics + 5 about + 5 404 + 5 privacy + 33 子站 site-nav + 48 mobile-dock = 至少 165+ 入口。 --- ## 部署链路 ``` [本地开发] python3 -m http.server 8000 → 浏览器 localhost:8000 [一行推 33 仓] bash scripts/deploy-all-subprojects.sh apply ↓ gh repo create sigmagent-X --public --source=sigmagent-X --push ↓ npx wrangler pages deploy sigmagent-X --project-name=sigmagent-X ↓ Cloudflare Pages 自动构建 (纯静态，无 build) ↓ https://sigmagent-X.pages.dev (3 分钟内可访问) [GitHub Actions] push main → .github/workflows/deploy.yml 触发 ↓ validate job: Python 扫 broken href/src ↓ deploy job: wrangler-action@v3 → CF Pages ↓ 自动部署完成 + 留 GitHub 部署痕迹 ``` --- ## 核心设计原则 ### 1. **零依赖纯静态** — 不引 npm / 不引外部 CDN - HTML/CSS/JS 三件套，0 build 步骤 - Web Components 自定义元素（无 React/Vue） - 系统字体栈（不下载 Google Fonts） ### 2. **子站自包含** — 每子站可剪切独立运行 - 每子站含 `engine/` 副本（与 `sigmagent-engine/` 一致 md5） - 跨子域链接用绝对 URL（不依赖父站） - localStorage 仅存主题/语言/进度（无 PII，每子站独立） ### 3. **闭环导航** — 用户走任何位置都有出口 - 主→子: topic-card / 🎲 - 子→主: site-nav logo + 主站 link + back-home + 主站 footer link - 子→兄弟: topic-path (3 hard-coded) + 🎲 (随机 31) - 即使 404 → 含 🎲 试个随机 + 回主站 + 回本子站 ### 4. **PWA 优先** — 安装到主屏幕完整体验 - 5 个独立 PWA 应用（主站 + sigmagent-org + 33 子站） - 各自 manifest 含 maskable + shortcuts + display_override - sw.js 离线缓存（cache v13 / v3） - iOS 4 件套 + Win 3 件套 PWA meta ### 5. **多语言一等公民** - 7 语言 i18n 字典 (zh-CN/en/ja/ko/es/fr/de) - 4 语言主页镜像 + 52 页 hreflang + sitemap hreflang - locale-switcher 跨子站同步 (engine-sync.js) ### 6. **GitHub 仓库礼仪** - 34 仓全套对等: CODEOWNERS + dependabot + Issue/PR 模板 + CONTRIB + SECURITY + .gitattributes + .nojekyll --- ## 共享 engine 副本一致性 ``` sigmagent-engine/ ← 唯一源 └── assets/ ├── engine.js (2590 行, 22 plot.kind) ├── engine-i18n.js (7 语言字典) ├── engine-sync.js (跨子站主题/语言同步) └── style.css ↓ python3 scripts/_propagate-engine-js.py ↓ python3 scripts/_propagate-engine-css.py sigmagent-{X}/engine/assets/ ← 33 副本 ├── engine.js (md5 与源一致 ✓) ├── engine-i18n.js (md5 一致 ✓) ├── engine-sync.js (md5 一致 ✓) └── style.css (md5 一致 ✓) ``` 改 engine 必须改 `sigmagent-engine/assets/` 然后跑 `scripts/_propagate-engine-*.py` 同步。 --- ## 22 个互动 demo plot.kind | kind | 升级 iter | 用法 | |---|---|---| | `function` | (基础) | y=f(x) 静态曲线 (12 已升级) | | `projectile` | (基础) | 抛体运动 | | `pendulum` | iter 11 | 真实摆动 (rAF) | | `moon-phase` | iter 12 | 月相自动播放 + ⏸/▶ | | `solar-system` | iter 12 | 太阳系自动公转 | | `gacha-monte-carlo` | iter 13 | 1000 次抽卡模拟 | | `supply-demand` | iter 14 | 供求平衡 E* 求解 | | `linear` | iter 14 | 一次函数 + 截距 + 斜率三角形 | | `punnett` | iter 15 | 显隐性方格 + 后代采样 | | `circle-area` | iter 15 | 圆面积积分思想 | | `plant-growth` | iter 16 | 植物生长动画 | | `rainbow-refraction` | iter 16 | 7 色折射 + 彩虹弧 | | `running-burn` | iter 17 | 跑步小人 + 燃烧累计柱 | | `random-convergence` | iter 17 | Monte Carlo 大数定律 | | `supply-demand` `electrolysis` `predator-prey` `truth-table` `plate-tectonics` `climate-bands` `photosynthesis-rate` `compound-interest` `logistic` | (legacy) | 仍用 function 派生或简化 | --- ## 项目时间线 | 阶段 | 内容 | |---|---| | 2026-06-04 | 老游戏项目（已弃用）| | 2026-06-06 | 重构为 sigmagent.org 知识图谱实验室 | | 2026-06-06 13:00-18:00 | 47 轮 /loop 迭代，全面完善 33 子项目 | | **2026-06-06 18:00** | **首版 v1.0.0 可部署** | --- ## 进一步阅读 - [README.md](../README.md) — 项目入口 + 33 子站索引表 - [CONTRIBUTING.md](../CONTRIBUTING.md) — 贡献流程 - [SECURITY.md](../SECURITY.md) — 安全策略 - [CHANGELOG.md](../CHANGELOG.md) — [1.0.0] 完整发布记录