@danceiny/gotry 0.2.0-rc.30 → 0.2.0-rc.32

package/bin/gotry-flyai-verification.d.ts

@@ -0,0 +1,9 @@
+export interface FlyaiCandidateVerification {
+  verdict: 'hit' | 'auth-error' | 'forbidden' | 'needs-setup' | 'rate-limited' | 'timeout' | 'cancelled' | 'error'
+  count?: number
+  error?: string
+}
+export declare function verifyFlyaiCandidate(candidate: string, options?: {
+  env?: NodeJS.ProcessEnv
+  signal?: AbortSignal
+}): Promise<FlyaiCandidateVerification>

package/bin/gotry-flyai-verification.js

@@ -0,0 +1,63 @@
+/** Shared, bounded, read-only candidate verification for terminal and native Web setup. */
+import { spawnOwnedChild, terminateOwnedChild } from './gotry-process-liveness.js'
+
+export async function verifyFlyaiCandidate(candidate, options = {}) {
+  const configured = options.env ?? process.env
+  if (options.signal?.aborted) return { verdict: 'cancelled', error: '验证已取消。' }
+  const env = { ...configured, FLYAI_API_KEY: candidate }
+  delete env.DEBUG_FLYAI_API_KEY
+  const command = configured.GOTRY_FLYAI_CLI_BIN || 'npx'
+  const prefix = configured.GOTRY_FLYAI_CLI_BIN ? [] : ['-y', '@fly-ai/flyai-cli@1.0.16']
+  const date = new Date(Date.now() + 7 * 86_400_000).toISOString().slice(0, 10)
+  const args = [...prefix, 'search-flight', '--origin', '上海', '--destination', '丽江', '--dep-date', date]
+  const limit = Number(configured.GOTRY_FLYAI_VERIFY_TIMEOUT_MS ?? 20_000)
+  const timeoutMs = Number.isFinite(limit) && limit > 0 ? Math.min(limit, 60_000) : 20_000
+  const owned = spawnOwnedChild(command, args, { env, stdio: ['ignore', 'pipe', 'pipe'] })
+  let stopReason, timer, stdout = '', stderr = '', bytes = 0
+  const stop = (reason) => {
+    stopReason ??= reason
+    void terminateOwnedChild({ ...owned, signal: 'SIGKILL', termGraceMs: 100, killWaitMs: 1000 })
+  }
+  const abort = () => stop('cancelled')
+  try {
+    const result = await new Promise(resolve => {
+      let settled = false
+      const finish = value => { if (!settled) { settled = true; resolve(value) } }
+      timer = setTimeout(() => stop('timeout'), timeoutMs)
+      options.signal?.addEventListener('abort', abort, { once: true })
+      if (options.signal?.aborted) abort()
+      owned.child.stdout?.on('data', chunk => {
+        bytes += chunk.length
+        if (bytes > 256 * 1024) return stop('output-limit')
+        stdout += chunk.toString()
+      })
+      owned.child.stderr?.on('data', chunk => {
+        bytes += chunk.length
+        if (bytes > 256 * 1024) return stop('output-limit')
+        stderr += chunk.toString()
+      })
+      owned.child.once('error', () => finish({ verdict: 'error', error: '无法启动验证进程。' }))
+      owned.child.once('close', code => {
+        if (stopReason) return finish({ verdict: stopReason === 'output-limit' ? 'error' : stopReason,
+          error: stopReason === 'cancelled' ? '验证已取消。' : stopReason === 'timeout' ? `验证调用超时 ${timeoutMs}ms。` : '验证响应过大。' })
+        const combined = `${stderr}\n${stdout}`
+        if (/Invalid API key|HTTP\s*401|\b401\b/.test(combined)) return finish({ verdict: 'auth-error', error: '401 Invalid API key' })
+        if (/HTTP\s*403|\b403\b/.test(combined)) return finish({ verdict: 'forbidden', error: 'HTTP 403：无访问权限，请核对控制台权限。' })
+        if (/Trial limit reached/.test(combined)) return finish({ verdict: 'needs-setup', error: '试用额度已用尽，请核对控制台 Key。' })
+        if (/HTTP\s*429|\b429\b/.test(combined)) return finish({ verdict: 'rate-limited', error: '普通限流，稍后重试。' })
+        if (code !== 0) return finish({ verdict: 'error', error: `验证进程失败（exit ${code}）；请检查网络与服务状态。` })
+        try {
+          const envelope = JSON.parse(stdout)
+          finish(Array.isArray(envelope?.data?.itemList)
+            ? { verdict: 'hit', count: envelope.data.itemList.length }
+            : { verdict: 'error', error: '响应缺 data.itemList。' })
+        } catch { finish({ verdict: 'error', error: '响应不是合法 JSON。' }) }
+      })
+    })
+    return result
+  } finally {
+    clearTimeout(timer)
+    options.signal?.removeEventListener('abort', abort)
+    await terminateOwnedChild({ ...owned, signal: 'SIGKILL', termGraceMs: 100, killWaitMs: 1000 })
+  }
+}

package/bin/gotry-hbcli-release.d.ts

@@ -0,0 +1,3 @@
+export const HBCLI_RELEASE_VERSION: string
+export const HBCLI_INSTALL_URL: string
+export const HBCLI_INSTALL_CMD: string

package/bin/gotry-hbcli-release.js

@@ -0,0 +1,4 @@
+/** Official stable hbcli baseline. npm's staicli@latest still points to 0.0.3. */
+export const HBCLI_RELEASE_VERSION = '0.0.4'
+export const HBCLI_INSTALL_URL = `https://github.com/hotelbyte-com/docs/releases/download/staicli-v${HBCLI_RELEASE_VERSION}/install.sh`
+export const HBCLI_INSTALL_CMD = `curl -fsSL --connect-timeout 15 --max-time 60 ${HBCLI_INSTALL_URL} | bash -s -- --version ${HBCLI_RELEASE_VERSION}`

