@danceiny/gotry 0.0.1-rc.12 → 0.0.1-rc.14

package/README.zh-CN.md

@@ -0,0 +1,233 @@
+# GoTry
+
+[English](README.md) | [简体中文](README.zh-CN.md)
+
+[![CI](https://github.com/Danceiny/gotry/actions/workflows/ci.yml/badge.svg)](https://github.com/Danceiny/gotry/actions/workflows/ci.yml)
+
+> **身体和灵魂,更多旅行,更少旅游。**
+> *Body and soul — more travel, less tourism.*
+
+**GoTry 是「从出发到下一次出发」的 AI 旅行 Agent**:你用一句话说想去哪、为什么想出发;它先问清楚你的工作时间和已订资源,再用**数学求解器**给你一份经过验证的行程方案。
+
+**GoTry is an AI travel agent for departure-to-next-departure.** Tell it where you want to go and why. It asks what's missing, then hands you a **formally verified itinerary** — not vibes.
+
+---
+
+## 🚀 30 秒上手
+
+```bash
+npx @danceiny/gotry web
+# 首跑会提示建 .env:LLM_API_KEY=<DeepSeek key 或 OpenAI 兼容 key>
+# → 浏览器打开 http://127.0.0.1:3080,像聊天一样说「我想去大理三天」
+```
+
+| 你想要的 | 命令 |
+|---|---|
+| 🖥️ 对话规划(推荐) | `npx @danceiny/gotry web` → :3080 对话界面 |
+| 🤖 脚本/一次性问答 | `npx @danceiny/gotry "我想从深圳休整两天,预算 3000"` |
+| 🛠️ 开发者:仓内运行 | 见下方[源码安装](#-快速开始) |
+
+- 前置:Node 22+;一个 LLM API key。零成本启动——dsh 运行时以 cordis patch 自动挂载,无额外配置。
+- 例外提示:`:3080` 端口被占时先 `kill <PID>`;首启 6–15 秒属正常冷启动;异常退出会留证据到 `gotry-state/incidents.jsonl`(不静默)。
+
+<details>
+<summary>🛠️ 开发者:源码安装(仓内运行)</summary>
+
+```bash
+git clone https://github.com/Danceiny/gotry && cd gotry
+cd ts/dsh-runtime && pnpm install && cd ../..    # ① vendored dsh 0.1.2-alpha.1(一次性)
+cp .env.example .env                              # ② 填 LLM_API_KEY
+./gotry web                                       # ③ 仓内入口,同 npm 形态
+```
+
+| 入口 | 命令 | 什么时候用 |
+|---|---|---|
+| dsh Web 对话(推荐) | `./gotry web` | 持续多轮规划,看推理可视化 → :3080 |
+| headless 一问一答 | `./gotry "一句任务"` | 脚本 / CI / 定向调试 → stdout |
+| help | `./gotry help` | 三行帮助 |
+
+为什么源码模式要先装 runtime:dsh 以 vendored tarball 进 git(`ts/dsh-runtime/`),npm 一键分发不打包它;源码检出读 `.ts` 源码,装完一次重复可用。
+
+</details>
+
+---
+
+## ✨ 它做什么 — What it does
+
+GoTry 把「想去哪」变成「能不能、怎么去」:
+
+| 阶段 | 由谁做 | 给你什么 |
+|---|---|---|
+| **动机访谈** | LLM | 必问项:工作窗口 / 已订资源 / 出发城市 |
+| **事实抽取** | LLM | 工作窗口生效 + 休假语义识别 |
+| **可行性判定** | **Z3 求解器** | 哪些候选可行、哪些不可行、为什么、**最小改动让它可行** |
+| **门到门全成本** | 求解器 | 真实飞行时长(含时差)+ 醒来起夜惩罚 + 接驳代价 + 到达精力 % |
+| **证据链** | 渲染层 | 每个数字带标签:`[骨架:openflights]` / `[实时API:flyai]` / `[静态包:估算]` |
+
+**不像普通 AI 聊天**——LLM 只做理解和解释,**判定与算术是数学求解器**算的。
+
+> **Unlike a regular AI chat**, the LLM only translates and explains. **Decisions and arithmetic are computed by a Z3 solver**, not guessed.
+
+---
+
+## 🎬 一段对话 — Demo
+
+输入 → 引擎判定 → 输出(真实输出,milliseconds 保留原味):
+
+```
+> 我想去洱海边发呆两三天,上海出发,预算 3000,年假别让我办公。
+
+GoTry: 收到。先把约束记下来——
+  • 窗口: 2 天(2026 年窗口)  • 出发: 上海  • 预算: ¥3000 全含
+  • 动机: 休整 / [escape_rest: 0.7]  • 还没订任何东西
+
+引擎判定:
+  **大理·洱海: 现在不行** —— 2 天窗口装不下「至少 5 天的洱海休整」。
+    放宽方案: 行程延长到 5 天,约 ¥4950。★已放入「下一次出发」清单。
+  **千岛湖: 可行** (G7315 06:35 出发,¥996,到达精力 84%,有效休整 4.4h)
+  **太湖: 可行** (G101 09:00 出发,¥716,有效休整 4.6h)
+  建议: 千岛湖(意象匹配 80%)。
+
+[骨架:openflights] ✓ SZX↔PVG 已校验 [实时API:hbcli] 上海机场在跑
+[静态包:估算] G7315/G7316 价格按 7-8 月淡季估算
+```
+
+> **Brief English summary**: input → engine verdicts (feasibility + whole-cost) → recommendation + wish-pool entry for infeasible candidates. Every numeric carries an evidence tag.
+
+---
+
+## 🧰 18 个工具 — Tools
+
+| 组 | 工具 | 干什么 |
+|---|---|---|
+| **实时检索(OTA/官方只读)** | `gotry_flyai_search` | 机票/火车/酒店实时报价(飞猪官方通道;酒店价格为上游打码展示,真实价以 jumpUrl 为准) |
+| | `gotry_session_search` | 在**用户本人登录态**里查携程机票(授权后,只读) |
+| | `gotry_session_login` | 登录引导:自动检测已登录与否,未登录才在用户 Chrome 弹登录入口(**零终端**) |
+| | `gotry_weather_check` | Open-Meteo 预报≤16 天 + 历史气候基线 |
+| | `gotry_flight_verify` | OpenSky ADS-B 航班实时观测(三值) |
+| | `gotry_skeleton_check` | OpenFlights 168 对枢纽通航性(三值) |
+| **库存与目录** | `gotry_hotel_search` | hotel-byte 实时桥,降级静态包(证据标注) |
+| | `gotry_anything_search` | 城市/酒店/地标混合目录(hotel-be Anything) |
+| **判定引擎** | `gotry_feasibility_check` | 门到门真成本可行性(Z3),逐候选判定 |
+| **记忆与触达** | `gotry_motivation_save` | 动机画像落盘(evidence 强制,反幻觉) |
+| | `gotry_wish_pool_add` / `gotry_wish_pool_list` | 「下一次出发」愿望池 + 0..1 条件召回 |
+| | `gotry_companion_save` · `gotry_trip_log` | 同行人档案 / 旅行时间线 |
+| **通用外部** | `gotry_web_search` · `gotry_video_subtitle` · `gotry_github_search` · `gotry_agent_reach` | 网页/字幕/GitHub/全渠道外部信息(经 Agent-Reach) |
+
+---
+
+## 🔐 账号会话:授权与隐私 — Account consent
+
+会话检索使用**你本人已登录的 Chrome**读取酒店/机票实时数据,为此立了四条 hard 规则:
+
+1. **登录在外部网站完成** —— gotry 从不提供、不代填、不收集任何密码/验证码/cookie 值。它只回答一个布尔问题:"登录票据 cookie 存在吗"(只读**名字**,0 值过手)。
+2. **授权卡,每会话一次** —— 首次动用账号会话会弹运行时审批卡;批准后会话内记住,拒绝即本会话吊销,不再打扰。总闸 `sessionAccess: ask|allow|off` 随时可关。
+3. **物理只读** —— ReadGuard 在网络层中止一切写请求(下单/支付在传输层不可达),agent 永不接触凭证与验证码;遇到验证码立即停,交还给你。
+4. **绝不劫持你的浏览器** —— 检索/登录只开自己的独立标签页,登录页置前台、留在你那;例行动测试永不自动开浏览器窗。
+
+> 前置(一次性):日常 Chrome 打开 `chrome://inspect/#remote-debugging` 打开开关(Chrome 144+),并保持 Chrome 在线。未开启时工具返回 `needs-attach` 并给出指引,不消耗执行配额。
+
+---
+
+## 🏛️ 架构 — Architecture
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│ L1  对话即界面  chat-as-UI; gates 是消息内选择题                 │
+│ L2  编排  dsh 运行时 + GoTry 插件(ReAct);18 个工具            │
+│ L3  领域  统一行程模型 + Z3 可行性引擎(枚举/Z3 双形态)        │
+│ L4  数据  静态数据包 + hotelbyte-cli 实时桥 + OpenFlights 骨架 │
+│ L5  治理  LoopX(objective / gates / evidence / quota)         │
+└──────────────────────────────────────────────────────────────┘
+```
+
+| 层 | 模块 | 角色 |
+|---|---|---|
+| L2 | `ts/src/index.ts`(dsh 插件) | 注册 18 工具,挂时间锚点/记忆 brief 变量;execute 异常隔离 + 授权闸 + 进程护栏 |
+| L3 | `ts/src/unified.ts` · `py/gotry_feasibility/` | 唯一求解入口(候选枚举 + 航班链 Z3) |
+| L4 | `ts/capabilities/hbcli.ts` · `skeleton-check.ts` | 实时库存桥 + OpenFlights 骨架(三值语义) |
+| L5 | loopx 治理面 | objective / gates / evidence / quota |
+
+> 📖 完整 ADR / 演进 / 债务清单: [`docs/architecture.md`](docs/architecture.md)
+
+---
+
+## ⚠️ 状态与限制 — Status & limitations
+
+**已就绪(全绿可验)**:
+
+- ✅ **Z3 WASM race 已根治**(`z3-shared.ts` 单实例+会话级互斥;run-all §30 并发回归闸)
+- ✅ **实时机票/酒店/会话检索**已接入:FlyAI 官方通道(机/火/酒;`GOTRY_REALTIME_PRICING=1` 可选把实时票价覆写进求解)
+- ✅ **英文面(工程层)**:`GOTRY_LOCALE=en` 一键切换,en 零缺键,金标准行为不变
+- ✅ **账号会话:授权闸 + 登录产品化 + 自动检测**(见上方 [🔐 账号会话](#-账号会话授权与隐私--account-consent))
+- ✅ License MIT;薄壳遗留已删除(dsh web 唯一产品面)
+
+**未收口(诚实清单)**:
+
+- ⏳ **M3 Exit 未关闭** —— 工程与分发面就绪,但真实种子用户 evidence(50–200 人 cohort)未积累;合成 fixture 只证明合同不证明 business pass
+- ⏳ **中文之外的界面残余** —— dsh web 界面属宿主;工具结果卡与人格对话面的英文校准件挂 M4 校准样本
+- ⏳ **携程酒店/美团会话适配器** —— 机票已通,酒店会话面等登录态实测回填(下一 tick)
+
+<details>
+<summary>📖 展开完整状态表(账本/证据合同/里程碑口径)</summary>
+
+事务化状态账本(ADR-15,`gotry_async_terminal.v1`:4/4→`succeeded`/ledger `settled`/exit 0,非 4/4→`failed`/`failed`/exit 2,终态复诵零重算);双形态架构冻结(ADR-16:本地+Web 一套账本语义,tenant_id 一等字段);会话数据面 #21 的字段 fixture scorer、双源合同与 waiting-attach no-spend 已进确定性回归,真实 sf-01..08 尚未验收;里程碑口径(2026-08-29):M3 工程与分发面已就绪但真实种子用户 evidence 未收口,M4 由 founder 授权并行推进不构成 M3 Exit 证明,M5/M6 仅在各自 Entry gate 满足后启动——细则见 [`docs/roadmap.md`](docs/roadmap.md) 与 [`docs/architecture.md`](docs/architecture.md)。
+
+</details>
+
+---
+
+## 📚 文档 — Docs
+
+| 文档 | 适合谁 |
+|---|---|
+| [本 README](README.md) | **所有人**:是什么 · 怎么用 · 限制 |
+| [`docs/architecture.md`](docs/architecture.md) | 工程师:分层 · ADR · 演进 · 债务 |
+| [`docs/roadmap.md`](docs/roadmap.md) | 项目管理:M0–M6 与当前位置 |
+| [`docs/user-guide.md`](docs/user-guide.md) | 终端用户:详细使用文档 |
+| [`docs/gotry-product-design.md`](docs/gotry-product-design.md) | 产品:主循环 · 透明机制 · 全成本模型 |
+| [`docs/gotry-master-outline.md`](docs/gotry-master-outline.md) | 决策者:工作分解 · 复用矩阵 |
+| [`docs/kimi-postmortem.md`](docs/kimi-postmortem.md) | 所有人:真实 AI 旅行规划失败复盘(反面教材) |
+| [`docs/release-notes.md`](docs/release-notes.md) | 历史:每个 tag 的发布闸勾稽 |
+
+---
+
+## 🧪 跑测试 — Verify
+
+```bash
+./scripts/run-all-tests.sh
+```
+
+全栈一次性绿(纯 TS,无 Python 依赖):engine/journey/unified 金标准 · 对话重放 · 异步工单跨进程 · 插件 smoke · hbcli · 进程护栏(含工具异常隔离)· 天气 · 航班 · Anything · probePoi · agent-reach(web/deep/wrapper)· 双路径稳定性 · 时间感评测(锚点卡/槽位过期校验/评分器/mock 回放;真模型巡检 `time-eval-tests.ts --real`)· 记忆域(动机合并守门/效用 sidecar/只读指标投影)· **Z3 并发竞态(§30)· 实时票价桥(§31)· i18n 目录(§32)· M3 cohort 证据合同(§33)· M4 价值证据合同(§34)**。
+
+---
+
+## 🤝 参与开发 — Contributing
+
+> *PR-based flow: branch off the latest `main`, full suite green, open a Pull Request — `main` never takes direct pushes; merge after review. Full guide: [CONTRIBUTING.md](CONTRIBUTING.md).*
+
+标准开源流程:**`main` 不直接推**——从最新 `main` 切出 `feat/ · fix/ · docs/ · chore/` 分支,本地全栈绿后开 Pull Request,CI(Node 22/24,typecheck + 全部套件)与维护者 review 双绿后 squash 合入。**测试红着不许合。**
+
+- 完整贡献指南(环境搭建 · 测试 · 分支与提交约定 · PR 流程): **[CONTRIBUTING.md](CONTRIBUTING.md)**
+- Bug / 功能建议:[issue 模板](.github/ISSUE_TEMPLATE/bug_report.yml)(搜过既有 issue 再提)
+- 行为或架构改动先立 ADR(`docs/architecture.md` §8);多 agent 协作契约见 [`AGENTS.md`](AGENTS.md)
+
+---
+
+## 📜 License
+
+**MIT**(2026-08-23 落定)。与上游 dsh(MIT)/ loopx 一致——宽松、可商用、可闭源分叉。文本见 [LICENSE](LICENSE)。
+
+---
+
+## 🌐 中英版 — Locales
+
+- 本文件(main)**英文版独立成文**:[README.md](README.md)——两文件各自完整,常见开源双语布局。
+- 深 README(中文)面向中国出境首发种子用户群;英文版是它的完整镜像(不含深度工程文档)。
+- `docs/` 深度工程文档当前中文先行,英文版计划 v0.1.0 同步。
+
+---
+
+**Built with**: DeepSeek Harness 0.1.2-alpha.1 (vendored) · Cordis · Z3 (WASM) · loopx (pipx) · hotelbyte-cli · Agent-Reach v1.5.0 (`.venv/`) · OpenFlights · TypeScript
+
+**Last verified against `v0.0.1-rc.14`(2026-08-29)** — 全栈回归全绿 §1-§34(发布流程见 `scripts/publish-npm.sh`)。

package/bin/gotry-bootstrap.js

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+/**
+ * gotry 外部依赖自举(founder 2026-08-29 指令:安装 gotry 时按上游本身的方式装好外部依赖):
+ *   hbcli(hotelbyte-cli)  → 官方 install.sh(原生二进制,~/.local/bin/hbcli)
+ *   agent-reach            → 官方 pip 安装 git+ upstream(包内 .venv,与 z3-solver 同址原则)
+ *   flyai                  → 无需安装(npx 每次自拉 @fly-ai/flyai-cli)
+ *
+ * 用法:
+ *   node bin/gotry-bootstrap.js              # 显式安装(缺啥装啥;失败 exit 1)
+ *   node bin/gotry-bootstrap.js --auto       # postinstall 模式:CI/跳过开关检测,任何失败不挡安装(exit 0)
+ *   node bin/gotry-bootstrap.js --check-only # 只探测报告,不安装(测试钩子)
+ *
+ * 环境开关:
+ *   GOTRY_SETUP_SKIP=1            全部跳过
+ *   GOTRY_SETUP_HBCLI=0           跳过 hbcli
+ *   GOTRY_SETUP_REACH=0           跳过 agent-reach
+ *
+ * 契约:安装外部依赖永远不挡 gotry 本体——能力层各有降级路径(静态包/not-installed
+ * verdict),自举失败只降级体验,不产生故障。凭证(hbcli auth / agent-reach 渠道
+ * cookie)属用户资产,不自动配置,装完二进制后给指引。
+ */
+
+import { spawn } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const repoRoot = join(dirname(fileURLToPath(import.meta.url)), '..')
+const AUTO = process.argv.includes('--auto')
+const CHECK_ONLY = process.argv.includes('--check-only')
+
+const HBCLI_INSTALL_CMD = 'curl -fsSL https://github.com/hotelbyte-com/docs/releases/latest/download/install.sh | bash'
+const REACH_INSTALL_URL = 'git+https://github.com/Panniantong/Agent-Reach.git'
+
+/** 带超时的子进程(inherit stdio 让用户看见上游安装进度) */
+function run(cmd, args, { timeoutMs, cwd } = {}) {
+  return new Promise((resolve) => {
+    const child = spawn(cmd, args, { stdio: 'inherit', cwd, env: process.env })
+    let done = false
+    const timer = setTimeout(() => {
+      if (!done) { done = true; try { child.kill('SIGKILL') } catch { /* ignore */ } }
+    }, timeoutMs)
+    child.on('error', (e) => { if (!done) { done = true; clearTimeout(timer); resolve({ ok: false, error: e.message }) } })
+    child.on('exit', (code) => { if (!done) { done = true; clearTimeout(timer); resolve({ ok: code === 0, error: code === 0 ? undefined : `exit ${code}` }) } })
+  })
+}
+
+/** 静默探测命令是否可执行(带超时) */
+function probe(cmd, args, timeoutMs = 10_000) {
+  return new Promise((resolve) => {
+    const child = spawn(cmd, args, { stdio: 'ignore' })
+    let done = false
+    const timer = setTimeout(() => { if (!done) { done = true; try { child.kill('SIGKILL') } catch { /* ignore */ } resolve(false) } }, timeoutMs)
+    child.on('error', () => { if (!done) { done = true; clearTimeout(timer); resolve(false) } })
+    child.on('exit', (code) => { if (!done) { done = true; clearTimeout(timer); resolve(code === 0) } })
+  })
+}
+
+const say = (s) => console.log(s)
+
+async function setupHbcli() {
+  say('[gotry-setup] hbcli(hotelbyte-cli,可选酒店实时源)')
+  const candidates = ['hbcli', join(homedir(), '.local/bin/hbcli'), join(homedir(), '.staicli/current/hbcli')]
+  const present = candidates.some((p) => existsSync(p)) && (await probe(candidates[0], ['version']) || await probe(candidates[1], ['version']) || await probe(candidates[2], ['version']))
+  if (present) { say('  ✓ 已安装'); return { ok: true } }
+  if (CHECK_ONLY) { say('  ✗ 未安装(--check-only 只报告)'); return { ok: true } }
+  say(`  安装中(官方脚本): ${HBCLI_INSTALL_CMD}`)
+  const r = await run('bash', ['-c', HBCLI_INSTALL_CMD], { timeoutMs: 120_000 })
+  if (!r.ok) { say(`  ✗ 安装失败(${r.error})——不影响 gotry,酒店检索将用内置静态包;可稍后重试: npx gotry setup`); return { ok: false } }
+  const binDir = join(homedir(), '.local/bin')
+  if (!process.env.PATH.split(':').includes(binDir)) {
+    say(`  ⚠ ${binDir} 不在当前 PATH —— gotry 工具已内建候选路径回退,无需手动处理;其他程序可用: export PATH="${binDir}:$PATH"`)
+  }
+  say('  ✓ 安装完成(凭证选配: hbcli auth set-credentials --app-key ... --app-secret ...,或 HOTELBYTE_TOKEN;未配时酒店检索自动用静态包)')
+  return { ok: true }
+}
+
+async function setupReach() {
+  say('[gotry-setup] agent-reach(可选网页/社媒读取源,pip 装入包内 .venv)')
+  const venvBin = join(repoRoot, '.venv/bin/agent-reach')
+  if (existsSync(venvBin)) { say('  ✓ 已安装(.venv)'); return { ok: true } }
+  if (CHECK_ONLY) { say('  ✗ 未安装(--check-only 只报告)'); return { ok: true } }
+  const hasPy = await probe('python3', ['--version'], 10_000)
+  if (!hasPy) { say('  ✗ 跳过:未找到 python3(agent-reach 需 Python 3;装好后重跑 npx gotry setup)'); return { ok: false } }
+  say(`  创建 .venv 并安装上游(${REACH_INSTALL_URL})`)
+  const venv = await run('python3', ['-m', 'venv', join(repoRoot, '.venv')], { timeoutMs: 120_000 })
+  if (!venv.ok) { say(`  ✗ venv 创建失败(${venv.error})——不影响 gotry,gotry_agent_reach 将返回 not-installed 指引`); return { ok: false } }
+  const pip = join(repoRoot, '.venv/bin/pip')
+  const inst = await run(pip, ['install', '-q', REACH_INSTALL_URL], { timeoutMs: 300_000 })
+  if (!inst.ok) { say(`  ✗ pip 安装失败(${inst.error})——可稍后重试: npx gotry setup`); return { ok: false } }
+  say('  ✓ 安装完成(渠道凭证选配见 docs/tokens.md: .venv/bin/agent-reach configure --from-browser chrome --platform <渠道>)')
+  return { ok: true }
+}
+
+async function main() {
+  if (process.platform === 'win32') {
+    say('[gotry-setup] Windows 暂不支持自动安装(hbcli 上游仅 darwin/linux)。手动指引:')
+    say(`  hbcli: ${HBCLI_INSTALL_CMD}(WSL);agent-reach: python -m venv .venv && .venv/Scripts/pip install ${REACH_INSTALL_URL}`)
+    process.exit(AUTO ? 0 : 1)
+  }
+  if (AUTO && (process.env.CI || process.env.GOTRY_SETUP_SKIP === '1')) {
+    say('[gotry-setup] CI/GOTRY_SETUP_SKIP 检测——跳过外部依赖自举(可随时手动: npx gotry setup)')
+    say('GoTry installed. Run: npx gotry web   (dsh Web UI on :3080)')
+    process.exit(0)
+  }
+  if (!AUTO && process.env.GOTRY_SETUP_SKIP === '1') { say('[gotry-setup] GOTRY_SETUP_SKIP=1——跳过'); process.exit(0) }
+  const results = []
+  if (process.env.GOTRY_SETUP_HBCLI !== '0') results.push(await setupHbcli())
+  else say('[gotry-setup] hbcli:GOTRY_SETUP_HBCLI=0 跳过')
+  if (process.env.GOTRY_SETUP_REACH !== '0') results.push(await setupReach())
+  else say('[gotry-setup] agent-reach:GOTRY_SETUP_REACH=0 跳过')
+  say('[gotry-setup] flyai:无需安装(npx 每次自拉 @fly-ai/flyai-cli,免 key)')
+  const failed = results.filter((r) => !r.ok).length
+  if (failed > 0) {
+    say(`[gotry-setup] ${failed} 项未就绪——gotry 本体不受影响(各能力均有降级路径);可稍后重跑: npx gotry setup`)
+    process.exit(AUTO ? 0 : 1)
+  }
+  say('[gotry-setup] 全部就绪。Run: npx gotry web')
+  process.exit(0)
+}
+
+main().catch((e) => {
+  say(`[gotry-setup] 异常:${e.message}(不影响 gotry 本体;可重试 npx gotry setup)`)
+  process.exit(AUTO ? 0 : 1)
+})

package/bin/gotry-inner.js

@@ -16,7 +16,7 @@
  *      占位(本机绝对路径),随 tarball 分发后对其他机器必错。
  */
 
-import { spawn } from 'node:child_process'
+import { spawn, spawnSync } from 'node:child_process'
 import { existsSync, readFileSync, writeFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
 import { dirname, join } from 'node:path'
@@ -56,6 +56,7 @@ if (help) {
 
 Usage:
   gotry web                          # dsh Web UI on http://127.0.0.1:3080
+  gotry setup                        # 安装可选外部依赖(hbcli 官方脚本 / agent-reach pip;装时已自动跑过)
   gotry "一段完整任务..."            # headless 一问一答
   gotry help                         # this help
 
@@ -68,12 +69,18 @@ Detail: https://github.com/Danceiny/gotry — README
   process.exit(0)
 }
 
-// mode 决定路径: 'web'/'help'/'help' 是字面命令;否则第一段 args[0] 是任务本身的一部分
-const literal = new Set(['web', 'help', '-h', '--help'])
+// mode 决定路径: 'web'/'setup'/'help' 是字面命令;否则第一段 args[0] 是任务本身的一部分
+const literal = new Set(['web', 'setup', 'help', '-h', '--help'])
 const isLiteral = literal.has(args[0])
 const mode = isLiteral ? args[0] : 'headless'
 const rest = isLiteral ? args.slice(1) : args
 
+// setup:外部依赖自举(hbcli/agent-reach),不需要 dsh runtime 与 LLM key,同步分发后即退
+if (mode === 'setup') {
+  const r = spawnSync(process.execPath, [join(here, 'gotry-bootstrap.js'), ...rest], { stdio: 'inherit' })
+  process.exit(r.status ?? (r.error ? 1 : 0))
+}
+
 // --- dsh runtime 定位:repo checkout(vendored)优先,npm 安装走依赖解析 ---
 const vendoredDsh = join(repoRoot, 'ts/dsh-runtime/node_modules/@deepseek-ai/dsh/lib/bin.js')
 let dshBin = ''

package/cordis.gotry-patch.yml

@@ -84,8 +84,8 @@
       登录态,现携程机票):**首次调用**经运行时审批卡向用户请求授权,本会话
       内记住、不再重复弹卡;用户拒绝即本会话吊销——不再请求也不再执行,改走
       其他工具推进;无审批通道(headless)不执行。返回 needs-login→调
-      gotry_session_login 产品工具(在用户自己的 Chrome 打开携程登录入口并等待
-      其完成登录,不需要任何终端命令;**登录永远发生在携程官网、不在 gotry
+      gotry_session_login 产品工具(先自动检测票据——已登录则直接确认零弹窗;未登录才
+      打开登录入口等待其完成,不需要任何终端命令;**登录永远发生在携程官网、不在 gotry
       里进行**——gotry 永不收集/存储/传输密码、验证码或任何 cookie 值,只检查
       "是否已登录"这一个事实;向用户说明这一点),完成前用官方源推进,不反复
       开页探测;返回 challenged→立即停手如实告知,绝不重试

package/dist/capabilities/hbcli.js

@@ -1,13 +1,18 @@
 import { spawn } from 'node:child_process';
-export async function callHbcliJson(args, opts = {}) {
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+export function hbcliBinCandidates(bin, homeDir = homedir()) {
+    if (bin !== 'hbcli') return [
+        bin
+    ];
+    return [
+        bin,
+        join(homeDir, '.local/bin/hbcli'),
+        join(homeDir, '.staicli/current/hbcli')
+    ];
+}
+function attemptHbcli(bin, args, opts) {
     const started = Date.now();
-    const bin = opts.hbcliBin ?? 'hbcli';
-    const timeoutMs = opts.timeoutMs ?? 15_000;
-    const env = opts.env ?? 'uat';
-    const envVars = {
-        HOTELBYTE_ENV: env
-    };
-    if (opts.token) envVars['HOTELBYTE_TOKEN'] = opts.token;
     return new Promise((resolve)=>{
         let stdout = '';
         let stderr = '';
@@ -15,7 +20,7 @@ export async function callHbcliJson(args, opts = {}) {
         const child = spawn(bin, args, {
             env: {
                 ...process.env,
-                ...envVars
+                ...opts.envVars
             }
         });
         const timer = setTimeout(()=>{
@@ -28,10 +33,10 @@ export async function callHbcliJson(args, opts = {}) {
                     result: null,
                     evidence: `[实时API:hbcli@timeout@${new Date().toISOString()}]`,
                     latencyMs: Date.now() - started,
-                    error: `timeout after ${timeoutMs}ms`
+                    error: `timeout after ${opts.timeoutMs}ms`
                 });
             }
-        }, timeoutMs);
+        }, opts.timeoutMs);
         child.stdout.on('data', (d)=>{
             stdout += d.toString();
         });
@@ -82,11 +87,31 @@ export async function callHbcliJson(args, opts = {}) {
                 result: null,
                 evidence: `[实时API:hbcli@spawn_error@${new Date().toISOString()}]`,
                 latencyMs: Date.now() - started,
-                error: e.message
+                error: e.message,
+                spawnError: true
             });
         });
     });
 }
+export async function callHbcliJson(args, opts = {}) {
+    const env = opts.env ?? 'uat';
+    const envVars = {
+        HOTELBYTE_ENV: env
+    };
+    if (opts.token) envVars['HOTELBYTE_TOKEN'] = opts.token;
+    const callOpts = {
+        timeoutMs: opts.timeoutMs ?? 15_000,
+        env,
+        envVars
+    };
+    const candidates = hbcliBinCandidates(opts.hbcliBin ?? 'hbcli');
+    let last;
+    for (const bin of candidates){
+        last = await attemptHbcli(bin, args, callOpts);
+        if (!(last.spawnError && candidates.indexOf(bin) < candidates.length - 1)) return last;
+    }
+    return last;
+}
 export async function searchHotels(query, opts = {}) {
     const hbArgs = [
         'search',
@@ -110,6 +135,8 @@ export async function searchHotels(query, opts = {}) {
             summary: `${query.destination}:hbcli 实时返回${query.checkIn || query.checkOut ? '(日期不传上游 list,以当前窗口房价返回)' : ''}`
         };
     }
+    const rawReason = live.error ?? live.via;
+    const reason = /ENOENT/i.test(rawReason) ? '未安装 hbcli(可选实时源;npx gotry setup 可按官方脚本安装)' : rawReason;
     const fallback = opts.fallbackPath;
     if (fallback) {
         try {
@@ -124,19 +151,19 @@ export async function searchHotels(query, opts = {}) {
                     hotels: {
                         stays: matched
                     },
-                    summary: `${query.destination}:hbcli 不可用(${live.error ?? live.via}),降级到静态包,命中 ${matched.length} 个住宿块`
+                    summary: `${query.destination}:hbcli 实时源不可用(${reason}),已降级到静态包(公开渠道估算,非实时),命中 ${matched.length} 个住宿块`
                 };
             }
             return {
                 ...live,
                 hotels: null,
-                summary: `${query.destination}:hbcli 不可用(${live.error ?? live.via}),且静态包无「${query.destination}」住宿数据(静态包仅覆盖内置场景)`
+                summary: `${query.destination}:hbcli 实时源不可用(${reason}),且静态包无「${query.destination}」住宿数据(静态包仅覆盖内置场景)`
             };
         } catch  {}
     }
     return {
         ...live,
-        summary: `${query.destination}:hbcli 不可用且无静态包(仅返回错误)`
+        summary: `${query.destination}:hbcli 实时源不可用(${reason})且无静态包(仅返回错误)`
     };
 }
 export async function listDestinations(opts = {}) {

package/dist/capabilities/session/transport.js

@@ -87,7 +87,14 @@ export async function openSession(opts = {}) {
             };
         }
     }
-    const page = (await browser.pages())[0] ?? await browser.newPage();
+    let ownPage = false;
+    let page;
+    if (opts.newPage) {
+        page = await browser.newPage();
+        ownPage = true;
+    } else {
+        page = (await browser.pages())[0] ?? await browser.newPage();
+    }
     return {
         ok: true,
         browser,
@@ -97,6 +104,9 @@ export async function openSession(opts = {}) {
             requestCount: ()=>0
         },
         close: async ()=>{
+            if (ownPage && (opts.closeOwnPage ?? true)) {
+                await page.close().catch(()=>{});
+            }
             await (isCdp ? browser.disconnect() : browser.close()).catch(()=>{});
         }
     };

package/dist/capabilities/session-login.js

@@ -57,12 +57,28 @@ export async function sessionLogin(q = {}) {
     }
     const evidenceTag = `[会话:${site}-login@${ts}]`;
     try {
+        const pre = await pollTicketNames(t.browser, target);
+        if (pre.length > 0) {
+            await t.close();
+            return {
+                ok: true,
+                via: 'session-login',
+                latencyMs: Date.now() - started,
+                verdict: 'logged-in',
+                site,
+                tickets: pre,
+                evidence: `${evidenceTag} 自动检测:票据 cookie 已在(先前登录已生效)——[${pre.join(', ')}](只读名字,0 网页交互)`
+            };
+        }
+        const page = await t.browser.newPage();
+        await page.bringToFront().catch(()=>{});
         try {
-            await t.page.goto(target.entryUrl, {
+            await page.goto(target.entryUrl, {
                 waitUntil: 'domcontentloaded',
                 timeout: 30_000
             });
         } catch  {}
+        console.log(`[session-login] ${target.label} 登录入口已在新标签页置前打开`);
         const waitMs = Math.min(Math.max(q.waitMs ?? 90_000, 0), 300_000);
         const pollMs = Math.min(Math.max(q.pollMs ?? 3_000, 500), 10_000);
         const deadline = Date.now() + waitMs;

package/dist/capabilities/session-search.js

@@ -34,7 +34,8 @@ export async function sessionFlightSearch(q) {
         profileDir: q.profileDir,
         headless: q.headless,
         auditPath: q.auditPath,
-        mode: q.profileDir ? 'persistent' : 'cdp'
+        mode: q.profileDir ? 'persistent' : 'cdp',
+        newPage: true
     });
     if (!t.ok) {
         return err(classifyTransportFailure(t.summary, q.profileDir === undefined), t.summary);

package/dist/scripts/bootstrap-tests.js

@@ -0,0 +1,56 @@
+import assert from 'node:assert/strict';
+import { execFileSync } from 'node:child_process';
+import { join } from 'node:path';
+const repoRoot = join(import.meta.dirname, '..', '..');
+const bootstrap = join(repoRoot, 'bin', 'gotry-bootstrap.js');
+function runBootstrap(extraArgs, extraEnv) {
+    try {
+        const out = execFileSync('node', [
+            bootstrap,
+            ...extraArgs
+        ], {
+            encoding: 'utf-8',
+            timeout: 60_000,
+            env: {
+                ...process.env,
+                ...extraEnv
+            }
+        });
+        return {
+            code: 0,
+            out
+        };
+    } catch (e) {
+        const err = e;
+        return {
+            code: err.status ?? 1,
+            out: err.stdout ?? ''
+        };
+    }
+}
+const c1 = runBootstrap([
+    '--check-only'
+], {});
+assert.equal(c1.code, 0, `--check-only 应 exit 0,实际 ${c1.code}\n${c1.out}`);
+assert.ok(c1.out.includes('hbcli'), '报告应含 hbcli 节');
+assert.ok(c1.out.includes('agent-reach'), '报告应含 agent-reach 节');
+assert.ok(c1.out.includes('flyai'), '报告应含 flyai(无需安装)节');
+console.log('1. --check-only 探测报告 exit 0(hbcli/agent-reach/flyai 三节齐)OK');
+const c2 = runBootstrap([
+    '--auto'
+], {
+    GOTRY_SETUP_SKIP: '1'
+});
+assert.equal(c2.code, 0, '--auto 跳过态应 exit 0(永不挡 npm install)');
+assert.ok(c2.out.includes('跳过'), '应输出跳过说明');
+console.log('2. --auto + GOTRY_SETUP_SKIP=1 → exit 0(安装永不失败)OK');
+const c3 = runBootstrap([], {
+    GOTRY_SETUP_SKIP: '1'
+});
+assert.equal(c3.code, 0, '显式模式跳过态应 exit 0');
+assert.ok(c3.out.includes('跳过'), '应输出跳过说明');
+console.log('3. 显式模式 + GOTRY_SETUP_SKIP=1 → exit 0 OK');
+console.log('BOOTSTRAP TESTS: 3/3 OK(探测报告/跳过开关/postinstall 非致命)');
+
+
+//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/bootstrap-tests.ts