你在 Steam 上买游戏时可能遇到过：同一个游戏，阿根廷区、土耳其区、国区的价格差好几倍。Holdexar 就是帮你把这件事自动盯起来的工具——
- 你只需要告诉它「我想盯哪些游戏」：粘贴游戏链接、登录 Steam 同步愿望单、或者导入一份列表；
- 剩下的全由它自己来：每隔几小时把各区价格抓回来、按实时汇率折算成人民币、发现降价和历史新低；
- 价格降到你的心理价位时，它自动发邮件提醒你。
它是一个绿色软件：解压就能用，不需要安装、不需要注册账号、不需要懂任何技术。所有数据都存在你自己的电脑里，不连接任何云端服务器，也没有任何数据上报。
- 到 Releases 页面下载
Holdexar-win64-v<版本>.zip； - 解压到任意文件夹，双击
Holdexar/Holdexar.exe； - 第一次打开会弹出安全提示（未签名程序的正常现象，不是病毒），点「更多信息 → 仍要运行」即可，详见下方安全提示。
打开后会有一遍新手导览，跟着「下一步」走就行，随时可以跳过。
三种方式任选，可以混着用：
- 粘贴链接：在【仪表盘】的添加框里粘贴任意 Steam 商店链接（比如
https://store.steampowered.com/app/105600/），回车即可； - 登录 Steam 同步：到【设置】绑定 Steam 账号（支持账号密码直接登录，遇到手机验证码按提示输入即可），愿望单和已购游戏会自动进来；
- 从游戏卡片关注：逛【游戏商店】时，看到想长期盯价的游戏，点卡片右上角的星标即可。
到【价格提醒】页，建一条规则，比如「泰拉瑞亚 国区 ≤ ¥42 时通知我」。之后每当价格刷新，符合条件就会自动发邮件到你预留的邮箱。
到这里核心用法就完成了。接下来你什么都不用做——程序会自己定时更新价格、自己发现降价、自己发提醒。你随时打开看最新数据就行。
| 功能 | 说明（人话版） |
|---|---|
| 游戏商店 | 41 个国家/地区的价格一屏对比：当地标价、折扣、折算人民币、史低标记；可按折扣和锁区筛选 |
| 游戏详情 | 同一游戏的标准版/豪华版等多版本比价；每个区的历史价格走势曲线 |
| 价格提醒 | 降价、历史新低自动发邮件；阈值条件自己定 |
| 愿望单与已购 | 绑定 Steam 后自动同步，不用手动维护 |
| 家庭共享 | 家庭组成员的游戏库聚合分析：谁贡献了什么、值不值 |
| 账单 | Steam 消费记录同步，多币种按当日汇率折算成人民币 |
| 捆绑包 / 免费游戏 | Humble Choice 月包、Epic 喜加一、Steam 免费游戏动态，换新自动提示 |
| 活动日历 | Steam 官方大促（夏促/冬促）和新品游戏节的时间表与倒计时 |
| 汇率 | 39 种货币兑人民币走势，自带 2010 年至今的历史档案；卡商充值价目参考 |
| 工具箱 | 礼品卡 CDK 批量激活，逐码出回执 |
窗口顶部有一颗「灵动岛」胶囊，程序里值得你知道的事都会在那里冒出来，不需要你主动翻页面：
- 价格更新到哪了（正在更新 / 已更新 / 部分暂缺）；
- Humble Choice 月包换新了、Epic 喜加一轮换了；
- 有新版本可以更新了。
点开胶囊能看详情和进度，不需要知道任何内部机制。
Important
本应用发布包未经代码签名，首次运行会遇到三类安全提示，均为无签名程序的正常现象，不是病毒：
- Windows SmartScreen 弹窗（「Windows 已保护你的电脑」）：点 更多信息 → 仍要运行 即可。
- Windows Smart App Control 硬阻断（「此应用已被阻止」，没有「仍要运行」按钮）：这是 Windows 11 对未签名程序的强制拦截，不给放行按钮。先确认下载来自官方 Releases 页并核对 SHA256，确需运行则在「Windows 安全中心 → 应用和浏览器控制 → Smart App Control 设置」中关闭该功能（关闭后杀毒软件仍在保护）。
- 杀毒软件报毒 / 主动防御弹窗（如「正在创建 BITS 任务」）：选 允许 / 信任，不要阻止——阻止可能影响窗口渲染。建议把整个程序目录加入杀软白名单。
请只从官方 Releases 页下载，并用页内公布的 SHA256 校验安装包。
首次运行弹出「Windows 已保护你的电脑」？
Windows 对未签名程序的标准提示，与病毒无关。点 更多信息 → 仍要运行 即可，同一版本之后不会再弹。
弹出「此应用已被阻止」，而且没有「仍要运行」？
这是 Windows 11 的 Smart App Control 在拦截未签名程序，它比上面那条更严格——不给放行按钮。先确认安装包来自官方 Releases 页且 SHA256 一致，确需运行再在「Windows 安全中心 → 应用和浏览器控制 → Smart App Control 设置」里把它关掉（关掉后杀毒软件仍然在工作）。
杀毒软件报毒？
无签名程序常见误报；随包分发的代理内核（开源的 mihomo，见文末致谢）也常被标记。处置：把整个程序目录加入白名单，弹窗选「允许」。
登录 Steam 时收不到验证码 / 登录不上？
应用内登录走 Steam 官方认证接口。验证码分两种：邮箱验证码去邮箱收；手机令牌打开 Steam 手机 App 就能看到。输错可以重新输入；如果开启了手机 App 确认，直接在手机上点「确认」即可，程序会自动继续。密码只在本机内存里用一次，不会保存。
刚装好，部分游戏没有价格？
新加的游戏会尽快补齐首趟价格（你星标关注的排最前）；刚装好时的批量数据要逐步积累，等一轮更新周期走完就好。可以随时手动触发一轮。
价格和 Steam 商店页不一致？
价格每 6 小时自动刷新一轮，两轮之间的临时调价有滞后；每条价格都带抓取时间，卡片上能看到数据的新旧。
我的账号密码安全吗？数据存在哪？
账号密码登录走 Steam 官方接口，密码只在登录那一刻在内存里用一次，不落盘、不写日志；登录成功后的凭据加密存放在本机数据库里。全部数据（holdexar.db）都在你自己的电脑上（默认 %LOCALAPPDATA%\Holdexar，便携模式在程序目录 data/）。零云端、零遥测——除了 Steam 官方接口和你自备的代理订阅，不连接任何第三方服务。
不想让它自动抓价格？
【自动抓取】页关闭「自动价格更新」即可：定时刷新和自动重试会停，手动抓取不受影响，随时能再打开。
想要更稳的自动更新和更快的抓取？
到【网络】页接入你自己的 Clash 订阅（程序不内置任何订阅源）。这是可选项——不接入也能正常加游戏、看已有数据。
- 有新版本时启动会主动提示一次，侧栏「我」项常驻红点，顶栏出现更新胶囊（发现新版 / 下载中 / 待重启）；进【我 → 应用更新】一键升级。
- 换装只替换程序文件，用户数据、账号绑定、价格历史一概不动；换装中断会自动回滚到原版本并重新打开应用。
- 也可以手动下载新版解压覆盖，数据不受影响。
Scoop 渠道（便携应用，不写注册表、不装服务）：
scoop bucket add holdexar https://github.com/GLrone/scoop-bucket
scoop install holdexar每个版本 Release 附带三件资产：应用包 zip（解压即用）、公共数据种子 holdexar_seed.db（仅源码运行需要，发布包已内置）、更新清单 latest.json（客户端检查更新读取）。
| 层 | 组件 |
|---|---|
| 后端 | FastAPI · SQLAlchemy(async) · APScheduler(21 个定时任务) · aiohttp 爬核 |
| 前端 | Vue 3 · TypeScript · Vite · 自制 Hl* 组件体系(深浅双主题 / 中英双语) |
| 桌面 | pywebview(WebView2) · onedir 绿色包 · 单实例锁 |
| 网络 | 出网策略引擎(proxy_first 默认 / direct_only / direct_first / proxy_only) · 自备 Clash 订阅 · mihomo 内核随包内置 |
| 认证 | 应用内账号密码登录直调 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一行是一次观察；事件层（降价 / 史低 / 永降）在观察之上独立判定。
- 用户的输入边界是封闭清单（绑定账号 / 关注 / 添加订阅 / 添加游戏），此后的一切自动完成：订阅导入即体检、体检健康自动准入、出口漂移启动热收敛、重建空池自愈、数据整体过期自动提前首轮刷新。
- 停自动化走白名单：仅数据泄露 / 登录信息过期 / 订阅全失效会停下等用户，其余失败一律自动降级、重试、换通道。
要求 Python ≥3.13、Node ≥ 20.19(或 ≥ 22.12;Vite 8 的 engines 要求):
git clone https://github.com/GLrone/Holdexar.git
cd Holdexar
python run.py # 自动建 venv → 装依赖 → 构建前端 → 拉起桌面窗口python run.py --server # 仅本地服务,浏览器访问 http://127.0.0.1:28765
python run.py --dev # 对接 Vite 热更新开发
python run.py --port N # 指定端口首次运行会自动补齐公共数据种子(历史汇率与价格历史切片,约 288MB):种子是二进制大文件,不进 git,由 run.py 从 Release 资产拉取。没网也不影响启动,只是【汇率】页没有历史档案,之后重跑 python scripts/fetch_seed.py 即可。
随包的还有 Clash 内核(mihomo,版本固定)及其许可与来源说明:二进制不入库,由 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/publish_release.py --dry-run # 预览发布动作,不碰网络
python scripts/publish_release.py # 正式发布(需 gh CLI 且已 gh auth login)一次正式发布会产生两条 Release:
| Release | tag | 内容 | 作用 |
|---|---|---|---|
| 版本发布 | v<版本> |
zip + holdexar_seed.db + latest.json |
给用户下载的那一条,带 changelog |
| 更新清单 | updater |
只有 latest.json |
机器读的那一条,地址恒定 |
要点:
- 清单 Release 必须不是 Latest release(
gh release create ... --latest=false,脚本已处理)。否则releases/latest与 RSS 会被带偏,源码用户取种子会失效。 - 资产名固定为
Holdexar-win64-v<版本>.zip(不带时间戳),渠道自动跟进(Scoop 的checkver/autoupdate)才能按版本号拼出 URL。 - tag 已存在时脚本改走
gh release upload --clobber,重复发布会覆盖资产而非失败。 - 客户端检查链:清单(镜像链)→ 失败回落 GitHub API。没发过时功能照常,只是享受不到免限速与内置 SHA256。
没装 gh:--dry-run 仍可打印全部命令;脚本还会给出网页端手工创建的照抄清单。
Holdexar/
├── 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 = 页面)
欢迎提 Issue 与 PR，也欢迎 fork 后按自己的需求改造。
- 克隆仓库，启用提交门禁：
git config core.hooksPath .githooks - 后端：Python ≥ 3.13，依赖与启动见上文【源码运行】（
run.py自动建 venv 装依赖） - 前端：Node ≥ 20.19（或 ≥ 22.12），
cd web && npm install
| 环节 | 命令 |
|---|---|
| 联调开发 | python run.py --dev（对接 Vite 热更新） |
| 仅起后端 | python run.py --server，浏览器访问 http://127.0.0.1:28765 |
| 后端选测 | python scripts/test_select.py --run（按导入关系自动圈定受影响测试） |
| 推送前冒烟 | python scripts/test_select.py --smoke --run |
| 后端全量 | cd server && python -m pytest（归发布门，日常不必跑） |
| 前端检查 | cd web && npm run lint、npm run test |
| 出包发布 | 见上文【打包与发布】 |
- 一个提交只做一件事；提交信息一句话功能概述，单行，不加正文
- pre-commit 会自动跑七道门禁：敏感面扫描、注释留痕、写路径审计、前端 lint、路由完整性、双语词典、旗帜素材。任何一项未过先修内容，禁止
--no-verify绕行 - 数据库写入统一走全局写调度器（write_gate），例外需先登记；前端新代码一律使用 Hl* 组件体系，不直连 Element Plus
- PR 聚焦单一功能面，正文写清做了什么、怎么验证的（测试或实测结果）
| 定制项 | 位置 |
|---|---|
| 区服列表（增删国家） | 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/（token 化，深浅主题各一套） |
- mihomo — Clash 代理内核（随包分发，GPL-3.0）