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

package/dist/capabilities/channel-registry.js

@@ -0,0 +1,213 @@
+import { channelState } from './channel-health.js';
+export const CHANNELS = [
+    {
+        id: 'flyai',
+        label: '飞猪官方 API',
+        tool: 'gotry_flyai_search',
+        intents: [
+            'search-flight',
+            'search-train',
+            'search-hotel'
+        ],
+        quotaClass: 'anonymous-trial',
+        evidenceTag: '[实时API:flyai@ts]',
+        tier: 'realtime-api',
+        efficiencyRank: 0,
+        setup: '零 setup(匿名试用共享池,易达限;正式 key 配 FLYAI_API_KEY 解除)'
+    },
+    {
+        id: 'hbcli-hotel',
+        label: 'hbcli 酒店实时源',
+        tool: 'gotry_hotel_search',
+        intents: [
+            'search-hotel'
+        ],
+        quotaClass: 'user-key',
+        evidenceTag: '[实时API:hbcli@ts]',
+        tier: 'realtime-api',
+        efficiencyRank: 1,
+        setup: 'hbcli 凭证(demo 沙箱一键);未装自动降静态包'
+    },
+    {
+        id: 'session:ctrip-flight',
+        label: '携程·用户登录态',
+        tool: 'gotry_session_search',
+        intents: [
+            'search-flight'
+        ],
+        quotaClass: 'user-session',
+        evidenceTag: '[会话:ctrip-flight@ts]',
+        tier: 'session',
+        efficiencyRank: 2,
+        setup: '一次性装 Session Bridge 扩展 + 授权卡 + (如需)官网登录',
+        hint: 'kind=flight'
+    },
+    {
+        id: 'session:ctrip-hotel',
+        label: '携程·用户登录态',
+        tool: 'gotry_session_search',
+        intents: [
+            'search-hotel'
+        ],
+        quotaClass: 'user-session',
+        evidenceTag: '[会话:ctrip-hotel@ts]',
+        tier: 'session',
+        efficiencyRank: 2,
+        setup: '一次性装 Session Bridge 扩展 + 授权卡 + (如需)官网登录',
+        hint: 'kind=hotel'
+    },
+    {
+        id: 'session:12306-train',
+        label: '12306 公开查询面',
+        tool: 'gotry_session_search',
+        intents: [
+            'search-train'
+        ],
+        quotaClass: 'user-session',
+        evidenceTag: '[会话:train-12306@ts]',
+        tier: 'session',
+        efficiencyRank: 2,
+        setup: '一次性装 Session Bridge 扩展(公开查询面,无需登录)',
+        hint: 'kind=train'
+    },
+    {
+        id: 'anything-geo',
+        label: '目的地/酒店候选(hotel-be)',
+        tool: 'gotry_anything_search',
+        intents: [
+            'search-geo'
+        ],
+        quotaClass: 'user-key',
+        evidenceTag: '[实时API:hbcli-anything@ts]',
+        tier: 'realtime-api',
+        efficiencyRank: 1,
+        setup: 'hbcli 可达即可(随 hbcli 安装)'
+    },
+    {
+        id: 'open-meteo',
+        label: '天气(open-meteo)',
+        tool: 'gotry_weather_check',
+        intents: [
+            'weather'
+        ],
+        quotaClass: 'free-public',
+        evidenceTag: '[实时API:open-meteo@ts]',
+        tier: 'realtime-api',
+        efficiencyRank: 0
+    },
+    {
+        id: 'opensky',
+        label: '航班实时印证(OpenSky)',
+        tool: 'gotry_flight_verify',
+        intents: [
+            'verify-flight'
+        ],
+        quotaClass: 'free-public',
+        evidenceTag: '[实时API:opensky@ts]',
+        tier: 'realtime-api',
+        efficiencyRank: 0
+    },
+    {
+        id: 'web-read',
+        label: '网页读取兜底(agent-reach)',
+        tool: 'gotry_web_search',
+        intents: [
+            'read-web',
+            'search-flight',
+            'search-train',
+            'search-hotel'
+        ],
+        quotaClass: 'user-key',
+        evidenceTag: '[agent-reach:web.read@ts]',
+        tier: 'best-effort',
+        efficiencyRank: 3,
+        setup: 'gotry .venv 装 agent-reach(npx gotry doctor --fix)'
+    },
+    {
+        id: 'static-hotel',
+        label: '内置静态数据包',
+        tool: 'gotry_hotel_search',
+        intents: [
+            'search-hotel'
+        ],
+        quotaClass: 'static',
+        evidenceTag: '[静态包:估算]',
+        tier: 'static',
+        efficiencyRank: 9,
+        routable: false
+    }
+];
+const TIER_RANK = {
+    'realtime-api': 0,
+    session: 1,
+    'best-effort': 2,
+    static: 3
+};
+const TIER_WHY = {
+    'realtime-api': '官方结构化数据,证据链最强',
+    'session': '用户本人登录态的真实价/库存',
+    'best-effort': '非结构化兜底(读页汇总),证据弱于 API',
+    'static': '内置估算,仅覆盖内置场景'
+};
+export const INTENT_LABELS = {
+    'search-flight': '机票',
+    'search-train': '火车',
+    'search-hotel': '酒店',
+    'search-geo': '目的地候选',
+    'read-web': '网页/社媒',
+    'weather': '天气',
+    'verify-flight': '航班印证'
+};
+export function channelsForIntent(intent) {
+    return CHANNELS.filter((c)=>c.routable !== false && c.intents.includes(intent)).slice().sort((a, b)=>TIER_RANK[a.tier] - TIER_RANK[b.tier] || a.efficiencyRank - b.efficiencyRank);
+}
+export function routingAdvice(intent, opts = {}) {
+    const alternatives = channelsForIntent(intent).filter((c)=>c.id !== opts.excludeChannel).filter((c)=>channelState(c.id, opts.now)?.state !== 'down').slice(0, opts.limit ?? 3).map((c)=>({
+            tool: c.tool,
+            channel: c.id,
+            label: c.label,
+            why: TIER_WHY[c.tier],
+            ...c.setup ? {
+                setup: c.setup
+            } : {},
+            ...c.hint ? {
+                hint: c.hint
+            } : {}
+        }));
+    return {
+        intent,
+        alternatives
+    };
+}
+export function toolRoutingHeadline(tool) {
+    const intents = new Set();
+    for (const c of CHANNELS){
+        if (c.routable === false || c.tool !== tool) continue;
+        for (const i of c.intents)intents.add(i);
+    }
+    if (intents.size === 0) return '';
+    const lines = [
+        ...intents
+    ].map((intent)=>`- ${INTENT_LABELS[intent]}: ${channelsForIntent(intent).map((c)=>`${c.label}(${c.tool}${c.hint ? ` ${c.hint}` : ''})`).join(' → ')}`);
+    return [
+        '本工具服务的检索意图与通道顺位(证据级降序):',
+        ...lines,
+        'verdict≠hit 时按结果内 routing 字段改道下一通道,勿盲试同通道。'
+    ].join('\n');
+}
+export function renderRoutingCard(now = new Date()) {
+    const multiChannel = Object.keys(INTENT_LABELS).map((intent)=>({
+            intent,
+            channels: channelsForIntent(intent)
+        })).filter((x)=>x.channels.length >= 2);
+    const lines = multiChannel.map(({ intent, channels })=>`- ${INTENT_LABELS[intent]}: ${channels.map((c)=>`${c.label}(${c.tool}${c.hint ? ` ${c.hint}` : ''})`).join(' → ')}`);
+    return [
+        '检索通道顺位(官方API > 用户会话 > 网页兜底;某次检索 verdict≠hit 时,按该结果内 routing 字段改道下一通道,同通道本会话不盲试第二次):',
+        ...lines,
+        '额度口径:匿名试用=首次体验导流(达限即改道并提示配 key);正式 key(FLYAI_API_KEY/hbcli 凭证)与账号会话=正式用量;静态包=估算必标注。',
+        `卡生成于 ${now.toISOString()}(通道状态变化不改变顺位表本身,只影响 routing 建议的可用性过滤)。`
+    ].join('\n');
+}
+
+
+//# sourceURL=ts/capabilities/channel-registry.ts

