# MathDuel

> 数学竞技平台 · 每日挑战 + 全球同题 + 社群打卡

## 项目概述

MathDuel 是面向华语/英语用户的数学竞技平台,包含三款核心游戏:

- **24 点** (`/games/24-game/`) — 4 张牌凑出 24,经典速算
- **方程式金字塔** (`/games/equation-pyramid/`) — 3 格算式等于目标数
- **数独** (`/games/sudoku/`) — 经典 9×9 数独,3 档难度

每个游戏都有:
- **每日挑战模式** (`?g={24|pyr|sud}&d=YYYYMMDD`) — 全球同题,UTC 0 点换题
- **战绩卡分享** — 1200×630 Canvas 分享图,含 streak 数 + 用时
- **难度解锁** — 数独有 streak≥7 解锁中等,≥30 解锁困难
- **跨设备同步** — 匿名 cookie + 服务端 KV,streak/history 跨设备一致

## API

- `GET /api/daily/{24-game|pyramid|sudoku}?d=YYYYMMDD` — 每日题
- `GET /api/daily-list` — 列出已生成每日题
- `GET /api/account/me` — 读取匿名账户
- `POST /api/account/sync` — 合并本地数据到服务端
- `DELETE /api/account/me` — 一键清除(隐私)
- `POST /api/track` — 上报埋点事件
- `GET /api/admin/stats` — 聚合统计(UV/分享率/留存)
- `GET /api/admin/decisions` — 决策矩阵触发器

## 文档

- `/shared/` — 前端共享模块(daily-challenge / streak / account / share-card / analytics)
- `/ws-server/solver/` — 服务端求解器(24game / pyramid / sudoku)
- `/ws-server/daily-gen/` — 每日题生成器(难度滚动:周一 easy / 周三 medium / 周六 hard)
- `/ws-server/daily-cron.js` — 每日题定时任务(UTC 0 点跑次日)
- 详细文档见 `/docs/`

## 技术栈

- 前端:纯 HTML + JS(无框架),Canvas(share-card)
- 后端:Node.js HTTP server(WS 对战)+ 文件 KV(账户/事件)
- 反代:nginx(已配 `/api/` 转发 + Cache-Control: no-store)
- 部署:PM2 管理 ws-24 进程

## 链接

- 主页:`https://mathduel.games/`
- 24 点 daily:`https://mathduel.games/games/24-game/?g=24&d=YYYYMMDD`
- 金字塔 daily:`https://mathduel.games/games/equation-pyramid/?g=pyr&d=YYYYMMDD`
- 数独 daily:`https://mathduel.games/games/sudoku/?g=sud&d=YYYYMMDD`
- AI 友好:`/llms-full.txt`(完整版)/ `/ai.txt`(基础元数据)/ `/sitemap.xml`(URL 列表)