@danceiny/gotry 0.2.0-rc.27 → 0.2.0-rc.29

package/extension/README.zh-CN.md

@@ -2,7 +2,7 @@
 
 # Stai 浏览器扩展
 
-Stai（原名 GoTry Session Bridge）将已支持的旅行检索页面连接至 GoTry。商店版与本地加载版的扩展 ID 不同，但使用相同的桥接合同。
+Stai（原名 Stai Travel Bridge）将已支持的旅行检索页面连接至 GoTry。商店版与本地加载版的扩展 ID 不同，但使用相同的桥接合同。
 
 ## 功能
 

package/extension/background.js

@@ -1,5 +1,5 @@
 /**
- * GoTry Session Bridge — MV3 Service Worker(RFC docs/rfc/user-session-data-rfc.md §2.2 通道 C,2026-08-29 定案为 PRIMARY 传输)。
+ * Stai Travel Bridge — MV3 Service Worker(RFC docs/rfc/user-session-data-rfc.md §2.2 通道 C,2026-08-29 定案为 PRIMARY 传输)。
  *
  * 职责(与 Node 侧 session/extension-bridge.ts 配对,零构建纯 JS):
  *   - 长轮询取活:POST /jobs(桥最多 hold 20s;每次响应/失败都重置 SW 30s 生命周期,任务秒级触达);

package/extension/content-bridge.js

@@ -1,5 +1,5 @@
 /**
- * GoTry Session Bridge — ISOLATED-world 桥(manifest 默认 world,document_start)。
+ * Stai Travel Bridge — ISOLATED-world 桥(manifest 默认 world,document_start)。
  *
  * MAIN world(content-main.js)拿不到 chrome API;本脚本监听页面里的
  * gotry-ctrip-sniff 自定义事件,把响应文本经 chrome.runtime.sendMessage 转发给

package/extension/content-main.js

@@ -1,5 +1,5 @@
 /**
- * GoTry Session Bridge — MAIN-world 网络嗅探(manifest world:"MAIN",document_start)。
+ * Stai Travel Bridge — MAIN-world 网络嗅探(manifest world:"MAIN",document_start)。
  *
  * MAIN world 没有 chrome.runtime,只负责:hook 站点自己的 fetch/XHR,把命中
  * 嗅探面的响应文本以 CustomEvent 派发到页面里;ISOLATED 侧的 content-bridge.js

package/extension/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Stai Travel Bridge",
-  "version": "0.2.0.27",
+  "version": "0.2.0.29",
   "description": "Stai 连接获准的旅行检索与供应商门户：检索结果经本机或授权后端桥接；门户可触发一次性登录代填，扩展不持久保存凭据。",
   "key": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAnuzBX8rT8+RZKEUip5VRA0cY056pExy9PNdN9YCiuY3dgglRbcIBhjuFJoR6EX3/MaUv82vJVyItRVrowXLTwDk4WZof0vwFgKL0zBK304PC46pUaAKTSu1PgXeL1+j5KTAGz/9a9+RnPdbj7jND5rM/MOmBHNPVPpp1NlwxRGIgF9OxHSOfXORcH4Iyte1aJSFUJbFtNS/DaE5D+KjyupPLyIqVN/dCiKnNsTCEHQB9ngeli665PFp76hkccHQQZ4sVuMLS4zBPcazUsp1kcnW+xsQoUATkODTCY+Pzk3zUVF1QOESTjRCVnbNi8tkO43RMRs2q63gX/3inFivcEwIDAQAB",
   "permissions": [
@@ -56,5 +56,5 @@
       "run_at": "document_start"
     }
   ],
-  "version_name": "0.2.0-rc.27"
+  "version_name": "0.2.0-rc.29"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danceiny/gotry",
-  "version": "0.2.0-rc.27",
+  "version": "0.2.0-rc.29",
   "description": "GoTry — 从出发到下一次出发的 AI 旅行 Agent(dsh 插件)。npm/源码入口共用锁定的 dsh runtime + README 安装路径。",
   "type": "module",
   "main": "ts/src/index.ts",

package/ts/capabilities/anything.ts

@@ -19,6 +19,12 @@
  *   - miss: hbcli exit 0,但 candidates 为空(查无结果)
  *   - err:  hbcli exit ≠ 0 或超时(降级,降级产物 标 [实时API:hbcli-anything@error@ts])
  *
+ * 离线开关(issue #617;与会话通道 GOTRY_SESSION_LIVE 同形,方向相反以保持产品默认不变):
+ *   GOTRY_HBCLI_LIVE=0|false|off(不分大小写)→ 零 spawn、不碰凭据与后端,走同一条降级面
+ *   (verdict=error,证据标 [实时API:hbcli-anything@offline@ts]);未设或任何其他取值 = 与此前
+ *   完全一致(hbcli 可用即 live)。判定见 hbcliLiveEnabled;mock/dry-run harness(nightly-evidence --dry-run、
+ *   persona-sim、replay*)缺省把它置 0,operator 显式设置的值不覆盖。
+ *
  * 契约(与 hbcli/weather/opensky 同构,L4 不变量):
  *   - 永不抛错:网络/超时/解析失败一律降级返回;
  *   - 证据链标注:成功 [实时API:hbcli-anything@ts];失败 [实时API:hbcli-anything@error@ts];
@@ -157,6 +163,16 @@ function failureReason(
     : `hbcli 退出码 ${r.code},未返回可判定结果(本轮按降级处理)`) + suffix
 }
 
+/**
+ * 实时 hbcli 通道是否开启(issue #617)。只有显式写 0 / false / off(不分大小写,忽略首尾空白)
+ * 才关闭;未设或任何其他取值都视为开启——终端用户依赖的实时源缺省不丢。调用时读取,
+ * 测试与 harness 可在进程内切换。
+ */
+export function hbcliLiveEnabled(env: Partial<Pick<NodeJS.ProcessEnv, 'GOTRY_HBCLI_LIVE'>> = process.env): boolean {
+  const v = (env.GOTRY_HBCLI_LIVE ?? '').trim().toLowerCase()
+  return v !== '0' && v !== 'false' && v !== 'off'
+}
+
 /** Anything 通用搜索 — 任何搜索失败走降级;不抛错 */
 export async function anythingSearch(q: AnythingQuery): Promise<AnythingResult> {
   const started = Date.now()
@@ -180,6 +196,17 @@ export async function anythingSearch(q: AnythingQuery): Promise<AnythingResult>
       latencyMs: 0, verdict: 'error', error: 'aborted by host signal',
     }
   }