package/bin/gotry-inner.js

@@ -88,8 +88,9 @@ Usage:
     # 跳过该问: --no-onboarding 或 GOTRY_ONBOARDING_SKIP=1
   gotry setup                        # 扩展就位检查/指引(商店一键装)
   gotry setup calendar               # 可选日历(CalDAV 工作窗口)挂载开关:默认关;--off 关闭;--status 查看
+  gotry setup flyai                  # FlyAI 配置向导:控制台取 key → 隐藏粘贴 → 验证后保存;--status 查看;--clear 清除
   gotry doctor                       # 可选依赖体检:扩展/agent-reach/hbcli/flyai/sidebar 状态 + 补装指引
-  gotry doctor --fix                 # 体检 + 按报告补装(hbcli 官方脚本 / agent-reach pip / sidebar 插件)
+  gotry doctor --fix                 # 补装可选依赖;交互终端可选择接着配置 FlyAI
   gotry "一段完整任务..."            # headless 一问一答
   gotry help                         # this help
   gotry --version                    # 版本号(bug 报告必填项)

package/client/client.js

@@ -12,6 +12,219 @@ window.__ModuleLoader__.load({
     var module = { exports: {} }
     var exports = module.exports
     var React = require('react')
+    var UI = require('@deepseek-ai/dsh-client-ui-primitives')
+
+    var webLocale = {
+      en: {
+        title: 'GoTry', description: 'Travel data sources and saved itineraries', flyai: 'FlyAI',
+        loading: 'Loading…', unavailable: 'Configuration is unavailable. Retry to read its current state.',
+        readOnly: 'The current key comes from the launch environment, or this platform cannot safely store it here.',
+        key: 'API Key', keyHint: 'Paste the key from the FlyAI console. It never enters the conversation.',
+        configured: 'A key is configured', anonymous: 'Anonymous trial · shared quota', verified: 'Current configuration verified',
+        unverified: 'Configured · verification required', debug: 'Debug endpoint', console: 'Open FlyAI console',
+        save: 'Verify and save', saving: 'Verifying…', saveFailed: 'The new key was not saved; the previous configuration is retained.',
+        saved: 'Verified and saved.', clear: 'Clear local key', cleared: 'Local key cleared. Anonymous trial is now active.',
+        retry: 'Refresh status', source: 'Source', config: 'Local configuration', env: 'Environment variable',
+        'env-debug': 'Debug environment variable', none: 'Shared trial',
+        hbcli: 'HotelByte · sandbox', appKey: 'App Key', appSecret: 'App Secret',
+        hbHint: 'Use the credentials supplied with your sandbox account. They never enter the conversation.',
+        hbRegistration: 'Apply for a sandbox account', hbUnconfigured: 'Sandbox API credentials are not configured', hbConfigured: 'Sandbox API credentials configured',
+        hbReadOnly: 'Credentials come from the launch environment, or the local configuration cannot be safely written.',
+        hbSaveFailed: 'Credentials were not saved; the previous configuration is retained.',
+        hbSaved: 'Credentials saved and the read-only hotel query completed.', hbClear: 'Clear local sandbox credentials',
+        hbCleared: 'Local sandbox API credentials cleared.', hbNoSuppliers: 'Saved · no available suppliers configured',
+        hbNoSuppliersHint: 'HotelByte must enable suppliers for your account. This result does not mean the destination has no rooms.',
+        hbMiss: 'Query verified · no hotels in this check', hbProbeHint: 'Verification makes one read-only Shanghai hotel query for tomorrow, one night and two adults.',
+        artifacts: 'GoTry artifacts', artifactsHint: 'Browse saved itineraries and planning deliveries',
+        search: 'Search artifacts', searchPlaceholder: 'Title or filename', refresh: 'Refresh',
+        empty: 'No saved artifacts in this workspace.', noMatches: 'No matching artifacts.', noSession: 'Open a conversation to browse its workspace.',
+        previous: 'Previous', next: 'Next', html: 'Open HTML preview', open: 'Open preview',
+        htmlHint: 'HTML previews may run the document’s scripts.', failed: 'Could not read the current state. Please retry.',
+      },
+      zh: {
+        title: 'GoTry', description: '旅行数据源与已保存行程', flyai: 'FlyAI（飞猪）',
+        loading: '正在读取…', unavailable: '配置暂时不可用，请重新读取当前状态。',
+        readOnly: '当前 Key 来自启动环境变量，或此平台无法在这里安全保存。',
+        key: 'API Key', keyHint: '粘贴飞猪控制台中的 Key，凭据不会进入对话。',
+        configured: '已配置 Key', anonymous: '匿名试用 · 共享额度', verified: '当前配置已验证',
+        unverified: '已配置 · 尚未验证通过', debug: '调试服务地址', console: '打开飞猪控制台',
+        save: '验证并保存', saving: '正在验证…', saveFailed: '新 Key 未保存，旧配置已保留。',
+        saved: '验证通过，已保存。', clear: '清除本机 Key', cleared: '本机 Key 已清除，已恢复匿名试用。',
+        retry: '重新读取状态', source: '来源', config: '本机配置', env: '环境变量',
+        'env-debug': '调试环境变量', none: '共享试用',
+        hbcli: 'HotelByte（沙箱）', appKey: 'App Key', appSecret: 'App Secret',
+        hbHint: '填写开通沙箱账号后取得的凭证，内容不会进入对话。',
+        hbRegistration: '申请沙箱账号', hbUnconfigured: '尚未配置沙箱 API 凭证', hbConfigured: '已配置沙箱 API 凭证',
+        hbReadOnly: '当前凭证来自启动环境变量，或本机配置无法安全写入。',
+        hbSaveFailed: '新凭证未保存，旧配置已保留。',
+        hbSaved: '凭证已保存，只读酒店查询已完成。', hbClear: '清除本机沙箱凭证',
+        hbCleared: '本机沙箱 API 凭证已清除。', hbNoSuppliers: '已保存 · 未配置可用供应商',
+        hbNoSuppliersHint: '请联系 HotelByte 开通当前账号的供应商。这次结果不能判断目的地无房。',
+        hbMiss: '查询通道已验证 · 本次未返回酒店', hbProbeHint: '验证会只读查询上海明天入住的一晚酒店，两位成人。',
+        artifacts: 'GoTry 产物', artifactsHint: '查看已保存行程和规划交付物',
+        search: '搜索产物', searchPlaceholder: '标题或文件名', refresh: '刷新',
+        empty: '这个工作区尚无已保存产物。', noMatches: '没有匹配的产物。', noSession: '打开一个对话后即可查看其工作区产物。',
+        previous: '上一页', next: '下一页', html: '打开 HTML 预览', open: '打开预览',
+        htmlHint: 'HTML 预览可能运行文档中的脚本。', failed: '无法读取当前状态，请重试。',
+      },
+    }
+
+    async function webRequest(path, options) {
+      var response = await fetch('api/gotry/' + path, Object.assign({ credentials: 'same-origin' }, options))
+      var value = await response.json()
+      if (!value || typeof value !== 'object') throw new Error('Invalid Web response')
+      if (!response.ok || value.ok === false) throw new Error(value.error || 'Request failed')
+      return value
+    }
+
+    function SourceSettings(props) {
+      var t = props.t
+      var hotelbyte = props.provider === 'hbcli', provider = hotelbyte ? 'hbcli' : 'flyai'
+      var state = React.useState(null), status = state[0], setStatus = state[1]
+      var draft = React.useState(''), key = draft[0], setKey = draft[1]
+      var secretDraft = React.useState(''), secret = secretDraft[0], setSecret = secretDraft[1]
+      var noticeState = React.useState(''), notice = noticeState[0], setNotice = noticeState[1]
+      var errorState = React.useState(''), error = errorState[0], setError = errorState[1]
+      var busyState = React.useState(false), busy = busyState[0], setBusy = busyState[1]
+      var reloadState = React.useState(0), reload = reloadState[0], setReload = reloadState[1]
+      var lifetime = React.useRef(null), activeRequest = React.useRef(false)
+      React.useEffect(function () {
+        var controller = new AbortController()
+        lifetime.current = controller
+        setError('')
+        webRequest(provider, { signal: controller.signal }).then(function (value) {
+          if (!controller.signal.aborted) setStatus(value)
+        }).catch(function () { if (!controller.signal.aborted) setError(t('failed')) })
+        return function () { controller.abort(); lifetime.current = null }
+      }, [reload])
+      async function write(action) {
+        if (activeRequest.current || !lifetime.current || !status?.writable) return
+        var controller = lifetime.current
+        activeRequest.current = true
+        setBusy(true); setError(''); setNotice('')
+        var candidate = key, candidateSecret = secret
+        setKey(''); setSecret('')
+        try {
+          var payload = action === 'clear' ? { action: action } : hotelbyte
+            ? { action: action, appKey: candidate, appSecret: candidateSecret } : { action: action, key: candidate }
+          var value = await webRequest(provider + '/write', { method: 'POST', signal: controller.signal,
+            headers: { 'content-type': 'application/json' }, body: JSON.stringify(payload) })
+          if (!controller.signal.aborted) {
+            setStatus(value)
+            setNotice(hotelbyte && action === 'save' && value.verdict === 'no-suppliers' ? ''
+              : t(hotelbyte ? action === 'clear' ? 'hbCleared' : 'hbSaved' : action === 'save' ? 'saved' : 'cleared'))
+          }
+        } catch (failure) {
+          if (!controller.signal.aborted) setError(failure.message || t(hotelbyte ? 'hbSaveFailed' : 'saveFailed'))
+        } finally {
+          activeRequest.current = false
+          if (!controller.signal.aborted) setBusy(false)
+        }
+      }
+      if (props.view === 'summary') return t('description')
+      var disabled = busy || !status?.writable
+      var stateLabel = !status ? t('loading') : !status.configured ? t(hotelbyte ? 'hbUnconfigured' : 'anonymous')
+        : hotelbyte && status.verdict === 'no-suppliers' ? t('hbNoSuppliers') : hotelbyte && status.verdict === 'miss' ? t('hbMiss')
+        : status.verified ? t('verified') : t('unverified')
+      var sectionProps = { style: { display: 'grid', gap: '16px', maxWidth: '640px' } }
+      sectionProps['data-gotry-' + provider + '-settings'] = ''
+      var statusProps = { key: 'status', role: 'status', style: { display: 'grid', gap: '6px' } }
+      statusProps['data-gotry-' + provider + '-status'] = ''
+      return element('section', sectionProps, [
+        element('h3', { key: 'heading', style: { margin: 0 } }, t(provider)),
+        element('div', statusProps, [
+          element(UI.Tag, { key: 'badge', tone: status?.verified ? 'success' : 'neutral' }, stateLabel),
+          status ? element('span', { key: 'source', style: { fontSize: '12px', color: 'var(--dsw-alias-label-tertiary)' } }, t('source') + '：' + t(hotelbyte && status.source === 'none' ? 'hbUnconfigured' : status.source)) : null,
+          status?.endpointDebug ? element('span', { key: 'debug' }, t('debug') + '：' + status.endpoint) : null,
+        ]),
+        element('a', { key: 'console', href: hotelbyte ? 'https://hotelbyte.com/zh/guides/sandbox-verification' : 'https://flyai.open.fliggy.com/console', target: '_blank', rel: 'noopener noreferrer' }, t(hotelbyte ? 'hbRegistration' : 'console')),
+        hotelbyte ? element('p', { key: 'probe-hint', style: { margin: 0, fontSize: '12px' } }, t('hbProbeHint')) : null,
+        hotelbyte && status?.verdict === 'no-suppliers' ? element('p', { key: 'supplier-hint', role: 'status', style: { margin: 0 } }, t('hbNoSuppliersHint')) : null,
+        element(UI.SettingsForm, { key: 'form', labels: { unavailable: t('loading'), readOnly: t(hotelbyte ? 'hbReadOnly' : 'readOnly'), saveFailed: t(hotelbyte ? 'hbSaveFailed' : 'saveFailed'), save: t('save'), saving: t('saving') },
+          state: { available: Boolean(status), writable: Boolean(status?.writable), dirty: key.trim().length > 0 && (!hotelbyte || secret.trim().length > 0), invalid: false, saving: busy, failed: false },
+          onSave: function () { void write('save') }, onDiscard: function () { setKey(''); setSecret('') } }, [
+          element(UI.SettingsSecretField, { key: 'key', id: 'gotry-' + provider + '-key', label: t(hotelbyte ? 'appKey' : 'key'), hint: t(hotelbyte ? 'hbHint' : 'keyHint'), text: key,
+            configured: Boolean(status?.configured), stateLabel: t(status?.configured ? hotelbyte ? 'hbConfigured' : 'configured' : hotelbyte ? 'hbUnconfigured' : 'anonymous'), disabled: disabled,
+            onEdit: function (value) { setKey(value); setError(''); setNotice('') } }),
+          hotelbyte ? element(UI.SettingsSecretField, { key: 'secret', id: 'gotry-hbcli-secret', label: t('appSecret'), text: secret,
+            configured: Boolean(status?.configured), stateLabel: t(status?.configured ? 'hbConfigured' : 'hbUnconfigured'), disabled: disabled,
+            onEdit: function (value) { setSecret(value); setError(''); setNotice('') } }) : null,
+        ]),
+        error ? element('p', { key: 'error', role: 'alert', style: { margin: 0, color: 'var(--dsw-alias-state-error-primary)' } }, error) : null,
+        notice ? element('p', { key: 'notice', role: 'status', style: { margin: 0 } }, notice) : null,
+        element('div', { key: 'actions', style: { display: 'flex', gap: '8px', flexWrap: 'wrap' } }, [
+          element(UI.Button, { key: 'retry', type: 'button', variant: 'outline', disabled: busy,
+            onClick: function () { setReload(function (value) { return value + 1 }) } }, t('retry')),
+          status?.configured && status.writable ? element(UI.Button, { key: 'clear', type: 'button', disabled: busy,
+            onClick: function () { void write('clear') } }, t(hotelbyte ? 'hbClear' : 'clear')) : null,
+        ]),
+      ])
+    }
+
+    function GoTrySettings(props) {
+      if (props.view === 'summary') return props.t('description')
+      return element('div', { style: { display: 'grid', gap: '32px' } }, [
+        element(SourceSettings, Object.assign({}, props, { key: 'flyai', provider: 'flyai' })),
+        element(SourceSettings, Object.assign({}, props, { key: 'hbcli', provider: 'hbcli' })),
+      ])
+    }
+
+    function ArtifactBrowser(props) {
+      var t = props.t, info = props.useTabInfo(), sessionId = props.sessionId
+      var cwd = props.useSessions(function (sessions) { return sessions.byId[sessionId]?.cwd })
+      var state = React.useState(null), result = state[0], setResult = state[1]
+      var queryState = React.useState(''), search = queryState[0], setSearch = queryState[1]
+      var pageState = React.useState(0), offset = pageState[0], setOffset = pageState[1]
+      var refreshState = React.useState(0), refresh = refreshState[0], setRefresh = refreshState[1]
+      var busyState = React.useState(false), busy = busyState[0], setBusy = busyState[1]
+      var errorState = React.useState(''), error = errorState[0], setError = errorState[1]
+      React.useEffect(function () {
+        if (!sessionId || !info.tab.visible) return
+        var controller = new AbortController()
+        setBusy(true); setError('')
+        var query = new URLSearchParams({ sessionId: sessionId, search: search, offset: String(offset), limit: '20' })
+        webRequest('artifacts?' + query, { signal: controller.signal }).then(function (value) {
+          if (!controller.signal.aborted) setResult(value)
+        }).catch(function () { if (!controller.signal.aborted) setError(t('failed')) })
+          .finally(function () { if (!controller.signal.aborted) setBusy(false) })
+        return function () { controller.abort() }
+      }, [sessionId, info.tab.visible, search, offset, refresh])
+      function open(path) {
+        var normalized = String(path).replace(/\\/g, '/')
+        var root = String(cwd || '').replace(/\\/g, '/').replace(/\/$/, '')
+        var relative = root && normalized.startsWith(root + '/') ? normalized.slice(root.length + 1) : normalized
+        info.tab.actions.openResource('dsh-resource://file/session/' + encodeURIComponent(sessionId) + '/' + relative.split('/').map(encodeURIComponent).join('/'))
+      }
+      var entries = result?.artifacts || []
+      return element('section', { 'data-gotry-artifacts-browser': '', style: { padding: '16px', display: 'grid', alignContent: 'start', gap: '12px', height: '100%', overflow: 'auto', boxSizing: 'border-box', minWidth: 0 } }, [
+        element('div', { key: 'controls', style: { display: 'flex', gap: '8px', alignItems: 'center', minWidth: 0 } }, [
+          element(UI.Input, { key: 'search', 'aria-label': t('search'), placeholder: t('searchPlaceholder'), value: search,
+            style: { minWidth: 0, width: '100%' }, onChange: function (event) { setSearch(event.target.value); setOffset(0) } }),
+          element(UI.Button, { key: 'refresh', size: 'sm', disabled: busy || !sessionId,
+            onClick: function () { setRefresh(function (value) { return value + 1 }) } }, busy ? t('loading') : t('refresh')),
+        ]),
+        error ? element('p', { key: 'error', role: 'alert' }, error) : null,
+        !sessionId ? element('p', { key: 'no-session' }, t('noSession')) : !busy && entries.length === 0 ? element('p', { key: 'empty' }, t(search ? 'noMatches' : 'empty')) : null,
+        element('div', { key: 'list', 'aria-busy': busy, style: { display: 'grid', gap: '8px' } }, entries.map(function (entry) {
+          var html = /\.html?$/i.test(entry.path)
+          return element(UI.Button, { key: entry.path, variant: 'outline', 'data-gotry-artifact-entry': entry.path,
+            title: html ? t('htmlHint') : entry.path, onClick: function () { open(entry.path) },
+            style: { width: '100%', height: 'auto', padding: '12px', textAlign: 'left', justifyContent: 'flex-start', minWidth: 0 } }, [
+            element(UI.FileTypeIcon, { key: 'icon', path: entry.path }),
+            element('span', { key: 'body', style: { display: 'grid', gap: '4px', minWidth: 0, flex: 1 } }, [
+              element('span', { key: 'title', style: { overflowWrap: 'anywhere' } }, entry.title),
+              element('span', { key: 'meta', style: { fontSize: '11px', color: 'var(--dsw-alias-label-tertiary)', overflowWrap: 'anywhere' } },
+                [entry.status, entry.updated ? new Date(entry.updated).toLocaleString() : '', html ? t('html') : t('open')].filter(Boolean).join(' · ')),
+            ]),
+          ])
+        })),
+        result?.total > 0 ? element('div', { key: 'pagination', style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: '8px', flexWrap: 'wrap' } }, [
+          element(UI.Button, { key: 'previous', size: 'sm', disabled: busy || offset === 0, onClick: function () { setOffset(Math.max(0, offset - 20)) } }, t('previous')),
+          element('span', { key: 'count', role: 'status', style: { fontSize: '12px' } }, (entries.length ? offset + 1 : 0) + '–' + (offset + entries.length) + ' / ' + result.total),
+          element(UI.Button, { key: 'next', size: 'sm', disabled: busy || !result.truncated, onClick: function () { setOffset(result.nextOffset) } }, t('next')),
+        ]) : null,
+      ])
+    }
 
     function element(type, props, children) {
       return React.createElement(type, props, ...(Array.isArray(children) ? children : [children]))
@@ -194,6 +407,21 @@ window.__ModuleLoader__.load({
           return scope.slots.register({ name: 'tool.call.toolview', key: 'gotry_artifacts_read' }, ArtifactToolView)
         })
       })
