文档

快速开始

VisaLark 的数据面（浏览器扩展或本地 Agent）跑在你自己的住宅网络上，复用你已登录的签证网站会话。四步即可运行：

1. 在 Chrome / Edge 安装 VisaLark 扩展（从 Releases 下载 .zip 并加载，或等待商店上架）。
2. 在同一个浏览器里像平时一样登录 usvisa-info——VisaLark 不会替你保存密码。
3. 打开扩展面板，新建一个监控：选择领馆（可多选）、签证类型、可接受日期范围、星期与时段过滤。
4. 配置通知渠道（Bark / Server酱 / Telegram / Webhook），选择预约模式（默认“仅通知”），保存即开始监控。

安全模型

美国签证系统运行按用户行为 ML，叠加 Cloudflare 与 reCAPTCHA。最致命的封号信号不是轮询频率，而是 ASN / 不可能旅行 不匹配。

为什么数据面必须跑在你的住宅网络

如果你从中国住宅 IP 登录，同一会话却从云数据中心 IP 拉取名额接口，这就是教科书式的账号盗用特征，会导致真实签证账号被快速停用。因此所有触碰 usvisa-info 的代码都只在你登录的地方运行——绝不在云服务器上轮询。

零凭据与零绕过

• 默认只用 Cookie / 会话复用，不存签证密码；控制面完全不接触凭据。
• 仓库内没有代理轮换、指纹伪造、验证码破解、TLS 伪装等任何绕过代码——这既是账号护盾也是法律护盾。
• 遇到 Turnstile / 401 / 403 / 1015 / 验证码，一律停止并通知你，绝不硬闯。

预约模式与自动改签联锁

每个监控可独立选择三种模式之一：

• 仅通知（notify）：发现名额只推送，由你手动预约。风险最低。
• 一键确认（confirm，默认头牌）：推送带一键按钮，点击后用热会话在 1 秒内完成改签。人始终在环内。
• 自动改签（auto）：默认关闭，满足联锁条件时无人值守自动改签。风险高。

auto 模式的联锁（开启时强制生效）

• 严格更优：仅当新日期早于当前日期（可配置最小提前量，如 ≥7 天）且领馆在白名单内、且匹配日期/星期/时段过滤时才改签。
• 绝不盲目放弃：usvisa-info 改签会替换现有预约，前 N 次（confirmFirstN，默认 1）即使在 auto 模式也需人工确认。
• 幂等锁：防止重复提交 / 重复预约。
• 每日预约上限 + 全局急停开关 + 试运行（dry-run）模式。

通知渠道

VisaLark 大陆优先、多渠道、冗余推送。高优先级名额事件会同时扇出到所有已配置渠道，单个渠道挂掉不会吞掉名额提醒。

• Bark（iOS）：大陆可达，高优先级使用 time-sensitive 中断级别 + 警报声。
• Server酱 / 微信：大陆可达，自动适配 SCT / SCTP key。
• Telegram：海外 / 技术选项，大陆需代理。
• Webhook：覆盖企业微信机器人 / Discord / Slack / 自定义中转。

自托管控制面（可选）

控制面是可选的便利组件，持有零签证凭据、永不触碰 usvisa-info。它提供跨设备的可约历史、日历热力图与“最佳查询时段”，以及一个通知中转（让渠道密钥留在你的服务器而非页面里）。推荐部署在 Oracle Cloud 永久免费 VM。

一行安装

curl -fsSL https://raw.githubusercontent.com/appleweiping/visa-lark/main/apps/control-plane/install.sh | bash

脚本会在缺失时安装 Docker，提示你输入（或自动生成）DASHBOARD_TOKEN，运行 docker compose，等待健康检查并打印 URL。

推荐入口：Cloudflare Tunnel

不要直接对公网开放 8787 端口。使用 Cloudflare Tunnel——无需开放入站端口、免费 TLS、隐藏 VM 真实 IP。docker-compose.yml 中已附带 cloudflared 服务模板。

常见问题 FAQ

它能保证我抢到最热门领馆的名额吗？

不能，我们也不会这么承诺。30 秒内抢到最火爆名额只能靠付费住宅代理 IP 舰队，而那会让账号被封。VisaLark 提高你的整体命中率、捕捉你本会错过的释放，且不拿账号冒险。

需要我提供签证账号密码吗？

不需要。默认只复用你浏览器里已登录的会话。我们绝不要求、也不存储签证密码。

可以跑在云服务器上 24 小时监控吗？

数据面不行——云 IP 轮询是最危险的封号信号。本地 Agent 适合跑在你家里的电脑或树莓派上（住宅网络）。只有零凭据的控制面可以上云。

支持哪些领馆？

内置覆盖中国（北京/成都/广州/上海/沈阳/武汉）、香港、东京、大阪、首尔、新加坡等常见领馆，你也可以在 UI 里自行添加 facility id。