Defold 编辑器扩展与工具链开发

值得做成扩展：
- 新增敌人：自动创建 go 文件、脚本、图集条目、加入工厂原型
- 批量重命名：assets/enemy_*.png 按规则改成 en_<type>_<idx>.png
- 图集重建：扫描目录下所有 png，按命名规则重建 images 与 animations
- 资源校验：检查每个 .go 是否挂脚本、每个 script 是否有 init
- 导表：csv 转成 lua 常量表并写回项目

不值得：一次性迁移脚本、需要人眼确认的编辑、依赖运行时状态的调试

project/
  game.project
  hooks.editor_script          ← 唯一接收生命周期钩子的文件
  editor/
    rename_tools.editor_script
    lib/naming.lua             ← 纯 Lua 工具模块，可被 require

locations 取值：
菜单栏：Edit / View / Project / Debug / Help
子菜单：Bundle（Project ▸ Bundle 下）
右键菜单：Assets / Outline / Scene / Code

function M.get_commands()
    return {
        {
            label = "统计选中脚本行数",
            locations = {"Assets"},
            query = { selection = { type = "resource", cardinality = "many" } },
            active = function(opts)
                -- active 高频调用，必须足够快
                return editor.get(opts.selection[1], "path"):match("%.lua$") ~= nil
            end,
            run = function(opts)
                local text = editor.get(opts.selection[1], "text")
                print("行数 " .. select(2, text:gsub("\n", "")))
            end
        }
    }
end

-- hooks.editor_script
local M = {}

function M.on_build_started(opts)
    -- opts.platform 形如 "x86_64-macos"
    local f = io.open("assets/build_info.json", "w")
    f:write(string.format('{"built_at": "%s"}', os.date()))
    f:close()
end

return M

editor.create_directory()  editor.create_resources()  editor.delete_directory()
editor.save()              editor.execute()           editor.transact()
os.remove()                file:write()

local path = editor.get("/main/game.script", "path")   -- "/main/game.script"
local text = editor.get("/main/game.script", "text")   -- 内存中的内容，含未保存的编辑
local kids = editor.get("/main", "children")           -- 目录的子资源路径列表

editor.transact({
    editor.tx.set(node, "position", {0, 0, 0}),
    editor.tx.set(node, "rotation", {0, 0, 0}),
    editor.tx.set(node, "scale", {1, 1, 1})
})

run = function(opts)
    local text = editor.get(opts.selection, "text")
    local formatted = editor.execute("jq", "-n", "--argjson", "data", text, "$data", {
        reload_resources = false, out = "capture"
    })
    editor.transact({ editor.tx.set(opts.selection, "text", formatted) })
end

local ok = editor.ui.show_dialog(editor.ui.dialog({
    title = "确认重建图集？",
    content = editor.ui.paragraph({ text = "将覆盖 atlas 现有的 images 与 animations 配置。" }),
    buttons = {
        editor.ui.dialog_button({ text = "取消", cancel = true, result = false }),
        editor.ui.dialog_button({ text = "重建", default = true, result = true })
    }
}))
if ok then rebuild_atlas() end

local dialog = editor.ui.component(function(props)
    local name, set_name = editor.ui.use_state("")

    return editor.ui.dialog({
        title = props.title,
        content = editor.ui.vertical({
            children = { editor.ui.string_field({ value = name, on_value_changed = set_name }) }
        }),
        buttons = {
            editor.ui.dialog_button({ text = "取消", cancel = true }),
            editor.ui.dialog_button({ text = "创建", enabled = name ~= "", result = name })
        }
    })
end)

local file_name = editor.ui.show_dialog(dialog({ title = "新建资源" }))

run = function(opts)
    local dir = editor.get(opts.selection, "path")
    local txs = {}
    for _, path in ipairs(editor.get(dir, "children")) do
        local type_, idx = path:match("enemy_(%a+)_(%d+)%.png$")
        if type_ then
            local to = dir .. "/" .. string.format("en_%s_%03d.png", type_, tonumber(idx))
            txs[#txs + 1] = editor.tx.rename(path, to)
        end
    end
    editor.transact(txs)
end

run = function()
    local atlas = "/assets/main.atlas"
    local txs = { editor.tx.clear(atlas, "images") }
    for _, path in ipairs(editor.get("/assets/sprites", "children")) do
        if path:match("%.png$") then
            txs[#txs + 1] = editor.tx.add(atlas, "images", { image = path })
        end
    end
    -- 按命名规则把 run_01.png ~ run_04.png 合成动画 run
    txs[#txs + 1] = editor.tx.clear(atlas, "animations")
    txs[#txs + 1] = editor.tx.add(atlas, "animations", {
        id = "run",
        images = {
            { image = "/assets/sprites/run_01.png" },
            { image = "/assets/sprites/run_04.png" }
        }
    })
    editor.transact(txs)
end

run = function()
    local gos = {}
    walk("/main", gos)
    for _, path in ipairs(gos) do
        local text = editor.get(path, "text")
        if text and not text:find("script", 1, true) then
            print("[警告] 没有挂脚本：" .. path)
        end
    end

    -- 导表：调用外部生成器，把结果写回文本资源
    local code = editor.execute("python3", "tools/gen_items.py", "design/items.csv", {
        reload_resources = false, out = "capture"
    })
    editor.transact({ editor.tx.set("/main/items.script", "text", code) })
    editor.save()
end

tools/gen_version.lua         ← 纯 Lua，编辑器与 CI 共用
tools/validate_assets.lua     ← 资源校验，编辑器与 CI 共用
editor/build_tools.editor_script   ← 只负责在钩子里 require 上面的脚本

# CI 里等价地跑一遍；版本号用 settings 覆盖，不依赖钩子
lua tools/gen_version.lua ci x86_64-linux
java -jar bob.jar --settings ci.settings --archive --platform x86_64-win32 \
  --variant release --bundle-output build/win resolve build bundle

# ci.settings
[project]
version = 1.4.2

editor/<domain>_<verb>.editor_script   命名：领域_动作，如 atlas_rebuild
editor/lib/                            纯 Lua 工具，不依赖 editor.*
hooks.editor_script                    只放生命周期钩子，保持极薄
tools/                                 与 CI 共用的命令行脚本