@danceiny/gotry 0.0.1-rc.18 → 0.0.1-rc.20

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,10 +54,11 @@
  */
 
 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'
+import { createRequire } from 'node:module'
 
 const repoRoot = join(dirname(fileURLToPath(import.meta.url)), '..')
 const AUTO = process.argv.includes('--auto')
@@ -65,9 +74,9 @@ const HBCLI_INSTALL_CMD = 'curl -fsSL https://github.com/hotelbyte-com/docs/rele
 const REACH_INSTALL_URL = 'git+https://github.com/Panniantong/Agent-Reach.git'
 
 /** 带超时的子进程(inherit stdio 让用户看见上游安装进度) */
-function run(cmd, args, { timeoutMs, cwd } = {}) {
+function run(cmd, args, { timeoutMs, cwd, env } = {}) {
   return new Promise((resolve) => {
-    const child = spawn(cmd, args, { stdio: 'inherit', cwd, env: process.env })
+    const child = spawn(cmd, args, { stdio: 'inherit', cwd, env: env ?? process.env })
     let done = false
     const timer = setTimeout(() => {
       if (!done) { done = true; try { child.kill('SIGKILL') } catch { /* ignore */ } }
@@ -135,34 +144,291 @@ async function setupReach() {
   return { ok: true }
 }
 
-async function setupSidebar() {  say('[gotry-setup] dsh-better-sidebar(dsh web 侧栏工作台,产物查看面 issue #25)')
-  const installed = existsSync(join(homedir(), '.dsh/profiles/web/node_modules/dsh-better-sidebar/package.json'))
-  if (installed) { say('  ✓ 已安装(~/.dsh/profiles/web)'); return { ok: true } }
+/** sidebar 落盘状态 = 与 doctor 检查同口径的唯一事实面(profile 里的 package.json) */
+function sidebarInstalled() {
+  return existsSync(join(homedir(), '.dsh/profiles/web/node_modules/dsh-better-sidebar/package.json'))
+}
+
+/** dsh plugin 在 profile 目录里跑 pnpm;pnpm ≥10.5 默认不执行依赖构建脚本,严格态
+ *  (pnpm 11 默认 / strict-dep-builds)下 ERR_PNPM_IGNORED_BUILDS 直接 exit 1——
+ *  但包本身已完整落盘(2026-09-08 实测:exit 1 而 167 包全部就位,doctor 复检即绿)。
+ *  对该调用降回警告态(env 只作用于这一次 spawn,不改用户全局 pnpm 配置);
+ *  老版本 pnpm 不认识此配置,零影响。 */
+const SIDEBAR_PNPM_ENV = { ...process.env, npm_config_strict_dep_builds: 'false' }
+
+async function setupSidebar(attemptInstall) {  say('[gotry-setup] dsh-better-sidebar(dsh web 侧栏工作台,产物查看面 issue #25)')
+  if (sidebarInstalled()) { say('  ✓ 已安装(~/.dsh/profiles/web)'); return { ok: true } }
   if (CHECK_ONLY) { say('  ✗ 未安装(--check-only 只报告)'); return { ok: true } }
   const SIDEBAR_PKG = 'dsh-better-sidebar@latest'
-  // dsh CLI:本包依赖里的 @deepseek-ai/dsh 优先;解析不到走 npx 自拉(官方安装途径同款)
-  const { createRequire } = await import('node:module')
+  // dsh CLI:本包依赖里的 @deepseek-ai/dsh 优先;解析不到走 npx 自拉(官方安装途径同款)。
+  // attemptInstall 注入位供测试模拟「安装器失败但状态落盘」(pnpm 忽略构建脚本策略)。
   const require_ = createRequire(join(repoRoot, 'package.json'))
-  let launched = false
+  const defaultAttempt = async () => {
+    try {
+      const dshBin = require_.resolve('@deepseek-ai/dsh/lib/bin.js')
+      say(`  安装中(dsh plugin → web profile): ${SIDEBAR_PKG}`)
+      return await run(process.execPath, [dshBin, 'plugin', '--profile', 'web', 'add', SIDEBAR_PKG], { timeoutMs: 300_000, env: SIDEBAR_PNPM_ENV })
+    } catch { return { ok: false, noDsh: true } }
+  }
+  const r = await (attemptInstall ?? defaultAttempt)()
+  if (r.ok) {
+    say('  ✓ 安装完成(gotry web 刷新浏览器即见右侧工作台;工作区里的产物 md 可直接预览)')
+    return { ok: true }
+  }
+  // exit 非 0 ≠ 没装上(pnpm 忽略构建脚本策略):先按落盘状态复核,再决定是否回退 npx 途径
+  if (sidebarInstalled()) {
+    say('  ✓ 安装完成(安装器 exit 非 0,但按落盘状态复核已就位;gotry web 刷新浏览器即见右侧工作台)')
+    say('  ⚠ pnpm 跳过了 node-pty(侧栏内嵌终端)的构建脚本——预览功能不受影响;如需内嵌终端:cd ~/.dsh/profiles/web && pnpm approve-builds 勾选 node-pty')
+    return { ok: true }
+  }
+  if (r.noDsh) say('  本包未携带 @deepseek-ai/dsh,走 npx 途径安装')
+  else say('  ✗ dsh plugin 安装失败且未落盘——尝试 npx 途径')
+  const r2 = await run('npx', ['-y', '--package', '@deepseek-ai/dsh', 'dsh', 'plugin', '--profile', 'web', 'add', SIDEBAR_PKG], { timeoutMs: 300_000, env: SIDEBAR_PNPM_ENV })
+  if (r2.ok) {
+    say('  ✓ 安装完成(gotry web 刷新浏览器即见右侧工作台)')
+    return { ok: true }
+  }
+  if (sidebarInstalled()) {
+    say('  ✓ 安装完成(npx 途径 exit 非 0,但按落盘状态复核已就位)')
+    return { ok: true }
+  }
+  say('  ✗ 安装失败——不影响 gotry:产物仍可在对话里说「看看我生成的行程」经 gotry_artifacts_list/read 查看;可稍后重试: npx gotry doctor --fix')
+  return { ok: false }
+}
+
+// ---------------------------------------------------------------------------
+// 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 dshBin = require_.resolve('@deepseek-ai/dsh/lib/bin.js')
-    say(`  安装中(dsh plugin → web profile): ${SIDEBAR_PKG}`)
-    const r = await run(process.execPath, [dshBin, 'plugin', '--profile', 'web', 'add', SIDEBAR_PKG], { timeoutMs: 300_000 })
-    launched = true
-    if (r.ok) {
-      say('  ✓ 安装完成(gotry web 刷新浏览器即见右侧工作台;工作区里的产物 md 可直接预览)')
-      return { ok: true }
+    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(状态面与 setupSidebar 的落盘复核同一口径)
+  const sbOk = sidebarInstalled()
+  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 同口径:
+  // tarball vendor 副本优先(随 files[] 分发,不进 npm 依赖——其 peerDependencies 要求
+  // dsh-settings/dsh-tools >=0.1.2-rc.1,与锁定的 0.1.2-alpha.3 家族在 npm 严格 peer
+  // 解析下 ERESOLVE,依赖形态会弄坏 npx 安装),其余覆盖 source/提升/profile 布局。
+  const rootRequire = createRequire(join(repoRoot, 'package.json'))
+  const mapCandidates = [
+    join(repoRoot, 'ts/dsh-runtime/vendor/dsh-map-tools/lib/index.js'),
+    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'),
+  ]
+  let mapHit = mapCandidates.find((p) => existsSync(p))
+  // npm 提升布局:gotry 的依赖不在包目录 node_modules 里,而在同级提升位——
+  // 与 inner 的 require_.resolve 同机制(createRequire 从包位置向上走查)
+  if (!mapHit) { try { mapHit = rootRequire.resolve('dsh-map-tools') } catch { mapHit = undefined } }
+  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: '重装 @danceiny/gotry(地图插件随包 vendor 分发,缺失多为安装不完整)' })
+  // 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'),
+  ]
+  let askHit = askCandidates.find((p) => existsSync(p))
+  // 与 inner 同口径:优先从 dsh 包上下文解析(pnpm 嵌套布局只有 dsh 看得见),再从包根上下文
+  // (npm/npx 提升布局),最后静态候选(source vendored / profile)
+  if (!askHit) {
+    try {
+      const reqFromDsh = createRequire(rootRequire.resolve('@deepseek-ai/dsh/lib/bin.js'))
+      askHit = reqFromDsh.resolve('@deepseek-ai/dsh-tool-ask-user')
+    } catch {
+      try { askHit = rootRequire.resolve('@deepseek-ai/dsh-tool-ask-user') } catch { askHit = undefined }
     }
-    say(`  ✗ dsh plugin 安装失败(${r.error})——尝试 npx 途径`)
-  } catch { /* 本包未携带 @deepseek-ai/dsh */ }
-  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')
-    return { ok: false }
   }
-  say('  ✓ 安装完成(gotry web 刷新浏览器即见右侧工作台)')
-  return { ok: true }
+  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']
@@ -440,6 +706,13 @@ async function runInlineHealthWatch(timeoutMs) {
 }
 
 async function main() {
+  // 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 不越界。
@@ -495,7 +768,13 @@ if (WIZARD) {
   process.exit(0)
 }
 
-main().catch((e) => {
-  say(`[gotry-setup] 异常:${e.message}(不影响 gotry 本体;可重试 npx gotry setup)`)
-  process.exit(AUTO ? 0 : 1)
-})
+// 直接执行才跑 main(bootstrap-tests import 本模块做 setupSidebar 单测时不触发安装面;
+// bin/gotry-inner.js 始终以 `node …/gotry-bootstrap.js` 直接 spawn,不受影响)
+if (process.argv[1] && process.argv[1].endsWith('gotry-bootstrap.js')) {
+  main().catch((e) => {
+    say(`[gotry-setup] 异常:${e.message}(不影响 gotry 本体;可重试 npx gotry setup)`)
+    process.exit(AUTO ? 0 : 1)
+  })
+}
+
+export { setupSidebar, sidebarInstalled }

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,24 +81,34 @@ if (help) {
 
 Usage:
   gotry web                          # dsh Web UI on http://127.0.0.1:3080
-  gotry setup                        # 安装可选外部依赖(hbcli 官方脚本 / agent-reach pip;装时已自动跑过)
+  gotry setup                        # 扩展就位检查/指引(商店一键装)
+  gotry setup calendar               # 可选日历(CalDAV 工作窗口)挂载开关:默认关;--off 关闭;--status 查看
+  gotry doctor                       # 可选依赖体检:扩展/agent-reach/hbcli/flyai/sidebar 状态 + 补装指引
+  gotry doctor --fix                 # 体检 + 按报告补装(hbcli 官方脚本 / agent-reach pip / sidebar 插件)
   gotry "一段完整任务..."            # headless 一问一答
   gotry help                         # this help
+  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))
 }
 
@@ -109,8 +118,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,
@@ -133,7 +141,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)
 }
@@ -144,12 +152,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')
@@ -357,17 +365,29 @@ if (benchmarkEnvironmentConfig) {
     process.exit(1)
   }
 }
-// dsh-map-tools 宿主插件(地图/路线/POI,零 key 走 OSM/OSRM):repo 用 vendored,
-// npm 用依赖解析;都找不到就整块剔除 patch 条目(缺地图不挡旅行规划)
+// dsh-map-tools 宿主插件(地图/路线/POI,零 key 走 OSM/OSRM):tarball 随包 vendor,
+// repo 工作副本走 runtime workspace 链接/依赖解析;都找不到就整块剔除 patch 条目
+// (缺地图不挡旅行规划)。不能改成 npm 依赖:其 peerDependencies 要求
+// dsh-settings/dsh-tools >=0.1.2-rc.1,与本包锁定的 0.1.2-alpha.3 家族在 npm
+// 严格 peer 解析下 ERESOLVE,会直接弄坏 npx 安装。
 let mapEntry = ''
 if (!benchmarkEnvironmentConfig) {
-  const vendoredMap = join(repoRoot, 'ts/dsh-runtime/node_modules/dsh-map-tools/lib/index.js')
+  const vendoredMap = join(repoRoot, 'ts/dsh-runtime/vendor/dsh-map-tools/lib/index.js')
+    // (随 tarball 分发;source 布局同一份文件)
+  const runtimeMap = join(repoRoot, 'ts/dsh-runtime/node_modules/dsh-map-tools/lib/index.js')
+    // (ts/dsh-runtime pnpm workspace vendor/* 链接形态)
   if (existsSync(vendoredMap)) {
     mapEntry = vendoredMap
+  } else if (existsSync(runtimeMap)) {
+    mapEntry = runtimeMap
   } 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 = '' } }
+    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 包
@@ -399,8 +419,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')
@@ -411,7 +439,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')
@@ -423,9 +451,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.
@@ -477,6 +517,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) {