🐟 摸鱼棋乐(moyu-qile)
益智 · 摸鱼 · 小憩 —— 象棋 / 五子棋 / 军棋(陆战棋翻棋)三合一网页棋类游戏,纯 Node.js 自研,无外部依赖,Docker 一键部署。
🚀 在线免费体验 → game3.88531.cn
不用注册、不用安装、打开就玩 —— 手机 / 平板 / 电脑通用;数据全部留在自己家里。
📸 实拍截图
| 首页大厅 | 象棋对局 | 残局挑战 |
|---|---|---|
![]() |
![]() |
![]() |
| 五子棋 | 军棋翻棋 | 手机竖屏 |
|---|---|---|
![]() |
![]() |
![]() |
| 模型设置(隐私安心提示) |
|---|
![]() |
🌟 为什么值得玩
- 🎮 三棋合一,零安装 —— 象棋、五子棋、军棋翻棋一个页面全有;浏览器打开即玩,也可以一条 Docker 命令跑在自己 NAS 上
- 🤖 AI 教练会讲人话 —— 不是冷冰冰的着法坐标,是「你的右路空了,他炮沉底就完了」这种中文人话;接任意 OpenAI 兼容模型,甚至有温柔 / 毒舌两种教练人格
- 🔓 不填 KEY 也能玩全部 AI 功能 —— 走法点评、每日一题、棋风画像、战绩海报、记牌推理……8 大扩展功能本地引擎兜底,模型只是锦上添花
- 🔒 模型 KEY 只存你自己的浏览器 —— localStorage 本地保存,不上传、不写入服务器,设置页有明确安心提示
- 📱 手机竖屏深度适配 —— 390px 屏幕开箱即用,通勤摸鱼不是问题
- 💾 存档不丢 —— 局中 5 分钟自动存档、切后台立即存、刷新询问续局、手动存档带时间戳
- 🖼 战绩海报 —— 胜率 / 用时 / 评语一键生成图片,文案可自定义,发朋友圈有面子
- 🏠 数据全在自己家 —— 无账号、无遥测、无外部依赖,纯 Node 自研 MIT 开源
✨ 功能一览
| 功能 | 说明 |
|---|---|
| 🤖 AI 对战 | 象棋(α-β 搜索,三档难度)、五子棋(攻防评分 + 前瞻堵四)、军棋(吃子优先评估) |
| 👥 双人同屏 | 不需要联机、不需要第二个账号,一台设备两人轮流点 |
| 🎯 残局挑战 | 象棋名局残局(马后炮 / 重炮将杀…)、五子棋三步杀、军棋三套明棋局面 |
| ↩ 悔棋 | 象棋/五子棋一次撤回"你 + AI"各一步;军棋支持完整回滚(含吃子、扛旗) |
| 💾 存档 / 恢复 | 手动存档以「日期 + 时间」标识;每 5 分钟自动存档并覆盖(切后台/关页还会立即存一次);三个游戏各自独立文件 |
| ♻️ 刷新不丢局 | 局中自动快照,刷新后进入游戏会询问「是否继续上一局」 |
| 🏆 战绩排行 | 每局自动记录胜负与用时,按游戏独立统计,可导出 JSON |
| ⏱ 倒计时 | 无 / 1 / 3 / 5 / 10 / 20 / 30 / 60 分钟,超时判负(双人模式像棋钟轮流计时) |
| 🚪 离开提醒 | 对局未结束时点其他页面、刷新、关页都会先确认 |
| 🤖 AI 教练 | 接入任意 OpenAI 兼容大模型,逐步给出行棋建议(全中文人话,带「🔌 测试」按钮先验连通;可选温柔/毒舌人格) |
| 🎙 语音朗读 | 教练建议念给你听(浏览器 TTS),勾选保存后一直生效 |
| ✨ 8 项扩展功能 | 走法点评(这步亏了多少分)/ 每日一题 + AI 出题(本地校验才给用户)/ 棋风画像与弱点报告 / 自适应难度(三连败降档)/ 战绩海报(文字可自定义)/ 军棋记牌推理 / 对手嘴炮 / 开局库讲解 —— 不填模型也全部可用 |
| 📖 玩法说明 | 每个游戏单独的规则页 + 完整使用说明页 |
| ⚙ 存档路径可配置 | 存档与战绩目录可在界面里修改,换目录自动迁移 |
🎮 三个游戏
♟️ 象棋(AI / 双人 / 残局)
标准中国象棋规则:蹩马腿、塞象眼、炮隔山打、兵过河横走、将帅不可照面、将死与困毙判负。点己方棋子 → 绿圈标出可走位置 → 点目标格落子。
⚫ 五子棋(AI / 双人 / 残局)
15×15 棋盘,五子连珠(横 / 竖 / 斜)即胜。困难档会计算对手活四、连四并封堵。
🚩 军棋 · 陆战棋翻棋(AI / 双人 / 残局)
标准 5 列 × 12 行棋盘:每方 5 个行营(圆)、2 个大本营(方框)、46 个兵站,全盘 50 枚棋子背面朝上随机布阵。
- 翻棋定色:轮到你就翻一张,翻到哪方颜色就执哪方(先翻者定色)
- 大小:司令 › 军长 › 师长 › 旅长 › 团长 › 营长 › 连长 › 排长 › 工兵;同级同归于尽
- 特殊:工兵挖地雷(唯一可吃雷)、炸弹与任何子同归于尽、军旗被吃即负
- 行营:空营可进可出,营内棋子不可被吃(会自动套琥珀虚线环 + 标「营」)
- 大本营:可摆子、可进入,但进去后不能再移动(标「本」)
- 铁路:工兵可沿铁路直行任意格,其他子一次一步;山界仅两侧与中路三处可通;斜线仅行营与兵站之间
🚀 三种打开方式
方式 0:在线直接玩(零部署)
→ game3.88531.cn —— 手机电脑都能开,适合先玩后装。
方式 1:Docker 拉公开镜像(最快)
镜像发布在自建 GiteA 容器仓库(国内直连、免登录匿名可拉,已实测):
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
固定版本 tag(与 latest 并行提供):
docker pull gitea.88531.cn/jinghui/moyu-qile:1.0.0 # 固定语义化版本
局域网内可用更快的直连地址:
docker pull 192.168.68.19:3200/jinghui/moyu-qile:latest⚠️ 状态注记(2026-10-27):GitHub 账号临时暂停,
ghcr.io/personal82555/moyu-qile暂不可拉取;腾讯云 TCR 东京区(jpccr.ccs.tencentyun.com/jinghui/moyu-qile)为私有自用仓。在线体验、FnDepot 商店、源码构建均不受影响。
方式 2:飞牛 NAS 应用商店(fpk)
- FnDepot 社区商店:客户端「添加源」→
https://github.com/personal82555/FnDepot→ 安装「摸鱼棋乐」 - 离线直装:下载仓库内
fpk/moyu-qile/moyu-qile.fpk,执行appcenter-cli install-fpk moyu-qile.fpk(安装包已在飞牛真机跑过装/起/停/卸全流程) - 打包细节见
fpk/README.md
方式 3:从源码构建
# 国内直连(自建 GiteA 镜像,推荐)
git clone https://gitea.88531.cn/jinghui/moyu-qile.git
# 或 GitHub(账号暂停期间暂不可用)
git clone https://github.com/personal82555/moyu-qile.git
cd moyu-qile
docker build -t moyu-qile:latest .
docker run -d --name moyu-qile --restart unless-stopped \
-p 7025:7025 \
-v "$PWD/data:/app/data" \
moyu-qile:latest
打开 http://<你的IP>:7025 即可(手机同理)。
数据卷必须挂:存档(
*-saves.json)、战绩(*-ranks.json)与路径配置都在/app/data,不挂卷重建容器会丢。
本地直跑(不用 Docker)
npm install
node server.js # 端口可用 PORT 覆盖
📝 更新日志
2026-10-27 更新
- ✨ 象棋/军棋新增「已被吃棋子」战况栏:棋盘下方实时展示双方损失明细(棋子+数量),悔棋/存档/残局自动同步
- 🔧 Docker 分发渠道调整:Docker Hub 下线,镜像主通道切换为自建 GiteA(
gitea.88531.cn,匿名可拉) - 🔌 v1.1.0 授权系统接入(auth.88531.cn):安装量/在线统计、公告推送、右上角版本角标与新版本红点提示
v1.0.0 — 2026-10-22(首个正式版)
游戏本体
- 象棋 / 五子棋 / 军棋翻棋三合一;AI 对战(三档难度)、双人同屏、残局挑战、悔棋、倒计时棋钟、战绩排行、离开守卫
AI 能力
- AI 教练(中文人话建议 + 温柔/毒舌人格 + 语音朗读 + 连通性测试)
- 8 项扩展:走法点评 / 每日一题(本地校验)/ 棋风画像 / 自适应难度 / 自定义战绩海报 / 军棋记牌推理 / 对手嘴炮 / 开局库讲解
- 模型 KEY 仅存浏览器 localStorage,服务器零留存
体验与工程
- 手机竖屏(390px)深度适配;5 分钟自动存档 + 刷新续局
- 公开镜像
ghcr.io/personal82555/moyu-qile(latest/1.0.0/ 日期 / 构建号),GitHub Actions 自动构建并设为 public - 飞牛
moyu-qile.fpk安装包(真机全流程验证)+ FnDepot 社区商店上架 - 在线体验站 game3.88531.cn;7 张真机截图与本 README 同步更新
📁 目录结构
server.js # HTTP 静态服务 + WS 房间 + /api/{rank,save,config,fs,ai-hint}
app/index.html # 单页应用(hash 路由,三个游戏视图)
app/about.html # 使用说明页
app/css/style.css # 样式(移动端适配)
app/js/chess.js # 象棋规则引擎
app/js/chessAI.js # 象棋搜索 AI
app/js/gomoku.js # 五子棋引擎 + 评分 AI
app/js/junqi.js # 军棋翻棋引擎(标准 12×5 棋盘 / 行营 / 大本营 / 铁路)
app/js/*_client.js # 三个游戏的界面逻辑 + 存档钩子(GAMEHOOKS)
app/js/common.js # 公共 UI:工具栏 / 存档 / 排行 / 倒计时 / 离开守卫 / AI 教练
data/ # 运行时数据(存档、战绩、配置)—— 已 gitignore
tests/ # Node 单元测试
fpk/ # 飞牛应用商店打包工程 + 截图 + FnDepot 分发仓库
🧪 测试
node tests/engine.test.js # 引擎回归
node tests/chess_state.test.js # 象棋局面序列化往返(存档正确性)
node tests/jq_rules.test.js # 军棋规则(行营 / 大本营 / 铁路 / 山界)
node tests/jq_camp.test.js # 军棋入营与营内免疫
node tests/jq_shown.test.js # 军棋翻开状态同步
🔧 快捷方式
- 端口:
7025(HTTP 与 WebSocket 同端口) - AI 教练需要 OpenAI 兼容接口:
⚙ 模型设置里填 Base URL / Key / 模型名即可,不填不影响对局 - 存档目录默认
<数据卷>/saves,可在「💾 存档 → ⚙ 存档路径」里改
🎁 白嫖党专区 · 更多免费资源(推荐)
| 站点 | 地址 | 说明 |
|---|---|---|
| 88531 主站 | https://www.88531.cn | 软件工具与资源分享主站 |
| 在线文档 | https://doc.88531.cn | 安装配置与使用教程 |
| 资源合集 | https://link3.cc/88531cn | 全部项目入口与工具合集 |
| 免费 AI KEY | https://ai.88531.cn | OpenAI 兼容大模型网关(AI 教练后端) |
| 资享博客 | https://personal82555.github.io | 软件与工具分享博客 |
| 网盘资源导航 | https://github.com/personal82555/mrfx-resource-hub | 全网网盘资源集合 |
📄 License
MIT © 2026 摸鱼棋乐






