《阶级骰斗》设计案总览 v3.0(整合版)

这是什么:把 docs/设计案/ 底下的两份文件 合并成一份,并用现在的程式码核实过状态。 整合来源:游戏设计总览 v2.0(2026-10-13)+ 设计案增量文档 v2.1。 配套的副文件(2026-10-19 整理后只剩两份 → 2026-10-19 补成三份): 职业变体设计集.md(30 个职业变体,§C.3 引用)+ 角色技能树设计集.md(💭 只是探路方向,后期可能要重想)+ 状态与Buff设计集.md(v3.0 整合时漏掉的那一层:主状态/Buff/觉醒值,§M 引用)。 已被整合的原稿移到 _archive/——不要从那里开始读。 核实基准:v1.33.128(62 个 JS 档、352 条测试、264 个版本 tag)——2026-10-19 实测。 整合原则: 1. 新覆盖旧:v2.1 与 v2.0 冲突时,以 v2.1 为准,并在 §J 逐条记下「被覆盖的是什么」。 2. 有实作就以程式码为准:文件与程式码冲突时,程式码赢(§K 列出核实与存疑)。 3. 未实作的东西不删:全部保留,但集中标记「📋 待实作」,并依 §I 的规矩排队。

与其他文件的关系:本档是设计意图(what/why to build); 规则与流程看 专案规则/,专案结构看 PROJECT-MAP.md, 现况与下一步看 HANDOVER.md。设计案不构成实作承诺(§I)。


目录


O. 状态图例

标记 意思 判准
✅ 已实作 程式码里有,而且能用 有对应函式/测试,或实际玩得到
🚧 部分实作 主体在,但文件描述的扩充还没有 开起来看得到,细节少一半
📋 已规划・未实作 设计写好了,程式码里没有 js/ 与 dev/index.html 搜不到
💭 构想 方向,还没有可动工的规格 只有一句话
⚠️ 待拍板 有冲突或需要玩家决定 两份文件的说法不一致
❌ 已否决 拍板不做(附版本与理由) 写明「当时的条件」

📌 状态是会过时的:本档的状态以 v1.33.128 为准;之后每次大改版请重跑 §K 的核实指令。


A. 设计哲学(四原则 + 四层架构)

v2.0 与 v2.1 完全一致,没有冲突。

A.1 四条原则

  1. 主心骨原则——打牌是唯一不需要解释就能玩的系统。其他系统(阵营进度、股市、立足点、考试、子女、法庭) 都挂在「出牌」这个动作上。任何新系统都必须回答「它怎么影响出牌」。
  2. 元规则原则——主心骨不变,但规则本身可以被局内因素改写。 追加/吃牌/自由额外回合/假性繁荣/双重标准/弱炸弹,全都是「条件触发的规则改写」。
  3. 反商业原则——不做新手引导、不做每日任务、不做自动寻路;玩家迷路是预期行为。
  4. 流派原则——流派是玩家自己生产的绳子,比教程有生命力;不写教程,只展示可能性。

A.2 四层架构(也是开发顺序)

第 0 层:核心    出牌、角色技能、技能卡                        ✅ 已实作(但没有「局数解锁」)
第 1 层:经济    股市、银行、子女、立足点                      ✅ 已实作(⚠️ v2.1 要把股市改成股牌)
第 2 层:制度    法庭、考试、阵营金库、阵营行动                🚧 考试/金库/阵营行动 ✅、法庭 📋
第 3 层:混沌    黑客、积木、指令、档案                        📋 全部未实作

⚠️ 「第 3/6/10 局解锁」没有实作:程式码里没有解锁机制(解锁 在 js/ 搜不到)。 现况是所有系统一次全开。这一条属于「教学曲线」设计,与 §I 的架构清理无关,但还没排队。


B. 主心骨:出牌

B.1 基础牌型 ✅

单张/对子/三条/三带一/三带二/顺子/连对/飞机/炸弹/火箭(js/core/rules.js)。

B.2 元规则机制(六种)✅

机制 改变什么 状态 程式码
追加 牌型的边界(顺子接长、对子升三条) ✅ doAppendFor()/findAppendPlay()
吃牌 牌的来源(上家单张可以变成自己的牌型) ✅ startEat()/doEatFor()
自由额外回合 出牌的时机(掷骰 ≥4 可无视大小出牌) ✅ freePlay/freePlayLock()(RD-08 之后是 freePlay 事实)
假性繁荣 出牌的规则(本回合自由出牌,代价抽 1 张) ✅ 技能卡 falsepros
双重标准 牌型的阶级(对子压三条、单张压对子) ✅ rules.js 的双重标准区块、技能卡 doublestd
弱炸弹 炸弹的无敌性(掷出 1 就失去无敌) ✅ rules.js

