私人休闲服统一助手：功能表与验收边界

一、交付及授权边界
主脚本 content/private_assistant.lua，仅供独立分享包使用；本轮没有部署、重启、数据库建表、修改远端文件或执行游戏业务操作。
入口：游戏聊天输入 .leisurehelp；若普通账号命令关闭，可在“说”频道精确输入“休闲助手”。该精确口令回调返回false，不发送给其他玩家。没有GM权限检查，作用对象始终为操作玩家，不接受角色名、物品ID、数量、SQL、路径或坐标输入。
主脚本固定dofile读取 /lzcapp/pkg/content/professions.lua、teleports.lua、spells.lua 与 gear.lua，缺失/损坏的模块自动隐藏。安装时只将主脚本置于lua_scripts；模块保留content路径，避免自动扫描两次。
启动脚本必须先创建 /lzcapp/var/private-assistant/，限服务进程可写。每角色数字GUID.state持久化；不创建或变更数据库表。
分享包不得安装原服solo_mode_8.lua，否则该旧脚本会在指定角色登录/复活强制开启旧增强，破坏“正常模式”。不需要也不得在现有服停用它。

二、功能表
- 模式：默认normal；自愿solo为50780伤害+100%，62733由CastCustomSpell明确指定-50承伤。没有god/无敌API证据，因此不提供无敌。
- 经验倍率：仅本人可选1x/2x/5x/10x，默认1x；事件12（OnGiveXP）返回新经验值，不改服务器全局倍率，组队时各人按自己的设置；0/负值不改，结果封顶2147483647；旧存档缺xp按1x，非法xp使该角色账本失效并按1x处理。
- 一键80：仅本人、当前<80、存活/脱战/落地/非PvP/非战场竞技场；SetLevel(80)后逐个LearnSpell并用HasSpell复核；天赋点初始化，不自动加天赋、不送专业/骑术；升级后打开T10套装菜单。
- 技能表：content/spells.lua由3.3.5a Spell/SkillLineAbility/Talent DBC生成；排除天赋、专业、骑术、符文熔铸配方和内部测试技能；包含职业技能、武器/护甲被动及职业可用种族限制；学习全部等级rank。
- T10套装：content/gear.lua含19个职责套装共95件277装等；只显示本职业；每件角色终身1件；发前用GetItemTemplate校验装等277/等级80/AllowableClass，API缺失时退回静态核对；不自动穿戴，背包不足可补领。
- 启动装：一键80后打开T10菜单选择职责套装，并可在同一页领取4个36格背包；武器/散件BIS仍属后续阶段，未包含。
- 首次登录入口：state新增welcomed=0/1；每角色首次登录延迟3秒自动打开主菜单，只弹一次；存活/脱战/落地条件不满足时最多重试6次（5秒间隔），之后提示用 .leisurehelp。旧存档缺welcomed按未弹处理。
- 骑术与坐骑：80级可学习33388/33391/34090/34091/54197（含寒冷天气飞行），以及61425/59568/59569/59570/63796/69395/72286等中立坐骑；每项用LearnSpell并HasSpell复核，不改移动速度、不作用他人。
- 天赋：content/talents.lua由Talent/TalentTab DBC生成并排除宠物天赋页；一键全天赋会ResetTalents(true)、SetFreeTalentPoints(本职业总点数)、多轮LearnTalent到最高rank，再SaveToDB；总点数超过正常上限，客户端天赋页可能显示异常；另有免费重置天赋。
- 范围：仅自身、单人PvE；组队、PvP标记、战场、竞技场暂停增强。1秒轮询存在小于约1秒的进入状态窗口；不是竞争服防作弊/强PvP隔离方案。不改变全服配置或他人角色。
- 正常模式：只移除自身持久状态登记的50780/62733，不RemoveAllAuras，不移除其他编号光环；发现未登记的同编号光环时拒绝开启，以免覆盖。
- 旧61144：有该光环时显示独立确认按钮，仅能确认移除自身施放的旧火焰视觉。并非切正常时无条件清所有61144。
- 登录/复活：恢复已保存选择；登录重施登记的62733为-50，不使用原版-90。死亡不自动复活，不跳过副本机制。
- 修理：按正常金币费用，仅自身，不使用公会银行。金币不足可能只修部分；不发金币。
- 背包：23162，36格，每角色4个终身额度，已持有（含银行）计入。不替换旧包，不丢旧物品。
- 职业装备：只向80级盗贼显示17件已核实277/284组合；每件角色终身1件。不强制穿戴，不学习全部职业技能，不改天赋。其他职业数据未核实，隐藏而非猜配。
- 附魔/宝石：只向盗贼显示已核实材料卷轴、多彩1、梦魇1、敏捷宝石22；手动使用，不覆盖现有附魔。使用时声望限制仍存在；镶嵌会消耗/替换宝石。
- 消耗品：治疗/法力药水各补足20，猛犸肉大餐20，四种合剂分别20，冰锋箭1000、破碎弹1000；仅盗贼可补速效/致命毒药各20。补足已有量上限（含银行），每项60秒间隔，消耗后可补，不是无限叠加大礼包。原生交易仍允许，不能当竞技服防经济滥用方案。
- ZG：诱饵19974×1、鱼19975×5；疯狂19931×1。只提供材料，不保证钓鱼召唤条件/疯狂链已修复，不自动生成Boss或刷新对象。
- 专业：模块提供已核实的14项专业学习与已学专业升级，严格执行两主专业上限；钓鱼、烹饪、急救为副专业。按等级和已学状态返回错误。没有“learn all class”，不批量学习配方、互斥专精。
- 传送：17条现有game_tele入口白名单，不允许输入任意坐标。MC为黑石深渊内入口、BWL为黑石塔内入口，均不是团本Boss直达；前置、门禁和副本队伍限制仍由核心处理。未经实际落地验收。

