水浒人物拓扑图（cast-map）

一个纯本地、零依赖的 HTML 拓扑图：108 将与全部非 108 人物画在一张图上，点头像看 品质与技能矩阵 ／ 属性成长（两轴） ／ 升星与技能 ／ 羁绊与关系 ／ 档案与台词 ／ 口径页 ／ 数据溯源。

本图的设计层取自 docs/ 里的稿件，不取工程现网配置： 技能内容以 水浒108将技能设计V3.md（V3 §0.2 自称"施工档"）为准，叠加本目录生成的《技能独立性修订》 （S01–S30 换机制、S31–S68 校平、S69–S102 差异化、S103–S179 塔防化改写，共 179 行）；品质与两轴养成以 108将成长属性表V1.md ＋ tools/tier_growth.py 为准 （红 22／橙 40／紫 28／蓝 18，局内 1–5★ 合成制、局外 Lv1–50 花资源，关键级解锁链逐将自己生成）。 现网的 yingxiongjineng 里多个将共用一条技能、tfyingxiong 里四档升级成本只差 0.2%， 那正是本次要被替换掉的东西，只在「数据溯源」与页末折叠块里留作对照。

目录位置：本图在 shuihu-master/Alan测试结果/cast-map/，tools/ 与 docs/ 与它同级； 工程目录由 build_cast_map.py 自动向上查找（也可用环境变量 SHUIHU_PROJ 指定）。

怎么打开

双击 index.html 即可（file:// 直接可用，不需要服务器、不联网、不用构建）。 如浏览器限制本地图片，可在本目录执行 python -m http.server 8000 后访问 http://127.0.0.1:8000/。

操作

角标：右下绿点＝工程里已建档（其技能行是占位，设计要替换）；左上灰点＝占位头像。

数据从哪来（分层，全部现测）

已经下线的旧口径（载荷里不再有，体检有一条"残留即 FAIL"盯着）： 局外 10★ 升星、design.starCost·ladder·ladderK·matrix.real_cost、三币种（本体／将魂／升星石）、 星宿石、design.redBlue（旧"红 12 将"名单）、紫卡"特技预留"。

生成方式（在本目录的上一级 Alan测试结果/ 里跑；改完真源后按此顺序重跑，不要在 data.js 里手改）：

cd shuihu-master/Alan测试结果
python tools/v3_parse.py                    # 解析器自检（108 块／206 技能行／词条 108 条…）
python tools/v3_delta.py                    # 生成 S 编号台账（换机制＋校平＋差异化）→ docs/＋tools/v3_delta.json
python tools/scan_v3_independence.py --delta# 合并稿体检（改档＋校平＋分散化后必须 0 条问题）
python tools/build_cast_map.py              # 第一遍：生成 data.js（补配行此时还是旧表）
python tools/skill_fill.py                  # 读新 data.js，按各将人设重写 54 行补配 → 成长文档 F 表
python tools/build_cast_map.py              # 第二遍：把新补配表读回载荷
python tools/check_cast_map.py              # 交付体检（§4g 成长线＋§4h 技能质量＋§4i 差异化；退出码跟结论走）
python tools/test_cast_checker.py           # 阳性对照（40 类注入，须全命中）
python tools/audit_cast_map.py              # 自查：载荷尺寸/死键/字段覆盖/边构成
python tools/sim_layout.py                  # 布局 A/B：三种力导向配置的量化对照
python tools/castmap_probe.py               # 浏览器实测：起服务＋拉 Edge，逐条交互判据＋截图

规模（以 tools/cast_map_check.txt 为准）：431 节点、841 条边、139 组羁绊、 260 条战斗技能行（V3 206 ＋ 补配 54）、S 编号 179 条（换机制 30／校平 38／差异化 34／塔防化 77）、头像 113 个文件、台词挂载 92 人。 差异化三项（都是复算值，不是自评）：整将技能功能组合 108／108 种（无两将同构）、 技能功能指纹 81 种（最大共享组 10 行，旧版 25 行）、关键级解锁链 108 种／108 将（效果文案 541 种）。 成长线覆盖 195 名角色：108 将 ＋ 26 敌将 ＋ 61 敌方战斗卡；另有 46 人（NPC 31／演出卡 13／仅点名 2）按设计不给面板，页面上会写明理由。195 + 46 + 190（羁绊/章/职司/阵营）= 431，与节点总数闭合，体检脚本逐条复算。