B.3 v2.1 新增的牌理(📋 未实作,且与现行机制有张力)

B.4 v2.0 的其他牌型构想


C. 角色

C.1 基础职业:设计 14、已实作 10

阵营 职业 状态
🔨 基层 农民、工人、投机者 ✅
🔨 基层 小贩 📋
🛡️ 管理 警察、监督、慈善家 ✅
🛡️ 管理 法官 📋(与法庭系统绑定,见 §E)
👑 高层 地主、资本家、大统领 ✅
👑 高层 贵族 📋
🎓 知识 知识分子 ✅
🎓 知识 记者 📋

核实:js/data/roles.js 的 ROLES 有 10 笔;SKILL_CARDS 有 16 张。 两份原稿写的「14 个基础职业」指的是设计目标(含 4 个未实作),不是现况。

C.2 角色加强(📋 全部未实作)

v2.0 列了投机者(伪装增强、隔岸观火)、工人、监督、慈善家…的加强案。 ⚠️ 其中「投机者伪装第一眼看不出」与现况冲突:现在伪装只是面板加一个「🃏伪装」标记(等于告诉所有人)。 这一条不是新功能,是把既有机制的资讯揭露方式改掉——属「规则/UI 一起改」,要单独评估。

C.3 变体系统/技能树(📋 变体;💭 技能树=探路方向)

⚠️ 变体会改「角色」这个核心资料结构(ROLES/新的 p.variant),动之前先看 §I。 ⚠️ 变体的 p.variant(以及技能树若真做的 p.ap)都是新状态 ⇒ 依铁律 11 进 SAVE_FIELDS; 这正是 STATE-01(状态登记守门)该先做完的理由(见变体设计集 §9.3)。


D. 经济(股市全留、持股牌化)

D.1 股市:✅ 全系统存留,只有「持股」变成牌(§J.0 D2/D3 裁定)

⚠️ 先修正一个误解:本档先前把 v2.1 读成「废除独立股市面板」—— 2026-10-19 玩家裁定是「股市系统全部存留,改变的是持股的呈现形式」。 下表是修正后的版本(J1/J2/J3 的旧写法作废,见 §J 的警语)。

维度 裁定(2026-10-19)
股市系统 全部存留:股价、情绪、内幕消息、做空、公司、市场压力 —— 一个都不砍
持股 持股本身就是牌(【股牌】):买入=拿到牌、卖出=把牌打出去结算
股价决定 仍由股市系统决定(随机 + 情绪/内幕/市场压力);股牌只是「持股的载体」,不是「股价的来源」
做空 面板操作保留;另外可做「空头合约牌」(把做空也变成一张牌)——两者可并存
股票牌堆 公司/IPO/上市持股可能引入独立的「股票牌堆」:市面上流通的股票数量相对稳定(除非发生分割等情况)
联机 内幕与股票牌共存:内幕=对未来资讯的不对称(私有);股票牌=股市资讯本身公开(公开)。两个维度,不冲突

