xx-ai-cli 0.1.0

package/dist/core/router.js

@@ -0,0 +1,182 @@
+import chalk from 'chalk';
+import { config, PROVIDER_LABELS } from '../core/config.js';
+import { theme } from '../ui/renderer.js';
+// ─── 意图识别规则 ─────────────────────────────────────────────
+const INTENT_RULES = [
+    {
+        intent: 'search',
+        score: 0.9,
+        patterns: [
+            /搜索|查一下|查找|找找|最新|新闻|实时/,
+            /search|google|look up|find out|latest|news/i,
+            /^搜.{0,20}(吗|啊|呢|？|\?)?$/, // 去掉"查"开头的宽泛匹配
+        ],
+    },
+    {
+        intent: 'pkg_install',
+        score: 0.95,
+        patterns: [
+            /安装\s*(npm|包|库|插件|模块|package)/,
+            /npm install|pip install|brew install/i,
+            /install\s+[\w@/-]+/i,
+            /帮我装|帮我安装/,
+        ],
+    },
+    {
+        intent: 'shell',
+        score: 0.93, // 调高，避免被 search 抢走
+        patterns: [
+            /命令|shell|terminal|终端|如何用命令/,
+            /怎么.*命令|用什么命令|command/i,
+            /find|grep|chmod|mkdir|rm |ls |ps |kill|port|端口|进程|查看.*占用|被.*占用/,
+            /帮我.*命令|给.*命令/,
+        ],
+    },
+    {
+        intent: 'code_gen',
+        score: 0.88,
+        patterns: [
+            /写.*代码|生成.*代码|实现.*函数|写.*函数|写.*类|写.*脚本/,
+            /write.*code|generate.*code|implement|create.*function/i,
+            /帮我写|帮我实现|帮我生成/,
+            /用.*写.*[（(]|typescript|python|java|golang|rust|go\s+写/i,
+        ],
+    },
+    {
+        intent: 'code_explain',
+        score: 0.88,
+        patterns: [
+            /解释.*代码|解释.*这段|这段代码|代码.*什么意思|什么作用/,
+            /explain.*code|what does.*code|how does/i,
+            /看看这段|分析这段/,
+        ],
+    },
+    {
+        intent: 'code_review',
+        score: 0.88,
+        patterns: [
+            /review|代码审查|code review|审查代码|检查代码|有没有.*问题|bug/i,
+            /帮我.*看看.*代码|优化.*代码|改进.*代码/,
+        ],
+    },
+    {
+        intent: 'file',
+        score: 0.92,
+        patterns: [
+            /\.(ts|tsx|js|jsx|py|go|java|rs|cpp|c|json|yaml|yml|md|txt|sh|env)\b/,
+            /文件|file|读取|打开.*文件/,
+            /分析.*文件|看.*文件/,
+        ],
+    },
+    {
+        intent: 'agent',
+        score: 0.85,
+        patterns: [
+            /帮我完成|自动|一步步|帮我.*然后.*帮我|多个步骤/,
+            /复杂任务|多步|agent|自动化/,
+            /先.*再.*然后|并且.*同时/,
+            /项目.*创建|创建.*项目|初始化.*项目/,
+        ],
+    },
+];
+// ─── 关键词提取 ───────────────────────────────────────────────
+function extractArgs(input, intent) {
+    const args = {};
+    // 提取文件路径
+    const fileMatch = input.match(/\.\/[\w/.-]+|\/[\w/.-]+\.\w+/);
+    if (fileMatch)
+        args.filePath = fileMatch[0];
+    // 提取包名（npm install xxx）
+    const pkgMatch = input.match(/(?:安装|install)\s+([\w@/-]+(?:@[\w.^~-]+)?)/i);
+    if (pkgMatch)
+        args.packageName = pkgMatch[1];
+    // 提取搜索关键词（去掉指令词）
+    if (intent === 'search') {
+        args.query = input
+            .replace(/^(搜索|查一下|查找|帮我搜索|search|look up)/i, '')
+            .trim();
+    }
+    return args;
+}
+// ─── 识别意图 ─────────────────────────────────────────────────
+// 高优先意图：一旦命中任意一条 pattern，就覆盖 file 意图
+const CODE_INTENTS = new Set(['code_explain', 'code_gen', 'code_review']);
+export function detectIntent(input) {
+    const scores = {};
+    for (const rule of INTENT_RULES) {
+        const matchCount = rule.patterns.filter((p) => p.test(input)).length;
+        if (matchCount > 0) {
+            scores[rule.intent] = rule.score * (matchCount / rule.patterns.length + 0.5);
+        }
+    }
+    // 合并规则：代码类意图 + file 同时命中时，代码意图优先
+    if (scores['file'] !== undefined) {
+        for (const ci of CODE_INTENTS) {
+            if (scores[ci] !== undefined) {
+                delete scores['file'];
+                break;
+            }
+        }
+    }
+    let bestIntent = 'chat';
+    let bestScore = 0;
+    for (const [intent, score] of Object.entries(scores)) {
+        if (score > bestScore) {
+            bestScore = score;
+            bestIntent = intent;
+        }
+    }
+    return {
+        intent: bestIntent,
+        confidence: Math.min(bestScore, 1),
+        extractedArgs: extractArgs(input, bestIntent),
+    };
+}
+// ─── 意图标签 ─────────────────────────────────────────────────
+export const INTENT_LABELS = {
+    search: '🔍 联网搜索',
+    code_gen: '💻 代码生成',
+    code_explain: '📖 代码解释',
+    code_review: '🔬 Code Review',
+    file: '📄 文件分析',
+    shell: '🔧 命令建议',
+    pkg_install: '📦 安装包',
+    agent: '🤖 Agent 任务',
+    chat: '💬 对话',
+};
+// ─── 自动选择最优模型 ─────────────────────────────────────────
+// 不同任务对应最优模型（按优先级排列）
+const MODEL_PREFERENCE = {
+    code_gen: ['deepseek', 'qwen', 'glm', 'moonshot', 'doubao'],
+    code_explain: ['deepseek', 'qwen', 'glm', 'moonshot', 'doubao'],
+    code_review: ['deepseek', 'qwen', 'glm', 'moonshot', 'doubao'],
+    file: ['moonshot', 'qwen', 'deepseek', 'glm', 'doubao'],
+    agent: ['deepseek', 'qwen', 'moonshot', 'glm', 'doubao'],
+    search: ['glm', 'qwen', 'deepseek', 'moonshot', 'doubao'],
+    shell: ['deepseek', 'glm', 'qwen', 'moonshot', 'doubao'],
+    pkg_install: ['deepseek', 'glm', 'qwen', 'moonshot', 'doubao'],
+    chat: ['glm', 'qwen', 'deepseek', 'moonshot', 'doubao'],
+};
+export function selectBestModel(intent) {
+    const providers = config.get('providers');
+    const preference = MODEL_PREFERENCE[intent];
+    // 从偏好列表中找第一个已配置 API Key 的模型
+    for (const p of preference) {
+        if (providers[p]?.apiKey)
+            return p;
+    }
+    // 都没配置，返回默认
+    return config.get('defaultProvider');
+}
+// ─── 打印路由决策 ─────────────────────────────────────────────
+export function printRouteDecision(input, intentResult, selectedModel) {
+    const { intent, confidence } = intentResult;
+    const label = INTENT_LABELS[intent];
+    const modelLabel = PROVIDER_LABELS[selectedModel];
+    const confPct = (confidence * 100).toFixed(0);
+    console.log(`\n${theme.dim('┌─ 智能路由')} ${chalk.bold(label)} ` +
+        `${chalk.dim(`(置信度 ${confPct}%)`)} ` +
+        `${chalk.dim('→')} ${chalk.green(modelLabel)}`);
+    console.log(theme.dim('└─────────────────────────────────────'));
+}
+//# sourceMappingURL=router.js.map

package/dist/core/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/core/router.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,MAAM,EAAE,eAAe,EAAsC,MAAM,mBAAmB,CAAC;AAChG,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAwB1C,2DAA2D;AAC3D,MAAM,YAAY,GAIZ;IACF;QACE,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,GAAG;QACV,QAAQ,EAAE;YACR,uBAAuB;YACvB,6CAA6C;YAC7C,yBAAyB,EAAI,eAAe;SAC7C;KACF;IACD;QACE,MAAM,EAAE,aAAa;QACrB,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE;YACR,8BAA8B;YAC9B,uCAAuC;YACvC,qBAAqB;YACrB,UAAU;SACX;KACF;IACD;QACE,MAAM,EAAE,OAAO;QACf,KAAK,EAAE,IAAI,EAAI,mBAAmB;QAClC,QAAQ,EAAE;YACR,4BAA4B;YAC5B,uBAAuB;YACvB,gEAAgE;YAChE,cAAc;SACf;KACF;IACD;QACE,MAAM,EAAE,UAAU;QAClB,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE;YACR,sCAAsC;YACtC,wDAAwD;YACxD,eAAe;YACf,uDAAuD;SACxD;KACF;IACD;QACE,MAAM,EAAE,cAAc;QACtB,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE;YACR,kCAAkC;YAClC,yCAAyC;YACzC,WAAW;SACZ;KACF;IACD;QACE,MAAM,EAAE,aAAa;QACrB,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE;YACR,gDAAgD;YAChD,0BAA0B;SAC3B;KACF;IACD;QACE,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE;YACR,qEAAqE;YACrE,mBAAmB;YACnB,cAAc;SACf;KACF;IACD;QACE,MAAM,EAAE,OAAO;QACf,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE;YACR,6BAA6B;YAC7B,mBAAmB;YACnB,iBAAiB;YACjB,uBAAuB;SACxB;KACF;CACF,CAAC;AAEJ,4DAA4D;AAC5D,SAAS,WAAW,CAAC,KAAa,EAAE,MAAc;IAChD,MAAM,IAAI,GAAkC,EAAE,CAAC;IAE/C,SAAS;IACT,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC9D,IAAI,SAAS;QAAE,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAE5C,wBAAwB;IACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAC1B,6CAA6C,CAC9C,CAAC;IACF,IAAI,QAAQ;QAAE,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE7C,iBAAiB;IACjB,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,KAAK;aACf,OAAO,CAAC,mCAAmC,EAAE,EAAE,CAAC;aAChD,IAAI,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6DAA6D;AAC7D,qCAAqC;AACrC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAS,CAAC,cAAc,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;AAElF,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,MAAM,GAAoC,EAAE,CAAC;IAEnD,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACrE,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,SAAS,EAAE,CAAC;QACjC,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;YAC9B,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC7B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;gBACtB,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,UAAU,GAAW,MAAM,CAAC;IAChC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAuB,EAAE,CAAC;QAC3E,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;YACtB,SAAS,GAAG,KAAK,CAAC;YAClB,UAAU,GAAG,MAAM,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;QAClC,aAAa,EAAE,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,SAAS;IACnB,YAAY,EAAE,SAAS;IACvB,WAAW,EAAE,gBAAgB;IAC7B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,WAAW,EAAE,QAAQ;IACrB,KAAK,EAAE,aAAa;IACpB,IAAI,EAAE,OAAO;CACd,CAAC;AAEF,yDAAyD;AACzD,qBAAqB;AACrB,MAAM,gBAAgB,GAAoC;IACxD,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC;IAC3D,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC;IAC/D,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC;IAC9D,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAC;IACvD,KAAK,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAC;IACxD,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC;IACzD,KAAK,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC;IACxD,WAAW,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC;IAC9D,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC;CACxD,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAE5C,4BAA4B;IAC5B,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM;YAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,YAAY;IACZ,OAAO,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;AACvC,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,kBAAkB,CAChC,KAAa,EACb,YAA0B,EAC1B,aAA4B;IAE5B,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,YAAY,CAAC;IAC5C,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAE9C,OAAO,CAAC,GAAG,CACT,KAAK,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG;QACjD,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,OAAO,IAAI,CAAC,GAAG;QACpC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAC/C,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/dist/core/search.d.ts

@@ -0,0 +1,14 @@
+export interface SearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+}
+export interface SearchResponse {
+    query: string;
+    results: SearchResult[];
+    provider: string;
+}
+export declare function webSearch(query: string, maxResults?: number): Promise<SearchResponse>;
+/** 将搜索结果格式化为供 AI 读取的文本 */
+export declare function formatSearchResults(resp: SearchResponse): string;
+//# sourceMappingURL=search.d.ts.map

