@danceiny/gotry 0.0.1-rc.17 → 0.0.1-rc.19

package/dist/capabilities/session/adapters/rail-12306.js

@@ -0,0 +1,285 @@
+export const STATION_TELECODES = {
+    "三亚": 'SEQ',
+    "上海": 'SHH',
+    "上饶": 'SRG',
+    "东莞": 'RTQ',
+    "中卫": 'ZWJ',
+    "中山": 'ZSQ',
+    "丽江": 'LHM',
+    "乌鲁木齐": 'WAR',
+    "乐山": 'IVW',
+    "九江": 'JJG',
+    "伊宁": 'YMR',
+    "佛山": 'FSQ',
+    "保山": 'BAM',
+    "六盘水": 'UMW',
+    "兰州": 'LZJ',
+    "包头": 'BTC',
+    "北京": 'BJP',
+    "北海": 'BHZ',
+    "十堰": 'SNN',
+    "南京": 'NJH',
+    "南充": 'NCW',
+    "南宁": 'NNZ',
+    "南昌": 'NCG',
+    "南通": 'NUH',
+    "南阳": 'NFF',
+    "厦门": 'XMS',
+    "台州": 'TEU',
+    "合肥": 'HFH',
+    "吉林": 'JLL',
+    "吐鲁番": 'TFR',
+    "呼和浩特": 'HHC',
+    "咸阳": 'XYY',
+    "哈密": 'HMR',
+    "哈尔滨": 'HBB',
+    "喀什": 'KSR',
+    "嘉兴": 'JXH',
+    "嘉峪关": 'JGJ',
+    "大同": 'DTV',
+    "大庆": 'DZX',
+    "大理": 'DKM',
+    "大连": 'DLT',
+    "天水": 'TSJ',
+    "天津": 'TJP',
+    "太原": 'TYV',
+    "宁波": 'NGH',
+    "安顺": 'ASW',
+    "宜宾": 'YKE',
+    "宜昌": 'YCN',
+    "宝鸡": 'BJY',
+    "岳阳": 'YYQ',
+    "常州": 'CZH',
+    "常德": 'VGQ',
+    "广州": 'GZQ',
+    "库尔勒": 'KLR',
+    "延安": 'YWY',
+    "开封": 'KFF',
+    "张掖": 'ZYJ',
+    "徐州": 'XCH',
+    "德阳": 'DYW',
+    "惠州": 'HCQ',
+    "成都": 'CDW',
+    "扬州": 'YLH',
+    "承德": 'CDP',
+    "抚顺": 'FET',
+    "拉萨": 'LSO',
+    "揭阳": 'JYA',
+    "新乡": 'XXF',
+    "无锡": 'WGH',
+    "日喀则": 'RKO',
+    "昆明": 'KMM',
+    "普洱": 'PEM',
+    "景德镇": 'JCG',
+    "曲靖": 'QJM',
+    "杭州": 'HZH',
+    "林芝": 'LZO',
+    "柳州": 'LZZ',
+    "株洲": 'ZZQ',
+    "格尔木": 'GRO',
+    "桂林": 'GLZ',
+    "梧州": 'WZZ',
+    "武汉": 'WHN',
+    "汉中": 'HOY',
+    "汕头": 'OTQ',
+    "沈阳": 'SYT',
+    "泉州": 'QYS',
+    "泸州": 'LUE',
+    "洛阳": 'LYF',
+    "济南": 'JNK',
+    "深圳": 'SZQ',
+    "温州": 'RZH',
+    "湛江": 'ZJZ',
+    "漳州": 'ZUS',
+    "潮州": 'CKQ',
+    "牡丹江": 'MDB',
+    "珠海": 'ZHQ',
+    "盐城": 'AFH',
+    "石家庄": 'SJP',
+    "福州": 'FZS',
+    "秦皇岛": 'QTP',
+    "绍兴": 'SOH',
+    "绵阳": 'MYW',
+    "芜湖": 'WHH',
+    "苏州": 'SZH',
+    "茂名": 'MDQ',
+    "莆田": 'PTS',
+    "衡阳": 'HYQ',
+    "襄阳": 'XFN',
+    "西宁": 'XNO',
+    "西安": 'XAY',
+    "西昌": 'ECW',
+    "贵阳": 'GIW',
+    "赣州": 'GZG',
+    "达州": 'RXW',
+    "遵义": 'ZYE',
+    "郑州": 'ZZF',
+    "重庆": 'CUW',
+    "金华": 'JBH',
+    "银川": 'YIJ',
+    "镇江": 'ZJH',
+    "长春": 'CCT',
+    "长沙": 'CSQ',
+    "阜阳": 'FYH',
+    "青岛": 'QDK',
+    "鞍山": 'AST',
+    "韶关": 'SNQ',
+    "香格里拉": 'EUM',
+    "香港": 'XJA',
+    "齐齐哈尔": 'QHX',
+    "龙岩": 'LYS'
+};
+export function buildTrainEntryUrl(q) {
+    const unresolved = [];
+    const fromTc = (q.fromStationTelecode ?? '').trim().toUpperCase() || STATION_TELECODES[q.from.trim()];
+    const toTc = (q.toStationTelecode ?? '').trim().toUpperCase() || STATION_TELECODES[q.to.trim()];
+    if (!fromTc) unresolved.push(q.from);
+    if (!toTc) unresolved.push(q.to);
+    if (unresolved.length > 0 || !/^\d{4}-\d{2}-\d{2}$/.test(q.date)) {
+        return {
+            ok: false,
+            unresolved: unresolved.length > 0 ? unresolved : [
+                q.date
+            ]
+        };
+    }
+    const fs = encodeURIComponent(`${q.from.trim()},${fromTc}`);
+    const ts = encodeURIComponent(`${q.to.trim()},${toTc}`);
+    return {
+        ok: true,
+        url: `https://kyfw.12306.cn/otn/leftTicket/init?linktypeid=dc&fs=${fs}&ts=${ts}&date=${q.date}&flag=N,N,Y`
+    };
+}
+export const TRAIN_NETWORK_HINTS = [
+    /leftTicket\/query/i
+];
+export const TRAIN_SITE_HOST = 'kyfw.12306.cn';
+const SEAT_BUCKETS = [
+    {
+        index: 20,
+        field: 'gg_num',
+        label: '其他(通勤)'
+    },
+    {
+        index: 21,
+        field: 'gr_num',
+        label: '高级软卧'
+    },
+    {
+        index: 22,
+        field: 'qt_num',
+        label: '其他'
+    },
+    {
+        index: 23,
+        field: 'rw_num',
+        label: '软卧(一等卧)'
+    },
+    {
+        index: 24,
+        field: 'rz_num',
+        label: '软座'
+    },
+    {
+        index: 25,
+        field: 'tz_num',
+        label: '特等座'
+    },
+    {
+        index: 26,
+        field: 'wz_num',
+        label: '无座'
+    },
+    {
+        index: 27,
+        field: 'yb_num',
+        label: 'yp_b(上游席别)'
+    },
+    {
+        index: 28,
+        field: 'yw_num',
+        label: '硬卧(二等卧)'
+    },
+    {
+        index: 29,
+        field: 'yz_num',
+        label: '硬座'
+    },
+    {
+        index: 30,
+        field: 'ze_num',
+        label: '二等座'
+    },
+    {
+        index: 31,
+        field: 'zy_num',
+        label: '一等座'
+    },
+    {
+        index: 32,
+        field: 'swz_num',
+        label: '商务座'
+    },
+    {
+        index: 33,
+        field: 'srrb_num',
+        label: '动卧'
+    }
+];
+const TRAIN_CODE_RE = /^[GDCZTKYLSF]\d{1,5}[A-Z]?$/i;
+const HHMM_RE = /^\d{2}:\d{2}$/;
+function lishiToMin(s) {
+    const m = /^(\d{1,3}):(\d{2})$/.exec((s ?? '').trim());
+    if (!m) return 0;
+    return Number(m[1]) * 60 + Number(m[2]);
+}
+function rowToOption(row, stationMap, entryUrl) {
+    const f = row.split('|');
+    if (f.length < 34) return null;
+    const trainCode = (f[3] ?? '').trim();
+    const depTime = (f[8] ?? '').trim();
+    const arrTime = (f[9] ?? '').trim();
+    if (!TRAIN_CODE_RE.test(trainCode) || !HHMM_RE.test(depTime) || !HHMM_RE.test(arrTime)) return null;
+    const fromStation = stationMap?.[f[6] ?? ''] ?? f[6] ?? '';
+    const toStation = stationMap?.[f[7] ?? ''] ?? f[7] ?? '';
+    const seats = {};
+    for (const b of SEAT_BUCKETS){
+        const v = (f[b.index] ?? '').trim();
+        if (v && v !== '--') seats[b.label] = v;
+    }
+    return {
+        trainCode,
+        fromStation,
+        toStation,
+        depTime,
+        arrTime,
+        durationMin: lishiToMin(f[10]),
+        canWebBuy: (f[11] ?? '').trim(),
+        seats,
+        jumpUrl: entryUrl
+    };
+}
+export function parseLeftTicketQuery(body, entryUrl, opts = {}) {
+    let raw;
+    try {
+        raw = JSON.parse(body);
+    } catch  {
+        return [];
+    }
+    const rows = raw.data?.result;
+    if (!Array.isArray(rows)) return [];
+    const map = raw.data?.map && typeof raw.data.map === 'object' ? raw.data.map : undefined;
+    const out = [];
+    for (const r of rows){
+        if (typeof r !== 'string') continue;
+        const opt = rowToOption(r, map, entryUrl);
+        if (opt) {
+            out.push(opt);
+            if (out.length >= (opts.maxItems ?? 30)) break;
+        }
+    }
+    return out;
+}
+
+
+//# sourceURL=ts/capabilities/session/adapters/rail-12306.ts

