文案承载换代(文档设计段): 玩家可见文案承载裁决换代——文案值归 data/l10n/strings.csv、数据表与代码只持文案 key(code-conventions 新增 §2.5 硬纪律; AGENTS.md 红线区加文案单一事实源单行+规范导航指路); 七处 gdd 同步: 战斗结算 v2.1(:87 条款改写)/增益状态 v1.8(display_key)/敌人系统 v2.0(display_key)/锻造工坊 v0.14/秘宝 v1.5(desc_key)/设置与本地化 v1.3(待设计问题4文本键半边闭合)/术语表 v1.30(文案承载新节两词条); 待办清单条目推进文档设计已闭合+待写卡。区内凭据: 流水线闸 PASS(36条目/57行/2链/5卡全过)、文档域闸【验收通过】无新增红(doc_link 死链4处改非反引号文本+能力审计纯度2处去代码调用形态后归绿)、grep 核对旧提法零残留
This commit is contained in:
1 parent
c713f335a9
commit
643f062653
10 files changed
+28
-18
No files matched your search
@@ -49,7 +49,7 @@
|
||||
| 概念切分与互链 | `design/engineering/concept-conventions.md`——概念封装 / 跨文档引用 / 归档与事实源 |
|
||||
| 系统设计 / 增删文档 | `design/gdd/02-系统清单.md`——根索引 + 中文规范名↔英文代号对照 |
|
||||
| 架构(唯一事实源) | `design/engineering/architecture/architecture.md`(只写依赖规则面:分层/目录归属/数据流/架构原则;模块级归属归代码头注,闸清单归 `game/tests/README.md`)——历史决策沿革查 git commit log,不另设决策文档;修订须用户发令 |
|
||||
| 术语与已锁数值 | 规范名与定义 = `design/gdd/术语表.md`(全库唯一对照表,仅 owner 文档可修订);现行数值 = `game/data/tables/*.tres`;规则(概念面)= 各系统 owner 文档;取值域与字段契约 = `game/data/schemas/*.gd`。冲突须显式提出,禁默默改值 |
|
||||
| 术语与已锁数值 | 规范名与定义 = `design/gdd/术语表.md`(全库唯一对照表,仅 owner 文档可修订);现行数值 = `game/data/tables/*.tres`;玩家可见文案 = `game/data/l10n/strings.csv`(key→文案,细则 = code-conventions §2.5);规则(概念面)= 各系统 owner 文档;取值域与字段契约 = `game/data/schemas/*.gd`。冲突须显式提出,禁默默改值 |
|
||||
| 现在做什么 / 待办与待裁 | 根 `roadmap.md` 顶部「当前位」节+迭代总表六列 · 待办唯一登记处 `待办清单.md` · 批次过程与结论查 git 提交信息与 `reports/` |
|
||||
|
||||
## 回答风格规则(只管对话输出;文档写作归 doc-conventions §2–§4)
|
||||
@@ -121,6 +121,7 @@
|
||||
- 真人检测只登记不阻塞——登记进体验验证清单/实现报告即完成义务,禁以等目检为停工理由或当作合回的前置条件
|
||||
- 文件头 = `##` 文档注释,介绍本模块是什么;禁写变更叙事(改动史查 git log);禁文档反向链接(code-conventions §1.4.1)
|
||||
- 数值单一事实源——玩法数值只存 `data/tables/`(.tres)经 ConfigDB 单点读取;禁数值字面量与自建 `load()` 表路径
|
||||
- 文案单一事实源——玩家可见文案值只存 `data/l10n/strings.csv`(key→文案),数据表行与代码只持文案 key、取文案只经 `tr()`/`atr()`;禁文案字面量与文案入数值表;诊断日志豁免(细则 = code-conventions §2.5)
|
||||
- RNG 单点——禁 `randomize()`/自建 RandomNumberGenerator,随机只经 `RngService` 统一流
|
||||
- 架构事实唯一源——架构事实只认 `design/engineering/architecture/architecture.md`(只写依赖规则面:分层/目录归属/数据流/架构原则;模块级归属归代码头注);禁立第二架构文档或决策文档体系,历史决策记录只进 git commit log;架构文档写权限=用户专属,agent 与技能只读(2026-11-07 用户裁)
|
||||
- Core 层零 UI 依赖——完整战斗必须可 `--headless --script` 跑通;fail-fast——数据校验错误一律致命中止,无软回退
|
||||
|
||||
@@ -56,6 +56,9 @@
|
||||
### 2.4 状态字段语义显式
|
||||
跨战斗/跨场景携带或恢复的状态字段,其语义来源必须显式(表值 / 明确入参),禁止用入参隐式定义。
|
||||
|
||||
### 2.5 玩家可见文案承载——key 单点,文案值住翻译文件
|
||||
玩家看得见的文字(界面标签、toast、明细行显示名、卡面摘要等)一律两件分离:**文案值只住 `game/data/l10n/strings.csv`**(key 列+`zh_CN` 列,加语言=加列),代码与数据表行只持**文案 key**(全库唯一,点分命名如 `clear_reward.title`);取文案只经 `tr()`(Node 语境)/`atr()`(非 Node 语境),禁在 `.gd`/`.tscn` 内联写死文案字串,禁把文案值塞进 `data/tables/*.tres`(数值表只管数值)。场景静态 `text` 按 key 写入、经 Godot 场景自动翻译解析;数据表文案字段更名 `display_key`/`desc_key`(值域=文案 key,不是文案本身)。豁免面:开发者诊断文字(`push_error`/`assert`/日志)与 `game/sim`/`game/probe`/`game/tests` 的文字不属玩家可见面,不受本条约束。
|
||||
|
||||
---
|
||||
|
||||
## 3. 测试纪律
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# 增益状态
|
||||
|
||||
> 一句话:增益/减益的状态池、叠层与衰减
|
||||
> 状态:已定稿;现行为 v1.7
|
||||
> 状态:已定稿;现行为 v1.8
|
||||
|
||||
## 设计目的
|
||||
|
||||
@@ -159,7 +159,7 @@
|
||||
| 字段 | 取值 | 说明 |
|
||||
|---|---|---|
|
||||
| effect_id | 文本,全表唯一 | 状态标识 |
|
||||
| display_name | 文本 | 界面与结算明细用名 |
|
||||
| display_key | 文案 key | 界面与结算明细用名的索引,文案值住 strings.csv(code-conventions §2.5) |
|
||||
| target_side | hero / enemy | 作用侧 |
|
||||
| magnitude | 整数 | 幅度:百分比行 ∈ [−100,100] 且非 0;固定值行 ≥ 1;护甲等级行 ∈ [−20,20] 且非 0 |
|
||||
| unit | percent / flat / ac | 百分比修正 / 固定值 / 护甲等级(掷点折扣判定阈值轴) |
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# 战斗结算
|
||||
|
||||
> 一句话:轮末结算的编排与逐行兑现
|
||||
> 状态:已定稿;现行为 v2.0
|
||||
> 状态:已定稿;现行为 v2.1
|
||||
|
||||
## 设计目的
|
||||
|
||||
@@ -84,7 +84,7 @@
|
||||
| 判定行 | 胜 / 负 / 继续各一行;终局判定行同时是胜负画面的数据锚 |
|
||||
| 高光行 | 完美封印成立时一行,只记实际有效兑付 |
|
||||
|
||||
每行还携带公共字段:来源类别、来源格、轮次、显示名、数值,以及可空的高光标记(用于强调封印标中、清图奖励这类值得高亮的结果)。**显示名等玩家可见文案是数据面字段:文案值登记在数据表行,代码按来源类别与效果身份读表拼行,不在代码里写死文案字串**(2026-11-06 用户裁——文案归属数据表承载;承载表与字段形态归表结构设计段定,设计闭合后由实装批落表)。奖励直伤行的数值字段沿用 `effectiveness` 键名、值为整数点数——键名与量纲是数据导出与分析工具的兼容契约,改动须连动分析工具面。没生效也要留痕:奖励未生效行如实记录四类合法例外(reason 键封闭:full_layers/full_hp/no_enemy_alive/hero_down),呈现面按 reason 归因(聚合计数呈现已随明细带退役)。**日志落盘零文案:text 与 display_name 不落盘**,玩家可见文案仅呈现面消费。
|
||||
每行还携带公共字段:来源类别、来源格、轮次、显示名、数值,以及可空的高光标记(用于强调封印标中、清图奖励这类值得高亮的结果)。**显示名等玩家可见文案是数据面字段:数据表行只登记文案 key,文案值登记在 strings.csv(data/l10n/),代码按 key 从翻译文件取文案拼行,不在代码里写死文案字串**(2026-11-09 用户裁——文案值归 strings.csv 承载;承载细则与字段形态 = `design/engineering/code-conventions.md` §2.5,实装批落表)。奖励直伤行的数值字段沿用 `effectiveness` 键名、值为整数点数——键名与量纲是数据导出与分析工具的兼容契约,改动须连动分析工具面。没生效也要留痕:奖励未生效行如实记录四类合法例外(reason 键封闭:full_layers/full_hp/no_enemy_alive/hero_down),呈现面按 reason 归因(聚合计数呈现已随明细带退役)。**日志落盘零文案:text 与 display_key 不落盘**,玩家可见文案仅呈现面消费。
|
||||
|
||||
任何一行找不到来源即断言失败——宁可返回错误,也不让"合并到看不出来源"的呈现混过数据层。但有些行天然没有棋盘来源,断言为此留了两层豁免,豁免集合是封闭清单,改动同样走本文修订。
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# 敌人系统
|
||||
|
||||
> 一句话:敌人数据、技能池出招、意图呈现
|
||||
> 状态:已定稿;现行为 v1.9
|
||||
> 状态:已定稿;现行为 v2.0
|
||||
|
||||
## 设计目的
|
||||
|
||||
@@ -97,7 +97,7 @@
|
||||
| 字段 | 适用类型 | 说明 |
|
||||
|---|---|---|
|
||||
| skill_id | 全部 | 主键,池条目引用键 |
|
||||
| display_name | 全部 | 玩家可见名(明细行与动画共用) |
|
||||
| display_key | 全部 | 玩家可见名的文案 key(明细行与动画共用),文案值住 strings.csv(code-conventions §2.5) |
|
||||
| type | 全部 | 封闭枚举 {普通攻击, 伤害, 增益, 妨害}(现行事实源=敌人系统.md 词汇表/增益状态.md;多段命中经用户拍板退役不入枚举);新类型走本文修订 |
|
||||
| damage_mult | 仅伤害 | 伤害倍率;域 [1.1, 16] provisional。普通攻击恒 1、不可配 |
|
||||
| rider_mult | 仅伤害、可省 | **必中附加分量**:域 (0, 1],缺省无字段 = 无附加;分量值 = max(伤害下限, floor(攻击基线 × rider_mult))——随施放者攻击基线缩放,后置加法、必中全额、不进乘区、不出暴击(后置加法同族);价位锚 0.75 = AC 折扣档最轻档"不掉档的稳定伤害" |
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# 设置与本地化
|
||||
|
||||
> 一句话:设置项与多语言
|
||||
> 状态:范围草案·最小设置面已兑现;现行为 v1.2
|
||||
> 状态:范围草案·最小设置面已兑现;现行为 v1.3
|
||||
|
||||
## 设计目的
|
||||
|
||||
@@ -20,7 +20,7 @@
|
||||
| 设置项清单与语义 | 收拢全游戏的可调选项;目前能确证的输入见核心规则一节,全集待设计 |
|
||||
| 减动效开关 | 可访问性基线已承诺的选项:开启后动画有时长减半或直达终态的通路 |
|
||||
| 音量控制入口 | 音量在设置里调(接口位,白话:给对方预留的接入位置;生效侧归音频系统) |
|
||||
| 多语言生产流程 | 全部玩家可见文案的翻译生产与语言切换——教学引导已在"不负责"表登记归本文 |
|
||||
| 多语言生产流程 | 全部玩家可见文案的翻译生产与语言切换——教学引导已在"不负责"表登记归本文;文案承载细则(key 单点、strings.csv 承载)已闭合,归 `design/engineering/code-conventions.md` §2.5 |
|
||||
| 调试面板退役后的常规设置 | 切片调试面板 TunePanel 正式版退役,其常规设置部分归本文(见核心规则) |
|
||||
|
||||
不负责:
|
||||
@@ -119,6 +119,6 @@ MVP 不要求本系统的闭环:[不做清单](../../05-不做清单.md)把设
|
||||
1. 设置项全集:画面、键位、可访问性、语言各类别各收哪些项——目前有来源的只有减动效与音量入口两条。
|
||||
2. 设置持久化(已拍板 2026-09-19):独立存储,不随存档——系统级设置一安装一份;具体文件格式与读写时机随存档序列化对齐(设置域归本系统所有)。
|
||||
3. 语言清单与字体覆盖:做哪些语言,字体对相应字符集的覆盖怎么保证。
|
||||
4. 文案生产流程:文本键(每条文案在工程里的唯一编号,机器据此找到译文)怎么管理、谁负责校对、翻译在流程的哪一步介入。
|
||||
4. 文案生产流程:文本键(每条文案在工程里的唯一编号,机器据此找到译文)的管理规则已闭合——文案 key 单点、文案值住 strings.csv(data/l10n/),细则 = `design/engineering/code-conventions.md` §2.5;尚待设计的是谁负责校对、翻译在流程的哪一步介入。
|
||||
5. 设置界面的入口与形态:从哪里打开、什么时刻可以打开——与 HUD 框架协作定。
|
||||
6. 键位映射表是否转化为改键设置项。
|
||||
@@ -1,7 +1,7 @@
|
||||
# 秘宝
|
||||
|
||||
> 一句话:营地装配、整局冒险生效的角色机能件——操作包络加强(视野/行动点/刷新/挖掘距离等),不出角色战斗属性值、不改战斗结算机制(经济与操作参数——视野/距离/行动点/刷新/转存率——属操作包络;分界规则归[核心循环](../../01-核心循环.md)「道具三层职责与分界」节)
|
||||
> 状态:已定稿(现行形态=局外同调件);现行为 v1.4
|
||||
> 状态:已定稿(现行形态=局外同调件);现行为 v1.5
|
||||
> 定位与形态:见下节
|
||||
> 术语:本文件的项目术语(同调位/RAP/GP/真视/危险格/整图等)定义见[术语表](../../术语表.md)
|
||||
|
||||
@@ -225,7 +225,7 @@
|
||||
|
||||
结构冻结(非调参项,改动走本文修订流程):真视窄域护栏、零信息目标不消耗、边缘窗口照常受理、使用零行动点成本、同调位装配与充能每冒险重置、用后不可逆、零随机。
|
||||
|
||||
效果声明形态(在役沿用):被动件的效果行为=**订阅行**——行内声明**订阅哪个事件(on)/ 什么条件(when)/ 什么效果(do)**,由效果引擎统一解释执行;主动件按效果类型通用分发(受理闸=使用事件订阅);常时参数面件(阔视野带/储备罐/远程镐/信标网络/刷新练习/刷新执照六件)effect_kinds 挂参数 kind、由注入面按装配集分发读取;试炼镐=自动兑付(ap_charge_safe 满 charge_n 直接 grant_ap)。事件/效果类型/条件事实/算子四词表封闭(效果引擎单一事实源);卡面效果摘要=行 `desc` 字段直读(文案表值化)。现行目录 14 件的效果行已落地登记。
|
||||
效果声明形态(在役沿用):被动件的效果行为=**订阅行**——行内声明**订阅哪个事件(on)/ 什么条件(when)/ 什么效果(do)**,由效果引擎统一解释执行;主动件按效果类型通用分发(受理闸=使用事件订阅);常时参数面件(阔视野带/储备罐/远程镐/信标网络/刷新练习/刷新执照六件)effect_kinds 挂参数 kind、由注入面按装配集分发读取;试炼镐=自动兑付(ap_charge_safe 满 charge_n 直接 grant_ap)。事件/效果类型/条件事实/算子四词表封闭(效果引擎单一事实源);卡面效果摘要=行 `desc_key` 经 strings.csv 取文案(code-conventions §2.5)。现行目录 14 件的效果行已落地登记。
|
||||
|
||||
playtest 预警(预注册,归难度曲线与Boss):
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# 锻造工坊
|
||||
|
||||
> 一句话:营地的武器与护甲成长——武器锻造区三条路线、护甲锻造区三条路线各练各的,钥石消费,一次冒险各选一件,满级特效留位本期不做
|
||||
> 状态:**v0.13**——全部数值 provisional,终值归 Alpha 收官 M4 数值批〔未排期〕
|
||||
> 状态:**v0.14**——全部数值 provisional,终值归 Alpha 收官 M4 数值批〔未排期〕
|
||||
## 设计目的
|
||||
|
||||
用户原案(playnote 2026-10-06):把现役"营地花钱买攻击 +1"改造成有等级、有成长、有满级特效的**武器升级路线**;新增长枪(穿刺)与法杖(魔法)实现武器间差异化;护甲同理——初始只有轻甲(升级只提 AC),最高等级后解锁重甲/魔法护甲,基础 AC 各异、各带满级特效。
|
||||
@@ -126,7 +126,7 @@
|
||||
- **奇物属性件**:分层并存,互不侵入。武器/护甲锻造动的是**账号层基础值**(营地永久强化,冒险开始时经参数面传入);奇物属性件动的是**单次冒险加算区**(关间不清零、冒险结束清零)。本设计不扩奇物"生命/AC/攻击"三轴封闭分类、不动渠道开关表、不往局内池加任何东西。入战 AC 的三层语义清晰可加:甲型基础 AC + 营地甲路线等级加值 + 局内加算区累加。
|
||||
- **克制矩阵(2a 裁:伪裁点消解)**:**伤害结算只有一套,类型不是待仲裁的槽位**。每份伤害单据自带攻击类型栏——主角基础攻击单据取当前武器的攻击类型,棋盘格面直伤件(穿刺弹 / 魔法矢)取奖励表自身的类型——各自按**同一张 3×3 克制矩阵**取克制修正。因此"叠加 / 替代 / 互斥"三分法不成立:两根参数之间无冲突可裁,也不需要任何共存规则。二者的真实差异只在**单据形态与生命周期**(主角基础攻击走掷点折扣 + 暴击;棋盘克制直伤走必中全额不掷点;且前者 = 账号层永久、后者 = 局内一次性)——那是两条不同的伤害来源,不是两种类型语义。矩阵九格满格结构冻结(2b 随 3a 自动消解:魔法护甲 = 现役 ward,不存在第四甲型)。
|
||||
- **工作间两区定名 + 路线行名(8a 裁)**:锻造工坊工作间内先立两个分区,各装三条锻造路线(路线行名统一为"件名 + 锻造")——①**武器锻造区**:长剑锻造 / 长枪锻造 / 法杖锻造;②**护甲锻造区**:轻甲锻造 / 重甲锻造 / 魔法护甲锻造。两区并列、机制层面零顺序门槛(A③ 裁),区内路线各自独立升级。
|
||||
- **局内不存在武器/护甲的提升(8a 裁连带核结)**:用户指出"局内没有可以提升武器的地方"——**属实**。查实:局内商店货架的三行(现名"攻击祝福 / 生命祝福 / 护甲祝福"),**正是奇物「属性值提升」三轴(攻击 / 生命上限 / AC)的货架前台标签**——`shop.tres` pool_shelf 六行用种类字段指向冒险表的奇物种类词表(其中凭证行为显式豁免种、不入该词表,六行中五行命中),`display_name` 只是这层的前台名;买到的东西进**冒险加算区**、冒险结束清零。所以它们是**奇物属性件**,既不是武器也不是护甲,局内不改变任何锻造等级。命名上的隐患确凿:行名里的"锻"字与营地锻造同字,是误读的直接来源。**命名(2026-10-12 用户裁)**:三行按「属性 + 后缀」改名,后缀取 **祝福** ⇒ **攻击祝福 / 生命祝福 / 护甲祝福**(D&D 参照调研:Blessing 为"神赐恩惠"义;用户同时裁定——参考书目里出现过「祝福」一词不构成禁用)。**改名后这三条在语感上彻底脱离"锻造"一词,与营地工作间不再有字面关联**,而结构关系不变(仍是奇物「属性值提升」三轴,机制分类名不动,只改玩家向显示名)。改名已执行完毕(shop.tres 六行锻升→祝福;reward.tres / status_effects.tres 护甲强化→盾牌加护)。
|
||||
- **局内不存在武器/护甲的提升(8a 裁连带核结)**:用户指出"局内没有可以提升武器的地方"——**属实**。查实:局内商店货架的三行(现名"攻击祝福 / 生命祝福 / 护甲祝福"),**正是奇物「属性值提升」三轴(攻击 / 生命上限 / AC)的货架前台标签**——`shop.tres` pool_shelf 六行用种类字段指向冒险表的奇物种类词表(其中凭证行为显式豁免种、不入该词表,六行中五行命中),`display_key` 只是这层的前台名索引(文案值住 strings.csv,code-conventions §2.5);买到的东西进**冒险加算区**、冒险结束清零。所以它们是**奇物属性件**,既不是武器也不是护甲,局内不改变任何锻造等级。命名上的隐患确凿:行名里的"锻"字与营地锻造同字,是误读的直接来源。**命名(2026-10-12 用户裁)**:三行按「属性 + 后缀」改名,后缀取 **祝福** ⇒ **攻击祝福 / 生命祝福 / 护甲祝福**(D&D 参照调研:Blessing 为"神赐恩惠"义;用户同时裁定——参考书目里出现过「祝福」一词不构成禁用)。**改名后这三条在语感上彻底脱离"锻造"一词,与营地工作间不再有字面关联**,而结构关系不变(仍是奇物「属性值提升」三轴,机制分类名不动,只改玩家向显示名)。改名已执行完毕(shop.tres 六行锻升→祝福;reward.tres / status_effects.tres 护甲强化→盾牌加护)。
|
||||
- **专长联动**:现役专长均为跨攻击类型通用件(不按 attack_type 分系——既无 normal 条件件、也无 pierce/magic 条件件,`feats.tres` 29 行实证),武器类型差异只经克制矩阵的 matchup 行体现;「选某类型激活某系专长」在本项目专长体系下不成立。现有死条件 `magic_vs_magic`(魔法打"魔法甲"——现行甲域无此型,永不可触发 = 废卡):**复活作废**——所属件魔网织者在素材库表二退役名单,该行已随专长退役消解,本系统零触碰。「魔法打魔法护甲」的克制语义由矩阵九格承载(magic vs ward = −1),新专长框架如需同类件 = 彼批的新卡设计题。
|
||||
- **天赋树**:同钥石经济;注入面分层叠加且**所有权切分**(2026-10-11 裁)——树脊柱只持生命/命中淬炼(树零攻防来源),攻/AC 唯一入口=本系统路线加值(只按当前选中武器/甲生效)。
|
||||
- **冒险前资源配比预设批(挂起冻结中)**:本设计不预设该批的重启口径、不占用其任何冻结裁决、不改其冻结文本。该批重启时须显式核对两处交汇面:①预算包络是否把武器类型计入克制注;②容量柜台与锻造工坊工作间(同在营地)的资源竞争关系。
|
||||
|
||||
+8
-1
@@ -1,7 +1,7 @@
|
||||
# 术语表
|
||||
|
||||
> 全库专用术语的唯一对照表(2026-10-11 用户令建立)。规矩:新术语先登记本表、再在文档使用;退役词见文末对照表,文档正文一律使用现行词。文档中遇到看不懂的词,查本表。用词纪律(禁用词、替换值、豁免范围)见「用语规范」节。
|
||||
> 状态:**现行 v1.29**——2026-10-11 建立;历次升版明细见 git 提交史。
|
||||
> 状态:**现行 v1.30**——2026-10-11 建立;历次升版明细见 git 提交史。
|
||||
|
||||
## 格与棋盘
|
||||
|
||||
@@ -122,6 +122,13 @@
|
||||
| 逐需求点验收清单 | 需求卡片验证闸的必备清单:每个需求点列明测什么(具体断言或行为)/怎么测(测试落点与注入方式)/谁验(自动闸或用户目检);查不出验收条目的需求点=卡片不成立(规矩见 req-card 技能,测试落码写法见 [code-conventions](../engineering/code-conventions.md) §3.5) |
|
||||
| 测试方式两分法 | 能力验证与体验验证分开走(2026-10-11 用户定):能力验证=通过调试接口直接修改游戏数据(改钥石/槽位/解锁状态等,不走正常资源积累流程);体验验证=用户目检完整流程,登记体验验证清单观测项 |
|
||||
|
||||
## 文案承载(2026-11-09 用户裁立)
|
||||
|
||||
| 术语 | 定义 |
|
||||
|---|---|
|
||||
| 文案 key | 玩家可见文案的唯一索引键(点分命名如 `clear_reward.title`):数据表行与代码只持 key,文案值住 strings.csv(data/l10n/,key 列+`zh_CN` 列),取文案走承载细则的单点接口;硬纪律原文 = [code-conventions](../engineering/code-conventions.md) §2.5 |
|
||||
| strings.csv | 文案值的唯一承载文件(data/l10n/strings.csv):第一列文案 key、第二列中文文案,Alpha 单中文列;加语言=加列,多语言生产仍归[设置与本地化](systems/表现与支撑/设置与本地化.md)后置排期 |
|
||||
|
||||
## 用语规范(2026-10-15 用户令立)
|
||||
|
||||
词面纪律的登记处。通用禁用词与选词以**简明技术中文(STC)词表**为权威:外部同名词表,约 170 条,配检查脚本。
|
||||
|
||||
@@ -87,10 +87,9 @@
|
||||
|
||||
#### 结算明细文案入表(2026-11-07 登记,来源=批次移交)
|
||||
|
||||
**实况**:结算期文字列表退役批(迭代 56 已落地,git 提交 d234a547)落地后,剩余玩家可见文案(清图奖励/Boss 解锁技名等 toast 与明细行显示名)的承载面换代——文案从代码字面量迁数据表,与 [战斗结算](design/gdd/systems/战斗循环/战斗结算.md) v2.0 :87「显示名等玩家可见文案是数据面字段」对齐。
|
||||
**缺口**:还差一次文档设计讨论——入哪张表、哪些文案入表、日志零文案后 toast 文案的承载形态。
|
||||
**实况**:玩家可见文案承载换代设计闭合——承载规则=code-conventions.md §2.5(文案 key 单点、文案值住 data/l10n/strings.csv);同步修订 design/gdd/systems/表现与支撑/设置与本地化.md v1.3、战斗循环/战斗结算.md v2.1(:87 条款)、战斗循环/增益状态.md v1.8、战斗循环/敌人系统.md v2.0、跨局循环/锻造工坊.md v0.14、跨局循环/秘宝.md v1.5、术语表.md v1.30(文案 key 词条);字段更名 display_key/desc_key。
|
||||
**改动面**:文档+游戏代码
|
||||
**状态**:待文档设计
|
||||
**状态**:文档设计已闭合+待写卡
|
||||
|
||||
#### UI 贴图重构批——元进度件仍是程序化占位(2026-10-13 登记,来源=审计发现)
|
||||
|
||||
|
||||
Reference in new issue
Block a user