AI 编程助手 Pack
把整套 API 知识打包成一个可下载的 pack。装上之后，写 / 改 / 调试 HApex3.0 Lua 脚本时 AI 助手会自动加载 API 参考、约定和示例。
包内语言
Pack 内文档统一英文。中文文档读 wiki 本身（右上角可切换语言）。
约 37 KB · 单一包同时支持 Claude Code / Codex CLI / opencode / Aider 等
支持的 AI 工具
| 工具 | 入口 | 安装路径 |
|---|---|---|
| Claude Code | SKILL.md（带 dispatch frontmatter） | ~/.claude/skills/hapex3-lua/ |
| OpenAI Codex CLI | AGENTS.md | ~/.codex/hapex3-lua/ + 引用追加到 ~/.codex/AGENTS.md |
| opencode TUI | AGENTS.md | ~/.config/opencode/hapex3-lua/ + 引用追加到 ~/.config/opencode/AGENTS.md |
| Aider / 其他 AGENTS.md 工具 | AGENTS.md | 手动放到对应位置 |
包内同时提供 SKILL.md（Claude 专用 dispatch 入口）和 AGENTS.md（多工具通用入口），两者内容等价，references 目录共享。
包结构
hapex3-lua-skill.zip
├── hapex3-lua/
│ ├── SKILL.md # Claude Code 入口（带 frontmatter）
│ ├── AGENTS.md # Codex / opencode / 通用入口
│ └── references/ # 按需加载的详细内容
│ ├── api-reference.md # 15 模块完整 API（约 1400 行）
│ ├── guide.md # 项目结构 / 通信 / 时序 / 陷阱
│ └── examples.md # 8 个完整示例脚本
├── README.md # 用户安装说明
├── install.ps1 # Windows 一键安装
└── install.sh # macOS / Linux 一键安装安装
一键脚本
| 平台 | 装到所有工具 | 只装某一个 |
|---|---|---|
| Windows | .\install.ps1 | .\install.ps1 -Target claude |
| macOS / Linux | ./install.sh | ./install.sh --target=claude |
-Target / --target= 接受 claude / codex / opencode / all（默认）。
脚本自动检测旧版本并覆盖。Codex / opencode 还会在对应的 AGENTS.md 末尾追加一行 pack 引用（带 # === hapex3-lua pack (auto-managed) === 标记，重装不会重复追加）。
手动安装
把 hapex3-lua/ 目录复制到目标工具的对应位置：
| 工具 | 目标目录 |
|---|---|
| Claude Code | ~/.claude/skills/hapex3-lua/（Win：%USERPROFILE%\.claude\skills\hapex3-lua\） |
| Codex CLI | ~/.codex/hapex3-lua/（Win：%USERPROFILE%\.codex\hapex3-lua\） |
| opencode | ~/.config/opencode/hapex3-lua/ |
对 Codex / opencode，还需要在该工具的 AGENTS.md 末尾加一行：
See `<安装路径>/hapex3-lua/AGENTS.md` for HApex3.0 Lua scripting context.这个 pack 包含什么
- 15 个 Lua 模块的完整 API 参考（签名 / 参数 / 返回 / 行为）
- 约定与常见陷阱：冒号 vs 点、Combobox 1-based、
draw.*必须每帧调、双机架构无input.is_down(vk)、资源自动清理边界、gui.set同帧可见 - 8 个完整示例脚本：按键提示 · ESP 文字 · 配色主题 · 性能 HUD · 配置预设 · 物资浏览 · WebSocket 推送 · 伤害日志
- 项目结构、加载顺序、跨脚本通信、frame_update 节拍
验证安装
启动对应工具后输入：
我想写一个 HApex3.0 Lua 脚本，在屏幕中央画个红色十字准星
预期输出包含：
- 用
event.on("frame_update", function(e) ... end)包绘制（不是脚本顶层直接调） - 用
draw.line配draw.rgba(1, 0, 0, 1) - 屏幕中点用
draw.screen()取分辨率
如果输出符合这套风格，pack 工作正常。
触发场景
工具在用户提到下列内容时应用此 pack：
- 写 / 改 / 调试
.lua脚本（HApex3.0 / HOOZi） - 询问具体 API：
gui.find/esp.add/net.http/draw.text/game.localplayer/event.on等 - 「怎么做一个 ESP / 水印 / 通知 / 热键提示」之类的实现问题
- 旧脚本迁移到当前 API
仅 HApex3.0 / HOOZi 的通用使用问题（非脚本相关）不会触发。
升级
新版释出后重新下载 zip，跑安装脚本即可。旧目录被替换；AGENTS.md 引用行不会重复追加。
反馈
Pack 内容跟本站 wiki 同步，如果 API 描述与运行时行为不一致请反馈，下一版修复。