deeper-cli 1.0.0

package/src/tools/builtin/shell/terminal_screenshot.ts

@@ -0,0 +1,28 @@
+import type { Tool } from '../../tool-types.js';
+
+export const terminal_screenshot: Tool = {
+  name: 'terminal_screenshot',
+  description: '获取终端状态快照（文本形式）',
+  category: 'shell',
+  parameters: {
+    type: 'object',
+    properties: {
+      terminal_id: { type: 'string', description: '终端标识' },
+    },
+    required: ['terminal_id'],
+  },
+  dangerous: false,
+  requiresApproval: false,
+  async execute(params) {
+    try {
+      const terminalId = params.terminal_id as string;
+      return {
+        success: true,
+        output: `终端快照: ${terminalId}\n（终端屏幕截图功能在 CLI 环境中以文本输出替代）`,
+        metadata: { terminalId, method: 'text-snapshot' },
+      };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/system/log_viewer.ts

@@ -0,0 +1,89 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import type { Tool } from '../../tool-types.js';
+
+export const log_viewer: Tool = {
+  name: 'log_viewer',
+  description: '查看和管理日志文件',
+  category: 'system',
+  parameters: {
+    type: 'object',
+    properties: {
+      action: { type: 'string', description: '操作: read, tail, search, clear', enum: ['read', 'tail', 'search', 'clear'] },
+      file_path: { type: 'string', description: '日志文件路径' },
+      lines: { type: 'number', description: '读取行数（tail 模式）' },
+      query: { type: 'string', description: '搜索关键词' },
+    },
+    required: ['action'],
+  },
+  dangerous: false,
+  requiresApproval: false,
+  async execute(params) {
+    try {
+      const action = params.action as string;
+      const filePath = params.file_path as string | undefined;
+      const lineCount = (params.lines as number) ?? 50;
+      const query = params.query as string | undefined;
+
+      if (action !== 'clear' && !filePath) {
+        const defaultLogs = ['npm-debug.log', 'yarn-error.log', '.log', 'logs/'];
+        const cwd = process.cwd();
+        const found = defaultLogs.filter(f => existsSync(resolve(cwd, f)));
+        return {
+          success: true,
+          output: `请指定 file_path。项目目录中的日志文件:\n${found.length > 0 ? found.join('\n') : '  (未找到)'}`,
+        };
+      }
+
+      const abs = resolve(filePath!);
+
+      if (action === 'clear') {
+        const { writeFileSync } = await import('node:fs');
+        writeFileSync(abs, '', 'utf-8');
+        return { success: true, output: `日志已清空: ${abs}` };
+      }
+
+      if (!existsSync(abs)) {
+        return { success: false, error: `日志文件不存在: ${abs}`, output: '' };
+      }
+
+      const content = readFileSync(abs, 'utf-8');
+      const allLines = content.split('\n');
+
+      switch (action) {
+        case 'read': {
+          const sub = allLines.slice(0, lineCount).join('\n');
+          return {
+            success: true,
+            output: sub,
+            metadata: { lines: allLines.length, shown: Math.min(lineCount, allLines.length) },
+          };
+        }
+        case 'tail': {
+          const sub = allLines.slice(-lineCount).join('\n');
+          return {
+            success: true,
+            output: `最后 ${Math.min(lineCount, allLines.length)} 行:\n${sub}`,
+            metadata: { totalLines: allLines.length },
+          };
+        }
+        case 'search': {
+          if (!query) return { success: false, error: 'search 需要 query 参数', output: '' };
+          const matches = allLines
+            .map((line, i) => line.includes(query) ? `${i + 1}:${line.trim()}` : null)
+            .filter(Boolean)
+            .slice(0, 200);
+          return {
+            success: true,
+            output: matches.join('\n') || '未找到匹配行',
+            metadata: { matches: matches.length, totalLines: allLines.length },
+          };
+        }
+        default:
+          return { success: false, error: `不支持的操作: ${action}`, output: '' };
+      }
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/system/notify_user.ts

@@ -0,0 +1,55 @@
+import type { Tool } from '../../tool-types.js';
+
+export const notify_user: Tool = {
+  name: 'notify_user',
+  description: '发送系统通知给用户',
+  category: 'system',
+  parameters: {
+    type: 'object',
+    properties: {
+      title: { type: 'string', description: '通知标题' },
+      message: { type: 'string', description: '通知详情' },
+      level: { type: 'string', description: '通知级别: info, warn, error, success', enum: ['info', 'warn', 'error', 'success'] },
+    },
+    required: ['message'],
+  },
+  dangerous: false,
+  requiresApproval: false,
+  async execute(params) {
+    try {
+      const title = (params.title as string) ?? 'DeeperCode';
+      const message = params.message as string;
+      const level = (params.level as string) ?? 'info';
+
+      const icons: Record<string, string> = {
+        info: 'ℹ',
+        warn: '⚠',
+        error: '✗',
+        success: '✓',
+      };
+
+      const output = `${icons[level] || ''} [${level.toUpperCase()}] ${title}: ${message}`;
+
+      try {
+        if (process.platform === 'win32') {
+          const { execSync } = await import('node:child_process');
+          execSync(`powershell -Command "Add-Type -AssemblyName System.Windows.Forms; $notify = New-Object System.Windows.Forms.NotifyIcon; $notify.Icon = [System.Drawing.SystemIcons]::Information; $notify.Visible = $true; $notify.ShowBalloonTip(5000, '${title}', '${message}', [System.Windows.Forms.ToolTipIcon]::${level === 'error' ? 'Error' : 'Info'}); Start-Sleep -Seconds 6; $notify.Dispose()"`, {
+            timeout: 10000,
+            stdio: 'ignore',
+          });
+        } else if (process.platform === 'darwin') {
+          const { execSync } = await import('node:child_process');
+          execSync(`osascript -e 'display notification "${message}" with title "${title}"'`, { stdio: 'ignore' });
+        } else {
+          const { execSync } = await import('node:child_process');
+          execSync(`notify-send "${title}" "${message}"`, { stdio: 'ignore' });
+        }
+        return { success: true, output, metadata: { title, level, notified: true } };
+      } catch {
+        return { success: true, output, metadata: { title, level, notified: false } };
+      }
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/system/process_list.ts

@@ -0,0 +1,66 @@
+import { execSync } from 'node:child_process';
+import type { Tool } from '../../tool-types.js';
+
+export const process_list: Tool = {
+  name: 'process_list',
+  description: '列出当前运行的进程',
+  category: 'system',
+  parameters: {
+    type: 'object',
+    properties: {
+      filter: { type: 'string', description: '进程名过滤' },
+      count: { type: 'number', description: '显示数量' },
+    },
+    required: [],
+  },
+  dangerous: false,
+  requiresApproval: false,
+  async execute(params) {
+    try {
+      const filter = params.filter as string | undefined;
+      const count = (params.count as number) ?? 20;
+      const platform = process.platform;
+
+      let cmd: string;
+      if (platform === 'win32') {
+        cmd = 'tasklist /FO CSV /NH';
+      } else {
+        cmd = 'ps aux --sort=-%mem';
+      }
+
+      try {
+        let output = execSync(cmd, { encoding: 'utf-8', timeout: 10000, stdio: 'pipe' });
+        const lines = output.split('\n');
+
+        if (filter) {
+          const filtered = lines.filter(l => l.toLowerCase().includes(filter.toLowerCase()));
+          output = filtered.slice(0, count).join('\n');
+        } else {
+          output = lines.slice(0, count).join('\n');
+        }
+
+        return {
+          success: true,
+          output: `进程列表 (${platform}):\n${output}`,
+          metadata: { platform, filter, lines: Math.min(lines.length, count) },
+        };
+      } catch {
+        const os = await import('node:os');
+        return {
+          success: true,
+          output: [
+            `当前进程信息:`,
+            `PID: ${process.pid}`,
+            `平台: ${os.platform()}`,
+            `架构: ${os.arch()}`,
+            `Node.js: ${process.version}`,
+            `CPU 数: ${os.cpus().length}`,
+          ].join('\n'),
+          metadata: { pid: process.pid },
+        };
+      }
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/system/resource_monitor.ts

@@ -0,0 +1,66 @@
+import type { Tool } from '../../tool-types.js';
+
+export const resource_monitor: Tool = {
+  name: 'resource_monitor',
+  description: '监控系统资源使用情况',
+  category: 'system',
+  parameters: {
+    type: 'object',
+    properties: {
+      interval_ms: { type: 'number', description: '采样间隔毫秒' },
+      samples: { type: 'number', description: '采样次数' },
+    },
+    required: [],
+  },
+  dangerous: false,
+  requiresApproval: false,
+  async execute(params) {
+    try {
+      const intervalMs = (params.interval_ms as number) ?? 1000;
+      const samples = (params.samples as number) ?? 3;
+
+      const os = await import('node:os');
+      const results: Record<string, unknown>[] = [];
+
+      for (let i = 0; i < samples; i++) {
+        const cpus = os.cpus();
+        const totalIdle = cpus.reduce((s, c) => s + c.times.idle, 0);
+        const totalTick = cpus.reduce((s, c) => s + c.times.user + c.times.nice + c.times.sys + c.times.idle + c.times.irq, 0);
+        const cpuUsage = totalTick > 0 ? ((1 - totalIdle / totalTick) * 100).toFixed(1) : '0';
+
+        results.push({
+          sample: i + 1,
+          cpu: `${cpuUsage}%`,
+          memory: {
+            total: `${(os.totalmem() / 1024 / 1024 / 1024).toFixed(1)} GB`,
+            free: `${(os.freemem() / 1024 / 1024 / 1024).toFixed(1)} GB`,
+            used: `${((os.totalmem() - os.freemem()) / os.totalmem() * 100).toFixed(1)}%`,
+          },
+          uptime: `${Math.floor(os.uptime() / 3600)}h ${Math.floor((os.uptime() % 3600) / 60)}m`,
+          loadAverage: os.loadavg().map(l => l.toFixed(2)),
+        });
+
+        if (i < samples - 1) {
+          await new Promise(r => setTimeout(r, intervalMs));
+        }
+      }
+
+      const latest = results[results.length - 1];
+      const output = [
+        `资源监控 (${samples} 采样，间隔 ${intervalMs}ms):`,
+        `CPU 使用率: ${(latest as Record<string, unknown>).cpu}`,
+        `内存: ${JSON.stringify((latest as Record<string, unknown>).memory)}`,
+        `运行时间: ${(latest as Record<string, unknown>).uptime}`,
+        `平均负载: ${JSON.stringify((latest as Record<string, unknown>).loadAverage)}`,
+      ].join('\n');
+
+      return {
+        success: true,
+        output,
+        metadata: { samples, intervalMs, latest },
+      };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/builtin/system/system_info.ts

@@ -0,0 +1,41 @@
+import type { Tool } from '../../tool-types.js';
+
+export const system_info: Tool = {
+  name: 'system_info',
+  description: '获取系统信息',
+  category: 'system',
+  parameters: {
+    type: 'object',
+    properties: {},
+    required: [],
+  },
+  dangerous: false,
+  requiresApproval: false,
+  async execute() {
+    try {
+      const os = await import('node:os');
+
+      const info = {
+        platform: os.platform(),
+        arch: os.arch(),
+        hostname: os.hostname(),
+        cpus: os.cpus().length,
+        totalMemory: `${(os.totalmem() / 1024 / 1024 / 1024).toFixed(1)} GB`,
+        freeMemory: `${(os.freemem() / 1024 / 1024 / 1024).toFixed(1)} GB`,
+        uptime: `${Math.floor(os.uptime() / 3600)}h ${Math.floor((os.uptime() % 3600) / 60)}m`,
+        nodeVersion: process.version,
+        homeDir: os.homedir(),
+        tmpDir: os.tmpdir(),
+        cwd: process.cwd(),
+      };
+
+      const output = Object.entries(info)
+        .map(([k, v]) => `${k}: ${v}`)
+        .join('\n');
+
+      return { success: true, output, metadata: info };
+    } catch (err: unknown) {
+      return { success: false, error: (err as Error).message, output: '' };
+    }
+  },
+};

package/src/tools/tool-types.ts

@@ -0,0 +1,97 @@
+export interface JSONSchema {
+  type: string;
+  properties?: Record<string, JSONSchema>;
+  required?: string[];
+  description?: string;
+  enum?: string[];
+  items?: JSONSchema;
+  additionalProperties?: boolean;
+}
+
+export interface ToolParameter {
+  name: string;
+  type: string;
+  description: string;
+  required: boolean;
+  default?: unknown;
+  enum?: string[];
+}
+
+export interface ToolDefinition {
+  name: string;
+  description: string;
+  category: string;
+  parameters: JSONSchema;
+  dangerous?: boolean;
+  requiresApproval?: boolean;
+}
+
+export interface ToolResult {
+  success: boolean;
+  output: string;
+  error?: string;
+  metadata?: Record<string, unknown>;
+}
+
+export interface ToolExecutor {
+  execute(params: Record<string, unknown>, signal?: AbortSignal): Promise<ToolResult>;
+}
+
+export type Tool = ToolDefinition & ToolExecutor;
+
+export interface ToolCall {
+  id: string;
+  name: string;
+  arguments: Record<string, unknown>;
+}
+
+export interface ToolCallResult {
+  callId: string;
+  result: ToolResult;
+  timestamp: number;
+}
+
+export type ToolSafetyLevel = 'safe' | 'confirm' | 'dangerous';
+
+export const TOOL_SAFETY_MAP: Record<string, ToolSafetyLevel> = {
+  read_file: 'safe', list_dir: 'safe', glob_find: 'safe', file_info: 'safe',
+  grep_search: 'safe', text_search: 'safe', fuzzy_find: 'safe', regex_find: 'safe',
+  find_references: 'safe', find_definition: 'safe', symbol_search: 'safe',
+  search_package: 'safe', search_docs: 'safe', codebase_search: 'safe',
+  token_count: 'safe', system_info: 'safe', process_list: 'safe',
+  resource_monitor: 'safe', log_viewer: 'safe', bug_scan: 'safe',
+  web_fetch: 'safe', web_search: 'safe', check_url: 'safe',
+  parse_html: 'safe', http_request: 'safe',
+  watch_file: 'safe', batch_read: 'safe', create_dir: 'safe',
+  json_parse: 'safe', csv_parse: 'safe', xml_parse: 'safe', yaml_parse: 'safe', toml_parse: 'safe',
+  data_validate: 'safe', data_diff: 'safe', hash_generate: 'safe', jwt_decode: 'safe',
+  coverage_report: 'safe', config_manage: 'safe', notify_user: 'safe',
+  format_code: 'safe', lint_code: 'safe', type_check: 'safe', code_metrics: 'safe',
+  analyze_deps: 'safe', import_organizer: 'safe', parse_ast: 'safe',
+  db_schema: 'safe',
+  context_summarize: 'safe', prompt_template: 'safe',
+  skill_create: 'safe', tool_create: 'safe', memory_store: 'safe',
+  todo_manager: 'safe', subagent: 'safe',
+  background_terminal: 'safe', list_terminals: 'safe', read_terminal: 'safe',
+  send_keys: 'safe', send_ctrl_keys: 'safe', send_text: 'safe', kill_terminal: 'safe',
+  terminal_screenshot: 'safe', terminal_resize: 'safe', check_status: 'safe', stop_command: 'safe',
+  download_file: 'safe', api_call: 'safe', graphql_query: 'safe', websocket_connect: 'safe',
+
+  write_file: 'safe', edit_file: 'safe',
+  delete_file: 'confirm', move_file: 'confirm', copy_file: 'confirm', batch_write: 'safe',
+  merge_files: 'confirm', diff_files: 'confirm',
+  run_command: 'safe', run_async: 'safe', pipe_commands: 'safe',
+  shell_script: 'confirm', npm_manage: 'confirm',
+  project_init: 'confirm', build_project: 'confirm', run_test: 'confirm',
+  docker_manage: 'confirm', env_manage: 'confirm',
+  sql_query: 'confirm', sql_migrate: 'confirm', nosql_query: 'confirm',
+  db_backup: 'confirm', db_restore: 'confirm', redis_command: 'confirm',
+  encrypt_file: 'confirm', decrypt_file: 'confirm',
+  template_render: 'confirm', chart_generate: 'confirm',
+  secret_scan: 'confirm', vulnerability_check: 'confirm',
+  orm_generate: 'confirm', generate_code: 'confirm', refactor_code: 'confirm',
+  extract_function: 'confirm', data_transform: 'confirm', proxy_request: 'confirm',
+
+  interactive_terminal: 'confirm',
+  browser_action: 'confirm', screenshot_page: 'confirm',
+};

package/src/ui/AgentTree.tsx

@@ -0,0 +1,98 @@
+import { Text, Box } from 'ink';
+import { defaultTheme } from './themes/default.ts';
+
+interface AgentNode {
+  id: string;
+  name: string;
+  status: 'idle' | 'running' | 'completed' | 'failed';
+  children?: AgentNode[];
+}
+
+interface AgentTreeProps {
+  agents: AgentNode[];
+}
+
+const statusIcon: Record<AgentNode['status'], string> = {
+  idle: '⏸',
+  running: '🔄',
+  completed: '✅',
+  failed: '❌',
+};
+
+const statusColor: Record<AgentNode['status'], string> = {
+  idle: defaultTheme.dimText,
+  running: defaultTheme.primary,
+  completed: defaultTheme.success,
+  failed: defaultTheme.error,
+};
+
+function AgentNodeRow({
+  node,
+  depth,
+  isLast,
+}: {
+  node: AgentNode;
+  depth: number;
+  isLast: boolean;
+}) {
+  const prefix = depth === 0
+    ? ''
+    : '  '.repeat(depth - 1) + (isLast ? '└─' : '├─');
+
+  return (
+    <Box flexDirection="column">
+      <Box>
+        <Text dimColor>{prefix}</Text>
+        <Text color={statusColor[node.status]}>{statusIcon[node.status]}</Text>
+        <Text bold color={statusColor[node.status]}> {node.name}</Text>
+      </Box>
+      {node.children?.map((child, i) => (
+        <AgentNodeRow
+          key={child.id}
+          node={child}
+          depth={depth + 1}
+          isLast={i === (node.children?.length || 0) - 1}
+        />
+      ))}
+    </Box>
+  );
+}
+
+export function AgentTree({ agents }: AgentTreeProps) {
+  const total = agents.length;
+  const running = agents.filter((a) => a.status === 'running').length;
+  const completed = agents.filter((a) => a.status === 'completed').length;
+  const failed = agents.filter((a) => a.status === 'failed').length;
+
+  const countChildren = (ns: AgentNode[]): number =>
+    ns.reduce((sum, n) => sum + 1 + countChildren(n.children || []), 0);
+
+  const totalWithChildren = countChildren(agents);
+
+  return (
+    <Box flexDirection="column" borderStyle="round" borderColor={defaultTheme.border} paddingX={1}>
+      <Box>
+        <Text bold>🤖 Agent 树</Text>
+        <Text dimColor>
+          {' '}
+          [{totalWithChildren} 节点:
+          {' '}<Text color={defaultTheme.success}>{completed} 完成</Text>
+          {running > 0 ? <Text color={defaultTheme.primary}> {running} 运行</Text> : null}
+          {failed > 0 ? <Text color={defaultTheme.error}> {failed} 失败</Text> : null}
+          ]
+        </Text>
+      </Box>
+
+      <Box flexDirection="column" marginTop={0}>
+        {agents.map((agent, i) => (
+          <AgentNodeRow
+            key={agent.id}
+            node={agent}
+            depth={0}
+            isLast={i === total - 1}
+          />
+        ))}
+      </Box>
+    </Box>
+  );
+}

package/src/ui/App.tsx

@@ -0,0 +1,46 @@
+import { useEffect, useState, useRef } from 'react';
+import { Text, Box } from 'ink';
+import { ChatView } from './ChatView.tsx';
+import { StatusBar } from './StatusBar.tsx';
+import { eventbus } from '../core/eventbus.ts';
+import type { ChatMessage } from '../model/types.ts';
+
+interface AppProps {
+  apiKey?: string;
+  model?: string;
+  verbose?: boolean;
+  autoRun?: string;
+}
+
+export function App({ apiKey, model, autoRun }: AppProps) {
+  const [initialMessages, setInitialMessages] = useState<ChatMessage[]>([]);
+  const startTimeRef = useRef(Date.now());
+
+  useEffect(() => {
+    const memTimer = setInterval(() => {
+      eventbus.emitStatusUpdate({
+        memoryUsage: Math.round(process.memoryUsage().heapUsed / (1024 * 1024)),
+        uptime: Date.now() - startTimeRef.current,
+      });
+    }, 5000);
+
+    if (autoRun) {
+      setInitialMessages([{
+        id: `auto-${Date.now()}`, role: 'user', content: autoRun, timestamp: Date.now(),
+      }]);
+    }
+
+    return () => { clearInterval(memTimer); eventbus.reset(); };
+  }, []);
+
+  return (
+    <Box flexDirection="column" width="100%">
+      <ChatView
+        initialMessages={initialMessages}
+        apiKey={apiKey}
+        model={model}
+      />
+      <StatusBar />
+    </Box>
+  );
+}