Planner_Tools/配置表联动查看器

配置表联动查看器

一个用于 Unity 项目的配置表联动关系可视化工具，支持跨项目复用。

功能特性

• ✅ 支持 76+ 配置表的联动关系查看
• ✅ 自动检测项目中实际存在的配置表
• ✅ 智能搜索功能
• ✅ 快速跳转到关联表
• ✅ 显示数据格式说明
• ✅ 跨项目自动适配

安装指南

方法一：复制文件

1. 找到本项目中的 ConfigLinkViewer 文件夹：

   Assets/Scripts/mgame/tools/ConfigLinkViewer/
   

2. 复制整个文件夹到目标项目的任意位置（建议保持相同路径）：

   目标项目/Assets/Scripts/mgame/tools/ConfigLinkViewer/
   

3. 打开 Unity，等待脚本编译完成。

方法二：Git 子模块（推荐）

cd 你的项目目录
git submodule add <本工具仓库地址> Assets/Scripts/mgame/tools/ConfigLinkViewer

使用说明

打开工具

在 Unity 编辑器菜单中点击：

Tools → 配置表联动查看器

界面说明

区域	说明
搜索框	按表名、显示名、描述搜索配置表
过滤选项	可选择只显示当前项目存在的表
左侧列表	配置表列表，显示状态标记
右侧详情	显示选中表的联动关系

操作指南

1. 选择配置表：从左侧列表点击任意配置表
2. 查看联动关系：右侧显示该表的所有字段关联
3. 展开详情：点击折叠箭头查看详细信息
4. 跳转到关联表：点击"查看 xxx 表"按钮跳转
5. 搜索过滤：在搜索框输入关键词快速定位

状态标识说明

标记	含义
[存在]	该表存在于当前项目
[缺失]	该表不存在于当前项目
[目标表缺失]	联动目标表不存在于当前项目

跨项目适配

工具会自动检测目标项目中的配置表：

1. 扫描路径：Resources/Resources_moved/config/*.json
2. 自动标记哪些表存在/缺失
3. 缺失的表不会影响工具正常运行
4. 联动到缺失表的跳转按钮会自动禁用

配置表联动关系示例

敌人表 (enemy)

• reward_id → checkpointreward.id - 掉落奖励
• skills → skill.id - 技能列表

商店表 (mall)

• productId → prop.id - 商品道具ID
• consumes → prop.id (格式: item_id_num) - 购买消耗
• rewards → prop.id (格式: item_id_num) - 购买获得奖励

英雄表 (hero)

• skills → skill.id - 技能列表
• equips → equip.id - 装备列表
• buffs → buff.id - 升阶解锁buff

数据格式说明

格式	示例	说明
item_id_num	1001_5	道具ID_数量
type_id_num	item_1001_5	类型_道具ID_数量
id_pos_lv	101_2_5	ID_位置_等级
id_lv_num	101_5_3	ID_等级_数量
id_lv_num_time	101_5_3_30	ID_等级_数量_时间

维护指南

添加新表联动关系

编辑 ConfigLinkDatabase.cs，在 GetAllTableInfo() 方法中添加：

new ConfigTableInfo {
    tableName = "新表名",
    displayName = "显示名称",
    description = "表描述",
    relations = new List<FieldRelation> {
        new FieldRelation {
            fieldName = "字段名",
            targetTable = "目标表名",
            targetField = "目标字段",
            relationFormat = "数据格式（可选）",
            description = "说明文字"
        }
    }
}

清理缓存

如果配置表有变动，可以调用：

ConfigLinkDatabase.ClearCache();

技术支持

如有问题或建议，请联系开发者。

---

版本: 1.0 最后更新: 2026年5月