@danceiny/gotry 0.0.1-rc.18 → 0.0.1-rc.20

package/dist/capabilities/doctor.js

@@ -0,0 +1,307 @@
+import { spawn } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { readLatestChannelEvents } from './channel-health.js';
+function hbcliCandidates(homeDir) {
+    return [
+        'hbcli',
+        join(homeDir, '.local/bin/hbcli'),
+        join(homeDir, '.staicli/current/hbcli')
+    ];
+}
+function probe(bin, args, timeoutMs = 8_000) {
+    return new Promise((resolveProbe)=>{
+        const child = spawn(bin, args, {
+            stdio: 'ignore',
+            env: process.env
+        });
+        let done = false;
+        const timer = setTimeout(()=>{
+            if (!done) {
+                done = true;
+                try {
+                    child.kill('SIGKILL');
+                } catch  {}
+                resolveProbe(false);
+            }
+        }, timeoutMs);
+        child.on('error', ()=>{
+            if (!done) {
+                done = true;
+                clearTimeout(timer);
+                resolveProbe(false);
+            }
+        });
+        child.on('exit', (code)=>{
+            if (!done) {
+                done = true;
+                clearTimeout(timer);
+                resolveProbe(code === 0);
+            }
+        });
+    });
+}
+export function nodeOk(version) {
+    const [maj = '0', min = '0'] = version.split('.');
+    return Number(maj) > 22 || Number(maj) === 22 && Number(min) >= 15;
+}
+export async function runDoctorChecks(opts = {}) {
+    const repoRoot = opts.repoRoot ? resolve(opts.repoRoot) : resolve(import.meta.dirname, '..', '..');
+    const home = opts.homeDir ?? homedir();
+    const env = opts.env ?? process.env;
+    const items = [];
+    const nodeVersion = process.versions.node;
+    items.push(nodeOk(nodeVersion) ? {
+        id: 'node',
+        label: 'Node 运行时',
+        status: 'ok',
+        detail: `Node ${nodeVersion}(≥22.15)`
+    } : {
+        id: 'node',
+        label: 'Node 运行时',
+        status: 'missing',
+        detail: `Node ${nodeVersion} 过旧(gotry 需 ≥22.15)`,
+        fix: '升级 Node.js 至 22.15+(https://nodejs.org)'
+    });
+    const extManifest = join(home, '.gotry', 'extension', 'manifest.json');
+    items.push(existsSync(extManifest) ? {
+        id: 'extension',
+        label: 'GoTry Session Bridge 扩展',
+        status: 'ok',
+        detail: `已就位(本地通道:${extManifest})`
+    } : {
+        id: 'extension',
+        label: 'GoTry Session Bridge 扩展',
+        status: 'missing',
+        detail: '本地通道未落位(~/.gotry/extension/manifest.json 不存在)。若你已从 Chrome 商店安装(自动更新,商店版 ID oeajpicc…),本项可忽略——会话检索可用性以运行时为准(gotry_session_search 的 verdict)。若未安装:应用商店一键装即可',
+        fix: '在 Chrome 应用商店一键安装(自动更新): https://chromewebstore.google.com/detail/gotry-session-bridge/oeajpiccmonococjcegddlooeeohlbgd'
+    });
+    const venvPython = join(repoRoot, '.venv/bin/python');
+    const reachBin = join(repoRoot, '.venv/bin/agent-reach');
+    if (existsSync(reachBin)) {
+        items.push({
+            id: 'agent-reach',
+            label: 'Agent Reach(网页/社媒读取)',
+            status: 'ok',
+            detail: `已安装(${reachBin});渠道凭证选配体检:在对话里调 gotry_agent_reach {action:"status"}`
+        });
+    } else if (existsSync(venvPython)) {
+        items.push({
+            id: 'agent-reach',
+            label: 'Agent Reach(网页/社媒读取)',
+            status: 'degraded',
+            detail: '.venv 存在但缺 agent-reach 包——gotry_agent_reach / gotry_web_search 读页会失败',
+            fix: `npx gotry doctor --fix(或在包根执行: ${venvPython} -m pip install git+https://github.com/Panniantong/Agent-Reach.git)`
+        });
+    } else {
+        items.push({
+            id: 'agent-reach',
+            label: 'Agent Reach(网页/社媒读取)',
+            status: 'missing',
+            detail: '未安装——gotry_agent_reach / gotry_web_search(读网页)/ gotry_video_subtitle / gotry_github_search 全部不可用',
+            fix: 'npx gotry doctor --fix'
+        });
+    }
+    let hbPresent = '';
+    for (const p of hbcliCandidates(home)){
+        if (p !== 'hbcli' && existsSync(p)) {
+            hbPresent = p;
+            break;
+        }
+        if (p === 'hbcli' && await probe(p, [
+            'version'
+        ])) {
+            hbPresent = 'hbcli(PATH)';
+            break;
+        }
+    }
+    if (hbPresent) {
+        const whoami = await probe(hbPresent === 'hbcli(PATH)' ? 'hbcli' : hbPresent, [
+            'auth',
+            'whoami'
+        ]);
+        items.push(whoami ? {
+            id: 'hbcli',
+            label: 'hbcli(酒店实时源)',
+            status: 'ok',
+            detail: `已安装且凭证有效(${hbPresent})`
+        } : {
+            id: 'hbcli',
+            label: 'hbcli(酒店实时源)',
+            status: 'degraded',
+            detail: '二进制在,但凭证未配置/失效——酒店检索将降级静态包(非实时)',
+            fix: 'hbcli auth set-credentials --app-key hotelbyte_api_demo --app-secret hotelbyte_api_demo(快速试用沙箱;正式 key 向 HotelByte 申请)'
+        });
+    } else {
+        items.push({
+            id: 'hbcli',
+            label: 'hbcli(酒店实时源)',
+            status: 'missing',
+            detail: '未安装——酒店检索降级静态包(公开渠道估算,非实时,仅覆盖内置场景)',
+            fix: 'npx gotry doctor --fix'
+        });
+    }
+    const flyaiKey = env.FLYAI_API_KEY?.trim();
+    const flyaiQuotaNote = !flyaiKey && opts.stateRoot ? await (async ()=>{
+        const ev = (await readLatestChannelEvents(opts.stateRoot)).get('flyai');
+        return ev?.state === 'down' ? `;最近一次试用达限: ${ev.at}(匿名共享池,正式 key 可解除)` : '';
+    })() : '';
+    items.push(flyaiKey ? {
+        id: 'flyai',
+        label: 'FlyAI(飞猪官方检索)',
+        status: 'ok',
+        detail: 'FLYAI_API_KEY 已配(正式 key,无试用额度限制)'
+    } : {
+        id: 'flyai',
+        label: 'FlyAI(飞猪官方检索)',
+        status: 'degraded',
+        detail: `未配 FLYAI_API_KEY——走匿名试用额度(共享,易达限;达限报 "Trial limit reached")${flyaiQuotaNote}`,
+        fix: '到 flyai.open.fliggy.com 控制台申请正式 key,配进环境变量 FLYAI_API_KEY;无 key 期间机/火/酒检索请以 gotry_session_search(账号会话)为主'
+    });
+    const sidebarPkg = join(home, '.dsh/profiles/web/node_modules/dsh-better-sidebar/package.json');
+    items.push(existsSync(sidebarPkg) ? {
+        id: 'sidebar',
+        label: 'dsh-better-sidebar(侧栏工作台)',
+        status: 'ok',
+        detail: '已安装——web UI 右侧工作台可预览产物与 doctor 报告(gotry-state/doctor-report.md)'
+    } : {
+        id: 'sidebar',
+        label: 'dsh-better-sidebar(侧栏工作台)',
+        status: 'missing',
+        detail: '未安装——dsh web 无右侧工作台,产物与 doctor 报告只能在对话里看(gotry_artifacts_list)',
+        fix: 'npx gotry doctor --fix'
+    });
+    const calStatePath = join(home, '.gotry', 'calendar.json');
+    const calEnabled = (()=>{
+        try {
+            return JSON.parse(readFileSync(calStatePath, 'utf-8'))?.enabled === true;
+        } catch  {
+            return false;
+        }
+    })();
+    const calProfilePatch = join(home, '.dsh/profiles/web/cordis.patch.yml');
+    const calConfigured = calEnabled && existsSync(calProfilePatch) && (()=>{
+        try {
+            const content = readFileSync(calProfilePatch, 'utf-8');
+            return /calendar/.test(content) && /username\s*:/.test(content);
+        } catch  {
+            return false;
+        }
+    })();
+    items.push(!calEnabled ? {
+        id: 'calendar',
+        label: 'dsh-calendar(日历工作窗口)',
+        status: 'ok',
+        detail: '默认未挂载(D-9:未配置的日历工具不进工具箱;工作窗口由访谈覆盖,不影响任何检索)'
+    } : calConfigured ? {
+        id: 'calendar',
+        label: 'dsh-calendar(日历工作窗口)',
+        status: 'ok',
+        detail: `已挂载且已配置(${calStatePath})`
+    } : {
+        id: 'calendar',
+        label: 'dsh-calendar(日历工作窗口)',
+        status: 'degraded',
+        detail: '已挂载但 calendar 未配置 username——日历工具会话中会报「未配置」',
+        fix: `npx gotry setup calendar --off(恢复默认不挂载),或在 ${calProfilePatch} 覆盖 calendar 行 config 填 username(指引: npx gotry setup calendar --status)`
+    });
+    const rootRequire = createRequire(join(repoRoot, 'package.json'));
+    const mapCandidates = [
+        join(repoRoot, 'ts/dsh-runtime/vendor/dsh-map-tools/lib/index.js'),
+        join(repoRoot, 'ts/dsh-runtime/node_modules/dsh-map-tools/lib/index.js'),
+        join(repoRoot, 'node_modules/dsh-map-tools/package.json'),
+        join(repoRoot, 'ts/node_modules/dsh-map-tools/package.json'),
+        join(home, '.dsh/profiles/web/node_modules/dsh-map-tools/package.json')
+    ];
+    let mapHit = mapCandidates.find((p)=>existsSync(p));
+    if (!mapHit) {
+        try {
+            mapHit = rootRequire.resolve('dsh-map-tools');
+        } catch  {
+            mapHit = undefined;
+        }
+    }
+    items.push(mapHit ? {
+        id: 'map-tools',
+        label: 'dsh-map-tools(地图/路线/POI)',
+        status: 'ok',
+        detail: `已就位(${mapHit})——地图工具可用(零 key,走 OSM/OSRM)`
+    } : {
+        id: 'map-tools',
+        label: 'dsh-map-tools(地图/路线/POI)',
+        status: 'missing',
+        detail: '未随包解析——启动时该 patch 条目被静默剔除,地图/路线/POI 工具不会出现在模型工具箱(缺地图不挡旅行规划,只少能力)',
+        fix: '重装 @danceiny/gotry(地图插件随包 vendor 分发,缺失多为安装不完整)'
+    });
+    const askCandidates = [
+        join(repoRoot, 'ts/dsh-runtime/vendor/deepseek-ai-dsh-tool-ask-user/package.json'),
+        join(repoRoot, 'node_modules/@deepseek-ai/dsh-tool-ask-user/package.json'),
+        join(home, '.dsh/profiles/web/node_modules/@deepseek-ai/dsh-tool-ask-user/package.json')
+    ];
+    let askHit = askCandidates.find((p)=>existsSync(p));
+    if (!askHit) {
+        try {
+            const reqFromDsh = createRequire(rootRequire.resolve('@deepseek-ai/dsh/lib/bin.js'));
+            askHit = reqFromDsh.resolve('@deepseek-ai/dsh-tool-ask-user');
+        } catch  {
+            try {
+                askHit = rootRequire.resolve('@deepseek-ai/dsh-tool-ask-user');
+            } catch  {
+                askHit = undefined;
+            }
+        }
+    }
+    items.push(askHit ? {
+        id: 'ask-user',
+        label: 'dsh-tool-ask-user(结构化澄清卡)',
+        status: 'ok',
+        detail: `已就位(${askHit})——ask_user_question 澄清卡可用(web 原生卡片;headless+TTY 用 stdio 提供方)`
+    } : {
+        id: 'ask-user',
+        label: 'dsh-tool-ask-user(结构化澄清卡)',
+        status: 'missing',
+        detail: '未解析——启动时澄清卡注入被静默剔除,模型只能散文追问(人格契约 (5) 退化文本形态)',
+        fix: '重装 @danceiny/gotry——该依赖随 dsh 闭包自带,缺失多为安装不完整'
+    });
+    items.push({
+        id: 'llm-key',
+        label: 'LLM key',
+        status: 'ok',
+        detail: '由 dsh 宿主 UI 管理——不在 doctor 体检范围(gotry 不接触、不回显凭证)'
+    });
+    const broken = items.filter((i)=>i.status !== 'ok' && i.id !== 'llm-key');
+    const summary = broken.length === 0 ? `体检通过:${items.length} 项全部就绪(可选依赖齐,LLM key 归 dsh 宿主管)。` : `体检发现 ${broken.length} 项待处理:${broken.map((i)=>`${i.label}(${i.status === 'missing' ? '未装' : '半可用'})`).join('、')}。补装:终端跑 npx gotry doctor --fix,或按各项 fix 指引逐项处理。`;
+    return {
+        ok: broken.length === 0,
+        items,
+        summary
+    };
+}
+const fixCell = (fix)=>!fix ? '—' : /^(npx|hbcli|curl|pip|python|\$)/.test(fix) ? `\`${fix}\`` : fix;
+export function renderDoctorReportMd(report, now = new Date()) {
+    const icon = (s)=>s === 'ok' ? '✅' : s === 'degraded' ? '⚠️' : '❌';
+    const lines = [
+        '# GoTry 依赖体检报告(doctor)',
+        '',
+        `> 生成于 ${now.toISOString()};重新生成:终端 \`npx gotry doctor\`,或在对话里让助手调 gotry_doctor。`,
+        '',
+        '| 状态 | 依赖 | 现状 | 修复指引 |',
+        '|---|---|---|---|',
+        ...report.items.map((i)=>`| ${icon(i.status)} | ${i.label} | ${i.detail} | ${fixCell(i.fix)} |`),
+        '',
+        `**结论**:${report.summary}`,
+        '',
+        '---',
+        '',
+        '- `npx gotry doctor` 随时可重跑(只读,不改任何东西);',
+        '- `npx gotry doctor --fix` 按上表补装(hbcli 官方脚本 / agent-reach pip / dsh-better-sidebar 插件);',
+        '- LLM key 由 dsh 宿主 UI 管理,gotry 永不体检、不回显。',
+        ''
+    ];
+    return lines.join('\n');
+}
+
+
+//# sourceURL=ts/capabilities/doctor.ts