三、发物与持久化安全
Player:AddItem实际源码会先CanStoreNewItem，容量不足可部分加入；Lua没有CanStoreNewItem/GetFreeInventorySpace绑定，不能声称调用了这两个接口。本助手逐物品比较GetItemCount(entry,true)前后差额，容量不足释放未发额度，留空格后可补领；不邮件、不自动删物、不自动装备。
领取前先将额度写入固定GUID账本，再AddItem，再SaveToDB、回写实际数量。进程崩溃发生在额度预留后/实际入包前，可能少领而不会因此无限重复；需管理员结合角色库存与账本核查补偿。文件与角色数据库不是跨介质事务，不能承诺断电场景零丢失。写失败关闭该角色后续领取/模式变更。
装备/背包/附魔/宝石/工具账本是逐角色终身额度；T10套装按 t10set<setID> 记账，背包与既有 bags 额度共用；这些物品出售、交易或消耗不会恢复额度。已有数量计入。日常消耗品使用独立refill，只补足当前持有上限，60秒后可补，可能通过交易转移后再补，故仅适合授权的私人休闲服。保留备份，不可随意清空此目录或将旧数据库与不匹配的账本组合恢复。GUID重用或换角色库时需隔离不同实例目录。
原子rename需要目标文件系统支持；io写入没有fsync，极端掉电仍有边界。不能把账本放其他普通玩家可写目录。非管理员不能通过菜单修改路径；代码从不执行账本内容。

四、本轮只读API证据（2021源码）
1. /azerothcore/modules/mod-eluna-lua-engine/LuaEngine/PlayerMethods.h:3437 AddItem：CanStoreNewItem→StoreNewItem→SendNewItem，未调用邮件；数量可被noSpaceForCount扣减。
2. 同文件3819 GossipSendMenu：参数为(npc_text, Object sender, menu_id)；sender不能nil，玩家来源必须menu_id。本助手使用GossipSendMenu(100,player,88533501)。
3. /azerothcore/modules/mod-eluna-lua-engine/LuaEngine/GossipHooks.cpp HandleGossipSelectOption：玩家菜单回调(event,player,player,sender,action,code)，本助手检查独立sender与同GUID。
4. /azerothcore/modules/mod-eluna-lua-engine/LuaEngine/Hooks.h：event42命令；3登录；4退出；36复活；28换图；18聊天。
5. /azerothcore/modules/mod-eluna-lua-engine/LuaEngine/PlayerHooks.cpp:OnCommand，返回false拦截已处理命令；AIO已有42事件，仅处理aio前缀，本助手只精确匹配leisurehelp，不拦其他命令。
6. /azerothcore/src/server/game/Chat/Chat.cpp:398 ParseCommands：普通账号需AllowPlayerCommands；当前worldserver.conf为1。event42在内置命令未匹配后执行，不赋予GM。
7. /azerothcore/modules/mod-eluna-lua-engine/LuaEngine/UnitMethods.h:2461 CastCustomSpell：bp0为第4个方法参数，int32，支持-50。
8. /azerothcore/modules/mod-eluna-lua-engine/LuaEngine/LuaEngine.cpp:232 luaL_openlibs，支持io；原solo_mode_8.lua也使用io.open。
9. /azerothcore/modules/mod-eluna-lua-engine/LuaEngine/LuaFunctions.cpp绑定GetItemCount/GetItemByPos/DurabilityRepairAll/GetGUIDLow/GetAura/HasAura/IsPvPFlagged/InBattleground/InArena/IsFlying；未发现SetGod、CanStoreNewItem或GetFreeInventorySpace的Lua绑定。
10. /root/azeroth-server/bin/lua_scripts/多功能炉石非常强大.lua:10及927-928注册6948物品菜单；本脚本无RegisterItemGossipEvent，避免双处理。
11. /root/azeroth-server/bin/lua_scripts/solo_mode_8.lua使用50780、62733(custom -50)、61144及角色8恢复逻辑，是独立新包排除此脚本的依据，非本轮部署结论。
12. 本轮新增依赖 SetLevel、GetRace、LearnSpell、HasSpell、GetItemTemplate 及其 GetItemLevel/GetRequiredLevel/GetAllowableClass；当前 mod-ale 源码有对应实现，但已安装2021 Eluna 的逐项绑定必须在测试角色实测；缺失 GetItemTemplate 时T10只按静态核对发放。
物品与盗贼套装依据本地《战斗贼-277与284装备方案.txt》《战斗贼-附魔宝石方案.txt》以及桌面《魔兽单机服-GM命令与怀旧副本速查.md》中的当前服核对清单；旧文件邮件命令没有复制执行。专业、入口数据由独立模块交付。技能表来自本机3.3.5a客户端DBC，T10 95件已对照公开3.3.5a item_template；生成与核对细节见 store/p1-boost80-t10.md。

