deeper-cli 1.0.0

package/src/tools/builtin/network/web_search.ts

@@ -0,0 +1,128 @@
+import type { Tool } from '../../tool-types.js';
+
+export const web_search: Tool = {
+  name: 'web_search',
+  description: '使用 Bing 搜索引擎查询，返回真实搜索结果摘要',
+  category: 'network',
+  parameters: {
+    type: 'object',
+    properties: {
+      query: { type: 'string', description: '搜索查询关键词' },
+      count: { type: 'number', description: '返回结果数 (默认 5, 最多 10)' },
+    },
+    required: ['query'],
+  },
+  dangerous: false,
+  requiresApproval: false,
+  async execute(params) {
+    try {
+      const query = params.query as string;
+      const count = Math.min((params.count as number) ?? 5, 10);
+      const encoded = encodeURIComponent(query);
+      const url = `https://www.bing.com/search?q=${encoded}&count=${count}`;
+
+      const resp = await fetch(url, {
+        headers: {
+          'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36',
+          'Accept': 'text/html,application/xhtml+xml',
+          'Accept-Language': 'zh-CN,zh;q=0.9,en;q=0.8',
+        },
+        signal: AbortSignal.timeout(12000),
+      });
+
+      if (!resp.ok) {
+        return { success: false, error: `Bing 搜索失败: HTTP ${resp.status}`, output: '' };
+      }
+
+      const html = await resp.text();
+      const results = extractBingResults(html, count);
+
+      if (results.length === 0) {
+        return {
+          success: true,
+          output: `Bing 搜索 "${query}" — 未提取到结果\n直接访问: ${url}`,
+          metadata: { query, engine: 'bing', url },
+        };
+      }
+
+      const lines = [`Bing 搜索: "${query}"`, ''];
+      for (let i = 0; i < results.length; i++) {
+        const r = results[i];
+        lines.push(`${i + 1}. ${r.title}`);
+        lines.push(`   ${r.snippet}`);
+        lines.push(`   ${r.url}`);
+        lines.push('');
+      }
+
+      return {
+        success: true,
+        output: lines.join('\n'),
+        metadata: { query, engine: 'bing', count: results.length },
+      };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};
+
+interface SearchResult {
+  title: string;
+  url: string;
+  snippet: string;
+}
+
+function extractBingResults(html: string, maxCount: number): SearchResult[] {
+  const results: SearchResult[] = [];
+
+  // Bing 搜索结果在 <li class="b_algo"> 或 <div class="b_caption"> 中
+  const algoRegex = /<li class="b_algo"[^>]*>([\s\S]*?)<\/li>/gi;
+  const matches = html.match(algoRegex);
+
+  if (matches) {
+    for (const block of matches.slice(0, maxCount)) {
+      const r = parseAlgoBlock(block);
+      if (r) results.push(r);
+    }
+  }
+
+  // 回退: 直接抓标题链接
+  if (results.length === 0) {
+    const linkRegex = /<h2[^>]*><a[^>]*href="(https?:\/\/(?!www\.bing\.com)[^"]+)"[^>]*>([\s\S]*?)<\/a><\/h2>/gi;
+    let m;
+    while ((m = linkRegex.exec(html)) !== null && results.length < maxCount) {
+      const url = m[1]!.replace(/&amp;/g, '&');
+      const title = m[2]!.replace(/<[^>]+>/g, '').replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"').trim();
+      const snippet = extractSnippet(html, url);
+      results.push({ title: title.slice(0, 120), url: url.slice(0, 200), snippet: snippet.slice(0, 200) });
+    }
+  }
+
+  return results;
+}
+
+function parseAlgoBlock(block: string): SearchResult | null {
+  const titleMatch = block.match(/<h2[^>]*><a[^>]*href="([^"]+)"[^>]*>([\s\S]*?)<\/a><\/h2>/i);
+  if (!titleMatch) return null;
+
+  const url = titleMatch[1]!.replace(/&amp;/g, '&').slice(0, 200);
+  const title = titleMatch[2]!.replace(/<[^>]+>/g, '').replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"').trim();
+
+  // 尝试多种摘要容器
+  const snippetMatch = block.match(/<p[^>]*class="[^"]*b_lineclamp[^"]*"[^>]*>([\s\S]*?)<\/p>/i)
+    || block.match(/<div class="b_caption"[^>]*>\s*<p[^>]*>([\s\S]*?)<\/p>/i)
+    || block.match(/<p[^>]*>([\s\S]*?)<\/p>/i);
+
+  const snippet = snippetMatch
+    ? snippetMatch[1]!.replace(/<[^>]+>/g, '').replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"').trim()
+    : '';
+
+  return { title: title.slice(0, 120), url, snippet: snippet.slice(0, 200) };
+}
+
+function extractSnippet(html: string, _url: string): string {
+  // 简单回退: 找标题附近的文本
+  const idx = html.indexOf(_url) + _url.length;
+  const nearby = html.slice(idx, idx + 500);
+  const text = nearby.replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim();
+  return text.slice(0, 200);
+}

