Tickets Hunter关键字匹配与回退机制深度解析：如何精准锁定心仪场次与票区-平芜编程栈

RPA
浏览器控制

【免费下载链接】tickets_hunter

Tickets Hunter (獵票機器人) - automated ticket purchasing. 科技決定你搶票的速度！ Previously named tixcraft_bot

项目地址：https://gitcode.com/gh_mirrors/ti/tickets_hunter

Tickets Hunter 是一款开源的多平台抢票自动化系统（原名 tixcraft_bot），支持 TixCraft、KKTIX、ibon、TicketPlus 等众多票务平台。它的核心卖点之一就是关键字匹配与自动回退机制：你只需填写部分文字（如11/16、搖滾A），程序就会自动在抢票页面中找到并点击对应场次与票区；当关键字失效时，还能按你设定的回退策略自动兜底。本文带你完整看懂这套机制，从新手入门到进阶技巧一次讲透。

🎯 什么是「关键字匹配」？

关键字匹配是 Tickets Hunter 自动选择日期、区域、票种的核心方式。你不需要输入与页面完全一致的文字，只需提供部分文字，程序会在所有可选项中查找包含该文字的条目。

举个例子：

网站页面显示	你填写的关键字	能否匹配
`2024/11/16 (六) 19:30`	`11/16`	✅
`2024/11/16 (六) 19:30`	`週六`	✅
`2024/11/16 (六) 19:30`	`19:30`	✅

💡 只要关键字是页面文字的「子串」就能命中，无需完全一致。

这套匹配逻辑统一作用于三个环节：

日期选择—— 锁定演出场次
区域选择—— 锁定票区/座位
票种选择—— 锁定票种（如全票、福利券）

🔄 三层回退机制：关键字失效后会发生什么？

这是整个机制中最值得理解的部分。当关键字匹配失败时，程序不会直接崩溃，而是按三层回退逐级处理：

第 1 层：尝试关键字匹配 ↓ 找不到 第 2 层：使用排序方式自动选择（正序 / 倒序 / 取中间 / 随机） ↓ 仍无法选择（或你关闭了自动递补） 第 3 层：暂停等待，持续刷新寻找指定关键字，或等待手动操作

其中第 2 层是否生效，由两个关键设置控制：

设置项	默认值	作用
`date_auto_fallback`（日期自动递补）	关闭	日期关键字全部失败时，是否自动按排序方式选一个
`area_auto_fallback`（区域自动递补）	关闭	区域关键字全部失败时，是否自动按排序方式选一个

严格模式 vs 自动递补模式

模式	关键字全部失败时的行为	适合人群
严格模式（默认）	停止执行，持续刷新寻找指定关键字，等待手动介入	新手，避免误购不想要的场次
自动递补模式	自动按「排序方式」挑一个可用选项继续抢	老手，追求更高成功率

⚠️ 默认关闭自动递补，是官方刻意的设计——宁可停下等你的指令，也不买错票。

📅 日期关键字机制：如何锁定心仪场次

多组关键字：分号 = OR 逻辑（按顺序尝试）

多个关键字用分号分隔，程序会依序尝试，第一个命中就立即停止：

日期关键字：11/16;11/17;週六 执行过程： 1️⃣ 先找 "11/16" → 找到？✅ 直接选择，停止！ 2️⃣ 没找到 → 再找 "11/17" → 找到？✅ 选择，停止！ 3️⃣ 还没找到 → 再找 "週六" → 找到？✅ 选择，停止！ 4️⃣ 全部失败 → 触发回退策略（按你的 auto_fallback 设置决定）

核心原则：关键字顺序决定优先级，最想要的必须放最前面！

空格 = AND 逻辑（同一组内）

同一组关键字内部用空格分隔，表示必须同时包含才算匹配：

日期关键字：週六 19:30

意思是：选项必须同时包含「週六」和「19:30」才会被选中，精准锁定周六晚场。

进阶组合示例

场景	日期关键字写法	效果
指定晚场	`19:30;晚上`	优先选择晚上场次
指定周末	`週六;週日`	优先选择周末场次
由具体到模糊	`11/16 19:30;11/16;週六`	最优先精确场次，逐步放宽

⚠️ 常见错误写法：週六;11/16;11/16 19:30（由模糊到具体）。一旦找到任何「週六」就会选中，可能抢到不想要的 11/17 周六场。正确顺序应由具体到模糊。

日期选择的完整技术实现可以参考文档 04-date-selection.md，其中详细说明了 Early Return Pattern（早期返回模式）如何驱动关键字优先比对。

🪑 区域关键字机制：如何锁定心仪票区

区域选择流程比日期多了一步——先套用排除关键字：

1. 进入选位页面，读取所有区域选项 2. 先过滤：排除关键字命中的区域（如「輪椅」「身障」「視線不良」） 3. 关键字匹配：依序尝试你的区域关键字，命中即停 4. 全部失败 → 触发区域回退策略

建议的排除关键字组合

强烈建议设置，避免误选需要特殊资格或视线受阻的区域：

排除關鍵字：輪椅;身障;身心;障礙;Restricted View;燈柱遮蔽;視線不完整

