线条小狗滑雪大冒险

基于 Vite + React + TypeScript 的 Canvas 滑雪小游戏。

技术栈

• Vite — 构建与开发服务器
• React + TypeScript — UI 框架
• React Router — 页面路由
• Canvas — 游戏主画面（GamePage）
• localStorage — 本地游戏数据持久化
• Vitest — 单元测试

快速开始

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 运行单元测试
npm run test

# 运行端到端测试
npm run test:e2e

# 运行完整质量门禁
npm run quality

# 生产构建
npm run build

# 预览生产构建
npm run preview

页面结构

路径	页面	说明
/	HomePage	首页，游戏入口
/levels	LevelSelectPage	关卡选择
/game	GamePage	游戏主画面（Canvas）
/result	ResultPage	游戏结算
/settings	SettingsPage	设置
/about	AboutPage	关于我们
/leaderboard	LeaderboardPage	排行榜
/community	CommunityPage	社区反馈中心
/ai-quality	AIQualityPage	AI 质量中心
/admin	AdminPage	后台管理
/test-harness	TestHarnessPage	测试 Harness

项目结构

src/
  pages/        # 页面组件
  routes/       # 路由配置
  utils/        # 工具函数（如 storage.ts）

CI 检查

流水线可依次执行：

npm ci
npm run quality

或使用组合命令：

npm run quality

Playwright 浏览器级测试可单独执行：

npm run test:e2e

OpenSpec 工作流

较大功能先创建 OpenSpec change，补齐 proposal.md、design.md、specs/**/spec.md 和 tasks.md，确认规格后再实现。

openspec status --change <change-name>
openspec validate <change-name>

更多过程记录见 docs/sdd-process.md、docs/ci-quality-report.md、docs/community-operation-report.md 和 docs/ai-usage-record.md。