package/dist/core/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/core/search.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA2KD,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA0B3F;AAED,0BAA0B;AAC1B,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAMhE"}

package/dist/core/search.js

@@ -0,0 +1,179 @@
+import { config } from './config.js';
+// ─── DuckDuckGo HTML 搜索（无需 API Key，需要网络可访问）───────
+async function searchDuckDuckGo(query, maxResults) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 8000); // 8 秒超时
+    try {
+        // 先用 Instant Answer API 试一下
+        const iaUrl = `https://api.duckduckgo.com/?q=${encodeURIComponent(query)}&format=json&no_html=1&skip_disambig=1`;
+        const iaRes = await fetch(iaUrl, {
+            signal: controller.signal,
+            headers: { 'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36' },
+        });
+        clearTimeout(timeout);
+        if (iaRes.ok) {
+            const data = (await iaRes.json());
+            const results = [];
+            if (data.Abstract && data.AbstractURL) {
+                results.push({ title: data.AbstractSource ?? query, url: data.AbstractURL, snippet: data.Abstract });
+            }
+            for (const r of data.Results ?? []) {
+                if (r.Text && r.FirstURL && results.length < maxResults) {
+                    results.push({ title: r.Text.split(' - ')[0] ?? r.Text, url: r.FirstURL, snippet: r.Text });
+                }
+            }
+            for (const t of data.RelatedTopics ?? []) {
+                if (t.Text && t.FirstURL && results.length < maxResults) {
+                    results.push({ title: t.Name ?? t.Text.split(' - ')[0], url: t.FirstURL, snippet: t.Text });
+                }
+            }
+            if (results.length > 0)
+                return results.slice(0, maxResults);
+        }
+    }
+    catch {
+        clearTimeout(timeout);
+        // 网络不通，直接返回提示，不再尝试 HTML 搜索
+        return [{
+                title: '搜索不可用',
+                url: '',
+                snippet: `[搜索不可用] DuckDuckGo 无法访问（网络受限或未配置代理）。` +
+                    `请改用 xxcli search-config set serper --key <API_KEY> 配置搜索引擎，` +
+                    `或直接使用 xxcli install ${query.split(' ')[0]} 命令尝试安装。`,
+            }];
+    }
+    // Instant Answer 无结果时，改用 DDG HTML 搜索
+    try {
+        const htmlController = new AbortController();
+        const htmlTimeout = setTimeout(() => htmlController.abort(), 8000);
+        const htmlUrl = `https://html.duckduckgo.com/html/?q=${encodeURIComponent(query)}`;
+        const htmlRes = await fetch(htmlUrl, {
+            signal: htmlController.signal,
+            headers: {
+                'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+                'Accept': 'text/html',
+                'Accept-Language': 'zh-CN,zh;q=0.9,en;q=0.8',
+            },
+        });
+        clearTimeout(htmlTimeout);
+        if (!htmlRes.ok)
+            throw new Error(`HTTP ${htmlRes.status}`);
+        const html = await htmlRes.text();
+        const results = [];
+        const resultBlocks = html.match(/<a class="result__a"[^>]+href="([^"]+)"[^>]*>([^<]+)<\/a>[\s\S]*?<a class="result__snippet"[^>]*>([\s\S]*?)<\/a>/g) ?? [];
+        for (const block of resultBlocks) {
+            if (results.length >= maxResults)
+                break;
+            const urlMatch = block.match(/href="([^"]+)"/);
+            const titleMatch = block.match(/<a class="result__a"[^>]+>([^<]+)<\/a>/);
+            const snippetMatch = block.match(/<a class="result__snippet"[^>]*>([\s\S]*?)<\/a>/);
+            if (urlMatch && titleMatch) {
+                const url = urlMatch[1].startsWith('//') ? `https:${urlMatch[1]}` : urlMatch[1];
+                const snippet = snippetMatch ? snippetMatch[1].replace(/<[^>]+>/g, '').trim() : '';
+                results.push({ title: titleMatch[1].trim(), url, snippet: snippet.slice(0, 300) });
+            }
+        }
+        if (results.length > 0)
+            return results.slice(0, maxResults);
+    }
+    catch { /* HTML 搜索也失败，走兜底 */ }
+    // 最终兜底
+    return [{
+            title: '搜索无结果',
+            url: `https://duckduckgo.com/?q=${encodeURIComponent(query)}`,
+            snippet: `搜索 "${query}" 无结果。建议配置 Serper 或 Tavily 获得更好的搜索效果：xxcli search-config set serper --key <API_KEY>`,
+        }];
+}
+// ─── Serper（Google Search API，需要 API Key）────────────────
+async function searchSerper(query, apiKey, maxResults) {
+    const res = await fetch('https://google.serper.dev/search', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'X-API-KEY': apiKey,
+        },
+        body: JSON.stringify({ q: query, num: maxResults, gl: 'cn', hl: 'zh-cn' }),
+    });
+    if (!res.ok)
+        throw new Error(`Serper 请求失败 [${res.status}]`);
+    const data = (await res.json());
+    const results = [];
+    if (data.answerBox) {
+        results.push({
+            title: data.answerBox.title,
+            url: data.answerBox.link,
+            snippet: data.answerBox.snippet,
+        });
+    }
+    for (const item of data.organic ?? []) {
+        if (results.length >= maxResults)
+            break;
+        results.push({ title: item.title, url: item.link, snippet: item.snippet });
+    }
+    return results;
+}
+// ─── Tavily（AI-optimized search，需要 API Key）───────────────
+async function searchTavily(query, apiKey, maxResults) {
+    const res = await fetch('https://api.tavily.com/search', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            api_key: apiKey,
+            query,
+            max_results: maxResults,
+            include_answer: true,
+            search_depth: 'basic',
+        }),
+    });
+    if (!res.ok)
+        throw new Error(`Tavily 请求失败 [${res.status}]`);
+    const data = (await res.json());
+    const results = [];
+    if (data.answer) {
+        results.push({ title: '综合答案', url: '', snippet: data.answer });
+    }
+    for (const item of data.results ?? []) {
+        if (results.length >= maxResults)
+            break;
+        results.push({ title: item.title, url: item.url, snippet: item.content.slice(0, 300) });
+    }
+    return results;
+}
+// ─── 主搜索入口 ───────────────────────────────────────────────
+export async function webSearch(query, maxResults) {
+    const searchCfg = config.get('search');
+    const limit = maxResults ?? searchCfg.maxResults;
+    const provider = searchCfg.provider;
+    let results = [];
+    try {
+        if (provider === 'serper' && searchCfg.apiKey) {
+            results = await searchSerper(query, searchCfg.apiKey, limit);
+        }
+        else if (provider === 'tavily' && searchCfg.apiKey) {
+            results = await searchTavily(query, searchCfg.apiKey, limit);
+        }
+        else {
+            // 默认 DuckDuckGo，无需 key
+            results = await searchDuckDuckGo(query, limit);
+        }
+    }
+    catch (err) {
+        // 降级到 DuckDuckGo
+        if (provider !== 'duckduckgo') {
+            results = await searchDuckDuckGo(query, limit);
+        }
+        else {
+            throw err;
+        }
+    }
+    return { query, results, provider };
+}
+/** 将搜索结果格式化为供 AI 读取的文本 */
+export function formatSearchResults(resp) {
+    if (!resp.results.length)
+        return `搜索 "${resp.query}" 无结果`;
+    return resp.results
+        .map((r, i) => `[${i + 1}] ${r.title}\n${r.url ? `URL: ${r.url}\n` : ''}${r.snippet}`)
+        .join('\n\n');
+}
+//# sourceMappingURL=search.js.map

