feedback5 R4: paths after the kit split — DESIGN §7 and SIM.md (layout, §7.2 kit contract, kit citations), research 09, code comments (content/generic, tokens, items/battle, shared/loadoutRecord, render fx / demo), test comments, and the kits' own comments that named tierN.js; DESIGN §17–§23 history citations are left as they are

server/sim/content/generic.js

@@ -35,7 +35,7 @@
 //   推与拉 方向力) / 朝部署方向 / 向前 / 身前方向 or for 推击手 (directional), otherwise away from the unit (radial); a skill of
 //   constants.js PUSH_EFFECT_SKILLS (见行者 S1) pushes by PRTS 推与拉's 特效 column. These keywords are only a fallback:
 //   the hand-written kits follow the client's buff templates (knockback[dir] = directional, knockback[relative] = radial),
-//   and the text can mislead — 琳琅诗怀雅 S3's "向前推开" is knockback[relative] (kits/tier3.js). No pool skill pushes
+//   and the text can mislead — 琳琅诗怀雅 S3's "向前推开" is knockback[relative] (kits/ops/chess_char_3_04-swire2.js). No pool skill pushes
 //   through this path with 向前 / 往攻击方向; the only generic push is 见行者 S1, a 推击手.
 
 import { normalizeSkill } from '../simdata.js';

server/sim/content/items/battle.js

