deeper-cli 1.0.0

package/src/tools/builtin/filesystem/file_info.ts

@@ -0,0 +1,52 @@
+import { statSync, existsSync } from 'node:fs';
+import { resolve, basename } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const file_info: Tool = {
+  name: 'file_info',
+  description: '获取文件元信息（大小、修改时间等）',
+  category: 'filesystem',
+  parameters: {
+    type: 'object',
+    properties: {
+      file_path: { type: 'string', description: '文件绝对路径' },
+    },
+    required: ['file_path'],
+  },
+  dangerous: false,
+  requiresApproval: false,
+  async execute(params) {
+    try {
+      const filePath = resolve(params.file_path as string);
+      if (!existsSync(filePath)) {
+        return { success: false, error: `文件不存在: ${filePath}`, output: '' };
+      }
+      const stat = statSync(filePath);
+      const info = {
+        name: basename(filePath),
+        path: filePath,
+        size: stat.size,
+        sizeFormatted: formatSize(stat.size),
+        isDirectory: stat.isDirectory(),
+        isFile: stat.isFile(),
+        isSymlink: stat.isSymbolicLink(),
+        created: stat.birthtime.toISOString(),
+        modified: stat.mtime.toISOString(),
+        accessed: stat.atime.toISOString(),
+        permissions: stat.mode.toString(8).slice(-3),
+        readable: true,
+        writable: true,
+      };
+      return { success: true, output: JSON.stringify(info, null, 2), metadata: info };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};
+
+function formatSize(bytes: number): string {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  if (bytes < 1024 * 1024 * 1024) return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+  return `${(bytes / 1024 / 1024 / 1024).toFixed(1)} GB`;
+}

package/src/tools/builtin/filesystem/glob_find.ts

@@ -0,0 +1,44 @@
+import { resolve } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const glob_find: Tool = {
+  name: 'glob_find',
+  description: '使用 glob 模式匹配查找文件',
+  category: 'filesystem',
+  parameters: {
+    type: 'object',
+    properties: {
+      pattern: { type: 'string', description: 'Glob 匹配模式，如 **/*.ts' },
+      cwd: { type: 'string', description: '搜索根目录' },
+      ignore: { type: 'array', items: { type: 'string' }, description: '忽略模式列表' },
+      max_results: { type: 'number', description: '最大结果数' },
+    },
+    required: ['pattern'],
+  },
+  dangerous: false,
+  requiresApproval: false,
+  async execute(params) {
+    try {
+      const pattern = params.pattern as string;
+      const cwd = (params.cwd as string) ? resolve(params.cwd as string) : process.cwd();
+      const ignore = (params.ignore as string[]) ?? [];
+      const maxResults = (params.max_results as number) ?? 1000;
+      const fg = await import('fast-glob');
+      const files = await fg.default(pattern, {
+        cwd,
+        ignore: ['node_modules/**', '.git/**', ...ignore],
+        absolute: false,
+        dot: false,
+        onlyFiles: true,
+      });
+      const results = files.slice(0, maxResults);
+      return {
+        success: true,
+        output: results.join('\n'),
+        metadata: { count: results.length, total: files.length, pattern },
+      };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/filesystem/list_dir.ts

@@ -0,0 +1,51 @@
+import { readdirSync, existsSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const list_dir: Tool = {
+  name: 'list_dir',
+  description: '列出目录内容',
+  category: 'filesystem',
+  parameters: {
+    type: 'object',
+    properties: {
+      dir_path: { type: 'string', description: '目录绝对路径' },
+      recursive: { type: 'boolean', description: '是否递归列出' },
+      max_depth: { type: 'number', description: '递归最大深度' },
+    },
+    required: ['dir_path'],
+  },
+  dangerous: false,
+  requiresApproval: false,
+  async execute(params) {
+    try {
+      const dirPath = resolve(params.dir_path as string);
+      const recursive = (params.recursive as boolean) ?? false;
+      const maxDepth = (params.max_depth as number) ?? 3;
+      if (!existsSync(dirPath)) {
+        return { success: false, error: `目录不存在: ${dirPath}`, output: '' };
+      }
+      const { statSync } = await import('node:fs');
+      const lines: string[] = [];
+      function walk(dir: string, depth: number, prefix: string) {
+        if (depth > maxDepth) return;
+        try {
+          const entries = readdirSync(dir, { withFileTypes: true });
+          for (const entry of entries) {
+            const isDir = entry.isDirectory();
+            lines.push(`${prefix}${isDir ? '📁' : '📄'} ${entry.name}`);
+            if (isDir && recursive) {
+              walk(join(dir, entry.name), depth + 1, prefix + '  ');
+            }
+          }
+        } catch {
+          lines.push(`${prefix}权限不足`);
+        }
+      }
+      walk(dirPath, 1, '');
+      return { success: true, output: lines.join('\n'), metadata: { path: dirPath, entries: lines.length } };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/filesystem/merge_files.ts

@@ -0,0 +1,44 @@
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const merge_files: Tool = {
+  name: 'merge_files',
+  description: '合并多个文件内容写入目标文件',
+  category: 'filesystem',
+  parameters: {
+    type: 'object',
+    properties: {
+      file_paths: { type: 'array', items: { type: 'string' }, description: '源文件路径列表' },
+      output: { type: 'string', description: '输出文件路径' },
+      separator: { type: 'string', description: '文件间分隔符，默认换行' },
+    },
+    required: ['file_paths', 'output'],
+  },
+  dangerous: false,
+  requiresApproval: true,
+  async execute(params) {
+    try {
+      const paths = params.file_paths as string[];
+      const output = resolve(params.output as string);
+      const sep = (params.separator as string) ?? '\n';
+      const parts: string[] = [];
+      for (const p of paths) {
+        const abs = resolve(p);
+        if (!existsSync(abs)) {
+          return { success: false, error: `文件不存在: ${abs}`, output: '' };
+        }
+        parts.push(readFileSync(abs, 'utf-8'));
+      }
+      const merged = parts.join(sep);
+      writeFileSync(output, merged, 'utf-8');
+      return {
+        success: true,
+        output: `已合并 ${paths.length} 个文件到: ${output}`,
+        metadata: { count: paths.length, size: merged.length },
+      };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/filesystem/move_file.ts

@@ -0,0 +1,37 @@
+import { renameSync, existsSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const move_file: Tool = {
+  name: 'move_file',
+  description: '移动或重命名文件',
+  category: 'filesystem',
+  parameters: {
+    type: 'object',
+    properties: {
+      source: { type: 'string', description: '源文件路径' },
+      destination: { type: 'string', description: '目标文件路径' },
+    },
+    required: ['source', 'destination'],
+  },
+  dangerous: false,
+  requiresApproval: true,
+  async execute(params) {
+    try {
+      const source = resolve(params.source as string);
+      const dest = resolve(params.destination as string);
+      if (!existsSync(source)) {
+        return { success: false, error: `源文件不存在: ${source}`, output: '' };
+      }
+      const destDir = dirname(dest);
+      const { mkdirSync } = await import('node:fs');
+      if (!existsSync(destDir)) {
+        mkdirSync(destDir, { recursive: true });
+      }
+      renameSync(source, dest);
+      return { success: true, output: `已移动: ${source} -> ${dest}` };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/filesystem/read_file.ts

@@ -0,0 +1,55 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve, normalize } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const read_file: Tool = {
+  name: 'read_file',
+  description: '读取文件内容，支持指定行范围和偏移量，最大支持1万行',
+  category: 'filesystem',
+  parameters: {
+    type: 'object',
+    properties: {
+      file_path: { type: 'string', description: '文件绝对路径' },
+      offset: { type: 'number', description: '起始行号（从1开始）' },
+      limit: { type: 'number', description: '读取行数（最大10000）' },
+    },
+    required: ['file_path'],
+  },
+  dangerous: false,
+  requiresApproval: false,
+  async execute(params) {
+    try {
+      const filePath = resolve(params.file_path as string);
+      if (!existsSync(filePath)) {
+        return { success: false, error: `文件不存在: ${filePath}`, output: '' };
+      }
+      const statSync = await import('node:fs').then(m => m.statSync);
+      const stat = statSync(filePath);
+      if (stat.isDirectory()) {
+        return { success: false, error: `路径是目录，不是文件: ${filePath}`, output: '' };
+      }
+      const maxSize = 20 * 1024 * 1024;
+      if (stat.size > maxSize) {
+        return { success: false, error: `文件过大 (${(stat.size / 1024 / 1024).toFixed(1)}MB)，限制 ${maxSize / 1024 / 1024}MB`, output: '' };
+      }
+      let raw = readFileSync(filePath, 'utf-8');
+      const offset = (params.offset as number) ?? 1;
+      let limit = params.limit as number | undefined;
+      if (limit !== undefined) limit = Math.min(limit, 10000);
+      if (offset > 1 || limit !== undefined) {
+        const lines = raw.split('\n');
+        const start = Math.max(0, offset - 1);
+        const end = limit !== undefined ? Math.min(start + limit, lines.length) : lines.length;
+        raw = lines.slice(start, end).join('\n');
+      } else {
+        const lines = raw.split('\n');
+        if (lines.length > 10000) {
+          raw = lines.slice(0, 10000).join('\n') + `\n... (共${lines.length}行，仅显示前10000行)`;
+        }
+      }
+      return { success: true, output: raw, metadata: { size: stat.size, path: normalize(filePath) } };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/filesystem/watch_file.ts

@@ -0,0 +1,33 @@
+import { watch, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const watch_file: Tool = {
+  name: 'watch_file',
+  description: '监听文件变化并返回初始状态',
+  category: 'filesystem',
+  parameters: {
+    type: 'object',
+    properties: {
+      file_path: { type: 'string', description: '文件绝对路径' },
+    },
+    required: ['file_path'],
+  },
+  dangerous: false,
+  requiresApproval: false,
+  async execute(params) {
+    try {
+      const filePath = resolve(params.file_path as string);
+      if (!existsSync(filePath)) {
+        return { success: false, error: `文件不存在: ${filePath}`, output: '' };
+      }
+      return {
+        success: true,
+        output: `监听已设置: ${filePath}（文件变化将在下次查询时反映）`,
+        metadata: { watching: true, path: filePath },
+      };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/filesystem/write_file.ts

@@ -0,0 +1,45 @@
+import { existsSync, mkdirSync } from 'node:fs';
+import { writeFile, appendFile, readFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const write_file: Tool = {
+  name: 'write_file',
+  description: '写入文件内容，自动创建父目录。最大 512KB。空内容会跳过写入。',
+  category: 'filesystem',
+  parameters: {
+    type: 'object',
+    properties: {
+      file_path: { type: 'string', description: '文件绝对路径' },
+      content: { type: 'string', description: '要写入的内容' },
+      append: { type: 'boolean', description: '是否追加模式' },
+    },
+    required: ['file_path', 'content'],
+  },
+  dangerous: false,
+  requiresApproval: false,
+  async execute(params) {
+    const content = params.content as string;
+    if (content.length > 524_288) {
+      return { success: false, error: `内容过大 (${content.length}B, 最大 512KB)`, output: '' };
+    }
+    try {
+      const filePath = resolve(params.file_path as string);
+      const append = (params.append as boolean) ?? false;
+      if (!content.trim() && !append) {
+        return { success: false, error: `内容为空，跳过写入: ${filePath}`, output: '' };
+      }
+      const dir = dirname(filePath);
+      if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+      if (append) {
+        await appendFile(filePath, content, 'utf-8');
+      } else {
+        await writeFile(filePath, content, 'utf-8');
+      }
+      const lineCount = content.split('\n').length;
+      return { success: true, output: `文件已${append ? '追加' : '写入'}: ${filePath} (${lineCount}行)` };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/index.ts

@@ -0,0 +1,244 @@
+import type { Tool } from '../tool-types.js';
+
+import { read_file } from './filesystem/read_file.js';
+import { write_file } from './filesystem/write_file.js';
+import { edit_file } from './filesystem/edit_file.js';
+import { delete_file } from './filesystem/delete_file.js';
+import { list_dir } from './filesystem/list_dir.js';
+import { glob_find } from './filesystem/glob_find.js';
+import { move_file } from './filesystem/move_file.js';
+import { copy_file } from './filesystem/copy_file.js';
+import { create_dir } from './filesystem/create_dir.js';
+import { file_info } from './filesystem/file_info.js';
+import { watch_file } from './filesystem/watch_file.js';
+import { batch_read } from './filesystem/batch_read.js';
+import { batch_write } from './filesystem/batch_write.js';
+import { diff_files } from './filesystem/diff_files.js';
+import { merge_files } from './filesystem/merge_files.js';
+
+import { grep_search } from './search/grep_search.js';
+import { codebase_search } from './search/codebase_search.js';
+import { symbol_search } from './search/symbol_search.js';
+import { find_references } from './search/find_references.js';
+import { find_definition } from './search/find_definition.js';
+import { text_search } from './search/text_search.js';
+import { fuzzy_find } from './search/fuzzy_find.js';
+import { regex_find } from './search/regex_find.js';
+import { search_package } from './search/search_package.js';
+import { search_docs } from './search/search_docs.js';
+
+import { run_command } from './shell/run_command.js';
+import { run_async } from './shell/run_async.js';
+import { check_status } from './shell/check_status.js';
+import { stop_command } from './shell/stop_command.js';
+import { pipe_commands } from './shell/pipe_commands.js';
+import { shell_script } from './shell/shell_script.js';
+import { background_terminal } from './shell/background_terminal.js';
+import { send_keys } from './shell/send_keys.js';
+import { send_ctrl_keys } from './shell/send_ctrl_keys.js';
+import { send_text } from './shell/send_text.js';
+import { terminal_screenshot } from './shell/terminal_screenshot.js';
+import { terminal_resize } from './shell/terminal_resize.js';
+import { list_terminals, read_terminal } from './shell/list_terminals.js';
+import { kill_terminal } from './shell/kill_terminal.js';
+import { interactive_terminal } from './shell/interactive_terminal.js';
+
+import { web_fetch } from './network/web_fetch.js';
+import { web_search } from './network/web_search.js';
+import { http_request } from './network/http_request.js';
+import { download_file } from './network/download_file.js';
+import { api_call } from './network/api_call.js';
+import { graphql_query } from './network/graphql_query.js';
+import { websocket_connect } from './network/websocket_connect.js';
+import { check_url } from './network/check_url.js';
+import { screenshot_page } from './network/screenshot_page.js';
+import { parse_html } from './network/parse_html.js';
+import { browser_action } from './network/browser_action.js';
+import { proxy_request } from './network/proxy_request.js';
+
+import { parse_ast } from './code/parse_ast.js';
+import { format_code } from './code/format_code.js';
+import { lint_code } from './code/lint_code.js';
+import { type_check } from './code/type_check.js';
+import { generate_code } from './code/generate_code.js';
+import { refactor_code } from './code/refactor_code.js';
+import { extract_function } from './code/extract_function.js';
+import { analyze_deps } from './code/analyze_deps.js';
+import { import_organizer } from './code/import_organizer.js';
+import { code_metrics } from './code/code_metrics.js';
+import { bug_scan } from './code/bug_scan.js';
+
+import { sql_query } from './database/sql_query.js';
+import { sql_migrate } from './database/sql_migrate.js';
+import { nosql_query } from './database/nosql_query.js';
+import { db_schema } from './database/db_schema.js';
+import { db_backup } from './database/db_backup.js';
+import { db_restore } from './database/db_restore.js';
+import { redis_command } from './database/redis_command.js';
+import { orm_generate } from './database/orm_generate.js';
+
+import { json_parse } from './data/json_parse.js';
+import { csv_parse } from './data/csv_parse.js';
+import { xml_parse } from './data/xml_parse.js';
+import { yaml_parse } from './data/yaml_parse.js';
+import { toml_parse } from './data/toml_parse.js';
+import { data_transform } from './data/data_transform.js';
+import { data_validate } from './data/data_validate.js';
+import { data_diff } from './data/data_diff.js';
+import { template_render } from './data/template_render.js';
+import { chart_generate } from './data/chart_generate.js';
+
+import { secret_scan } from './security/secret_scan.js';
+import { encrypt_file } from './security/encrypt_file.js';
+import { decrypt_file } from './security/decrypt_file.js';
+import { hash_generate } from './security/hash_generate.js';
+import { jwt_decode } from './security/jwt_decode.js';
+import { vulnerability_check } from './security/vulnerability_check.js';
+
+import { npm_manage } from './project/npm_manage.js';
+import { project_init } from './project/project_init.js';
+import { build_project } from './project/build_project.js';
+import { run_test } from './project/run_test.js';
+import { coverage_report } from './project/coverage_report.js';
+import { env_manage } from './project/env_manage.js';
+import { config_manage } from './project/config_manage.js';
+import { docker_manage } from './project/docker_manage.js';
+
+import { token_count } from './ai/token_count.js';
+import { context_summarize } from './ai/context_summarize.js';
+import { prompt_template } from './ai/prompt_template.js';
+import { skill_create } from './ai/skill_create.js';
+import { tool_create } from './ai/tool_create.js';
+import { memory_store } from './ai/memory_store.js';
+import { todo_manager } from './ai/todo_manager.js';
+import { subagent, setSubagentRunner } from './ai/subagent.js';
+
+import { process_list } from './system/process_list.js';
+import { system_info } from './system/system_info.js';
+import { resource_monitor } from './system/resource_monitor.js';
+import { notify_user } from './system/notify_user.js';
+import { log_viewer } from './system/log_viewer.js';
+
+export const builtinTools: Tool[] = [
+  read_file,
+  write_file,
+  edit_file,
+  delete_file,
+  list_dir,
+  glob_find,
+  move_file,
+  copy_file,
+  create_dir,
+  file_info,
+  watch_file,
+  batch_read,
+  batch_write,
+  diff_files,
+  merge_files,
+
+  grep_search,
+  codebase_search,
+  symbol_search,
+  find_references,
+  find_definition,
+  text_search,
+  fuzzy_find,
+  regex_find,
+  search_package,
+  search_docs,
+
+  run_command,
+  run_async,
+  check_status,
+  stop_command,
+  pipe_commands,
+  shell_script,
+  background_terminal,
+  send_keys,
+  send_ctrl_keys,
+  send_text,
+  terminal_screenshot,
+  terminal_resize,
+  list_terminals,
+  read_terminal,
+  kill_terminal,
+  interactive_terminal,
+
+  web_fetch,
+  web_search,
+  http_request,
+  download_file,
+  api_call,
+  graphql_query,
+  websocket_connect,
+  check_url,
+  screenshot_page,
+  parse_html,
+  browser_action,
+  proxy_request,
+
+  parse_ast,
+  format_code,
+  lint_code,
+  type_check,
+  generate_code,
+  refactor_code,
+  extract_function,
+  analyze_deps,
+  import_organizer,
+  code_metrics,
+  bug_scan,
+
+  sql_query,
+  sql_migrate,
+  nosql_query,
+  db_schema,
+  db_backup,
+  db_restore,
+  redis_command,
+  orm_generate,
+
+  json_parse,
+  csv_parse,
+  xml_parse,
+  yaml_parse,
+  toml_parse,
+  data_transform,
+  data_validate,
+  data_diff,
+  template_render,
+  chart_generate,
+
+  secret_scan,
+  encrypt_file,
+  decrypt_file,
+  hash_generate,
+  jwt_decode,
+  vulnerability_check,
+
+  npm_manage,
+  project_init,
+  build_project,
+  run_test,
+  coverage_report,
+  env_manage,
+  config_manage,
+  docker_manage,
+
+  token_count,
+  context_summarize,
+  prompt_template,
+  skill_create,
+  tool_create,
+  memory_store,
+  todo_manager,
+  subagent,
+
+  process_list,
+  system_info,
+  resource_monitor,
+  notify_user,
+  log_viewer,
+];
+
+export { setSubagentRunner };