package/dist/core/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/core/search.ts"],"names":[],"mappings":"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"}

package/dist/core/session.d.ts

@@ -0,0 +1,38 @@
+export interface Message {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    tool_calls?: unknown[];
+    tool_call_id?: string;
+}
+export interface PersistedSession {
+    id: string;
+    title: string;
+    model: string;
+    createdAt: string;
+    updatedAt: string;
+    messages: Message[];
+}
+export declare function loadAllSessions(): PersistedSession[];
+export declare function loadSessionById(id: string): PersistedSession | null;
+export declare function deleteSession(id: string): boolean;
+export declare class Session {
+    messages: Message[];
+    private systemPrompt;
+    private persistId;
+    private model;
+    private savedToHistory;
+    constructor(systemPrompt?: string, model?: string);
+    /** 从已有持久化会话恢复（用于 history resume） */
+    static fromPersisted(data: PersistedSession): Session;
+    addUser(content: string): void;
+    addAssistant(content: string, toolCalls?: unknown[]): void;
+    addToolResult(toolCallId: string, content: string): void;
+    getMessages(): Message[];
+    clear(): void;
+    get length(): number;
+    trim(maxPairs?: number): void;
+    /** 持久化当前会话到磁盘（仅当有 user+assistant 对话时才保存）*/
+    persist(): void;
+    setModel(model: string): void;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/core/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAGD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAaD,wBAAgB,eAAe,IAAI,gBAAgB,EAAE,CAepD;AAGD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CASnE;AAoDD,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAKjD;AAGD,qBAAa,OAAO;IAClB,QAAQ,EAAE,OAAO,EAAE,CAAM;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,cAAc,CAAkB;gBAE5B,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAkB;IAsB5D,oCAAoC;IACpC,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;IAOrD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI;IAI1D,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIxD,WAAW,IAAI,OAAO,EAAE;IAIxB,KAAK,IAAI,IAAI;IAIb,IAAI,MAAM,IAAI,MAAM,CAEnB;IAGD,IAAI,CAAC,QAAQ,SAAK,GAAG,IAAI;IAMzB,2CAA2C;IAC3C,OAAO,IAAI,IAAI;IAoBf,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAG9B"}

package/dist/core/session.js

@@ -0,0 +1,172 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+// ─── 历史存储路径 ──────────────────────────────────────────────
+const HISTORY_DIR = path.join(os.homedir(), '.config', 'ai-cli', 'history');
+const MAX_HISTORY_FILES = 50; // 最多保留最近 50 条会话
+function ensureHistoryDir() {
+    if (!fs.existsSync(HISTORY_DIR)) {
+        fs.mkdirSync(HISTORY_DIR, { recursive: true });
+    }
+}
+// ─── 读取所有历史会话（按时间倒序）───────────────────────────
+export function loadAllSessions() {
+    ensureHistoryDir();
+    const files = fs.readdirSync(HISTORY_DIR)
+        .filter((f) => f.endsWith('.json'))
+        .sort()
+        .reverse(); // 最新的在前
+    return files.map((f) => {
+        try {
+            const raw = fs.readFileSync(path.join(HISTORY_DIR, f), 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }).filter(Boolean);
+}
+// ─── 按 ID 加载单条会话 ────────────────────────────────────────
+export function loadSessionById(id) {
+    ensureHistoryDir();
+    const filePath = path.join(HISTORY_DIR, `${id}.json`);
+    if (!fs.existsSync(filePath))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+// ─── 保存单条会话 ─────────────────────────────────────────────
+function saveSession(data) {
+    ensureHistoryDir();
+    fs.writeFileSync(path.join(HISTORY_DIR, `${data.id}.json`), JSON.stringify(data, null, 2), 'utf-8');
+    pruneOldSessions();
+}
+// ─── 清理超出上限的旧会话 ──────────────────────────────────────
+function pruneOldSessions() {
+    const files = fs.readdirSync(HISTORY_DIR)
+        .filter((f) => f.endsWith('.json'))
+        .sort(); // 最旧的在前
+    if (files.length > MAX_HISTORY_FILES) {
+        files.slice(0, files.length - MAX_HISTORY_FILES).forEach((f) => {
+            fs.unlinkSync(path.join(HISTORY_DIR, f));
+        });
+    }
+}
+// ─── 敏感信息脱敏（防止 key 被意外存入历史）─────────────────
+// 匹配常见 API Key 格式：sk-xxx / Bearer xxx / 纯随机长字符串
+const SENSITIVE_PATTERNS = [
+    /sk-[A-Za-z0-9]{16,}/g, // OpenAI / DeepSeek / Moonshot 风格
+    /Bearer\s+[A-Za-z0-9\-_.]{16,}/gi, // Authorization header
+    /[A-Za-z0-9]{32,}\.[A-Za-z0-9]{16,}/g, // GLM 风格（含点号）
+    /eyJ[A-Za-z0-9_\-.]{20,}/g, // JWT token
+];
+function redactSensitive(text) {
+    let result = text;
+    for (const pattern of SENSITIVE_PATTERNS) {
+        result = result.replace(pattern, (match) => {
+            return `${match.slice(0, 6)}${'*'.repeat(8)}[REDACTED]`;
+        });
+    }
+    return result;
+}
+function redactMessages(messages) {
+    return messages.map((m) => ({
+        ...m,
+        content: redactSensitive(m.content),
+    }));
+}
+// ─── 删除会话 ──────────────────────────────────────────────────
+export function deleteSession(id) {
+    const filePath = path.join(HISTORY_DIR, `${id}.json`);
+    if (!fs.existsSync(filePath))
+        return false;
+    fs.unlinkSync(filePath);
+    return true;
+}
+// ─── Session 类 ───────────────────────────────────────────────
+export class Session {
+    messages = [];
+    systemPrompt;
+    persistId;
+    model;
+    savedToHistory = false;
+    constructor(systemPrompt, model = 'unknown') {
+        this.systemPrompt =
+            systemPrompt ??
+                `你是 XX-AI-CLI 的内置智能助手，运行在用户的命令行终端中。
+
+## 你的能力边界
+你不仅能回答问题，还能直接调用本工具的以下内置功能：
+- **安装工具**：用户说"安装 openclaw"、"帮我装 xxx" → 告知用户运行 \`xxcli install openclaw\`
+- **搜索包**：用户说"搜索/查找 xxx 包" → 告知用户运行 \`xxcli pkg search xxx\`
+- **Shell 命令**：用户说"怎么删除文件夹" → 直接给出 Shell 命令
+- **代码生成**：用户说"帮我写..." → 直接生成代码
+- **文件分析**：用户说"分析这个文件" → 告知用户运行 \`xxcli file <路径> "问题"\`
+
+## 重要原则
+- 对于"安装 openclaw"这类需求，**不要说做不到**，要告知用户使用 \`xxcli install openclaw\` 命令，本工具内置了安装功能
+- 回答简洁清晰，优先用中文
+- 涉及终端操作时，直接给出可执行的命令`;
+        this.model = model;
+        // ID = 时间戳，保证文件名可排序
+        this.persistId = Date.now().toString();
+    }
+    /** 从已有持久化会话恢复（用于 history resume） */
+    static fromPersisted(data) {
+        const s = new Session(undefined, data.model);
+        s.messages = data.messages;
+        s.persistId = data.id; // 复用原 ID，更新同一文件
+        return s;
+    }
+    addUser(content) {
+        this.messages.push({ role: 'user', content });
+    }
+    addAssistant(content, toolCalls) {
+        this.messages.push({ role: 'assistant', content, ...(toolCalls ? { tool_calls: toolCalls } : {}) });
+    }
+    addToolResult(toolCallId, content) {
+        this.messages.push({ role: 'tool', content, tool_call_id: toolCallId });
+    }
+    getMessages() {
+        return [{ role: 'system', content: this.systemPrompt }, ...this.messages];
+    }
+    clear() {
+        this.messages = [];
+    }
+    get length() {
+        return this.messages.length;
+    }
+    // 限制历史长度，避免 token 超限
+    trim(maxPairs = 20) {
+        if (this.messages.length > maxPairs * 2) {
+            this.messages = this.messages.slice(-maxPairs * 2);
+        }
+    }
+    /** 持久化当前会话到磁盘（仅当有 user+assistant 对话时才保存）*/
+    persist() {
+        const hasDialog = this.messages.some((m) => m.role === 'user') &&
+            this.messages.some((m) => m.role === 'assistant');
+        if (!hasDialog)
+            return;
+        const firstUser = this.messages.find((m) => m.role === 'user')?.content ?? '';
+        const title = firstUser.slice(0, 40).replace(/\n/g, ' ') + (firstUser.length > 40 ? '…' : '');
+        const now = new Date().toISOString();
+        saveSession({
+            id: this.persistId,
+            title,
+            model: this.model,
+            createdAt: this.savedToHistory ? '' : now,
+            updatedAt: now,
+            messages: redactMessages(this.messages), // 存储前自动脱敏
+        });
+        this.savedToHistory = true;
+    }
+    setModel(model) {
+        this.model = model;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/core/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"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"}

package/dist/core/stream.d.ts

@@ -0,0 +1,15 @@
+import type { ModelConfig } from './config.js';
+import type { Message } from './session.js';
+import type { ToolCall } from './tools.js';
+export interface ChatOptions {
+    stream?: boolean;
+    onChunk?: (chunk: string) => void;
+    tools?: object[];
+}
+export interface ChatResponse {
+    content: string;
+    toolCalls?: ToolCall[];
+    finishReason?: string;
+}
+export declare function chat(modelConfig: ModelConfig, messages: Message[], options?: ChatOptions): Promise<ChatResponse>;
+//# sourceMappingURL=stream.d.ts.map

package/dist/core/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/core/stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,IAAI,CACxB,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,YAAY,CAAC,CA+HvB"}