排除关键字是全局共享的一份清单，日期、区域、票种三个阶段都会套用同一份设置。注意跨阶段误伤：某个词若同时出现在你想要的区域和不想要的票种名里，排除会两边同时生效。

用票价选区域的坑：逗号是千位分隔符

不同页面的金额格式可能不一致（TixCraft 等平台尤其明显）：

页面	显示示例	格式
区域选择页	`B2層特A5區6980`	无千位分隔符
票种选择页	`全票 6,980`	有千位分隔符（逗号）

如果只填6980，区域能选中但票种页匹配失败。解决方案是两种格式都写上：

區域關鍵字：6980;6,980

⚠️ 逗号是价格的一部分，分号才是关键字分隔符，别写反了。

区域关键字实战技巧

技巧	写法	说明
精确区网域名	`搖滾A區`	加「區」字，避免误中「搖滾A排」
位置关键字	`前排;中央`	优先前排或中央区域
空格 AND 逻辑	`搖滾A 前排`	必须同时包含「搖滾A」和「前排」
多组 OR 逻辑	`搖滾A 3,280;搖滾B 2,680`	先试第一组，失败再试第二组

区域选择的实现细节可参阅 05-area-selection.md。

🎟️ 票种关键字的隐藏规则：沿用区域设置

这是最容易踩坑的一点：票种选择没有独立的设置栏位，它直接沿用你在「区域」里填写的三个设置：

你填的栏位	在票种页的作用
区域关键字	用来比对票种名称
排除关键字	用来跳过不要的票种
区域自动递补	关键字全失败时是否自动挑一个

陷阱一：票种名互为主子串。「全票」是「全票+福利券」的子串，只填全票时两个票种都算命中，程序会选到排在前面的福利券版本。要区分互相包含的票种名，必须靠排除关键字。

陷阱二：排除关键字是照字面比对。画面上写「福利券」就填「福利券」，填「福利票」不会生效。

正确姿势（以购买纯全票为例）：

區域關鍵字：全票 排除關鍵字：（原有的）;福利券

如果所有票种都被排除，程序不会硬选一个，而是不选择、刷新页面、继续等待。若发现程序在票种页反复刷新，先检查排除关键字是否把所有票种都覆盖了。

🧭 四种排序模式：回退时怎么选？

当自动递补开启（或你压根没填关键字）时，程序按「排序方式」挑选，共四种：

模式	行为	日期场景	区域场景
正序	选第一个	最早场次	通常是最贵/最好的位置（网站常把贵的放前面）
倒序	选最后一个	最晚场次	最便宜/最后面的位置
取中间	选中间选项	居中	平衡策略，不贵不便宜
随机变化	随机选一个	不可预测	分散风险，多人抢票时避免冲突

示例（正序选区域）：

可用选项： 1. VIP区 $3880 2. 搖滾A區 $2280 3. 搖滾B區 $1980 → 正序选择：VIP区 $3880

🛠️ 实战设置方案：按需求组合开关

你的情况	日期自动递补	区域自动递补
只想要特定日期和区域	关闭	关闭
日期可以妥协，区域要特定	开启	关闭
日期要特定，区域可以妥协	关闭	开启
日期和区域都可以接受	开启	开启

一个典型场景：你只想要 11/16，但开抢时 11/16 已售完——

设置	结果
日期自动递补关闭	停止执行，持续刷新等待 11/16，由你决定怎么办
日期自动递补开启	自动选择第一个可用日期（可能是 11/15 或 11/17）⚠️ 有买错风险

新手建议：保持默认「关闭」，确认关键字设置无误后，再视情况开启自动递补。

这些字段都可以在图形界面的设置页中配置，对应界面文件见 settings.html，完整字段说明请查阅 settings-guide.md。

❓ 常见问题速查

Q1：关键字需要和页面文字完全一样吗？不需要，只要页面文字包含你的关键字即可。

Q2：多组关键字到底是 AND 还是 OR？分号分隔的多组之间是OR（依序尝试）；同一组内空格分隔的词是AND（必须全部包含）。

Q3：关键字打错了怎么办？取决于自动递补设置：关闭时程序会暂停刷新等待（安全）；开启时会按排序方式自动选一个（可能买错）。建议第一次使用先保持关闭。

Q4：排除关键字可以作用于日期吗？可以。排除关键字是全局清单，日期、区域、票种三阶段共用。

Q5：能看到关键字比对过程吗？可以。在「进阶设置」中开启详细调试信息输出，你会看到类似日志：

[DATE KEYWORD] Trying keyword: "11/16" [DATE KEYWORD] Match found! Total: 1 [DATE SELECT] Selected: 2024/11/16 (六) 19:30 [AREA KEYWORD] Trying keyword: "搖滾A" [AREA SELECT] Selected: 搖滾A區 $2280

调试日志的详细规范见 debug-logger-spec.md。

Q6：KKTIX 票券显示「尚未开卖」会怎样？系统会先做关键字比对，命中但尚未开卖的票券会被标记追踪，并自动刷新页面直到开卖——避免你误以为关键字设置错误。