配置表通用规则
配置表通用规则 本文件是 config agent 和 config skill agent 共同引用的基础知识。 1. 如何解读 .txt 配置表 配置表 文件有固定的 6 行表头结构： | 行号 | 内容 | 说明 | | | | | | 第 1 行 | Sheet 名 | 如 | | 第 2 行 | 中文列名 | 人类可读名称，如「BUFFID」「持续回合」 | | 第 3 行 | 英文字段…
·
3 min read
·
965 字
配置表通用规则
本文件是 config-agent 和 config-skill-agent 共同引用的基础知识。
1. 如何解读 .txt 配置表
配置表 .txt 文件有固定的 6 行表头结构：
| 行号 |
内容 |
说明 |
| 第 1 行 |
Sheet 名 |
如 **********Sheet:buff_1 |
| 第 2 行 |
中文列名 |
人类可读名称，如「BUFFID」「持续回合」 |
| 第 3 行 |
英文字段名 |
程序用字段名，如 ID、type、trigger_events |
| 第 4 行 |
字段数据类型 |
如 数字(空转0)、文字、多语言文字、布尔(空转nil) |
| 第 5 行 |
详细描述 |
枚举值定义、使用规则、填写约束 |
| 第 6 行 |
端标记 |
c = 仅客户端, s = 仅服务器, cs = 双端 |
审查关键规则：
- 审查任何配置表时，必须先读取前 6 行理解列布局、数据类型和字段语义，然后再分析数据行
- 第 5 行包含枚举值定义和使用约束，是验证数据正确性的关键依据
- 需要理解引用表时，用 Bash 工具获取其表头：
svn cat -r {revision} {svn_url}/Design/config/<table>.txt 2>&1 | head -6
2. 数据类型系统
2.1 基础类型
| 类型 |
规则 |
空值导出 |
| 文字 |
字符串 |
— |
| 文字(空转0) |
字符串，不填导出 "0" |
"0" |
| 多语言文字 |
字符串，会导出到翻译需求 |
— |
| 数字(空转0) |
填数字，不填导出 0 |
0 |
| 数字(空转1) |
填数字，不填导出 1 |
1 |
| 数字(空转-1) |
填数字，不填导出 -1 |
-1 |
| 数字(空转nil) |
填数字，不填导出 nil |
nil |
| 布尔 |
填 "true" 为 true，不填或填其他为 false |
false |
| 布尔(空转nil) |
填 "true" 为真，填其他为假，不填为 nil |
nil |
| 去除首尾空格 |
文字类型，导出时删掉首尾空格 |
— |
2.2 列表 / 数组类型
| 类型 |
分隔符 |
配置样例 |
导出结果 |
| 文字数组 |
; |
adb;efg |
{"adb", "efg"} |
| 多语言文字数组 |
; |
adb;efg |
{"adb", "efg"} |
| 文字逗号数组 |
, |
adb,efg |
{"adb", "efg"} |
| 数字全数组 |
;（空缺元素占位） |
1;2;;4;5 |
{[1]=1, [2]=2, [4]=4, [5]=5} |
| 数字全数组(整数小数) |
; |
1;2.5;;4;5 |
{[1]=1, [2]=2.5, [4]=4, [5]=5} |
| 混合数组 |
, |
1,adb,3,efg |
{1,"adb",3,"efg"} |
| 分号型混合数组 |
; |
1;adb;3;efg |
{1,"adb",3,"efg"} |
| 竖线型混合数组 |
| |
1|adb|3|efg |
{1,"adb",3,"efg"} |
| 文字分号数组 |
; |
1;2;3;4;5 |
{1,2,3,4,5} |
2.3 嵌套数组类型
| 类型 |
层级分隔符 |
配置样例 |
导出结果 |
| 竖线正斜杠分号数组简化 |
| → ; → / |
11/22;33/44|55/66;77 |
{{{11,22},{33,44}},{{55,66},77}} |
| 混合数组2 |
; → , |
1,adb,3;4,5,abc |
{{1,"adb",3},{4,5,"abc"}} |
| 逗号竖线数组 |
| → , |
1,adb|3,efg|4,abc |
{{1,"adb"},{3,"efg"},{4,"abc"}} |
| 分号竖线数组 |
| → ; |
1;adb|3;efg|4;abc |
{{1,"adb"},{3,"efg"},{4,"abc"}} |
| 等号竖线数组 |
| → = |
1=adb|3=efg|4=abc |
{{1,"adb"},{3,"efg"},{4,"abc"}} |
2.4 KV / 字典 / 集合类型
| 类型 |
分隔符 |
配置样例 |
导出结果 |
| 竖线型KV数组 |
| 挨个 K|V |
1|adb|3|efg |
{[1]="adb",[3]="efg"} |
| 分号型混合字典 |
; |
1;adb;3;efg |
{[1]=true,["adb"]=true,[3]=true,["efg"]=true} |
| 混合集合 |
, |
1,adb,3,efg |
{[1]=true,["adb"]=true,[3]=true,["efg"]=true} |
| 混合KV |
; → , K,V |
3,1;4,a;a,2;b,a |
{[3]=1,[4]='a',['a']=2,['b']='a'} |
2.5 特殊类型
| 类型 |
说明 |
配置样例 |
导出结果 |
| 数字区间 |
- 分隔最小最大值 |
1-6 |
{1,6} |
| 剧本覆盖 |
| 分隔剧本序号，支持范围 |
2-4|6|8 |
{[2]=true,[3]=true,[4]=true,[6]=true,[8]=true} |
| 枚举 |
填本表某页签的 id |
WelfareType.Shop |
welfare_WelfareType.Shop.content |
3. 类型验证检查规则
审查配置表时，对照第 4 行的类型声明验证数据行：
| Check |
Severity |
Max Confidence |
字段类型声明为 数字(空转X) 但数据行填了非数字内容 |
P1 |
85 |
数组类型使用了错误的分隔符（如 ; 分隔型用了 ,） |
P1 |
80 |
布尔类型填了 1/0 而非 true/false |
P2 |
70 |
| 嵌套数组层级分隔符顺序错误 |
P1 |
80 |
| 数字类型字段填了带字母的内容（排除表达式字段） |
P1 |
85 |