+      ctx.inject(['slots', 'locale'], function (scope) {
+        var ns = 'gotry.web'
+        var t = scope.locale.bind(ns)
+        scope.effect(function () { return scope.locale.register(ns, webLocale) })
+        scope.slots.inject('plugins.item', function () {
+          return scope.slots.register({ name: 'plugins.item', id: 'gotry', order: 50, label: function () { return t('title') }, locale: ns }, GoTrySettings)
+        })
+        scope.inject(['sidebarRightTabs'], function (sidebar) {
+          sidebar.effect(function () { return sidebar.sidebarRightTabs.register({ id: '@danceiny/gotry:artifacts', kind: 'gotry-artifacts',
+            title: function () { return t('artifacts') }, guide: [{ id: 'gotry-artifacts', order: 15, title: function () { return t('artifacts') }, description: function () { return t('artifactsHint') } }] }) })
+          sidebar.slots.inject('sidebar.right.pane.tab', function () {
+            return sidebar.slots.register({ name: 'sidebar.right.pane.tab', key: '@danceiny/gotry:artifacts', locale: ns }, ArtifactBrowser)
+          })
+        })
+      })
     }
 
     exports.apply = apply

package/dist/capabilities/doctor.js

@@ -19,6 +19,8 @@ import { existsSync, readFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { homedir } from 'node:os';
 import { join, resolve } from 'node:path';
+import { checkExtensionStatus } from '../../bin/gotry-extension-status.js';
+import { HBCLI_RELEASE_VERSION, HBCLI_INSTALL_CMD } from '../../bin/gotry-hbcli-release.js';
 import { readLatestChannelEvents } from './channel-health.js';
 import { displayEndpoint, endpointFingerprint, readFlyaiVerification, resolveFlyaiEndpoint, resolveFlyaiKey, sha256Hex, } from './flyai-config.js';
 /** hbcli 已知安装位(与 capabilities/hbcli.ts hbcliBinCandidates 同清单) */
@@ -109,10 +111,8 @@ export function nodeOk(version) {
     const [maj = '0', min = '0'] = version.split('.');
     return Number(maj) > 22 || (Number(maj) === 22 && Number(min) >= 15);
 }
-/** hbcli 最低版本(可用 GOTRY_MIN_HBCLI_VERSION 覆盖)。0.0.3 修了 portal-ticket
- * fallback bug(issue #142)——低于该版本的 hbcli 会把 literal "stored-ticket"
- * 当 bearer 发到 hotel-be,让 trade.* / search/checkAvail 全部 401。 */
-const MIN_HBCLI_VERSION = process.env.GOTRY_MIN_HBCLI_VERSION ?? '0.0.3';
+/** hbcli 最低版本(可用 GOTRY_MIN_HBCLI_VERSION 覆盖)，与 CLI doctor 共用发布基线。 */
+const MIN_HBCLI_VERSION = process.env.GOTRY_MIN_HBCLI_VERSION ?? HBCLI_RELEASE_VERSION;
 /** 单项检查:全部只读、永不抛错;env/homeDir/repoRoot 可注入(测试确定性) */
 export async function runDoctorChecks(opts = {}) {
     const repoRoot = opts.repoRoot ? resolve(opts.repoRoot) : resolve(import.meta.dirname, '..', '..');
@@ -124,17 +124,8 @@ export async function runDoctorChecks(opts = {}) {
     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)' });
-    // 1. Stai Travel Bridge 扩展(账号会话通道的传输层;装在哪由 bootstrap setup 管理)
-    //    D-24 自适应(#117):离线只能探测本地 unpacked 通道;商店版无本地文件面——
-    //    missing detail 明示「商店版用户可忽略本项」,不再把商店版用户误导成本地通道缺失
-    const extManifest = join(home, '.gotry', 'extension', 'manifest.json');
-    items.push(existsSync(extManifest)
-        ? { id: 'extension', label: 'Stai Travel Bridge 扩展', status: 'ok', detail: `已就位(本地通道:${extManifest})` }
-        : {
-            id: 'extension', label: 'Stai Travel Bridge 扩展', status: 'missing',
-            detail: '本地通道未落位(~/.gotry/extension/manifest.json 不存在)。影响面:gotry_session_search / gotry_session_login(账号会话通道)不可用;携程机票/酒店实时检索、12306 余票、Dida 实时报价都依赖此通道。其它工具(机票 FlyAI、酒店 hbcli、地图、天气等)不受影响。若你已从 Chrome 商店安装(自动更新,商店版 ID oeajpicc…),本项可忽略——会话检索可用性以运行时为准(gotry_session_search 的 verdict)。若未安装:应用商店一键装即可',
-            fix: '在 Chrome 应用商店一键安装(自动更新): https://chromewebstore.google.com/detail/gotry-session-bridge/oeajpiccmonococjcegddlooeeohlbgd',
-        });
+    // 1. CLI 与工具层共用只读检测：安装、落位、连接是不同证据。
+    items.push({ id: 'extension', label: 'Stai Travel Bridge 扩展', ...await checkExtensionStatus({ homeDir: home, env, ports: opts.extensionPorts }) });
     // 2. agent-reach(网页/社媒读取;.venv 装在包内,与 agent-reach.ts venvPython 同位)
     const venvPython = join(repoRoot, '.venv/bin/python');
     const reachBin = join(repoRoot, '.venv/bin/agent-reach');
@@ -157,7 +148,7 @@ export async function runDoctorChecks(opts = {}) {
     }
     // 3. hbcli(酒店实时源;静态包自动降级,缺了不致命)
     //    裸名 'hbcli' 靠 PATH 解析(existsSync 对裸名是 cwd 相对,无意义)——先探测再落位
-    //    版本 < MIN_HBCLI_VERSION 视为 missing(issue #142:portal-ticket fallback 401)
+    //    版本 < MIN_HBCLI_VERSION 视为 missing，修复走版本钉扎的官方安装器
     let hbPresent = '';
     for (const p of hbcliCandidates(home)) {
         if (p !== 'hbcli' && existsSync(p)) {
@@ -175,8 +166,8 @@ export async function runDoctorChecks(opts = {}) {
         if (v && !versionAtLeast(v, MIN_HBCLI_VERSION)) {
             items.push({
                 id: 'hbcli', label: 'hbcli(酒店实时源)', status: 'missing',
-                detail: `版本过旧(v${v.join('.')} < v${MIN_HBCLI_VERSION})——trade.* / search/checkAvail 会 401(issue #142)`,
-                fix: 'npm install -g staicli --registry=https://registry.npmjs.org/',
+                detail: `版本过旧(v${v.join('.')} < v${MIN_HBCLI_VERSION})——请升级到支持当前认证与酒店配置的版本`,
+                fix: HBCLI_INSTALL_CMD,
             });
         }
         else {
@@ -202,7 +193,7 @@ export async function runDoctorChecks(opts = {}) {
                 : {
                     id: 'hbcli', label: 'hbcli(酒店实时源)', status: 'degraded',
                     detail: '二进制在,但凭证未配置/失效——酒店检索将降级静态包(非实时)',
-                    fix: 'hbcli auth customer-send-code --email you@mail.com 收码后 hbcli auth customer-login --email you@mail.com --code <收件码>(客户邮箱验证码登录,新邮箱即注册,需 npm staicli ≥ 0.0.4);B 端租户注册走 hbcli auth register(先 auth send-code);或 hbcli auth set-credentials --app-key hotelbyte_api_demo --app-secret hotelbyte_api_demo(快速试用沙箱;正式 key 向 HotelByte 申请)',
+                    fix: 'hbcli auth customer-send-code --email you@mail.com 收码后 hbcli auth customer-login --email you@mail.com --code <收件码>(客户邮箱验证码登录,新邮箱即注册);B 端租户注册走 hbcli auth register(先 auth send-code);或在 插件 → GoTry → HotelByte 配置沙箱 App Key/App Secret',
                 });
         }
     }
@@ -229,7 +220,7 @@ export async function runDoctorChecks(opts = {}) {
         items.push({
             id: 'flyai', label: 'FlyAI(飞猪官方检索:机/火/酒/景/关键词/AI/万豪)', status: 'degraded',
             detail: `未配置 key——匿名试用中(共享额度易达限;达限报 Trial limit reached)${flyaiQuotaNote}。影响面:共享池额度小,频繁会话易触顶;达限本会话内 gotry_flyai_search(机票/酒店/票务/AI/万豪 8 类)失败,改走 gotry_session_search 账号会话通道。`,
-            fix: '本机运行 `gotry setup flyai`(隐藏输入,候选 key 先 scrub-env 验证后保存);打开 https://flyai.open.fliggy.com/console，登录后复制 API Key',
+            fix: 'Web 打开「插件 → GoTry → FlyAI」验证并保存；或运行 `npx @danceiny/gotry setup flyai`：① 打开 https://flyai.open.fliggy.com/console 复制 API Key；② 在终端隐藏粘贴；③ 验证后保存。也可运行 `npx @danceiny/gotry doctor --fix` 按提示配置',
         });
     }
     else {
@@ -254,7 +245,7 @@ export async function runDoctorChecks(opts = {}) {
             items.push({
                 id: 'flyai', label: 'FlyAI(飞猪官方检索:机/火/酒/景/关键词/AI/万豪)', status: 'degraded',
                 detail: `${reason}(${sourceText};endpoint ${displayEndpoint(flyaiEndpoint.url)}${flyaiEndpoint.debug ? '(DEBUG)' : ''})——非空不等于鉴权通过`,
-                fix: '本机运行 `gotry setup flyai` 重新验证后保存;`gotry setup flyai --clear` 回退匿名',
+                fix: 'Web 打开「插件 → GoTry → FlyAI」重新验证；或运行 `npx @danceiny/gotry setup flyai`；`npx @danceiny/gotry setup flyai --clear` 回退匿名',
             });
         }
     }
@@ -264,7 +255,7 @@ export async function runDoctorChecks(opts = {}) {
         ? { 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)',
+            detail: '未安装此增强组件——Web 自带 GoTry 产物页与原生预览；可选补装以增强文件浏览',
             fix: 'npx @danceiny/gotry doctor --fix',
         });
     // 6. dsh-calendar(patch 分发面宿主插件;D-9 拍板:默认不挂载)
@@ -371,7 +362,7 @@ export async function runDoctorChecks(opts = {}) {
     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 @danceiny/gotry doctor --fix,或按各项 fix 指引逐项处理。`;
+        : `体检发现 ${broken.length} 项待处理:${broken.map(i => `${i.label}(${i.status === 'missing' ? '未装' : i.id === 'extension' ? '待确认' : '半可用'})`).join('、')}。补装:终端跑 npx @danceiny/gotry doctor --fix,或按各项 fix 指引逐项处理。`;
     return { ok: broken.length === 0, items, summary };
 }
 /** 修复指引入表:命令类才加反引号(prose 类如「到控制台申请 key」原样) */

package/dist/capabilities/effect.js

@@ -23,9 +23,9 @@
  * 本层只让「每条通道」更可替换、可熔断、可 mock。
  */
 import { CircuitBreaker, withRetry, } from './resilience.js';
-import { flyaiSearch } from './flyai.js';
+import { flyaiBreakerScope, flyaiSearch } from './flyai.js';
 import { checkAvail, hotelRates, searchHotels } from './hbcli.js';
-import { sessionFlightSearch, sessionHotelSearch, sessionTrainSearch, sessionDidaSearch } from './session-search.js';
+import { sessionFlightSearch, sessionFlightGuiSearch, sessionHotelGuiSearch, sessionHotelSearch, sessionTrainSearch, sessionDidaSearch } from './session-search.js';
 import { geocodePlace, getClimate, getForecast } from './weather.js';
 import { verifyFlight } from './opensky.js';
 import { anythingSearch } from './anything.js';
@@ -86,8 +86,12 @@ const DEFAULT_HANDLERS = {
     HBCLI_CHECK_AVAIL: (p) => checkAvail({ ratePkgId: p.ratePkgId }, { hbcliBin: p.hbcliBin, timeoutMs: p.timeoutMs }),
     /** 用户本人登录态会话检索(浏览器解译通道:扩展桥默认 + cdp 显式后备;ReadGuard+节律闸) */
     SESSION_FLIGHT_SEARCH: (p) => sessionFlightSearch(p),
+    /** 携程机票 GUI 车道(2026-10-14 实装;gotry 隔离匿名窗口驱动 PC 表单,往返/任意城市原生;匿名公开价) */
+    SESSION_FLIGHT_GUI_SEARCH: (p) => sessionFlightGuiSearch(p),
     /** 用户本人登录态会话酒店检索(2026-09-03 实装;同浏览器解译通道,风控红线同款) */
     SESSION_HOTEL_SEARCH: (p) => sessionHotelSearch(p),
+    /** 携程酒店 GUI 车道(2026-10-14 实装,#664;匿名窗口驱动表单,cityId 码表退出主链路) */
+    SESSION_HOTEL_GUI_SEARCH: (p) => sessionHotelGuiSearch(p),
     /** 12306 余票会话检索(2026-09-03 实装;公开查询面,无登录闸;同浏览器解译通道) */
     SESSION_TRAIN_SEARCH: (p) => sessionTrainSearch(p),
     /** Dida 供应商门户实时价会话检索(2026-09-09 实装;hotel-be portal integration 迁移线) */
@@ -133,8 +137,8 @@ const hbcliTimeout = (r) => {
 const HBCLI_RETRY = { maxAttempts: 2, baseDelayMs: 300, maxDelayMs: 1_000 };
 /**
  * 渠道韧性策略表(权威面;docs/design/effect-interpreter.md §3 同表逐行有依据):
- *   - FLYAI:瞬时代码级错误重试 1 次;连续 3 次 error(含 Sentinel)熔断 60s 保护配额;
- *     试用额度达限(429)归 needs-setup,永不重试;
+ *   - FLYAI:明确瞬时故障重试 1 次；同 kind/endpoint/key 连续 3 次明确
+ *     上游健康故障（含 Sentinel）熔断 60s；业务、配置与未知失败不计熔断；
  *   - HBCLI:仅 timeout 类失败重试 1 次(冷启动建后端 session 可超时,重试即恢复);
  *     ENOENT/退码类永不重试(上游契约「候选路径是切换不是重试」),熔断同上;
  *     RATES/CHECK_AVAIL 同族,且价格面无静态降级(fail-closed,不估算房价——
@@ -159,7 +163,12 @@ const SPECS = {
             // Only explicit transient classification permits retry; terminal failures stay final.
             return result?.retryable === true;
         },
-        isFailure: defaultIsFailure,
+        isFailure: r => r?.upstreamHealth === 'unhealthy',
+        isNeutral: r => {
+            const health = r?.upstreamHealth;
+            return health !== 'healthy' && health !== 'unhealthy';
+        },
+        breakerScope: p => flyaiBreakerScope(p?.kind),
     },
     HBCLI_HOTEL_SEARCH: {
         channel: 'cli',
@@ -190,12 +199,24 @@ const SPECS = {
         breaker: null,
         isFailure: defaultIsFailure,
     },
+    SESSION_FLIGHT_GUI_SEARCH: {
+        channel: 'browser',
+        retry: null,
+        breaker: null,
+        isFailure: defaultIsFailure,
+    },
     SESSION_HOTEL_SEARCH: {
         channel: 'browser',
         retry: null,
         breaker: null,
         isFailure: defaultIsFailure,
     },
+    SESSION_HOTEL_GUI_SEARCH: {
+        channel: 'browser',
+        retry: null,
+        breaker: null,
+        isFailure: defaultIsFailure,
+    },
     SESSION_TRAIN_SEARCH: {
         channel: 'browser',
         retry: null,
@@ -286,9 +307,12 @@ export function declinedObservation(effect, trace) {
         summary: trace.declined === 'aborted'
             ? `${effect} 检索已取消，未产生新的查询结果。`
             : trace.declined === 'circuit-open'
-                ? `${effect} 通道被断路器开启保护(连续失败达到阈值,冷却中)——不要立即重试,换其他工具或稍后再试;原因见 trace 证据链`
+                ? trace.breaker === 'half-open'
+                    ? `${effect} 通道的恢复探测正在进行；等待当前探测结果后再查询，或使用其他工具。`
+                    : `${effect} 通道被断路器开启保护（连续上游故障达到阈值，冷却中）；${typeof trace.retryAfterMs === 'number' ? `约 ${Math.ceil(trace.retryAfterMs / 1_000)} 秒后可发起恢复探测` : '稍后可发起恢复探测'}，当前可使用其他工具。`
                 : `${effect} 未登记效应(effect_interpreter.v1 注册表外,生产解译器拒绝)`,
         evidence: trace.evidence.join(';'),
+        ...(trace.retryAfterMs !== undefined ? { retryAfterMs: trace.retryAfterMs } : {}),
     };
 }
 const defaultBreakers = new Map();
@@ -314,16 +338,18 @@ export function makeProductionInterpreter(opts = {}) {
         const br = (() => {
             if (!spec.breaker)
                 return null;
-            const existing = breakers.get(fx.effect);
+            const key = spec.breakerScope ? `${fx.effect}:${spec.breakerScope(fx.params)}` : fx.effect;
+            const existing = breakers.get(key);
             if (existing)
                 return existing;
             const created = new CircuitBreaker({ ...spec.breaker, ...(opts.now ? { now: opts.now } : {}) });
-            breakers.set(fx.effect, created);
+            breakers.set(key, created);
             return created;
         })();
         const gate = br?.canAttempt() ?? { allowed: true, state: 'closed', token: undefined };
         if (!gate.allowed) {
-            const trace = { effect: fx.effect, channel: spec.channel, attempts: 0, backoffMs: 0, breaker: gate.state, declined: 'circuit-open', evidence: [`[效应:${fx.effect}@${ts}] breaker=${gate.state} 拒绝(冷却中,不重试)`] };
+            const retryAfterMs = 'retryAfterMs' in gate ? gate.retryAfterMs : undefined;
+            const trace = { effect: fx.effect, channel: spec.channel, attempts: 0, backoffMs: 0, breaker: gate.state, declined: 'circuit-open', ...(retryAfterMs !== undefined ? { retryAfterMs } : {}), evidence: [`[效应:${fx.effect}@${ts}] breaker=${gate.state} 拒绝${retryAfterMs !== undefined ? ` retryAfterMs=${retryAfterMs}` : '（恢复探测在途）'}`] };
             return { result: null, trace };
         }
         const policy = spec.retry
@@ -346,9 +372,16 @@ export function makeProductionInterpreter(opts = {}) {
             };
             return { result: null, trace: abortedTrace };
         }
-        const failed = outcome.error != null || spec.isFailure(outcome.result);
-        if (br)
-            failed ? br.onFailure(gate.token) : br.onSuccess(gate.token);
+        const neutral = spec.isNeutral?.(outcome.result, outcome.error) === true;
+        const failed = !neutral && (outcome.error != null || spec.isFailure(outcome.result));
+        if (br) {
+            if (neutral)
+                br.releaseProbe(gate.token);
+            else if (failed)
+                br.onFailure(gate.token);
+            else
+                br.onSuccess(gate.token);
+        }
         const breakerState = br?.state() ?? 'off';
         const evidence = [`[效应:${fx.effect}@${ts}] attempts=${outcome.attempts} backoff=${outcome.backoffMs}ms breaker=${breakerState}`];
         return {