🐟 摸鱼棋乐(moyu-qile)

益智 · 摸鱼 · 小憩 —— 象棋 / 五子棋 / 军棋(陆战棋翻棋)三合一网页棋类游戏,纯 Node.js 自研,无外部依赖,Docker 一键部署。

🚀 在线免费体验 → game3.88531.cn

不用注册、不用安装、打开就玩 —— 手机 / 平板 / 电脑通用;数据全部留在自己家里。

games node license ghcr.io fpk


📸 实拍截图

首页大厅 象棋对局 残局挑战
首页 象棋 残局
五子棋 军棋翻棋 手机竖屏
五子棋 军棋 手机
模型设置(隐私安心提示)
设置

🌟 为什么值得玩

  • 🎮 三棋合一,零安装 —— 象棋、五子棋、军棋翻棋一个页面全有;浏览器打开即玩,也可以一条 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
# 或 Gitee(公共镜像仓)
git clone https://gitee.com/jinghui111/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 Compose部署

仓库里没有现成的 docker-compose.yml,下面这份是按 Dockerfile(端口 7025、数据目录 /app/data)写的最小可用 yaml,与方式 1 的 docker run 等价:

services:
  moyu-qile:
    build: .
    image: moyu-qile:latest
    container_name: moyu-qile
    restart: unless-stopped
    ports:
      - "7025:7025"
    volumes:
      # 存档 *-saves.json、战绩 *-ranks.json 与路径配置都在这里,必须挂载
      - ./data:/app/data
    environment:
      - PORT=7025
docker compose up -d --build   # 首次构建并启动
docker compose up -d           # 日常更新 / 重启

本地直跑(不用 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 分钟自动存档 + 刷新续局
  • 公开镜像经自建 GiteA 分发(gitea.88531.cn/jinghui/moyu-qile:latest / 1.0.0,匿名可拉);GitHub Actions CI 保留(账号恢复后 ghcr 自动重建)
  • 飞牛 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 摸鱼棋乐

S
Description
🐟 摸鱼棋乐 — 象棋/五子棋/军棋三合一网页游戏 · AI教练/复盘/残局/解说等8大AI功能 · 手机竖屏适配 · 战绩海报+自动存档 · Docker一键部署:docker pull jinghui1984/moyu-qile · 在线体验 https://game3.88531.cn
Readme MIT
1.8 MiB
0 Stars 1 Watchers 0 Forks
Latest
2026-11-02 16:00:05 +08:00
Languages
JavaScript 86%
HTML 7.6%
CSS 5.7%
Shell 0.6%