跳到主要内容
版本:5.x

Luban.Agent CLI

Luban.Agent 是面向 Agent / 脚本的独立 CLI,与主生成器 Luban.dll 分离。

  • 主 Luban:生成代码/数据;可用 --errorFormat json 得到机器可读报错。
  • Luban.Agentvalidate / schema / list-tables / describe / capabilitiesstdout 始终输出一份 AgentResult JSON

构建

推荐与主工具一起构建(lubanluban_examples 仓库并列时):

# Windows
luban_examples/Tools/build-luban.bat

# macOS / Linux
luban_examples/Tools/build-luban.sh

产物在 luban_examples/Tools/Luban.Agent/(同脚本还会生成 Tools/LubanTools/Luban.Mcp)。

也可单独编译源码:

dotnet build src/Luban.Agent/Luban.Agent.csproj -c Release -o <out_dir>

用法

dotnet Tools/Luban.Agent/Luban.Agent.dll capabilities

dotnet Tools/Luban.Agent/Luban.Agent.dll list-tables --conf luban.conf -t all
dotnet Tools/Luban.Agent/Luban.Agent.dll describe --conf luban.conf -t all --name TbItem
dotnet Tools/Luban.Agent/Luban.Agent.dll schema --conf luban.conf -t all
dotnet Tools/Luban.Agent/Luban.Agent.dll schema --conf luban.conf -t all --name item

dotnet Tools/Luban.Agent/Luban.Agent.dll validate --conf luban.conf -t all
# 可加 -x pathValidator.rootDir=... 等

也支持 --mode list-tables 写法。

退出码

Code含义
0成功
1数据 / 校验
2Schema / 配置
3用法错误
4内部错误

与 MCP

Luban.Mcp 通过环境变量 LUBAN_AGENT_DLL 调用本工具;生成仍走主 Luban.dllLUBAN_DLL)。