luban_skill

帮助 AI 高效操作 Luban 游戏配置表，支持枚举、Bean、数据表的增删改查。

前置条件

1. 确保 Python 3.8+ 已安装
2. 安装依赖：pip install openpyxl

使用方式

python scripts/luban_helper.py <command> --data-dir <项目的Datas目录>

注意：PowerShell 中使用分号 ; 作为命令分隔符，不要使用 &&。

PowerShell JSON 参数问题

PowerShell 处理 JSON 字符串参数会有转义问题。推荐使用 --file 参数从文件读取：

# 方法1：从JSON文件读取（推荐）
python scripts/luban_helper.py row add TbItem --file item.json --data-dir ...

# 方法2：使用Python脚本调用
python -c "import json; ..."

AI 操作工作流

⚠️ 操作前确认机制（强制）

所有写入/修改/删除操作在执行前，必须明确询问用户确认。

确认信息必须包含：

1. 目标文件：完整的 Excel 文件路径
2. 操作类型：添加/修改/删除 字段/数据行/枚举/Bean 等
3. 具体内容：详细的操作参数

各类操作确认模板

添加字段时：

我将执行以下操作：
- 目标文件：tables/datas/#Item-道具表.xlsx
- 操作：添加新字段
- 字段名：soul
- 字段类型：string
- 字段注释：灵魂
- 分组：c (客户端)

确认执行吗？(是/否)

添加数据行时：

我将执行以下操作：
- 目标文件：tables/datas/#Item-道具表.xlsx
- 操作：新增数据行
- 数据内容：
  - id: 3007
  - name: 魔丸
  - type: Consumable
  - quality: 5
  - ...

确认执行吗？(是/否)

删除字段/数据时：

⚠️ 警告：此操作不可逆！
- 目标文件：tables/datas/#Item-道具表.xlsx
- 操作：删除字段 "price"
- 影响：该字段的所有数据将被永久删除

确认执行吗？(是/否)

模糊指令时的确认：

多文件选择：

找到多个可能的目标表：
1. TbItem (道具表) - #Item-道具表.xlsx
2. TbSkill (技能表) - #Skill-技能表.xlsx

请选择要操作的表？

首次操作项目时

1. 执行 table list 了解项目有哪些表
2. 执行 enum list 和 bean list 了解类型系统
3. 根据用户需求定位具体表

修改数据前

1. 先用 table get 或 field list 确认表结构
2. 用 row get 查询现有数据，避免主键冲突
3. 执行写入/修改/删除前，明确询问用户确认（目标文件 + 操作内容）
4. 执行修改后用 validate 验证

删除操作前

1. 用 ref 检查引用关系
2. 提醒用户确认风险
3. 危险操作需要二次确认

智能推断指南

重要原则：

• 只读操作（list/get/query/search）：无需确认，直接执行
• 写入操作（add/update/delete）：必须明确询问用户确认，包括目标文件和具体操作内容

常见错误速查

常见场景速查