文档

摸鱼棋乐 使用教程

它是什么、适合谁

摸鱼棋乐是一个把中国象棋、五子棋、军棋翻棋装进同一个网页里的小游戏站——不用注册、不用安装、打开浏览器就能玩，手机、平板、电脑通用。它最讨喜的地方是 AI 教练说"人话"：不是冷冰冰的着法坐标，而是"你的右路空了，他炮沉底就完了"这种中文点评，还有温柔/毒舌两种人格可选。就算不配置任何模型 Key，走法点评、每日一题、棋风画像、战绩海报、记牌推理等 8 大 AI 功能也全部可用（本地引擎兜底）。

想随时随地玩，直接用在线体验站；想数据留在自己家，可以用 Docker 部署在 NAS/服务器上，存档战绩全在自己机器里。

快速开始

方式一：在线直接玩（零部署）

打开 https://game3.88531.cn 即可。

方式二：Docker 自部署（推荐 NAS 用户）

docker pull gitea.88531.cn/jinghui/moyu-qile:latest

docker run -d --name moyu-qile --restart unless-stopped \
  -p 7025:7025 \
  -v "$PWD/data:/app/data" \
  gitea.88531.cn/jinghui/moyu-qile:latest

打开 http://<你的IP>:7025 就能玩。想固定版本可拉 :1.0.0 这类 tag。

方式三：飞牛 NAS 应用商店

FnDepot 社区商店添加源 https://github.com/personal82555/FnDepot 后安装「摸鱼棋乐」；或下载仓库内 fpk/moyu-qile/moyu-qile.fpk 用 appcenter-cli install-fpk moyu-qile.fpk 离线直装。

⚠️ Docker 部署务必挂载 -v "$PWD/data:/app/data"，存档和战绩都在这里，不挂卷重建容器会丢。

界面速览

01-home

首页大厅：象棋 / 五子棋 / 军棋三个入口，手机竖屏开箱即用。

02-game

对局界面：棋盘 + 工具栏（悔棋、存档、倒计时、战绩、AI 教练）一体化设计。

常用操作

  1. 开一局：首页选游戏 → 选模式（AI 对战三档难度 / 双人同屏 / 残局挑战）。双人同屏不需要联机，一台设备两人轮流点。
  2. 走棋：点己方棋子（绿圈标出可走位置）→ 点目标格落子。象棋遵守蹩马腿、塞象眼、将帅不照面等标准规则。
  3. 悔棋：象棋/五子棋一次撤回"你 + AI"各一步；军棋支持完整回滚（含吃子、扛旗）。
  4. 存档与续局：局中每 5 分钟自动存档并覆盖，切后台/关页立即再存一次；刷新后进入游戏会询问"是否继续上一局"；也可手动存档（以日期+时间标识），三个游戏各自独立文件。
  5. 配置 AI 教练（可选）：「⚙ 模型设置」里填 OpenAI 兼容接口的 Base URL / Key / 模型名，先点「🔌 测试」验证连通；可选温柔/毒舌人格，勾选后教练建议还能用浏览器 TTS 语音念给你听。Key 只存你自己的浏览器，不上传服务器。
  6. 用扩展功能：走法点评（这步亏了多少分）、每日一题、棋风画像与弱点报告、自适应难度（三连败自动降档）、军棋记牌推理、开局库讲解——不配 Key 也全部可用。
  7. 生成战绩海报：对局结束后一键生成胜率/用时/评语海报图，文案可自定义，适合发朋友圈。
  8. 改存档路径：「💾 存档 → ⚙ 存档路径」可换目录，会自动迁移已有存档。

常见问题

更新与版本

完整历史见仓库内 CHANGELOG.md 与 README 更新日志。