2023-7 project started
23-08-18 修复了由于命令行应用造成的线程阻塞
23-12-3 发布Ma2: 重新组织业务逻辑。统一支持 Mjai Protocol。降低代码耦合度
【这个项目还在更新，请及时关注。有想法和 Bug 欢迎 issue。】
平台支持:
- Darwin (MacOS)
- Windows (test on Windows 11, works fine)
- Linux 正在测试
游戏支持：
- 雀魂 / Majsoul / MahjongSoul
- 天凤 / Tenhou (正在开发)
【Notice】 考虑到下列原因，已停用Bot自动点击
2024年夏季雀魂的一次界面升级
自动点击的cv识别不准确
可能的自动化鼠标检测（反作弊）
未来对天凤（tenhou）等其他平台的完整支持
- 自动提供帮助，处理麻将牌局
Step1 安装依赖
yarn run install:dependenceStep2 构建前端注入脚本
yarn run build:userStep3 将 dist/majsoul-analyser.user.js 脚本注入油猴/暴力猴中
Step4 开启后端服务
yarn start
# 直到出现 'Service started at port: xxxxx' 才真正开始Step5 打开雀魂网页（国服）game.maj-soul.com
注意：一定要先启动服务，再进入游戏。由于雀魂服务器的消息特性，本程序不能从对局中途开始监听（但是刷新网页后重新进入可以）
例如：
(x) 开局摸完牌了 -> 开启助手
(√) 开局摸完牌了 -> 开启助手 -> 刷新网页重进牌桌
本程序由 Typescript 编写，用 vite 构建用户浏览器脚本，用 ts-node 运行服务端
-
用户脚本，负责将雀魂的牌桌 WS 消息转发给服务端。目前仅转发对局消息，不转发Lobby类的消息。
-
服务器由主入口启动，将收到的二进制消息转发给消息处理器（server/msgHandler.ts），通过雀魂消息解析器模块 (server/majsoul)、牌桌记录模块 (server/gameRecords)、分析器模块 (server/analyser)、自动操作模块 (server/bot)贯通处理
雀魂消息解析器模块 (server/majsoul)：解析雀魂的二进制消息，解析规则可能有更新而导致这一块解析出错，届时请及时提醒开发者更新。
牌桌记录模块 (server/gameRecords)：记录对局状态。因为雀魂的消息是流程化的，也就是每一条消息只会告诉前端这一步的动作，而非牌桌信息，所以需要记录流程。
分析器模块 (server/analyser)：暂时使用 mahjong-helper 包装了一个初级分析器，返回一些操作结果 (operations)
自动操作模块 (server/bot)：使用 opencv.js 识别桌面，并通过 robot.js 操作鼠标点击