@danceiny/gotry 0.0.1-rc.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Danceiny (GoTry)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,267 @@
+# GoTry
+
+> **身体和灵魂，更多旅行，更少旅游。**
+> *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.
+
+| | |
+|---|---|
+| **Version** | `v0.0.1-rc.9`(npm **latest 直指本版**,`npx @danceiny/gotry` 即得;[release notes](docs/release-notes.md)) |
+| **Status** | M4 记忆域推进中(2026-08-28):记忆写读闭环 + 效用 sidecar + 「下一次出发」0::1 召回;17 工具;事务化状态账本(ADR-15)+ 双形态架构冻结(ADR-16:本地+Web 一套账本语义,tenant_id 一等字段);全栈回归全绿(套件清单见 `scripts/run-all-tests.sh` 分节) |
+| **Repo** | [github.com/Danceiny/gotry](https://github.com/Danceiny/gotry) (private) |
+| **Runtime** | DeepSeek Harness 0.1.1-rc.2 (vendored `ts/dsh-runtime/`, [upstream](https://github.com/deepseek-ai/DeepSeek-Harness)) · Z3 (npm `z3-solver`) · LoopX (pipx, `~/.local/pipx/venvs/loopx/bin/loopx`) · Agent-Reach v1.5.0 (`.venv/bin/agent-reach`) |
+| **License** | **MIT** (2026-08-23 落定,见 [LICENSE](LICENSE)) |
+
+
+---
+
+## ✨ 它做什么 — What it does
+
+GoTry 把「想去哪」变成「能不能、怎么去」：
+
+| 阶段 | AI/Engine | 输什么 |
+|---|---|---|
+| **动机访谈** | LLM | 必问项：工作窗口 / 已订资源 / 出发城市 |
+| **事实抽取** | LLM | 工作窗口生效 + 休假语义识别 |
+| **可行性判定** | **Z3** | 哪些候选目的地**可行**、哪些**不可行**、为什么、**如何最小化改动让它变可行** |
+| **门到门全成本** | 求解器 | 真实飞行时长（含时差）+ 醒来起夜惩罚 + 接驳代价 + 到达精力 % |
+| **证据链** | 渲染层 | 每个数字标 `[骨架:openflights]`、`[实时API:hbcli]`、`[静态包:估算]` |
+
+**不像普通 AI 聊天**——LLM 只做理解和解释，**判定与算术是数学求解器**算的。
+
+> **Unlike a regular AI chat**, the LLM only translates and explains. **Decisions and arithmetic are computed by a Z3 solver**, not guessed.
+
+---
+
+## 🚀 快速开始 — Quick start
+
+### 一行启动(npm,推荐)
+
+```bash
+npx @danceiny/gotry web          # 首跑会提示在当前目录建 .env(LLM_API_KEY=<DeepSeek key>)
+```
+
+装完即得 :3080 对话界面。已装 dsh 的用户同理——上面的命令会自动以 cordis patch
+挂载 gotry 插件,无需任何额外配置(零成本启动)。
+
+> rc.5 为不可用首发(已停止指向);`@rc` tag 当前为 rc.7,`latest` 为 rc.9,两者均可跑。rc.10 在仓(双形态冻结 ADR-16),待发——见 release-notes。
+
+### 源码安装(开发者)
+
+```bash
+git clone https://github.com/Danceiny/gotry
+cd gotry
+```
+
+#### A. 装 vendored dsh runtime(一次性,约 1 分钟)
+
+```bash
+cd ts/dsh-runtime
+pnpm install    # 拉 @deepseek-ai/dsh 0.1.1-rc.2 + 依赖(实测 51 秒)
+cd ../..
+```
+
+> 为什么这一步:dsh runtime 是 vendored 的(`ts/dsh-runtime/`)——
+> 避免 npm 一键分发时把整个 dsh 也打包进去。
+> 之后可以重复使用,无需重装。
+
+#### B. 环境前置 — Prerequisites
+
+- **Node 22+**(`nvm install 22` 或更高)
+- 一个 LLM API key(默认走 DeepSeek,也支持 OpenAI 兼容协议)
+
+#### C. 配 — Configure
+
+```bash
+cp .env.example .env
+# 填 LLM_API_KEY(deepseek: sk-...; 也兼容 OpenAI/Anthropic 兼容协议)
+```
+
+#### D. 跑 — Run(仓内入口,开发者)
+
+gotry 把 **DeepSeek Harness (dsh) 运行时**作为唯一推荐面——任何自然语言输入在那里面都能跟 GoTry 正常对话(自动调用引擎、追问缺失字段、给出证据链)。
+
+启动方式有三种,对应三种使用场景:
+
+| 入口 | 命令 | 什么时候用 | 给你什么 |
+|---|---|---|---|
+| **① dsh Web 对话框**(推荐) | `./gotry web` | 第一天上手;持续多轮规划;想看推理过程可视化 | `http://127.0.0.1:3080` 浏览器界面;带 GoTry 人格的对话框 |
+| **② headless 一次性问答** | `./gotry "一句完整任务..."` | 写脚本、CI 自动化、定向 LLM 调试 | stdout 输出 markdown 回答 |
+| **③ help** | `./gotry help` | 不知道用法 | 三行帮助 |
+
+```bash
+# 推荐:打开对话框,正常打「我想去大理三天」,看引擎回答
+./gotry web
+#   → http://127.0.0.1:3080,在输入框里像跟 DeepSeek 对话一样打字
+
+# 调试/自动化:直接一问一答,无浏览器
+./gotry "我想从深圳休整两天,预算 3000"
+#   → stdout 拿到引擎判定 + 证据链 + 候选 gate
+
+# 不知道用法
+./gotry help
+```
+
+> ⚠️ **dsh 运行时端口冲突**:如果你之前已经手动 `node ...dsh web` 跑过,而后再 `./gotry web`,会因 `:3080` 占用启动失败。要么先 `kill <PID>`,要么直接用已经在跑的那个。
+>
+> **dsh 启动耗时**:第一次 cold start 6–15 秒(cordis 组合 + plugin 加载 + LLM 准备);之后热启动 < 2 秒。
+>
+> **headless 报错兜底**:意外退出(exit ≠ 0 / signal)会 fsync 一条记录到 `gotry-state/incidents.jsonl`,作为事故证据而不是沉默(D-NEW 进程护栏)。
+
+<br>
+
+*One-liner mental model: `npx @danceiny/gotry@rc web` + `.env` 一行 key — done。dsh 对话框是唯一产品面(旧 shell 前端已删除)。*
+
+> 一行安装的关键点: `./gotry web`(终端粘贴即用),或 `./gotry "任务"`(一句问答)。**任何自然语言都能用**(这是 dsh runtime 投资的最大价值)。详见 [known limitations](#-known-limitations)。
+
+
+---
+
+## 🎬 一段对话 — Demo
+
+输入 → 引擎判定 → 输出（真实截图，monospace 保留原味）：
+
+```
+> 我想去洱海边发呆两三天，上海出发，预算 3000，年假别让我办公。
+
+GoTry: 收到。先把约束记下来——
+  • 窗口: 2 天(2026 年窗口)
+  • 出发: 上海
+  • 预算: ¥3000 全含
+  • 动机: 休整 / [escape_rest: 0.7]
+  • 不要求工作窗口(年假)
+  • 还没订任何东西
+
+引擎判定:
+
+  **大理·洱海: 现在不行** —— 冲突约束: duration。
+    你的 2 天窗口装不下「至少 5 天的洱海休整」(你之前的画像也有此约)。
+    放宽方案: 把行程延长到 5 天,约 ¥4950。
+  ★已放入「下一次出发」清单: 需 5 天起,3-5 / 9-11 月最佳。
+
+  **千岛湖: 可行** (G7315 06:35 出发,bus 接驳,
+   ¥996,起床 06:35,到达精力 84%,门到门 5h20m,
+   有效休整 4.4h)
+  **太湖: 可行** (G101 09:00 出发,
+   ¥716,起床 07:12,到达精力 84%,
+   有效休整 4.6h)
+
+  建议: 千岛湖(意象匹配 80%)。
+  备选: 太湖(¥716,匹配 60%)。
+
+**待你决定**:
+  1. 千岛湖还是太湖?(前者更贴意象,后者更省)
+  2. 出发班次选 G7315(06:35)还是更晚的?
+
+[骨架: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.
+
+---
+
+## 🏛️ 架构 — Architecture
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│ L1  对话即界面  chat-as-UI; gates 是消息内选择题                 │
+│ L2  编排  dsh 运行时 + GoTry 插件(ReAct);13 个工具            │
+│ L3  领域  统一行程模型 + Z3 可行性引擎(枚举/Z3 双形态)        │
+│ L4  数据  静态数据包 + hotelbyte-cli 实时桥 + OpenFlights 骨架 │
+│ L5  治理  LoopX(objective / gates / evidence / quota)         │
+└──────────────────────────────────────────────────────────────┘
+```
+
+| 层 | 模块 | 角色 |
+|---|---|---|
+| L2 | `ts/src/index.ts` (dsh 插件) | 注册 13 个工具,挂 `{{current_date}}`/`{{time_anchor_card}}`/`{{motivation_brief}}` 变量,工具 execute 异常隔离 + 平铺观察 envelope + uncaughtException 护栏 |
+| L3 | `ts/src/unified.ts` · `py/gotry_feasibility/unified.py` | 唯一求解入口(候选枚举 + 航班链 Z3) |
+| L4 | `ts/capabilities/hbcli.ts` | hotelbyte-cli 进程封装 + 降级到 `data/hotels_2026.json` |
+| L4 | `ts/scripts/skeleton-check.ts` | OpenFlights 168 对枢纽,三值语义(阳性/枢纽对否定≠证伪/枢纽外=无结论) |
+
+> 📖 完整 ADR / 演进阶段 / 债务清单见 [`docs/architecture.md`](docs/architecture.md)。
+
+
+---
+
+## ⚠️ Known limitations · 已知限制
+
+- ✅ **License MIT** (D-1 落地 2026-08-23)
+- **zh-CN 体验** — 当前面向中国出境首发(你的账号语言习惯)。英文界面/wider 国际化未做,等 M4 校准输入落定。
+- **机票实时数据** — 静态包(`data/flights_2026.json`)作为降级。实时票价接入留到 v0.1.x。
+- **Z3 WASM race** — 连续跑多个测试套件时偶发 `memory access out of bounds`(已规避回滚)。M3 早期处理。
+- **薄壳已废弃** — `./gotry shell` 不再推荐;dsh web 是唯一面。本版 README 仍保留旧命令行做迁移证据。
+
+
+---
+
+## 📚 文档 — 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/只读指标投影)。
+
+---
+
+## 🤝 参与开发 — Contributing
+
+仓库内 branch 模型:`main` 是唯一分支(没有 dev/staging)。所有迭代在 main 直接推(每次提交需全栈绿)。
+
+```bash
+./scripts/run-all-tests.sh   # 提交前必跑
+
+# 单独跑某个套件
+cd ts && npx tsx scripts/replay.ts          # 对话重放(mock,不需要 key)
+cd ts && npx tsx scripts/hbcli-tests.ts     # 能力封装
+cd ts && npx tsx scripts/incident-tests.ts  # 进程护栏
+```
+
+ADR 与技术债见 [`docs/architecture.md` §8 / §10](docs/architecture.md)。Agent 协作契约见 [`AGENTS.md`](AGENTS.md)。
+
+---
+
+## 📜 License
+
+**MIT**（2026-08-23 落定）。与上游 dsh（MIT）/ loopx 一致——宽松、可商用、可闭源分叉。
+
+文本见 [LICENSE](LICENSE)。
+
+---
+
+## 🌐 中英版 — Locales
+
+- **English section summaries** are inline above (italic blockquotes).
+- 本 README 主语言是中文,面向中国出境首发种子用户群。
+- 完整英文版 README 计划在 v0.1.0 同步([issue 路线](#-known-limitations))。
+
+---
+
+**Built with**: DeepSeek Harness 0.1.1-rc.2 · Cordis · Z3 (WASM) · loopx (pipx) · hotelbyte-cli · Agent-Reach v1.5.0 (`.venv/`) · OpenFlights · TypeScript · Bun
+
+**Last verified against `v0.0.1-rc.9`(已发布,2026-08-28)** — 全栈回归全绿(发布流程见 `scripts/publish-npm.sh`,内部决策见 [docs/decisions-needed.md](docs/decisions-needed.md)、[docs/tokens.md](docs/tokens.md))。

package/bin/gotry-inner.js

@@ -0,0 +1,214 @@
+#!/usr/bin/env node
+/**
+ * gotry CLI 入口(v0.0.1-rc.2 起;rc.6 起支持 npm 安装运行):
+ *   gotry web                          # dsh Web 浏览器界面(:3080)
+ *   gotry "I want 2 days in Phuket"    # headless one-shot
+ *   gotry help                         # help
+ *
+ * 工作流程:
+ *   1. 解析 argv + .env(provider-neutral → DEEPSEEK_API_KEY)
+ *   2. 定位 dsh runtime:
+ *      a. repo checkout → vendored ts/dsh-runtime/node_modules/...
+ *      b. npm 安装     → createRequire 解析依赖 @deepseek-ai/dsh(不走 npx:
+ *         dsh cordis-loader 在子 cwd 求值 plugin name,必须绝对路径 patch)
+ *   3. 运行时生成 patch(os.tmpdir):把 gotry-tools 插件路径重写为按本包
+ *      位置解析的绝对路径 —— 仓内 cordis.gotry-patch.yml 里的 name 行只是
+ *      占位(本机绝对路径),随 tarball 分发后对其他机器必错。
+ */
+
+import { spawn } from 'node:child_process'
+import { existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { dirname, join } from 'node:path'
+import { tmpdir } from 'node:os'
+import { createRequire } from 'node:module'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const repoRoot = join(here, '..')
+const require_ = createRequire(import.meta.url)
+
+// --- 环境 .env 加载(provider-neutral) ---
+// npm 安装模式优先读用户当前目录的 .env(包目录内不该有凭证);repo 检出读仓根。
+const vendoredDshEarly = existsSync(join(repoRoot, 'ts/dsh-runtime/node_modules/@deepseek-ai/dsh/lib/bin.js'))
+const envCandidates = vendoredDshEarly
+  ? [join(repoRoot, '.env')]
+  : [join(process.cwd(), '.env'), join(repoRoot, '.env')]
+const envLines = []
+for (const p of envCandidates) {
+  if (existsSync(p)) envLines.push(...readFileSync(p, 'utf-8').split('\n'))
+}
+for (const line of envLines) {
+  const m = line.match(/^\s*([A-Z_][A-Z0-9_]*)\s*=\s*(.*)$/i)
+  if (!m || line.trim().startsWith('#')) continue
+  const k = m[1]; const v = m[2].trim().replace(/^["']|["']$/g, '')
+  if (process.env[k] === undefined) process.env[k] = v
+}
+if (process.env.LLM_API_KEY && !process.env.DEEPSEEK_API_KEY) {
+  process.env.DEEPSEEK_API_KEY = process.env.LLM_API_KEY
+}
+
+// --- argv 解析 ---
+const args = process.argv.slice(2)
+const help = args.length === 0 || args[0] === '-h' || args[0] === '--help' || args[0] === 'help'
+
+if (help) {
+  console.log(`GoTry — dsh-driven AI travel agent
+
+Usage:
+  gotry web                          # dsh Web UI on http://127.0.0.1:3080
+  gotry "一段完整任务..."            # headless 一问一答
+  gotry help                         # this help
+
+Prerequisites:
+  • Node 22+
+  • \`.env\` 里 LLM_API_KEY (DeepSeek / OpenAI 兼容均可)
+
+Detail: https://github.com/Danceiny/gotry — README
+`)
+  process.exit(0)
+}
+
+// mode 决定路径: 'web'/'help'/'help' 是字面命令;否则第一段 args[0] 是任务本身的一部分
+const literal = new Set(['web', 'help', '-h', '--help'])
+const isLiteral = literal.has(args[0])
+const mode = isLiteral ? args[0] : 'headless'
+const rest = isLiteral ? args.slice(1) : args
+
+// --- dsh runtime 定位:repo checkout(vendored)优先,npm 安装走依赖解析 ---
+const vendoredDsh = join(repoRoot, 'ts/dsh-runtime/node_modules/@deepseek-ai/dsh/lib/bin.js')
+let dshBin = ''
+let dshCwd = ''
+if (existsSync(vendoredDsh)) {
+  dshBin = vendoredDsh
+  dshCwd = join(repoRoot, 'ts/dsh-runtime')
+} else {
+  try {
+    dshBin = require_.resolve('@deepseek-ai/dsh/lib/bin.js')
+    dshCwd = process.cwd() // npm 安装:gotry-state 落在用户调用目录
+  } catch {
+    dshBin = ''
+  }
+}
+
+if (!dshBin) {
+  console.error(`[gotry] 找不到 dsh runtime(既无 vendored ${vendoredDsh},依赖里也没有 @deepseek-ai/dsh)。`)
+  console.error('repo checkout: cd ts/dsh-runtime && pnpm install;npm 安装: npm install(检查 node_modules)。')
+  process.exit(1)
+}
+
+// --- 运行时 patch:插件路径按本包位置重写为绝对路径 ---
+// npm 模式指向 dist/ 纯 JS(Node 拒绝 strip node_modules 下的 .ts);
+// repo 检出指向 .ts 源码(vendored runtime 下天然可行)。
+const distEntry = join(repoRoot, 'dist/src/index.js')
+const tsEntry = join(repoRoot, 'ts/src/index.ts')
+const npmMode = !existsSync(vendoredDsh)
+const pluginEntry = npmMode && existsSync(distEntry) ? distEntry : tsEntry
+const staticPatch = join(repoRoot, 'cordis.gotry-patch.yml')
+if (!existsSync(staticPatch)) {
+  console.error(`[gotry] 找不到 patch 配置: ${staticPatch}`)
+  process.exit(1)
+}
+if (!existsSync(pluginEntry)) {
+  console.error(`[gotry] 找不到插件入口: ${pluginEntry}(包不完整?)`)
+  process.exit(1)
+}
+// dsh-map-tools 宿主插件(地图/路线/POI,零 key 走 OSM/OSRM):repo 用 vendored,
+// npm 用依赖解析;都找不到就整块剔除 patch 条目(缺地图不挡旅行规划)
+let mapEntry = ''
+const vendoredMap = join(repoRoot, 'ts/dsh-runtime/node_modules/dsh-map-tools/lib/index.js')
+if (existsSync(vendoredMap)) {
+  mapEntry = vendoredMap
+} else {
+  // npm 布局:子路径可能被 exports 挡(resolve 抛错不能留下旧值),裸包名返回真实入口
+  try { mapEntry = require_.resolve('dsh-map-tools/lib/index.js') } catch { mapEntry = '' }
+  if (!mapEntry) { try { mapEntry = require_.resolve('dsh-map-tools') } catch { mapEntry = '' } }
+}
+// 结构化澄清卡(T2):ask_user_question 工具 + user-questions 服务,从 dsh 包
+// 上下文解析(pnpm 嵌套布局下只有 dsh 自己看得见这些依赖);失败整块剔除
+// 澄清卡注入(T2):web 用 dsh 原生卡片;headless+TTY 用 gotry 的 stdio 提供方
+// (终端渲染选择题);headless 非 TTY(CI/管道)不注入——工具收到 NO_PROVIDER
+// 错误,人格契约 (5) 退化文本。GOTRY_ASK_STDIO=1 强制启用(测试/外接答复)。
+const stdioAsk = mode === 'headless' && (process.stdin.isTTY || process.env.GOTRY_ASK_STDIO === '1')
+  ? join(here, 'gotry-stdio-ask.js') : ''
+let askUserInsert = ''
+if (mode === 'web' || stdioAsk) try {
+  const reqFromDsh = createRequire(dshBin)
+  // 裸包名解析(这些包的 exports 不暴露 ./lib/index.js 子路径,但裸名返回真实入口)
+  // userQuestions 服务默认树已注册(重复插入会崩),只插工具消费者
+  const at = reqFromDsh.resolve('@deepseek-ai/dsh-tool-ask-user')
+  askUserInsert = (stdioAsk ? `    - id: gotry-stdio-ask\n      name: '${stdioAsk}'\n` : '')
+    + `    - id: dsh-tool-ask-user\n      name: '${at}'`
+} catch { /* 缺件不挡启动 */ }
+
+let patchRaw = readFileSync(staticPatch, 'utf-8')
+  .replace(/(name:\s*)'[^']*ts\/src\/index\.ts'/, `$1'${pluginEntry}'`)
+  .replace(/^\s*# \{ask-user-insert\}.*\n(\s*# .*\n)?/m, askUserInsert ? askUserInsert + '\n' : '')
+if (mapEntry) {
+  patchRaw = patchRaw.replace(/(name:\s*)'placeholder\/dsh-map-tools'/, `$1'${mapEntry}'`)
+} else {
+  patchRaw = patchRaw.replace(/\n\s*- id: dsh-map-tools\n\s*name: 'placeholder\/dsh-map-tools'\n/, '\n')
+}
+
+// dsh-calendar 宿主插件(CalDAV 工作窗口读取;未配置时工具报错降级,不挡启动)
+let calEntry = ''
+const vendoredCal = join(repoRoot, 'ts/dsh-runtime/node_modules/dsh-calendar/lib/index.js')
+if (existsSync(vendoredCal)) {
+  calEntry = vendoredCal
+} else {
+  try { calEntry = require_.resolve('dsh-calendar/lib/index.js') } catch { calEntry = '' }
+  if (!calEntry) { try { calEntry = require_.resolve('dsh-calendar') } catch { calEntry = '' } }
+}
+if (calEntry) {
+  patchRaw = patchRaw.replace(/(name:\s*)'placeholder\/dsh-calendar'/, `$1'${calEntry}'`)
+} else {
+  patchRaw = patchRaw.replace(/\n\s*- id: dsh-calendar\n\s*name: 'placeholder\/dsh-calendar'\n/, '\n')
+}
+const patchPath = join(tmpdir(), `cordis.gotry.${process.pid}.yml`)
+writeFileSync(patchPath, patchRaw)
+if (!process.env.DEEPSEEK_API_KEY && mode !== 'help') {
+  console.error('[gotry] 缺少 LLM API key —— 两种方式任选其一后重跑:')
+  console.error(`  1) 在当前目录创建 .env 写入一行: LLM_API_KEY=<你的 DeepSeek key>(key 从 https://platform.deepseek.com 获取)`)
+  console.error('  2) 或临时环境变量: export LLM_API_KEY=<key>')
+  process.exit(1)
+}
+
+// --- 调 vendored dsh 二进制(不走 npx)---
+// headless: 第一个非 -- 之后的参数是 task —— gotry argv 0 是 headless 触发,其余都算 task;
+const binJs = mode === 'web'
+  ? ['web', '--patch', patchPath, ...(process.argv.includes('--no-open') ? ['--no-open'] : [])]
+  : ['--profile', 'headless', '--patch', patchPath, ...rest]
+
+const child = spawn(process.execPath, [dshBin, ...binJs], {
+  stdio: 'inherit',
+  env: process.env,
+  cwd: dshCwd,
+})
+if (process.env.GOTRY_DEBUG) {
+  console.error('[gotry-debug] exec:', process.execPath, dshBin)
+  console.error('[gotry-debug] argv:', binJs)
+  console.error('[gotry-debug] cwd:', dshCwd)
+  console.error('[gotry-debug] patch exists:', existsSync(patchPath), patchPath)
+}
+child.on('exit', (code, signal) => {
+  if (code !== 0 || signal) {
+    // D-NEW 护栏:dsh 异常退出也写一条 incident,留现场而非沉默
+    // npm 模式 import dist JS(node_modules 下的 .ts 会被 Node 拒 strip)
+    const incidentModule = npmMode && existsSync(join(repoRoot, 'dist/capabilities/incident-log.js'))
+      ? '../dist/capabilities/incident-log.js'
+      : '../ts/capabilities/incident-log.ts'
+    import(incidentModule).then(({ recordIncident }) => {
+      recordIncident({
+        ts: new Date().toISOString(),
+        kind: 'plugin_error',
+        message: `gotry spawn exit: ${mode} code=${code} signal=${signal}`,
+        source: 'gotry-cli',
+      }, repoRoot).catch(() => {})
+    }).catch(() => {}) // module 找不到时静默
+  }
+  process.exit(code ?? 1)
+})
+child.on('error', (e) => {
+  console.error(`[gotry] dsh 启动失败: ${e.message}`)
+  console.error('尝试: node -v 看 Node 版本(需 22+),或查看 ts/dsh-runtime/node_modules/。')
+  process.exit(1)
+})

package/bin/gotry-stdio-ask.js

@@ -0,0 +1,59 @@
+/**
+ * gotry stdio 澄清卡提供方(T2 补强,ask_user_question 的 headless/TTY 形态):
+ *
+ * dsh 的 userQuestions 服务是「单一 UI 提供方」架构——web 界面注册一种,这里注册
+ * 终端形态:ask_user_question 在交互终端渲染成选择题,读一行序号作答复。业界对照
+ * (Claude Code -p 最终做法是 headless 直接不暴露工具;MCP elicitation 规范:无提供
+ * 方应作为错误/优雅降级传回模型)——我们比照实现为:
+ *   - headless + TTY(人坐在终端前):注册本插件,终端问答(优于纯文本退化)
+ *   - headless + 非 TTY(CI/管道):不注册 → 工具收到 NO_PROVIDER 错误 → 人格契约
+ *     (5) 退化文本选择题;GOTRY_ASK_STDIO=1 可强制启用(测试/外接答复管道)
+ *
+ * 插件形态遵循 dsh 约定(name/inject/apply);纯 JS 无需 dist 编译。
+ */
+
+import { createInterface } from 'node:readline'
+
+export const name = 'gotry-stdio-ask'
+export const inject = ['userQuestions']
+
+export function apply(ctx) {
+  const svc = ctx.userQuestions
+  if (!svc || typeof svc.registerProvider !== 'function') return
+
+  svc.registerProvider({
+    async ask(request) {
+      const answers = []
+      for (const q of request.questions ?? []) {
+        if (request.signal?.aborted) { answers.push({ id: q.id, selected: [] }); continue }
+        const opts = q.options ?? []
+        const lines = ['', `❓ ${q.header ? `${q.header} — ` : ''}${q.question}`]
+        opts.forEach((o, i) => lines.push(`  ${i + 1}. ${o.label}${o.detail ? ` — ${o.detail}` : ''}`))
+        lines.push(q.multiSelect ? '  (多选:序号逗号分隔;回车=跳过,可输自定义文本)' : '  (输入序号回车;回车=跳过,可输自定义文本)')
+        process.stdout.write(lines.join('\n') + '\n> ')
+        const rl = createInterface({ input: process.stdin, output: process.stdout, signal: request.signal })
+        let raw = ''
+        try {
+          raw = (await new Promise((resolve) => {
+            rl.once('line', resolve)
+            rl.once('close', () => resolve(''))
+            if (request.signal) request.signal.addEventListener('abort', () => { try { rl.close() } catch { /* ignore */ } }, { once: true })
+          })).trim()
+        } finally { try { rl.close() } catch { /* ignore */ } }
+        const selected = []
+        let custom
+        if (raw && /^[0-9,\s]+$/.test(raw)) {
+          for (const part of raw.split(/[,\s]+/).filter(Boolean)) {
+            const o = opts[Number(part) - 1]
+            if (o) selected.push(o.label)
+          }
+        } else if (raw) {
+          custom = raw
+        }
+        // 空输入=跳过(MCP elicitation 规范:decline 是正常答复,不是错误)
+        answers.push({ id: q.id, selected, ...(custom !== undefined ? { custom } : {}) })
+      }
+      return { answers }
+    },
+  })
+}

package/bin/gotry.js

@@ -0,0 +1,28 @@
+#!/bin/sh
+# bin/gotry.js: npm bin entry(sh wrapper,找 node 路径,exec 真正代码 bin/gotry-inner.js)
+# 解决 nvm 没 source 时 `env: node: not found`。
+# 优先:$PATH → nvm 常见路径 → 系统路径 → 找不到给一次性提示。
+# 零新依赖;不改 npm bin 名(强制 .js 后缀),实际 node 代码在 bin/gotry-inner.js。
+
+conf="$(command -v node 2>/dev/null)"
+if [ -z "$conf" ] || [ ! -x "$conf" ]; then
+  for cand in \
+    "$HOME/.nvm/versions/node/v24.16.0/bin/node" \
+    "$HOME/.nvm/versions/node/v22.16.0/bin/node" \
+    /usr/local/bin/node \
+    /opt/homebrew/bin/node
+  do
+    if [ -x "$cand" ]; then conf="$cand"; break; fi
+  done
+fi
+if [ -z "$conf" ] || [ ! -x "$conf" ]; then
+  cat >&2 <<'EOF'
+gotry: node not found in PATH. Install Node 22+:
+  macOS:  brew install node@22  (or use nvm)
+  Linux:  https://nodejs.org/
+
+Then re-run: gotry web
+EOF
+  exit 1
+fi
+exec "$conf" "$(dirname "$0")/gotry-inner.js" "$@"