package/dist/capabilities/effect.js

@@ -1,9 +1,76 @@
 import { CircuitBreaker, withRetry } from './resilience.js';
 import { flyaiSearch } from './flyai.js';
 import { checkAvail, hotelRates, searchHotels } from './hbcli.js';
-import { sessionFlightSearch } from './session-search.js';
+import { sessionFlightSearch, sessionHotelSearch, sessionTrainSearch } from './session-search.js';
 import { geocodePlace, getClimate, getForecast } from './weather.js';
 import { verifyFlight } from './opensky.js';
+import { anythingSearch } from './anything.js';
+import { continentListUrl, countryPageUrl, extractVisaSection, fetchVisaPolicyPage, listCountryPaths, policyFactsFromMfa } from './visa-policy.js';
+import { readUrl, reach, reachStatus } from './agent-reach.js';
+import { githubSearch, videoSubtitle } from './agent-reach-deep.js';
+import { sessionLogin } from './session-login.js';
+async function fetchVisaPolicyEntries(p) {
+    const started = Date.now();
+    const fetchedAt = new Date().toISOString();
+    const countries = [];
+    const facts = [];
+    const targets = [];
+    if (p.country) {
+        targets.push({
+            continent: p.continent ?? 'yz_645708',
+            country: p.country
+        });
+    } else if (p.continent) {
+        const listUrl = continentListUrl(p.continent);
+        if (!listUrl) return {
+            ok: false,
+            via: 'visa-policy-error',
+            evidence: `[visa-policy@${fetchedAt}] 非法洲路径`,
+            latencyMs: 0,
+            facts: [],
+            countries: [],
+            error: 'invalid_continent'
+        };
+        const page = await fetchVisaPolicyPage(listUrl, p.timeoutMs);
+        if (!page.ok || !page.html) return {
+            ok: false,
+            via: 'visa-policy-error',
+            evidence: `[visa-policy@${fetchedAt}] 洲列表抓取失败: ${page.error ?? '?'}`,
+            latencyMs: 0,
+            facts: [],
+            countries: [],
+            error: page.error
+        };
+        for (const c of listCountryPaths(page.html, p.continent).slice(0, Math.max(1, Math.min(10, p.limit ?? 10))))targets.push({
+            continent: p.continent,
+            country: c
+        });
+    }
+    for (const t of targets){
+        const url = countryPageUrl(t.continent, t.country);
+        if (!url) continue;
+        const page = await fetchVisaPolicyPage(url, p.timeoutMs);
+        countries.push(t.country);
+        if (!page.ok || !page.html) continue;
+        const section = extractVisaSection(page.html);
+        if (!section) continue;
+        facts.push(...policyFactsFromMfa({
+            countryLabel: t.country,
+            countryPath: t.country,
+            section,
+            fetchedAt
+        }));
+    }
+    const evidence = facts.length > 0 ? `[visa-policy:cs-mfa@${fetchedAt}] ${facts.length} 条政策事实(抓取 ${countries.length} 国)` : `[visa-policy@${fetchedAt}] 0 条(页面缺「签证入境」章节或抓取失败;不落负事实)`;
+    return {
+        ok: true,
+        via: 'cs-mfa',
+        evidence,
+        latencyMs: Date.now() - started,
+        facts,
+        countries
+    };
+}
 const DEFAULT_HANDLERS = {
     FLYAI_SEARCH: (p)=>flyaiSearch(p),
     HBCLI_HOTEL_SEARCH: (p)=>searchHotels({
@@ -35,6 +102,8 @@ const DEFAULT_HANDLERS = {
             timeoutMs: p.timeoutMs
         }),
     SESSION_FLIGHT_SEARCH: (p)=>sessionFlightSearch(p),
+    SESSION_HOTEL_SEARCH: (p)=>sessionHotelSearch(p),
+    SESSION_TRAIN_SEARCH: (p)=>sessionTrainSearch(p),
     WEATHER_GEOCODE: (p)=>geocodePlace(p.name, {
             count: p.count,
             timeoutMs: p.timeoutMs
@@ -52,7 +121,24 @@ const DEFAULT_HANDLERS = {
         }, p.month, {
             timeoutMs: p.timeoutMs
         }),
-    OPENSKY_FLIGHT_VERIFY: (p)=>verifyFlight(p)
+    OPENSKY_FLIGHT_VERIFY: (p)=>verifyFlight(p),
+    ANYTHING_SEARCH: (p)=>anythingSearch(p),
+    WEB_READ: (p)=>readUrl({
+            url: p.url,
+            timeoutMs: p.timeoutMs
+        }),
+    GITHUB_SEARCH: (p)=>githubSearch(p),
+    VIDEO_SUBTITLE: (p)=>videoSubtitle(p),
+    AGENT_REACH: (p)=>p.action === 'status' || !p.action && !p.channel ? reachStatus(p.timeoutMs) : reach({
+            channel: p.channel ?? '',
+            method: p.method ?? '',
+            args: p.args,
+            timeoutMs: p.timeoutMs
+        }),
+    SESSION_LOGIN: (p)=>sessionLogin({
+            waitMs: typeof p.waitSeconds === 'number' ? p.waitSeconds * 1000 : undefined
+        }),
+    VISA_POLICY_FETCH: (p)=>fetchVisaPolicyEntries(p)
 };
 const defaultIsFailure = (r)=>r?.ok === false;
 const flyaiTransient = (msg)=>msg.length > 0 && !/Sentinel/i.test(msg) && /timeout|timed out|ECONNRESET|ECONNREFUSED|ETIMEDOUT|socket|HTTP 5/i.test(msg);
@@ -65,6 +151,15 @@ const API_BREAKER = {
     failureThreshold: 3,
     openMs: 30_000
 };
+const hbcliTimeout = (r)=>{
+    const msg = String((r ?? {}).error ?? '');
+    return msg.length > 0 && /timeout/i.test(msg);
+};
+const HBCLI_RETRY = {
+    maxAttempts: 2,
+    baseDelayMs: 300,
+    maxDelayMs: 1_000
+};
 const SPECS = {
     FLYAI_SEARCH: {
         channel: 'cli',
@@ -85,7 +180,8 @@ const SPECS = {
     },
     HBCLI_HOTEL_SEARCH: {
         channel: 'cli',
-        retry: null,
+        retry: HBCLI_RETRY,
+        isRetryable: (r)=>hbcliTimeout(r),
         breaker: {
             failureThreshold: 3,
             openMs: 60_000
@@ -94,7 +190,8 @@ const SPECS = {
     },
     HBCLI_HOTEL_RATES: {
         channel: 'cli',
-        retry: null,
+        retry: HBCLI_RETRY,
+        isRetryable: (r)=>hbcliTimeout(r),
         breaker: {
             failureThreshold: 3,
             openMs: 60_000
@@ -103,7 +200,8 @@ const SPECS = {
     },
     HBCLI_CHECK_AVAIL: {
         channel: 'cli',
-        retry: null,
+        retry: HBCLI_RETRY,
+        isRetryable: (r)=>hbcliTimeout(r),
         breaker: {
             failureThreshold: 3,
             openMs: 60_000
@@ -116,6 +214,18 @@ const SPECS = {
         breaker: null,
         isFailure: defaultIsFailure
     },
+    SESSION_HOTEL_SEARCH: {
+        channel: 'browser',
+        retry: null,
+        breaker: null,
+        isFailure: defaultIsFailure
+    },
+    SESSION_TRAIN_SEARCH: {
+        channel: 'browser',
+        retry: null,
+        breaker: null,
+        isFailure: defaultIsFailure
+    },
     WEATHER_GEOCODE: {
         channel: 'api',
         retry: API_RETRY,
@@ -140,6 +250,69 @@ const SPECS = {
         breaker: API_BREAKER,
         isRetryable: (_r, e)=>e != null || (_r ?? {}).verdict === 'unavailable',
         isFailure: (r)=>r.via === 'opensky-error'
+    },
+    ANYTHING_SEARCH: {
+        channel: 'cli',
+        retry: HBCLI_RETRY,
+        isRetryable: (r)=>hbcliTimeout(r),
+        breaker: {
+            failureThreshold: 3,
+            openMs: 60_000
+        },
+        isFailure: (r)=>r.via === 'hbcli-anything-error'
+    },
+    WEB_READ: {
+        channel: 'api',
+        retry: API_RETRY,
+        breaker: API_BREAKER,
+        isFailure: (r)=>r.via === 'r.jina.ai-error'
+    },
+    GITHUB_SEARCH: {
+        channel: 'cli',
+        retry: HBCLI_RETRY,
+        isRetryable: (r)=>r.verdict === 'timeout',
+        breaker: {
+            failureThreshold: 3,
+            openMs: 60_000
+        },
+        isFailure: (r)=>{
+            const v = r.verdict;
+            return v === 'error' || v === 'timeout';
+        }
+    },
+    VIDEO_SUBTITLE: {
+        channel: 'cli',
+        retry: HBCLI_RETRY,
+        isRetryable: (r)=>r.verdict === 'timeout',
+        breaker: {
+            failureThreshold: 3,
+            openMs: 60_000
+        },
+        isFailure: (r)=>{
+            const v = r.verdict;
+            return v === 'error' || v === 'timeout';
+        }
+    },
+    AGENT_REACH: {
+        channel: 'cli',
+        retry: null,
+        breaker: null,
+        isFailure: (r)=>r.verdict === 'error'
+    },
+    SESSION_LOGIN: {
+        channel: 'browser',
+        retry: null,
+        breaker: null,
+        isFailure: defaultIsFailure
+    },
+    VISA_POLICY_FETCH: {
+        channel: 'api',
+        retry: null,
+        breaker: {
+            failureThreshold: 2,
+            openMs: 300_000
+        },
+        isFailure: defaultIsFailure
     }
 };
 export function declinedObservation(effect, trace) {

package/dist/capabilities/flyai.js

@@ -150,6 +150,19 @@ export async function flyaiSearch(q) {
     });
     const latencyMs = Date.now() - started;
     if (r.error || r.code !== 0) {
+        const upstream = `${r.stderr}\n${r.stdout}`;
+        if (/Trial limit reached|HTTP\s*429|\b429\b/.test(upstream)) {
+            return {
+                ...base,
+                latencyMs,
+                ok: false,
+                via: 'flyai-error',
+                verdict: 'needs-setup',
+                evidence: `[实时API:flyai@error@${ts}] trial quota exhausted`,
+                error: `FlyAI 匿名试用额度已用尽(上游 429):${upstream.replace(/\s+/g, ' ').slice(0, 160)}`,
+                setup: 'FlyAI 试用额度达限——到 flyai.open.fliggy.com 控制台申请正式 API Key,配入环境变量 FLYAI_API_KEY 即恢复;本会话请勿重试 gotry_flyai_search,机/火/酒改走 gotry_session_search(账号会话)或 web 检索推进。'
+            };
+        }
         return {
             ...base,
             latencyMs,

package/dist/capabilities/hbcli.js

@@ -112,6 +112,25 @@ export async function callHbcliJson(args, opts = {}) {
     }
     return last;
 }
+function i18nName(v) {
+    if (!v) return '';
+    if (typeof v === 'string') return v;
+    return v.zh || v.en || v.ar || '';
+}
+function hotelLines(result, max = 8) {
+    const list = result?.list;
+    if (!Array.isArray(list) || list.length === 0) return '';
+    const lines = [];
+    for (const item of list.slice(0, max)){
+        const h = item;
+        const name = i18nName(h.name) || `hotel ${h.id ?? '?'}`;
+        const star = typeof h.star === 'number' && h.star > 0 ? ` ${h.star}★` : '';
+        const price = h.minPrice && typeof h.minPrice.amount === 'number' ? ` 低至 ${h.minPrice.amount}${h.minPrice.currency ? ` ${h.minPrice.currency}` : ''}` : '';
+        lines.push(`- id=${h.id ?? '?'} ${name}${star}${price}`);
+    }
+    if (list.length > max) lines.push(`…(共 ${list.length} 家,仅列前 ${max})`);
+    return lines.join('\n');
+}
 export async function searchHotels(query, opts = {}) {
     const hbArgs = [
         'search',
@@ -121,6 +140,8 @@ export async function searchHotels(query, opts = {}) {
         '10'
     ];
     if (query.destination) hbArgs.push('--destination-name', query.destination);
+    if (query.checkIn) hbArgs.push('--check-in', query.checkIn);
+    if (query.checkOut) hbArgs.push('--check-out', query.checkOut);
     if (query.adults) hbArgs.push('--room-occupancies', JSON.stringify([
         {
             adultCount: query.adults,
@@ -129,10 +150,15 @@ export async function searchHotels(query, opts = {}) {
     ]));
     const live = await callHbcliJson(hbArgs, opts);
     if (live.via === 'hbcli-realtime') {
+        const list = live.result?.list;
+        const n = Array.isArray(list) ? list.length : 0;
+        const dateTag = query.checkIn ? `入住 ${query.checkIn}${query.checkOut ? ` → 退房 ${query.checkOut}` : ''}` : '未传日期(上游按当前窗口价)';
+        const lines = hotelLines(live.result);
+        const summary = `${query.destination}:hbcli 实时 ${n} 家(${dateTag})${lines ? `\n${lines}` : ''}\n${live.evidence}`;
         return {
             ...live,
             hotels: live.result,
-            summary: `${query.destination}:hbcli 实时返回${query.checkIn || query.checkOut ? '(日期不传上游 list,以当前窗口房价返回)' : ''}`
+            summary
         };
     }
     const rawReason = live.error ?? live.via;
@@ -151,7 +177,7 @@ export async function searchHotels(query, opts = {}) {
                     hotels: {
                         stays: matched
                     },
-                    summary: `${query.destination}:hbcli 实时源不可用(${reason}),已降级到静态包(公开渠道估算,非实时),命中 ${matched.length} 个住宿块`
+                    summary: `${query.destination}:hbcli 实时源不可用(${reason}),已降级到静态包(公开渠道估算,非实时),命中 ${matched.length} 个住宿块:\n${JSON.stringify(matched).slice(0, 1600)}`
                 };
             }
             return {