deeper-cli 1.0.0

package/src/tools/builtin/code/extract_function.ts

@@ -0,0 +1,86 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const extract_function: Tool = {
+  name: 'extract_function',
+  description: '从代码中提取指定函数',
+  category: 'code',
+  parameters: {
+    type: 'object',
+    properties: {
+      file_path: { type: 'string', description: '文件路径' },
+      function_name: { type: 'string', description: '函数名' },
+    },
+    required: ['file_path', 'function_name'],
+  },
+  dangerous: false,
+  requiresApproval: false,
+  async execute(params) {
+    try {
+      const filePath = resolve(params.file_path as string);
+      const funcName = params.function_name as string;
+
+      if (!existsSync(filePath)) {
+        return { success: false, error: `文件不存在: ${filePath}`, output: '' };
+      }
+
+      const content = readFileSync(filePath, 'utf-8');
+      const lines = content.split('\n');
+
+      const funcRegex = new RegExp(
+        `(?:function\\s+${escapeRegex(funcName)}|` +
+        `(?:const|let|var)\\s+${escapeRegex(funcName)}\\s*=|` +
+        `(?:public|private|protected|static|async\\s+)?${escapeRegex(funcName)}\\s*\\([^)]*\\)\\s*[\\{:]|` +
+        `(?:export\\s+)?(?:async\\s+)?${escapeRegex(funcName)}\\s*\\([^)]*\\)\\s*[\\{:]|` +
+        `(?:get |set )?${escapeRegex(funcName)}\\s*\\([^)]*\\)\\s*\\{)`,
+      );
+
+      let startLine = -1;
+      for (let i = 0; i < lines.length; i++) {
+        if (funcRegex.test(lines[i])) {
+          startLine = i;
+          break;
+        }
+      }
+
+      if (startLine === -1) {
+        return { success: false, error: `未找到函数: ${funcName}`, output: '' };
+      }
+
+      let braceCount = 0;
+      let endLine = -1;
+      for (let i = startLine; i < lines.length; i++) {
+        for (const ch of lines[i]) {
+          if (ch === '{') braceCount++;
+          else if (ch === '}') {
+            braceCount--;
+            if (braceCount === 0) {
+              endLine = i;
+              break;
+            }
+          }
+        }
+        if (endLine !== -1) break;
+      }
+
+      if (endLine === -1) {
+        endLine = Math.min(startLine + 50, lines.length - 1);
+      }
+
+      const extracted = lines.slice(startLine, endLine + 1).join('\n');
+
+      return {
+        success: true,
+        output: `提取函数 "${funcName}" (${filePath}:${startLine + 1}-${endLine + 1}):\n\n${extracted}`,
+        metadata: { functionName: funcName, file: filePath, startLine: startLine + 1, endLine: endLine + 1 },
+      };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};
+
+function escapeRegex(s: string): string {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}

package/src/tools/builtin/code/format_code.ts

@@ -0,0 +1,57 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const format_code: Tool = {
+  name: 'format_code',
+  description: '格式化代码（建议使用 prettier）',
+  category: 'code',
+  parameters: {
+    type: 'object',
+    properties: {
+      file_path: { type: 'string', description: '文件路径' },
+      language: { type: 'string', description: '语言类型', enum: ['typescript', 'javascript', 'json', 'css', 'html', 'python'] },
+    },
+    required: ['file_path'],
+  },
+  dangerous: false,
+  requiresApproval: true,
+  async execute(params) {
+    try {
+      const filePath = resolve(params.file_path as string);
+      const language = (params.language as string) ?? 'typescript';
+
+      if (!existsSync(filePath)) {
+        return { success: false, error: `文件不存在: ${filePath}`, output: '' };
+      }
+
+      try {
+        const { execSync } = await import('node:child_process');
+        const ext = filePath.split('.').pop() ?? 'ts';
+        execSync(`npx prettier --write "${filePath}"`, {
+          encoding: 'utf-8',
+          timeout: 30000,
+          stdio: 'pipe',
+        });
+        const formatted = readFileSync(filePath, 'utf-8');
+        return {
+          success: true,
+          output: `已格式化: ${filePath}\n\n${formatted.slice(0, 10000)}`,
+          metadata: { formatted: true, tool: 'prettier' },
+        };
+      } catch {
+        const content = readFileSync(filePath, 'utf-8');
+        return {
+          success: true,
+          output: `代码格式化建议 (${language}):\n\n` +
+            '- 运行 npx prettier --write . 来批量格式化\n' +
+            '- 使用 ESLint: npx eslint --fix .\n\n' +
+            `当前文件内容:\n${content.slice(0, 10000)}`,
+          metadata: { formatted: false, suggestion: 'prettier' },
+        };
+      }
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/code/generate_code.ts

@@ -0,0 +1,75 @@
+import type { Tool } from '../../tool-types.js';
+
+export const generate_code: Tool = {
+  name: 'generate_code',
+  description: 'AI 辅助代码生成（提供代码模板和最佳实践）',
+  category: 'code',
+  parameters: {
+    type: 'object',
+    properties: {
+      description: { type: 'string', description: '功能描述' },
+      language: { type: 'string', description: '语言类型', enum: ['typescript', 'javascript', 'python', 'java', 'go', 'rust'] },
+      template: { type: 'string', description: '模板类型: function, class, component, api, test', enum: ['function', 'class', 'component', 'api', 'test'] },
+      file_path: { type: 'string', description: '输出文件路径' },
+    },
+    required: ['description'],
+  },
+  dangerous: false,
+  requiresApproval: false,
+  async execute(params) {
+    try {
+      const description = params.description as string;
+      const language = (params.language as string) ?? 'typescript';
+      const template = (params.template as string) ?? 'function';
+      const filePath = params.file_path as string | undefined;
+
+      const output = [
+        `代码生成请求: ${language}/${template}`,
+        `描述: ${description}`,
+        filePath ? `输出: ${filePath}` : '',
+        '',
+        '此工具由 AI Agent 调用。生成代码由 AI 模型在上下文中完成。',
+        '以下是相关的最佳实践建议:',
+        '',
+        ...getBestPractices(language, template),
+      ].filter(Boolean).join('\n');
+
+      return {
+        success: true,
+        output,
+        metadata: { description, language, template, filePath },
+      };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};
+
+function getBestPractices(lang: string, tmpl: string): string[] {
+  const tips: string[] = [];
+  if (lang === 'typescript') {
+    tips.push('- 使用 strict 模式，避免 any 类型');
+    tips.push('- 优先使用 interface/type 定义数据结构');
+  }
+  if (tmpl === 'function') {
+    tips.push('- 单一职责，每个函数只做一件事');
+    tips.push('- 添加类型标注和参数验证');
+  }
+  if (tmpl === 'class') {
+    tips.push('- 使用 private/public 控制访问');
+    tips.push('- 考虑使用 composition 替代 inheritance');
+  }
+  if (tmpl === 'component') {
+    tips.push('- 拆分大组件为小组件');
+    tips.push('- 使用 hooks 管理状态');
+  }
+  if (tmpl === 'api') {
+    tips.push('- 实现输入验证和错误处理');
+    tips.push('- 添加请求日志和限流');
+  }
+  if (tmpl === 'test') {
+    tips.push('- 遵循 AAA 模式 (Arrange, Act, Assert)');
+    tips.push('- 每个测试只测一个行为');
+  }
+  return tips;
+}

package/src/tools/builtin/code/import_organizer.ts

@@ -0,0 +1,82 @@
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const import_organizer: Tool = {
+  name: 'import_organizer',
+  description: '整理和组织导入语句',
+  category: 'code',
+  parameters: {
+    type: 'object',
+    properties: {
+      file_path: { type: 'string', description: '文件路径' },
+      group_by: { type: 'string', description: '分组方式: none, type, source', enum: ['none', 'type', 'source'] },
+      sort: { type: 'boolean', description: '是否排序' },
+      remove_unused: { type: 'boolean', description: '是否移除未使用导入' },
+    },
+    required: ['file_path'],
+  },
+  dangerous: false,
+  requiresApproval: true,
+  async execute(params) {
+    try {
+      const filePath = resolve(params.file_path as string);
+      const groupBy = (params.group_by as string) ?? 'source';
+      const sort = (params.sort as boolean) ?? true;
+      const removeUnused = (params.remove_unused as boolean) ?? false;
+
+      if (!existsSync(filePath)) {
+        return { success: false, error: `文件不存在: ${filePath}`, output: '' };
+      }
+
+      const content = readFileSync(filePath, 'utf-8');
+      const lines = content.split('\n');
+      const importLines: { index: number; line: string; isRelative: boolean }[] = [];
+      const otherLines: { index: number; line: string }[] = [];
+
+      for (let i = 0; i < lines.length; i++) {
+        const trimmed = lines[i].trim();
+        if (/^(import\s+|require\(|from\s+|import\(|import\s*\{)/.test(trimmed)) {
+          importLines.push({
+            index: i,
+            line: trimmed,
+            isRelative: trimmed.includes("'./") || trimmed.includes("'../") || trimmed.includes('"./') || trimmed.includes('"../'),
+          });
+        } else {
+          otherLines.push({ index: i, line: trimmed });
+        }
+      }
+
+      let organized: string[];
+      if (groupBy === 'source') {
+        const external = importLines.filter(i => !i.isRelative).map(i => i.line).sort();
+        const internal = importLines.filter(i => i.isRelative).map(i => i.line).sort();
+        organized = [...external, ...(external.length && internal.length ? [''] : []), ...internal];
+      } else if (groupBy === 'type') {
+        const typeImports = importLines.filter(i => i.line.includes('import type')).map(i => i.line).sort();
+        const valueImports = importLines.filter(i => !i.line.includes('import type')).map(i => i.line).sort();
+        organized = [...typeImports, ...(typeImports.length && valueImports.length ? [''] : []), ...valueImports];
+      } else {
+        organized = sort ? importLines.map(i => i.line).sort() : importLines.map(i => i.line);
+      }
+
+      const updated = [...organized, '', ...otherLines.map(l => l.line)].join('\n');
+
+      if (removeUnused) {
+        return {
+          success: true,
+          output: `导入已整理: ${filePath}\n\n建议: 使用 'npx eslint --fix' 或 'organize-imports-cli' 自动移除未使用导入。\n\n整理后:\n${updated.slice(0, 10000)}`,
+          metadata: { filePath, importCount: organized.length, removeUnused },
+        };
+      }
+
+      return {
+        success: true,
+        output: `导入已整理: ${filePath}\n整理后:\n${updated.slice(0, 10000)}`,
+        metadata: { filePath, importCount: organized.length },
+      };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/code/lint_code.ts

@@ -0,0 +1,48 @@
+import { execSync } from 'node:child_process';
+import { resolve } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const lint_code: Tool = {
+  name: 'lint_code',
+  description: '运行代码检查（ESLint）',
+  category: 'code',
+  parameters: {
+    type: 'object',
+    properties: {
+      file_path: { type: 'string', description: '文件或目录路径' },
+      fix: { type: 'boolean', description: '是否自动修复' },
+    },
+    required: [],
+  },
+  dangerous: false,
+  requiresApproval: false,
+  async execute(params) {
+    try {
+      const filePath = params.file_path as string | undefined;
+      const fix = (params.fix as boolean) ?? false;
+
+      const target = filePath ? resolve(filePath) : '.';
+
+      try {
+        const cmd = fix ? `npx eslint "${target}" --fix` : `npx eslint "${target}"`;
+        const output = execSync(cmd, {
+          encoding: 'utf-8',
+          timeout: 60000,
+          stdio: 'pipe',
+        });
+        return { success: true, output: output || '代码检查通过，无问题！', metadata: { target, fix } };
+      } catch (err: unknown) {
+        const e = err as { stdout?: string; stderr?: string };
+        const issues = e.stdout || e.stderr || String(err);
+        return {
+          success: false,
+          error: '代码检查发现问题',
+          output: issues,
+          metadata: { target, hasIssues: true },
+        };
+      }
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/code/parse_ast.ts

@@ -0,0 +1,86 @@
+import { readFileSync, existsSync, statSync } from 'node:fs';
+import { resolve } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const parse_ast: Tool = {
+  name: 'parse_ast',
+  description: '解析代码结构（简化 AST 分析）',
+  category: 'code',
+  parameters: {
+    type: 'object',
+    properties: {
+      file_path: { type: 'string', description: '源代码文件路径' },
+      language: { type: 'string', description: '语言类型: typescript, javascript, python', enum: ['typescript', 'javascript', 'python'] },
+    },
+    required: ['file_path'],
+  },
+  dangerous: false,
+  requiresApproval: false,
+  async execute(params) {
+    try {
+      const filePath = resolve(params.file_path as string);
+      const language = (params.language as string) ?? 'typescript';
+
+      if (!existsSync(filePath)) {
+        return { success: false, error: `文件不存在: ${filePath}`, output: '' };
+      }
+
+      const content = readFileSync(filePath, 'utf-8');
+      const lines = content.split('\n');
+
+      const functions: string[] = [];
+      const classes: string[] = [];
+      const imports: string[] = [];
+      const exports: string[] = [];
+
+      for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        const lineNum = i + 1;
+
+        if (/^(export\s+)?(async\s+)?function\s+(\w+)/i.test(line)) {
+          functions.push(`${lineNum}: ${line.slice(0, 120)}`);
+        }
+        if (/^(export\s+)?class\s+(\w+)/i.test(line)) {
+          classes.push(`${lineNum}: ${line.slice(0, 120)}`);
+        }
+        if (/^(import\s+|from\s+|require\()/i.test(line)) {
+          imports.push(`${lineNum}: ${line.slice(0, 120)}`);
+        }
+        if (/^export\s+/.test(line)) {
+          exports.push(`${lineNum}: ${line.slice(0, 120)}`);
+        }
+      }
+
+      const output = [
+        `=== 代码结构分析: ${filePath} ===`,
+        `语言: ${language} | 行数: ${lines.length}`,
+        '',
+        `--- 函数 (${functions.length}) ---`,
+        ...functions.slice(0, 50),
+        '',
+        `--- 类 (${classes.length}) ---`,
+        ...classes.slice(0, 20),
+        '',
+        `--- 导入 (${imports.length}) ---`,
+        ...imports.slice(0, 30),
+        '',
+        `--- 导出 (${exports.length}) ---`,
+        ...exports.slice(0, 30),
+      ].join('\n');
+
+      return {
+        success: true,
+        output,
+        metadata: {
+          functions: functions.length,
+          classes: classes.length,
+          imports: imports.length,
+          exports: exports.length,
+          lines: lines.length,
+        },
+      };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/code/refactor_code.ts

@@ -0,0 +1,63 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const refactor_code: Tool = {
+  name: 'refactor_code',
+  description: '提供代码重构建议和执行常见重构操作',
+  category: 'code',
+  parameters: {
+    type: 'object',
+    properties: {
+      file_path: { type: 'string', description: '文件路径' },
+      action: { type: 'string', description: '重构操作: rename, extract, inline, move', enum: ['rename', 'extract', 'inline', 'move'] },
+      target: { type: 'string', description: '目标符号名' },
+      new_name: { type: 'string', description: '新名称' },
+    },
+    required: ['file_path', 'action'],
+  },
+  dangerous: false,
+  requiresApproval: true,
+  async execute(params) {
+    try {
+      const filePath = resolve(params.file_path as string);
+      const action = params.action as string;
+      const target = params.target as string | undefined;
+      const newName = params.new_name as string | undefined;
+
+      if (!existsSync(filePath)) {
+        return { success: false, error: `文件不存在: ${filePath}`, output: '' };
+      }
+
+      const content = readFileSync(filePath, 'utf-8');
+      const lines = content.split('\n');
+
+      let output = `=== 代码重构: ${filePath} ===\n操作: ${action}\n`;
+
+      switch (action) {
+        case 'rename': {
+          if (!target || !newName) {
+            return { success: false, error: 'rename 需要 target 和 new_name 参数', output: '' };
+          }
+          const escaped = escapeRegex(target);
+          const count = (content.match(new RegExp(`\\b${escaped}\\b`, 'g')) || []).length;
+          output += `目标: ${target} → ${newName}\n`;
+          output += `找到 ${count} 处引用\n`;
+          output += '请使用 edit_file 工具执行精确替换，或使用 IDE 的重构功能。';
+          break;
+        }
+        default:
+          output += `重构操作 "${action}" 的分析已提供。\n`;
+          output += '建议使用 IDE (VS Code, WebStorm) 的内置重构工具以获得最佳结果。';
+      }
+
+      return { success: true, output, metadata: { filePath, action, target, newName } };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};
+
+function escapeRegex(s: string): string {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}

package/src/tools/builtin/code/type_check.ts

@@ -0,0 +1,48 @@
+import { execSync } from 'node:child_process';
+import { resolve } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const type_check: Tool = {
+  name: 'type_check',
+  description: '运行 TypeScript 类型检查',
+  category: 'code',
+  parameters: {
+    type: 'object',
+    properties: {
+      project: { type: 'string', description: 'tsconfig.json 路径' },
+      strict: { type: 'boolean', description: '是否严格模式' },
+    },
+    required: [],
+  },
+  dangerous: false,
+  requiresApproval: false,
+  async execute(params) {
+    try {
+      const project = params.project as string | undefined;
+      const strict = (params.strict as boolean) ?? true;
+
+      try {
+        const args = ['tsc', '--noEmit'];
+        if (project) args.push('--project', resolve(project));
+        if (strict) args.push('--strict');
+
+        const output = execSync(args.join(' '), {
+          encoding: 'utf-8',
+          timeout: 120000,
+          stdio: 'pipe',
+        });
+        return { success: true, output: output || '类型检查通过！', metadata: { passed: true } };
+      } catch (err: unknown) {
+        const e = err as { stdout?: string; stderr?: string };
+        return {
+          success: false,
+          error: '类型检查发现错误',
+          output: e.stdout || e.stderr || String(err),
+          metadata: { passed: false },
+        };
+      }
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/data/chart_generate.ts

@@ -0,0 +1,62 @@
+import type { Tool } from '../../tool-types.js';
+
+export const chart_generate: Tool = {
+  name: 'chart_generate',
+  description: '生成数据图表（输出图表描述和配置）',
+  category: 'data',
+  parameters: {
+    type: 'object',
+    properties: {
+      data: { type: 'string', description: 'JSON 格式的数据' },
+      chart_type: { type: 'string', description: '图表类型: bar, line, pie, scatter, area', enum: ['bar', 'line', 'pie', 'scatter', 'area'] },
+      x_key: { type: 'string', description: 'X 轴数据键名' },
+      y_key: { type: 'string', description: 'Y 轴数据键名' },
+      title: { type: 'string', description: '图表标题' },
+    },
+    required: ['data', 'chart_type'],
+  },
+  dangerous: false,
+  requiresApproval: true,
+  async execute(params) {
+    try {
+      const data = JSON.parse(params.data as string);
+      const chartType = params.chart_type as string;
+      const xKey = params.x_key as string | undefined;
+      const yKey = params.y_key as string | undefined;
+      const title = (params.title as string) ?? 'Chart';
+
+      const config = {
+        title,
+        type: chartType,
+        data: Array.isArray(data) ? data : [data],
+        xKey,
+        yKey,
+        timestamp: new Date().toISOString(),
+      };
+
+      const output = [
+        `图表配置: ${title} (${chartType})`,
+        '',
+        '```json',
+        JSON.stringify(config, null, 2),
+        '```',
+        '',
+        '提示: 可以使用以下工具渲染图表:',
+        '- Chart.js + Canvas (Node.js)',
+        '- Apache ECharts',
+        '- D3.js',
+        '- Matplotlib (Python)',
+        '',
+        '使用建议: 安装 chartjs-node-canvas 或使用 web 前端渲染。',
+      ].join('\n');
+
+      return {
+        success: true,
+        output,
+        metadata: { chartType, dataPoints: Array.isArray(data) ? data.length : 1 },
+      };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/data/csv_parse.ts

@@ -0,0 +1,56 @@
+import type { Tool } from '../../tool-types.js';
+
+export const csv_parse: Tool = {
+  name: 'csv_parse',
+  description: '解析 CSV 内容',
+  category: 'data',
+  parameters: {
+    type: 'object',
+    properties: {
+      content: { type: 'string', description: 'CSV 字符串' },
+      file_path: { type: 'string', description: 'CSV 文件路径' },
+      delimiter: { type: 'string', description: '列分隔符，默认逗号' },
+      has_header: { type: 'boolean', description: '是否有标题行' },
+    },
+    required: [],
+  },
+  dangerous: false,
+  requiresApproval: false,
+  async execute(params) {
+    try {
+      let csvContent = '';
+      const filePath = params.file_path as string | undefined;
+      const content = params.content as string | undefined;
+      const delimiter = (params.delimiter as string) ?? ',';
+      const hasHeader = (params.has_header as boolean) ?? true;
+
+      if (filePath) {
+        const { readFileSync, existsSync } = await import('node:fs');
+        const { resolve } = await import('node:path');
+        const abs = resolve(filePath);
+        if (!existsSync(abs)) return { success: false, error: `文件不存在: ${abs}`, output: '' };
+        csvContent = readFileSync(abs, 'utf-8');
+      } else if (content) {
+        csvContent = content;
+      } else {
+        return { success: false, error: '请提供 content 或 file_path 参数', output: '' };
+      }
+
+      const { parse } = await import('csv-parse/sync');
+      const records = parse(csvContent, {
+        delimiter,
+        columns: hasHeader,
+        skip_empty_lines: true,
+        trim: true,
+      });
+
+      return {
+        success: true,
+        output: JSON.stringify(records, null, 2),
+        metadata: { rows: Array.isArray(records) ? records.length : 0 },
+      };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};