d![]()
dsh-card-lan
Manifest validLAN Card Table: 21 Points / Dou Di Zhu / Pao De Kuai / Guan Dan / Zha Jin Hua / Texas Hold'em / Japanese Mahjong (4-Player · 3-Player), UDP Room Discovery + Host-Authoritative Game Sessions, supporting passwords / spectator mode / AI filling / reconnection after disconnection.
UI (client)hasBundlePatch
dsh-card-lan
局域网棋牌桌(21 点 / 斗地主 / 跑得快 / 掼蛋 / 炸金花 / 德州 / 日麻四人·三人),DeepSeek Harness 插件。联机模型与 dsh-pet-lan(桌宠联机)一致:UDP 广播自动发现同房间的电脑,房主权威发牌,其他机器入座,浏览器里直接开牌桌;单人可以开人机补位。
功能
- 房间发现:UDP 41235 广播,房间名一致才能互相看见(同 dsh-pet-lan)。
- 入座/房主制:任一台机器「创建牌桌」成为房主,其余人从发现列表点「加入」;跨网段时可用 IP:端口手动加入。
- 房间密码:房主可开启,玩家加入和观战都要输密码;密码只留在房主本机,不走网络。
- 邀请复制/粘贴:大厅一键复制「房间名+端口」邀请码(
DSH-CARD-LAN|房间名|端口),朋友粘贴后点「应用」直接保存房间配置,不用手抄、也不用再去设置页点保存。 - 观战:房主可开关,最多 6 人观战,不参与出牌;观战者看到和玩家同样的牌局状态。
- 21 点对局:1–4 人,庄家 17 点停牌,支持要牌/停牌/爆牌/黑杰克/赢输平,局间保留战绩。
- 斗地主对局:3 人、54 张;叫地主、出牌/不要、牌型判断与比较(单/对/三带/顺子/连对/飞机/炸弹/王炸)、地主/农民结算;创建牌桌时选玩法。
- 跑得快对局:3 人、48 张(去 2 和王);持黑桃 3 先出,牌型含三带二/顺子/连对/飞机/炸弹,能管必须管;先出完者胜。
- 掼蛋对局:4 人 2v2、两副牌 108 张;级牌 + 红桃级牌「逢人配」万能牌,牌型含三带二/顺子/连对/钢板/炸弹/同花顺/四大天王;头游→末游按双上/头游三游/头游末游升 3/2/1 级,打 A 过 A 获胜;进贡/还贡(双下双贡、两张大王抗贡、还贡 ≤10、进贡方先手)。
- 人机补位:房主可勾选「自动补齐」(按玩法推荐人数补满:斗地主/跑得快 3 人,掼蛋/炸金花/德州/21 点 4 人,日麻四人 4 人 / 日麻三人 3 人),或手动选「机器人数量」0–5 个;机器人在斗地主/跑得快/掼蛋/炸金花/德州有真实策略,21 点为基本策略(<17 要牌、≥17 停牌),日麻为简单陪练(自动摸切/立直/和了,不鸣牌);后加入的真人会顶掉机器人,真人优先。
- 日麻牌面图标:34 种牌面 + 赤宝 + 牌背共 38 张自绘矢量图标,两套风格(深色/象牙白);默认图形 + 深色,可在「设置」里切换「牌面(图形/文字)」与「风格(深色/象牙白/跟随 DSH 主题)」;只影响日麻,不占牌桌窗口。
- 和牌/立直交互:「自摸」按钮只在确实能和时出现;立直改为「选中可立直的牌(绿框高亮)→ 点击立直」一步完成立直并打出该牌;不能和时不会出现和牌按钮。
- 规则与机器人修复:日麻大明杠补摸(王牌补摸+岭上花开,修复杠后手牌少一张)、抢杠(加杠可被荣和,「抢杠」+1 番)、本场(连庄累加,荣和 +300/自摸每家 +100);掼蛋机器人不再在进贡/还贡阶段卡死。
- 炸弹金花对局:2–6 人、每人 3 张、起始筹码 1000/底注 10;闷牌/看牌、跟注/加注/弃牌/比牌,3 轮强制摊牌;牌型 豹子>顺金>金花>顺子>对子>单张(异花 235 吃豹子),赢家收底池。
- 德州扑克对局:2–6 人、每人 2 张底牌 + 5 张公共牌;按钮轮转、小盲 10/大盲 20、翻前/翻牌/转牌/河牌四轮下注(弃牌/过牌/跟注/自由加注,短码自动全下)、边池摊牌 7 选 5 比大小,赢家分池。
- 后续计划:日麻(立直麻雀)作为独立大版本开发,待确认赤宝牌/食断/东风战或半庄/机器人陪练等参数。
- 日麻(东风战,里程碑④完成):日麻·四人(东 1–4 局)/ 日麻·三人(东 1–3 局,无北家);摸打、吃碰杠、立直/一发、全役种+符点+点数、宝牌/赤宝/里宝、荣和/振听、流局听牌罚符、连庄/轮庄、东风战终局与最终排名;25000 起点、食断开、3 人拔北、自摸不损;专用文字牌大窗。
- 浮层显示设置:透明度(25%–100%)、大小四档(小/中/大/超大 920px)、拖动标题栏移动并记住位置、自动变淡(鼠标离开时更不显眼)、
Ctrl+Shift+H一键隐藏/显示。 - 断线容错:动作带重传与去重,房主 1 秒心跳,客人 4 秒没收到状态提示「房主失联」;房主 12 秒没见到某台机器的发现广播就清掉该座位。
- 掉线重连:客人 5 秒收不到房主状态会自动重连回座(记住房主和密码,不写盘);重连失败可点「重新连接」再试;房主关桌会主动通知所有客人回大厅。
- 回合超时:默认 45 秒没人操作自动替他「停牌」(0 可关闭),防止挂机卡局;浮层上有剩余秒数提示。
- 界面:设置页里的「牌桌联机」大厅(分「房间 / 设置」两个页签:创建/加入牌桌和邀请在「房间」,房间名/端口/密码/机器人/浮层显示在「设置」)+ 右下角可最小化的牌桌浮层。
安装
在 DSH 的插件管理里点「添加插件」,填仓库地址:
https://github.com/Fatelikeshit/dsh-card-lan
命令行等价写法:dsh plugin install https://github.com/Fatelikeshit/dsh-card-lan。安装是热加载的:装完刷新一下 DSH 页面,设置里就会出现「牌桌联机」(没出现再重启 DSH)。
本机开发也可以直接填本地目录路径。两端插件版本要一致(当前 0.20.0),局域网里房间名和端口保持一致。
装好后:
- 设置 →「牌桌联机」,房间名两端保持一致(默认
dsh-card),确认 UDP 显示已监听。 - 一台机器点「创建牌桌」(先选玩法:21 点 / 斗地主 / 跑得快),另一台在发现列表里点「加入」(跨网段就填房主的 IP 和端口);想单人玩斗地主/跑得快就在大厅勾上「人机补位」。
- 房主点「开始本局」:21 点轮到你要牌/停牌;斗地主先叫地主再出牌/不要;跑得快持黑桃 3 者先出,能管必须管。
Windows 首次监听会弹防火墙提示,需要允许「专用网络」的 UDP 入站。公司/访客 WiFi 若开了客户端隔离(AP isolation),设备之间互相不可见,需走有线或换网络。
结构
lib/index.js 宿主半边:UDP 发现/入座/动作/状态、房主权威牌局、/api/card-lan 路由
lib/engine.js 21 点规则引擎:牌堆、点数、轮次、庄家、结算(无 IO)
lib/games/doudizhu.js 斗地主规则引擎:牌型/比较、叫地主、出牌、结算、隐私快照(无 IO)
lib/games/paodekuai.js 跑得快规则引擎:48 张、黑桃3先出、能管必须管、结算(无 IO)
client.js 浏览器半边:大厅设置页 + 牌桌浮层(classic script,无需构建)
cordis.patch.yml 插件行
PROTOCOL.md 网络与 HTTP 契约(改协议先改它)
test/ engine 单测 + 双实例集成测试
测试
cd dsh-card-lan
node --test test/
engine.test.mjs:牌堆、A 计点、黑杰克、庄家补牌、赢输平。integration.mjs:两个createCardLan实例在回环 UDP 上跑通 发现 → 入座 → 开局 → 出牌 → 结算 → 离座,并验证 HTTP 路由与回环守卫。
规则说明(MVP)
- 一副牌,不补牌;庄家 17 点(含软 17)停牌。
- 无下注与筹码,只记每局 win/lose/push。
- 黑杰克(两张 21)大于普通 21;双方黑杰克为平局。
- 同一房间只该有一张牌桌(房主制);房间名/端口一改即视为换网络,牌桌与发现列表清空。
协议摘要
- UDP
hello(广播,1.5s)→ 发现;join/action/leave(单播到房主);state(房主单播,变化即发 + 1s 心跳)。 - HTTP(仅回环):
GET /api/card-lan取 view;POST /api/card-lan/config改配置;POST /api/card-lan/action执行open/close/join/leave/start/hit/stand。 - 完整字段与校验规则见 PROTOCOL.md。
Comments
Loading…