@danceiny/gotry 0.2.0-rc.29 → 0.2.0-rc.31

package/client/client.js

@@ -12,6 +12,174 @@ window.__ModuleLoader__.load({
     var module = { exports: {} }
     var exports = module.exports
     var React = require('react')
+    var UI = require('@deepseek-ai/dsh-client-ui-primitives')
+
+    var webLocale = {
+      en: {
+        title: 'GoTry', description: 'Travel data sources and saved itineraries', flyai: 'FlyAI',
+        loading: 'Loading…', unavailable: 'Configuration is unavailable. Retry to read its current state.',
+        readOnly: 'The current key comes from the launch environment, or this platform cannot safely store it here.',
+        key: 'API Key', keyHint: 'Paste the key from the FlyAI console. It never enters the conversation.',
+        configured: 'A key is configured', anonymous: 'Anonymous trial · shared quota', verified: 'Current configuration verified',
+        unverified: 'Configured · verification required', debug: 'Debug endpoint', console: 'Open FlyAI console',
+        save: 'Verify and save', saving: 'Verifying…', saveFailed: 'The new key was not saved; the previous configuration is retained.',
+        saved: 'Verified and saved.', clear: 'Clear local key', cleared: 'Local key cleared. Anonymous trial is now active.',
+        retry: 'Refresh status', source: 'Source', config: 'Local configuration', env: 'Environment variable',
+        'env-debug': 'Debug environment variable', none: 'Shared trial',
+        artifacts: 'GoTry artifacts', artifactsHint: 'Browse saved itineraries and planning deliveries',
+        search: 'Search artifacts', searchPlaceholder: 'Title or filename', refresh: 'Refresh',
+        empty: 'No saved artifacts in this workspace.', noMatches: 'No matching artifacts.', noSession: 'Open a conversation to browse its workspace.',
+        previous: 'Previous', next: 'Next', html: 'Open HTML preview', open: 'Open preview',
+        htmlHint: 'HTML previews may run the document’s scripts.', failed: 'Could not read the current state. Please retry.',
+      },
+      zh: {
+        title: 'GoTry', description: '旅行数据源与已保存行程', flyai: 'FlyAI（飞猪）',
+        loading: '正在读取…', unavailable: '配置暂时不可用，请重新读取当前状态。',
+        readOnly: '当前 Key 来自启动环境变量，或此平台无法在这里安全保存。',
+        key: 'API Key', keyHint: '粘贴飞猪控制台中的 Key，凭据不会进入对话。',
+        configured: '已配置 Key', anonymous: '匿名试用 · 共享额度', verified: '当前配置已验证',
+        unverified: '已配置 · 尚未验证通过', debug: '调试服务地址', console: '打开飞猪控制台',
+        save: '验证并保存', saving: '正在验证…', saveFailed: '新 Key 未保存，旧配置已保留。',
+        saved: '验证通过，已保存。', clear: '清除本机 Key', cleared: '本机 Key 已清除，已恢复匿名试用。',
+        retry: '重新读取状态', source: '来源', config: '本机配置', env: '环境变量',
+        'env-debug': '调试环境变量', none: '共享试用',
+        artifacts: 'GoTry 产物', artifactsHint: '查看已保存行程和规划交付物',
+        search: '搜索产物', searchPlaceholder: '标题或文件名', refresh: '刷新',
+        empty: '这个工作区尚无已保存产物。', noMatches: '没有匹配的产物。', noSession: '打开一个对话后即可查看其工作区产物。',
+        previous: '上一页', next: '下一页', html: '打开 HTML 预览', open: '打开预览',
+        htmlHint: 'HTML 预览可能运行文档中的脚本。', failed: '无法读取当前状态，请重试。',
+      },
+    }
+
+    async function webRequest(path, options) {
+      var response = await fetch('api/gotry/' + path, Object.assign({ credentials: 'same-origin' }, options))
+      var value = await response.json()
+      if (!value || typeof value !== 'object') throw new Error('Invalid Web response')
+      if (!response.ok || value.ok === false) throw new Error(value.error || 'Request failed')
+      return value
+    }
+
+    function FlyaiSettings(props) {
+      var t = props.t
+      var state = React.useState(null), status = state[0], setStatus = state[1]
+      var draft = React.useState(''), key = draft[0], setKey = draft[1]
+      var noticeState = React.useState(''), notice = noticeState[0], setNotice = noticeState[1]
+      var errorState = React.useState(''), error = errorState[0], setError = errorState[1]
+      var busyState = React.useState(false), busy = busyState[0], setBusy = busyState[1]
+      var reloadState = React.useState(0), reload = reloadState[0], setReload = reloadState[1]
+      var lifetime = React.useRef(null), activeRequest = React.useRef(false)
+      React.useEffect(function () {
+        var controller = new AbortController()
+        lifetime.current = controller
+        setError('')
+        webRequest('flyai', { signal: controller.signal }).then(function (value) {
+          if (!controller.signal.aborted) setStatus(value)
+        }).catch(function () { if (!controller.signal.aborted) setError(t('failed')) })
+        return function () { controller.abort(); lifetime.current = null }
+      }, [reload])
+      async function write(action) {
+        if (activeRequest.current || !lifetime.current || !status?.writable) return
+        var controller = lifetime.current
+        activeRequest.current = true
+        setBusy(true); setError(''); setNotice('')
+        var candidate = key
+        setKey('')
+        try {
+          var value = await webRequest('flyai/write', { method: 'POST', signal: controller.signal,
+            headers: { 'content-type': 'application/json' }, body: JSON.stringify(action === 'save' ? { action: action, key: candidate } : { action: action }) })
+          if (!controller.signal.aborted) { setStatus(value); setNotice(t(action === 'save' ? 'saved' : 'cleared')) }
+        } catch (failure) {
+          if (!controller.signal.aborted) setError(failure.message || t('saveFailed'))
+        } finally {
+          activeRequest.current = false
+          if (!controller.signal.aborted) setBusy(false)
+        }
+      }
+      if (props.view === 'summary') return t('description')
+      var disabled = busy || !status?.writable
+      var stateLabel = !status ? t('loading') : !status.configured ? t('anonymous') : status.verified ? t('verified') : t('unverified')
+      return element('section', { 'data-gotry-flyai-settings': '', style: { display: 'grid', gap: '16px', maxWidth: '640px' } }, [
+        element('h3', { key: 'heading', style: { margin: 0 } }, t('flyai')),
+        element('div', { key: 'status', role: 'status', 'data-gotry-flyai-status': '', style: { display: 'grid', gap: '6px' } }, [
+          element(UI.Tag, { key: 'badge', tone: status?.verified ? 'success' : 'neutral' }, stateLabel),
+          status ? element('span', { key: 'source', style: { fontSize: '12px', color: 'var(--dsw-alias-label-tertiary)' } }, t('source') + '：' + t(status.source)) : null,
+          status?.endpointDebug ? element('span', { key: 'debug' }, t('debug') + '：' + status.endpoint) : null,
+        ]),
+        element('a', { key: 'console', href: 'https://flyai.open.fliggy.com/console', target: '_blank', rel: 'noopener noreferrer' }, t('console')),
+        element(UI.SettingsForm, { key: 'form', labels: { unavailable: t('loading'), readOnly: t('readOnly'), saveFailed: t('saveFailed'), save: t('save'), saving: t('saving') },
+          state: { available: Boolean(status), writable: Boolean(status?.writable), dirty: key.trim().length > 0, invalid: false, saving: busy, failed: false },
+          onSave: function () { void write('save') }, onDiscard: function () { setKey('') } }, [
+          element(UI.SettingsSecretField, { key: 'key', id: 'gotry-flyai-key', label: t('key'), hint: t('keyHint'), text: key,
+            configured: Boolean(status?.configured), stateLabel: t(status?.configured ? 'configured' : 'anonymous'), disabled: disabled,
+            onEdit: function (value) { setKey(value); setError(''); setNotice('') } }),
+        ]),
+        error ? element('p', { key: 'error', role: 'alert', style: { margin: 0, color: 'var(--dsw-alias-state-error-primary)' } }, error) : null,
+        notice ? element('p', { key: 'notice', role: 'status', style: { margin: 0 } }, notice) : null,
+        element('div', { key: 'actions', style: { display: 'flex', gap: '8px', flexWrap: 'wrap' } }, [
+          element(UI.Button, { key: 'retry', type: 'button', variant: 'outline', disabled: busy,
+            onClick: function () { setReload(function (value) { return value + 1 }) } }, t('retry')),
+          status?.configured && status.writable ? element(UI.Button, { key: 'clear', type: 'button', disabled: busy,
+            onClick: function () { void write('clear') } }, t('clear')) : null,
+        ]),
+      ])
+    }
+
+    function ArtifactBrowser(props) {
+      var t = props.t, info = props.useTabInfo(), sessionId = props.sessionId
+      var cwd = props.useSessions(function (sessions) { return sessions.byId[sessionId]?.cwd })
+      var state = React.useState(null), result = state[0], setResult = state[1]
+      var queryState = React.useState(''), search = queryState[0], setSearch = queryState[1]
+      var pageState = React.useState(0), offset = pageState[0], setOffset = pageState[1]
+      var refreshState = React.useState(0), refresh = refreshState[0], setRefresh = refreshState[1]
+      var busyState = React.useState(false), busy = busyState[0], setBusy = busyState[1]
+      var errorState = React.useState(''), error = errorState[0], setError = errorState[1]
+      React.useEffect(function () {
+        if (!sessionId || !info.tab.visible) return
+        var controller = new AbortController()
+        setBusy(true); setError('')
+        var query = new URLSearchParams({ sessionId: sessionId, search: search, offset: String(offset), limit: '20' })
+        webRequest('artifacts?' + query, { signal: controller.signal }).then(function (value) {
+          if (!controller.signal.aborted) setResult(value)
+        }).catch(function () { if (!controller.signal.aborted) setError(t('failed')) })
+          .finally(function () { if (!controller.signal.aborted) setBusy(false) })
+        return function () { controller.abort() }
+      }, [sessionId, info.tab.visible, search, offset, refresh])
+      function open(path) {
+        var normalized = String(path).replace(/\\/g, '/')
+        var root = String(cwd || '').replace(/\\/g, '/').replace(/\/$/, '')
+        var relative = root && normalized.startsWith(root + '/') ? normalized.slice(root.length + 1) : normalized
+        info.tab.actions.openResource('dsh-resource://file/session/' + encodeURIComponent(sessionId) + '/' + relative.split('/').map(encodeURIComponent).join('/'))
+      }
+      var entries = result?.artifacts || []
+      return element('section', { 'data-gotry-artifacts-browser': '', style: { padding: '16px', display: 'grid', alignContent: 'start', gap: '12px', height: '100%', overflow: 'auto', boxSizing: 'border-box', minWidth: 0 } }, [
+        element('div', { key: 'controls', style: { display: 'flex', gap: '8px', alignItems: 'center', minWidth: 0 } }, [
+          element(UI.Input, { key: 'search', 'aria-label': t('search'), placeholder: t('searchPlaceholder'), value: search,
+            style: { minWidth: 0, width: '100%' }, onChange: function (event) { setSearch(event.target.value); setOffset(0) } }),
+          element(UI.Button, { key: 'refresh', size: 'sm', disabled: busy || !sessionId,
+            onClick: function () { setRefresh(function (value) { return value + 1 }) } }, busy ? t('loading') : t('refresh')),
+        ]),
+        error ? element('p', { key: 'error', role: 'alert' }, error) : null,
+        !sessionId ? element('p', { key: 'no-session' }, t('noSession')) : !busy && entries.length === 0 ? element('p', { key: 'empty' }, t(search ? 'noMatches' : 'empty')) : null,
+        element('div', { key: 'list', 'aria-busy': busy, style: { display: 'grid', gap: '8px' } }, entries.map(function (entry) {
+          var html = /\.html?$/i.test(entry.path)
+          return element(UI.Button, { key: entry.path, variant: 'outline', 'data-gotry-artifact-entry': entry.path,
+            title: html ? t('htmlHint') : entry.path, onClick: function () { open(entry.path) },
+            style: { width: '100%', height: 'auto', padding: '12px', textAlign: 'left', justifyContent: 'flex-start', minWidth: 0 } }, [
+            element(UI.FileTypeIcon, { key: 'icon', path: entry.path }),
+            element('span', { key: 'body', style: { display: 'grid', gap: '4px', minWidth: 0, flex: 1 } }, [
+              element('span', { key: 'title', style: { overflowWrap: 'anywhere' } }, entry.title),
+              element('span', { key: 'meta', style: { fontSize: '11px', color: 'var(--dsw-alias-label-tertiary)', overflowWrap: 'anywhere' } },
+                [entry.status, entry.updated ? new Date(entry.updated).toLocaleString() : '', html ? t('html') : t('open')].filter(Boolean).join(' · ')),
+            ]),
+          ])
+        })),
+        result?.total > 0 ? element('div', { key: 'pagination', style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: '8px', flexWrap: 'wrap' } }, [
+          element(UI.Button, { key: 'previous', size: 'sm', disabled: busy || offset === 0, onClick: function () { setOffset(Math.max(0, offset - 20)) } }, t('previous')),
+          element('span', { key: 'count', role: 'status', style: { fontSize: '12px' } }, (entries.length ? offset + 1 : 0) + '–' + (offset + entries.length) + ' / ' + result.total),
+          element(UI.Button, { key: 'next', size: 'sm', disabled: busy || !result.truncated, onClick: function () { setOffset(result.nextOffset) } }, t('next')),
+        ]) : null,
+      ])
+    }
 
     function element(type, props, children) {
       return React.createElement(type, props, ...(Array.isArray(children) ? children : [children]))
@@ -194,6 +362,21 @@ window.__ModuleLoader__.load({
           return scope.slots.register({ name: 'tool.call.toolview', key: 'gotry_artifacts_read' }, ArtifactToolView)
         })
       })