+  // 离线开关:位置在入参校验与 pre-abort 之后,既有入参的既有结果/原因串逐字节不变;
+  // 关闭时与「未装配 hbcli」同形降级(ok:false / hbcli-anything-error / verdict:error + 人话原因,
+  // 无进程噪音,也不含 timeout 字样——效应层只重试 timeout 类),且不 spawn、不重试。
+  if (!hbcliLiveEnabled()) {
+    return {
+      ok: false, via: 'hbcli-anything-error',
+      evidence: `[实时API:hbcli-anything@offline@${ts}] GOTRY_HBCLI_LIVE switched off; live channel closed, zero spawn`,
+      latencyMs: Date.now() - started, verdict: 'error',
+      error: 'hbcli 实时通道已关闭(GOTRY_HBCLI_LIVE 离线开关;本轮按降级处理,未发起查询)',
+    }
+  }
   let r: Awaited<ReturnType<typeof spawnBounded>> = { code: null, stdout: '', stderr: '', aborted: false, timedOut: false }
   for (let i = 0; i < candidates.length; i++) {
     r = await sh(candidates[i]!, args, { timeoutMs: q.timeoutMs ?? 12_000, env: process.env, signal: q.signal })

package/ts/capabilities/session/extension-bridge.ts

@@ -62,17 +62,17 @@ export function localExtensionInstalled(home = homedir()): boolean {
  * 影响面统一行:账号会话通道断 → 列表底部工具不提供;其余工具不受影响。
  * 纯函数(默认 HOME 可注入)。
  *
- * 双语对照:CN=本函数返回值;EN 权威见 docs/capability-onboarding.md「Session Bridge 安装」段。
+ * 双语对照:CN=本函数返回值;EN 权威见 docs/capability-onboarding.md「Stai Travel Bridge 安装」段。
  */
 const EXTENSION_IMPACT_LINE = '影响面:gotry_session_search / gotry_session_login(账号会话通道)不可用;携程机票/酒店实时检索、12306 余票、Dida 实时报价都依赖此通道。其它工具(机票 FlyAI、酒店 hbcli、地图、天气等)不受影响。'
 export function needsExtensionSummary(opts: { localInstalled?: boolean; home?: string } = {}): string {
   const local = opts.localInstalled ?? localExtensionInstalled(opts.home)
   if (local) {
-    return 'GoTry Session Bridge 扩展未连接(未安装或已停用)。推荐 Chrome 应用商店一键装(自动更新) '
+    return 'Stai Travel Bridge 扩展未连接(未安装或已停用)。推荐 Chrome 应用商店一键装(自动更新) '
       + `${EXTENSION_STORE_URL} ;或 npx @danceiny/gotry setup 落位后 chrome://extensions 开发者模式「加载已解压的扩展程序」指向 ~/.gotry/extension。`
       + EXTENSION_IMPACT_LINE
   }
-  return 'GoTry Session Bridge 扩展未连接。若你已从 Chrome 商店安装(自动更新):打开 Chrome 并确认扩展已启用即可自动连接,无需再装。'
+  return 'Stai Travel Bridge 扩展未连接。若你已从 Chrome 商店安装(自动更新):打开 Chrome 并确认扩展已启用即可自动连接,无需再装。'
     + `若尚未安装:应用商店一键装 ${EXTENSION_STORE_URL} (装完零弹窗,浏览器自己当安装器)。`
     + EXTENSION_IMPACT_LINE
 }

package/ts/capabilities/session-search.ts

@@ -2,7 +2,7 @@
  * 会话检索编排层(RFC §3.2):transport → adapter entry → networkHint 嗅探 → 解析 → ReadGuard → 证据链。
  *
  * 传输车道(2026-08-29 定案,RFC §2.2):**扩展桥为默认**——一次性安装的 MV3 扩展
- * (GoTry Session Bridge)在自己标签页被动嗅探 batchSearch,零 Chrome 系统弹窗;
+ * (Stai Travel Bridge)在自己标签页被动嗅探 batchSearch,零 Chrome 系统弹窗;
  *  cdp(attach 日常 Chrome,Chrome 144+ 每连接弹权限框)降为显式后备
  * (`GOTRY_SESSION_TRANSPORT=cdp` opt-in,诊断/测试用);persistent 仅测试。
  *

package/ts/scripts/state-cli.ts

@@ -4,6 +4,8 @@
  *   migrate [root]                      one-shot 迁移:旧 JSON/JSONL → 账本 events
  *                                       (导入前自动快照到 gotry-state/pre-ledger-backup/)
  *   export [root]                       local-only:账本 → 旧文件名视图(红线 6:可见可导出;单向,不回流)
+ *                                       另含会话双区派生视图(P4-2):hot-context.jsonl /
+ *                                       notebook.json,从事件 fold 渲染——视图永不是写路径
  *   log [root] [--limit N]              事件账本尾部(append-only 审计面)
  *   stats [root]                        各面计数
  *   rebuild [root] [toSeq]              DROP 投影 → fold 重放(可截到 toSeq;账本/投影
@@ -48,6 +50,11 @@
 import { mkdirSync, renameSync, writeFileSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { ensureLedger, ledgerDbPath, ledgerExists, openLedgerIfExists } from '../src/state-ledger.ts'
+import {
+  ZONE_EXPORT_HOT_FILE,
+  ZONE_EXPORT_NOTEBOOK_FILE,
+  readZoneExportViews,
+} from '../src/session-zone-ledger.ts'
 import { formatRepairPlan, loadEvidenceMappingFile, planLedgerRepair } from '../src/ledger-repair-plan.ts'
 import {
   applyLedgerRepair,
@@ -405,6 +412,17 @@ switch (cmd) {
     if (utility.length) atomicWrite(join(dir, 'memory-utility.jsonl'), utility.map(e => JSON.stringify(e)).join('\n') + '\n')
     const trips = ledger.readTrips()
     if (trips.length) atomicWrite(join(dir, 'trips.jsonl'), trips.map(e => JSON.stringify(e)).join('\n') + '\n')
+    // 会话双区派生视图(P4-2,design/session-dual-zone-memory-design.md §2):
+    // 从六个事件 kind 的确定性 fold 渲染;空分区不产生空文件(同既有视图纪律)。
+    // 日志触读上界即拒:导出残缺视图比不导出更坏(读者会当它是全量)。
+    const zone = readZoneExportViews(ledger)
+    if (!zone.ok) {
+      console.error(`${zone.code}: ${zone.detail}`)
+      process.exit(1)
+    }
+    const zoneViews = zone.views
+    if (zoneViews.hotContextJsonl) atomicWrite(join(dir, ZONE_EXPORT_HOT_FILE), zoneViews.hotContextJsonl)
+    if (zoneViews.notebookJson !== '[]') atomicWrite(join(dir, ZONE_EXPORT_NOTEBOOK_FILE), zoneViews.notebookJson)
     console.log(`视图已导出(单向,DB→文件;红线 6):${dir}/`)
     break
   }

package/ts/src/contracts.ts

@@ -76,11 +76,15 @@ export interface TripState {
 // ---- 求解结果(unified 求解器输出的契约化引用) ----------------------------------
 
 export interface SolveResult {
+  /** `solver_error` 存在时,`feasible: false` 只表示「没有产出可行解」,
+   *  **不表示「不可行」**(issue #620):那一轮求解器自己失败了,判定缺席。 */
   feasible: boolean
   money_cny?: number
   legs?: Array<Record<string, unknown> & { leg: string }>
   red_flags?: string[]
   unsat_core?: string[]
+  /** 求解器自身失败(非判定)。机器 token 只住 `code`,不进用户面「冲突」文案。 */
+  solver_error?: { code: string; message: string }
   suggestions?: Array<{ relax: string; money_cny?: number }>
   work_window_exclusions?: Array<{ segment: string; option: string; reason: string }>
   skeleton_notes?: string[]

package/ts/src/dsh-llm.ts

@@ -1,7 +1,8 @@
 /**
  * 真 LlmPort:OpenAI 兼容接口的 provider 中立适配器(DeepSeek/MiniMax-M2 实测)。
  * 零新依赖(node 内建 fetch)。环境变量:LLM_API_KEY/LLM_BASE_URL/LLM_MODEL
- * (兼容旧 DEEPSEEK_* 别名)。MiniMax-M2 是推理模型:输出带 <think> 块,
+ * (兼容旧 DEEPSEEK_* 别名);GOTRY_LLM_TIMEOUT_MS = 单次请求总预算(默认 300000ms,
+ * 非正整数忽略)。MiniMax-M2 是推理模型:输出带 <think> 块,
  * 必须先剥离再解析——JSON 藏在 think 里是常见失败模式。
  * 无 key 时抛出明确错误,replay-real 自动回退 mock(ADR-8)。
  * 责任铁律不变:本适配器只做翻译/润色/解释,判定与算术在确定性组件。
@@ -37,11 +38,100 @@ function emptyUsage(): LlmUsageTracker {
   return { calls: 0, inputTokens: 0, outputTokens: 0, inputCacheHitTokens: 0, inputCacheMissTokens: 0, responsesMissingUsage: 0 }
 }
 
-async function chat(messages: Array<{ role: 'system' | 'user' | 'assistant'; content: string }>, json: boolean, usage?: LlmUsageTracker): Promise<string> {
+/** 单次请求(连接→响应头→正文读完)的默认总预算:对推理模型足够宽松,只兜「连上了却永不应答」的卡死。 */
+export const DEFAULT_LLM_TIMEOUT_MS = 300_000
+/**
+ * 超时上限 = 2^31-1 ms(≈24.8 天)。Node 对更大的延迟会溢出并**悄悄改成 1ms**
+ * (TimeoutOverflowWarning),即「配得越大越立刻超时」——所以必须夹住,绝不原样透传。
+ */
+const MAX_LLM_TIMEOUT_MS = 2_147_483_647
+
+/**
+ * chat() 的请求级选项。timeoutMs 压过环境变量 GOTRY_LLM_TIMEOUT_MS;signal 由调用方持有并与
+ * 超时合并(AbortSignal.any)——任一先触发就终止本次请求,落成 LlmRequestError。
+ */
+export interface LlmRequestOptions {
+  timeoutMs?: number
+  signal?: AbortSignal
+}
+
+/** 只认十进制正整数(数值或纯数字串);其余(0/负数/小数/NaN/带单位/空串)一律 undefined——绝不退化成「无超时」。 */
+function parseTimeoutMs(raw: unknown): number | undefined {
+  const n = typeof raw === 'string' ? (/^\d+$/.test(raw.trim()) ? Number(raw.trim()) : Number.NaN) : raw
+  return typeof n === 'number' && Number.isSafeInteger(n) && n > 0 ? Math.min(n, MAX_LLM_TIMEOUT_MS) : undefined
+}
+
+/** 解析顺序:本次调用显式值 > 环境变量 GOTRY_LLM_TIMEOUT_MS(调用时取值,同 base()/model())> 默认值。 */
+export function resolveLlmTimeoutMs(callMs?: number): number {
+  return parseTimeoutMs(callMs) ?? parseTimeoutMs(process.env['GOTRY_LLM_TIMEOUT_MS']) ?? DEFAULT_LLM_TIMEOUT_MS
+}
+
+export type LlmRequestFailureCode = 'timeout' | 'aborted'
+
+/**
+ * chat() 请求被截断(超时 / 调用方取消)的类型化失败——不是挂起,也不会被吞。
+ * 与既有错误形态一致,而非另起一套:
+ *  - message 沿用本模块 `llm <kind>: <detail>` 约定(同 `llm 429: …`),只读 .message 的调用方
+ *    (nightly-evidence / persona-sim / time-eval --real)原样可用;
+ *  - name 取平台既有名 TimeoutError / AbortError(AbortSignal.timeout 与手动 abort 抛的同名),
+ *    persona-sim、channel-probe 等按 name 分类的代码零改动即可识别;
+ *  - cause 保留 fetch 抛出的原始错误(调用方自定义的 abort reason 也在其中)。
+ * HTTP 非 2xx(`llm <status>`)、DNS/连接重置、坏 JSON 仍是原样的普通 Error——只改写「被我们的 signal 终止」的失败。
+ */
+export class LlmRequestError extends Error {
+  readonly code: LlmRequestFailureCode
+  /** 本次生效的超时预算;仅 code === 'timeout' 有值 */
+  readonly timeoutMs: number | undefined
+
+  constructor(code: LlmRequestFailureCode, detail: string, options: { cause?: unknown; timeoutMs?: number } = {}) {
+    super(`llm ${code}: ${detail}`, options.cause === undefined ? undefined : { cause: options.cause })
+    this.name = code === 'timeout' ? 'TimeoutError' : 'AbortError'
+    this.code = code
+    this.timeoutMs = options.timeoutMs
+  }
+}
+
+interface ChatCompletion {
+  choices: Array<{ message: { content: string } }>
+  usage?: { prompt_tokens?: number; completion_tokens?: number; prompt_cache_hit_tokens?: number; prompt_cache_miss_tokens?: number }
+}
+
+/**
+ * 发一次请求并读完正文。**同一个 signal 贯穿 fetch 与 res.json()/res.text()**,所以超时覆盖整个请求
+ * (含「响应头已到、正文卡住」与「非 2xx 的错误正文卡住」),调用方取消同理。
+ * 只有「被我们的 signal 终止」才改写成 LlmRequestError;其余错误原样上抛。
+ */
+async function requestCompletion(
+  url: string,
+  init: { headers: Record<string, string>; body: string },
+  request: LlmRequestOptions,
+): Promise<{ ok: true; data: ChatCompletion } | { ok: false; status: number; text: string }> {
+  const timeoutMs = resolveLlmTimeoutMs(request.timeoutMs)
+  const timeout = AbortSignal.timeout(timeoutMs)
+  const signal = request.signal ? AbortSignal.any([request.signal, timeout]) : timeout
+  try {
+    const res = await fetch(url, { method: 'POST', headers: init.headers, body: init.body, signal })
+    if (!res.ok) return { ok: false, status: res.status, text: await res.text() }
+    return { ok: true, data: await res.json() as ChatCompletion }
+  } catch (error) {
+    if (!signal.aborted) throw error
+    // AbortSignal.any 的 reason 是最先触发的那个源的 reason:等于超时信号的 reason 即超时先到,否则是调用方取消
+    if (timeout.aborted && signal.reason === timeout.reason) {
+      throw new LlmRequestError('timeout', `no complete response within ${timeoutMs}ms (GOTRY_LLM_TIMEOUT_MS)`, { cause: error, timeoutMs })
+    }
+    throw new LlmRequestError('aborted', "request cancelled by the caller's AbortSignal", { cause: error })
+  }
+}
+
+async function chat(
+  messages: Array<{ role: 'system' | 'user' | 'assistant'; content: string }>,
+  json: boolean,
+  usage?: LlmUsageTracker,
+  request: LlmRequestOptions = {},
+): Promise<string> {
   const key = process.env['LLM_API_KEY'] ?? process.env['DEEPSEEK_API_KEY']
   if (!key) throw new Error('LLM_API_KEY 未设置(兼容 DEEPSEEK_API_KEY 别名)——真 LLM 路径不可用,请回退 mock(ADR-8)')
-  const res = await fetch(`${base()}/chat/completions`, {
-    method: 'POST',
+  const reply = await requestCompletion(`${base()}/chat/completions`, {
     headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${key}` },
     body: JSON.stringify({
       model: model(),
@@ -49,9 +139,9 @@ async function chat(messages: Array<{ role: 'system' | 'user' | 'assistant'; con
       ...(json ? { response_format: { type: 'json_object' } } : {}),
       temperature: json ? 0 : 0.7,
     }),
-  })
-  if (!res.ok) throw new Error(`llm ${res.status}: ${(await res.text()).slice(0, 300)}`)
-  const data = await res.json() as { choices: Array<{ message: { content: string } }>; usage?: { prompt_tokens?: number; completion_tokens?: number; prompt_cache_hit_tokens?: number; prompt_cache_miss_tokens?: number } }
+  }, request)
+  if (!reply.ok) throw new Error(`llm ${reply.status}: ${reply.text.slice(0, 300)}`)
+  const data = reply.data
   if (usage) {
     usage.calls += 1
     const u = data.usage
@@ -94,7 +184,11 @@ const SKELETON_SYSTEM = `你是行程骨架抽取器。从对话中抽取行程
 规则:每个跨城移动一段;锚点只放用户明说或必然的(如"当天到"→arriveByMin 23:59=1439);时刻用当日分钟。
 scenario 判定:「洱海/大理/千岛湖/太湖+选目的地」→erhai(候选集);「普吉/workation/远程办公+多城链」→workation(五段链);「云南/大理丽江」→yunnan;不确定→generic。只输出 JSON。`
 
-export function createOpenAICompatLlm(flightPackPath?: string, clock: () => Date = () => new Date()): LlmPort & { usage: LlmUsageTracker } {
+/**
+ * request:本端口每次 chat() 共用的请求级选项(timeoutMs / signal)。signal 是端口级取消——
+ * 调用方可借它在会话/批次截止时真正掐断在途请求,而不是放着它继续挂在 provider 上。
+ */
+export function createOpenAICompatLlm(flightPackPath?: string, clock: () => Date = () => new Date(), request: LlmRequestOptions = {}): LlmPort & { usage: LlmUsageTracker } {
   const pack = flightPackPath
   const usage = emptyUsage()
   const historyText = (h: Turn[]) => h.map(t => `${t.role === 'user' ? '用户' : '助手'}: ${t.text}`).join('\n')
@@ -107,6 +201,7 @@ export function createOpenAICompatLlm(flightPackPath?: string, clock: () => Date
         [{ role: 'system', content: FACTS_SYSTEM }, { role: 'user', content: `${anchorContext()}\n\n${historyText(history)}` }],
         true,
         usage,
+        request,
       )
       const obj = parseJsonBlock(out)
       if (!obj) return { assumptions: [] }
@@ -122,6 +217,7 @@ export function createOpenAICompatLlm(flightPackPath?: string, clock: () => Date
         [{ role: 'system', content: SKELETON_SYSTEM }, { role: 'user', content: `${context}\n\n${historyText(history)}` }],
         true,
         usage,
+        request,
       )
       const skeleton = parseJsonBlock(out)
       if (!skeleton || !Array.isArray(skeleton['segments']) || (skeleton['segments'] as unknown[]).length === 0) return null
@@ -147,7 +243,11 @@ export function createOpenAICompatLlm(flightPackPath?: string, clock: () => Date
           return { segments: [], note: 'erhai-candidates', budgetCny: 3000 } as unknown as JourneySpecTS
         }
         packSpec = parseFlightPackToSpec(JSON.parse(await readFile(packPath, 'utf-8')))
-      } catch {
+      } catch (e) {
+        // issue #620:数据包被 parse 边界拒收时,原因必须留痕——否则用户只看到
+        // 「骨架还不完整」,运维看不到是哪个包的哪个字段把求解面挡住了。
+        const err = e as Error & { code?: string }
+        console.error(`[gotry] extractSpec: 数据包不可用 ${packPath}(${err.code ?? 'parse_failed'}):`, (err.message ?? '').slice(0, 200))
         return null
       }
       const anchorsById = new Map<string, Record<string, unknown>>(
@@ -167,6 +267,7 @@ export function createOpenAICompatLlm(flightPackPath?: string, clock: () => Date
         [{ role: 'system', content: buildSlotSystem(anchor) }, { role: 'user', content: historyText(history) }],
         true,
         usage,
+        request,
       )
       const obj = parseJsonBlock(out)
       if (!obj) return null
@@ -180,6 +281,7 @@ export function createOpenAICompatLlm(flightPackPath?: string, clock: () => Date
          { role: 'user', content: `【${q.key}】${q.text}(为什么问:${q.why})` }],
         false,
         usage,
+        request,
       )
       return out.trim() || `【${q.key}】${q.text}`
     },