把「网址 + 油猴脚本」一键打包成 Windows 桌面应用（exe，Edge WebView2 内核）。

生成器为纯 Python 实现（单文件、仅标准库、无需 pip 装任何东西）；生成的 exe 来自内置的固化 C# 模板，由 Python 自动填充参数后调用系统自带的 .NET 编译器现场编译 —— 不需要懂 C#，也不需要安装 Visual Studio / .NET SDK。

网址 + 脚本.js  ──►  Hook2Exe(Python)  ──►  csc.exe(系统自带)  ──►  独立 exe（Edge 内核）

• 零依赖生成器：hook2exe.py 单文件，仅用 Python 标准库，pip install 都不用跑
• 自动推断：标题留空 → 自动抓网页 <title>；图标留空 → 自动抓 favicon（apple-touch-icon 优先），抓不到用「渐变圆角 + 首字」默认图标
• 油猴元数据感知：自动解析 @match / @include / @run-at / @name / @version，按规则门控注入、按时机调度执行
• GM_* 全兼容：内置 GM 兼容层，GM_xmlhttpRequest 经宿主 exe 转发，不受 CORS 限制
• 轻量产物：exe + 3 个 DLL 共约 0.9MB（直接复用系统 Edge 内核，不捆绑浏览器）
• 开箱即用：Win10/11 目标机一般自带 .NET Framework 4.x 和 Edge 运行时，拷过去就能跑
• 常驻后台：默认关窗缩托盘继续运行，单实例互斥，登录态按网址隔离持久化

python hook2exe.py

填网址 → 选脚本 → 点「生成应用」，日志区实时显示进度，完成后可直接打开输出目录。支持把 .js 脚本和图标文件直接拖进窗口。

# 最简：只有网址（无脚本、无图标，全自动推断）
python hook2exe.py --url https://www.example.com/

# 完整示例：用原版闲鱼 AI 客服脚本打包
python hook2exe.py --url https://www.goofish.com/im \
    --script "闲鱼 AI 智能客服-1.0.0.txt"

# 指定标题 / 应用名 / 图标 / 输出目录，关窗直接退出
python hook2exe.py --url https://www.goofish.com/im \
    --script bot.js --title "闲鱼客服" --name XianyuBot \
    --icon logo.ico --out D:\apps --no-tray

output/<应用名>/
├── <应用名>.exe                      # 主程序（图标、标题、目标网址均已固化）
├── Microsoft.Web.WebView2.Core.dll   # ┐
├── Microsoft.Web.WebView2.WinForms.dll  # ├ WebView2 依赖，共 ~0.9MB
└── WebView2Loader.dll                # ┘

分发时 4 个文件必须放在一起（可整体打成 zip）。

生成的应用首次运行会自动创建数据目录：

%LOCALAPPDATA%\HookApp\<网址哈希8位>\
├── WebView2Data\    # 浏览器登录态 / localStorage / Cookie
└── host.log         # 宿主异常日志（正常运行为空或不存在）

不同网址的应用数据互相隔离；同一网址的多个应用共享登录态。

• @match / @include：转换为正则做注入门控（页面 URL 不匹配则脚本不执行）；涉及的域名同时进入宿主桥白名单
• @run-at：document-start / document-body / document-end / document-idle（默认）
• @name / @version：填充 GM_info

图标：用户指定文件 → 网页 <link rel="apple-touch-icon"> → <link rel="icon">（按尺寸排序）
      → 站点根 /favicon.ico → 渐变默认图标（标题首字）
标题：用户指定 → 网页 <title> → 域名
应用名：用户指定 → 标题 → "HookApp"

• 托盘常驻：点 × 收进托盘继续后台运行（托盘双击恢复；右键菜单可退出/重载页面）；--no-tray 生成的则直接退出
• 单实例互斥：同一网址的应用只允许运行一个，重复启动弹窗提示
• F12 开发者工具：应用内按 F12 可调试注入的脚本（WebView2 DevTools）
• 安全防护：宿主 HTTP 桥只接受白名单域名（目标域名 + 脚本 @match/@include 域名）发来的请求；拒绝回环/内网地址（基础 SSRF 防护）

Hook2Exe/
├── hook2exe.py               # 生成器主程序（Python，CLI + GUI）
├── README.md                 # 本文档
├── requirements.txt          # 依赖说明（核心零依赖）
├── lib/                      # WebView2 运行时 DLL（随生成的应用分发）
│   ├── Microsoft.Web.WebView2.Core.dll
│   ├── Microsoft.Web.WebView2.WinForms.dll
│   └── WebView2Loader.dll
├── templates/                # 固化模板（生成器填参数后编译）
│   ├── host_program.cs       # exe 入口（单实例互斥）
│   ├── host_mainform.cs      # 主窗体（WebView2 + 托盘 + 页面消息桥）
│   ├── host_httpbridge.cs    # HTTP 转发桥（无 CORS + SSRF 防护）
│   ├── host_manifest.xml     # DPI 感知清单
│   └── gm_prelude.js         # GM_* 兼容层（注入脚本头部）
└── output/                   # 生成产物（首次生成时自动创建）

日常改生成逻辑：只动 hook2exe.py，不碰 C#。

模板占位符对照表（Python 渲染时替换）：

Q：生成的 exe 双击没反应 / 闪退？ 检查目标机是否 64 位 Windows、是否装有 Edge 或 WebView2 运行时，没有的话到微软官方页面下载安装：WebView2 运行时下载页；装完仍异常再看 %LOCALAPPDATA%\HookApp\<哈希>\host.log 里的报错。

Q：脚本好像没生效？ 应用内按 F12 打开控制台看报错；确认脚本的 @match 能匹配目标网址；如果脚本要跑在 iframe 里，生成时加 --all-frames。

Q：脚本里的网络请求失败？ GM_xmlhttpRequest 走宿主桥（无 CORS）；但白名单只包含目标域名和脚本 @match/@include 声明的域名 —— 想请求别的域名，在脚本元数据里加一条对应域名的 @match（如 // @match https://api.example.com/*）后重新生成。用浏览器 fetch 的请求仍受页面 CORS 限制。

Q：登录态会丢吗？ 不会。登录态存 %LOCALAPPDATA%\HookApp\<网址哈希>\，关机重启都保留；同网址重新生成的应用沿用同一份登录态。

Q：favicon 抓不到 / 图标难看？ 部分网站用 SVG 图标或不允许抓取，此时用默认图标；可手动 --icon xxx.png 指定。装了 Pillow（pip install pillow）后任意图片转图标效果更好。

Q：杀毒软件报毒？ csc 编译的未签名 exe 可能被误报（常见于小众杀软），把生成的目录加入信任列表即可。

Q：能生成 32 位版本吗？ 当前模板固定 /platform:x64。如需 x86，把 hook2exe.py 中编译参数改为 /platform:x86 并自备 32 位 WebView2Loader.dll。

# 例 1：把原版闲鱼 AI 客服 1.0.0 打包成桌面应用
python hook2exe.py --url https://www.goofish.com/im \
    --script "闲鱼 AI 智能客服-1.0.0.txt"
# → output/闲鱼 AI 智能客服/（自动用闲鱼 favicon + 网页标题）

# 例 2：纯净浏览器壳（无脚本）
python hook2exe.py --url https://mail.example.com --name 公司邮箱

# 例 3：批处理打包多个站点
for /f %u in (urls.txt) do python hook2exe.py --url %u