+      ctx.inject(['slots', 'locale'], function (scope) {
+        var ns = 'gotry.web'
+        var t = scope.locale.bind(ns)
+        scope.effect(function () { return scope.locale.register(ns, webLocale) })
+        scope.slots.inject('plugins.item', function () {
+          return scope.slots.register({ name: 'plugins.item', id: 'gotry', order: 50, label: function () { return t('title') }, locale: ns }, FlyaiSettings)
+        })
+        scope.inject(['sidebarRightTabs'], function (sidebar) {
+          sidebar.effect(function () { return sidebar.sidebarRightTabs.register({ id: '@danceiny/gotry:artifacts', kind: 'gotry-artifacts',
+            title: function () { return t('artifacts') }, guide: [{ id: 'gotry-artifacts', order: 15, title: function () { return t('artifacts') }, description: function () { return t('artifactsHint') } }] }) })
+          sidebar.slots.inject('sidebar.right.pane.tab', function () {
+            return sidebar.slots.register({ name: 'sidebar.right.pane.tab', key: '@danceiny/gotry:artifacts', locale: ns }, ArtifactBrowser)
+          })
+        })
+      })
     }
 
     exports.apply = apply

package/cordis.gotry-patch.yml

@@ -10,6 +10,8 @@
         stateRoot: '.'
         timeoutMs: 30000
         hbcliBin: 'hbcli'