package/src/tools/builtin/network/websocket_connect.ts

@@ -0,0 +1,70 @@
+import type { Tool } from '../../tool-types.js';
+
+let activeWs: import('ws').WebSocket | null = null;
+
+export const websocket_connect: Tool = {
+  name: 'websocket_connect',
+  description: '建立 WebSocket 连接',
+  category: 'network',
+  parameters: {
+    type: 'object',
+    properties: {
+      url: { type: 'string', description: 'WebSocket URL (ws:// 或 wss://)' },
+      message: { type: 'string', description: '要发送的消息' },
+      timeout_ms: { type: 'number', description: '连接超时毫秒数' },
+    },
+    required: ['url'],
+  },
+  dangerous: false,
+  requiresApproval: true,
+  async execute(params) {
+    try {
+      const url = params.url as string;
+      const message = params.message as string | undefined;
+      const timeout = (params.timeout_ms as number) ?? 10000;
+
+      const WS = await import('ws');
+      const ws = new WS.WebSocket(url);
+
+      const result = await new Promise<{ success: boolean; output: string }>((resolve, reject) => {
+        const timer = setTimeout(() => {
+          ws.close();
+          reject(new Error('WebSocket 连接超时'));
+        }, timeout);
+
+        let response = '';
+
+        ws.on('open', () => {
+          response += `已连接: ${url}\n`;
+          if (message) {
+            ws.send(message);
+            response += `已发送: ${message}\n`;
+          }
+        });
+
+        ws.on('message', (data: Buffer) => {
+          response += `收到: ${data.toString('utf-8')}\n`;
+          clearTimeout(timer);
+          ws.close();
+          resolve({ success: true, output: response });
+        });
+
+        ws.on('error', (err: Error) => {
+          clearTimeout(timer);
+          reject(err);
+        });
+
+        ws.on('close', () => {
+          clearTimeout(timer);
+          if (response) {
+            resolve({ success: true, output: response + '\n连接已关闭' });
+          }
+        });
+      });
+
+      return result;
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/project/build_project.ts

@@ -0,0 +1,68 @@
+import { execSync } from 'node:child_process';
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const build_project: Tool = {
+  name: 'build_project',
+  description: '构建项目',
+  category: 'project',
+  parameters: {
+    type: 'object',
+    properties: {
+      cwd: { type: 'string', description: '项目目录' },
+      target: { type: 'string', description: '构建目标: dev, prod, dist', enum: ['dev', 'prod', 'dist'] },
+      tool: { type: 'string', description: '构建工具: auto, tsup, vite, webpack', enum: ['auto', 'tsup', 'vite', 'webpack'] },
+    },
+    required: [],
+  },
+  dangerous: false,
+  requiresApproval: true,
+  async execute(params) {
+    try {
+      const cwd = (params.cwd as string) ?? process.cwd();
+      const target = (params.target as string) ?? 'prod';
+      const tool = (params.tool as string) ?? 'auto';
+
+      let cmd = '';
+      const pkgPath = resolve(cwd, 'package.json');
+
+      if (tool === 'auto' && existsSync(pkgPath)) {
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+        const scripts = pkg.scripts || {};
+        if (scripts.build) cmd = `npm run build`;
+        else if (scripts.compile) cmd = `npm run compile`;
+        else if (scripts.bundle) cmd = `npm run bundle`;
+        else cmd = `npx tsup src/index.ts --format esm`;
+      } else {
+        switch (tool) {
+          case 'tsup': cmd = 'npx tsup src/index.ts --format esm'; break;
+          case 'vite': cmd = 'npx vite build'; break;
+          case 'webpack': cmd = 'npx webpack --mode production'; break;
+          default: cmd = 'npm run build';
+        }
+      }
+
+      const output = execSync(cmd, {
+        cwd,
+        encoding: 'utf-8',
+        timeout: 180000,
+        maxBuffer: 50 * 1024 * 1024,
+        stdio: 'pipe',
+      });
+
+      return {
+        success: true,
+        output: `构建完成\n${output.slice(0, 10000)}`,
+        metadata: { cwd, tool, command: cmd },
+      };
+    } catch (err: unknown) {
+      const e = err as { message?: string; stdout?: string; stderr?: string };
+      return {
+        success: false,
+        error: '构建失败: ' + (e.message || String(err)),
+        output: (e.stdout || '') + (e.stderr || ''),
+      };
+    }
+  },
+};

package/src/tools/builtin/project/config_manage.ts

@@ -0,0 +1,99 @@
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const config_manage: Tool = {
+  name: 'config_manage',
+  description: '管理项目配置文件',
+  category: 'project',
+  parameters: {
+    type: 'object',
+    properties: {
+      action: { type: 'string', description: '操作: read, set, list, init', enum: ['read', 'set', 'list', 'init'] },
+      file_path: { type: 'string', description: '配置文件路径 (.json, .yaml, .env, .toml)' },
+      key: { type: 'string', description: '配置键名' },
+      value: { type: 'string', description: '配置值' },
+    },
+    required: ['action'],
+  },
+  dangerous: false,
+  requiresApproval: true,
+  async execute(params) {
+    try {
+      const action = params.action as string;
+      const filePath = params.file_path as string | undefined;
+      const key = params.key as string | undefined;
+      const value = params.value as string | undefined;
+
+      if (action === 'list') {
+        const configs = [
+          '.env', '.env.local', '.env.development', '.env.production',
+          'package.json', 'tsconfig.json', '.eslintrc.json', '.prettierrc',
+        ];
+        const cwd = process.cwd();
+        const found = configs.filter(f => existsSync(resolve(cwd, f)));
+        return {
+          success: true,
+          output: `项目配置文件:\n${found.map(f => `  ${f}`).join('\n') || '  (未找到)'}`,
+          metadata: { files: found },
+        };
+      }
+
+      if (action === 'init') {
+        const defaultEnv = `# DeeperCode 配置文件\nNODE_ENV=development\n`;
+        writeFileSync(resolve(process.cwd(), '.env'), defaultEnv, 'utf-8');
+        return { success: true, output: '已创建 .env 配置文件' };
+      }
+
+      if (!filePath) {
+        return { success: false, error: '缺少 file_path 参数', output: '' };
+      }
+
+      const abs = resolve(filePath);
+      if (!existsSync(abs)) {
+        return { success: false, error: `配置文件不存在: ${abs}`, output: '' };
+      }
+
+      if (action === 'read') {
+        const content = readFileSync(abs, 'utf-8');
+        if (filePath.endsWith('.json')) {
+          const parsed = JSON.parse(content);
+          if (key) {
+            return {
+              success: true,
+              output: `${key}: ${JSON.stringify((parsed as Record<string, unknown>)[key])}`,
+            };
+          }
+          return { success: true, output: JSON.stringify(parsed, null, 2) };
+        }
+        return { success: true, output: content.slice(0, 10000) };
+      }
+
+      if (action === 'set' && key && value !== undefined) {
+        if (filePath.endsWith('.json')) {
+          const parsed = JSON.parse(readFileSync(abs, 'utf-8'));
+          try { parsed[key] = JSON.parse(value); } catch { parsed[key] = value; }
+          writeFileSync(abs, JSON.stringify(parsed, null, 2), 'utf-8');
+        } else {
+          const content = readFileSync(abs, 'utf-8');
+          const lines = content.split('\n');
+          let found = false;
+          for (let i = 0; i < lines.length; i++) {
+            if (lines[i].startsWith(`${key}=`)) {
+              lines[i] = `${key}=${value}`;
+              found = true;
+              break;
+            }
+          }
+          if (!found) lines.push(`${key}=${value}`);
+          writeFileSync(abs, lines.join('\n'), 'utf-8');
+        }
+        return { success: true, output: `已设置: ${key} = ${value}` };
+      }
+
+      return { success: false, error: `不支持的操作组合: ${action}`, output: '' };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/project/coverage_report.ts

@@ -0,0 +1,59 @@
+import { execSync } from 'node:child_process';
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const coverage_report: Tool = {
+  name: 'coverage_report',
+  description: '生成代码覆盖报告',
+  category: 'project',
+  parameters: {
+    type: 'object',
+    properties: {
+      cwd: { type: 'string', description: '项目目录' },
+      runner: { type: 'string', description: '测试运行器', enum: ['vitest', 'jest', 'nyc'] },
+      format: { type: 'string', description: '报告格式: text, html, json, lcov', enum: ['text', 'html', 'json', 'lcov'] },
+    },
+    required: [],
+  },
+  dangerous: false,
+  requiresApproval: false,
+  async execute(params) {
+    try {
+      const cwd = (params.cwd as string) ?? process.cwd();
+      const runner = (params.runner as string) ?? 'vitest';
+      const format = (params.format as string) ?? 'text';
+
+      let cmd = '';
+      switch (runner) {
+        case 'vitest': cmd = `npx vitest run --coverage --reporter=${format}`; break;
+        case 'jest': cmd = `npx jest --coverage`; break;
+        case 'nyc': cmd = `npx nyc --reporter=${format} npm test`; break;
+      }
+
+      try {
+        const output = execSync(cmd, {
+          cwd,
+          encoding: 'utf-8',
+          timeout: 180000,
+          maxBuffer: 50 * 1024 * 1024,
+          stdio: 'pipe',
+        });
+        return {
+          success: true,
+          output: `覆盖报告:\n${output.slice(0, 10000)}`,
+          metadata: { runner, format, cwd },
+        };
+      } catch (err: unknown) {
+        const e = err as { stdout?: string; stderr?: string };
+        return {
+          success: false,
+          error: '覆盖报告生成失败',
+          output: (e.stdout || '') + (e.stderr || ''),
+        };
+      }
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/project/docker_manage.ts

@@ -0,0 +1,90 @@
+import { execSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const docker_manage: Tool = {
+  name: 'docker_manage',
+  description: 'Docker 容器管理',
+  category: 'project',
+  parameters: {
+    type: 'object',
+    properties: {
+      action: { type: 'string', description: '操作: build, run, stop, ps, logs, compose_up, compose_down, pull', enum: ['build', 'run', 'stop', 'ps', 'logs', 'compose_up', 'compose_down', 'pull'] },
+      image: { type: 'string', description: '镜像名' },
+      container: { type: 'string', description: '容器名' },
+      cwd: { type: 'string', description: '工作目录' },
+      ports: { type: 'string', description: '端口映射' },
+      options: { type: 'string', description: '附加选项' },
+    },
+    required: ['action'],
+  },
+  dangerous: false,
+  requiresApproval: true,
+  async execute(params) {
+    try {
+      const action = params.action as string;
+      const image = params.image as string | undefined;
+      const container = params.container as string | undefined;
+      const cwd = (params.cwd as string) ?? process.cwd();
+      const ports = params.ports as string | undefined;
+      const options = params.options as string ?? '';
+
+      let cmd = '';
+
+      switch (action) {
+        case 'build': {
+          const dockerfile = resolve(cwd, 'Dockerfile');
+          if (!existsSync(dockerfile)) {
+            return { success: false, error: `Dockerfile 不存在: ${dockerfile}`, output: '' };
+          }
+          cmd = `docker build ${options} -t ${image || 'app'} .`;
+          break;
+        }
+        case 'run':
+          cmd = `docker run ${ports ? `-p ${ports}` : ''} ${options} ${image || 'app'}`;
+          break;
+        case 'stop':
+          cmd = `docker stop ${container || ''}`;
+          break;
+        case 'ps':
+          cmd = 'docker ps -a';
+          break;
+        case 'logs':
+          cmd = `docker logs ${container || ''}`;
+          break;
+        case 'compose_up':
+          cmd = 'docker-compose up -d';
+          break;
+        case 'compose_down':
+          cmd = 'docker-compose down';
+          break;
+        case 'pull':
+          cmd = `docker pull ${image || ''}`;
+          break;
+        default:
+          return { success: false, error: `不支持的操作: ${action}`, output: '' };
+      }
+
+      try {
+        const output = execSync(cmd, {
+          cwd,
+          encoding: 'utf-8',
+          timeout: 120000,
+          maxBuffer: 10 * 1024 * 1024,
+          stdio: 'pipe',
+        });
+        return { success: true, output: output || `${action} 完成`, metadata: { action } };
+      } catch (err: unknown) {
+        const e = err as { message?: string; stdout?: string; stderr?: string };
+        return {
+          success: false,
+          error: `Docker 操作失败: ${e.message || String(err)}`,
+          output: (e.stdout || '') + (e.stderr || ''),
+        };
+      }
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/project/env_manage.ts

@@ -0,0 +1,88 @@
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const env_manage: Tool = {
+  name: 'env_manage',
+  description: '管理环境变量文件',
+  category: 'project',
+  parameters: {
+    type: 'object',
+    properties: {
+      action: { type: 'string', description: '操作: read, set, remove, list_envs', enum: ['read', 'set', 'remove', 'list_envs'] },
+      file_path: { type: 'string', description: '.env 文件路径' },
+      key: { type: 'string', description: '环境变量名' },
+      value: { type: 'string', description: '环境变量值' },
+    },
+    required: ['action'],
+  },
+  dangerous: false,
+  requiresApproval: true,
+  async execute(params) {
+    try {
+      const action = params.action as string;
+      const filePath = (params.file_path as string) ?? '.env';
+      const key = params.key as string | undefined;
+      const value = params.value as string | undefined;
+
+      const abs = resolve(filePath);
+
+      if (action === 'list_envs') {
+        const cwd = process.cwd();
+        const envs = ['.env', '.env.local', '.env.development', '.env.production', '.env.test'];
+        const found = envs.filter(f => existsSync(resolve(cwd, f)));
+        return {
+          success: true,
+          output: found.join('\n') || '未找到 .env 文件',
+          metadata: { files: found },
+        };
+      }
+
+      if (!existsSync(abs)) {
+        if (action === 'set' && key && value !== undefined) {
+          writeFileSync(abs, `${key}=${value}`, 'utf-8');
+          return { success: true, output: `已创建 ${filePath} 并设置 ${key}=${value}` };
+        }
+        return { success: false, error: `文件不存在: ${abs}`, output: '' };
+      }
+
+      const content = readFileSync(abs, 'utf-8');
+      const lines = content.split('\n');
+
+      if (action === 'read') {
+        if (key) {
+          const found = lines.find(l => l.startsWith(`${key}=`));
+          return {
+            success: true,
+            output: found ? found.slice(key.length + 1) : `未找到 ${key}`,
+          };
+        }
+        return { success: true, output: content };
+      }
+
+      if (action === 'set' && key && value !== undefined) {
+        let found = false;
+        for (let i = 0; i < lines.length; i++) {
+          if (lines[i].startsWith(`${key}=`) || lines[i].startsWith(`# ${key}=`)) {
+            lines[i] = `${key}=${value}`;
+            found = true;
+            break;
+          }
+        }
+        if (!found) lines.push(`${key}=${value}`);
+        writeFileSync(abs, lines.join('\n'), 'utf-8');
+        return { success: true, output: `已设置 ${key}=${value}` };
+      }
+
+      if (action === 'remove' && key) {
+        const filtered = lines.filter(l => !l.startsWith(`${key}=`));
+        writeFileSync(abs, filtered.join('\n'), 'utf-8');
+        return { success: true, output: `已移除 ${key}` };
+      }
+
+      return { success: false, error: `不支持的操作: ${action}`, output: '' };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/project/npm_manage.ts

@@ -0,0 +1,71 @@
+import { execSync } from 'node:child_process';
+import type { Tool } from '../../tool-types.js';
+
+export const npm_manage: Tool = {
+  name: 'npm_manage',
+  description: '管理 npm 包（安装、更新、删除、查看）',
+  category: 'project',
+  parameters: {
+    type: 'object',
+    properties: {
+      action: { type: 'string', description: '操作: install, update, remove, list, audit, init', enum: ['install', 'update', 'remove', 'list', 'audit', 'init'] },
+      package: { type: 'string', description: '包名（install/remove/update 时使用）' },
+      cwd: { type: 'string', description: '工作目录' },
+      dev: { type: 'boolean', description: '是否安装为 devDependencies' },
+      global: { type: 'boolean', description: '是否全局安装' },
+    },
+    required: ['action'],
+  },
+  dangerous: false,
+  requiresApproval: true,
+  async execute(params) {
+    try {
+      const action = params.action as string;
+      const pkg = params.package as string | undefined;
+      const cwd = (params.cwd as string) ?? process.cwd();
+      const dev = (params.dev as boolean) ?? false;
+      const global = (params.global as boolean) ?? false;
+
+      const registry = 'https://registry.npmmirror.com';
+      let cmd = '';
+
+      switch (action) {
+        case 'install':
+          cmd = `npm install ${pkg || ''} ${dev ? '-D' : ''} ${global ? '-g' : ''} --registry ${registry}`;
+          break;
+        case 'update':
+          cmd = `npm update ${pkg || ''} --registry ${registry}`;
+          break;
+        case 'remove':
+          cmd = `npm uninstall ${pkg || ''}`;
+          break;
+        case 'list':
+          cmd = `npm list --depth=0 ${pkg || ''}`;
+          break;
+        case 'audit':
+          cmd = 'npm audit';
+          break;
+        case 'init':
+          cmd = 'npm init -y';
+          break;
+      }
+
+      const output = execSync(cmd, {
+        cwd,
+        encoding: 'utf-8',
+        timeout: 120000,
+        maxBuffer: 50 * 1024 * 1024,
+        stdio: 'pipe',
+      });
+
+      return { success: true, output: output || `${action} 完成`, metadata: { action, cwd } };
+    } catch (err: unknown) {
+      const e = err as { message?: string; stdout?: string; stderr?: string };
+      return {
+        success: false,
+        error: e.message || String(err),
+        output: (e.stdout || '') + (e.stderr || ''),
+      };
+    }
+  },
+};