它解决什么问题(主要针对南昌文旅一卡通需预约的门票抢票)
需要按放票时间点操作多个平台、多个账号时,人工反复刷新与切换窗口既容易错过时间,也不便回看每次执行结果。本软件把这些动作收敛成一个本地网页控制台:你负责配置规则与确认结果,到点触发与状态记录交给程序完成。
软件不代管账号、不代抢、不托管运行:所有操作都在你自己的电脑、用你自己的登录态发起,数据只落在本机。
核心功能
| 模块 | 功能 |
|---|---|
| 任务管理 | 新建/编辑/停用/删除任务;按平台选择目标,填写名称、景区、日期、触发时间、平台业务参数;「立即运行一次」无需等到点即可验证 |
| 精确调度 | 到点触发;支持「仅一次」与「每天」重复;远期任务采用扫描逼近,避免定时器溢出导致误触发;状态分为待命/已排程/执行中/成功/失败/错过 |
| 执行引擎 | 多路并发、失败自动重试、首次成功即停(避免重复提交);多账号各自独立执行,互不阻塞 |
| 实时日志 | 右侧日志区实时输出每次执行的过程与结果,可一键清空 |
| 账号管理 | 独立页面,按平台分组;显示登录态有效性、备注名、平台标签;支持添加、校验、删除、一键重登/原地更新登录态;各平台页面顶部实时联动「有效登录数」 |
| 年卡与景区 | 南昌文旅一卡通账号自动检测有效期内年卡,过期卡单独标记不参与任务;支持手动「扫描可预约景区」与启动时/每 6 小时自动扫描,发现新增景点自动写回清单 |
| 多平台适配 | 内置南昌文旅一卡通、大麦、猫眼、12306、江西省博物馆、H5 浏览器自动化、模拟模式等适配入口;后四者以配置模板方式提供,接口与参数由使用者自行填写 |
| 大麦相关(可选) | 本机浏览器辅助的扫码/密码登录、登录后识别昵称与手机尾号、按项目 ID 或关键词识别活动、活动列表管理、观演人预填、开售时间蹲守、下单与支付二维码实时呈现、支付成功自动回写状态 |
| 模拟模式 | 不发任何真实请求,默认成功;可调失败率用于验证重试链路,是首次上手的推荐入口 |
| 授权管理 | 页面顶部状态条、激活弹窗、令牌刷新、清除授权;支持申请试用入口 |
| 一键启停 | start_server.bat 启动(等待端口真正响应后自动开浏览器),stop_server.bat 停止 |
技术特点
- 零第三方依赖的基础功能:核心服务用 Node.js 内置模块编写,解压后不装依赖也能运行任务调度、状态监测与页面;仅大麦浏览器相关功能需要
playwright。 - 授权离线可用:激活后服务端下发的到期时间保存在本机,放行以「是否在有效期内」为唯一主判据,与断网时长无关;网络故障、令牌过期、请求限流都视为临时状态,恢复联网后自动核实并解封,不会要求重新激活。只有服务端明确禁用、授权到期,才需要重新处理。
- 本地化存储:任务、日志、账号、授权状态均为本机 JSON 文件,便于备份与迁移;软件不收集、不回传业务数据。
- 凭据外置:发布包内不含任何真实密钥或登录态,授权配置由使用者自己填写,从根上避免凭据随软件扩散。
- 演练优先:支持模拟模式与部分适配器的
dryRun演练,先核对参数再决定是否发起真实请求。
界面与交互
顶部为导航栏:账号管理 + 各平台独立标签页;切换平台时,任务表单与账号下拉自动按平台过滤。主界面左侧是「新建预约任务」表单,中间是任务列表(含状态徽标与操作按钮),右侧是实时日志。账号管理页集中展示各平台账号、有效卡数、登录态检测结果与重登入口。
建议配图:① 主控制台(任务列表 + 实时日志);② 账号管理页;③ 某平台标签页下的任务表单;④ 顶部授权状态条。截图时请自行遮住账号、备注名、手机号等个人信息后再发布。
发布包里「没有」什么(透明说明)
- 没有任何真实平台账号、Cookie、登录态、抓包数据或运行日志;
- 没有 AppKey、clientSecret、授权码、私钥等任何密钥,需使用者自行填写;
- 没有浏览器内核(Playwright/Chromium 需按需安装);
- 没有云端业务服务、没有数据回传,也没有内置任何第三方票务平台的接口地址或现成业务数据;各平台接口与参数由使用者按随包模板自行配置(授权服务地址属于授权配置项,见
config\auth.json)。
更新日志
V1.0.0 · 2026-11-15(首个公开发布版)
本版本为脱敏后的首个可分发版本,与 jingquyuyue-release-v1.0.zip 对应。
新增
- 软件授权体系:授权码激活、硬件指纹绑定、在线心跳、令牌刷新、申请试用入口,以及页面顶部授权状态条与激活弹窗。
- 离线可用策略:以服务端到期时间为准判定授权有效性;断网期间持续放行,恢复联网自动核实,无需重新激活;心跳加入指数退避重试,服务端恢复后自动解封。
- 一键启动/停止脚本:启动脚本会做真实 HTTP 就绪探测,等服务真正响应后自动打开
http://127.0.0.1:3000;停止脚本一键释放 3000 端口。 - 脱敏发布包:白名单收集运行所需文件,出包前对全部文件做凭据与个人信息扫描,零命中才允许生成;发布包内配置均为空白模板。
修复
- 修复「长期断网后被判定为未授权、被迫重新激活」:原逻辑以「距上次在线是否超过固定小时数」作为放行判据,且网络故障后会持久化停用标记并停止重试。现改为以授权到期时间为唯一主判据,网络类故障一律视为临时状态。
- 修复一键启动脚本在中文 Windows 上的多类闪退(文件编码、
if/for块内括号、变量展开污染块结构),以及浏览器打开localhost被解析为 IPv6 导致页面打不开、端口被僵死进程占用却盲目开浏览器等问题。 - 修复扫码登录手机确认后不显示已登录、活动识别请求无限等待、识别结果错误显示「未知」等交互问题。
优化
- 真实密钥外置到本机独立文件,发布配置的密钥字段全部留空;本机已激活状态不受影响。
- 前端状态条区分「未激活」与「已激活但暂时离线」,后者不再弹出激活窗,业务功能照常可用。
历史迭代记录(V1.0.0 之前)
- 2026-11-13:接入自建授权系统(签名、RSA 分段加密、设备指纹、心跳与门禁);完成密钥外置与首批脱敏发布包。
- 2026-10-09:新增一键启动与停止脚本,随后连续修复闪退、编码、IPv6、端口探测等启动链路问题。
- 2026-08-31:修复扫码登录「手机确认后无反应 / 不显示已登录」,补充登录态判定兜底。
- 2026-08-30:平台模块化重构——账号管理独立成页、各平台独立标签页、登录态联动横幅;新增活动识别与管理、开售时间蹲守、下单与支付二维码实时呈现、支付成功自动回写、实名观演人预填、登录后识别昵称与手机尾号;修复填项目 ID 仍识别不出活动的问题。
- 2026-08-28:新增本机浏览器辅助的扫码/密码登录与滑块处理;登录态改用真实用户态接口校验;活动识别改为拦截页面自身响应,规避设备签名限制;修复账号被误报「已过期」。
- 2026-08-27:接入真实预约流程;重构为多账号架构;新增年卡有效性检测、可预约景区同步、本机微信登录态自动检测与定时存活监测。
- 2026-08-26:项目建立——毫秒级调度器、并发与重试引擎、任务持久化、实时日志、模拟模式,以及抓包与配置说明文档。
说明:以上为对外公开的功能级变更记录,不含内部开发、测试与材料准备事项。版本号以发布包为准,历史条目为迭代里程碑,不代表单独发行版本。
使用教程
环境准备
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10 / 11(脚本为 .bat + .ps1) |
| Node.js | ≥ 18,需已加入系统 PATH。可在命令行执行 node -v 确认 |
| 浏览器 | Chrome / Edge 等现代浏览器,用于打开本地控制台 |
| 可选依赖 | 仅大麦浏览器登录、活动识别、下单等功能需要 playwright 与 Chromium 内核 |
基础功能(任务调度、状态监测、账号管理、页面)不需要 npm install。
解压
将 jingquyuyue-release-v1.0.zip 解压到一个不含中文与空格的目录(例如 D:\jingquyuyue)。解压后应保持目录结构完整:server.js、src\、public\、config\、data\ 与三个启动脚本在同一层。
授权配置(首次必做)
发布包不含任何真实密钥,请先在 config\ 目录新建 auth.local.json:
{
"appKey": "<你的 AppKey>",
"clientSecret": "<你的 clientSecret>",
"authCode": "<你的授权码>",
"fallbackPublicKey": ""
}
可参考同目录的 auth.local.example.json。config\auth.json 只保留行为配置(开关、心跳间隔、超时等),运行时会用 auth.local.json 中的同名字段覆盖。
没有 AppKey / clientSecret / 授权码?请联系发布者获取,或在激活弹窗点「申请试用」。
请勿把填好密钥的auth.local.json随软件一起转发或上传。
启动与停止
- 双击
start_server.bat。脚本会检查 Node.js、检查 3000 端口,另开一个名为JingQuYuYue-Server的服务窗口。 - 脚本轮询探测服务是否真正返回响应(最多约 45 秒),就绪后自动打开
http://127.0.0.1:3000。 - 使用期间保持服务窗口开启。停止时双击
stop_server.bat,或在该窗口按Ctrl+C。
请始终使用
127.0.0.1而不是localhost访问,避免部分系统把localhost解析为 IPv6 导致连接被拒。
也可手动启动:在项目目录执行 node server.js,然后浏览器打开上述地址。
首次激活
打开页面后会弹出「软件授权」窗口(这是预期行为,未激活时业务接口会被拦住):
- 在「授权码」栏填入你的授权码 → 点「立即激活」。
- 激活会绑定本机硬件指纹,请在你要长期使用的那台电脑上完成。
- 成功后顶部状态条显示「授权有效」;页面自动进入主界面。
其他按钮:「申请试用」用于申请试用授权;「刷新令牌」手动刷新访问令牌;「清除授权」会清除本机授权状态(需重新激活,请谨慎)。
用模拟模式跑通第一个任务(强烈建议先做)
- 在顶部切换到 模拟(mock) 标签页(或新建任务时平台选「模拟」)。
- 左侧「新建预约任务」填写任务名称,选择景区、日期与触发时间,重复方式选「仅一次」。
- 点「创建任务」,任务状态变为「已排程」。
- 不用等到点:在任务列表点「立即抢一次」,右侧实时日志会输出执行过程与结果。
- 想验证失败重试,可编辑
config\mock.json调整failureRate,再运行一次。 - 把触发时间设成几分钟后,观察调度器到点自动触发。
模拟模式不会发送任何真实请求,是熟悉流程最安全的方式。
配置平台账号
- 点顶部「账号管理」进入独立页面。
- 在「添加新账号」选择平台,填写备注名与
SESSION / Cookie登录态 → 点「添加账号」(保存前会先校验登录态)。 - 账号列表会显示平台标签、登录态有效性;对支持自动检测的平台,还会显示有效卡数量。
- 登录态过期时,用对应账号的「重登 / 更新登录态」入口原地更新,不会新建账号、也不会让已有任务的账号引用失效。
- 各平台页面顶部会实时显示「当前有效登录数」,没有有效账号时请先回到账号管理补齐。
各平台的
config\<平台>.json中,accounts数组与会话模板默认是空的,请按随包的*.example.json模板填写。登录态属于个人敏感凭据,请勿公开、勿转发。
接入真实平台(按需)
- 参考
config\nanchang.example.json等模板,把接口地址、请求头、请求体模板、成功判定规则填入对应配置文件,并将enabled设为true。 - 在任务表单选择对应平台,填写「平台业务参数」JSON(例如场次、票档、数量等字段)。
- 建议先用演练/模拟核对参数,再启用真实任务;部分适配器支持在参数中加
"dryRun": true,只打印将要发出的请求而不真正提交。 - 任务创建后可设「每天」循环;引擎支持并发数、重试次数与重试间隔等高级参数。
不同平台的接口、字段与风控策略会变化,需要使用者自行核对并按平台规则调整。软件不内置任何平台接口地址或可直接使用的数据。
大麦相关功能(可选,需额外依赖)
在项目目录执行一次:
npm install
npx playwright install chromium
若本机已装 Chrome / Edge,可在 config\damai.json 的 browser.executablePath 指定浏览器路径以跳过内核下载。
- 登录:账号管理页展开「大麦网一键登录」→「扫码登录」用手机 App 扫码并确认,或填账号密码登录;遇到滑块/短信验证时,在弹出的浏览器窗口中手动完成。登录成功后会自动读取完整登录态写入账号,并显示昵称与手机尾号。
- 识别活动:在「大麦活动识别」填项目 ID(推荐)或关键词 → 点「识别活动」。程序会打开本机浏览器读取页面信息,识别结果加入「已识别活动」列表。
- 开售蹲守:在活动卡上填写开售时间并勾选自动蹲守 → 保存,到点自动触发下单流程。
- 下单与支付:下单过程中支付二维码会实时显示在页面上,请用手机自行扫码完成付款;支付成功后状态会自动回写为「已抢到」。
- 观演人:可在「大麦账号观演人」中预先填写实名信息,供下单时选用。
页面结构变化时,下单流程的选择器可能需要现场调整;请使用者在放票时间点本人在场辅助操作。
离线使用
激活成功后,服务端下发的授权到期时间会保存在本机 data\auth_state.json。此后:
- 断网多久都可以继续使用,只要本机记录的到期时间未过;顶部状态条会显示「授权有效 · 暂离线,恢复联网后自动核实,无需重新激活」。
- 恢复联网后心跳会自动向服务器核实、校准到期时间并清除离线标记,全程不需要重新激活。
- 只有三种情况需要处理授权:服务端明确禁用、服务端判定授权过期、本机记录的到期时间已过。
- 网络故障、令牌过期(会自动刷新)、请求限流、服务器 5xx 都不会导致停用。
常见问题
| 现象 | 处理 |
|---|---|
| 双击启动脚本窗口一闪而过 | 保持窗口查看提示(脚本各分支都会停留);常见原因是 Node.js 未安装或未加入 PATH。执行 node -v 确认 |
| 浏览器弹出但网页打不开 | 用 http://127.0.0.1:3000 访问;若 3000 端口被上次残留进程占用,先双击 stop_server.bat 再启动 |
| 页面一直提示「未授权」 | 检查 config\auth.local.json 是否已创建且字段填写正确;首次使用需在弹窗中完成激活 |
| 提示「缺少 app_key 参数」 | 说明密钥未配置,按 4.3 填写 auth.local.json |
| 授权服务器暂时连不上 | 在有效期内不影响使用,无需操作;恢复联网后自动核实。配置层面的应急开关见随包 README_RELEASE.md |
| 活动识别一直转圈 / 提示超时 | 多为未安装浏览器内核或页面加载过慢;执行 npx playwright install chromium,并确认本机浏览器能正常打开目标站点 |
| 账号显示「已过期」或卡数为 0 | 用「重登 / 更新登录态」更新;南昌账号可点「检测年卡」重新拉取有效卡 |
| 想换一台电脑使用 | 授权绑定本机硬件指纹,换机需按发布者的授权流程重新处理;请勿直接复制 auth_state.json |
| 任务到点没触发 | 确认任务处于「启用」、状态为「已排程」、服务窗口未被关闭,且触发时间晚于当前时间 |
合规与免责声明
- 本软件定位为本地运行的票务状态监测与到点预约管理辅助工具,仅供个人学习、研究与本人合法权益范围内的自用。
- 自动化操作可能违反目标平台的服务条款,部分平台设有滑块、设备指纹、频率限制等风控措施,可能出现拦截、失败或账号限制,相关风险由使用者自行承担。
- 不得用于商业代抢、批量注册、加价转售、干扰平台正常运行等违规行为;请务必遵守目标平台规则与适用法律法规。
- 实名核验、人脸核销、支付等环节仍需本人到场完成,软件不能替代。
- 发布包不含任何第三方账号、登录态、密钥、个人信息或抓包数据;使用者自行填入的凭据由使用者自行保管。
- 软件按「现状」提供,作者不对使用效果、平台规则变化或由此产生的任何损失作保证或承担责任。
下载地址
https://cdn.hyclive.cn/dixunblog/softs/jingquyuyue-release-v1.0.zip
