AGENTS.md@.github/apps git:20261025.3c17b73A

Immutable. This exact content never changes and is served at /api/v1/blob/89239c9d832e684b.

# AGENTS.md - apps

## 目录用途

`.github/apps/` 承载用户体验入口与渠道壳层，只表达用户如何进入 FateCat，不承载命理领域规则、数据库写入或平台通用能力。

## 目录结构

```text
.github/apps/
├── AGENTS.md
├── bazi-3d-web/
├── bazi-infinite-demo/
├── bazi-math-web/
├── developer-clients/
│   └── python/
└── timeline-web/
```

## 职责边界

- Web、Bot、CLI 等体验壳层如果独立成产品入口，优先落在这里。
- 领域计算、能力协议和报告事实源不放在 `.github/apps/`，应进入 `.github/domains/` 或 `.github/contracts/`。
- 当前生产交付服务仍登记在 `.github/domains/experience-delivery/services/fatecat-delivery/`，`.github/apps/` 暂不承载 active runtime。
- `developer-clients/`：公开远程 API 客户端；不得携带服务端计算核心或受限 vendor 资产。
- `bazi-infinite-demo/`：本地单一 3D 八字算法时间矩阵，使用原生三层工作台；35 组字段、119 行与初始 574165 层保留同场，固定 provider 通过本地 producer 向过去/未来生成新时间块；BigInt 全局索引、浮动原点、无损整数纹理及有界缓存不限制逻辑年份。聚焦不替换字段，无出生查询或其他图型；外推模型与生产 Profile 精度范围分开，不承担生产路由。
- `bazi-3d-web/`：独立八字全历史三维数学图谱；把 CalendarProfile 的 574165 个完整四柱时辰原子同时放入一个 Three.js 画布，以 26 种位置投影和 4 种整体或派生着色观察同一历史集合，不承担二维图谱或支持域外历法推演。
- `bazi-math-web/`：独立八字数学图谱目录；把固定时辰窗口投影为 42 项拓扑、几何、图论、序列与经典统计视图，只消费 timeline API，不承担无限浏览。
- `timeline-web/`：独立的纵向时辰浏览器；时间沿纵轴连续展开，registry 字段沿横轴投影，并以 Top / Middle / Bottom 三层工作台隔离开关、控制面和数据面；只消费 timeline API，不承载命理算法。

## 依赖方向

- `apps -> domains/*/services/* + .github/contracts/*`
- 禁止 `domains` 反向依赖 `apps`。