简化数据分册结构并避免配置与文案重复列值

合并数据模板的字段说明与完整内容章节，简单配置和文案集中维护。同步写作规则与星露谷样例，保留多记录字段定义及完整配置、文案和验算要求。更新策划技术方案与共享决策记录。
2026-09-28 03:58:46 +00:00
parent 9d792abad0
commit c95ed2b519
5 changed files with 22 additions and 18 deletions
@@ -19,16 +19,15 @@

 ## 已知字段契约与示例配置

-下表只覆盖已出现的字段。ID 是不随显示名称变化的字符串；引用不存在时不能把动作算作成功。数值单位写在字段定义中，不能把游戏日、体力、金钱和经验混用。无默认值的字段必须显式给值；本例没有授权用 `0`、空值或估值替代缺失配置。
+本例涉及物品、作物等记录，因此将共用字段定义与具体记录分列；具体取值只在记录中定义，验算场景输入放在验算段落。少量配置可合写字段含义与当前值，无需照搬两张表。下表只覆盖已出现的字段。ID 是不随显示名称变化的字符串；引用不存在时不能把动作算作成功。数值单位写在字段定义中，不能把游戏日、体力、金钱和经验混用。无默认值的字段必须显式给值；本例没有授权用 `0`、空值或估值替代缺失配置。

 | 字段及维护者 | 类型与单位 | 本例约束/默认值 | 消费方式 |
 |---|---|---|---|
 | S07 `item_id` | 非空字符串 | 必填、唯一；无默认值 | S03、S05、S09 以 ID 引用物品 |
 | S03 `crop_id`、`seed_item_id`、`harvest_item_id` | 非空字符串 | 必填、唯一作物 ID；两个物品引用无默认值 | 播种消费种子；收获请求产出物品入账 |
-| S03 `growth_days` | 非负整数，游戏日 | 必填；本例 4；无默认值 | 每次满足成长条件的跨日推进一次 |
+| S03 `growth_days` | 非负整数，游戏日 | 必填；无默认值 | 每次满足成长条件的跨日推进一次 |
 | S09 `buy_price`、`sell_price`、`starting_currency` | 非负整数，金 | 必填；无默认值 | 买入扣款、出售入账、开局钱包 |
 | S08 `farming_xp_per_harvest`、`farming_level_1_xp` | 非负整数，经验 | 必填；无默认值 | 成功收获入账并比较等级阈值 |
-| 验算 `seed_count` | 非负整数，包 | 仅场景输入，本例 15；不是商店库存默认值 | 验算一次购买和播种的总量 |

 | 维护系统 | 示例记录或参数 | 已知值与引用 | 仍缺的当前范围配置 |
 |---|---|---|---|
@@ -12,6 +12,8 @@

 ## 写出可直接消费的配置

+按数据形态选择组织方式：少量配置把名称、当前值、单位或含义及必要约束合写，不再重复列配置清单；同结构多条记录可分为共用字段定义和完整记录。玩家可见文案集中列一次，注明使用位置；其他章节引用已有定义，不重复抄录。共用消费方式集中说明，特殊用法就近注明，不为每个简单常量另建消费映射表；派生值说明计算关系，不作为另一份配置登记。
+
 对当前范围每个数据集，写明维护系统、记录身份、字段类型、单位、允许值、默认值或必填要求、引用目标和消费方。默认值只给确实允许省略的字段；未确定的关键值列入待解决问题，不能把“待定”当成运行值。多值采用能明确表达数量和顺序的结构，按实际消费需要选择数组、对象或独立表。

 把当前范围所需的**全部**记录和玩家可见文案放入本套 TDD，或明确指向本套 TDD 内唯一的权威定义。示例行不能代替完整配表；不能用“照此补齐”掩盖作物、商品、资源点或提示文案的缺口。对每条跨系统引用，说明来源、目标以及使用方如何处理缺失、不可用或入账失败。改变数据时同步更新受影响的规则、配置和验算。
@@ -10,27 +10,23 @@

 只列本期实际使用的内容。每项事实只在一个位置定义；其他系统引用其 ID 或读取其结果。复杂项目可按需要拆为多张表、JSON 或工作簿，简单项目可在本册直接列清。

-## 字段与消费契约
+## 数据定义与完整内容

-对每个实际数据集列出记录身份、全部字段、类型、单位、允许值、默认值或必填要求、引用目标。下表按需复制；不要求所有数据集拥有相同字段。
+根据实际数据形态组织，字段说明与具体取值可以合并。少量配置可直接使用下表，不另设重复的配置清单；同结构多条记录可分别给出共用字段定义和完整记录，不要求两种形式都使用。

-### __（维护系统：__）
+| 参数或适用对象 | 当前值 | 单位、含义与必要约束 |
+|---|---|---|
+| __ | __ | __ |

-| 字段 | 类型及单位 | 必填或默认值 | 允许值/约束 | 引用目标与消费方式 |
-|---|---|---|---|---|
-| __ | __ | __ | __ | __ |
+写清实际需要的记录身份、字段类型、单位、允许值、默认值或必填要求、归属及引用。共用消费方式集中说明，特殊用法就近注明，不为每个简单常量另建消费映射表。派生值写明计算关系，不作为另一份配置重复登记。实例状态与静态配置、读取时机、缺失或失败处理在影响实现时说明；一对多内容采用能明确表达数量和顺序的结构，条件、随机或迁移数据只在实际需要时定义。

-说明：__（如实例状态与静态配置的区别、数据何时读取、缺失或失败如何处理）。若存在一对多内容，选用能清楚表示数量与顺序的结构；条件、随机或迁移数据只在实际需要时定义。
+玩家可见文案集中列一次，注明使用位置：

-## 当前范围完整配置与文案
+| 文案标识 | 完整文本 | 使用位置及必要说明 |
+|---|---|---|
+| __ | __ | __ |

-在此列出当前实现范围**每一条**实际记录和值，包括所需的系统参数、配置和玩家可见文案；也可明确指向本套 TDD 中唯一的权威定义。下面的单行仅示范格式，不表示填充完成。
-
-| 数据集 | ID 或适用对象 | 字段和值（含单位） | 来源/引用 |
-|---|---|---|---|
-| __ | __ | __ | __ |
-
-内容数量由已定范围决定。允许明确当前采用的初值并在原型中调优；未定关键值进入“待解决问题”，不可用空白、未经说明的估值或几行示例冒充完整配置。
+当前范围所需的**全部**实际记录、参数值和文案必须在本套 TDD 中完整给出。已在本套 TDD 其他位置定义的内容，明确引用其唯一权威位置，不重复抄录；上面的占位行不代表填充完成。内容数量由已定范围决定，允许明确当前采用的初值并在原型中调优；未定关键值进入“待解决问题”，不可用空白、未经说明的估值或几行示例冒充完整配置。

 ## 关键循环验算