package/dist/capabilities/session/extension-bridge.js

@@ -1,4 +1,7 @@
 import { randomUUID } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
 import { createServer } from 'node:http';
 export const BRIDGE_PORTS = [
     8791,
@@ -17,6 +20,16 @@ export const EXTENSION_ORIGINS = [
     EXTENSION_ORIGIN,
     EXTENSION_ORIGIN_STORE
 ];
+export function localExtensionInstalled(home = homedir()) {
+    return existsSync(join(home, '.gotry', 'extension', 'manifest.json'));
+}
+export function needsExtensionSummary(opts = {}) {
+    const local = opts.localInstalled ?? localExtensionInstalled(opts.home);
+    if (local) {
+        return 'GoTry Session Bridge 扩展未连接(未安装或已停用)。推荐 Chrome 应用商店一键装(自动更新) ' + `${EXTENSION_STORE_URL} ;或 npx gotry setup 落位后 chrome://extensions 开发者模式「加载已解压的扩展程序」指向 ~/.gotry/extension`;
+    }
+    return 'GoTry Session Bridge 扩展未连接。若你已从 Chrome 商店安装(自动更新):打开 Chrome 并确认扩展已启用即可自动连接,无需再装。' + `若尚未安装:应用商店一键装 ${EXTENSION_STORE_URL} (装完零弹窗,浏览器自己当安装器)`;
+}
 export const EXTENSION_CONNECTED_WINDOW_MS = 45_000;
 export const JOBS_LONG_POLL_MS = 20_000;
 export const DEFAULT_EXTENSION_WAIT_MS = 6_000;
@@ -267,7 +280,7 @@ export async function createSessionBridge(opts = {}) {
                         settle({
                             ok: false,
                             reason: 'extension-not-connected',
-                            summary: `GoTry Session Bridge 扩展未连接(未安装或已停用)。一次性安装(装完零弹窗):推荐 Chrome 应用商店一键装(自动更新) ${EXTENSION_STORE_URL} ;或 npx gotry setup 落位后 chrome://extensions 开发者模式「加载已解压的扩展程序」指向 ~/.gotry/extension`
+                            summary: needsExtensionSummary()
                         });
                     }
                 }, 250);

