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

package/dist/scripts/doctor-tests.js

@@ -0,0 +1,121 @@
+import assert from 'node:assert/strict';
+import { mkdtemp, mkdir, writeFile, rm, readFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { runDoctorChecks, renderDoctorReportMd, nodeOk } from '../capabilities/doctor.js';
+import { apply } from '../src/index.js';
+const tmp = await mkdtemp(join(tmpdir(), 'gotry-doctor-test-'));
+const emptyRepo = join(tmp, 'repo-empty');
+const emptyHome = join(tmp, 'home-empty');
+await mkdir(emptyRepo, {
+    recursive: true
+});
+await mkdir(emptyHome, {
+    recursive: true
+});
+const r1 = await runDoctorChecks({
+    repoRoot: emptyRepo,
+    homeDir: emptyHome,
+    env: {}
+});
+const byId = (id)=>r1.items.find((i)=>i.id === id);
+assert.ok(byId('agent-reach'), 'agent-reach 项存在');
+assert.equal(byId('agent-reach').status, 'missing', `空仓 agent-reach=missing,实际 ${byId('agent-reach').status}`);
+assert.match(byId('agent-reach').fix ?? '', /npx gotry doctor --fix/, 'missing 项带精确补装指引');
+assert.equal(byId('extension').status, 'missing', '空 home 扩展=missing');
+assert.equal(byId('flyai').status, 'degraded', '无 key flyai=degraded(有共享试用,非缺失)');
+assert.equal(byId('llm-key').status, 'ok', 'LLM key 恒 ok(让渡面)');
+assert.equal(r1.ok, false, '有 missing 项时报告 ok=false');
+assert.match(r1.summary, /待处理/, 'summary 指明待处理项');
+console.log('1. 空 tmp 环境 → missing/degraded 分级正确,LLM key 让渡 OK');
+const repoPartial = join(tmp, 'repo-partial');
+await mkdir(join(repoPartial, '.venv/bin'), {
+    recursive: true
+});
+await writeFile(join(repoPartial, '.venv/bin/python'), '#!/bin/sh\n', {
+    mode: 0o755
+});
+const r2a = await runDoctorChecks({
+    repoRoot: repoPartial,
+    homeDir: emptyHome,
+    env: {}
+});
+assert.equal(r2a.items.find((i)=>i.id === 'agent-reach').status, 'degraded', '只 python → degraded(半可用显式区分)');
+const repoFull = join(tmp, 'repo-full');
+await mkdir(join(repoFull, '.venv/bin'), {
+    recursive: true
+});
+await writeFile(join(repoFull, '.venv/bin/python'), '#!/bin/sh\n', {
+    mode: 0o755
+});
+await writeFile(join(repoFull, '.venv/bin/agent-reach'), '#!/bin/sh\n', {
+    mode: 0o755
+});
+const r2b = await runDoctorChecks({
+    repoRoot: repoFull,
+    homeDir: emptyHome,
+    env: {}
+});
+assert.equal(r2b.items.find((i)=>i.id === 'agent-reach').status, 'ok', 'python+agent-reach 齐 → ok');
+console.log('2. .venv 三态(missing/degraded/ok)分级 OK');
+const r3 = await runDoctorChecks({
+    repoRoot: emptyRepo,
+    homeDir: emptyHome,
+    env: {
+        FLYAI_API_KEY: 'test-key'
+    }
+});
+assert.equal(r3.items.find((i)=>i.id === 'flyai').status, 'ok', '有正式 key → flyai=ok');
+console.log('3. FLYAI_API_KEY 注入 → flyai ok OK');
+assert.equal(nodeOk('22.14.0'), false, '22.14 不足');
+assert.equal(nodeOk('22.15.0'), true, '22.15 达标');
+assert.equal(nodeOk('23.0.0'), true, '23.x 达标');
+console.log('4. nodeOk 边界 OK');
+const md = renderDoctorReportMd(r1);
+assert.match(md, /# GoTry 依赖体检报告/, '报告标题');
+assert.match(md, /`npx gotry doctor --fix`/, '命令类 fix 加反引号');
+assert.match(md, /flyai\.open\.fliggy\.com 控制台申请正式 key/, 'prose 类 fix 原样呈现');
+assert.ok(!md.includes('`到 flyai'), 'prose 类 fix 不应整体包反引号');
+assert.match(md, /LLM key/, '让渡面(LLM key)照常入表');
+console.log('5. 报告渲染 OK');
+const smokeRoot = await mkdtemp(join(tmpdir(), 'gotry-doctor-state-'));
+const registered = [];
+const ctx = {
+    tools: {
+        register: (t)=>registered.push(t)
+    },
+    systemPrompt: {
+        variable: ()=>{}
+    },
+    on: ()=>()=>{}
+};
+apply(ctx, {
+    stateRoot: smokeRoot,
+    timeoutMs: 30_000,
+    hbcliBin: 'hbcli-not-on-path',
+    sessionAccess: 'ask'
+});
+const doctorTool = registered.find((t)=>t.name === 'gotry_doctor');
+assert.ok(doctorTool, 'gotry_doctor 已注册');
+const out = await doctorTool.execute({
+    query: {}
+}, null);
+assert.equal(out.ok, true, '体检工具 ok=true(体检本身成功,与依赖是否缺失无关)');
+assert.equal(out.verdict, 'needs-attention', '注入环境外仍能出 verdict(本机真实状态,不判 all-clear)');
+assert.ok(Array.isArray(out.items) && out.items.length >= 6, 'items 齐全');
+assert.ok(out.report_path && out.report_path.includes(smokeRoot), `报告落在 isolated stateRoot: ${out.report_path}`);
+const reportMd = await readFile(out.report_path, 'utf-8');
+assert.match(reportMd, /# GoTry 依赖体检报告/, '落盘报告可预览');
+await rm(tmp, {
+    recursive: true,
+    force: true
+});
+await rm(smokeRoot, {
+    recursive: true,
+    force: true
+});
+console.log('6. gotry_doctor 工具面 + 报告落盘 OK');
+console.log('doctor-tests: 全部通过');
+
+
+//# sourceURL=ts/scripts/doctor-tests.ts

package/dist/scripts/effect-tests.js

@@ -468,7 +468,280 @@ assert.equal(m10a.result.rates?.rooms?.length, 1, 'RATES 夹具回放');
 assert.equal(m10b.result.avail?.avail, true, 'CHECK_AVAIL 夹具回放');
 assert.match(m10a.trace.evidence[0] ?? '', /\[效应:mock@.*夹具回放/, 'mock trace 标注');
 console.log('10c. mock 解译器夹具回放(预订链 CI 形态)OK');
-console.log('EFFECT INTERPRETER TESTS: 10/10 OK(effect_interpreter.v1:注册表封闭/退避链/断路三态/Sentinel 不重试/mock 夹具/SESSION 红线/真实降级/M0 预订链读效应,纯离线)');
+__resetEffectBreakersForTest();
+let flakyCalls = 0;
+const ipTimeout = makeProductionInterpreter({
+    sleep: sleep0,
+    breakers: new Map(),
+    handlers: {
+        HBCLI_HOTEL_SEARCH: async ()=>{
+            flakyCalls += 1;
+            if (flakyCalls === 1) return {
+                via: 'hbcli-error',
+                exitCode: -1,
+                result: null,
+                evidence: '[实时API:hbcli@timeout@ts]',
+                latencyMs: 1,
+                error: 'timeout after 30000ms'
+            };
+            return {
+                via: 'hbcli-realtime',
+                exitCode: 0,
+                result: {
+                    hotels: []
+                },
+                evidence: '[实时API:hbcli@ts]',
+                latencyMs: 1
+            };
+        }
+    }
+});
+const itp11 = await ipTimeout({
+    effect: 'HBCLI_HOTEL_SEARCH',
+    params: {
+        destination: '迪拜'
+    }
+});
+assert.equal(itp11.trace.attempts, 2, `timeout 重试一次(attempts=2),实际 ${itp11.trace.attempts}`);
+assert.equal(itp11.result?.via, 'hbcli-realtime', '重试后恢复实时');
+assert.equal(itp11.trace.breaker, 'closed', '恢复即成功,断路不计数');
+let hardCalls = 0;
+const ipEnoent = makeProductionInterpreter({
+    sleep: sleep0,
+    breakers: new Map(),
+    handlers: {
+        HBCLI_HOTEL_SEARCH: async ()=>{
+            hardCalls += 1;
+            return {
+                via: 'hbcli-error',
+                exitCode: -1,
+                result: null,
+                evidence: '[实时API:hbcli@spawn_error@ts]',
+                latencyMs: 1,
+                error: 'spawn hbcli ENOENT'
+            };
+        }
+    }
+});
+const itp11b = await ipEnoent({
+    effect: 'HBCLI_HOTEL_SEARCH',
+    params: {
+        destination: '迪拜'
+    }
+});
+assert.equal(itp11b.trace.attempts, 1, 'ENOENT 类永不重试(切换不是重试契约不变)');
+console.log('11. HBCLI×timeout 冷启动重试(timeout→attempts=2 恢复实时;ENOENT→attempts=1)OK');
+__resetEffectBreakersForTest();
+const sixChannels = [
+    [
+        'ANYTHING_SEARCH',
+        'cli',
+        {
+            ok: true,
+            via: 'hbcli-anything',
+            verdict: 'hit',
+            evidence: 'e',
+            latencyMs: 1
+        }
+    ],
+    [
+        'WEB_READ',
+        'api',
+        {
+            ok: true,
+            via: 'r.jina.ai',
+            evidence: 'e',
+            latencyMs: 1
+        }
+    ],
+    [
+        'GITHUB_SEARCH',
+        'cli',
+        {
+            ok: true,
+            verdict: 'found',
+            evidence: 'e',
+            latencyMs: 1
+        }
+    ],
+    [
+        'VIDEO_SUBTITLE',
+        'cli',
+        {
+            ok: true,
+            verdict: 'found',
+            evidence: 'e',
+            latencyMs: 1
+        }
+    ],
+    [
+        'AGENT_REACH',
+        'cli',
+        {
+            ok: true,
+            verdict: 'found',
+            channel: 'v2ex',
+            method: 'read',
+            evidence: 'e',
+            latencyMs: 1
+        }
+    ],
+    [
+        'SESSION_LOGIN',
+        'browser',
+        {
+            ok: true,
+            via: 'session-login',
+            verdict: 'pending',
+            evidence: 'e',
+            latencyMs: 1
+        }
+    ]
+];
+for (const [fx, channel, obs] of sixChannels){
+    const ip = makeProductionInterpreter({
+        sleep: sleep0,
+        breakers: new Map(),
+        handlers: {
+            [fx]: async ()=>obs
+        }
+    });
+    const out = await ip({
+        effect: fx,
+        params: {}
+    });
+    assert.equal(out.result, obs, `${fx} 透传原样`);
+    assert.equal(out.trace.channel, channel, `${fx} trace.channel=${channel}(策略表行在案)`);
+    assert.equal(out.trace.attempts, 1, `${fx} 成功单次执行`);
+}
+console.log('12a. 六渠道入表(透传 + trace.channel 与策略表一致)OK');
+for (const fx of [
+    'AGENT_REACH',
+    'SESSION_LOGIN'
+]){
+    const ip = makeProductionInterpreter({
+        sleep: sleep0,
+        breakers: new Map(),
+        handlers: {
+            [fx]: async ()=>{
+                throw new Error('upstream says no');
+            }
+        }
+    });
+    const out = await ip({
+        effect: fx,
+        params: {}
+    });
+    assert.equal(out.result, null, `${fx} 抛错 → result=null`);
+    assert.equal(out.trace.attempts, 1, `${fx} 永不重试(attempts=1)`);
+}
+console.log('12b. AGENT_REACH/SESSION_LOGIN 永不重试(反射桥透传/浏览器风控红线)OK');
+__resetEffectBreakersForTest();
+let webCalls = 0;
+const ipWeb = makeProductionInterpreter({
+    sleep: sleep0,
+    breakers: new Map(),
+    handlers: {
+        WEB_READ: async ()=>{
+            webCalls += 1;
+            if (webCalls === 1) throw new Error('socket hang up');
+            return {
+                ok: true,
+                via: 'r.jina.ai',
+                evidence: 'e',
+                latencyMs: 1
+            };
+        }
+    }
+});
+const outWeb = await ipWeb({
+    effect: 'WEB_READ',
+    params: {
+        url: 'https://example.com'
+    }
+});
+assert.equal(outWeb.trace.attempts, 2, `WEB_READ 瞬时抖动重试 1 次,实际 ${outWeb.trace.attempts}`);
+let ghTimeoutCalls = 0;
+const ipGhTimeout = makeProductionInterpreter({
+    sleep: sleep0,
+    breakers: new Map(),
+    handlers: {
+        GITHUB_SEARCH: async ()=>{
+            ghTimeoutCalls += 1;
+            if (ghTimeoutCalls === 1) return {
+                ok: false,
+                verdict: 'timeout',
+                evidence: 'e',
+                latencyMs: 1,
+                stdout: '',
+                stderr: ''
+            };
+            return {
+                ok: true,
+                verdict: 'found',
+                evidence: 'e',
+                latencyMs: 1
+            };
+        }
+    }
+});
+const outGhT = await ipGhTimeout({
+    effect: 'GITHUB_SEARCH',
+    params: {
+        query: 'x'
+    }
+});
+assert.equal(outGhT.trace.attempts, 2, 'GITHUB timeout 类重试 1 次(冷启动同 HBCLI 实况)');
+let ghNiCalls = 0;
+const ipGhNi = makeProductionInterpreter({
+    sleep: sleep0,
+    breakers: new Map(),
+    handlers: {
+        GITHUB_SEARCH: async ()=>{
+            ghNiCalls += 1;
+            return {
+                ok: false,
+                verdict: 'not-installed',
+                evidence: 'e',
+                latencyMs: 0
+            };
+        }
+    }
+});
+const outGhNi = await ipGhNi({
+    effect: 'GITHUB_SEARCH',
+    params: {
+        query: 'x'
+    }
+});
+assert.equal(outGhNi.trace.attempts, 1, 'not-installed 是配置态(needs-setup 族)不重试');
+console.log('12c. WEB_READ/GITHUB/VIDEO 策略行(timeout 重试/配置态不重试)OK');
+__resetEffectBreakersForTest();
+const mockIp = makeMockInterpreter({
+    ANYTHING_SEARCH: {
+        ok: true,
+        via: 'hbcli-anything',
+        verdict: 'hit',
+        evidence: '[实时API:hbcli-anything@ts]',
+        latencyMs: 1
+    }
+});
+const outMock = await mockIp({
+    effect: 'ANYTHING_SEARCH',
+    params: {
+        keyword: '大理'
+    }
+});
+assert.equal(outMock.result.verdict, 'hit', 'mock 夹具回放原样');
+assert.equal(outMock.trace.channel, 'mock', 'mock 通道标注');
+const outMockBad = await mockIp({
+    effect: 'SESSION_LOGIN',
+    params: {}
+});
+assert.equal(outMockBad.result, null, '未登记夹具 → result=null');
+assert.equal(outMockBad.trace.declined, 'unknown-effect', '未登记夹具 → 结构化拒绝');
+console.log('12d. mock 夹具回放/未登记拒绝(新效应同语义)OK');
+console.log('EFFECT INTERPRETER TESTS: 12/12 OK(effect_interpreter.v1:注册表封闭/退避链/断路三态/Sentinel 不重试/mock 夹具/SESSION 红线/真实降级/M0 预订链读效应/HBCLI timeout 重试/D-23 六渠道入表,纯离线)');
 
 
 //# sourceURL=ts/scripts/effect-tests.ts

package/dist/scripts/extension-tests.js

@@ -1,15 +1,17 @@
 import assert from 'node:assert/strict';
 import { fork } from 'node:child_process';
 import { createHash } from 'node:crypto';
-import { mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { BRIDGE_PORTS, EXTENSION_ID, EXTENSION_ID_STORE, EXTENSION_ORIGIN, EXTENSION_ORIGIN_STORE, EXTENSION_ORIGINS, EXTENSION_STORE_URL, createSessionBridge, __resetSessionBridgeForTest, __setSessionBridgeForTest } from '../capabilities/session/extension-bridge.js';
+import { BRIDGE_PORTS, EXTENSION_ID, EXTENSION_ID_STORE, EXTENSION_ORIGIN, EXTENSION_ORIGIN_STORE, EXTENSION_ORIGINS, EXTENSION_STORE_URL, createSessionBridge, localExtensionInstalled, needsExtensionSummary, __resetSessionBridgeForTest, __setSessionBridgeForTest } from '../capabilities/session/extension-bridge.js';
 import { classifyBridgeFailure, extensionCookieNames, extensionSearchJob } from '../capabilities/session/extension-channel.js';
-import { appendExtensionAudit, resolveTransportMode, sessionFlightSearch } from '../capabilities/session-search.js';
+import { appendExtensionAudit, resolveTransportMode, sessionFlightSearch, sessionHotelSearch, sessionTrainSearch, __resetRateLimiterForTest } from '../capabilities/session-search.js';
 import { sessionLogin } from '../capabilities/session-login.js';
 import { LOGIN_COOKIE_NAMES, NETWORK_HINTS, SITE_DOMAIN } from '../capabilities/session/adapters/ctrip-flight.js';
+import { HOTEL_NETWORK_HINTS, HOTEL_SITE_HOST, buildHotelEntryUrl } from '../capabilities/session/adapters/ctrip-hotel.js';
+import { TRAIN_NETWORK_HINTS, TRAIN_SITE_HOST } from '../capabilities/session/adapters/rail-12306.js';
 import { evaluateDoubleSource } from '../capabilities/session/benchmark.js';
 const EXT_DIR = fileURLToPath(new URL('../../extension/', import.meta.url));
 const UNREF_CHILD = fileURLToPath(new URL('./fixtures/extension-bridge-unref-child.mjs', import.meta.url));
@@ -161,11 +163,14 @@ async function main() {
         ].sort((a, b)=>a - b));
         assert.ok(manifest.host_permissions.includes('https://*.ctrip.com/*'));
     });
-    await check('防漂移:content_scripts 双 world 只挂 flights.ctrip.com(MAIN 嗅探 + ISOLATED 桥)', ()=>{
+    await check('防漂移:content_scripts 双 world 挂 ctrip 双站+12306(MAIN 嗅探 + ISOLATED 桥;2026-09-03 酒/火实装)', ()=>{
         assert.equal(manifest.content_scripts.length, 2);
         for (const cs of manifest.content_scripts){
             assert.deepEqual(cs.matches, [
-                'https://flights.ctrip.com/*'
+                'https://flights.ctrip.com/*',
+                `https://${HOTEL_SITE_HOST}/*`,
+                `https://${TRAIN_SITE_HOST}/*`,
+                'https://www.12306.cn/*'
             ]);
             assert.equal(cs.run_at, 'document_start');
         }
@@ -182,19 +187,42 @@ async function main() {
     const backgroundJs = read('background.js');
     const contentMainJs = read('content-main.js');
     const contentBridgeJs = read('content-bridge.js');
+    await check('版本跟随主版本:manifest version_name = package.json version;version = 四段投影(0.0.1-rc.N → 0.0.1.N,founder 2026-09-03 拍板)', ()=>{
+        const pkgVersion = JSON.parse(readFileSync(join(EXT_DIR, '..', 'package.json'), 'utf8')).version;
+        assert.equal(manifest.version_name, pkgVersion, 'version_name 应与 gotry 主版本逐字一致');
+        const m = /^(\d+)\.(\d+)\.(\d+)-rc\.(\d+)$/.exec(pkgVersion);
+        assert.ok(m, `主版本形态应为 x.y.z-rc.N,实际 ${pkgVersion}`);
+        assert.equal(manifest.version, `${m[1]}.${m[2]}.${m[3]}.${m[4]}`, 'version 应为主版本的四段投影(Chrome manifest 只收点分整数)');
+        assert.equal(manifest.content_scripts.length, 2);
+    });
     await check('防漂移:票据 cookie 名单(Node LOGIN_COOKIE_NAMES)= 扩展 SITES.ticketNames', ()=>{
         for (const name of LOGIN_COOKIE_NAMES){
             assert.ok(backgroundJs.includes(`'${name}'`), `background.js 缺票据名 ${name}`);
         }
         assert.ok(backgroundJs.includes("domain: 'ctrip.com'"), 'background.js 站点域应与 LOGIN_TARGETS.domain 对账');
     });
-    await check('防漂移:NETWORK_HINTS(Node)= content-main HINT_RE(MAIN-world 嗅探面)', ()=>{
+    await check('防漂移:NETWORK_HINTS + HOTEL_NETWORK_HINTS(Node)= content-main 嗅探面(MAIN-world)', ()=>{
         for (const hint of NETWORK_HINTS){
             assert.ok(stripRe(contentMainJs).includes(stripRe(hint.source)), `content-main.js 缺 hint ${hint.source}`);
         }
+        for (const hint of HOTEL_NETWORK_HINTS){
+            assert.ok(stripRe(contentMainJs).includes(stripRe(hint.source)), `content-main.js 缺酒店 hint ${hint.source}`);
+        }
+        for (const hint of TRAIN_NETWORK_HINTS){
+            assert.ok(stripRe(contentMainJs).includes(stripRe(hint.source)), `content-main.js 缺火车 hint ${hint.source}`);
+        }
+        assert.ok(contentMainJs.includes('12306'), 'content-main.js 应感知 12306 页域(火车嗅探作用域)');
+        assert.ok(contentMainJs.includes('hotels\\.ctrip\\.com'), 'content-main.js 应感知酒店页域(形状嗅探兜底的作用域)');
+    });
+    await check('防漂移:酒店形状签名(Node looksLikeHotelListBody 同款)= content-main HOTEL_BODY_SIG_RE', ()=>{
+        assert.ok(stripRe(contentMainJs).includes('"hotelList"|"hotelMatchInfos"|"hotelName"'), '形状嗅探签名两侧必须逐字一致');
     });
-    await check('防漂移:检索/登录 URL 面(background 只允许 flights.ctrip.com;ISOLATED 桥转发两类事件)', ()=>{
-        assert.ok(backgroundJs.includes('https://flights.ctrip.com/'));
+    await check('防漂移:检索/登录 URL 面(background per-site 白名单 flights+hotels;ISOLATED 桥转发两类事件)', ()=>{
+        assert.ok(backgroundJs.includes('https://flights.ctrip.com/'), 'background 应含机票检索白名单');
+        assert.ok(backgroundJs.includes(`https://${HOTEL_SITE_HOST}/`), 'background 应含酒店检索白名单(2026-09-03 实装)');
+        assert.ok(backgroundJs.includes('https://kyfw.12306.cn/'), 'background 应含火车检索白名单(2026-09-03 实装)');
+        assert.ok(backgroundJs.includes("'ctrip-hotel'"), 'background SITES 应注册 ctrip-hotel');
+        assert.ok(backgroundJs.includes("'train-12306'"), 'background SITES 应注册 train-12306');
         assert.ok(contentMainJs.includes('gotry-ctrip-sniff'));
         assert.ok(contentBridgeJs.includes('gotry-ctrip-sniff'));
         assert.ok(contentBridgeJs.includes('gotry-page'));
@@ -453,16 +481,43 @@ async function main() {
                                 ]
                             };
                             if (job.kind === 'search') {
-                                assert.ok(String(job.url).startsWith('https://flights.ctrip.com/'));
+                                const u = String(job.url);
+                                const isHotel = u.startsWith(`https://${HOTEL_SITE_HOST}/`);
+                                const isTrain = u.startsWith('https://kyfw.12306.cn/');
+                                assert.ok(u.startsWith('https://flights.ctrip.com/') || isHotel || isTrain, `search job 只允许已注册站点域,实际 ${u}`);
                                 return {
                                     ok: true,
                                     kind: 'search',
-                                    body: JSON.stringify({
+                                    body: isHotel ? JSON.stringify({
+                                        data: {
+                                            hotelList: [
+                                                {
+                                                    hotelId: 442516,
+                                                    hotelName: 'Hotel X',
+                                                    star: 5,
+                                                    commentScore: 4.7,
+                                                    priceInfo: {
+                                                        avgPrice: 680
+                                                    }
+                                                }
+                                            ]
+                                        }
+                                    }) : isTrain ? JSON.stringify({
+                                        data: {
+                                            result: [
+                                                '|预订|24000000G1375|G1375|SHH|KMM|SHH|KMM|07:35|15:27|07:52|Y|yp|x|x|loc|01|02|Y|0|--|--|--|--|--|--|有|--|--|有|有|有|有|--|ex|st|'
+                                            ],
+                                            map: {
+                                                SHH: '上海南',
+                                                KMM: '昆明'
+                                            }
+                                        }
+                                    }) : JSON.stringify({
                                         data: {
                                             flightItineraryList: []
                                         }
                                     }),
-                                    title: '机票列表'
+                                    title: isHotel ? '酒店列表' : isTrain ? '12306 车票预订' : '机票列表'
                                 };
                             }
                             return {
@@ -491,6 +546,40 @@ async function main() {
             assert.ok(search.ok);
             assert.equal(search.ok ? search.timedOut : true, false);
             assert.ok(search.ok ? search.body.includes('flightItineraryList') : false);
+            const hotelLane = await extensionSearchJob({
+                site: 'ctrip-hotel',
+                url: `https://${HOTEL_SITE_HOST}/hotels/list?city=220&checkin=2026-12-01&checkout=2026-12-03`,
+                timeoutMs: 3_000
+            });
+            assert.ok(hotelLane.ok, '酒店 search job 应放行(per-site 白名单)');
+            assert.ok(hotelLane.ok ? hotelLane.body.includes('hotelList') : false);
+            __resetRateLimiterForTest();
+            const hotelSession = await sessionHotelSearch({
+                to: '迪拜',
+                cityId: 220,
+                checkIn: '2026-12-01',
+                checkOut: '2026-12-03',
+                timeoutMs: 3_000
+            });
+            assert.equal(hotelSession.verdict, 'hit', `酒店会话检索应 hit,实际 ${hotelSession.verdict}:${hotelSession.error ?? ''}`);
+            assert.ok(hotelSession.evidence.includes('[会话:ctrip-hotel@'), '酒店证据链 [会话:ctrip-hotel@ts]');
+            assert.equal(hotelSession.hotels?.[0]?.name, 'Hotel X');
+            assert.equal(hotelSession.hotels?.[0]?.price, 680);
+            assert.ok(hotelSession.hotels?.[0]?.jumpUrl?.includes('/hotel/442516'), 'jumpUrl 由 hotelId 构造(预订由人在落地页完成)');
+            __resetRateLimiterForTest();
+            const trainSession = await sessionTrainSearch({
+                from: '上海',
+                to: '昆明',
+                date: '2026-12-01',
+                timeoutMs: 3_000
+            });
+            assert.equal(trainSession.verdict, 'hit', `火车会话检索应 hit,实际 ${trainSession.verdict}:${trainSession.error ?? ''}`);
+            assert.ok(trainSession.evidence.includes('[会话:train-12306@'), '火车证据链 [会话:train-12306@ts]');
+            assert.ok(trainSession.evidence.includes('公开查询面'), '证据链标注公开查询面(无登录闸的诚实口径)');
+            assert.equal(trainSession.trains?.[0]?.trainCode, 'G1375');
+            assert.equal(trainSession.trains?.[0]?.depTime, '07:35');
+            assert.equal(trainSession.trains?.[0]?.durationMin, 472);
+            assert.ok(trainSession.trains?.[0]?.jumpUrl?.includes('kyfw.12306.cn'), 'jumpUrl=查询落地页(人选车完成预订)');
             const login = await sessionLogin({
                 site: 'ctrip-flight'
             });
@@ -558,6 +647,35 @@ async function main() {
         assert.equal(e.quota_disposition, 'no_spend_waiting_user');
         assert.equal(e.retry_allowed, false);
     });
+    await check('needs-extension 自适应文案:本地已落位 → 双通道完整指引(含开发者模式)', ()=>{
+        const s = needsExtensionSummary({
+            localInstalled: true
+        });
+        assert.match(s, /开发者模式「加载已解压的扩展程序」/, '本地通道在 → 保留开发者模式指引');
+        assert.ok(s.includes(EXTENSION_STORE_URL), '商店 URL 仍在');
+    });
+    await check('needs-extension 自适应文案:本地未落位(商店版用户/未装)→ 自动跳过 dev-mode 文案', ()=>{
+        const s = needsExtensionSummary({
+            localInstalled: false
+        });
+        assert.doesNotMatch(s, /开发者模式/, '不再推开发者模式/本地通道(商店版用户不该被指导 load unpacked)');
+        assert.doesNotMatch(s, /加载已解压/, '不再出现 load unpacked 字样');
+        assert.match(s, /已从 Chrome 商店安装/, '给「已装商店版?」提示(打开 Chrome 即可,无需再装)');
+        assert.match(s, /应用商店一键装/, '未装用户仍得商店一键装指引');
+    });
+    await check('localExtensionInstalled:HOME 注入可测(manifest 存在=本地通道在)', ()=>{
+        const fakeHome = mkdtempSync(join(tmpdir(), 'gotry-ext-home-'));
+        assert.equal(localExtensionInstalled(fakeHome), false, '空 HOME → 本地通道未落位');
+        mkdirSync(join(fakeHome, '.gotry', 'extension'), {
+            recursive: true
+        });
+        writeFileSync(join(fakeHome, '.gotry', 'extension', 'manifest.json'), '{}', 'utf-8');
+        assert.equal(localExtensionInstalled(fakeHome), true, 'manifest 落位 → true');
+        rmSync(fakeHome, {
+            recursive: true,
+            force: true
+        });
+    });
     await b.close();
     console.log(`\n§38 extension bridge: ${passed} 段全绿`);
 }