Note
HoldexarPlus 基于 GLrone/Holdexar 创建（GPL-3.0），由 @Solvora-orbit 独立维护，与原项目无隶属关系，后续改动不代表原项目。原项目版权归 GLrone，感谢原作者的贡献。
一句话：底座是原项目的，方向是使用者体验——原项目偏功能广度，Plus 版围绕「装好就能用、用了不迷路、更新不受制于人」持续打磨。两者数据目录与库文件完全兼容，原版用户迁移零成本。
| 维度 | 原项目 Holdexar | HoldexarPlus（当前） |
|---|---|---|
| 更新通道 | 跟随上游发版 | 完全独立：应用内「检查更新」只读本仓库发布，上游更新不影响你 |
| 直连体验 | 「直连优先」仍要求代理池出口，空池报「没有可用出口」 | 直连 / 直连优先统一为本机网络托管，无代理也能完整使用全部功能 |
| 策略可审计 | 策略变化无痕 | 每次路由策略变更写入日志，设置跳变一查便知 |
| 抓取方式 | 任务粒度较粗 | 任务页可选方案：全部 / 愿望单 / 折扣中游戏 / 已购库 / 监控池 / 指定 AppID + 特惠榜一键抓取；页内白话说明「抓取会不会删数据、总数为什么会变」 |
| 榜单可见性 | 特惠榜抓完「看不见摸不着」 | 独立榜单视图：特惠 / 热销 / 热门新品 / 即将推出四榜可翻 + 榜内区域/比价筛选，抓完即达；快速切榜不串数据 |
| 捆绑包情报 | HB 月包只标当月 | 捆绑包中心：HB 月包近 2 年进包记录（抓取窗口可调）、HB 商店捆绑包按价格档展示包内游戏 + 实时销量、Fanatical（档位包/选择包，多币种切换）、GreenManGaming（PWY 累进档）三站同构交互、Steam 捆绑包浏览比价、新包 NEW 提醒 |
| 自助排障 | 需翻文档问作者 | 帮助与诊断卡：FAQ、当前策略、版本号、数据目录路径一屏直达；日志页一键跳转 |
| 数据管理 | 手动删文件 | 应用内一键清空本地数据（双保险确认），重置即全新安装 |
| 外观 | 深浅两档 | 深浅之外四套主题色（蒸汽蓝/翠绿/暖橙/紫罗兰），偏好跨启动持久；侧栏指示条随页面变色、品牌图标 H+ PLUS |
| 细节 | — | 全页面统一的返回 / 回顶 / 列表不竞态交互规范；降价动态独立页；统计卡点按直达；关闭弹窗二选一清晰引导；操作全程不闪命令行黑窗 |
已发布 ✅
- v0.1.1-plus.1（2026-10-06）：fork 基线切割（更新源/品牌/版本号）· 直连形态修复 + 策略审计 · 多抓取方案 · 帮助诊断卡 + 数据清空 · 主题色方案 · 按钮体系统一
- v0.1.1-plus.2（2026-10-06）：偏好持久化修复（主题不再跳回默认）· 榜单视图上线 · 游戏库补抓无价格 + 数据自动同步 · 返回键来源感知 · Steam 账号管理收敛至设置页
- v0.1.1-plus.3（2026-10-07）：捆绑包中心（HB 月包 + 近一年进包记录 + 多站源预留）· HB 历史逐月补抓 · 降价动态独立子页 · 榜单筛选与竞态修复 · 统计卡跳转 · 游戏库家庭成员计数修复 · 网络页防闪控制台 · 图标重绘 H+ PLUS · 侧栏指示条增强
- v0.2.0（2026-10-07）：转正式发布。HB 捆绑包上线（商店在售包抓取 + 包内游戏比价）· Steam 捆绑包展示区 · HB 月包近一年启动自动补抓 · 侧栏品牌 logo 高清化 · 自动抓取页居中 · 版本号转 semver（plus 开发线完结）
- v0.2.1（2026-10-07）：月包抓取窗口含当月可调（默认 6 期 / 上限 2 年）· HB 捆绑包条目计数一致 + 未收录自动补爬 · 新包 NEW 角标点开已读 · 抽屉拖宽记忆 · 包卡档期与列表收放 · 关闭弹窗图标清晰化
- v0.2.2（2026-10-07）：关闭弹窗去左上图标、退出改描边按钮更克制 ·
run.py --dev/dev.bat免构建开发模式（自动拉起 Vite 热更新，端口占用智能换）· fork 遗留死文件清理与文档对账 - v0.3.2（2026-10-08）：HB 捆绑包关联大幅修复——标题
\u0027转义还原（A Juggler's Tale 类永远关联失败根因）· 简称→全称副标题模糊匹配（Disco Elysium 自动对准 The Final Cut 本体）· 关联三轮未果标「Steam 未找到（可能非 Steam 游戏）」· 单款档位游戏卡形占位（不再塌成一条信息） - v0.3.1（2026-10-07）：捆绑包档位数据自愈补抓（存量包档位缺失导致档位条不出现）· 月包「抓取窗口」与「立即抓取」按钮重叠修复
- v0.3.0（2026-10-07）：装好就能用——默认策略改「直连优先」（本机有系统代理自动识别并采用；导入订阅自动切代理优先，手动选过的策略不覆盖）· 直连形态默认不随价格轮刷全量目录/特惠榜（省流量）· 连不上 Steam 时弹加速器配置建议 · 捆绑包档位改 HB 官网式档位选择器（点档看该档实得全部游戏）· 收录链轮内连续分批 + 新包优先 + 「收录中 N」一键立即收录 · 愿望单同步补齐 SSL 证书降级（代理环境不再崩）· 爬虫写侧价格保全（本次失败不推翻曾经拿到，修 dev 库现价清零事故）· AI 月度用量默认不设上限 · 领航员多余卡片折叠 · 日志页模块中文名 · mihomo 内核 v1.19.32
- v0.4.0（2026-10-11）：捆绑包三站统一——Fanatical（档位包 + 选择包）与 GreenManGaming（PWY 累进档）捆绑包接入捆绑包中心，与 HB 同构交互（档位条 / 卡片 / NEW / 三态关联状态），F 站价格 7 币种原生展示可切换（零折算）· 统一模糊检索引擎（storesearch + Steam 店铺全文搜索双检索源 + NFKD 音标归一，13 条 HB VR/格斗包存量欠账全部 exact 恢复）· HB 捆绑包销量「已购 N」显示 · 下架 30 天内带欠账的包也吃检索升级红利 · 爬取侧 HTML 实体/NFKC 字符标记防关联遗漏
- v0.4.1（2026-10-11）：Fanatical 关联判据修正——steamId 缺失不再误标「非 Steam」（以 drm 字段为权威，58 条误标重走检索恢复），合辑 SKU（Double/Triple Pack、A + B、Pack/Bundle 收尾）如实直标 · 版本词表扩充 + 查询词「剥版本词」档（Premium/Legendary Edition 变体对准本体）· 完成 Mimosa 深度安全审计（25 项复核全为静态保守项，依赖 0 命中）
- v0.4.2（2026-10-11）：撤回 v0.4.1 的「剥版本词」逻辑（用户裁定）——版本后缀可能是独立 Steam 捆绑包 SKU（如某些 Complete Edition 是合辑），剥词会把合辑错对到本体；词表回 v0.3.2 基线，宁留欠账不猜，已关联条目不受影响
- v0.5.0（2026-10-11）：捆绑包条目 ↔ Steam 捆绑包联动——三站查不到的条目名在同一次 Steam 搜索页请求里顺带解析捆绑包，命中后复用 Steam 捆绑包功能全套链路，抽屉显示「Steam 捆绑包」卡并可展开包内比价 · 实验性功能区（设置页开关 + 风险确认弹窗，默认关）：开启后侧栏出 Steampy 行情实验页（游戏 CDK 市场公开行情：最低 CDK 价/在售数/原价史低对照）· Fanatical「剩 355828 天」显示修复（站点用公元 3001 年表示永久在售，超 2100 年按无到期处理）
- v0.6.0（2026-10-11：捆绑包大修）：Steam 捆绑包联动换源修复——v0.5.0 的搜索页捆绑包解析在实网从未命中（Steam 已把捆绑包移出搜索结果），改由本地捆绑包语料（爬虫日常发现的近 2 万条实名）精确匹配 · 捆绑包防误判：带 Complete Edition 类版本后缀的条目不再错配本体游戏，先查捆绑包（Police Stories - Complete Edition 实为捆绑包 12051 而非游戏本体）· 站点合辑成员展开：Fanatical 自造合辑 SKU（Double/Triple Pack 等）按站点明示的成员清单逐个关联（30 条历史欠账实网全解，77 名成员 100% 命中），抽屉「站点合辑」卡免点击出封面、成员行直达游戏详情 · 单包重抓：抽屉「重抓此包」一键删数据重建 · Steam 捆绑包卡改右侧详情抽屉（包价对比 + 包内游戏直达）· 捆绑包 Sub 形态封面修复 · 联动入库写锁死锁根修（写事务内嵌套连接 → 出闸重排 + 悬空引用自愈补抓）· 迁移 v16 存量欠账自动重试
规划中
- 顶栏主题色快捷切换（不止设置页入口）
- 「自动抓取」与「任务」两页的引导互链，自动化控制不再分散
- 公共目录库模板随发布分发——全新安装首次进店即可看到完整目录，冷启动等待归零
- 榜单视图增强：游戏卡 TOP 徽章、榜内价格变化高亮
- 自有 Scoop 渠道（清单已随发版产出，待建 bucket 仓库接入；上游 bucket 是原版不混用）
- 价格事件摘要邮件（每日/每周汇总，替代逐条轰炸）
想投票或催更？直接在 Issues 里说。合理的功能请求优先安排。
你在 Steam 上买游戏时可能遇到过：同一个游戏，阿根廷区、土耳其区、国区的价格差好几倍。HoldexarPlus 就是帮你把这件事自动盯起来的工具——
- 你只需要告诉它「我想盯哪些游戏」：粘贴游戏链接、登录 Steam 同步愿望单、或者导入一份列表；
- 剩下的全由它自己来：每隔几小时把各区价格抓回来、按实时汇率折算成人民币、发现降价和历史新低；
- 价格降到你的心理价位时，它自动发邮件提醒你。
它是一个绿色软件：解压就能用，不需要安装、不需要注册账号、不需要懂任何技术。所有数据都存在你自己的电脑里，不连接任何云端服务器，也没有任何数据上报。没有代理也能用：默认策略就是「直连优先」，全程走本机网络（开着系统代理/加速器时自动识别采用）；导入订阅后自动切到代理优先。
- 到 Releases 页面下载
HoldexarPlus-win64-v<版本>.zip； - 解压到任意文件夹，双击
HoldexarPlus/HoldexarPlus.exe； - 第一次打开会弹出安全提示（未签名程序的正常现象，不是病毒），点「更多信息 → 仍要运行」即可，详见下方安全提示。
打开后会有一遍新手导览，跟着「下一步」走就行，随时可以跳过。
三种方式任选，可以混着用：
- 粘贴链接：在【仪表盘】的添加框里粘贴任意 Steam 商店链接（比如
https://store.steampowered.com/app/105600/），回车即可； - 登录 Steam 同步：到【设置】绑定 Steam 账号（支持账号密码直接登录，遇到手机验证码按提示输入即可），愿望单和已购游戏会自动进来；
- 从游戏卡片关注：逛【找游戏】时，看到想长期盯价的游戏，点卡片右上角的星标即可。
到【价格提醒】页，建一条规则，比如「泰拉瑞亚 国区 ≤ ¥42 时通知我」。之后每当价格刷新，符合条件就会自动发邮件到你预留的邮箱。
到这里核心用法就完成了。接下来你什么都不用做——程序会自己定时更新价格、自己发现降价、自己发提醒。你随时打开看最新数据就行。
| 功能 | 说明（人话版） |
|---|---|
| 找游戏 | 41 个国家/地区的价格一屏对比：当地标价、折扣、折算人民币、史低标记；可按折扣和锁区筛选；工具条直达榜单视图 |
| 降价动态 | 全库新史低 / 平史低 / 永降 / 折扣中的完整动态列表，仪表盘只放精选 |
| 游戏详情 | 同一游戏的标准版/豪华版等多版本比价；每个区的历史价格走势曲线 |
| 游戏库 | 账号已购 + 家庭库 + 游玩动态聚合分析；缺价游戏一键补抓 |
| 价格提醒 | 降价、历史新低自动发邮件；阈值条件自己定 |
| 愿望单与已购 | 绑定 Steam 后自动同步，不用手动维护 |
| 账单 | Steam 消费记录同步，多币种按当日汇率折算成人民币 |
| 捆绑包 / 免费游戏 | 捆绑包中心：HB 月包进包记录（抓取窗口默认 6 期、最多 2 年）、HB 商店捆绑包按价格档看包内游戏与人民币定价 + 实时销量、Fanatical（档位独立成套 + N 选 K 选择包，USD 等 7 币种切换展示）、GreenManGaming（PWY 累进档）、Steam 捆绑包浏览与链接导入；Epic 喜加一、Steam 免费游戏动态，换新自动提示、新包带 NEW 角标 |
| 活动日历 | Steam 官方大促（夏促/冬促）和新品游戏节的时间表与倒计时 |
| 汇率 | 39 种货币兑人民币走势，自带 2010 年至今的历史档案；卡商充值价目参考 |
| 任务 | 想立刻刷新哪批数据就抓哪批：全部 / 愿望单 / 折扣中 / 已购库 / 监控池 / 特惠榜 / 指定 AppID；页内展开「抓取口径说明」看懂不删数据、总数为何波动 |
| 工具箱 | 礼品卡 CDK 批量激活，逐码出回执 |
窗口顶部有一颗「灵动岛」胶囊，程序里值得你知道的事都会在那里冒出来，不需要你主动翻页面：
- 价格更新到哪了（正在更新 / 已更新 / 部分暂缺）；
- Humble Choice 月包换新了、Epic 喜加一轮换了；
- 有新版本可以更新了。
点开胶囊能看详情和进度，不需要知道任何内部机制。
Important
本应用发布包未经代码签名，首次运行会遇到两类安全提示，均为无签名程序的正常现象，不是病毒：
- Windows SmartScreen 弹窗（「Windows 已保护你的电脑」）：点 更多信息 → 仍要运行 即可。
- 杀毒软件报毒 / 主动防御弹窗（如「正在创建 BITS 任务」）：选 允许 / 信任，不要阻止——阻止可能影响窗口渲染。建议把整个程序目录加入杀软白名单。
请只从官方 Releases 页下载，并用页内公布的 SHA256 校验安装包。
首次运行弹出「Windows 已保护你的电脑」？
Windows 对未签名程序的标准提示，与病毒无关。点 更多信息 → 仍要运行 即可，同一版本之后不会再弹。
杀毒软件报毒？
无签名程序常见误报；随包分发的代理内核（开源的 mihomo，见文末致谢）也常被标记。处置：把整个程序目录加入白名单，弹窗选「允许」。
没有代理能用吗？
能。默认策略「直连优先」就是这条路径：全部功能托管到你本机网络环境（开着加速器/系统代理时自动识别采用）；限速由程序统一约束，不会打爆你的网络。导入自备 Clash 订阅后自动切换「代理优先」；爬取大面积连不上时会弹加速器配置建议。
改了主题/语言，重启后又变回默认？
v0.1.1-plus.2 起已修复（桌面壳持久化存储）。如果你用的是更早的包，升级即可；设置跳变类问题可在【设置 → 帮助与诊断】看数据目录，或到日志页搜「[策略]」审计记录。
登录 Steam 时收不到验证码 / 登录不上？
应用内登录走 Steam 官方认证接口。验证码分两种：邮箱验证码去邮箱收；手机令牌打开 Steam 手机 App 就能看到。输错可以重新输入；如果开启了手机 App 确认，直接在手机上点「确认」即可，程序会自动继续。密码只在本机内存里用一次，不会保存。
刚装好，部分游戏没有价格？
新加的游戏会尽快补齐首趟价格（你星标关注的排最前）；刚装好时的批量数据要逐步积累，等一轮更新周期走完就好。也可以手动触发：游戏库页脚「补抓无价格游戏」一键定向补齐，或【任务】页选方案立即开抓。
价格和 Steam 商店页不一致？
价格每 6 小时自动刷新一轮，两轮之间的临时调价有滞后；每条价格都带抓取时间，卡片上能看到数据的新旧。
我的账号密码安全吗？数据存在哪？
账号密码登录走 Steam 官方接口，密码只在登录那一刻在内存里用一次，不落盘、不写日志；登录成功后的凭据加密存放在本机数据库里。全部数据（holdexar.db）都在你自己的电脑上（默认 %LOCALAPPDATA%\holdexar，便携模式在程序目录 data/）。零云端、零遥测——除了 Steam 官方接口和你自备的代理订阅，不连接任何第三方服务。
抓了几轮之后，游戏总数反而变少了？数据丢了吗？
没丢。抓取对数据库只做新增和更新，任何方案都不删游戏。你看到的列表只统计「国区在售且有价格」的游戏——复刷会把 Steam 的当前真相写回：锁区、转免费、折扣结束的游戏会暂时跌出统计（找游戏页把筛选切到「锁国区」就能看到它们）。【任务】页展开「抓取口径说明」有完整白话解释。
不想让它自动抓价格？
【自动抓取】页关闭「自动价格更新」即可：定时刷新和自动重试会停，手动抓取不受影响，随时能再打开。
捆绑包中心里 Fanatical / GMG 的价格币种怎么理解？
价格一律是站点实付原价、零折算：HB 是人民币；Fanatical 不支持人民币（站点本身只有美元等 7 币种），面板右上角可切换展示币种；GMG 按抓取出口实得币种入库（直连多为人民币、走代理可能是美元）。另外包里标「Steam 未找到（可能非 Steam 游戏）」的条目是站点未发行 Steam 键的内容（如同捆的画集/原声），不是抓取故障。
想从原版 Holdexar 迁移？
不用迁。Plus 版数据目录与库文件同原版（holdexar.db），直接退出原版、解压 Plus 版启动即可无损接管全部游戏、账号绑定与价格历史。建议之后卸载原版避免双实例。
- 有新版本时启动会主动提示一次，侧栏「我」项常驻红点，顶栏出现更新胶囊（发现新版 / 下载中 / 待重启）；进【我 → 应用更新】一键升级。
- Plus 版只跟随本仓库的发布——上游原项目更新不会推送给你，也不会覆盖你的版本。
- 换装只替换程序文件，用户数据、账号绑定、价格历史一概不动；换装中断会自动回滚到原版本并重新打开应用。
- 也可以手动下载新版解压覆盖，数据不受影响。
Scoop 渠道（便携应用，不写注册表、不装服务）：自有 bucket 尚未开通（清单已随每次发版构建产出，待建仓库接入）。上游作者的 bucket 装的是原版 Holdexar，不是本 Plus 分支——现阶段请用 Releases 便携 zip 下载 + 应用内更新。详见 packaging/scoop/README.md。
每个版本 Release 附带三件资产：应用包 zip（解压即用）、公共数据种子 holdexar_seed.db（仅源码运行需要，发布包已内置）、更新清单 latest.json（客户端检查更新读取）。
| 层 | 组件 |
|---|---|
| 后端 | FastAPI · SQLAlchemy(async) · APScheduler(25 个定时任务) · aiohttp 爬核 |
| 前端 | Vue 3 · TypeScript · Vite · 自制 Hl* 组件体系(深浅双主题 / 四套主题色 / 中英双语) |
| 桌面 | pywebview(WebView2) · onedir 绿色包 · 单实例锁 · WebView2 偏好持久化 |
| 网络 | 出网策略引擎(direct_first 默认 / proxy_first / direct_only / proxy_only，直连类本机托管 + 系统代理自动识别，导入订阅自动切代理) · 自备 Clash 订阅 · mihomo v1.19.32 内核与 GeoIP 数据随包内置 |
| 认证 | 应用内账号密码登录直调 Steam IAuthenticationService；手动 Cookie 粘贴通道保留；凭据 AES-256-GCM 加密落库 |
价格系统的组织主线：
Monitor Pool → Price Refresh Cycle → Price Observation
→ Coverage / Freshness → Price Event → 用户结果
- Monitor Pool：持续监控的对象集合，只由用户显式动作建立（关注 / 同步 / 导入）；「添加游戏」仅入 Catalog + 一次性首爬，不等于建立监控。
- Price Refresh Cycle：唯一的价格刷新生命周期，每轮由多段任务串成（监控池 → 库内其余 → 目录层随开关 → 特惠榜尾段恒随轮），锚点网格对齐 Steam 折扣刷新时刻。
- Observation 与 Event 分离：
game_price_history一行是一次观察；事件层（降价 / 史低 / 永降）在观察之上独立判定。 - 榜单视图（Plus 增补）：
GET /games?board=<key>把榜单 appid 序 join 目录与价格行——发现面从调试端点变成用户可翻的页。
- 用户的输入边界是封闭清单（绑定账号 / 关注 / 添加订阅 / 添加游戏），此后的一切自动完成：订阅导入即体检、体检健康自动准入、出口漂移启动热收敛、重建空池自愈、数据整体过期自动提前首轮刷新。
- 停自动化走白名单：仅数据泄露 / 登录信息过期 / 订阅全失效会停下等用户，其余失败一律自动降级、重试、换通道。
- 版本号唯一来源
server/app/core/app_info.py的APP_VERSION。0.1.1-plus.N 开发线已收尾（plus.3 末版），v0.2.0 起转正式 semver：新增功能升次版本、修 bug 升修订号；web/package.json与 README 徽章同步。 - 品牌与存储分离：
APP_NAME = HoldexarPlus（界面/发布包/更新资产名），APP_SLUG = holdexar（数据目录、库文件、localStorage 键、环境变量前缀）——改名不动数据。 - 更新源切割：
GITHUB_REPO指向本仓库（应用内自更新唯一来源）；UPSTREAM_REPO仅用于只读公共种子资产。
要求 Python ≥3.13、Node ≥ 20.19（或 ≥ 22.12；Vite 8 的 engines 要求）：
git clone https://github.com/Solvora-orbit/HoldexarPlus.git
cd HoldexarPlus
python run.py # 自动建 venv → 装依赖 → 构建前端 → 拉起桌面窗口python run.py --server # 仅本地服务，浏览器访问 http://127.0.0.1:28765
python run.py --dev # 免构建开发模式：自动拉起 Vite 热更新并接窗（改前端即时生效）
python run.py --port N # 指定端口开发也可以直接双击 dev.bat（等价 python run.py --dev）：不用另开终端、不用先构建前端——脚本检测本机 8080 无 Vite 就后台拉起一份（日志在 vite-dev.log），窗口退出时顺带收掉。Windows 数据目录隔离在 %LOCALAPPDATA%\holdexar-dev，永远不碰打包版用户数据。
首次运行会自动补齐公共数据种子（历史汇率与价格历史切片，约 288MB）：种子是二进制大文件，不进 git，由 run.py 从 Release 资产拉取。没网也不影响启动，只是【汇率】页没有历史档案，之后重跑 python scripts/fetch_seed.py 即可。
随包的还有 Clash 内核（mihomo + GeoIP 数据，约 97MB，版本固定）：同为二进制不入库，由 run.py 调用 python scripts/fetch_kernel.py 从上游补齐；获取失败也不阻断启动，【网络】页会显示「内核缺失」并提供一键安装入口。
发布机（建议用 server/.venv 的解释器）：
python scripts/build_release.py # npm build → PyInstaller → 消毒 → zip，并生成清单
# 编辑 release/RELEASE_NOTES.md 写本次 changelog（客户端检查更新直接展示这段文字）
python scripts/build_manifest.py # 改完说明后刷新 latest.json
python scripts/publish_release.py --dry-run # 预览发布动作，不碰网络
python scripts/publish_release.py # 正式发布（需 gh CLI 且已 gh auth login）一次正式发布会产生两条 Release：
| Release | tag | 内容 | 作用 |
|---|---|---|---|
| 版本发布 | v<版本> |
zip + latest.json + holdexar_seed.db + Scoop 清单 |
给用户下载的那一条，带 changelog |
| 更新清单 | updater |
只有 latest.json |
机器读的那一条，地址恒定 |
要点：
- 清单 Release 必须不是 Latest release（脚本已处理为
--prerelease --latest=false）。否则releases/latest与 RSS 会被带偏，源码用户取种子会失效。 - 资产名固定为
HoldexarPlus-win64-v<版本>.zip（不带时间戳），渠道自动跟进（Scoop 的checkver/autoupdate）才能按版本号拼出 URL。 - 打包产物含
THIRD_PARTY_NOTICES.md（GPL-3.0 第三方组件声明，构建必需）。 - tag 已存在时脚本改走
gh release upload --clobber，重复发布会覆盖资产而非失败。 - 客户端检查链：清单（镜像链）→ 失败回落 GitHub API。没发过时功能照常，只是享受不到免限速与内置 SHA256。
没装 gh：--dry-run 仍可打印全部命令；脚本还会给出网页端手工创建的照抄清单。
HoldexarPlus/
├── run.py # 一键启动器
├── desktop/ # pywebview 壳 + PyInstaller spec
├── scripts/ # 发布脚本（出包 / 清单 / 发布 / 取种子 / 取内核）
├── packaging/scoop/ # Scoop 渠道用法
├── server/app/
│ ├── core/ # 配置 / 数据库 / 调度器 / 更新器 / 数据目录判定
│ ├── crawler/ # 爬核（aiohttp / 路由 / worker / 写库）
│ └── domains/ # 业务域（account/games/wishlist/family/bills/proxies/monitoring/…）
├── server/tests/ # 行为测试套件
├── web/src/ # Vue 3 + TS（components/ui = Hl* 体系，views = 页面）
└── CHANGELOG.md # 发布变更记录
欢迎 fork 后按自己的需求改造。常见定制点：
| 定制项 | 位置 |
|---|---|
| 区服列表（增删国家） | server/app/crawler/config.py → CC_LIST |
| 调度节奏（任务 / 间隔） | server/app/core/scheduler.py → start_scheduler() |
| 爬取并发与超时 | server/app/crawler/config.py → DEFAULT_WORKER_COUNT / HTTP_TIMEOUT |
| 主题与主题色 | web/src/styles/tokens.css（token 化：深浅各一套 + data-accent 方案覆盖块） |
有问题或功能建议，随时提 Issue。参与开发：克隆后执行 git config core.hooksPath .githooks 启用提交门禁（敏感面 / 注释留痕 / lint / 路由 / 词典 / 旗帜素材六项）；依赖与启动见上文【源码运行】，出包与发布见【打包与发布】。
- GLrone/Holdexar — 本项目的底座，全部核心能力源自于此
- mihomo — Clash 代理内核（随包分发，GPL-3.0）
- meta-rules-dat — GeoIP / GeoSite 规则数据（随包分发）