package/dist/capabilities/session/extension-channel.js

@@ -1,5 +1,7 @@
-import { getOrCreateSessionBridge, EXTENSION_STORE_URL } from './extension-bridge.js';
-export const NEEDS_EXTENSION_HINT = '需要一次性安装 GoTry Session Bridge 浏览器扩展(装完零弹窗):' + `推荐 Chrome 应用商店一键安装(自动更新) ${EXTENSION_STORE_URL} ;` + '免审核、版本更新更快的 GitHub 通道:npx gotry setup --extension-from=github(自动下载落位 ~/.gotry/extension;' + '手动下载 github.com/Danceiny/gotry/releases 标签 ext-* 的 gotry-session-bridge.tar.gz),' + '再在 chrome://extensions 开发者模式「加载已解压的扩展程序」指向解压目录';
+import { getOrCreateSessionBridge, needsExtensionSummary } from './extension-bridge.js';
+export function needsExtensionHint() {
+    return needsExtensionSummary();
+}
 export function classifyBridgeFailure(kind) {
     return kind === 'extension-not-connected' ? 'needs-extension' : 'error';
 }

package/dist/capabilities/session/extension-distribution.js

@@ -37,7 +37,7 @@ export function parseDistManifest(raw) {
     const tarballSha256 = obj.tarballSha256;
     const zip = obj.zip;
     const zipSha256 = obj.zipSha256;
-    if (typeof version !== 'string' || !/^\d+\.\d+\.\d+$/.test(version)) throw new Error('dist-manifest.version 缺失或非 x.y.z');
+    if (typeof version !== 'string' || !/^\d+(\.\d+){1,3}$/.test(version)) throw new Error('dist-manifest.version 缺失或非 1-4 段点分整数');
     if (tarball !== DIST_ASSET_TARBALL) throw new Error(`dist-manifest.tarball 资产名漂移(期望 ${DIST_ASSET_TARBALL})`);
     if (zip !== DIST_ASSET_STORE_ZIP) throw new Error(`dist-manifest.zip 资产名漂移(期望 ${DIST_ASSET_STORE_ZIP})`);
     if (typeof tarballSha256 !== 'string' || !SHA256_RE.test(tarballSha256)) throw new Error('dist-manifest.tarballSha256 非 64-hex');

package/dist/capabilities/session-search.js

@@ -3,6 +3,8 @@ import { extensionCookieNames, extensionSearchJob, classifyBridgeFailure } from
 import { appendFileSync, mkdirSync } from 'node:fs';
 import { dirname } from 'node:path';
 import { buildEntryUrl, NETWORK_HINTS, parseBatchSearch, LOGIN_COOKIE_NAMES, SITE_DOMAIN } from './session/adapters/ctrip-flight.js';
+import { buildHotelEntryUrl, parseCtripHotelList, HOTEL_SITE_HOST } from './session/adapters/ctrip-hotel.js';
+import { buildTrainEntryUrl, parseLeftTicketQuery, TRAIN_SITE_HOST } from './session/adapters/rail-12306.js';
 import { EXTENSION_STORE_URL } from './session/extension-bridge.js';
 const MIN_INTERVAL_MS = 30_000;
 const lastCallAt = new Map();
@@ -48,6 +50,315 @@ export function appendExtensionAudit(auditPath, entry) {
         appendFileSync(auditPath, JSON.stringify(record) + '\n');
     } catch  {}
 }
