【框架设计】新手村动线：前 30 分钟的任务编排

---新手村的任务链编排
local VILLAGE_FLOW = {
    { step = 1, task = "与村长对话",       teach = "交互" },
    { step = 2, task = "击杀 5 只鸡",      teach = "战斗" },
    { step = 3, task = "拾取掉落的肉",     teach = "拾取" },
    { step = 4, task = "穿上布衣",         teach = "装备" },
    { step = 5, task = "学习第一个技能",   teach = "技能" },
    { step = 6, task = "击败稻草人演练",   teach = "操作" },
    { step = 7, task = "出村前往比奇省",   teach = "世界" },
}

function Village.progress(actor, step)
    local player = class(actor)
    if not player then return false end
    local cur = tonumber(getplayvar(actor, 2, "VillageStep")) or 1
    if step ~= cur then return false end
    setplayvar(actor, "HUMAN", "VillageStep", cur + 1, 1)
    local cfg = VILLAGE_FLOW[cur]
    giveitem(actor, "新手补给", 1)
    sendmsg(actor, 1, "完成：" .. cfg.task)
    return true
end

---动线的漏斗监控与流失点定位
setontimerex(103, 600)
function Village.funnel()
    local steps = {}
    for i = 1, #VILLAGE_FLOW do
        steps[i] = Village.reachedCount(i)
    end
    local report = {}
    for i = 2, #steps do
        local dropRate = 1 - steps[i] / steps[i - 1]
        report[#report + 1] = string.format(
            "步骤%d→%d 流失 %.0f%%", i - 1, i, dropRate * 100)
    end
    Ops.log(table.concat(report, " | "))
end