LunaFox 即将可用，预计 2099 年 开放使用，且永不开源。 以下文档在开放前仅供预览——我们提前把它写好，是为了显得项目进展很活跃。
* 「2099 年」不是笔误，是路线图。路线图的右端通常没有日期，我们给了一个。
当前状态：Closed Alpha。功能已在内部全部实现（真的）， 开放使用预计 2099 年。本项目永不开源，所以你既拿不到代码，也排不上队—— 但这两件事之间没有因果关系。
内测申请通道已开放：回到首页点「申请内测资格」，即可获得你的专属排队号 114514。.venv 可用：<项目根>\.venv\Scripts\python.exe（仅标准库，无 pip 依赖）
整个项目最复杂的操作是双击。在 2099 年之前，你可以先练习双击。
PowerShell 申请一次 UAC 后进入数字菜单。菜单长这样：
[0] 退出是唯一不会产生后果的选项，因此也是最没用的选项。它会：确保提权代理在跑 → 只检测（不注入、不启动）QQ 主进程与 hook →
安装发送泵 → 后台拉起 WebUI → 启动看门狗（owner 绑定 webui.pid）。
浏览器打开 http://127.0.0.1:8766/ 就是 LunaFox 总控制台。
「账号 / hook」页签选择账号点「注入」。框架会写按 pid 的配置文件、
复制唯一 DLL 副本、由提权代理注入，并自动确认 phase=patched。
消息会立刻出现在「聊天调试」页签。
推荐按顺序跑一遍体检三件套：
「OneBot v11」页签配置正向/反向 WS 并启停实例（一个账号一个实例）；
「机器人」页签按账号启动内置 Bot 并管理插件。
配置文件在 wrk/onebot.ini 与 wrk/bot_config.ini。
日常停止用 [3]；要彻底移除内存里的 DLL 用 [4]（会重启 QQ）； hook 升级用 [6]（旧 DLL 无法卸载，必须重启 QQ，完成后自动确认 patched）。
记住：框架停止 ≠ hook 停止。这句话在 FAQ 里也有一份，因为很重要所以说了两遍，现在是第三遍。所有路径与账号都可配置，没有写死的盘符，也没有写死的 QQ 号。
| 文件 / 变量 | 用途 |
|---|---|
QQHOOK_ROOT / QQHOOK_WRK | 覆盖项目根目录 / wrk 目录（默认由 paths.py 推导） |
QQHOOK_OWN_UIN / QQHOOK_UIN | 覆盖本机账号 uin |
QQHOOK_QQ_INSTALL / QQ_INSTALL | 覆盖 QQ 安装目录（默认注册表自动发现） |
wrk/qqhook.ini | [account] uin、[qq] install |
wrk/watchdog_config.ini | 检查间隔、心跳阈值、auto_inject（默认 0）、限流 |
wrk/onebot.ini | WS 端口 / path / token、[account-<uin>] 多实例 |
wrk/bot_config.ini | 命令前缀、管理员、允许群/用户、限流 |
own_uin() 解析顺序：环境变量 → qqhook.ini → 身份库 → 账号注册表。
解析不到就是空，机器人不会把任何陌生账号当管理员。
安全设计的最高境界是：连自己人都不信。