+export function hotelCityUnresolvedHint(cities) {
+    return `城市 ${cities.join('/')} 不在携程酒店城市码表——先 web 搜「hotels.ctrip.com ${cities[0] ?? ''} 酒店」拿到 list 页 URL 里的 city= 数字,带 cityId 重试`;
+}
+export async function sessionHotelSearch(q) {
+    const started = Date.now();
+    const ts = new Date().toISOString();
+    const site = 'ctrip-hotel';
+    const err = (verdict, error)=>({
+            ok: false,
+            via: 'session-ctrip-hotel-error',
+            evidence: `[会话:${site}@error@${ts}] ${error}`,
+            latencyMs: Date.now() - started,
+            verdict,
+            error
+        });
+    if ((q.checkIn ? 1 : 0) !== (q.checkOut ? 1 : 0) || q.checkIn && !/^\d{4}-\d{2}-\d{2}$/.test(q.checkIn)) {
+        return err('error', 'checkIn/checkOut 须成对且为 YYYY-MM-DD(未定档期可不带日期)');
+    }
+    if (q.checkIn) {
+        const now = new Date();
+        const today = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-${String(now.getDate()).padStart(2, '0')}`;
+        if (q.checkIn < today || (q.checkOut ?? '') < q.checkIn) {
+            return err('error', `入住 ${q.checkIn}/退房 ${q.checkOut ?? ''} 不是未来合法区间(今天 ${today})——向用户确认日期后再查`);
+        }
+    }
+    const last = lastCallAt.get(site) ?? 0;
+    if (Date.now() - last < MIN_INTERVAL_MS) {
+        return err('cooldown', `rate limit: last call ${Date.now() - last}ms ago, min ${MIN_INTERVAL_MS}ms`);
+    }
+    lastCallAt.set(site, Date.now());
+    const entry = buildHotelEntryUrl({
+        to: q.to,
+        cityId: q.cityId,
+        checkIn: q.checkIn,
+        checkOut: q.checkOut,
+        adults: q.adults
+    });
+    if (!entry.ok || !entry.url) {
+        return err('error', hotelCityUnresolvedHint(entry.unresolved ?? [
+            q.to
+        ]));
+    }
+    const mode = resolveTransportMode(q.profileDir);
+    if (mode === 'extension') {
+        const login = await extensionCookieNames({
+            site,
+            domain: SITE_DOMAIN.replace(/^\./, ''),
+            ticketNames: LOGIN_COOKIE_NAMES
+        });
+        if (!login.ok) {
+            const verdict = classifyBridgeFailure(login.kind);
+            if (verdict === 'needs-extension') {
+                return {
+                    ok: false,
+                    via: 'session-ctrip-hotel-error',
+                    evidence: '[会话:ctrip-hotel-needs-extension@ts]',
+                    latencyMs: Date.now() - started,
+                    verdict,
+                    error: login.summary,
+                    installUrl: EXTENSION_STORE_URL,
+                    installAction: 'add-to-chrome'
+                };
+            }
+            return err(verdict, login.summary);
+        }
+        if (login.tickets.length === 0 && !q.allowAnonymous) {
+            return err('needs-login', '未检出你本人登录态——调用 gotry_session_login 为用户打开携程登录入口(登录在携程官网完成;gotry 永不经手密码/验证码/cookie 值)');
+        }
+        const r = await extensionSearchJob({
+            site,
+            url: entry.url,
+            timeoutMs: q.timeoutMs
+        });
+        appendExtensionAudit(q.auditPath, {
+            kind: 'extension-session-job',
+            site,
+            url: entry.url,
+            jobId: 'search',
+            result: r.ok ? r.timedOut ? 'timeout' : `body ${r.body.length}B title="${r.title.slice(0, 60)}"` : `${r.kind}:${r.summary.slice(0, 120)}`
+        });
+        if (!r.ok) {
+            const verdict = classifyBridgeFailure(r.kind);
+            if (verdict === 'needs-extension') {
+                return {
+                    ok: false,
+                    via: 'session-ctrip-hotel-error',
+                    evidence: '[会话:ctrip-hotel-needs-extension@ts]',
+                    latencyMs: Date.now() - started,
+                    verdict,
+                    error: r.summary,
+                    installUrl: EXTENSION_STORE_URL,
+                    installAction: 'add-to-chrome'
+                };
+            }
+            return err(verdict, r.summary);
+        }
+        const title = r.title;
+        const head = r.body.slice(0, 5000);
+        if (CHALLENGE_RE.test(title + head)) {
+            return err('challenged', `风控/验证码命中(title=${title.slice(0, 60)});按红线不重试不绕过,交还用户`);
+        }
+        const hotels = parseCtripHotelList(r.body);
+        const verdict = hotels.length > 0 ? 'hit' : 'miss';
+        return {
+            ok: true,
+            via: 'session-ctrip-hotel',
+            evidence: `[会话:${site}@${ts}] ${hotels.length} hotels;transport=extension(被动嗅探,零系统弹窗;扩展零写行为=物理只读)${q.allowAnonymous ? ';anonymous=自检态' : ''}`,
+            latencyMs: Date.now() - started,
+            verdict,
+            hotels
+        };
+    }
+    const t = await openSession({
+        profileDir: q.profileDir,
+        headless: q.headless,
+        auditPath: q.auditPath,
+        mode: mode === 'persistent' ? 'persistent' : 'cdp',
+        newPage: true
+    });
+    if (!t.ok) {
+        return err(classifyTransportFailure(t.summary, q.profileDir === undefined), t.summary);
+    }
+    try {
+        const loggedIn = async ()=>{
+            const cookies = await t.browser.cookies().catch(()=>[]);
+            return cookies.some((c)=>c.domain.includes(SITE_DOMAIN.replace(/^\./, '')) && LOGIN_COOKIE_NAMES.includes(c.name));
+        };
+        if (!await loggedIn() && !q.allowAnonymous) {
+            return err('needs-login', '未检出你本人登录态——调用 gotry_session_login 为用户打开携程登录入口(登录在携程官网完成;gotry 永不经手密码/验证码/cookie 值)');
+        }
+        let settled = false;
+        let body = '';
+        const heard = new Promise((resolve)=>{
+            t.page.on('response', async (res)=>{
+                if (settled) return;
+                const u = res.url();
+                const hostHit = u.includes(HOTEL_SITE_HOST);
+                if (!hostHit) return;
+                try {
+                    const text = await res.text();
+                    if (text && (hostHit && /hotels\.ctrip\.com\/(hotels\/api|domestic\/pc\/api)|GetHotelListBySOA|GetHotelListByCity|HotelSearch|hotelsearch/i.test(u) || text.length <= 2_000_000 && /"hotelList"|"hotelMatchInfos"|"hotelName"/.test(text))) {
+                        body = text;
+                        settled = true;
+                        resolve();
+                    }
+                } catch  {}
+            });
+            setTimeout(()=>resolve(), q.timeoutMs ?? 30_000);
+        });
+        await t.page.goto(entry.url, {
+            waitUntil: 'domcontentloaded',
+            timeout: 30_000
+        });
+        await heard;
+        const title = await t.page.title().catch(()=>'');
+        const headHtml = (await t.page.content().catch(()=>'')).slice(0, 5000);
+        if (CHALLENGE_RE.test(title + headHtml)) {
+            return err('challenged', `风控/验证码命中(title=${title.slice(0, 60)});按红线不重试不绕过,交还用户`);
+        }
+        const hotels = parseCtripHotelList(body);
+        const verdict = hotels.length > 0 ? 'hit' : 'miss';
+        return {
+            ok: true,
+            via: 'session-ctrip-hotel',
+            evidence: `[会话:${site}@${ts}] ${hotels.length} hotels;guard blocked=${t.guard.blockedCount()}/${t.guard.requestCount()}${q.allowAnonymous ? ';anonymous=自检态' : ''}`,
+            latencyMs: Date.now() - started,
+            verdict,
+            hotels
+        };
+    } catch (e) {
+        return err('error', e instanceof Error ? e.message.slice(0, 200) : String(e));
+    } finally{
+        await t.close();
+    }
+}
+export function trainStationUnresolvedHint(cities) {
+    return `城市 ${cities.join('/')} 不在 12306 城市电报码表——web 搜「12306 ${cities[0] ?? ''} 余票」拿到 kyfw 查询页 URL 里的 fs=城市,XXX 三位码,带 fromStationTelecode/toStationTelecode 重试`;
+}
+export async function sessionTrainSearch(q) {
+    const started = Date.now();
+    const ts = new Date().toISOString();
+    const site = 'train-12306';
+    const err = (verdict, error)=>({
+            ok: false,
+            via: 'session-train-12306-error',
+            evidence: `[会话:${site}@error@${ts}] ${error}`,
+            latencyMs: Date.now() - started,
+            verdict,
+            error
+        });
+    const last = lastCallAt.get(site) ?? 0;
+    if (Date.now() - last < MIN_INTERVAL_MS) {
+        return err('cooldown', `rate limit: last call ${Date.now() - last}ms ago, min ${MIN_INTERVAL_MS}ms`);
+    }
+    lastCallAt.set(site, Date.now());
+    const entry = buildTrainEntryUrl({
+        from: q.from,
+        to: q.to,
+        date: q.date,
+        fromStationTelecode: q.fromStationTelecode,
+        toStationTelecode: q.toStationTelecode
+    });
+    if (!entry.ok || !entry.url) {
+        return err('error', trainStationUnresolvedHint(entry.unresolved ?? [
+            q.from,
+            q.to
+        ]));
+    }
+    const mode = resolveTransportMode(q.profileDir);
+    if (mode === 'extension') {
+        const r = await extensionSearchJob({
+            site,
+            url: entry.url,
+            timeoutMs: q.timeoutMs
+        });
+        appendExtensionAudit(q.auditPath, {
+            kind: 'extension-session-job',
+            site,
+            url: entry.url,
+            jobId: 'search',
+            result: r.ok ? r.timedOut ? 'timeout' : `body ${r.body.length}B title="${r.title.slice(0, 60)}"` : `${r.kind}:${r.summary.slice(0, 120)}`
+        });
+        if (!r.ok) {
+            const verdict = classifyBridgeFailure(r.kind);
+            if (verdict === 'needs-extension') {
+                return {
+                    ok: false,
+                    via: 'session-train-12306-error',
+                    evidence: '[会话:train-12306-needs-extension@ts]',
+                    latencyMs: Date.now() - started,
+                    verdict,
+                    error: r.summary,
+                    installUrl: EXTENSION_STORE_URL,
+                    installAction: 'add-to-chrome'
+                };
+            }
+            return err(verdict, r.summary);
+        }
+        const title = r.title;
+        const head = r.body.slice(0, 5000);
+        if (CHALLENGE_RE.test(title + head)) {
+            return err('challenged', `风控/验证码命中(title=${title.slice(0, 60)});按红线不重试不绕过,交还用户`);
+        }
+        const trains = parseLeftTicketQuery(r.body, entry.url);
+        const verdict = trains.length > 0 ? 'hit' : 'miss';
+        return {
+            ok: true,
+            via: 'session-train-12306',
+            evidence: `[会话:${site}@${ts}] ${trains.length} trains;transport=extension(公开查询面,被动嗅探,零系统弹窗;扩展零写行为=物理只读)`,
+            latencyMs: Date.now() - started,
+            verdict,
+            trains
+        };
+    }
+    const t = await openSession({
+        profileDir: q.profileDir,
+        headless: q.headless,
+        auditPath: q.auditPath,
+        mode: mode === 'persistent' ? 'persistent' : 'cdp',
+        newPage: true
+    });
+    if (!t.ok) {
+        return err(classifyTransportFailure(t.summary, q.profileDir === undefined), t.summary);
+    }
+    try {
+        let settled = false;
+        let body = '';
+        const heard = new Promise((resolve)=>{
+            t.page.on('response', async (res)=>{
+                if (settled) return;
+                const u = res.url();
+                if (!/leftTicket\/query/i.test(u)) return;
+                try {
+                    const text = await res.text();
+                    if (text) {
+                        body = text;
+                        settled = true;
+                        resolve();
+                    }
+                } catch  {}
+            });
+            setTimeout(()=>resolve(), q.timeoutMs ?? 25_000);
+        });
+        await t.page.goto(entry.url, {
+            waitUntil: 'domcontentloaded',
+            timeout: 30_000
+        });
+        await heard;
+        const title = await t.page.title().catch(()=>'');
+        const headHtml = (await t.page.content().catch(()=>'')).slice(0, 5000);
+        if (CHALLENGE_RE.test(title + headHtml)) {
+            return err('challenged', `风控/验证码命中(title=${title.slice(0, 60)});按红线不重试不绕过,交还用户`);
+        }
+        const trains = parseLeftTicketQuery(body, entry.url);
+        const verdict = trains.length > 0 ? 'hit' : 'miss';
+        return {
+            ok: true,
+            via: 'session-train-12306',
+            evidence: `[会话:${site}@${ts}] ${trains.length} trains(公开查询面);guard blocked=${t.guard.blockedCount()}/${t.guard.requestCount()}`,
+            latencyMs: Date.now() - started,
+            verdict,
+            trains
+        };
+    } catch (e) {
+        return err('error', e instanceof Error ? e.message.slice(0, 200) : String(e));
+    } finally{
+        await t.close();
+    }
+}
 export async function sessionFlightSearch(q) {
     const started = Date.now();
     const ts = new Date().toISOString();