五、独立测试服验收清单（以下不是本轮已通过结论）
A. 普通新账号两角色：无GM，.leisurehelp打开；“休闲助手”不广播；其他命令/聊天与6948原菜单正常。菜单超时/重复包不重复执行。
B. 默认无增强；开启后核对50780为+100%、62733效果值确为-50且无视觉；普通模式移除登记两光环，玩家其他buff不变。预先加同编号外部buff应拒绝开启。
C. 退出登录/重登、死亡复活、换地图恢复选择；normal保持normal，旧61144仅明确确认且来源自身可清。确认独立包无旧solo脚本。
D. 组队/PvP/战场/竞技场暂停，离开后恢复；记录1秒窗口，确认不接受此边界的服务器不应启用solo功能。
E. 0空格、1空格、部分堆叠、银行已有、背包已有、消耗后再点、换角色：检查实际物品增量与额度；17装备分批补领、不邮件。强杀进程模拟预留窗口应最多少领，不应重复。使用测试角色，不拿用户旧角色试。
F. 状态目录只读、目录缺失、账本畸形、文件读权限丢失：关闭领取/模式写入，不覆盖异常账本。正常文件能在重启后恢复。
G. 专业：0/1/2主专业；第三主专业拒绝；重复学习不消耗专业位；等级不足拒绝；三副专业可共存；升级只针对已学专业；不误学另一职业、不解锁互斥专精。
H. 各入口实际落地、阵营安全、门禁、战斗/死亡/飞行禁用；MC/BWL确认是前置本入口而非Boss。ZG诱饵/鱼与疯狂材料不代表召唤链修复。
I. 使用卷轴/宝石前保留旧装备；验证声望/插孔/材料消耗由原生核心处理，不盲目覆盖。
J. 一键80：新建多职业测试角色，确认仅<80可点、存活脱战限制、SetLevel到80、HasSpell复核、天赋点可用、重登保存；抽查不包含天赋/专业/骑术；记录学习失败数量与缺失API。不要用用户旧角色试。
K. T10：10职业19职责逐一发放，确认只显示本职业、95件装等277/等级80/职业限制、每件终身1件、重复点击不叠加、0空格分批补领；若GetItemTemplate缺失，记录退回静态核对的行为。确认不自动穿戴、不发邮件。
L. 首次登录：新建角色登录后3秒内自动弹菜单且只弹一次；重登不再弹；战斗中/飞行中登录确认重试与最终提示；旧存档升级后应补弹一次。
M. 坐骑：80级学习全部骑术后确认能召唤地面/飞行坐骑，寒冷天气飞行生效；重复点击不重复学习；低级角色拒绝。
N. 天赋：一键全天赋后确认技能书/被动/天赋页状态；免费重置后点数返还；观察客户端显示异常、被动叠加和重登保存；记录真实服务端结果。

六、静态验证边界
本轮完成Lua语法解析（luaparse）与离线模拟79项通过（fengari Lua VM）；新增经验倍率、一键80、种族过滤、T10发放/额度/等级门槛、首次登录自动弹菜单/只弹一次、坐骑学习、全天赋/免费重置用例。技能表由本机3.3.5a Spell/SkillLineAbility/Talent DBC生成，排除895个天赋法术、专业/骑术/符文熔铸配方及内部技能；T10 95件对照公开3.3.5a item_template全部为277装等/80级/职业允许；天赋表由Talent/TalentTab DBC生成并排除宠物天赋页。仍未在真实服务端验收SetLevel/LearnSpell/GetItemTemplate/LearnTalent/ResetTalents、首次登录自动弹菜单、全天赋与坐骑；本机无原生Lua，使用临时安装的 fengari/luaparse 执行，未修改项目依赖。提供test_private_assistant.lua纯内存模拟测试，仅供离线工具执行，不可安装进lua_scripts。可从content目录用已有Lua 5.1+执行 lua ../tests/test_private_assistant.lua private_assistant.lua。未安装npm依赖到项目、未在现有服执行脚本、未完成游戏登录/战斗/落地验收。主线程若另行完成Lua解析/模拟测试，应在最终交付报告单独注明准确结果。