package/dist/capabilities/doctor.js

@@ -0,0 +1,285 @@
+import { spawn } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { readLatestChannelEvents } from './channel-health.js';
+function hbcliCandidates(homeDir) {
+    return [
+        'hbcli',
+        join(homeDir, '.local/bin/hbcli'),
+        join(homeDir, '.staicli/current/hbcli')
+    ];
+}
+function probe(bin, args, timeoutMs = 8_000) {
+    return new Promise((resolveProbe)=>{
+        const child = spawn(bin, args, {
+            stdio: 'ignore',
+            env: process.env
+        });
+        let done = false;
+        const timer = setTimeout(()=>{
+            if (!done) {
+                done = true;
+                try {
+                    child.kill('SIGKILL');
+                } catch  {}
+                resolveProbe(false);
+            }
+        }, timeoutMs);
+        child.on('error', ()=>{
+            if (!done) {
+                done = true;
+                clearTimeout(timer);
+                resolveProbe(false);
+            }
+        });
+        child.on('exit', (code)=>{
+            if (!done) {
+                done = true;
+                clearTimeout(timer);
+                resolveProbe(code === 0);
+            }
+        });
+    });
+}
+export function nodeOk(version) {
+    const [maj = '0', min = '0'] = version.split('.');
+    return Number(maj) > 22 || Number(maj) === 22 && Number(min) >= 15;
+}
+export async function runDoctorChecks(opts = {}) {
+    const repoRoot = opts.repoRoot ? resolve(opts.repoRoot) : resolve(import.meta.dirname, '..', '..');
+    const home = opts.homeDir ?? homedir();
+    const env = opts.env ?? process.env;
+    const items = [];
+    const nodeVersion = process.versions.node;
+    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)'
+    });
+    const extManifest = join(home, '.gotry', 'extension', 'manifest.json');
+    items.push(existsSync(extManifest) ? {
+        id: 'extension',
+        label: 'GoTry Session Bridge 扩展',
+        status: 'ok',
+        detail: `已就位(本地通道:${extManifest})`
+    } : {
+        id: 'extension',
+        label: 'GoTry Session Bridge 扩展',
+        status: 'missing',
+        detail: '本地通道未落位(~/.gotry/extension/manifest.json 不存在)。若你已从 Chrome 商店安装(自动更新,商店版 ID oeajpicc…),本项可忽略——会话检索可用性以运行时为准(gotry_session_search 的 verdict)。若未安装:应用商店一键装即可',
+        fix: '在 Chrome 应用商店一键安装(自动更新): https://chromewebstore.google.com/detail/gotry-session-bridge/oeajpiccmonococjcegddlooeeohlbgd'
+    });
+    const venvPython = join(repoRoot, '.venv/bin/python');
+    const reachBin = join(repoRoot, '.venv/bin/agent-reach');
+    if (existsSync(reachBin)) {
+        items.push({
+            id: 'agent-reach',
+            label: 'Agent Reach(网页/社媒读取)',
+            status: 'ok',
+            detail: `已安装(${reachBin});渠道凭证选配体检:在对话里调 gotry_agent_reach {action:"status"}`
+        });
+    } else if (existsSync(venvPython)) {
+        items.push({
+            id: 'agent-reach',
+            label: 'Agent Reach(网页/社媒读取)',
+            status: 'degraded',
+            detail: '.venv 存在但缺 agent-reach 包——gotry_agent_reach / gotry_web_search 读页会失败',
+            fix: `npx gotry doctor --fix(或在包根执行: ${venvPython} -m pip install git+https://github.com/Panniantong/Agent-Reach.git)`
+        });
+    } else {
+        items.push({
+            id: 'agent-reach',
+            label: 'Agent Reach(网页/社媒读取)',
+            status: 'missing',
+            detail: '未安装——gotry_agent_reach / gotry_web_search(读网页)/ gotry_video_subtitle / gotry_github_search 全部不可用',
+            fix: 'npx gotry doctor --fix'
+        });
+    }
+    let hbPresent = '';
+    for (const p of hbcliCandidates(home)){
+        if (p !== 'hbcli' && existsSync(p)) {
+            hbPresent = p;
+            break;
+        }
+        if (p === 'hbcli' && await probe(p, [
+            'version'
+        ])) {
+            hbPresent = 'hbcli(PATH)';
+            break;
+        }
+    }
+    if (hbPresent) {
+        const whoami = await probe(hbPresent === 'hbcli(PATH)' ? 'hbcli' : hbPresent, [
+            'auth',
+            'whoami'
+        ]);
+        items.push(whoami ? {
+            id: 'hbcli',
+            label: 'hbcli(酒店实时源)',
+            status: 'ok',
+            detail: `已安装且凭证有效(${hbPresent})`
+        } : {
+            id: 'hbcli',
+            label: 'hbcli(酒店实时源)',
+            status: 'degraded',
+            detail: '二进制在,但凭证未配置/失效——酒店检索将降级静态包(非实时)',
+            fix: 'hbcli auth set-credentials --app-key hotelbyte_api_demo --app-secret hotelbyte_api_demo(快速试用沙箱;正式 key 向 HotelByte 申请)'
+        });
+    } else {
+        items.push({
+            id: 'hbcli',
+            label: 'hbcli(酒店实时源)',
+            status: 'missing',
+            detail: '未安装——酒店检索降级静态包(公开渠道估算,非实时,仅覆盖内置场景)',
+            fix: 'npx gotry doctor --fix'
+        });
+    }
+    const flyaiKey = env.FLYAI_API_KEY?.trim();
+    const flyaiQuotaNote = !flyaiKey && opts.stateRoot ? await (async ()=>{
+        const ev = (await readLatestChannelEvents(opts.stateRoot)).get('flyai');
+        return ev?.state === 'down' ? `;最近一次试用达限: ${ev.at}(匿名共享池,正式 key 可解除)` : '';
+    })() : '';
+    items.push(flyaiKey ? {
+        id: 'flyai',
+        label: 'FlyAI(飞猪官方检索)',
+        status: 'ok',
+        detail: 'FLYAI_API_KEY 已配(正式 key,无试用额度限制)'
+    } : {
+        id: 'flyai',
+        label: 'FlyAI(飞猪官方检索)',
+        status: 'degraded',
+        detail: `未配 FLYAI_API_KEY——走匿名试用额度(共享,易达限;达限报 "Trial limit reached")${flyaiQuotaNote}`,
+        fix: '到 flyai.open.fliggy.com 控制台申请正式 key,配进环境变量 FLYAI_API_KEY;无 key 期间机/火/酒检索请以 gotry_session_search(账号会话)为主'
+    });
+    const sidebarPkg = join(home, '.dsh/profiles/web/node_modules/dsh-better-sidebar/package.json');
+    items.push(existsSync(sidebarPkg) ? {
+        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)',
+        fix: 'npx gotry doctor --fix'
+    });
+    const calStatePath = join(home, '.gotry', 'calendar.json');
+    const calEnabled = (()=>{
+        try {
+            return JSON.parse(readFileSync(calStatePath, 'utf-8'))?.enabled === true;
+        } catch  {
+            return false;
+        }
+    })();
+    const calProfilePatch = join(home, '.dsh/profiles/web/cordis.patch.yml');
+    const calConfigured = calEnabled && existsSync(calProfilePatch) && (()=>{
+        try {
+            const content = readFileSync(calProfilePatch, 'utf-8');
+            return /calendar/.test(content) && /username\s*:/.test(content);
+        } catch  {
+            return false;
+        }
+    })();
+    items.push(!calEnabled ? {
+        id: 'calendar',
+        label: 'dsh-calendar(日历工作窗口)',
+        status: 'ok',
+        detail: '默认未挂载(D-9:未配置的日历工具不进工具箱;工作窗口由访谈覆盖,不影响任何检索)'
+    } : calConfigured ? {
+        id: 'calendar',
+        label: 'dsh-calendar(日历工作窗口)',
+        status: 'ok',
+        detail: `已挂载且已配置(${calStatePath})`
+    } : {
+        id: 'calendar',
+        label: 'dsh-calendar(日历工作窗口)',
+        status: 'degraded',
+        detail: '已挂载但 calendar 未配置 username——日历工具会话中会报「未配置」',
+        fix: `npx gotry setup calendar --off(恢复默认不挂载),或在 ${calProfilePatch} 覆盖 calendar 行 config 填 username(指引: npx gotry setup calendar --status)`
+    });
+    const mapCandidates = [
+        join(repoRoot, 'ts/dsh-runtime/node_modules/dsh-map-tools/lib/index.js'),
+        join(repoRoot, 'node_modules/dsh-map-tools/package.json'),
+        join(repoRoot, 'ts/node_modules/dsh-map-tools/package.json'),
+        join(home, '.dsh/profiles/web/node_modules/dsh-map-tools/package.json')
+    ];
+    const mapHit = mapCandidates.find((p)=>existsSync(p));
+    items.push(mapHit ? {
+        id: 'map-tools',
+        label: 'dsh-map-tools(地图/路线/POI)',
+        status: 'ok',
+        detail: `已就位(${mapHit})——地图工具可用(零 key,走 OSM/OSRM)`
+    } : {
+        id: 'map-tools',
+        label: 'dsh-map-tools(地图/路线/POI)',
+        status: 'missing',
+        detail: '未随包解析——启动时该 patch 条目被静默剔除,地图/路线/POI 工具不会出现在模型工具箱(缺地图不挡旅行规划,只少能力)',
+        fix: 'npx gotry doctor --fix 不覆盖此项:source 布局把 dsh-map-tools 放进 ts/dsh-runtime/node_modules(或 ts/node_modules);npm 布局重装 @danceiny/gotry(随发行版依赖提供)'
+    });
+    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(home, '.dsh/profiles/web/node_modules/@deepseek-ai/dsh-tool-ask-user/package.json')
+    ];
+    const askHit = askCandidates.find((p)=>existsSync(p));
+    items.push(askHit ? {
+        id: 'ask-user',
+        label: 'dsh-tool-ask-user(结构化澄清卡)',
+        status: 'ok',
+        detail: `已就位(${askHit})——ask_user_question 澄清卡可用(web 原生卡片;headless+TTY 用 stdio 提供方)`
+    } : {
+        id: 'ask-user',
+        label: 'dsh-tool-ask-user(结构化澄清卡)',
+        status: 'missing',
+        detail: '未解析——启动时澄清卡注入被静默剔除,模型只能散文追问(人格契约 (5) 退化文本形态)',
+        fix: '重装 @danceiny/gotry——该依赖随 dsh 闭包自带,缺失多为安装不完整'
+    });
+    items.push({
+        id: 'llm-key',
+        label: 'LLM key',
+        status: 'ok',
+        detail: '由 dsh 宿主 UI 管理——不在 doctor 体检范围(gotry 不接触、不回显凭证)'
+    });
+    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 gotry doctor --fix,或按各项 fix 指引逐项处理。`;
+    return {
+        ok: broken.length === 0,
+        items,
+        summary
+    };
+}
+const fixCell = (fix)=>!fix ? '—' : /^(npx|hbcli|curl|pip|python|\$)/.test(fix) ? `\`${fix}\`` : fix;
+export function renderDoctorReportMd(report, now = new Date()) {
+    const icon = (s)=>s === 'ok' ? '✅' : s === 'degraded' ? '⚠️' : '❌';
+    const lines = [
+        '# GoTry 依赖体检报告(doctor)',
+        '',
+        `> 生成于 ${now.toISOString()};重新生成:终端 \`npx gotry doctor\`,或在对话里让助手调 gotry_doctor。`,
+        '',
+        '| 状态 | 依赖 | 现状 | 修复指引 |',
+        '|---|---|---|---|',
+        ...report.items.map((i)=>`| ${icon(i.status)} | ${i.label} | ${i.detail} | ${fixCell(i.fix)} |`),
+        '',
+        `**结论**:${report.summary}`,
+        '',
+        '---',
+        '',
+        '- `npx gotry doctor` 随时可重跑(只读,不改任何东西);',
+        '- `npx gotry doctor --fix` 按上表补装(hbcli 官方脚本 / agent-reach pip / dsh-better-sidebar 插件);',
+        '- LLM key 由 dsh 宿主 UI 管理,gotry 永不体检、不回显。',
+        ''
+    ];
+    return lines.join('\n');
+}
+
+
+//# sourceURL=ts/capabilities/doctor.ts