+    - id: gotry-present
+      name: 'placeholder/dsh-tool-present'
     - id: dsh-map-tools
       name: 'placeholder/dsh-map-tools'
     - id: dsh-calendar

package/dist/capabilities/artifacts.js

@@ -215,6 +215,32 @@ async function listCwdArtifacts(cwd) {
     }
     return entries;
 }
+/** Durable handoff outputs live outside async/, including honest failure notes. */
+async function listHandoffArtifacts(root) {
+    const dir = join(root, 'gotry-state', 'turn-handoffs');
+    const names = await readdir(dir).catch(() => []);
+    const entries = [];
+    for (const name of names) {
+        if (!name.endsWith('.json'))
+            continue;
+        try {
+            const ticket = JSON.parse(await readFile(join(dir, name), 'utf8'));
+            if (ticket.schema !== 'gotry_turn_handoff.v1' || name !== `${ticket.id}.json`
+                || !['settled', 'failed'].includes(ticket.status) || ticket.deliverableFile !== `${ticket.id}.deliverable.md`)
+                continue;
+            const path = await realpath(join(dir, ticket.deliverableFile));
+            if (!underRoot(path, root) || hasDeniedSegment(path))
+                continue;
+            const info = await stat(path);
+            if (!info.isFile())
+                continue;
+            entries.push({ source: 'turn-handoff', id: ticket.id, title: String(ticket.objective ?? ticket.id),
+                path, status: ticket.status, updated: new Date(info.mtimeMs).toISOString(), bytes: info.size });
+        }
+        catch { /* A corrupt or missing output cannot be advertised as a file. */ }
+    }
+    return entries;
+}
 export async function listArtifacts(opts) {
     const limit = clampLimit(opts.limit);
     const offset = normalizeOffset(opts.offset, 'offset');
@@ -223,12 +249,16 @@ export async function listArtifacts(opts) {
     const cwd = opts.cwd ? resolve(opts.cwd) : process.cwd();
     const canonicalRoot = await realpath(root).catch(() => root);
     const canonicalCwd = await realpath(cwd).catch(() => cwd);
+    const handoffRoot = rootOf(opts.handoffRoot ?? opts.cwd ?? opts.stateRoot);
+    const canonicalHandoffRoot = await realpath(handoffRoot).catch(() => handoffRoot);
     // 1) collect all eligible entries per source, without per-source limits —
     //    pageSize is applied to the merged/deduped/sorted set so older cwd files
     //    stay reachable across pages.
     const collected = [
         ...listRunsFromLedger(canonicalRoot, 'local'),
         ...(await listDeliverableFiles(canonicalRoot)),
+        ...(await listHandoffArtifacts(canonicalRoot)),
+        ...(canonicalHandoffRoot !== canonicalRoot ? await listHandoffArtifacts(canonicalHandoffRoot) : []),
         ...(await listCwdArtifacts(canonicalCwd)),
     ];
     // 2) canonical-path dedupe (keep ledger authority when both sources point
@@ -262,6 +292,8 @@ export async function listArtifacts(opts) {
         offset,
         roots: [canonicalRoot, canonicalCwd],
     };
+    if (!result.roots.includes(canonicalHandoffRoot))
+        result.roots.push(canonicalHandoffRoot);
     if (hasMore)
         result.nextOffset = start + page.length;
     if (needle !== '')
@@ -280,6 +312,8 @@ export async function readArtifact(opts) {
     const cwd = opts.cwd ? resolve(opts.cwd) : process.cwd();
     const canonicalRoot = await realpath(root).catch(() => root);
     const canonicalCwd = await realpath(cwd).catch(() => cwd);
+    const handoffRoot = rootOf(opts.handoffRoot ?? opts.cwd ?? opts.stateRoot);
+    const canonicalHandoffRoot = await realpath(handoffRoot).catch(() => handoffRoot);
     const raw = String(opts.path ?? '').trim();
     if (!raw)
         return { ok: false, error: 'path 必填(来自 gotry_artifacts_list 的 path,或异步工单 id)' };
@@ -296,10 +330,13 @@ export async function readArtifact(opts) {
             filePath = asyncDeliverablePath(root, raw);
         }
         else {
-            const p = asyncDeliverablePath(root, raw);
+            const handoff = /^th-[a-z0-9-]+$/i.test(raw)
+                ? [join(handoffRoot, 'gotry-state', 'turn-handoffs', `${raw}.deliverable.md`),
+                    join(root, 'gotry-state', 'turn-handoffs', `${raw}.deliverable.md`)] : [];
+            const p = handoff.find(path => existsSync(path)) ?? asyncDeliverablePath(root, raw);
             const canonical = await realpath(p).catch(() => null);
             if (canonical) {
-                if (!underRoot(canonical, canonicalRoot) || hasDeniedSegment(canonical)) {
+                if (!(underRoot(canonical, canonicalRoot) || underRoot(canonical, canonicalHandoffRoot)) || hasDeniedSegment(canonical)) {
                     return { ok: false, error: `路径越界:${raw}`, hint: `只读 ${root} 与 dsh 工作目录内的文本产物` };
                 }
                 const ext = canonical.slice(canonical.lastIndexOf('.') + 1).toLowerCase();
@@ -325,7 +362,7 @@ export async function readArtifact(opts) {
         // 路径(realpath 后的 cwd),而 macOS 上 /var 与 /private/var 这类符号链接会让
         // canonical 路径不匹配字面 cwd,导致 list→read 串联断裂。边界权威仍是下方
         // realpath 后的 canonical 复检,这里放宽不改变可读集合。
-        const inScope = (p) => (underRoot(p, cwd) || underRoot(p, root) || underRoot(p, canonicalCwd) || underRoot(p, canonicalRoot)) && !hasDeniedSegment(p);
+        const inScope = (p) => (underRoot(p, cwd) || underRoot(p, root) || underRoot(p, canonicalCwd) || underRoot(p, canonicalRoot) || underRoot(p, handoffRoot) || underRoot(p, canonicalHandoffRoot)) && !hasDeniedSegment(p);
         // Prefer an existing candidate so a cwd miss does not mask a valid state-root file.
         const allowed = candidates.find(p => inScope(p) && existsSync(p)) ?? candidates.find(inScope);
         if (!allowed) {
@@ -335,7 +372,7 @@ export async function readArtifact(opts) {
         if (!canonical) {
             return { ok: false, error: `文件不存在:${raw}`, hint: '先 gotry_artifacts_list 看在册产物' };
         }
-        if (!(underRoot(canonical, canonicalCwd) || underRoot(canonical, canonicalRoot)) || hasDeniedSegment(canonical)) {
+        if (!(underRoot(canonical, canonicalCwd) || underRoot(canonical, canonicalRoot) || underRoot(canonical, canonicalHandoffRoot)) || hasDeniedSegment(canonical)) {
             return { ok: false, error: `路径越界:${raw}`, hint: `只读 ${root} 与 dsh 工作目录内的文本产物` };
         }
         const ext = canonical.slice(canonical.lastIndexOf('.') + 1).toLowerCase();

package/dist/capabilities/doctor.js

@@ -19,6 +19,7 @@ import { existsSync, readFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { homedir } from 'node:os';
 import { join, resolve } from 'node:path';
+import { checkExtensionStatus } from '../../bin/gotry-extension-status.js';
 import { readLatestChannelEvents } from './channel-health.js';
 import { displayEndpoint, endpointFingerprint, readFlyaiVerification, resolveFlyaiEndpoint, resolveFlyaiKey, sha256Hex, } from './flyai-config.js';
 /** hbcli 已知安装位(与 capabilities/hbcli.ts hbcliBinCandidates 同清单) */
@@ -124,17 +125,8 @@ export async function runDoctorChecks(opts = {}) {
     items.push(nodeOk(nodeVersion)
         ? { id: 'node', label: 'Node 运行时', status: 'ok', detail: `Node ${nodeVersion}(≥22.15)` }
         : { id: 'node', label: 'Node 运行时', status: 'missing', detail: `Node ${nodeVersion} 过旧(gotry 需 ≥22.15)`, fix: '升级 Node.js 至 22.15+(https://nodejs.org)' });
-    // 1. Stai Travel Bridge 扩展(账号会话通道的传输层;装在哪由 bootstrap setup 管理)
-    //    D-24 自适应(#117):离线只能探测本地 unpacked 通道;商店版无本地文件面——
-    //    missing detail 明示「商店版用户可忽略本项」,不再把商店版用户误导成本地通道缺失
-    const extManifest = join(home, '.gotry', 'extension', 'manifest.json');
-    items.push(existsSync(extManifest)
-        ? { id: 'extension', label: 'Stai Travel Bridge 扩展', status: 'ok', detail: `已就位(本地通道:${extManifest})` }
-        : {
-            id: 'extension', label: 'Stai Travel Bridge 扩展', status: 'missing',
-            detail: '本地通道未落位(~/.gotry/extension/manifest.json 不存在)。影响面:gotry_session_search / gotry_session_login(账号会话通道)不可用;携程机票/酒店实时检索、12306 余票、Dida 实时报价都依赖此通道。其它工具(机票 FlyAI、酒店 hbcli、地图、天气等)不受影响。若你已从 Chrome 商店安装(自动更新,商店版 ID oeajpicc…),本项可忽略——会话检索可用性以运行时为准(gotry_session_search 的 verdict)。若未安装:应用商店一键装即可',
-            fix: '在 Chrome 应用商店一键安装(自动更新): https://chromewebstore.google.com/detail/gotry-session-bridge/oeajpiccmonococjcegddlooeeohlbgd',
-        });
+    // 1. CLI 与工具层共用只读检测：安装、落位、连接是不同证据。
+    items.push({ id: 'extension', label: 'Stai Travel Bridge 扩展', ...await checkExtensionStatus({ homeDir: home, env, ports: opts.extensionPorts }) });
     // 2. agent-reach(网页/社媒读取;.venv 装在包内,与 agent-reach.ts venvPython 同位)
     const venvPython = join(repoRoot, '.venv/bin/python');
     const reachBin = join(repoRoot, '.venv/bin/agent-reach');
@@ -229,7 +221,7 @@ export async function runDoctorChecks(opts = {}) {
         items.push({
             id: 'flyai', label: 'FlyAI(飞猪官方检索:机/火/酒/景/关键词/AI/万豪)', status: 'degraded',
             detail: `未配置 key——匿名试用中(共享额度易达限;达限报 Trial limit reached)${flyaiQuotaNote}。影响面:共享池额度小,频繁会话易触顶;达限本会话内 gotry_flyai_search(机票/酒店/票务/AI/万豪 8 类)失败,改走 gotry_session_search 账号会话通道。`,
-            fix: '本机运行 `gotry setup flyai`(隐藏输入,候选 key 先 scrub-env 验证后保存);打开 https://flyai.open.fliggy.com/console，登录后复制 API Key',
+            fix: 'Web 打开「插件 → GoTry → FlyAI」验证并保存；或运行 `npx @danceiny/gotry setup flyai`：① 打开 https://flyai.open.fliggy.com/console 复制 API Key；② 在终端隐藏粘贴；③ 验证后保存。也可运行 `npx @danceiny/gotry doctor --fix` 按提示配置',
         });
     }
     else {
@@ -254,7 +246,7 @@ export async function runDoctorChecks(opts = {}) {
             items.push({
                 id: 'flyai', label: 'FlyAI(飞猪官方检索:机/火/酒/景/关键词/AI/万豪)', status: 'degraded',
                 detail: `${reason}(${sourceText};endpoint ${displayEndpoint(flyaiEndpoint.url)}${flyaiEndpoint.debug ? '(DEBUG)' : ''})——非空不等于鉴权通过`,
-                fix: '本机运行 `gotry setup flyai` 重新验证后保存;`gotry setup flyai --clear` 回退匿名',
+                fix: 'Web 打开「插件 → GoTry → FlyAI」重新验证；或运行 `npx @danceiny/gotry setup flyai`；`npx @danceiny/gotry setup flyai --clear` 回退匿名',
             });
         }
     }
@@ -264,7 +256,7 @@ export async function runDoctorChecks(opts = {}) {
         ? { id: 'sidebar', label: 'dsh-better-sidebar(侧栏工作台)', status: 'ok', detail: '已安装——web UI 右侧工作台可预览产物与 doctor 报告(gotry-state/doctor-report.md)' }
         : {
             id: 'sidebar', label: 'dsh-better-sidebar(侧栏工作台)', status: 'missing',
-            detail: '未安装——dsh web 无右侧工作台,产物与 doctor 报告只能在对话里看(gotry_artifacts_list)',
+            detail: '未安装此增强组件——Web 自带 GoTry 产物页与原生预览；可选补装以增强文件浏览',
             fix: 'npx @danceiny/gotry doctor --fix',
         });
     // 6. dsh-calendar(patch 分发面宿主插件;D-9 拍板:默认不挂载)
@@ -371,7 +363,7 @@ export async function runDoctorChecks(opts = {}) {
     const broken = items.filter(i => i.status !== 'ok' && i.id !== 'llm-key');
     const summary = broken.length === 0
         ? `体检通过:${items.length} 项全部就绪(可选依赖齐,LLM key 归 dsh 宿主管)。`
-        : `体检发现 ${broken.length} 项待处理:${broken.map(i => `${i.label}(${i.status === 'missing' ? '未装' : '半可用'})`).join('、')}。补装:终端跑 npx @danceiny/gotry doctor --fix,或按各项 fix 指引逐项处理。`;
+        : `体检发现 ${broken.length} 项待处理:${broken.map(i => `${i.label}(${i.status === 'missing' ? '未装' : i.id === 'extension' ? '待确认' : '半可用'})`).join('、')}。补装:终端跑 npx @danceiny/gotry doctor --fix,或按各项 fix 指引逐项处理。`;
     return { ok: broken.length === 0, items, summary };
 }
 /** 修复指引入表:命令类才加反引号(prose 类如「到控制台申请 key」原样) */

package/dist/scripts/agent-planning-turn-deadline-e2e.js

@@ -206,6 +206,8 @@ async function main() {
             cwd: TS_DIR,
             env: {
                 ...process.env,
+                HOME: dshHome,
+                DSH_HOME: dshHome,
                 GOTRY_HANDOFF_PLANNER_BIN: configuredBin,
                 LLM_API_KEY: 'synthetic-e2e-key',
                 LLM_BASE_URL: 'http://127.0.0.1:' + relay.port + '/v1',

package/dist/scripts/agent-planning-turn-deadline-tests.js

@@ -1,7 +1,10 @@
 import assert from 'node:assert/strict';
-import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync } from 'node:fs';
+import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
+import { Context } from '@deepseek-ai/cordis';
+import { ToolRuntime, defineTool } from '@deepseek-ai/dsh-tools';
+import { createScope } from '@deepseek-ai/dsh-scope';
 import { installTurnDeadline, TURN_DEADLINE_EXHAUSTED, TURN_DEADLINE_HANDOFF, TURN_HANDOFF_SCHEMA, writeTurnHandoffTicket, } from '../src/turn-deadline.js';
 const success = () => ({ isError: false, value: null, content: [] });
 const handlers = new Map();
@@ -129,7 +132,7 @@ const turnEvent = (id, type) => sessionEvent({ id }, { type });
         const text = result.content[0]?.text ?? '';
         assert.match(text, /TURN_DEADLINE_HANDOFF/);
         assert.match(text, /th-/, 'result names the persisted ticket id');
-        assert.match(text, /约 1 小时/, 'ETA label mirrors the S5 promise');
+        assert.match(text, /queued|not started/i, 'a persisted ticket alone must not claim a running worker');
     }
     // 同步抑制已生效
     assert.deepEqual(restricted.at(-1), { agentId: agent.id, deny: ['gotry_alpha', 'gotry_beta'] });
@@ -181,5 +184,135 @@ function deepPlanningNoise() {
     rmSync(root, { recursive: true, force: true });
 }
 sessionDisposed({ id: 'agent-handoff' });
+// A deadline must let the pending output write complete and keep native present
+// available. Start exactly one tracked job even if the model makes another call.
+{
+    const hooks = new Map();
+    let started = 0;
+    let denied = [];
+    const agent = { id: 'delivery',
+        session: { id: 'delivery', header: { cwd: handoffRoot }, snapshotEvents: () => [
+                { type: 'tool/call', data: { name: 'ask_user_question', callId: 'question' } },
+                { type: 'tool/result', data: { message: { source: { kind: 'tool', callId: 'question' }, content: [{ text: 'China working hours 9-18 CST' }] } } },
+                { type: 'tool/result', data: { message: { source: { kind: 'tool', callId: 'other' }, content: [{ text: 'large evidence '.repeat(3000) }] } } },
+            ] },
+        ctx: { tools: { restrict: (filter) => { denied = filter.deny; return () => { }; } } } };
+    const deliveryCtx = {
+        tools: { schemas: () => [{ name: 'write' }, { name: 'present' }, { name: 'search' }] },
+        on: (name, hook) => { hooks.set(name, hook); },
+    };
+    installTurnDeadline(deliveryCtx, {
+        stateRoot: handoffRoot, now: clock.now,
+        startHandoff: async (ticket) => {
+            assert.equal(written, true, 'output finishes before the worker starts');
+            assert.ok(ticket.context?.includes('9-18 CST'), 'retain early clarification answers despite large recent evidence');
+            started++;
+            return { ...ticket, status: 'running', jobId: 'gotry-planning-1' };
+        },
+    });
+    hooks.get('session/event')({ id: agent.id }, { type: 'user/message', data: { source: { kind: 'user' }, content: [{ type: 'text', text: deepMessageForDelivery() }] } });
+    clock.advance(240_001);
+    let written = false;
+    const draft = join(handoffRoot, 'exploration.md');
+    const pending = { token: Symbol(), name: 'write', agent };
+    const result = await hooks.get('tools/execute')(pending, async () => { writeFileSync(draft, '# Exploration'); written = true; return success(); });
+    const post = await hooks.get('tools/post-execute')(pending, result, async () => ({ kind: 'accept' }));
+    assert.equal(written, true, 'pending output write must really execute');
+    assert.equal(readFileSync(draft, 'utf8'), '# Exploration');
+    assert.equal(result.isError, false, 'write result must remain truthful');
+    assert.ok(!denied.includes('present'), 'native deliverable publication stays available');
+    assert.equal(started, 1, 'handoff starts a tracked job');
+    await hooks.get('tools/execute')({ token: Symbol(), name: 'present', agent }, async () => success());
+    assert.equal(started, 1, 'present must not queue another planner');
+    const text = JSON.stringify(post.additionalContexts);
+    assert.match(text, /gotry-planning-1/, 'handoff names the actual native job');
+    assert.match(text, /present/, 'successful writes must be presented before final reply');
+    let repeatedWrite = false;
+    await hooks.get('tools/execute')({ token: Symbol(), name: 'write', agent }, async () => { repeatedWrite = true; return success(); });
+    assert.equal(repeatedWrite, false, 'only the pending draft write gets the deadline exception');
+    assert.equal(started, 1, 'repeated finalization must not dispatch another worker');
+}
+function deepMessageForDelivery() { return '12月初有个阿联酋国庆，我打算借机 IRW远程办公（还有5天额度）+请假+放假 回国玩一趟，主要去东北，比如长春泡澡啊啥的，可以看看一些东北风光啥的（没去过），我女朋友从南京过去，请帮我探索一个可行的具体规划'; }
 rmSync(handoffRoot, { recursive: true, force: true });
+// Real DSH registry coverage: inherited and agent-scoped output writes must
+// finish before deadline restrictions hide inherited registrations.
+for (const [registration, writeFailure] of [['global', false], ['scoped', false], ['global', true], ['scoped', true]]) {
+    const root = mkdtempSync(join(tmpdir(), 'gotry-write-registry-'));
+    const runtimeCtx = new Context();
+    runtimeCtx.provide('systemPrompt', { tools() { } });
+    const tools = new ToolRuntime(runtimeCtx);
+    let time = 0;
+    const mutableAgent = { id: registration, ctx: runtimeCtx, session: { id: registration, header: { cwd: root }, snapshotEvents: () => [] } };
+    const agent = mutableAgent;
+    const scope = createScope(runtimeCtx, agent);
+    mutableAgent.ctx = scope.ctx;
+    installTurnDeadline(runtimeCtx, { stateRoot: root, now: () => time, fixedPolicy: { softMs: 5, hardMs: 10, exit: 'handoff' } });
+    const draft = join(root, 'draft.md');
+    let writes = 0;
+    (registration === 'global' ? tools : scope.ctx.tools).register(defineTool({
+        name: 'write', description: 'Write the draft', parameters: {}, output: { schema: { type: 'json' }, render: () => [{ type: 'text', text: 'saved' }] },
+        async execute() { writes++; if (writeFailure)
+            throw new Error('disk write failed'); writeFileSync(draft, 'saved draft'); return { saved: true }; },
+    }));
+    try {
+        assert.ok(tools.get('write', agent), 'write is visible before deadline dispatch');
+        runtimeCtx.emit('session/event', agent.session, { type: 'user/message', data: { source: { kind: 'user' }, content: [{ type: 'text', text: 'plan my trip' }] } });
+        time = 11;
+        const call = () => tools.execute({ name: 'write', agent, arguments: {}, callId: 'draft', signal: new AbortController().signal });
+        const result = await call();
+        assert.equal(result.isError, writeFailure, `${registration} pending write keeps its actual registry outcome: ${JSON.stringify(result)}`);
+        if (writeFailure) {
+            assert.equal(existsSync(draft), false);
+            assert.match(JSON.stringify(result), /disk write failed/);
+        }
+        else
+            assert.equal(readFileSync(draft, 'utf8'), 'saved draft');
+        assert.match(JSON.stringify(result.additionalContexts), /queued/, 'registry post-execute carries handoff guidance');
+        await call();
+        assert.equal(writes, 1, 'only the pending write receives the exception');
+    }
+    finally {
+        await scope.dispose();
+        await runtimeCtx.fiber.dispose();
+        rmSync(root, { recursive: true, force: true });
+    }
+}
+// Long earlier prose and recent large search output cannot evict a mandatory
+// answer. If user input itself exceeds the bounded snapshot, fail visibly.
+for (const overflow of [false, true]) {
+    const root = mkdtempSync(join(tmpdir(), 'gotry-handoff-context-'));
+    const hooks = new Map();
+    let captured;
+    const agent = { id: 'constraints', ctx: { tools: { restrict: () => () => { } } }, session: {
+            id: 'constraints', header: { cwd: root }, snapshotEvents: () => [
+                { type: 'user/message', data: { source: { kind: 'user' }, content: [{ type: 'text', text: 'earlier prose '.repeat(overflow ? 6000 : 600) }] } },
+                { type: 'tool/call', data: { name: 'ask_user_question', callId: 'access' } },
+                { type: 'tool/result', data: { message: { source: { kind: 'tool', callId: 'access' }, content: [{ type: 'text', text: 'MUST_KEEP_WHEELCHAIR_ACCESS_AND_NO_STAIRS' }] } } },
+                { type: 'tool/result', data: { message: { source: { kind: 'tool', callId: 'search' }, content: [{ type: 'text', text: 'recent search '.repeat(2000) }] } } },
+            ],
+        } };
+    const localCtx = { tools: { schemas: () => [] }, on: (name, hook) => hooks.set(name, hook) };
+    let time = 0;
+    installTurnDeadline(localCtx, { stateRoot: root, now: () => time, fixedPolicy: { softMs: 5, hardMs: 10, exit: 'handoff' },
+        startHandoff: async (ticket) => { captured = ticket; return ticket; } });
+    try {
+        hooks.get('session/event')({ id: agent.id }, { type: 'user/message', data: { source: { kind: 'user' }, content: [{ type: 'text', text: 'plan my trip' }] } });
+        time = 11;
+        await hooks.get('tools/execute')({ token: Symbol(), name: 'search', agent }, async () => success());
+        if (overflow) {
+            assert.equal(captured, undefined, 'do not start planning after silently losing user constraints');
+            const ticketFile = readdirSync(join(root, 'gotry-state', 'turn-handoffs')).find(name => name.endsWith('.json'));
+            const ticket = JSON.parse(readFileSync(join(root, 'gotry-state', 'turn-handoffs', ticketFile), 'utf8'));
+            assert.equal(ticket.status, 'failed');
+            assert.match(ticket.error, /context|answers|constraints/i);
+        }
+        else {
+            assert.ok(captured?.context?.includes('MUST_KEEP_WHEELCHAIR_ACCESS_AND_NO_STAIRS'), 'mandatory answer survives large surrounding output');
+            assert.ok(captured.context.length < 90_000, 'context remains bounded');
+        }
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+}
 console.log('agent turn deadline tests: OK (routing→converge/handoff exits, ticket persistence, plugin-message discipline, lifecycle)');

package/dist/scripts/artifact-client-contract-tests.js

@@ -36,13 +36,14 @@ const fakeReact = {
     useState(initial) { return [initial, () => { }]; },
 };
 const clientExports = registrations[0].factory(name => {
-    assert.equal(name, 'react');
-    return fakeReact;
+    assert.ok(['react', '@deepseek-ai/dsh-client-ui-primitives'].includes(name));
+    return name === 'react' ? fakeReact : {};
 });
 assert.deepEqual(Object.keys(clientExports), ['apply', 'inject']);
 const slotRegistrations = [];
 const registrationContext = {
-    inject(_deps, callback) { callback(registrationContext); },
+    inject(deps, callback) { if (deps.every(name => name in registrationContext))
+        callback(registrationContext); },
     slots: {
         inject(_slot, callback) { callback(); },
         register(definition, view) {

package/dist/scripts/artifact-delivery-tests.js

@@ -0,0 +1,31 @@
+/** Successful bounded renders produce native delivery events; failures and escaped paths never do. */
+import assert from 'node:assert/strict';
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+const moduleUrl = new URL('../src/artifact-delivery.js', import.meta.url).href;
+const delivery = await import(moduleUrl).catch(() => undefined);
+assert.equal(typeof delivery?.registerArtifactDeliveries, 'function', 'bounded render tools must publish native file deliveries');
+const root = mkdtempSync(join(tmpdir(), 'gotry-artifact-delivery-'));
+try {
+    const path = join(root, 'trip.html');
+    writeFileSync(path, '<h1>Trip</h1>');
+    let observe = () => { throw new Error('observer absent'); };
+    const events = [];
+    const session = { header: { cwd: root }, view: () => ({ getSnapshot: () => ({ openTurnStartSeq: 1, lastTurn: 7 }) }),
+        append: (name, value) => events.push({ name, value }) };
+    delivery.registerArtifactDeliveries({ get: () => ({ stateOf: () => ({ openTurnStartSeq: 1, lastTurn: 7 }) }),
+        on: (name, fn) => { assert.equal(name, 'tools/result'); observe = fn; } });
+    const exec = { name: 'gotry_itinerary_render', callId: 'render-1', agent: { session }, signal: new AbortController().signal };
+    observe(exec, { isError: false, value: { ok: true, path } });
+    assert.deepEqual(events, [{ name: 'deliverables/presented', value: { turn: 7, callId: 'render-1', files: [{ path, description: 'GoTry itinerary' }] } }]);
+    for (const value of [{ ok: false, path }, { ok: true, path: join(root, 'missing.html') }, { ok: true, path: join(root, '..', 'private.html') }])
+        observe(exec, { isError: false, value });
+    observe({ ...exec, name: 'gotry_artifacts_read' }, { isError: false, value: { ok: true, path } });
+    observe(exec, { isError: true, value: { ok: true, path } });
+    assert.equal(events.length, 1);
+    console.log('GoTry native artifact deliveries: real bounded render only PASS');
+}
+finally {
+    rmSync(root, { recursive: true, force: true });
+}