MateriaMedica/README.md

本草牌局

三人实时浏览器牌局。服务端负责发牌、回合、规则验证和信息隔离，客户端通过 Socket.IO 使用同源连接。

本地部署测试

本地版本绑定 127.0.0.1:17979，不会暴露到外部网卡：

docker compose -f compose.local.yml up --build

浏览器打开 http://127.0.0.1:17979。使用三个浏览器配置文件或三个无痕窗口加入同一 房间，即可测试完整流程。

运行自动测试：

docker compose -f compose.local.yml run --rm game npm test

停止本地版本：

docker compose -f compose.local.yml down

实际部署

生产版本同样只绑定宿主机回环地址，由反向代理提供公网访问：

docker compose -f compose.prod.yml up -d --build

反向代理目标为：

http://127.0.0.1:17979

以 Nginx 为例，WebSocket 所需配置如下：

server {
    server_name materiamedica.maths79.site;

    location / {
        proxy_pass http://127.0.0.1:17979;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

浏览器使用 https://materiamedica.maths79.site，不需要填写端口。

当前规则约定

• 牌组包含2张数字2、3张数字3、4张数字4和5张数字5。
• 随机隐藏2张，其余12张平均发给3名玩家。
• 公开记录会显示“取一张”或“取同号全部”请求及被询问的两个数字，并显示实际转移数量； 最终交出的是哪个数字只向转移双方私下显示。
• 同一玩家不能在连续两个自己的回合请求相同的两种牌；数字顺序、目标玩家和请求类型不同 也视为同一组。中间选择猜隐藏牌后不受上一组请求限制。
• 首位玩家提出猜测后，其余玩家按座位顺序选择认同某一份公开猜测、另猜或放弃。
• 另猜不会覆盖已有猜测；后续玩家可以选择认同任意一位猜牌者。
• 两位后续玩家完成操作后，如果恰好一人放弃，该玩家必须再次选择认同或另猜，不能继续 放弃。
• 如果两位后续玩家都放弃且首位玩家猜错，只淘汰首位猜牌者，其余玩家继续游戏。
• 猜对者加3分，认同正确猜测者加1分，猜错者减1分。出现正确猜测后本局结束并公开隐藏牌。

数据说明

房间和牌局保存在服务内存中。容器重启会清空所有房间，适合当前的简单部署版本。