作品简介

大鱼吃小鱼是一款给小朋友做的海底成长小游戏，核心玩法是“吃小鱼，躲大鱼，越长越大”：鼠标控制小鱼游动，吃掉比自己小的鱼会变大、得分，碰到比自己大的鱼会掉一条命，三条命用完游戏结束。吃豆子可额外加分（小豆 +100、金豆 +200），按体型给分（小鱼 +200 / 中鱼 +300 / 大鱼 +500）。

游戏面向 9 岁左右小朋友设计，操作只有鼠标移动、空格放技能、P/ESC 暂停、F11 全屏。闯关模式共 8 关，每关有分数目标（从第 1 关 1000 分到第 8 关 21000 分，逐关变难），通关后可进入无限模式继续冲最高分。需要注意海里的鱼群会跟着玩家一起长大——你越大，大鱼也越大，永远有要躲的对手。

核心亮点

• 6 种角色鱼各带专属技能：小丑鱼“橙橙”吃鱼得分 +20%、鲨鱼“大力”可吃范围 +15% 还能吃掉比自己大的鱼、电鳗“皮卡”放电清场、河豚“球球”膨胀三秒吃大鱼、灯笼鱼“亮亮”发光吸引小鱼、旗鱼“飞飞”全力冲刺
• 技能冷却机制：HUD 左下角倒计时进度条，灰色“冷却中”、绿色“按空格使用”、黄色“生效中”，帮助孩子理解资源管理
• 8 关闯关 + 无限模式：每关分数目标递增、大鱼越来越多，通关后可继续挑战最高分
• 每条鱼独立最高纪录：记录保存在本地 records.json，鼓励把 6 条鱼都玩一遍
• 窗口自由缩放：窗口可最大化、任意拖动，画面等比缩放不变形，F11 切换全屏
• 打包成 exe 即玩：PyInstaller 打包后双击运行，拷贝整个文件夹给孩子即可，无需安装 Python

技术与工具

• 开发语言：Python（游戏源码位于 src/fish_game/，按模块组织）
• 项目管理：uv（uv sync 装依赖、uv run fish-game 启动、uv run pytest 跑测试、ruff 做代码检查）
• 测试：包含单元测试与全流程冒烟测试
• 打包：PyInstaller 打包为带图标的 Windows exe（–windowed 无控制台）
• 开发方式：AI 编程类工具 + 国内顶级 AI 模型，通过与 AI 多轮对话迭代完成

适用场景

• 亲子编程启蒙：把 AI 编程当作亲子时间，让孩子在玩游戏的过程中对 AI 与编程产生兴趣
• 儿童休闲小游戏：操作简单（鼠标 + 空格），适合 9 岁左右的小朋友
• AI 辅助开发入门案例：从需求描述到打包分发，完整演示了一次对话式游戏开发

# 首次运行
uv sync

# 启动游戏
uv run fish-game

# 运行测试与代码检查
uv run pytest
uv run ruff check src tests

uv run pyinstaller --noconfirm --windowed --name "大鱼吃小鱼" \
    --icon assets/icon.ico --paths src src/fish_game/main.py