「属性成长」页里有什么

布局是量过的，不是猜的

tools/sim_layout.py 用与 tick() 相同的力参数跑了三组配置（同种子、同参数，只差"播种方式"与"枢纽是否吃簇锚"）：

我原先担心"139 个羁绊枢纽共用一个簇锚会被吸成一团"，模拟推翻了这个假设（三组重叠对都是 0）， 而"枢纽不吃簇锚"虽然让枢纽更贴近成员（171 vs 186.6），代价是画布宽 42%、高 100%——所以只保留了"按成员质心播种"这一半改动， tick() 里的簇锚照旧。

图的读法

• 颜色＝品质四档：红 22／橙 40／紫 28／蓝 18（tools/tier_growth.py:assign() 复算，主判据＝天罡 seat≤36），节点半径按 ladderK 0.8／1.0／1.3／1.66 递增； 绿是 V3 §2.1 明确留给后续非 108 卡片的保留档，所以图上 133 个非 108 角色一律标绿。 四档的运营定位按你的口径定死：蓝＝过渡（不值得堆量）、橙＝核心培养、红＝追求（难获取但升级吃得少）。
• 108 将的名字一律「绰号·姓名」（黑旋风·李逵、豹子头·林冲、呼保义·宋江）：不管这张卡在工程里有没有建档，标题、画布标签、搜索结果、面包屑都是同一个写法； 姓名／绰号两种搜法都能命中。30 张已建档卡的配置名本来就等于这个拼法（实测 0 处冲突），所以统一不会改动任何已有标签。 没有真头像时，占位盘取姓（卢俊义→"卢"，不是"义"）。
• 阵营只作为分簇底色与"阵营枢纽"边存在（14 个枢纽），不再参与卡牌配色。
• 羁绊 139 组画成枢纽节点＋放射边；规模只用 2／3／4／6——上阵上限 6 人，7 人以上永远触发不了， 所以《图鉴》§7 那 27 组（含 7/8/16 人团伙）不作为图上口径，被《羁绊设计》取代。
• 两条养成轴（记法＝打得到的看局内，养得到的看局外）： 带 战斗内 N★ 解锁 徽章的是局内合成升星（1★主动／3★被动或第二攻击／5★绝招，不花资源）； 带 战斗外 LvNN 的是局外升级解锁（Lv5…50 十档技能拓展，花通用碎片＋同名卡）。 原 V3 的"局外 8★／10★"两条词条已改挂 Lv35／Lv50，内容一字未改。
• 红色有向边＝原著杀敌关系，只在选中该边一端时加粗显箭头。

口径与已知限制（先说清楚，免得被当成事实）

