@danceiny/gotry 0.0.1-rc.17 → 0.0.1-rc.19

package/bin/gotry-bootstrap.js

@@ -23,10 +23,18 @@
  *                                           # 扩展改走 GitHub Releases 下载通道(ADR-21):
  *                                           #   dist-manifest → tar.gz → SHA256 → key 钉扎 → 原子交换;
  *                                           #   任何失败显式降级回包内副本(离线确定性不变)。
+ *   node bin/gotry-bootstrap.js calendar        # 可选日历挂载开关(D-9,setup 状态面):
+ *                                               #   默认写 ~/.gotry/calendar.json {"enabled":true};
+ *                                               #   --off 删除恢复默认不挂载;--status 只读查看。
+ *   node bin/gotry-bootstrap.js doctor      # 可选依赖体检(2026-09-02 迪拜 session 复盘):
+ *                                           #   扩展/agent-reach/.venv/hbcli/flyai key/sidebar/calendar
+ *                                           #   逐项只读检查 + 精确补装指引;
+ *                                           #   报告落 gotry-state/doctor-report.md(侧栏工作台可预览)。
+ *   node bin/gotry-bootstrap.js doctor --fix # 体检后按缺失项补装(复用下方三个安装器;LLM key 永不管)。
  *   node bin/gotry-bootstrap.js wizard       # 会话扩展 onboarding 闭环(issue #21 onboarding UX,§3.3):
  *                                           #   5 步编排 + 后台 health-watch 等扩展心跳,
  *                                           #   扩展一就位 stdout 翻绿并自动重放同 query。
- *                                           # 详见 docs/user-session-data-rfc.md §3.3 / RFC P3.6。
+ *                                           # 详见 docs/rfc/user-session-data-rfc.md §3.3 / RFC P3.6。
  *
  * 环境开关:
  *   GOTRY_SETUP_SKIP=1            全部跳过
@@ -46,7 +54,7 @@
  */
 
 import { spawn } from 'node:child_process'
