Skip to content

Repository files navigation

ZeroToken 图标

ZeroToken

谎言入席,各自上膛。

一款面向 3–6 位成年好友的 Windows 局域网社交诈唬牌桌游戏。
暗出、声明、质疑;失败者扣动自己的六槽左轮,枪响即决出唯一赢家与唯一输家。

GitHub Release Build status Platform: Windows 10/11 Tauri 2

下载安装包 · 核心玩法 · 本地开发 · 安全模型 · 协议与公平性

ZeroToken 雨夜牌桌登记首页

ZeroToken 是什么?

ZeroToken 把传统的“信不信”诈唬规则放进一间雨夜赛博酒馆。每手玩家暗出 1–3 张牌,并声称它们都是本轮目标牌;下一位玩家可以继续下注,也可以拍桌质疑。判断错误的一方必须拉动自己的左轮。

它不是把输赢交给一次随机动画:每名玩家拥有独立六槽转轮,击锤位置跨手保留,空枪会继续本手,弹位与行动可在终局通过种子承诺完整重放验证。

体验支柱 ZeroToken 的做法
一人一枪 每位玩家维护自己的弹膛、弹量与击锤进度,风险不会在玩家之间平均分摊。
谎言会改变局势 假 A 被识破会给说谎者装弹;杀、闪、桃让真实目标牌同时具备战术效果。
好友局优先 通过局域网 mDNS 发现、邀请串和 WSS 安全码快速组桌,不依赖互联网匹配或账号体系。
AI 只负责演出 DeepSeek 用于旁白、吐槽与受限终局结算;规则、洗牌和胜负全部由本地 Rust 引擎决定。

实机画面

以下画面由 v0.1.9 代码在 Windows、1440 × 900 分辨率下实际运行采集,不是概念稿。

ZeroToken 四人局牌桌实机画面 ZeroToken 赛博公堂结算实机画面
四人局牌桌
手牌、声明、效果目标与个人弹膛同屏呈现
赛博公堂
胜方指控、败方答辩与受限 AI 裁决

核心玩法

  1. 建立牌桌:房主选择练习局或真实调用局,其他玩家通过局域网发现或邀请串加入。
  2. 暗出并声明:当前玩家打出 1–3 张牌,统一声明为本手目标牌;Joker 可充当任意目标牌。
  3. 继续或质疑:下一位有牌玩家选择继续出牌,或质疑上一手。末位持牌者会被强制质疑。
  4. 揭牌拉栓:声明为假时由出牌者拉栓,声明为真时由质疑者拉栓;空枪后本手继续。
  5. 枪响终局:致命弹槽决定唯一输家,其对手成为唯一赢家,并进入公平性验证与终局结算。

牌与效果

牌面 数量 作为本手目标真牌时的效果
A / 杀 9 压制目标下一次出牌数量;假 A 被识破会给说谎者自己的左轮装弹。
K / 闪 9 私下查看目标的一张手牌。
Q / 桃 9 将自己的弹膛进度安全退回一格。
Joker 3 可充当任意目标牌,但不触发额外效果。

效果先挂起、后结算;若这手被质疑,挂起效果立即作废。单枪弹量封顶 2 颗,装弹与桃的变化都纳入公平性重放。

已实现能力

  • 完整牌局引擎:30 张牌、3–6 人发牌、空手跳过、末位强制质疑、空枪续局和平局重发。
  • 房主权威协议:命令 revision、幂等 command ID、128 位重连令牌和 60 秒重连窗口。
  • 局域网组桌:mDNS 自动发现;发现失败时可使用含地址、房间码和证书指纹的完整邀请串。
  • 传输与秘密保护:每房临时 TLS 证书、WSS 指纹固定;DeepSeek Key 只存在于本机 Rust 可清零内存。
  • 可验证公平性:开局提交种子承诺,终局公开种子和行动记录,由客户端重放并核对胜负与 Prompt 哈希。
  • 受限 AI 流程:局内随机额度支付者、每局配额与冷却;真实局固定模型参数并使用单次 SSE 请求。
  • 桌面演出:原创 2D 赛博牌桌、左轮演出、环境音、全房聊天、回合计时、提醒和减少动态效果。
  • 隐私遮罩:按 Ctrl+Shift+F12 立即遮罩并静音,再次按下返回牌局。

下载与安装

当前版本:v0.1.9

  1. 前往 GitHub Releases
  2. 下载 ZeroToken_0.1.9_x64-setup.exeSHA256SUMS.txt
  3. 可选:在 PowerShell 中验证安装包完整性。
Get-FileHash .\ZeroToken_0.1.9_x64-setup.exe -Algorithm SHA256

预期 SHA-256:

98A422D84D0BB5E6DAE17479D0114AEB81353F1EF897F9A86130296F3437E091

Important

当前安装包尚未进行代码签名,Windows SmartScreen 可能在首次安装时显示提示。请只从本仓库 Releases 页面下载,并在安装前核对 SHA-256。

运行要求:Windows 10/11(x64)与 WebView2。安装包采用 NSIS 当前用户安装模式,无需管理员权限。

开发与验证

环境要求

工具 版本
Node.js 22
pnpm 10
Rust 1.93 或更新版本
系统 Windows 10/11 + WebView2

本地运行

pnpm install
pnpm tauri dev

开发构建首页会显示 DEV LAB / 一键单人试玩。填写代号后即可创建一名真人与两名本地机器人的完整练习局;该入口不会出现在正式构建中。

自动化验收

pnpm check
cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets -- -D warnings

构建安装包

pnpm tauri build

NSIS 产物位于 src-tauri/target/release/bundle/nsis/

技术架构

Vue 3 · Pinia · TypeScript · GSAP · Three.js
                    │
              Tauri IPC / Events
                    │
Rust 权威房主 ──────┼────── 游戏规则与公平性重放
     │              ├────── 本机秘密与 DeepSeek 授权
     ├─ mDNS        └────── 临时 TLS / WSS 指纹固定
     └─ WSS ─────────────── 局域网玩家客户端
src/                    Vue 界面、Pinia 状态、音频与前端测试
src-tauri/src/          Rust 规则、房间、网络、授权、AI 与 Tauri 命令
src-tauri/capabilities/ Tauri 最小权限配置
docs/                   安全、协议、测试与实机截图

安全边界

ZeroToken 的 MVP 威胁模型假设参与者、房主和局域网可信,但仍由房主验证所有玩法命令。真实局中,Prompt 与生成结果会发送给 DeepSeek;请勿提交个人敏感信息。

当前版本不提供互联网匹配、账号、支付、现金押金、语音、反作弊、主机迁移、自动更新或跨平台支持。

进一步阅读:

DeepSeek 集成的发布依据为官方 Chat Completion API模型与价格开放平台服务协议

About

面向 3–6 位成年好友的 Windows 局域网诈唬牌桌游戏:暗出、声明、质疑,失败者扣动自己的六槽左轮。AI使用DeepSeek的API Key。

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages