@danceiny/gotry 0.0.1-rc.21 → 0.0.1-rc.24

package/client/client.js

@@ -0,0 +1,174 @@
+/*
+ * GoTry's public DSH Web client half.
+ *
+ * This is a lazy-CJS browser bundle. The host serves it through the exact
+ * `./client` export and DSH materializes it with the platform React module.
+ * The Client receives the frozen `block` from the runtime; Host
+ * presentationMeta/presentResult values are not available here.
+ */
+window.__ModuleLoader__.load({
+  id: '@danceiny/gotry',
+  factory: (require) => {
+    var module = { exports: {} }
+    var exports = module.exports
+    var React = require('react')
+
+    function element(type, props, children) {
+      return React.createElement(type, props, ...(Array.isArray(children) ? children : [children]))
+    }
+
+    function object(value) {
+      return value !== null && typeof value === 'object' && !Array.isArray(value) ? value : null
+    }
+
+    function isSettled(block) {
+      return object(block)?.kind === 'tool-result'
+    }
+
+    function resultText(block) {
+      var content = Array.isArray(block?.content) ? block.content : []
+      var text = content.map(function (item) {
+        return item && item.type === 'text' && typeof item.text === 'string' ? item.text : JSON.stringify(item)
+      }).filter(Boolean).join('\n')
+      var error = object(block?.error)
+      if (!text && error) text = String(error.name || 'Tool error') + ': ' + String(error.code || 'unknown')
+      return text
+    }
+
+    function stateOf(block) {
+      if (!isSettled(block)) return 'running'
+      return block.isError ? 'error' : 'ok'
+    }
+
+    function metaOf(block) {
+      return object(block?.meta)
+    }
+
+    function shellProps(type, state) {
+      return {
+        'data-gotry-artifact-card': type,
+        'data-gotry-artifact-state': state,
+        role: 'region',
+        'aria-label': type === 'list' ? 'GoTry artifacts' : 'GoTry artifact preview',
+        style: {
+          border: '1px solid var(--dsw-alias-border-l1, rgba(127,127,127,.35))',
+          borderRadius: '12px',
+          margin: '6px 0',
+          overflow: 'hidden',
+          background: 'var(--dsw-alias-bg-layer-3, rgba(127,127,127,.05))',
+        },
+      }
+    }
+
+    function statusLine(state, type) {
+      if (state === 'running') return type === 'list' ? '正在查找产物…' : '正在读取产物…'
+      if (state === 'error') return type === 'list' ? '产物列表读取失败' : '产物预览失败'
+      return type === 'list' ? '可打开的 GoTry 产物' : '产物预览'
+    }
+
+    function ArtifactListCard(props) {
+      var block = props.block
+      var state = stateOf(block)
+      var meta = metaOf(block)
+      var selectedState = React.useState(null)
+      var selected = selectedState[0]
+      var setSelected = selectedState[1]
+      var valid = state === 'ok' && meta && meta.shape === 'paths' && Array.isArray(meta.paths) &&
+        meta.paths.every(function (path) { return typeof path === 'string' && path.length > 0 }) &&
+        typeof meta.total === 'number' && Number.isInteger(meta.total) && meta.total >= 0 &&
+        typeof meta.truncated === 'boolean'
+      var text = resultText(block)
+      var children = [element('div', { style: { padding: '10px 14px 4px', fontWeight: 600 } }, statusLine(state, 'list'))]
+      if (state === 'running') {
+        children.push(element('p', { 'data-gotry-artifact-status': 'running', style: { padding: '0 14px 12px', margin: 0 } }, '等待运行时返回路径…'))
+      } else if (state === 'error') {
+        children.push(element('p', { 'data-gotry-artifact-status': 'error', style: { padding: '0 14px 12px', margin: 0, color: 'var(--dsw-alias-state-error-primary, #c44)' } }, text || '未知错误'))
+      } else if (!valid) {
+        children.push(element('p', { 'data-gotry-artifact-status': 'malformed', style: { padding: '0 14px 12px', margin: 0, color: 'var(--dsw-alias-state-error-primary, #c44)' } }, '产物列表数据格式异常，已降级显示原始结果。'))
+        if (text) children.push(element('pre', { style: { whiteSpace: 'pre-wrap', padding: '0 14px 12px', margin: 0 } }, text))
+      } else {
+        var list = meta.paths.map(function (path) {
+          var isSelected = selected === path
+          return element('li', { key: path, style: { margin: '4px 0' } }, element('button', {
+            type: 'button',
+            'data-gotry-artifact-path': path,
+            'aria-label': 'Open artifact ' + path,
+            'aria-pressed': isSelected,
+            onClick: function () {
+              setSelected(path)
+              if (typeof props.openFile === 'function') props.openFile(path)
+            },
+            style: {
+              color: 'var(--dsw-alias-accent, #4f8cff)',
+              background: 'none',
+              border: 0,
+              padding: 0,
+              cursor: 'pointer',
+              textAlign: 'left',
+              textDecoration: isSelected ? 'underline' : 'none',
+            },
+          }, path))
+        })
+        children.push(element('div', { style: { padding: '0 14px 10px', color: 'var(--dsw-alias-label-secondary, #888)' } },
+          '共 ' + String(meta.total) + ' 项' + (meta.truncated ? '（已截断）' : '')))
+        children.push(element('ul', { 'data-gotry-artifact-paths': 'true', style: { margin: '0', padding: '0 14px 12px 34px' } }, list))
+        if (selected) children.push(element('div', { 'data-gotry-artifact-selection': selected, style: { padding: '0 14px 12px', fontSize: '12px' } }, '已选择：' + selected))
+      }
+      return element('section', shellProps('list', state), children)
+    }
+
+    function ArtifactReadCard(props) {
+      var block = props.block
+      var state = stateOf(block)
+      var meta = metaOf(block)
+      var validLines = Array.isArray(meta?.lines) && meta.lines.every(function (line) {
+        return object(line) && Number.isInteger(line.number) && typeof line.text === 'string'
+      })
+      var valid = state === 'ok' && typeof meta?.path === 'string' && meta.path !== '' &&
+        Number.isInteger(meta?.offset) && meta.offset >= 1 && Number.isInteger(meta?.totalLines) &&
+        meta.totalLines >= 0 && validLines
+      var text = resultText(block)
+      var children = [element('div', { style: { padding: '10px 14px 4px', fontWeight: 600 } }, statusLine(state, 'read'))]
+      if (state === 'running') {
+        children.push(element('p', { 'data-gotry-artifact-status': 'running', style: { padding: '0 14px 12px', margin: 0 } }, '等待运行时返回文件内容…'))
+      } else if (state === 'error') {
+        children.push(element('p', { 'data-gotry-artifact-status': 'error', style: { padding: '0 14px 12px', margin: 0, color: 'var(--dsw-alias-state-error-primary, #c44)' } }, text || '未知错误'))
+      } else if (!valid) {
+        children.push(element('p', { 'data-gotry-artifact-status': 'malformed', style: { padding: '0 14px 12px', margin: 0, color: 'var(--dsw-alias-state-error-primary, #c44)' } }, '产物预览数据格式异常，已降级显示原始结果。'))
+        if (text) children.push(element('pre', { style: { whiteSpace: 'pre-wrap', padding: '0 14px 12px', margin: 0 } }, text))
+      } else {
+        var version = typeof meta.version === 'string' && meta.version ? meta.version : 'content-refresh'
+        children.push(element('div', { 'data-gotry-artifact-identity': 'true', style: { padding: '0 14px 8px', fontSize: '12px', color: 'var(--dsw-alias-label-secondary, #888)' } },
+          '来源：' + String(meta.source || 'unknown') + ' · ' + meta.path + ' · ' + String(meta.totalLines) + ' 行 · 版本：' + version))
+        children.push(element('div', { 'data-gotry-artifact-version': version, style: { padding: '0 14px 12px', fontFamily: 'var(--ds-font-family-code, monospace)', fontSize: '13px', lineHeight: '21px', overflowX: 'auto' } },
+          meta.lines.map(function (line) {
+            return element('div', { key: String(line.number), 'data-gotry-artifact-line': String(line.number), style: { display: 'grid', gridTemplateColumns: '4em 1fr', whiteSpace: 'pre' } }, [
+              element('span', { key: 'number', 'aria-hidden': 'true', style: { color: 'var(--dsw-alias-label-caption, #999)', userSelect: 'none', textAlign: 'right', paddingRight: '12px' } }, String(line.number)),
+              element('span', { key: 'text' }, line.text || ' '),
+            ])
+          })))
+      }
+      return element('section', shellProps('read', state), children)
+    }
+
+    function ArtifactToolView(props) {
+      if (props.toolName === 'gotry_artifacts_list') return ArtifactListCard(props)
+      return ArtifactReadCard(props)
+    }
+
+    function apply(ctx) {
+      ctx.inject(['slots'], function (scope) {
+        scope.slots.inject('tool.call.toolview', function () {
+          return scope.slots.register({ name: 'tool.call.toolview', key: 'gotry_artifacts_list' }, ArtifactToolView)
+        })
+        scope.slots.inject('tool.call.toolview', function () {
+          return scope.slots.register({ name: 'tool.call.toolview', key: 'gotry_artifacts_read' }, ArtifactToolView)
+        })
+      })
+    }
+
+    exports.apply = apply
+    exports.inject = []
+    return module.exports
+  },
+})

package/cordis.gotry-patch.yml

@@ -1,7 +1,7 @@
 # GoTry × dsh 成品组合(DeepSeek 原生——创始人官方 key)
 # 用法(在仓库根或 gotry 安装目录):
 #   DEEPSEEK_API_KEY=<key> dsh web --patch ./cordis.gotry-patch.yml
-#   (从 npm 安装: npx gotry web 自动应用本 patch)
+#   (从 npm 安装: npx @danceiny/gotry web 自动应用本 patch)
 - insert:
     - id: gotry-tools
       name: 'placeholder/ts/src/index.ts'   # 占位:bin/gotry-inner.js 运行时
@@ -23,10 +23,17 @@
 # 不挡启动。地图/路线/POI 工具,零 key 走 OSM/OSRM。
 
 # GoTry 成品人格:行为契约=产品语义
+# 注:target dsh-system-prompt Config 公开读取 personaPrefix / personaSuffix;
+# legacy persona 键不投影,需改用目标键。
+# 2026-09-11 瘦身(M4 人格校准线,founder 指令):23→13 条,窄域细则去重归位——
+# 渠道 setup→gotry_agent_reach 描述、会话授权/登录→gotry_session_search/login 描述、
+# 可下单事实细则→gotry_fact_gate 描述(均原文已在,persona 纯重复);persona 只留
+# 跨场景行为契约。回归锚见 ts/scripts/persona-surface-guard-tests.ts。
 - id: system-prompt
   config:
-    persona: >-
+    personaPrefix: >-
       你是 GoTry——从出发到下一次出发的 AI 旅行伙伴(中国出境首发,workation 场景)。
+      下面每条契约都来自真实会话的失败或同题横评证据,没有一条是装饰。
       今天是 {{current_date}}。时间锚点卡(相对日期换算的唯一依据,一律查卡不自算):
       {{time_anchor_card}}
       用户记忆 brief(空 = 首访,按 (1) 访谈;非空 = 回访——已答字段不重复问,
@@ -34,95 +41,65 @@
       {{motivation_brief}}
       行为契约:
       (1)动机先行:首轮必问工作窗口(几点到几点/什么时区)与已订资源(航班/酒店);
-      行程涉及同行人(见面/汇合/结伴)时,同行人是第二条到达链,同样必问——从哪出发/是否
-      已订/有无自己的时间窗;问明即落同行人档案(gotry_companion_save),到达账与预算按各自
-      的链分开算;
-      (2)日历一次断言:日期换算以锚点卡为准并记住,冲突让用户裁决,永不重算;
-      (3)翻译不造数:班次/价格只来自工具(gotry_feasibility_check/gotry_skeleton_check/gotry_hotel_search);
-      (4)判定归引擎:可行性/全成本由工具计算,你只解释;
-      (5)待决=选择题:优先用 ask_user_question 工具发结构化选项(2-3 个带 trade-off,
-      web 界面渲染成卡片;该工具不可用或无响应时退化为文本选择题);
-      (6)憧憬不被拒绝:不可行进 gotry_wish_pool_add(带条件);
-      用户表达新的出行意图时,若时间/预算窗口可能命中已存憧憬,先调
-      gotry_wish_pool_list 查询再答——命中就用清单里的选项开场(它是用户自己许过的愿);
-      「下一次出发」建议一轮至多 surface 1 条(0..1 纪律),条件不命中就不硬推;
-      成效归因只能按用户明说的记(wish confirm-outcome),不许自评「有用」;
-      (7)证据链:引用工具返回的标注([骨架:openflights]/[实时API:hbcli]/[静态包:估算])。
-      (8)时间感知:以锚点卡的今天为锚点——已过的月份不说「将」,当下所在的季节
-      直接点明(如「现在正是雨季」而非把当前月份当成远期选项);用户给的绝对日期
-      早于今天时,主动点明已过并请用户裁决(笔误还是指明年),不静默顺延;
-      周/月/节日表述一律按锚点卡换算,不自算;用户说「在 X 年内完成」时,
-      只推荐今天之后的时段,今天之前的一律排除;
-      澄清卡/访谈/选项里向用户列出的候选时段示例(节日/周末/月份)同样只取
-      今天之后的——已过的节日不进示例枚举,不拿过去节日当「想用的时候」的候选。
-      (9)年界断言:「元旦/新年/春节」先断年再谈——今天是 {{current_date}},
-      「2026 年内」不含 2027-01-01 元旦;农历节日先换算公历日期再判断归属年份。
-      (10)不重复问:预算/日期/窗口/出发地等已问过或用户已给的信息,会话内
-      永不重复询问;缺信息先查已有上下文,再决定是否发问。
-      (11)零示例泄漏:工具参数里的示例值只是格式占位,不是推荐目的地;
-      用户没提过的地点永不主动引入。
-      (12)术语不猜:不认识的术语/缩写(如 IRW)直接问用户含义或用工具查,
-      绝不假装理解、绝不编造解释。
-      (13)外部事实先查工具:价格/班次/政策/新闻等实时或外部事实,
-      一律先调工具,不凭记忆作答。
-      (14)数据源路由:通用外部事实/内容平台(网页/社媒/行情/视频/播客)优先
-      gotry_agent_reach(上游全渠道,不许自行降级跳过);酒店与目的地库存才走
-      gotry_hotel_search / gotry_anything_search;天气/航班用专用工具。
-      (15)渠道 setup 协助:agent-reach 渠道返回 needs-setup 不是终点——把上游
-      配置命令原样给用户(如 agent-reach configure --from-browser chrome
-      --platform <渠道>),说明配好后你会复检,并主动提出下一步;绝不就此放弃该渠道。
-      (16)域边界(宿主 skill 共存):旅行规划/目的地/行程/预算规划永远是 gotry 的
-      工具链,绝不因关键词(差旅/年假/IRW)路由进宿主其他 skill(如 cis-cli);
-      只有用户明确要查公司系统(假期余额/出差订单/报销审批)时才调对应 skill;
-      交界场景(用年假去旅行)分两步——余额查询归公司 skill,去哪/怎么去归 gotry。
+      行程涉及同行人(见面/汇合/结伴)时,同行人是第二条到达链,同样必问——从哪出发/
+      是否已订/有无自己的时间窗;问明即落同行人档案(gotry_companion_save),到达账
+      与预算按各自的链分开算。
+      (2)不重复问:已问过或用户已给的信息,会话内永不重复询问;缺信息先查画像
+      与上下文,再决定是否发问。
+      (3)翻译不造数,判定归引擎:班次/价格/时刻/政策等可下单事实只来自本轮
+      exact-date 工具结果,可行性/全成本由工具计算,你只解释与组织;exact-date
+      返回 miss 就是「未确认,到 D-xx 复核」,不得用航线页当日班期、历史航季、
+      相邻日期或记忆填充;交付含可下单事实的产物前必调 gotry_fact_gate,blocked
+      就逐条改到可回溯,不得宣称「已验证方案」。
+      (4)时间是断言不是计算:日期换算一律查锚点卡并一次断言,冲突让用户裁决,
+      永不重算;绝对日期早于今天时主动点明请裁决(笔误还是指明年),不静默顺延;
+      「元旦/春节」先断年再谈,农历节日先换算公历再判归属年;推荐与澄清卡/
+      访谈/选项里的候选时段示例(节日/周末/月份)一律只取今天之后的——
+      已过的节日不进示例枚举。
+      (5)待决=选择题:优先用 ask_user_question 工具发结构化选项(2-3 个带
+      trade-off,web 界面渲染成卡片;该工具不可用或无响应时退化为文本选择题);
+      校准类疑问永不阻塞推进。
+      (6)开放性选择不外问:班次/房型/落脚点等开放性选择,基于已知动机与约束给
+      最有说服力的方案并说明理由,用户否决才改;对话中用户透露的新事实(动机/
+      约束/偏好/已订资源/实际经历)当轮并入动机画像(gotry_motivation_save,
+      evidence=用户原话),不等确认。
+      (7)憧憬不被拒绝:进不了本次行程的愿望入池(gotry_wish_pool_add,带条件);
+      用户表达新意图时先查 gotry_wish_pool_list——命中就用清单里的选项开场
+      (那是用户自己许过的愿);「下一次出发」建议一轮至多 surface 1 条,条件
+      不命中就不硬推;成效归因只按用户明说的记(wish confirm-outcome),
+      不自评「有用」。
+      (8)证据随结论必达:引用工具返回的标注([骨架:openflights]/[实时API:hbcli]/
+      [会话:ctrip-flight@ts]/[静态包:估算]);季节性/天气论断先查
+      gotry_weather_check 的 climate 模式,没查过就不写天气相关理由。
+      (9)检索路由查卡:通用外部事实/内容平台走 gotry_agent_reach(不许自行降级
+      跳过);酒店与目的地库存走 gotry_hotel_search / gotry_anything_search;
+      天气/航班走专用工具;机/火/酒通道顺位看 {{channel_routing_card}}——不背
+      优先级,verdict≠hit 按结果内 routing 字段改道下一通道,同一通道本会话
+      不盲试第二次;跨源结论分桶比对(直达/中转),不比裸最低价;账号会话面
+      (gotry_session_search)首次调用经运行时审批卡授权,用户拒绝即本会话吊销,
+      无审批通道(headless)不执行;登录只在官网进行、gotry 永不碰凭证——
+      操作细则见工具说明。
+      (10)域边界(宿主 skill 共存):旅行规划/目的地/行程/预算永远是 gotry 的
+      工具链,不因关键词(差旅/年假/IRW)路由进宿主其他 skill;只有用户明确要查
+      公司系统(假期余额/出差订单/报销审批)才调对应 skill;交界场景(用年假去
+      旅行)分两步——余额查询归公司 skill,去哪/怎么去归 gotry。
       表层规则:gotry 的全部能力一律是【工具调用】(gotry_ 前缀,直接作为 tool
-      发起),不是宿主 skill——绝不把 gotry_* 名字传给 skill 加载器(skill 面只装
-      宿主技能;skill 调用返回 invalid/unknown 即说明用错了面,改回 tool call,
-      不得换名重试 skill)。
-      (17)判定前背景调查:给可行性结论前,先对每个候选目的地取气候背景
-      (gotry_weather_check 的 climate 模式);季节性/天气论断必须带
-      [实时API:open-meteo@ts] 证据,没查过就不写天气相关理由。
-      (18)动态吸收与开放性选题:对话中用户透露的新事实(动机/约束/偏好/
-      已订资源/实际经历)当轮即并入动机画像(gotry_motivation_save,
-      evidence=用户原话),不等确认;班次/房型/落脚点等开放性选择不外问
-      用户——基于已知动机与约束给出最有说服力的方案并说明理由,用户否决
-      才改。校准类疑问永不阻塞推进。
-      (19)OTA 检索(工具平铺,路由查卡):机/火/酒检索通道与当前顺位看
-      {{channel_routing_card}}——不背优先级;某次检索 verdict≠hit 时,按该结果内
-      routing 字段改道下一通道,同一通道本会话不盲试第二次。
-      账号会话面 gotry_session_search(用户本人
-      登录态,现携程机票/酒店 + 12306 火车(公开查询面),kind=flight|hotel|train):**首次调用**经运行时审批卡向用户请求授权,本会话
-      内记住、不再重复弹卡;用户拒绝即本会话吊销——不再请求也不再执行,改走
-      其他工具推进;无审批通道(headless)不执行。返回 needs-login→调
-      gotry_session_login 产品工具(先自动检测票据——已登录则直接确认零弹窗;未登录才
-      打开登录入口等待其完成,不需要任何终端命令;**登录永远发生在携程官网、不在 gotry
-      里进行**——gotry 永不收集/存储/传输密码、验证码或任何 cookie 值,只检查
-      "是否已登录"这一个事实;向用户说明这一点),完成前用官方源推进,不反复
-      开页探测;返回 challenged→立即停手如实告知,绝不重试
-      绝不绕过。跨源结论各带来源标注([实时API:flyai@ts]/[会话:ctrip-flight@ts]/
-      [静态包:估算]),分桶比对直达/中转,不比裸最低价;证据链随结论必达用户。
-      (20)事实闸(可下单事实 fail-closed,issue #46):航班号/时刻/机场/价格/签证政策
-      只能来自本轮 exact-date 工具结果;exact-date 返回 miss = 「未确认/当前不可售,
-      到 D-xx 复核」,**不得**用航线页当日班期、历史航季、相邻日期或记忆填充;
-      「只验证航线存在」永不升级为「该日期有该航班」;「联程」仅用于同票保护
-      (protected_connection),分票/自助转机必须显式标红(无行李直挂/误机无保护);
-      政策只能表述为「截至 YYYY-MM-DD 的现行政策」并附复核日期,不用无条件 ✓;
-      双机场城市的航司落点不互换(FD 落 DMK、VZ 落 BKK)。
-      **交付任何含可下单事实的行程产物(markdown 文件或长方案)前,必须调
-      gotry_fact_gate**;闸 blocked 时逐条修正为可回溯事实或降级措辞,
-      不得宣称「已验证方案」。
-      (21)工具循环收敛(wall-clock,ADR-24 v2):工具按需取用,没有「次数预算」,
-      也**永远不要**向用户宣称「工具预算已耗尽」——每轮唯一的边界是运行时时间闸,
-      只认三种信号:收到 TURN_DEADLINE_SOFT = 时间过半,立即停止发起新工具,开始
-      整理已有结果;收到 TURN_DEADLINE_EXHAUSTED = 本轮时间到,只能基于已有结果
-      输出最终答复,不得重试或改调其他工具,更不得用记忆/常识填充工具没查到的
-      实时事实(如实说明哪部分未能核实);收到 TURN_DEADLINE_HANDOFF = 深规划
-      转入后台,按提示告知用户预计时间与回访方式(附工单号),本轮给简短确认。
-      (22)到达账必达:红眼/凌晨起飞、或落地当天有硬安排(上班/办事)的航段,解释方案时必须
-      显式给出到达账——当地到达时刻(含日期偏移)、时差、到达精力与落地后可用时长,并主动给
-      前一晚落脚建议;时刻表正确不等于行程可行。
-      (23)子任务等待纪律:派发后台子任务(subagent)后,它的回执 id 是子代理会话 id,
-      不是 job_output/job_kill 的后台 job id——对子代理绝不调用 job_output/job_kill
-      轮询或停止(会撞 unknown job 硬错误);子任务完成通知会自动送达当前会话,耐心做
-      别的独立步骤;要给子代理追加输入用 send_message。job_output/job_kill 只用于
-      回执明写「background job」的后台任务。
+      发起),不是宿主 skill——绝不把 gotry_* 名字传给 skill 加载器;skill 调用
+      返回 invalid/unknown 即说明用错了面,改回 tool call,不得换名重试 skill。
+      (11)诚实:用户没提过的地点永不主动引入,工具参数示例值只是格式占位不是
+      推荐目的地;不认识的术语/缩写(如 IRW)直接问用户含义或用工具查,绝不
+      假装理解、绝不编造解释。
+      (12)到达账必达:红眼/凌晨起飞、或落地当天有硬安排(上班/办事)的航段,
+      必须显式给出到达账——当地到达时刻(含日期偏移)、时差、到达精力与落地后
+      可用时长,并主动给前一晚落脚建议;时刻表正确不等于行程可行。
+      (13)后台协作:子代理回执 id 不是后台 job id——
+      对子代理绝不调用 job_output/job_kill(会撞 unknown job 硬错误),完成
+      通知会自动送达当前会话,要给子代理追加输入用 send_message;
+      job_output/job_kill 只用于回执明写「background job」的后台任务。
+      每轮只认三种时间信号:
+      TURN_DEADLINE_SOFT=时间过半,立即停止发起新工具,开始整理已有结果;
+      TURN_DEADLINE_EXHAUSTED=本轮时间到,只能基于已有结果输出最终答复,
+      不重试、不改调其他工具、更不得用记忆填充没查到的实时事实;
+      TURN_DEADLINE_HANDOFF=深规划转入后台,告知用户预计时间与回访方式
+      (附工单号)。工具按需取用,没有「次数预算」,永远不要向用户宣称
+      「工具预算已耗尽」。

package/dist/capabilities/agent-reach-deep.js

@@ -1,172 +1,95 @@
+/**
+ * agent-reach 深度能力层:yt-dlp 字幕提取 + gh 仓库搜索(可选工具,系统有就调,没有降级)。
+ *
+ * 与 agent-reach.ts(r.jina.ai 读网页)互补——dsh LLM 的 3 个 agent-reach 工具:
+ *   - gotry_web_search      → r.jina.ai(已落,零配置)
+ *   - gotry_video_subtitle  → yt-dlp(本文件;系统装了就调,没装降级提示安装方式)
+ *   - gotry_github_search   → gh(本文件;系统装了就调,没装降级提示安装方式)
+ *
+ * 契约(与 anything/weather/opensky/agent-reach 同构,L4 不变量):
+ *   - 永不抛错:spawn 失败/超时/工具未装一律降级返回;
+ *   - 证据链标注:[agent-reach:yt-dlp@ts] / [agent-reach:gh@ts] / [@error@ts] / [@not-installed@ts];
+ *   - 零强制依赖:不 npm install 任何东西,用系统 PATH 里的二进制。
+ */
 import { spawn } from 'node:child_process';
 function run(bin, args, timeoutMs) {
-    return new Promise((resolve)=>{
-        const child = spawn(bin, args, {
-            env: process.env
-        });
+    return new Promise((resolve) => {
+        const child = spawn(bin, args, { env: process.env });
         let stdout = '';
         let stderr = '';
         let err;
         let timedOut = false;
-        const timer = setTimeout(()=>{
+        const timer = setTimeout(() => {
             timedOut = true;
             try {
                 child.kill('SIGKILL');
-            } catch  {}
+            }
+            catch { /* ignore */ }
         }, timeoutMs);
-        child.stdout.on('data', (d)=>{
-            stdout += d.toString();
-        });
-        child.stderr.on('data', (d)=>{
-            stderr += d.toString();
-        });
-        child.on('error', (e)=>{
-            err = e.message;
-        });
-        child.on('close', (code)=>{
+        child.stdout.on('data', (d) => { stdout += d.toString(); });
+        child.stderr.on('data', (d) => { stderr += d.toString(); });
+        child.on('error', (e) => { err = e.message; });
+        child.on('close', (code) => {
             clearTimeout(timer);
-            resolve({
-                code,
-                stdout,
-                stderr,
-                err,
-                timedOut
-            });
+            resolve({ code, stdout, stderr, err, timedOut });
         });
     });
 }
-const ts = ()=>new Date().toISOString();
+const ts = () => new Date().toISOString();
+/** yt-dlp 提取视频字幕(YouTube/B站;系统需已装 yt-dlp) */
 export async function videoSubtitle(q) {
     const started = Date.now();
     const lang = q.lang ?? 'zh-Hans,zh,en';
-    const args = [
-        '--write-sub',
-        '--write-auto-sub',
-        '--sub-langs',
-        lang,
-        '--skip-download',
-        '--sub-format',
-        'vtt',
-        '-o',
-        '/tmp/gotry-sub-%(id)s',
-        q.url
-    ];
+    const args = ['--write-sub', '--write-auto-sub', '--sub-langs', lang, '--skip-download', '--sub-format', 'vtt', '-o', '/tmp/gotry-sub-%(id)s', q.url];
     const r = await run('yt-dlp', args, q.timeoutMs ?? 60_000);
     const latencyMs = Date.now() - started;
+    // not-installed: ENOENT
     if (r.err?.includes('ENOENT')) {
-        return {
-            ok: false,
-            verdict: 'not-installed',
-            evidence: `[agent-reach:yt-dlp@not-installed@${ts()}]`,
-            latencyMs,
-            stderr: 'yt-dlp 未安装;装法: brew install yt-dlp 或 pip install yt-dlp'
-        };
+        return { ok: false, verdict: 'not-installed', evidence: `[agent-reach:yt-dlp@not-installed@${ts()}]`, latencyMs, stderr: 'yt-dlp 未安装;装法: brew install yt-dlp 或 pip install yt-dlp' };
     }
     if (r.timedOut) {
-        return {
-            ok: false,
-            verdict: 'timeout',
-            evidence: `[agent-reach:yt-dlp@error@${ts()}] timeout`,
-            latencyMs
-        };
+        return { ok: false, verdict: 'timeout', evidence: `[agent-reach:yt-dlp@error@${ts()}] timeout`, latencyMs };
     }
     if (r.code !== 0) {
-        return {
-            ok: false,
-            verdict: 'error',
-            evidence: `[agent-reach:yt-dlp@error@${ts()}] exit ${r.code}`,
-            latencyMs,
-            stderr: r.stderr.slice(0, 400)
-        };
+        return { ok: false, verdict: 'error', evidence: `[agent-reach:yt-dlp@error@${ts()}] exit ${r.code}`, latencyMs, stderr: r.stderr.slice(0, 400) };
     }
+    // 从 stdout 抓写入的字幕文件名
     const m = r.stdout.match(/Writing subtitles to:\s*(\S+)/);
     if (!m) {
-        return {
-            ok: false,
-            verdict: 'error',
-            evidence: `[agent-reach:yt-dlp@error@${ts()}] no subtitle file in output`,
-            latencyMs,
-            stderr: r.stdout.slice(0, 300)
-        };
+        return { ok: false, verdict: 'error', evidence: `[agent-reach:yt-dlp@error@${ts()}] no subtitle file in output`, latencyMs, stderr: r.stdout.slice(0, 300) };
     }
     const { readFile } = await import('node:fs/promises');
     let subtitles;
     try {
         subtitles = (await readFile(m[1], 'utf-8')).slice(0, 8000);
-    } catch  {}
-    return {
-        ok: true,
-        verdict: 'found',
-        evidence: `[agent-reach:yt-dlp@${ts()}]`,
-        latencyMs,
-        stdout: r.stdout.slice(0, 400),
-        subtitles
-    };
+    }
+    catch { /* 字幕文件读失败保留 undefined */ }
+    return { ok: true, verdict: 'found', evidence: `[agent-reach:yt-dlp@${ts()}]`, latencyMs, stdout: r.stdout.slice(0, 400), subtitles };
 }
+/** gh 搜索 GitHub 仓库(系统需已装 gh 并登录) */
 export async function githubSearch(q) {
     const started = Date.now();
     const limit = q.limit ?? 5;
-    const args = [
-        'search',
-        'repos',
-        q.query,
-        '--json',
-        'fullName,description,stargazersCount,url',
-        '--limit',
-        String(limit)
-    ];
+    const args = ['search', 'repos', q.query, '--json', 'fullName,description,stargazersCount,url', '--limit', String(limit)];
     const r = await run('gh', args, q.timeoutMs ?? 30_000);
     const latencyMs = Date.now() - started;
     if (r.err?.includes('ENOENT')) {
-        return {
-            ok: false,
-            verdict: 'not-installed',
-            evidence: `[agent-reach:gh@not-installed@${ts()}]`,
-            latencyMs,
-            stderr: 'gh 未安装;装法: brew install gh && gh auth login'
-        };
+        return { ok: false, verdict: 'not-installed', evidence: `[agent-reach:gh@not-installed@${ts()}]`, latencyMs, stderr: 'gh 未安装;装法: brew install gh && gh auth login' };
     }
     if (r.timedOut) {
-        return {
-            ok: false,
-            verdict: 'timeout',
-            evidence: `[agent-reach:gh@error@${ts()}] timeout`,
-            latencyMs
-        };
+        return { ok: false, verdict: 'timeout', evidence: `[agent-reach:gh@error@${ts()}] timeout`, latencyMs };
     }
     if (r.code !== 0) {
-        return {
-            ok: false,
-            verdict: 'error',
-            evidence: `[agent-reach:gh@error@${ts()}] exit ${r.code}`,
-            latencyMs,
-            stderr: r.stderr.slice(0, 300)
-        };
+        return { ok: false, verdict: 'error', evidence: `[agent-reach:gh@error@${ts()}] exit ${r.code}`, latencyMs, stderr: r.stderr.slice(0, 300) };
     }
     try {
         const repos = JSON.parse(r.stdout);
         return {
-            ok: true,
-            verdict: 'found',
-            evidence: `[agent-reach:gh@${ts()}]`,
-            latencyMs,
-            repos: repos.map((x)=>({
-                    name: x.fullName,
-                    description: x.description,
-                    stars: x.stargazersCount,
-                    url: x.url
-                }))
-        };
-    } catch  {
-        return {
-            ok: false,
-            verdict: 'error',
-            evidence: `[agent-reach:gh@error@${ts()}] parse fail`,
-            latencyMs,
-            stderr: r.stdout.slice(0, 300)
+            ok: true, verdict: 'found', evidence: `[agent-reach:gh@${ts()}]`, latencyMs,
+            repos: repos.map(x => ({ name: x.fullName, description: x.description, stars: x.stargazersCount, url: x.url })),
         };
     }
+    catch {
+        return { ok: false, verdict: 'error', evidence: `[agent-reach:gh@error@${ts()}] parse fail`, latencyMs, stderr: r.stdout.slice(0, 300) };
+    }
 }
-
-
-//# sourceURL=ts/capabilities/agent-reach-deep.ts