用途
该技能面向《魔兽世界》插件的全流程开发工作,包括设计、构建、调试、移植和打包。目标客户端限于三类:Retail、Forever、经典进度分支(Classic progression,注意不是 Classic Era),以及这三者的任意组合。
主要能力与工作方式
确定目标契约:在选择 API 前先阅读 wow-client-targets。用户明确指定的目标优先于已有配置;需要检查 TOC、打包配置和现有兼容模块,目标仍不明确时应询问,不得默认使用 Retail。Era、Anniversary、PTR、beta 或私服请求属于范围变更,不能静默替换。选定的目标、上游提交、客户端/接口版本、功能需求及未解决的可用性问题需记录在插件项目文档中。
UI 原型流程:当任务创建或修改可见插件 UI 时,实现前询问一次是否先做 UI 原型或直接实现;已有答案或明确要求时不再重复询问。无 UI 改动的任务无需此问题。等待选择期间可继续独立的 API 研究与项目检查。原型需展示代表性状态的具体布局;模拟器原型为可选项,交互工具或目标版本不可用时可用静态原型。
保持已确认外观:对已接受的���型做视觉检查并记录布局与素材方案,选用能还原它的渲染技术,将实际截图与原型比对;需要时使用自定义美术配合原生文本、输入和命中区域,不得用原生素材静默替换。原生控件需保持可用并遵守目标客户端的安全规则。应尽早比对代表性面板并修复差异;截图或渲染不可用时须报告视觉比对未运行。
按需研究 API:通过 wow-api-index 选择领域技能。旧的领域参考默认是 Retail 历史基线,除非某节给出目标相关的新证据。每个任务解析一次所选源码分支到具体提交,并在全任务中使用这些固定提交的源码;需核对生成的 API 定义、各客户端的 Lua/XML 加载路径、事件与载荷、参数与返回类型、插件访问限制。共享生成文件中出现某名称,不代表该功能会在所选客户端加载。不得编造函数签名,不得把 Retail API 静默换成 Forever/Classic,也不能因 Retail 移除就宣称所有客户端都移除。离线时需说明内置快照的日期/版本并只做可验证的断言。
面向一个或多个客户端实现:保留插件既有架构与所需功能,偏好事件驱动 Lua、插件局部命名空间、有意声明的全局变量、安全初始化和显式依赖加载。多目标时共享核心模块,把不同签名与行为隔离到小型兼容层,并遵循插件目录布局。每个选定目标生成独立分发包,含正确接口号和文件加载顺序;不应要求用户在同一客户端的 AddOns 目录安装多份副本。需按目标与上下文确定安全规则,遵守受保护操作、战斗锁定、污染(taint)和秘密值限制,不得尝试披露受限数据。能力不可用时报告受影响目标并提出缩减功能或明确不支持。可复用已验证的库 API,项目专属知识写入用户插件仓库,而非修改缓存的市集安装。
验证与交付:运行相关静态检查,检查每个目标的打包 TOC 与文件列表。UI 改动在条件允许时用 UIForever 模拟器测试,不可用的检查记录为未运行;游戏内验收需客户端验证。对全新 API 抓取、存在争议的可用性或事件探测,使用运行时验证,并区分源码、存在性、注册与操作结果。交付报告需包含选定目标、源码提交、兼容性选择、原型选择、已执行检查、不支持功能及需游戏客户端完成的检查。静态检查与模拟器通过不能证明游戏内兼容。
工具依赖与限制
仅在代理实际具备 Witchcraft MCP 或 computer-use 能力时,才使用连接客户端测试:Witchcraft 提供游戏上下文与错误,computer-use 可在已授权会话中查看和操作相关 UI。需先发现可用工具并遵守已有授权设置,分开记录上下文新鲜度、截图、交互结果与各客户端验收。宿主缺少这些能力时并非强制,应提供可复现步骤并明确标注未运行,而不是虚构工具访问或成功。官方收费、价格与具体支持平台暂未提供。