1. 台词全部是拟作，不是《水浒传》原文；「数据溯源」页标出每个字段的出处。
2. 技能/品质/羁绊是可推翻的设计稿口径，与工程现网不同级；被 S 层改过的行在面板里带 改档 S01＋S37 这种并联号（一行可能被换机制与校平各改一次），溯源页能点开看到同组保留了谁。
3. 108 将的成长线已全部有设计值（docs/108将成长属性表V1.md，195 名角色全覆盖）；工程侧仍只有 56 张卡 （108 将在编 30 ＋ 敌将 26），所以78 只将"有设计、无落卡"——要落地需新增 78 张 tfyingxiong（每人 1 行/级）。 已建档者的那条 21 阶现网曲线折到「属性成长」页末尾，标为"本次要替换掉的"。
4. 敌将不重设计：按 V3 §9「敌将不迁」，26 只已建档敌将的技能页显示的就是现网配置；但它们的成长面板按同一公式补齐了（quality 映射品质，绿档敌将按蓝档基准）。 C 表尾部六列给的是等阶参考线（星上限 5／满级 50／同名卡／碎片／每级首尾），不是玩家消耗——敌方单位不吃养成资源。
5. node.quality（现网品质）与 node.tier（设计品质）仍然并存且 28/30 人不一致，node.growth（现网 21 阶曲线）仍带 30 人。 这是"现网对照"故意留的，面板写明身份；想归一要先决定以谁为准（审查稿 R8）。
6. 取的是 config_export/*.json。它和线上 allconfig.bin 已实测 27/27 全等；若只改了 bin 需重跑 export_config.py。
7. 占位头像不是美术资产，只是首字 + 品质色的示意盘。
8. 本目录是交付物副本，不参与游戏构建（Cocos 只打 assets/ 与 build-templates/）。
9. 成长面板里的 12 字段是设计口径，工程面板现在只有 4 项（攻防＋暴击率＋暴伤）；exp 列、第 3 主动槽、8 个 SkillParams 列都得先加。
10. 4 个 attr（26／28／36／37）没有现网样本，被 48 条技能用到；单位是按 V1 §1.1 的写法推的，面板会标「需实测校准」。落表前必须拿 SkillMgr 分支实测一次。
11. 技能数值层面不做"跨品质单调"判据（同 attr 的值随 object/type/cxtime 变，中位不可比）；被钉住的单调性是面板按 ladderK 递增与同将内各档严格更强。理由与实测数见成长文档附口径 0b 的 R23 行。

本图的实现决策（P 编号，供审改）

待拍板（沿用 V3 的 Y 编号 ＋ 本图新增）

• Y1–Y6：见 docs/水浒108将技能设计V3.md §12（朱武是否升红、蓝卡 5★ 封顶、星宿石只上翻、重复卡转化率、紫特技是否先进 UI、红卡是否独占立绘）。 其中"蓝卡 5★ 封顶"与"星宿石"两条已被 P12/P13 取代（四档都 5★、没有星宿石），其余仍要 V3 作者定。
• N1｜22 组重复技能是否接受按 P2/P3 的取舍改档：不接受的话，可改为"保留谁的机制"另定，脚本只需换锚。
• N2｜V3 原稿"说明与参数打架"的行（王英技1/技2、扈三娘技1/技2、龚旺技1、杨志技2、孔明技2、张清技2、马麟技1）—— 本轮已校平：这些行要么进了 S 层（说明由参数重渲染），要么被 §4h 的"相邻档至少改 2 个参数"逼出真数值。若你要保留原手 writing 风格，需要另定文案模板。
• N3｜彭玘技1 的 object=2 疑似笔误：原文写"对凶手一击按 160% 重创"，目标应为敌方（object=1）。修订稿已按 object=1 落，但这算改文档原值，需确认。
• N4｜敌将是否也要独立化：现网 26 只敌将里有同名同参技能行（面板已标"沿用配置"），V3 §9 说不迁——确认维持还是另开一轮。
• N5｜"橙＝核心培养"要求定向通道把橙的指定同名片抬到 ≥1.05 片/日（否则橙落点 17.6 日反而慢于紫 16.7 日）；红要刻意留在 0.28–0.35 片/日。这是数值结论，接 R17 通道时按它开阀。
• N6｜同档输出 DPS 极差要不要设硬上限：实测紫档 3.99×，旧稿自称的"限 3.0 全 PASS"是没进判据的自评，现按实测改口径并列为 V19（成长文档 §8）。
• N7｜差异化拆行动了 34 行 V3 行的 type／behavior（如"单体→范围"）：台账在《技能独立性修订》S69–S102，每行带原参数；如果你觉得某将的形态不该变，指名回滚，脚本换锚即可。
• N9｜塔防化改写动了 77 行（说明＋技能名，参数零改动；台账 S103–S138）：无载体行为换写法（彭玘"突进至倒地处"→"旗立怒击"、李衮"跃入敌阵"→"先登垒土"）、盾/格挡全部改挂城墙（宋江"号令护佑"、呼延灼"护军"、穆弘"没遮拦"、宋万/杜迁/汤隆/侯健/燕顺/项充等——现在都是"为城墙加筑护盾"）、位移措辞改成不同攻击类型（石秀"跳楼"→"高坠掷杀"、雷横"插翅一纵"→"插翅横扫"、燕青"相扑擒王"→"擒索定将"、陈达"跃涧扑杀"→"越涧狙刺"、林冲"突进贯穿"→"蛇矛直线贯穿"）。若你想保留某个旧名或旧写法，指名即可换回。
• N8｜机制池 MECH 的 30 组关键词映射是设计稿（水战→拖浸、刀斧→断命、医护→敷养…）：你觉得哪个将的机制不像他，指名换词，54 行与同构拆分会一起重排。