现况:股市系统 ✅ 已实作(js/stock/*:23 个函式、stock-modal、drawStockChart、company.js); 股牌 📋 未实作(股牌 在 js/ 搜不到)。

剩下要设计的问题(不是「要不要」,是「怎么接」):

  1. 股牌与手牌是同一个容器吗? 若是 ⇒ 出牌流程(submitPlay/doPlayFor)要认识「这张是股牌」; 若不是(独立牌区)⇒ 要有第 2 个牌堆与第 2 套出牌入口。
  2. 股票牌堆的稳定性:市面上股票数量固定 ⇒ 这是「有限资源」的牌堆,和 190 张的主牌堆不同 (分割/增发=改变总量)。⇒ 需要 stockDeck 这种有上限的结构,且要进存档(SAVE_FIELDS)。
  3. 卖出=打出时的股价取哪一刻?(出牌那一刻/结算那一刻)——这会决定「打大牌拉抬股价再卖」能不能成立。

D.2 经济咬合(v2.1 新增,📋)

D.3 银行 ✅(现有:存款/定存/贷款/纾困/保险/质押)

v2.0 的扩充 📋:利率动态化、央行干预、挤兑、债券市场、洗钱、离岸帐户、新角色「银行家」。 ⚠️ 这一组全部依附在「利率」这个新概念上(现在利率是常数 BANK_INTEREST 等), 要做的话是先加「利率」状态,再逐项接——不是六个独立小功能。

D.4 子女 ✅(子女牌/抚养费/弃养/农民多子多福/资本家信托)

扩充 📋:阶段式成长(婴儿→幼童→学龄→青少年→成年)、送去读书、继承(只给资本家)、 成年子女贡献阵营进度。⚠️ 会动 p.children 的资料形状 ⇒ 存档栏位(SAVE_FIELDS)要一起改。

D.5 图书馆/研究所/技能卡获取(📋 全部未实作)

图书馆(借书/书籍类型/禁书)、研究所(📋 详见 v2.0)、技能卡获取来源重新分配。 ⚠️ 这些是第 2 层(制度)的东西,依 §I 排队。


E. 制度:裁决与会议

E.1 法庭(v2.0 §七)📋 与 v2.1 的会议阶段冲突

v2.0 的法庭是一套完整制度:起诉(5 金)→ 一次性投入(律师/证据/证人)→ 判决(法官掷骰 + 7 项修正) → 三级法院(阵营建筑,30/60/100 金)→ 法官职业。

v2.1 的会议阶段:监督的【绩效考核】、警察的【维持秩序】这类权力技能不再瞬间生效, 改插入一个不弹窗、不暂停打牌的微型会议——出牌即表态(原告出控诉牌、被告用更大的牌抗辩、 其他人站队跟牌),比总点数判胜负,Pass 的人吃「消极态度」惩罚。

整合结论(新覆盖旧):

⚠️ 已拍板(§J.0 D5,2026-10-19):每局最多 2 次会议(暂定,依后期实做测试调整)。 ⇒ v2.0 的「一局 5 个案件」顾虑解决:上限 2 次就等于「一局最多占 2 次注意力」。

E.2 已经实作的制度 ✅


F. 模式

模式 来源 状态 一句话
克隆模式 v2.0 §10.1 📋 所有人选同一个角色;胜利条件退回「出完牌」(对称竞技/平衡测试工具)
鸡尾酒模式 v2.0 §10.2 📋 技能效果与角色 ID 解耦:面板写「农民:罢工抗争」,实际效果是剥削;日志写真、面板写假 ⇒ 资讯战
沙盒模式 v2.0 §10.3 📋 纯出牌练习:没有其他系统,让新手熟悉牌型与出牌规则
黑市 v2.0 §10.4 📋 它是技能卡获取来源(见 §D.5),不是独立的交易玩法
紊乱模式(Chaos) v2.1(新) 📋 伺服器向每个客户端下发不同视图:视觉欺诈(8 看成 K)、身份幻觉、数据污染;反制是 hack.sys.truth() 与管理的「信息管制」

🐞 2026-10-19 更正:v3.0 的前一版把这四条摘要错了(鸡尾酒被写成「多种变体混搭」、 克隆被写成「同一份手牌复本」、沙盒被写成「自由设定(给测试/实况用)」、黑市被写成「局内黑市交易」)。 上表已照 v2.0 原文重写;这件事记在 §J.14 的教训里(摘要 ≠ 安全)。

⚠️ 冲突:v2.0 的模式是「规则层的变体」;v2.1 的紊乱模式是「视图层的欺诈」。 两者不互斥,但紊乱模式直接踩在「伺服器只送自己视图」这条现行契约上(room.viewFor(seat))—— 它需要「同一份真实状态 → 每一席不同投影」的能力,而目前的 viewFor() 只是过滤,不是造假。 ⇒ 若要实作,viewFor() 要从「过滤」升级成「投影管线」,这是联机核心改动,见 §I。


G. 混沌层:黑客/积木/指令/档案

全部 📋 未实作(黑客/积木/指令系统/档案系统 在 js/ 都搜不到; play.js 提到的「大模型股票指令」是另一回事,不是这一层的指令系统)。

系统 v2.0 v2.1(覆盖/扩展)
黑客 沙箱、API 设计、管理阵营控制台干预、安全边界 +Mini-VM 与汇编(寄存器/内存地址)、漏洞攻击(ROP/虚表劫持/XSS 注入)、彩虹表彩蛋
积木 五大类积木 →(编译成 JS)、双向切换、图形档案界面 沿用
指令 26 个指令分五类、say 独立广播通道 沿用
档案 目录结构、Vim 编辑器、权限 沿用 + 多语言转译器(Python/C++/Java → AST → 受限 JS)

⚠️ G.1 一条真正的冲突:XSS 是「玩法」还是「风险」?

整合结论:玩法上采用 v2.1(把「注入」变成沙箱内的攻防),但实作守则不变:

G.2 混沌层与主心骨的张力(v2.0 自己就标了 ⚠️)—— ✅ 已拍板:可以脱离

v2.0 待拍板清单第 8 条:「黑客/积木/指令/档案这四个系统,和『打牌是主心骨』有没有冲突?这是最大的问题」。

裁定(§J.0 D6,2026-10-19):黑客模式后期可以脱离本作,变成另一个游戏《骇客牌局》。


H. 帐户・场外・技术

H.1 帐户:⚠️ v2.1 覆盖(v2.0 隐含「有帐号」)

v2.0(隐含) v2.1(新,采用)
形态 ELO/段位/赛季/场外资产 ⇒ 隐含「有一个持久身份」 去中心化密钥帐户:JJD-xxxx-xxxx 即帐户,无注册/无邮箱/无密码
遗失 可找回 无法找回(丢了就是丢了)
防刷分 未写 同 IP 不互计分;可生成多个密钥
认证 未写 HMAC 签名验意图,伺服器只存 Hash

H.2 ELO/结算/场外资产(v2.0 §15/§16)📋

整合结论:ELO/赛季不变,但全部降级为 📋 且要与 §H.1 的密钥帐户一起设计(没有帐号就没有 ELO)。 ⚠️ 「联机版强制不存留资源层(公平优先)」这条保留——它与密钥帐户的匿名性一致。

H.3 技术选型:⚠️ v2.1 覆盖 v2.0

v2.0 v2.1(新,采用)
形态 Web(DOM + Vue 元件 + 单档打包) Godot(原生)与 Web(DOM/Vite)双轨并行
沙箱 未细写 Web Worker 沙箱、Object.freeze、纯文本渲染、防 URL 钓鱼
语言 未写 多语言转译器:Python/C++/Java → 通用 AST → 受限 JS

⚠️ 但要说清楚「现在」:本专案的实作仍是 v2.0 的形态(单档 index.html、全域脚本、无框架、无 Vite)。 v2.1 的双轨是方向(💭),不是现况。⇒ Godot 迁移在 v2.0 自己的清单里也是「长期构想 💭」。

H.4 联机架构 ✅(v2.0 §18 的内容已落后于现况)

v2.0 把「联机架构」列在第三梯队 📋;现况已经可玩(NET-01~NET-06,v1.33.111): SSE + POST、权威伺服器、viewFor(seat) 过滤、限时决策、node tools/llm-proxy.mjs 起伺服器。 还没做的:NET-07 上云、NET-08 联机 LLM 难度、NET-09 状态差分。

H.5 其他(📋):Wiki 系统、玩家排布、学习曲线


I. 未实作部分的处置原则(先读这一节)

一句话:本档里的 📋 与 💭 不是待办清单,是设计意图的仓库。 它们要等到架构债清到一个阶段之后,才会被逐条捡起来评估。

I.1 为什么要等

  1. 主心骨原则自己就是门槛:任何新系统都要回答「它怎么影响出牌」。现在连出牌模式的状态归属 都还没搬干净(MODE 线,RD-09 留下的 5 处 updateUI),在这之上盖新系统=把债叠高。
  2. 持股牌化会动到整个股市层(D.1):4 个 market block、company.js、stockSessionTick, 还要新增「股票牌堆」(有上限、要进存档)。先做架构清理,再动牌堆。
  3. 帐户/ELO/紊乱模式都要动联机的视图管线(F/H.1):viewFor() 从「过滤」变「投影」是核心改动, 要在 NET-07(上云)之前想清楚。
  4. 混沌层(G)已裁定可脱离本作(§J.0 D6)⇒ 不再是本作的债;剩下的沙箱需求只影响姊妹作。

I.2 排队顺序(架构债先清)

顺位 项目 线/阶段 为什么在它前面
1 顶层状态登记守门 STATE-01 任何新系统都会加状态;先让「忘了登记就红」成立
2 开局重置机制化 STATE-02 新系统最容易咬人的 bug 是「跨局残留」
3 出牌模式归属 MODE-01.2 → .1 出牌是主心骨;它的 UI 状态归属不该留在引擎
4 EVENTS.lastTriggered 归位/window._xxx 清理 STATE-03/STATE-04 小、零风险,顺手做
5 客户端不载入引擎规则档 DOM-08 真正的解耦证明;也是「混沌层沙箱」的前置
6 上云/差分/联机 LLM NET-07/NET-08/NET-09 帐户、紊乱模式都要它

I.3 这之后才轮到设计案

⚠️ 本档不承诺任何一波会发生。真要动的时候: ① 先在 专案规则/02-命名规范.md §1.2 登记线/阶段 ② 拍板 §J 的 ⚠️ 项目 ③ 照 专案规则/04-开发流程.md 走。


J.0 ✅ 拍板结果(2026-10-19,玩家裁定 —— 本节优先于 §J 表格)

这一节是最新的裁定。若与下面的 §J/各章冲突,以本节为准(并回头修那一段)。

# 议题 裁定 影响
D1 胡牌 ❌ 不打算实作(目的不是它) §B.4 移除胡牌;v2.0 待拍板清单第 5 条(胡牌五问)作废
D2 股市 全部存留(股价/情绪/内幕/做空/公司/市场压力都留);改变的是持股的呈现形式 ⇒ 持股本身就是牌 §D.1、§J1 改写:不是「废除股市」,是「股市照旧,持股牌化」
D3 公司/IPO/上市持股 可能引入独立的「股票牌堆」(市面上的股票数量相对稳定,除非发生分割等情况) §D.1 新增「股票牌堆」;§J10 的 IPO 不再降级(保留)
D4 联机:内幕 vs 股票牌 两者共存,是两个维度:内幕=对未来资讯的不对称;股票牌的公开性=股市资讯本身公开 §D.1「私有资讯怎么共存」的疑问结案;viewFor(seat) 不必造假
D5 会议次数 每局最多 2 次(暂定,依后期实测调整) §E.1 的「每局最多几次会议」结案(暂定 2)
D6 黑客模式 后期可以脱离本作,变成另一个游戏《骇客牌局》 §G 从「本作第 3 层」改成「可独立的姊妹作」;§I 的混沌层排队不再是本作的债

📌 位阶(玩家明示,2026-10-19):本档(主设计案)优先级最高,所有副文件都必须与本档兼容。 副文件目前有两份:职业变体设计集.md、角色技能树设计集.md。 两份的档头都写了「以主档为准」;冲突时改副档,不要改主档去迁就副档。


J. 冲突对照表(新覆盖旧;已被 §J.0 部分改写)

依整合原则 1:v2.1 与 v2.0 冲突时以 v2.1 为准,下表逐条记下「被覆盖的是什么」。 ⚠️ 「覆盖」=设计意图以新者为准,不代表已实作(状态看各节)。 ⚠️ 2026-10-19 之后:J1/J2/J3/J10 已被 §J.0 的 D2~D3 再次覆盖(股市全留、持股牌化、股票牌堆), 下表保留原样当历史,以 §J.0 为准。

# 主题 v2.0(被覆盖) v2.1(采用) 被覆盖的具体内容
~~J1~~(已被 §J.0 D2 覆盖) 股市形态 独立股市面板(股价 K 线/持股清单/做空按钮) 股牌(买入=抽牌、卖出=打出结算、股价由牌局因果决定) §8.2 的「面板」整段、drawStockChart 的大盘 K 线、面板上的做空按钮
~~J2~~(已被 §J.0 D2 覆盖) 股价决定方式 每交易时段随机波动 + 情绪/内幕/市场压力 完全不随机,只受当前牌局影响(可变 0 点废纸) 「随机波动」与「情绪/市场压力」对股价的影响途径(情绪可能仍存在,但不再直接改股价)
~~J3~~(部分被 §J.0 D2 覆盖:面板做空保留) 做空 面板按钮(stockShortFor()/closeShortFor()) 融入出牌:空头合约牌/借股反卖 做空作为「独立操作」这件事
J4 裁决的呈现 法庭:起诉→投入→判决(弹窗式,三级法院是阵营建筑) 不弹窗的会议阶段:出牌即表态、站队跟牌、比总点数 §7.2 的「起诉→投入→判决」流程、§7.5 的「三级法院是建筑」、§7.6 的法官职业
J5 裁决的对象 6 类案件(弃养/学术不端/操纵/侵占/背信/渎职) 权力技能(考核/维持秩序)插入会议 不是取代案件,而是把「权力技能」也变成会议;案件清单保留
J6 资金流向 未写(费用直接消失/进金库) 阶级基金:费用进公共池,每回合分配给该阵营最穷者 v2.0 没有这条 ⇒ 属新增,不覆盖任何东西
J7 帐户 隐含持久帐号(ELO/赛季/场外资产) 去中心化密钥JJD-xxxx-xxxx(无注册、遗失不补、同 IP 不互计分) 「注册/找回」的前提;ELO/赛季降级为待整合
J8 技术选型 Web(DOM + Vue + 单档) Godot 双轨(+Worker 沙箱、多语言转译器) 「只有 Web 一条路」的假设(但现况仍是 Web,见 H.3)
J9 XSS 防范 XSS(纯文本渲染) XSS 是玩法(在沙箱内注入) 「XSS 只是风险」这件事;但宿主页面仍不 eval 玩家字串(守则不覆盖)
~~J10~~(已被 §J.0 D3 覆盖:IPO 保留、不降级) 股市扩充(IPO/投机者加成) §8.2 的 IPO 流程 + 投机者股市加成 未表态(v2.1 没提) 降级:它们依附在「面板价格」上,股牌化之后要重写(📋 待重写,不是采用)
J11 职业数 14(10 已实作) 14(「为 14 个基础职业补全专属建筑」) 无冲突(两边一致);建筑系统是新增
J12 联机进度 「联机架构」列第三梯队 📋 未提 v2.0 已过时:联机已可玩(NET-01~NET-06,v1.33.111)

J.13 其他「过时」但不属于冲突的(以程式码为准)

文件写的 现况(v1.33.128)
「脏标记系统」已实作 已进化成事件驱动重绘(dirty 事件退场、引擎 0 处 markDirty、UI_ORDER 15 块)——见 RD-01~RD-09
「14 个基础职业」 设计目标 14、实作 10
四层「第 3/6/10 局解锁」 没有解锁机制,所有系统一次全开
「法庭」「黑客」「积木」「指令」「档案」「变体」「技能树」「建筑」 js/ 全部搜不到 ⇒ 📋
ELO/场外资产/赛季 📋(且要先有帐户)

J.14 不是冲突、但也要交代去向的(2026-10-19 补记)

§J 的表只记「v2.1 覆盖 v2.0」的冲突。问题是:没有冲突的内容被丢掉时,不会出现在那张表里。 这一节就是补这个洞 —— 下面每一条都是「整合时掉了,但没人发现」。

# 掉了什么 现在在哪 教训
N1 整层「状态/Buff/觉醒值」(v2.0 §9 + §5.2 + §6.1 + §9.3 + §17) 已补副档 状态与Buff设计集.md;本档新增 §M 「细节被压缩」不能拿来解释一整个系统的消失。_archive/README 举的细节例子全是「系统内的算式」,不是系统本身
N2 系统优先级附录(v2.0 :1421-1471 四个梯队 + 长期构想) §I.2/§I.3 依架构债重排(合理),但旧梯队没有留痕;本节记下「已作废,逐项去向见 §J.15」 被取代的东西也要交代去哪里,不然「Buff 曾是第一优先」这种资讯就永久消失
N3 变体 42 → 30 的缩减(v2.0 §5.1 = 14 职业 × 3;本档 §C.3 = 10 职业 × 3) 缩减是对的(只做已实作的 10 个职业);但另 12 个(小贩/法官/贵族/记者各 3)没有写「等那 4 个职业实作再设计」 缩减要写成决定,不然读者分不出「还没设计」与「不做了」
N4 「出牌即攻击」的拍板状态(v2.0 待拍板 #6) §B.4 只写「保留为构想,未实作」,没有标 ⚠️ 待拍板 待拍板清单 8 条里,D1(胡牌)与 D6(混沌层)有裁定,#6 没有 ⇒ 应标 ⚠️
N5 v2.1 §一 的原则修订句:「如果一个功能,让玩家不用思考『出什么牌』也能赢,那它就是违反主心骨原则的」 §A.1 只写「任何新系统都要回答它怎么影响出牌」(弱了一级) 原稿有更好用的判准句时,要原样搬,不要改写成摘要
N6 §F 四个模式的原意(克隆=同一角色+胜利退回出完牌;鸡尾酒=技能错位+资讯战;沙盒=纯出牌练习;黑市=技能卡来源) 已照 v2.0 原文更正(§F) 一行摘要会改写语意:四个模式错了四个,而且错得看不出来

J.15 覆盖表(原稿每一节 → 现在在哪)——整合时必须填这张表

用途:以后任何一次「合并/浓缩」都先填这张表,没有冲突的内容也要交代去向。 「去向」四种:本档某节/副档/archive(仅细节)/刻意不做。

原稿 主题 去向 状态
v2.0 §1 设计哲学 §A ✅ 已吸收(N5:判准句没搬)
v2.0 §2 核心定位 §A.2/§K.1(人数、胜利条件) ✅
v2.0 §3 出牌规则 §B.1/§B.2/§B.3/§B.4 ✅(胡牌 ❌ 已否决)
v2.0 §4 角色系统 §C.1/§C.2/§C.3 ✅(加强案细节留 archive)
v2.0 §5 变体系统 §C.3 + 副档《职业变体设计集》 ⚠️ 42→30(N3);§5.2 的觉醒值 → §M
v2.0 §6 技能树 §C.3 + 副档《角色技能树设计集》 ✅(💭 探路)
v2.0 §7 法庭 §E.1(会议阶段覆盖呈现) ✅(公式细节留 archive)
v2.0 §8 经济(银行/股市/子女/图书馆/研究所/技能卡来源) §D.1~§D.5 ✅
v2.0 §9 Buff 系统重构 副档《状态与Buff设计集》+ §M 🔴 原本整层漏掉(N1)
v2.0 §10 模式系统 §F 🐞 四条被改写(N6),已更正
v2.0 §11 黑客模式 §G(+§J.0 D6 可脱离本作) ✅
v2.0 §12 积木模式 §G ✅
v2.0 §13 指令系统 §G ✅(26 指令清单留 archive)
v2.0 §14 档案系统 §G ✅(目录结构留 archive)
v2.0 §15 ELO/结算 §H.2 ✅
v2.0 §16 场外资产 §H.2 ✅
v2.0 §17 学习曲线(局数解锁、觉醒值解锁) §A.2/§H.5 + §M(觉醒值那一半) ⚠️ 原本只留「没有解锁机制」
v2.0 §18 联机架构 §H.4 ✅(已落后于现况,以程式码为准)
v2.0 §19 技术架构(脏标记、Godot、FX) §H.3/§J.13 ✅
v2.0 §20 Wiki §H.5 ✅(细节留 archive)
v2.0 §21 玩家排布 §H.5 ✅
v2.0 §22 系统优先级附录 §I.2/§I.3 重排;旧表作废(N2) ⚠️ 已交代
v2.0 待拍板 8 条 §J.0(D1/D6 已裁定)+ §B.4(#6 未拍板) ⚠️ #6 应标待拍板(N4)
v2.1 §一 核心原则修订 §A.1 🐞 判准句没搬(N5)
v2.1 §二 股牌 + 做空融入出牌 §D.1 ✅(§J.0 D2/D3 再次覆盖)
v2.1 §三 大牌打控/小牌打残 + 会议阶段 §B.3/§E.1 ✅
v2.1 §四 紊乱模式 + 黑客扩展 §F/§G ✅
v2.1 §五 密钥帐户 + 经济咬合 §H.1/§D.2 ✅
v2.1 §六 建筑/机关层 §G 的建筑(📋)+ §J.11 ✅
v2.1 §七 技术选型(AST 转译、沙箱) §H.3/§G.1 ✅

K. 核实清单(已核实/存疑)

K.1 已逐一核实(2026-10-19,v1.33.128)

项目 核实方式 结果
基础职业数 js/data/roles.js 的 ROLES 区块 10
技能卡数 SKILL_CARDS 区块 16
人数范围 js/data/balance.js 的 PLAYER_COUNT_MIN/MAX/DEFAULT 4~10,预设 6
胜利条件 checkWin() + showOverScreen() 标题 5 种:阵营进度/知识分子考试/独活/金融帝国(财富 ≥800)/和平演变(掷 6)+全员破产终局
六种元规则 rules.js/play.js/技能卡 全部 ✅
法庭・黑客・积木・指令系统・档案系统・变体・技能树・建筑・解锁 js/ + dev/index.html 搜关键字(大小写敏感) 全部 0 命中 ⇒ 📋
联机 js/net/online.js/js/net/room/tools/llm-proxy.mjs ✅ 可玩(NET-01~06)

K.2 存疑(本档没有去核实,动工前要自己查)


L. 修订史

版本 日期 内容
v1.0 2026-10-13 初版
v2.0 2026-10-13 大修:法庭节奏/判决公式/三级法院改阵营建筑/阶级优势不对称
v2.1 — 增量:股牌化、做空融入出牌、会议阶段、紊乱模式、密钥帐户、经济咬合、Mini-VM
v3.0(本档) 2026-10-19 整合成一份:以 v2.1 覆盖 v2.0(§J 逐条记录)、用 v1.33.128 的程式码核实状态(§K)、新增 §I「未实作部分的处置原则」
v3.0 修订 2026-10-19 ① 写入玩家 6 条裁定(§J.0)② 技能树降级为「💭 探路方向」(§C.3)③ 两份原稿移到 _archive/、副文件只留变体集 + 技能树集(§〇 档头)
v3.0 修订 2 2026-10-19 补回整合时漏掉的那一层:① 新增 §M「状态与成长」+ 副档 状态与Buff设计集.md(Buff/觉醒值)② 修正 §F 四个模式被误摘要的原意 ③ 新增 §J.14(漏掉/缩掉的交代)与 §J.15 覆盖表(以后整合必填)④ 档头副文件改成三份

原稿位置:docs/设计案/_archive/(游戏设计总览 v2.0.md、设计案增量文档 (v2.1).md)—— 保留细节、不当现况(本档已取代它们的内容;有疑义时以本档 + 程式码为准)。

📌 文档收拾原则(2026-10-19):同一个主题只留一份「现况」; 被取代的移到 _archive/ 并在档头写「已被 X 取代」——不要让两份都活在第一排 (那会让下一个人读到过期的状态)。

⚠️ 整合的教训(v3.0 修订 2 补记):把两份原稿浓缩成一份时,「冲突」会被记下来, 「没有冲突但被丢掉」不会。所以 §J.15 的覆盖表不是文件洁癖 —— 没有它,漏掉的东西 就是永久消失(Buff 层就这样消失了一轮,而且它还是 v2.0 自己排的第一梯队第一项)。


M. 状态与成长(Buff/觉醒值)

一句话:一局之中「谁身上挂著什么」(主状态 + Buff),以及它怎么被累积成跨局成长(觉醒值)。 详见副档:状态与Buff设计集.md。 ⚠️ 本节只做摘要;设计意图一律以副档为准(与变体集/技能树集同一个位阶规则)。

M.1 现况:主状态的 17 段混了四种东西

hud.js 的 renderStatusMark() 是 17 段 else-if,拆开来其实是:

种类 例 该怎么处理
派生 💀破产、💸负债 算出来的,不是状态(debt 要带 amount/limit)
身份 🎓知识独立、🏛️征税中 本来就有(role.camp/role.id),不是 Buff
全域事件 → 投影 📉减产年、🌾丰收年、🚜土地改革 scope:'global' + 「谁看得到」的规则
持久玩家状态 📈假性繁荣、⚖️双重标准、🛌躺平、📦补给线、💸通膨N、🃏伪装X、💵收租中 真正该 Buff 化的 7 个

⇒ 统一框架的第一步不是改名,是把这四类分开。

M.2 Buff 框架(v2.0 §9.2 的形状)

id/name/icon/type/scope(self/global/camp)/source/duration/stackable/effect/ onApply-onTick-onExpire/priority/visible。

⚠️ 本专案的四条落地限制(不遵守就撞铁律): ① 存的是「状态的事实」不是函式(effect 要查表,不能进存档);② 新状态要 SAVE_FIELDS/SAVE_SKIP 二选一(铁律 12); ③ 不可以住在唯读表上(铁律 13);④ 不碰 DOM,只发事实(RD/EXIT 的同一条精神)。

M.3 UI:主状态 + Buff 栏

M.4 觉醒值与 AP(跨局成长)

项目 设计(v2.0) 现况
觉醒值 0~100,跨局累积 ❌ 程式码没有
转职 30 解锁、60 费用 -50% 📋
AP 每 10 觉醒值 = 1 AP(上限 10) 📋(技能树副档用它)
用途 转职/技能树/Buff 栏解锁/学习曲线 📋

⚠️ 它天生跨局 ⇒ 需要帐户(§H.1 的密钥帐户还 📋)⇒ 觉醒值是「有帐户之后」的东西。 ⚠️ 它同时是「转职门槛」与「UI 资讯量解锁」:联机同桌时两边画面不同是刻意的 (「少看到」≠「看到假的」——后者是 §F 的紊乱模式)。

M.5 与 EXIT/STATE 的关系(这一节是三条线的交会点)

📌 排队建议:STATE-01(登记)→ §M.1 的分类 → M.3(主状态资料驱动)→ EXIT §三.4 才有东西可以回。 反过来先做 panelStatus,等于把「随手排的 else-if」冻结成契约。


⚠️ 本档是设计意图,不是实作承诺、也不是规则手册。 实作前请回到 专案规则/04-开发流程.md 与 专案规则/02-命名规范.md §1.2(先登记线/阶段)。