@@ -253,7 +253,7 @@ export function revivedInPlace(u) { if (u && u.mem) u.mem.revives = (u.mem.reviv
  * Does `u` hold 坚固维式重锤's 不死 right now — a window started in this deployment that has not run out? The window lives
  * on the unit (`mem.undyingUntil`, `mem.undyingAt`) and a battle-level hook holds it (hammerAcquire), so it outlives the
  * grant that started it — a lend running out mid-window leaves the 不死 for its 8 s [ASSUMED: the 异常效果 outlasts its
- * source] — and ends with the deployment. 信仰搅拌机 S2 steps aside while it holds (kits/tier4.js).
+ * source] — and ends with the deployment. 信仰搅拌机 S2 steps aside while it holds (kits/ops/chess_char_4_01-rmixer.js).
  */
 export function holdsUndying(battle, u) {
   return !!u && u.mem.undyingAt != null && battle.time < u.mem.undyingUntil && u.mem.undyingAt === deploymentOf(u);

server/sim/content/kits/ops/chess_char_1_16-tinman.js

@@ -59,8 +59,6 @@ export function tinmanKit(bb, chess, def) {
 }
 
 export default {
-  // 1_15 盟约·辅助干员 (hidden, band 优等生): its kit is tier6.js `pithst` (迭代元素 — one implementation only).
-
   // ---------------------------------------------------------------------------------------------------------------
   // 1_16 锡人 (hidden tier-1 entry of chess_char_2_19): see tinmanKit.
   chess_char_1_16_a: tinmanKit,

server/sim/content/kits/ops/chess_char_2_19-tinman.js

@@ -6,7 +6,7 @@ import { tinmanKit } from './chess_char_1_16-tinman.js';
 
 export default {
   // ---------------------------------------------------------------------------------------------------------------
-  // 2_19 锡人 “大拉里”: see tinmanKit (tier1.js).
+  // 2_19 锡人 “大拉里”: see tinmanKit (chess_char_1_16-tinman.js).
   // S1 “老科利” (alt, attack SP, needs a target): throws an alchemy unit at the target (ground first); for
   // projectile_delay_time s ground enemies within projectile_range tiles are 虚弱 (weaken −atk) and take atk_scale ×
   // ATK arts per second (ATK cached at the cast; damage over time, so the elite 凋敝魂灵 ×skill@damage_scale applies;

server/sim/content/kits/ops/chess_char_4_25-cetsyr.js

@@ -12,7 +12,7 @@ import {
 /**
  * 鼓舞 (ba.inspire "获得额外附加的基础属性加成（同类属性取最高）"): +`val` ATK (or max HP) on top of the target's own
  * percentage multipliers (the flat mod is compensated, so an ATK+% skill does not scale it), the strongest source wins
- * (the ATK key `inspire` is shared with tier6's 鼓舞); units flagged `mem.noInspire` (bards: 自身不受鼓舞影响) never
+ * (the ATK key `inspire` is shared with 浊心斯卡蒂's 鼓舞); units flagged `mem.noInspire` (bards: 自身不受鼓舞影响) never
  * receive it. Refreshed by an aura: lapses within AURA_DUR once the source stops.
  */
 function inspire(battle, target, val, src, stat = 'atk') {

server/sim/content/kits/ops/chess_char_5_20-aglina.js

@@ -22,7 +22,7 @@ export default {
   // off, all allies regenerate 20 HP/s. Module (elite): longer sluggish (trait bb, profession tunables).
   // S1 秘杖·速充模式 (duration, attack SP): ATK +; she attacks normally with S1 ("技能未开启时无法普通攻击" is only in the
   // S2/S3 texts). S2 秘杖·微粒模式 (duration, SEARCH): attack interval ×base_attack_time ("极大幅度缩短": a positive value
-  // described as a shortening is the new interval ratio, tier1 batMod convention), each attack damage_scale × ATK arts.
+  // described as a shortening is the new interval ratio, the shared/tier1.js batMod convention), each attack damage_scale × ATK arts.
   // Module DEC-X (elite): SP +0.2/s with an enemy in range.
   chess_char_5_20_a: (bb, chess, def) => {
     const t0 = talent(chess, 0), t1 = talent(chess, 1), tm = talent(chess, -1);

server/sim/content/kits/ops/chess_char_6_18-whitw2.js

@@ -50,7 +50,7 @@ function whitw2(bb, chess, def) {
   // ② the selectable enemy nearest to the drone, ties broken by the one nearest to her. [ASSUMED] distances are measured
   // to every enemy's position (a huge enemy's centre, its 判定中心) — the owner's decision of 2026-10-04: the centre, so
   // leader rounds stay close to 0.1.1; the sim's general convention for operator-side distance picks, the hit rectangle
-  // (body.js bodyDist: targeting.js sortEnemyTargets 'nearest', tier3 enemiesAround, 异客 / 溯光星源's chains), was
+  // (body.js bodyDist: targeting.js sortEnemyTargets 'nearest', 空弦's enemiesAround, 异客 / 溯光星源's chains), was
   // considered — it made a huge leader (胄, 管) the nearest enemy of every drone around it (DESIGN §22.9)
   const pickTarget = (battle, unit, d, ok) => {
     let best = null, bd = Infinity, bh = Infinity;

server/sim/content/kits/shared/tier1.js

@@ -9,7 +9,8 @@
 //
 // Covered (normal + elite): 1_01 隐现 1_02 角峰 1_03 惊蛰 1_04 深巡 1_05 红豆(H) 1_06 刺玫 1_07 普罗旺斯 1_08 德克萨斯
 // 1_09 跃跃 1_10 古米 1_11 地灵(H) 1_12 艾丝黛尔 1_13 波登可 1_14 格雷伊 1_16 锡人(H) 1_17 深靛
-// 1_18 宴 1_19 野鬃 1_20 雷蛇.  (H = hidden in the shop pool, still authored.) 1_15 盟约·辅助干员(H) lives in tier6.js.
+// 1_18 宴 1_19 野鬃 1_20 雷蛇.  (H = hidden in the shop pool, still authored.) 1_15 盟约·辅助干员(H) is registered
+// with the tier-6 kits.
 // Operator loadouts (DESIGN §16): every selectable non-default skill of the 16 visible chess is authored in the kit's
 // `skills: { [skillId]: SkillSpec }` map from its own SkillRecord (skillRec / skillBbOf — Lv4 normal, Lv7 elite);
 // talents / traits read the resolved record, so a module choice ('none' ⇒ traitBase / talentsBase, module.active
@@ -227,7 +228,7 @@ export const skillBbOf = (chess, skillId) => skillRec(chess, skillId)?.bb ?? {};
 /**
  * Skill blackboard `base_attack_time` → engine batPct of this chess's base attack time. The value is a FLAT change of
  * the base attack time in seconds (AK attribute ADDITION: 送葬人 −0.5 on 2.3 s "少量缩短(-0.5)" ⇒ 1.8 s, 红豆 +0.5
- * "略微增大(+0.5)" — the same convention as tier4/tier5), except a positive value described as a shortening, which is
+ * "略微增大(+0.5)" — the same convention as the tier-4 / tier-5 kits), except a positive value described as a shortening, which is
  * the new interval ratio (深靛 0.7 "攻击间隔略微缩短" ⇒ ×0.7). The convention is per skill in AK: skills PRTS lists as
  * a ratio (雷蛇 反击电弧 "+70%", 古米 食粮烹制 "+130%", 深靛 灯塔守卫者 "-80%") use batPct = value directly, not this.
  */

server/sim/content/kits/shared/tier2.js

@@ -1,9 +1,9 @@
 // server/sim/content/kits/shared/tier2.js — helpers and notes of the Tier 2 operator kits (formerly tier2.js; the kits
 // live one per file in ../ops/).
 //
-// export default { [baseChessId]: (bb, chess, def) => Kit } (docs/SIM.md §7.2). Shared helpers live in tier1.js (named
-// exports). Numbers come from the skill / talent / trait blackboards (elite module upgrades are in the elite record's
-// trait.bb and hidden index −1 talents). fx kinds: see the tier1.js header.
+// export default { [baseChessId]: (bb, chess, def) => Kit } (docs/SIM.md §7.2). Shared helpers live in shared/tier1.js
+// (named exports). Numbers come from the skill / talent / trait blackboards (elite module upgrades are in the elite
+// record's trait.bb and hidden index −1 talents). fx kinds: see the shared/tier1.js header.
 //
 // Covered (normal + elite): 2_01 送葬人 2_02 赫默 2_03 崖心(H) 2_04 小满 2_05 哈洛德 2_06 莎草 2_07 幽灵鲨 2_08 泡泡
 // 2_09 休谟斯 2_10 洛洛 2_11 风丸 2_12 砾 2_13 蒂比 2_14 调香师 2_15 协律(H) 2_16 拉普兰德 2_17 折桠 2_18 灰毫 2_19 锡人.

server/sim/content/kits/shared/tier5.js

@@ -159,7 +159,7 @@ function lowHpHealUp(battle, unit, tb) {
 
 /**
  * Modules "攻击范围扩大" (夕 SPC-X, 白面鸮 RIN-X): the range becomes the SELECTED module's own grid — the data's
- * range-only talent change (talentIndex −1), e.g. SPC-X = the 3×3 caster range + ONE centre tile [0,3] — like tier4's
+ * range-only talent change (talentIndex −1), e.g. SPC-X = the 3×3 caster range + ONE centre tile [0,3] — like the tier-4 kits'
  * 莫斯提马 / 莱恩哈特 / 白面鸮 (integration review: a flat forward +1 added a whole column, 3 tiles, and widened the skill
  * ranges too). It replaces the unit's own range, so the DEFAULT trigger's initial range follows; skills with their own
  * range keep it. Without such a grid in the data: one extra forward tile [ASSUMED].

server/sim/content/kits/shared/tier6.js

@@ -165,7 +165,7 @@ const selectedSkill = (chess, def) => chess?.skill?.skillId ?? def?.skill?.id ??
 /**
  * Skill blackboard `base_attack_time` → engine batPct, the rule of the AK damage calculator (akdata attributes.js,
  * checked against the game): a shortening (v < 0) is a FLAT change of the base attack time in seconds (送葬人 −0.5 on
- * 2.3 s ⇒ 1.8 s, the tier1 `batMod` convention), a lengthening (v > 0) scales it (迷迭香 S2 +0.5 ⇒ ×1.5, 佩佩 S3 +0.2 ⇒
+ * 2.3 s ⇒ 1.8 s, the shared/tier1.js `batMod` convention), a lengthening (v > 0) scales it (迷迭香 S2 +0.5 ⇒ ×1.5, 佩佩 S3 +0.2 ⇒
  * ×1.2). `mul` = a skill the calculator lists as "攻击间隔缩短，但是是乘算负数" (异客 S2 −0.3 ⇒ ×0.7, 迷迭香 S3 −0.5 ⇒ ×0.5).
  */
 function batOf(v, def, mul = false) {

server/sim/content/tokens.js

@@ -32,7 +32,7 @@
 //                 its blast fx carries `consumed: true` so clients play the explosion, not a death sound)
 //   从不混淆的方向 untargetable marker; when the owner's skill ends it vanishes and the owner returns to its tile
 //   黄金盟誓      attacks deal true damage (trait); lasts while the owner's skill runs; 维娜 S3 places one on every
-//                 free deployable tile around her (kits/tier6.js) — no per-owner deploy limit (SKILL_SUMMON_UNCAPPED)
+//                 free deployable tile around her (kits/ops/chess_char_6_07-siege2.js) — no per-owner deploy limit (SKILL_SUMMON_UNCAPPED)
 //   防护单元      untargetable, invulnerable device placed by the player (a hand piece, user playtest #6): shield =
 //                 凯瑟琳 max HP × max_shield_ratio on the operator in its range (range 1-1: the tile it faces; effects do
 //                 not stack — `cathy:shield`, read by 凯瑟琳 S1 岁月锻打), in full whenever it takes a new operator,
@@ -691,7 +691,7 @@ function wolfPack(bb, raw, def) {
  * The operator a 流形 copies ("可复制待部署区一名干员"): the nearest (Chebyshev tiles) living operator of its player on
  * the field, not the summoner; ties → higher base ATK → lower id. (The remake deploys the whole board at battle start,
  * so the official "operator waiting to deploy" is read as the nearest deployed operator — same pick as the 缪尔赛思
- * kit, content/kits/tier6.js.) Null when there is none: the 流形 then waits with its copy skill ready.
+ * kit, content/kits/ops/chess_char_6_11-mlyss.js.) Null when there is none: the 流形 then waits with its copy skill ready.
  */
 export function pickCopyTarget(battle, unit) {
   let best = null, bs = null;
@@ -1438,7 +1438,8 @@ function deployLimitOf(u) {
 /**
  * Tactical point (战术点) of a tactician when the player placed no 援军 piece: `Battle.findTacticalPoint` — a free
  * walkable tile of its initial range, on an enemy ground path first (where a player would put the blocker), then
- * nearest to the tactician. Shared by every tactician kit (tier3 伺夜, the tokens' own fallback).
+ * nearest to the tactician. Shared by every tactician kit (伺夜, kits/ops/chess_char_3_19-vigil.js; the tokens' own
+ * fallback).
  */
 export function tacticalPoint(battle, owner) {
   return battle.findTacticalPoint(owner);