-import { copyFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs'
+import { copyFileSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
 import { homedir } from 'node:os'
 import { join, dirname } from 'node:path'
 import { fileURLToPath } from 'node:url'
@@ -158,13 +166,231 @@ async function setupSidebar() {  say('[gotry-setup] dsh-better-sidebar(dsh web
   if (!launched) say('  本包未携带 @deepseek-ai/dsh,走 npx 途径安装')
   const r2 = await run('npx', ['-y', '--package', '@deepseek-ai/dsh', 'dsh', 'plugin', '--profile', 'web', 'add', SIDEBAR_PKG], { timeoutMs: 300_000 })
   if (!r2.ok) {
-    say('  ✗ 安装失败——不影响 gotry:产物仍可在对话里说「看看我生成的行程」经 gotry_artifacts_list/read 查看;可稍后重试: npx gotry setup')
+    say('  ✗ 安装失败——不影响 gotry:产物仍可在对话里说「看看我生成的行程」经 gotry_artifacts_list/read 查看;可稍后重试: npx gotry doctor --fix')
     return { ok: false }
   }
   say('  ✓ 安装完成(gotry web 刷新浏览器即见右侧工作台)')
   return { ok: true }
 }
 
+// ---------------------------------------------------------------------------
+// doctor(可选依赖体检;与 ts/capabilities/doctor.ts 同一状态面,-bootstrap 是
+// CLI 执行面纯 JS、capabilities 是 MCP 工具面 TS——两边清单/口径成对修改)
+// ---------------------------------------------------------------------------
+
+const DOCTOR = process.argv.includes('doctor')
+const DOCTOR_FIX = process.argv.includes('--fix')
+// calendar 子命令(issue #106/D-9):可选日历挂载的 setup 状态管理面。
+// `gotry setup calendar`=开启;`--off`=关闭(删状态文件恢复默认);`--status`=只读查看。
+const CALENDAR_CMD = process.argv.includes('calendar')
+const CALENDAR_OFF = process.argv.includes('--off')
+const CALENDAR_STATUS = process.argv.includes('--status')
+
+// --- calendar setup 状态面(与扩展 manifest 同居 ~/.gotry;运行时 inner 与
+// doctor 两端同读这一份,禁止 env 控制产品行为——founder 2026-09-03 纠偏)---
+function calendarStatePath() { return join(homedir(), '.gotry', 'calendar.json') }
+function readCalendarState() {
+  try { return JSON.parse(readFileSync(calendarStatePath(), 'utf8')) } catch { return null }
+}
+function calendarProfileConfigured() {
+  try {
+    const patch = readFileSync(join(homedir(), '.dsh', 'profiles', 'web', 'cordis.patch.yml'), 'utf8')
+    return /calendar/.test(patch) && /username\s*:/.test(patch)
+  } catch { return false }
+}
+
+/** 挂载/配置双态人话(bootstrap doctor 与 calendar 子命令共用) */
+function calendarDetail(state) {
+  if (!state || state.enabled !== true) return '默认未挂载(D-9:未配置的日历工具不进工具箱;工作窗口由访谈覆盖,不影响任何检索)'
+  return calendarProfileConfigured()
+    ? `已挂载且已配置(${calendarStatePath()})`
+    : '已挂载但 calendar 未配置 username——日历工具会话中会报「未配置」'
+}
+
+async function runCalendar() {
+  say('[gotry-setup] dsh-calendar(可选日历,CalDAV 工作窗口读取;默认不挂载)')
+  if (CALENDAR_STATUS) {
+    const state = readCalendarState()
+    say(`  状态: ${calendarDetail(state)}`)
+    say(`  状态文件: ${calendarStatePath()}`)
+    say('  说明: 挂载=`npx gotry setup calendar`;关闭=`npx gotry setup calendar --off`;配置在 dsh profile 的 cordis.patch.yml 覆盖 calendar 行 config 填 username')
+    return 0
+  }
+  if (CALENDAR_OFF) {
+    try { rmSync(calendarStatePath()) } catch { /* 本就未开启 */ }
+    say('  ✓ 已关闭——恢复默认不挂载(状态文件已删除;如需再开: npx gotry setup calendar)')
+    return 0
+  }
+  mkdirSync(dirname(calendarStatePath()), { recursive: true })
+  writeFileSync(calendarStatePath(), `${JSON.stringify({ enabled: true, updatedAt: new Date().toISOString() }, null, 2)}\n`, 'utf8')
+  say(`  ✓ 已开启挂载(状态文件 ${calendarStatePath()};重启 gotry web/headless 生效)`)
+  if (calendarProfileConfigured()) {
+    say('  ✓ calendar 已在 dsh profile 配置 username——全部就绪')
+  } else {
+    say('  ⚠ 还差最后一步:在 dsh profile 的 cordis.patch.yml 覆盖 calendar 行的 config,填你的 CalDAV username,例如:')
+    say('      - id: dsh-calendar')
+    say('        config:')
+    say('          username: <你的日历账号>')
+    say('    未配置时日历工具会话中会报「未配置」;不需要日历时可用 --off 恢复默认不挂载。')
+  }
+  return 0
+}
+
+/** 逐项只读检查(永不抛错;LLM key 显式让渡给 dsh 宿主,不体检)。
+ *  level 与 ts/capabilities/doctor.ts DoctorStatus 同构:ok / missing / degraded。 */
+async function doctorChecks() {
+  const items = []
+  // Node 运行时
+  const nv = process.versions.node
+  const [maj, min] = nv.split('.').map(Number)
+  const nodeFine = maj > 22 || (maj === 22 && min >= 15)
+  items.push({ label: 'Node 运行时', ok: nodeFine, level: nodeFine ? 'ok' : 'missing', detail: `Node ${nv}(需 ≥22.15)`, fix: nodeFine ? undefined : '升级 Node.js 至 22.15+(https://nodejs.org)' })
+  // 扩展
+  const extManifest = join(homedir(), '.gotry', 'extension', 'manifest.json')
+  const extOk = existsSync(extManifest)
+  items.push({ label: 'GoTry Session Bridge 扩展', ok: extOk, level: extOk ? 'ok' : 'missing', detail: extOk ? `已就位(${extManifest})` : '未安装——gotry_session_search / gotry_session_login(账号会话通道)不可用,其余工具不受影响', fix: extOk ? undefined : '在 Chrome 应用商店一键安装(自动更新): https://chromewebstore.google.com/detail/gotry-session-bridge/oeajpiccmonococjcegddlooeeohlbgd' })
+  // agent-reach(.venv 装在包内)
+  const venvPython = join(repoRoot, '.venv/bin/python')
+  const reachBin = join(repoRoot, '.venv/bin/agent-reach')
+  const reachOk = existsSync(reachBin)
+  const reachLevel = reachOk ? 'ok' : existsSync(venvPython) ? 'degraded' : 'missing'
+  items.push({ label: 'Agent Reach(网页/社媒读取)', ok: reachOk, level: reachLevel, detail: reachOk ? `已安装(${reachBin})` : reachLevel === 'degraded' ? '.venv 在但缺 agent-reach 包——gotry_agent_reach / gotry_web_search 读页会失败' : '未装配——gotry_agent_reach / gotry_web_search(读网页)/ gotry_video_subtitle / gotry_github_search 全部不可用', fix: reachOk ? undefined : 'npx gotry doctor --fix' })
+  // hbcli(裸名靠 PATH 探测;绝对路径 existsSync)
+  let hbBin = ''
+  for (const p of ['hbcli', join(homedir(), '.local/bin/hbcli'), join(homedir(), '.staicli/current/hbcli')]) {
+    if (p === 'hbcli') { if (await probe(p, ['version'])) { hbBin = 'hbcli(PATH)'; break } } else if (existsSync(p)) { hbBin = p; break }
+  }
+  if (hbBin) {
+    const whoami = await probe(hbBin === 'hbcli(PATH)' ? 'hbcli' : hbBin, ['auth', 'whoami'])
+    items.push({ label: 'hbcli(酒店实时源)', ok: whoami, level: whoami ? 'ok' : 'degraded', detail: whoami ? `已安装且凭证有效(${hbBin})` : '二进制在,但凭证未配置/失效——酒店检索将降级静态包(非实时)', fix: whoami ? undefined : 'hbcli auth set-credentials --app-key hotelbyte_api_demo --app-secret hotelbyte_api_demo(快速试用沙箱;正式 key 向 HotelByte 申请)' })
+  } else {
+    items.push({ label: 'hbcli(酒店实时源)', ok: false, level: 'missing', detail: '未安装——酒店检索降级静态包(公开渠道估算,非实时,仅覆盖内置场景)', fix: 'npx gotry doctor --fix' })
+  }
+  // flyai key(匿名试用额度共享易达限;正式 key 即免)
+  const flyaiKey = (process.env.FLYAI_API_KEY ?? '').trim()
+  items.push({ label: 'FlyAI(飞猪官方检索)', ok: Boolean(flyaiKey), level: flyaiKey ? 'ok' : 'degraded', detail: flyaiKey ? 'FLYAI_API_KEY 已配(正式 key,无试用额度限制)' : '未配 FLYAI_API_KEY——走匿名试用额度(共享,易达限;达限报 "Trial limit reached")', fix: flyaiKey ? undefined : '到 flyai.open.fliggy.com 控制台申请正式 key,配进环境变量 FLYAI_API_KEY' })
+  // sidebar
+  const sidebarPkg = join(homedir(), '.dsh/profiles/web/node_modules/dsh-better-sidebar/package.json')
+  const sbOk = existsSync(sidebarPkg)
+  items.push({ label: 'dsh-better-sidebar(侧栏工作台)', ok: sbOk, level: sbOk ? 'ok' : 'missing', detail: sbOk ? '已安装——web UI 右侧工作台可预览产物与 doctor 报告(gotry-state/doctor-report.md)' : '未安装——dsh web 无右侧工作台,产物与 doctor 报告只能在对话里看(gotry_artifacts_list)', fix: sbOk ? undefined : 'npx gotry doctor --fix' })
+  // dsh-calendar(setup 状态面;默认不挂载=ok 是合法态,opt-in 未配置才 degraded)
+  const calState = readCalendarState()
+  const calOn = calState?.enabled === true
+  const calConfigured = calOn && calendarProfileConfigured()
+  items.push({ label: 'dsh-calendar(日历工作窗口)', ok: !calOn || calConfigured, level: !calOn ? 'ok' : calConfigured ? 'ok' : 'degraded', detail: calendarDetail(calState), fix: !calOn ? undefined : calConfigured ? undefined : '在 ~/.dsh/profiles/web/cordis.patch.yml 覆盖 calendar 行 config 填 username(或 npx gotry setup calendar --off 恢复默认不挂载)' })
+  // dsh-map-tools(patch 分发面宿主插件,issue #139):解析失败启动时整块静默剔除,
+  // doctor 把两态照亮。候选清单与 bin/gotry-inner.js 解析链、ts/capabilities/doctor.ts 同口径。
+  const mapCandidates = [
+    join(repoRoot, 'ts/dsh-runtime/node_modules/dsh-map-tools/lib/index.js'),
+    join(repoRoot, 'node_modules/dsh-map-tools/package.json'),
+    join(repoRoot, 'ts/node_modules/dsh-map-tools/package.json'),
+    join(homedir(), '.dsh/profiles/web/node_modules/dsh-map-tools/package.json'),
+  ]
+  const mapHit = mapCandidates.find((p) => existsSync(p))
+  items.push(mapHit
+    ? { label: 'dsh-map-tools(地图/路线/POI)', ok: true, level: 'ok', detail: `已就位(${mapHit})——地图工具可用(零 key,走 OSM/OSRM)`, fix: undefined }
+    : { label: 'dsh-map-tools(地图/路线/POI)', ok: false, level: 'missing', detail: '未随包解析——启动时该 patch 条目被静默剔除,地图/路线/POI 工具不会出现在模型工具箱(缺地图不挡旅行规划,只少能力)', fix: 'npx gotry doctor --fix 不覆盖此项:source 布局把 dsh-map-tools 放进 ts/dsh-runtime/node_modules(或 ts/node_modules);npm 布局重装 @danceiny/gotry(随发行版依赖提供)' })
+  // dsh-tool-ask-user(结构化澄清卡,人格契约 (5) 的卡片形态载体)
+  const askCandidates = [
+    join(repoRoot, 'ts/dsh-runtime/vendor/deepseek-ai-dsh-tool-ask-user/package.json'),
+    join(repoRoot, 'node_modules/@deepseek-ai/dsh-tool-ask-user/package.json'),
+    join(homedir(), '.dsh/profiles/web/node_modules/@deepseek-ai/dsh-tool-ask-user/package.json'),
+  ]
+  const askHit = askCandidates.find((p) => existsSync(p))
+  items.push(askHit
+    ? { label: 'dsh-tool-ask-user(结构化澄清卡)', ok: true, level: 'ok', detail: `已就位(${askHit})——ask_user_question 澄清卡可用(web 原生卡片;headless+TTY 用 stdio 提供方)`, fix: undefined }
+    : { label: 'dsh-tool-ask-user(结构化澄清卡)', ok: false, level: 'missing', detail: '未解析——启动时澄清卡注入被静默剔除,模型只能散文追问(人格契约 (5) 退化文本形态)', fix: '重装 @danceiny/gotry——该依赖随 dsh 闭包自带,缺失多为安装不完整' })
+  // LLM key:显式让渡(founder 2026-09-02:doctor 不管 key)
+  items.push({ label: 'LLM key', ok: true, level: 'ok', detail: '由 dsh 宿主 UI 管理——不在体检范围(gotry 不接触、不回显凭证)', fix: undefined })
+  return items
+}
+
+const doctorIcon = { ok: '✅', missing: '❌', degraded: '⚠️' }
+
+/** 修复指引入表:命令类才加反引号( prose 类如「到控制台申请 key」原样) */
+const fixCell = (fix) => (!fix ? '—' : /^(npx|hbcli|curl|pip|python|\$)/.test(fix) ? `\`${fix}\`` : fix)
+
+/** 启动一次性摘要行(issue #114,design §3.1③):全 ok 返回 null(静默零输出);
+ *  有待处理项给一行人话 + 指路(对话里 gotry_doctor 看详情 / 终端 npx gotry doctor)。
+ *  纯函数,bootstrap-tests 直接断言。 */
+function startupDoctorLine(items) {
+  const broken = (items ?? []).filter((i) => i.level && i.level !== 'ok')
+  if (broken.length === 0) return null
+  const human = (lv) => (lv === 'missing' ? '缺' : '半可用')
+  return `[gotry] doctor: ${broken.length} 项待处理(${broken.map((i) => `${i.label}=${human(i.level)}`).join('、')})——对话里让助手调 gotry_doctor 看详情与指引,或终端跑 npx gotry doctor`
+}
+
+/** 体检报告 markdown(与 ts/capabilities/doctor.ts renderDoctorReportMd 同形) */
+function renderDoctorReportMd(items) {
+  const broken = items.filter((i) => i.level !== 'ok' && i.label !== 'LLM key')
+  const lines = [
+    '# GoTry 依赖体检报告(doctor)',
+    '',
+    `> 生成于 ${new Date().toISOString()};重新生成:终端 \`npx gotry doctor\`,或在对话里让助手调 gotry_doctor。`,
+    '',
+    '| 状态 | 依赖 | 现状 | 修复指引 |',
+    '|---|---|---|---|',
+    ...items.map((i) => `| ${doctorIcon[i.level]} | ${i.label} | ${i.detail} | ${fixCell(i.fix)} |`),
+    '',
+    `**结论**:${broken.length === 0 ? '全部就绪(可选依赖齐,LLM key 归 dsh 宿主管)。' : `${broken.length} 项待处理:${broken.map((i) => i.label).join('、')}。补装: npx gotry doctor --fix`}`,
+    '',
+    '---',
+    '',
+    '- `npx gotry doctor` 随时可重跑(只读,不改任何东西);',
+    '- `npx gotry doctor --fix` 按上表补装(hbcli 官方脚本 / agent-reach pip / dsh-better-sidebar 插件);',
+    '- LLM key 由 dsh 宿主 UI 管理,gotry 永不体检、不回显。',
+    '',
+  ]
+  return lines.join('\n')
+}
+
+/** doctor 主流程:体检 → 打印 →(可选)fix → 报告落盘。
+ *  exit 0=就绪(或仅剩有自动回退的降级项);exit 1=仍有缺失类问题。 */
+async function runDoctor() {
+  let items = await doctorChecks()
+  // 启动一次性摘要(issue #114):inner 分离子进程带 --summary 调用——只读体检,
+  // 有待处理项打一行 stderr,零写盘零 header;全 ok 静默。与完整体检面(逐项/报告落盘/exit 语义)分离。
+  if (process.argv.includes('--summary')) {
+    const line = startupDoctorLine(items)
+    if (line) console.error(line)
+    return 0
+  }
+  say('[gotry-doctor] GoTry 可选依赖体检(只读;LLM key 归 dsh 宿主管,不在范围)')
+  for (const i of items) {
+    say(`  ${doctorIcon[i.level]} ${i.label}:${i.detail}`)
+    if (i.level !== 'ok' && i.fix) say(`      ↳ 修复: ${i.fix}`)
+  }
+  if (DOCTOR_FIX) {
+    if (process.platform === 'win32') {
+      say('[gotry-doctor] --fix 在 Windows 暂不支持自动安装(hbcli/agent-reach 上游无 win 安装面);请按各项修复指引手动处理')
+    } else {
+      say('[gotry-doctor] 开始补装缺失项(--fix)…')
+      const results = []
+      if (process.env.GOTRY_SETUP_HBCLI !== '0') results.push(await setupHbcli())
+      if (process.env.GOTRY_SETUP_REACH !== '0') results.push(await setupReach())
+      if (process.env.GOTRY_SETUP_SIDEBAR !== '0') results.push(await setupSidebar())
+      const failedFix = results.filter((r) => !r.ok).length
+      say(failedFix === 0 ? '[gotry-doctor] 补装完成;下面是补装后复检。' : `[gotry-doctor] ${failedFix} 项补装失败——见上方安装器输出;可重跑 npx gotry doctor --fix`)
+      items = await doctorChecks()
+      for (const i of items) {
+        say(`  ${doctorIcon[i.level]} ${i.label}:${i.detail}`)
+      }
+    }
+  }
+  // 报告落盘(侧栏工作台预览面;写失败不挡体检结论)
+  try {
+    const stateDir = join(repoRoot, 'gotry-state')
+    mkdirSync(stateDir, { recursive: true })
+    writeFileSync(join(stateDir, 'doctor-report.md'), renderDoctorReportMd(items), 'utf8')
+    say(`[gotry-doctor] 报告已写: ${join(stateDir, 'doctor-report.md')}(dsh 侧栏工作台可直接预览)`)
+  } catch (e) {
+    say(`[gotry-doctor] 报告写盘失败(${e.message})——体检结论仍有效`)
+  }
+  // 降级类(凭证未配/flyai 试用)不挡 exit 0——降级有自动回退路径,缺失类才挡
+  const stillMissing = items.filter((i) => i.level === 'missing').length
+  return stillMissing === 0 ? 0 : 1
+}
+
 const EXTENSION_FILES = ['manifest.json', 'background.js', 'content-main.js', 'content-bridge.js', 'README.md']
 
 function readManifestVersion(manifestPath) {
@@ -440,12 +666,17 @@ async function runInlineHealthWatch(timeoutMs) {
 }
 
 async function main() {
-  // wizard 子命令(2026-09-02 商店上架后退化):**只走 stdout 提示 + 健康探活等待**;
-  // 不 spawn 任何 GUI 工具(不动 pbcopy / osascript / open / xdg-open / zenity),
-  // 不打开 chrome://extensions,不动扩展路径——浏览器自己当安装器,gotry 不越界。
-  // 期望用户路径:`npx gotry web` → dsh UI → 调 gotry_session_search 遇 needs-extension
-  // → dsh UI 渲商店 URL → 用户点链接 → 装好 → 同会话内自动 retry(health-watch)。
-  if (WIZARD) {
+  // calendar 子命令(issue #106/D-9):可选日历挂载的 setup 状态管理(on/off/status)
+  if (CALENDAR_CMD) process.exit(await runCalendar())
+
+  // doctor 子命令(2026-09-02 迪拜 session 复盘):可选依赖体检 + 补装指引/补装执行;
+  // 只读体检零副作用(--fix 才装),win32 也可跑体检(fix 面另有提示)。
+  if (DOCTOR) process.exit(await runDoctor())
+
+// wizard 子命令(2026-09-02 商店上架后退化):**只走 stdout 提示 + 健康探活等待**;
+// 不 spawn 任何 GUI 工具(不动 pbcopy / osascript / open / xdg-open / zenity),
+// 不打开 chrome://extensions,不动扩展路径——浏览器自己当安装器,gotry 不越界。
+if (WIZARD) {
     if (WIZARD_DRY_RUN) {
       say('[gotry-wizard] dry-run(零网络零浏览器零剪贴板;run-all §40 走这条)')
       say('  步骤: ensure-extension-files → watch-extension-ready(2 步纯 Node 端)')
@@ -467,44 +698,33 @@ async function main() {
     const watchResult = await runHealthWatch()
     if (watchResult.ready) {
       say(`[gotry-wizard] ✅ 扩展就绪(${watchResult.attempts} 次探活,等待 ${watchResult.waitedMs}ms)`)
-      say('[gotry-wizard] 现在 `npx gotry web` → dsh UI → 调 gotry_session_search 即可拿到结果。')
       process.exit(0)
     } else {
       say(`[gotry-wizard] ✗ ${watchResult.reason}——未在 ${watchResult.timeoutMs}ms 内就绪`)
-      say('[gotry-wizard] dsh UI 中 `gotry_session_search` 的 needs-extension 仍带商店链接;无需重跑,wizard 完全幂等。')
+      say('[gotry-wizard] 不需重跑;扩展未装时 dsh UI 中 gotry_session_search 的 needs-extension 会带商店链接,wizard 完全幂等。')
       process.exit(1)
     }
   }
 
   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}`)
-    say('  dsh-better-sidebar: npx -y --package @deepseek-ai/dsh dsh plugin --profile web add dsh-better-sidebar@latest')
-    say('  GoTry Session Bridge 扩展:推荐 Chrome 应用商店一键安装 https://chromewebstore.google.com/detail/gotry-session-bridge/oeajpiccmonococjcegddlooeeohlbgd ;本地通道:手动把包内 extension/ 目录拷到 %USERPROFILE%\\.gotry\\extension,再在 chrome://extensions 开发者模式「加载已解压的扩展程序」')
+    say('[gotry-setup] GoTry Session Bridge 扩展:推荐 Chrome 应用商店一键安装 https://chromewebstore.google.com/detail/gotry-session-bridge/oeajpiccmonococjcegddlooeeohlbgd ;本地通道:手动把包内 extension/ 目录拷到 %USERPROFILE%\\.gotry\\extension,再在 chrome://extensions 开发者模式「加载已解压的扩展程序」')
     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)')
+    say('[gotry-setup] CI/GOTRY_SETUP_SKIP 检测——跳过')
     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 跳过')
-  if (process.env.GOTRY_SETUP_SIDEBAR !== '0') results.push(await setupSidebar())
-  else say('[gotry-setup] dsh-better-sidebar:GOTRY_SETUP_SIDEBAR=0 跳过')
+  // gotry 自留面只剩扩展是否就位;hbcli/agent-reach/dsh-better-sidebar 由各自宿主生态自管。
   if (process.env.GOTRY_SETUP_EXTENSION !== '0') results.push(await (EXTENSION_FROM === 'github' ? setupExtensionFromGithub() : setupExtension()))
   else say('[gotry-setup] GoTry Session Bridge 扩展:GOTRY_SETUP_EXTENSION=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`)
+    say(`[gotry-setup] ${failed} 项未就绪——gotry 本体不受影响;可稍后重跑: npx gotry setup`)
     process.exit(AUTO ? 0 : 1)
   }
-  say('[gotry-setup] 全部就绪。Run: npx gotry web')
+  say('[gotry-setup] 扩展就绪检查完成。')
   process.exit(0)
 }
 

package/bin/gotry-inner.js

@@ -9,8 +9,8 @@
  *   1. 解析 argv + .env(provider-neutral → DEEPSEEK_API_KEY/DEEPSEEK_BASE_URL)
  *   2. 定位 dsh runtime:
  *      a. repo checkout / npm 安装 → root package 解析锁定的 @deepseek-ai/dsh
- *      b. 非 benchmark 且 root 缺失时 → legacy vendored node_modules fallback(不走 npx:
- *         dsh cordis-loader 在子 cwd 求值 plugin name,必须绝对路径 patch)
+ *      b. legacy vendored fallback 已按 D-27 移除(issue #120)——root 缺失即
+ *         fail-closed 报错指重装,不再有「解析成功却跑不起来」的玄学形态
  *   3. 运行时生成 patch(os.tmpdir):把 gotry-tools 插件路径重写为按本包
  *      位置解析的绝对路径 —— 仓内 cordis.gotry-patch.yml 里的 name 行只是
  *      占位(本机绝对路径),随 tarball 分发后对其他机器必错。
@@ -20,7 +20,7 @@ import { spawn, spawnSync } from 'node:child_process'
 import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
 import { fileURLToPath, pathToFileURL } from 'node:url'
 import { dirname, join } from 'node:path'
-import { tmpdir } from 'node:os'
+import { homedir, tmpdir } from 'node:os'
 import { createRequire } from 'node:module'
 import {
   benchmarkRuntimeSupported,
@@ -39,8 +39,7 @@ const rootRequire = createRequire(join(repoRoot, 'package.json'))
 // --- 环境 .env 加载(provider-neutral) ---
 // npm 安装模式优先读用户当前目录的 .env(包目录内不该有凭证);repo 检出读仓根。
 const sourceDshEarly = resolveDshPackage(rootRequire)
-const vendoredDshEarly = !sourceDshEarly && existsSync(join(repoRoot, 'ts/dsh-runtime/node_modules/@deepseek-ai/dsh/lib/bin.js'))
-const envCandidates = sourceCheckoutMode || vendoredDshEarly
+const envCandidates = sourceCheckoutMode || sourceDshEarly
   ? [join(repoRoot, '.env')]
   : [join(process.cwd(), '.env'), join(repoRoot, '.env')]
 const envLines = []
@@ -82,28 +81,37 @@ if (help) {
 
 Usage:
   gotry web                          # dsh Web UI on http://127.0.0.1:3080
-  gotry setup                        # 安装可选外部依赖(hbcli 官方脚本 / agent-reach pip;装时已自动跑过)
+  gotry setup                        # 扩展就位检查/指引(商店一键装)
+<<<<<<< HEAD
+  gotry setup calendar               # 可选日历(CalDAV 工作窗口)挂载开关:默认关;--off 关闭;--status 查看
+=======
+>>>>>>> origin/main
+  gotry doctor                       # 可选依赖体检:扩展/agent-reach/hbcli/flyai/sidebar 状态 + 补装指引
+  gotry doctor --fix                 # 体检 + 按报告补装(hbcli 官方脚本 / agent-reach pip / sidebar 插件)
   gotry "一段完整任务..."            # headless 一问一答
   gotry help                         # this help
-
-Prerequisites:
-  • Node 22.15+
-  • \`.env\` 里 LLM_API_KEY (DeepSeek / OpenAI 兼容均可;自定义端点另配 LLM_BASE_URL,一般以 /v1 结尾;指定模型另配 LLM_MODEL,同时驱动 dsh 会话面与仓内脚本)
+  gotry --version                    # 版本号(bug 报告必填项)
 
 Detail: https://github.com/Danceiny/gotry — README
 `)
   process.exit(0)
 }
 
-// mode 决定路径: 'web'/'setup'/'help' 是字面命令;否则第一段 args[0] 是任务本身的一部分
-const literal = new Set(['web', 'setup', 'help', '-h', '--help'])
+// repoRoot 在 npm 安装与源码检出两种形态下都是包根,version 统一从这里取
+if (args[0] === '-v' || args[0] === '--version') {
+  console.log(JSON.parse(readFileSync(join(repoRoot, 'package.json'), 'utf-8')).version)
+  process.exit(0)
+}
+
+// mode 决定路径: 'web'/'setup'/'doctor'/'help' 是字面命令;否则第一段 args[0] 是任务本身的一部分
+const literal = new Set(['web', 'setup', 'doctor', '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' })
+// setup/doctor:外部依赖自举与体检,不需要 dsh runtime 与 LLM key,同步分发后即退
+if (mode === 'setup' || mode === 'doctor') {
+  const r = spawnSync(process.execPath, [join(here, 'gotry-bootstrap.js'), mode, ...rest], { stdio: 'inherit' })
   process.exit(r.status ?? (r.error ? 1 : 0))
 }
 
@@ -113,8 +121,7 @@ if (!supportsNodeVersion(process.versions.node)) {
   process.exit(1)
 }
 
-// --- dsh runtime 定位:root manifest/require.resolve 优先;旧 vendored 仅作 legacy fallback ---
-const vendoredDsh = join(repoRoot, 'ts/dsh-runtime/node_modules/@deepseek-ai/dsh/lib/bin.js')
+// --- dsh runtime 定位(D-27 清偿,issue #120):仅 root manifest/依赖解析;legacy vendored 回退已移除 ---
 const installedPackageMode = !sourceCheckoutMode
 const selectedDsh = selectDshRuntime({
   repoRoot,
@@ -137,7 +144,7 @@ if (!dshBin) {
     console.error('[gotry] benchmark dsh runtime unavailable')
     process.exit(1)
   }
-  console.error(`[gotry] 找不到 dsh runtime(既无 vendored ${vendoredDsh},依赖里也没有 @deepseek-ai/dsh)。`)
+  console.error('[gotry] 找不到 dsh runtime(依赖里没有 @deepseek-ai/dsh;legacy vendored 回退已按 D-27 移除)。')
   console.error('repo checkout: npm ci && npm --prefix ts ci && node scripts/build-dist.mjs;npm 安装: npm install(检查 node_modules)。')
   process.exit(1)
 }
@@ -148,12 +155,12 @@ if (benchmarkEnvironmentConfig && !benchmarkRuntimeSupported(selectedDsh)) {
 
 // --- 运行时 patch:插件路径按本包位置重写为绝对路径 ---
 // 安装包始终指向 dist/ 纯 JS(Node 拒绝 strip node_modules 下的 .ts)。
-// repo 检出仅在 vendored runtime 或显式 tsx loader 可用时走 .ts；否则
+// repo 检出仅在显式 tsx loader 可用时走 .ts；否则
 // 使用当前 worktree 已构建的 dist，避免 Node strip-only 拒绝参数属性语法。
 const distEntry = join(repoRoot, 'dist/src/index.js')
 const tsEntry = join(repoRoot, 'ts/src/index.ts')
 const tsxLoaderActive = /(?:^|\s)--(?:import|loader)(?:=|\s)(?:"[^"]*tsx[^"]*"|'[^']*tsx[^']*'|\S*tsx\S*)/.test(process.env.NODE_OPTIONS ?? '')
-const sourceTypeScriptMode = !installedPackageMode && (dshSource === 'legacy-vendored' || tsxLoaderActive)
+const sourceTypeScriptMode = !installedPackageMode && tsxLoaderActive
 const pluginEntry = !sourceTypeScriptMode && existsSync(distEntry) ? distEntry : tsEntry
 const distModuleMode = pluginEntry === distEntry
 const staticPatch = join(repoRoot, 'cordis.gotry-patch.yml')
@@ -372,6 +379,10 @@ if (!benchmarkEnvironmentConfig) {
     // 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 = '' } }
+    if (!mapEntry) {
+      // ts/node_modules 回退(source 模式:dsh-map-tools 安装在 ts/package.json)
+      try { mapEntry = require_.resolve(join(repoRoot, 'ts/node_modules/dsh-map-tools')) } catch { mapEntry = '' }
+    }
   }
 }
 // 结构化澄清卡(T2):ask_user_question 工具 + user-questions 服务,从 dsh 包
@@ -403,8 +414,16 @@ if (mapEntry) {
   patchRaw = patchRaw.replace(/\n\s*- id: dsh-map-tools\n\s*name: 'placeholder\/dsh-map-tools'\n/, '\n')
 }
 
-// dsh-calendar 宿主插件(CalDAV 工作窗口读取;未配置时工具报错降级,不挡启动)。
-// 离线预算 E2E 显式禁用可选宿主插件，避免测试依赖真实 CalDAV 账号。
+// dsh-calendar 宿主插件(CalDAV 工作窗口读取)——D-9 拍板(issue #106):默认不挂载。
+// 未配置的日历工具是纯负资产(会话中段才撞「未配置 username」报错),gotry 对它的
+// 唯一诉求(工作窗口)由访谈首轮覆盖。挂载与否由 **setup 状态面**决定(founder
+// 2026-09-03 纠偏:禁止环境变量控制产品行为;可选依赖进 setup 状态管理,与扩展
+// manifest 同居 ~/.gotry)——`npx gotry setup calendar` 写 ~/.gotry/calendar.json,
+// `--off` 删除恢复默认;doctor 报告三态。
+let calEnabled = false
+try {
+  calEnabled = JSON.parse(readFileSync(join(homedir(), '.gotry', 'calendar.json'), 'utf-8'))?.enabled === true
+} catch { /* 缺文件/坏文件 = 默认不挂载 */ }
 let calEntry = ''
 if (!benchmarkEnvironmentConfig) {
   const vendoredCal = join(repoRoot, 'ts/dsh-runtime/node_modules/dsh-calendar/lib/index.js')
@@ -415,7 +434,7 @@ if (!benchmarkEnvironmentConfig) {
     if (!calEntry) { try { calEntry = require_.resolve('dsh-calendar') } catch { calEntry = '' } }
   }
 }
-if (calEntry && process.env.GOTRY_DISABLE_OPTIONAL_CALENDAR !== '1') {
+if (calEntry && calEnabled) {
   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')
@@ -427,9 +446,21 @@ if (calEntry && process.env.GOTRY_DISABLE_OPTIONAL_CALENDAR !== '1') {
 // 两条目标在 headless/web profile 均有(dsh-base 声明 llm-deepseek、两 profile 均声明
 // agent-default-model)。llm-deepseek 目录整体替换为单条目:显式指定模型的场景多为
 // 中转/兼容端点,默认 v4-* 目录对其是误导;不硬编码上游 DEFAULT_MODELS 防漂移。
+let llmMaxTokens
 if (process.env.GOTRY_LLM_MODEL) {
+  const rawMax = process.env.LLM_MAX_TOKENS
+  if (rawMax !== undefined && rawMax !== '') {
+    llmMaxTokens = Number.parseInt(rawMax, 10)
+    if (!Number.isSafeInteger(llmMaxTokens) || llmMaxTokens <= 0) {
+      throw new Error(`invalid LLM_MAX_TOKENS: ${JSON.stringify(rawMax)} (expected a positive safe integer)`)
+    }
+  }
   const modelYaml = `'${process.env.GOTRY_LLM_MODEL.replace(/'/g, "''")}'`
-  patchRaw += `\n# LLM_MODEL 指定模型(issue #77):dsh 会话面默认模型 + 模型目录\n- id: agent-default-model\n  config:\n    provider: deepseek-official\n    model: ${modelYaml}\n- id: llm-deepseek\n  config:\n    models:\n      - id: ${modelYaml}\n        name: ${modelYaml}\n`
+  // LLM_MAX_TOKENS(Round 9,#100/#102):中转/兼容端点模型常带低于 dsh 未知模型
+  // 默认 256K 预算的输出上限(MiniMax 2013 实测);目录条目 maxTokens 元数据是
+  // dsh-llm-deepseek defaultMaxTokens 的官方通道(web UI 模型同源)。
+  const maxTokensYaml = llmMaxTokens === undefined ? '' : `\n        maxTokens: ${llmMaxTokens}`
+  patchRaw += `\n# LLM_MODEL 指定模型(issue #77):dsh 会话面默认模型 + 模型目录\n- id: agent-default-model\n  config:\n    provider: deepseek-official\n    model: ${modelYaml}\n- id: llm-deepseek\n  config:\n    models:\n      - id: ${modelYaml}\n        name: ${modelYaml}${maxTokensYaml}\n`
 }
 // Keep the patch private and short-lived. mkdtempSync creates a 0700 directory;
 // wx prevents accidental reuse/races if a process is started concurrently.
@@ -450,20 +481,8 @@ const terminateOnSignal = (signal, listener) => {
   process.off(signal, listener)
   process.kill(process.pid, signal)
 }
-const onSigint = () => terminateOnSignal('SIGINT', onSigint)
-const onSigterm = () => terminateOnSignal('SIGTERM', onSigterm)
-process.once('SIGINT', onSigint)
-process.once('SIGTERM', onSigterm)
-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>')
-  cleanupPatch()
-  process.exit(1)
-}
-
-// --- 调 vendored dsh 二进制(不走 npx)---
-// headless: 第一个非 -- 之后的参数是 task —— gotry argv 0 是 headless 触发,其余都算 task;
+// LLM key 由 dsh 宿主管理(凭证是用户资产,UI 在 dsh 里;gotry 不拦截启动期,
+// 不在用户面前展示任何 key 配置引导),此处直接放手 spawn dsh。
 const binJs = mode === 'web'
   ? ['web', '--patch', patchPath, ...(process.argv.includes('--no-open') ? ['--no-open'] : [])]
   : ['--profile', 'headless', '--patch', patchPath, ...rest]
@@ -493,6 +512,17 @@ const childStdio = mode === 'web'
 let benchmarkCapturedBytes = 0
 let benchmarkDiagnosticBuffer = Buffer.alloc(0)
 let benchmarkOutputTruncated = false
+// 启动一次性 doctor 摘要(issue #114,design §3.1③):分离子进程后台跑只读体检,
+// 有待处理项打一行 stderr(stderr 继承,不污染 stdout;benchmark 面保持零杂音)。
+// detached+unref:不阻塞不拖慢启动;inner 生命周期天然一次,不重复刷;失败静默。
+if (!benchmarkEnvironmentConfig) {
+  try {
+    spawn(process.execPath, [join(here, 'gotry-bootstrap.js'), 'doctor', '--summary'], {
+      detached: true,
+      stdio: ['ignore', 'ignore', 'inherit'],
+    }).unref()
+  } catch { /* 体检不可用不挡启动 */ }
+}
 child = spawn(process.execPath, [dshBin, ...binJs], {
   stdio: childStdio,
   env: childEnv,

package/bin/gotry-runtime-resolution.d.ts

@@ -5,7 +5,7 @@ export type DshResolver = {
 export type DshRuntime = {
   bin: string
   version: string
-  source: 'root' | 'legacy-vendored'
+  source: 'root'
 }
 
 export const REQUIRED_BENCHMARK_DSH_VERSION: '0.1.2-alpha.3'

package/bin/gotry-runtime-resolution.js

@@ -1,4 +1,4 @@
-import { existsSync, readFileSync } from 'node:fs'
+import { readFileSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 
 export const REQUIRED_BENCHMARK_DSH_VERSION = '0.1.2-alpha.3'
@@ -29,15 +29,14 @@ export function supportsNodeVersion(version) {
   return major > 22 || (major === 22 && minor >= 15)
 }
 
-export function selectDshRuntime({ repoRoot, rootResolver, benchmark }) {
+export function selectDshRuntime({ rootResolver }) {
   const root = resolveDshPackage(rootResolver)
   if (root) return { ...root, source: 'root' }
-  if (benchmark) return null
-
-  const vendoredBin = join(repoRoot, 'ts/dsh-runtime/node_modules/@deepseek-ai/dsh/lib/bin.js')
-  if (!existsSync(vendoredBin)) return null
-  const vendored = readDshPackage(vendoredBin)
-  return vendored ? { ...vendored, source: 'legacy-vendored' } : null
+  // D-27 清偿(issue #120):legacy vendored 回退路径已移除——该形态的 Node 兼容窗口
+  // 断裂(Round 5 起「不承诺可运行」),解析成功只会把「dsh 缺失」变成下游玄学失败。
+  // 唯一受支持形态 = root manifest / 依赖解析(216 精确依赖闭包);找不到即 fail-closed,
+  // 由调用方给明确重装指引。benchmark 原本就禁用回退,语义不变(入参保留以稳调用面)。
+  return null
 }
 
 export function benchmarkRuntimeSupported(runtime) {