deeper-cli 1.0.0

package/src/cli/commands/chat.ts

@@ -0,0 +1,39 @@
+import { getConfig, loadConfig } from '../../core/config.ts';
+
+interface ChatOptions {
+  model?: string;
+  apiKey?: string;
+  verbose?: boolean;
+  autoRun?: string;
+}
+
+export async function chat(opts: ChatOptions = {}): Promise<void> {
+  const config = getConfig() || loadConfig();
+
+  const apiKey = opts.apiKey || config.apiKey || process.env.DEEPSEEK_API_KEY || '';
+  if (!apiKey) {
+    console.error('❌ 未设置 API Key');
+    console.error('');
+    console.error('   请运行以下命令之一:');
+    console.error('     deeper config set api_key "sk-你的密钥"');
+    console.error('     或设置环境变量: set DEEPSEEK_API_KEY=sk-你的密钥');
+    console.error('');
+    console.error('   获取密钥: https://platform.deepseek.com');
+    process.exit(1);
+  }
+
+  const model = opts.model || config.model || 'deepseek-v4-pro';
+  const baseUrl = config.baseUrl || 'https://api.deepseek.com';
+  const isFlash = model.includes('flash');
+
+  const { startRepl } = await import('../chat-repl.js');
+  await startRepl({
+    apiKey,
+    model,
+    baseUrl,
+    maxTokens: 8192,
+    temperature: config.temperature ?? (isFlash ? 0.3 : 0.7),
+    thinkEnabled: config.thinkEnabled ?? !isFlash,
+    thinkBudget: config.thinkBudget ?? (isFlash ? 0 : 16000),
+  });
+}

package/src/cli/commands/chat.tsx

@@ -0,0 +1,39 @@
+import { render } from 'ink';
+import { App } from '../../ui/App.tsx';
+import { bootstrap } from '../bootstrap.ts';
+
+interface ChatOptions {
+  model?: string;
+  apiKey?: string;
+  verbose?: boolean;
+  autoRun?: string;
+}
+
+export async function chat(opts: ChatOptions = {}): Promise<void> {
+  const result = await bootstrap();
+
+  if (!result.success) {
+    for (const err of result.errors) {
+      console.error(`❌ ${err}`);
+    }
+    process.exit(1);
+  }
+
+  for (const warn of result.warnings) {
+    console.warn(`⚠ ${warn}`);
+  }
+
+  const model = opts.model || result.config.model;
+  const apiKey = opts.apiKey || result.config.apiKey;
+
+  const { waitUntilExit } = render(
+    <App
+      apiKey={apiKey}
+      model={model}
+      verbose={opts.verbose}
+      autoRun={opts.autoRun}
+    />,
+  );
+
+  await waitUntilExit();
+}

package/src/cli/commands/config.ts

@@ -0,0 +1,133 @@
+import { getConfig, updateConfig, resetConfig, type DeeperConfig } from '../../core/config.ts';
+import { loadConfig } from '../../core/config.ts';
+import { DEEPER_CONFIG_FILE } from '../../core/constants.ts';
+
+export async function configCommand(args: string[]): Promise<void> {
+  loadConfig();
+  const subcommand = args[0] || 'list';
+
+  switch (subcommand) {
+    case 'list':
+    case 'ls': {
+      const config = getConfig();
+      console.log('\n📋 DeeperCode 配置:\n');
+      const displayKeys: { key: string; value: unknown; mask?: boolean }[] = [
+        { key: 'model', value: config.model },
+        { key: 'baseUrl', value: config.baseUrl },
+        { key: 'apiKey', value: config.apiKey || '', mask: true },
+        { key: 'maxTokens', value: config.maxTokens },
+        { key: 'thinkBudget', value: config.thinkBudget },
+        { key: 'thinkEnabled', value: config.thinkEnabled },
+        { key: 'temperature', value: config.temperature },
+        { key: 'maxSubAgents', value: config.maxSubAgents },
+        { key: 'maxRecursionDepth', value: config.maxRecursionDepth },
+        { key: 'timeoutMs', value: config.timeoutMs },
+        { key: 'theme', value: config.theme },
+        { key: 'locale', value: config.locale },
+      ];
+      for (const { key, value, mask } of displayKeys) {
+        const raw = String(value ?? '');
+        const display = mask
+          ? (raw ? `${raw.slice(0, 8)}...${raw.slice(-4)}` : '(未设置)')
+          : JSON.stringify(value);
+        console.log(`  ${key.padEnd(20)} ${display}`);
+      }
+      console.log();
+      break;
+    }
+
+    case 'get': {
+      const rawKey = args[1];
+      if (!rawKey) {
+        console.error('❌ 用法: deeper config get <key>');
+        process.exit(1);
+      }
+      const KEY_ALIASES: Record<string, string> = {
+        api_key: 'apiKey', 'api-key': 'apiKey', apikey: 'apiKey', key: 'apiKey',
+      };
+      const key = KEY_ALIASES[rawKey.toLowerCase()] || rawKey;
+      const config = getConfig();
+      const value = (config as Record<string, unknown>)[key];
+      if (value === undefined) {
+        console.error(`❌ 未知配置项: ${rawKey}`);
+        process.exit(1);
+      }
+      if (key === 'apiKey') {
+        const str = String(value || '');
+        console.log(str ? `${str.slice(0, 8)}...${str.slice(-4)}` : '(未设置)');
+      } else {
+        console.log(JSON.stringify(value, null, 2));
+      }
+      break;
+    }
+
+    case 'set': {
+      const rawKey = args[1];
+      const rawValue = args[2];
+      if (!rawKey || rawValue === undefined) {
+        console.error('❌ 用法: deeper config set <key> <value>');
+        process.exit(1);
+      }
+
+      const KEY_ALIASES: Record<string, string> = {
+        api_key: 'apiKey', 'api-key': 'apiKey', apikey: 'apiKey', key: 'apiKey',
+        base_url: 'baseUrl', 'base-url': 'baseUrl',
+        max_tokens: 'maxTokens', 'max-tokens': 'maxTokens',
+        think_budget: 'thinkBudget', 'think-budget': 'thinkBudget',
+        think_enabled: 'thinkEnabled', 'think-enabled': 'thinkEnabled',
+        log_level: 'logLevel', 'log-level': 'logLevel',
+        max_retries: 'maxRetries', 'max-retries': 'maxRetries',
+        timeout_ms: 'timeoutMs', 'timeout-ms': 'timeoutMs',
+        max_sub_agents: 'maxSubAgents', 'max-sub-agents': 'maxSubAgents',
+        max_recursion_depth: 'maxRecursionDepth', 'max-recursion-depth': 'maxRecursionDepth',
+      };
+      const key = KEY_ALIASES[rawKey.toLowerCase()] || rawKey;
+
+      try {
+        let parsedValue: unknown = rawValue;
+        if (rawValue === 'true') parsedValue = true;
+        else if (rawValue === 'false') parsedValue = false;
+        else if (!isNaN(Number(rawValue))) parsedValue = Number(rawValue);
+
+        updateConfig({ [key]: parsedValue } as Partial<DeeperConfig>);
+        console.log(`✅ 已设置 ${key} = ${JSON.stringify(parsedValue)}`);
+      } catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        console.error(`❌ 设置失败: ${msg}`);
+        process.exit(1);
+      }
+      break;
+    }
+
+    case 'reset': {
+      const config = resetConfig();
+      console.log('✅ 配置已重置为默认值');
+      console.log(JSON.stringify(config, null, 2));
+      break;
+    }
+
+    case 'path': {
+      console.log(`配置文件路径: ${DEEPER_CONFIG_FILE}`);
+      break;
+    }
+
+    default: {
+      console.log(`
+📋 DeeperCode 配置管理
+
+用法:
+  deeper config list              列出所有配置
+  deeper config get <key>         获取配置项
+  deeper config set <key> <value> 设置配置项
+  deeper config reset             重置配置
+  deeper config path              显示配置文件路径
+
+示例:
+  deeper config set model deepseek-v4-pro
+  deeper config set theme light
+  deeper config get apiKey
+`);
+      break;
+    }
+  }
+}

package/src/cli/commands/mcp.ts

@@ -0,0 +1,172 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { bootstrap } from '../bootstrap.ts';
+import { DEEPER_MCP_FILE } from '../../core/constants.ts';
+import { getConfig, updateConfig, type MCPConfigEntry } from '../../core/config.ts';
+
+export async function mcpCommand(args: string[]): Promise<void> {
+  const result = await bootstrap();
+  if (!result.success) {
+    for (const err of result.errors) {
+      console.error(`❌ ${err}`);
+    }
+    process.exit(1);
+  }
+
+  const subcommand = args[0] || 'list';
+
+  switch (subcommand) {
+    case 'list':
+    case 'ls': {
+      const config = getConfig();
+      const servers = config.mcpServers || [];
+
+      console.log('\n🔌 MCP 服务器:\n');
+
+      if (servers.length === 0) {
+        console.log('   (未配置任何 MCP 服务器)');
+        console.log();
+        console.log('   使用 "deeper mcp add" 添加 MCP 服务器');
+      } else {
+        for (const server of servers) {
+          const status = server.enabled ? '✅ 启用' : '⏸ 禁用';
+          const type = server.url ? 'SSE/HTTP' : 'Stdio';
+          console.log(`   📡 ${server.name.padEnd(20)} ${status} | ${type}`);
+          if (server.command) {
+            console.log(`      命令: ${server.command} ${(server.args || []).join(' ')}`);
+          }
+          if (server.url) {
+            console.log(`      URL: ${server.url}`);
+          }
+          if (server.autoConnect) {
+            console.log(`      🔗 自动连接`);
+          }
+        }
+      }
+      console.log();
+      break;
+    }
+
+    case 'add': {
+      const name = args[1];
+      const type = args[2];
+
+      if (!name) {
+        console.error('❌ 用法: deeper mcp add <name> stdio <command> [args...]');
+        console.error('         deeper mcp add <name> sse <url>');
+        process.exit(1);
+      }
+
+      const config = getConfig();
+      const servers = [...(config.mcpServers || [])];
+
+      if (servers.find((s) => s.name === name)) {
+        console.error(`❌ MCP 服务器 "${name}" 已存在`);
+        process.exit(1);
+      }
+
+      if (type === 'stdio') {
+        const command = args[3];
+        if (!command) {
+          console.error('❌ 请提供命令');
+          process.exit(1);
+        }
+        const cmdArgs = args.slice(4);
+        servers.push({
+          name,
+          command,
+          args: cmdArgs,
+          enabled: true,
+          autoConnect: true,
+        });
+      } else if (type === 'sse' || type === 'http') {
+        const url = args[3];
+        if (!url) {
+          console.error('❌ 请提供 URL');
+          process.exit(1);
+        }
+        servers.push({
+          name,
+          url,
+          enabled: true,
+          autoConnect: true,
+        });
+      } else {
+        console.error('❌ 未知类型。支持: stdio, sse');
+        process.exit(1);
+      }
+
+      updateConfig({ mcpServers: servers } as any);
+      console.log(`✅ MCP 服务器 "${name}" 已添加`);
+      break;
+    }
+
+    case 'remove':
+    case 'rm': {
+      const name = args[1];
+      if (!name) {
+        console.error('❌ 用法: deeper mcp remove <name>');
+        process.exit(1);
+      }
+
+      const config = getConfig();
+      const servers = (config.mcpServers || []).filter((s) => s.name !== name);
+
+      if (servers.length === config.mcpServers?.length) {
+        console.error(`❌ MCP 服务器 "${name}" 不存在`);
+        process.exit(1);
+      }
+
+      updateConfig({ mcpServers: servers } as any);
+      console.log(`✅ MCP 服务器 "${name}" 已移除`);
+      break;
+    }
+
+    case 'connect': {
+      const name = args[1];
+      if (!name) {
+        console.error('❌ 用法: deeper mcp connect <name>');
+        process.exit(1);
+      }
+      console.log(`🔌 连接 MCP 服务器 "${name}"...`);
+      console.log('💡 在 REPL 中使用 /mcp 查看已连接的服务器');
+      break;
+    }
+
+    case 'config': {
+      const filePath = DEEPER_MCP_FILE;
+      if (existsSync(filePath)) {
+        try {
+          const content = readFileSync(filePath, 'utf-8');
+          console.log(`📄 MCP 配置文件: ${filePath}`);
+          console.log(content);
+        } catch (e) {
+          const msg = e instanceof Error ? e.message : String(e);
+          console.error(`❌ 读取失败: ${msg}`);
+        }
+      } else {
+        console.log(`MCP 配置文件不存在: ${filePath}`);
+      }
+      break;
+    }
+
+    default: {
+      console.log(`
+🔌 DeeperCode MCP 管理
+
+用法:
+  deeper mcp list                          列出所有 MCP 服务器
+  deeper mcp add <name> stdio <cmd> [args] 添加 Stdio MCP 服务器
+  deeper mcp add <name> sse <url>          添加 SSE/HTTP MCP 服务器
+  deeper mcp remove <name>                 移除 MCP 服务器
+  deeper mcp connect <name>                连接 MCP 服务器
+  deeper mcp config                        查看 MCP 配置文件
+
+示例:
+  deeper mcp add filesystem stdio npx -y @modelcontextprotocol/server-filesystem
+  deeper mcp add myserver sse http://localhost:3001
+  deeper mcp remove myserver
+`);
+      break;
+    }
+  }
+}

package/src/cli/commands/run.ts

@@ -0,0 +1,147 @@
+import { loadConfig } from '../../core/config.ts';
+import { bootstrap } from '../bootstrap.ts';
+import type { DeeperConfig } from '../../core/config.ts';
+
+interface RunOptions {
+  task?: string;
+  model?: string;
+  apiKey?: string;
+  files?: string[];
+}
+
+export async function run(task: string, opts: RunOptions = {}): Promise<void> {
+  const result = await bootstrap();
+
+  if (!result.success) {
+    for (const err of result.errors) {
+      console.error(`❌ ${err}`);
+    }
+    process.exit(1);
+  }
+
+  if (!task) {
+    console.error('❌ 请提供任务描述。用法: deeper run "任务描述"');
+    process.exit(1);
+  }
+
+  const config = opts.model || opts.apiKey
+    ? { ...result.config, ...(opts.model ? { model: opts.model } : {}), ...(opts.apiKey ? { apiKey: opts.apiKey } : {}) }
+    : result.config;
+
+  if (!config.apiKey && !process.env.DEEPSEEK_API_KEY) {
+    console.error('❌ 未设置 API Key');
+    console.error('   请设置环境变量 DEEPSEEK_API_KEY 或使用 --api-key 参数');
+    process.exit(1);
+  }
+
+  console.log(`\n🚀 DeeperCode 执行任务\n`);
+  console.log(`📋 任务: ${task}`);
+  console.log(`🤖 模型: ${config.model}`);
+  console.log(`🔗 API: ${config.baseUrl}`);
+  console.log();
+
+  console.log('⏳ 正在连接 DeepSeek API...');
+  console.log();
+
+  try {
+    const apiKey = config.apiKey || process.env.DEEPSEEK_API_KEY || '';
+    const response = await fetch(`${config.baseUrl}/v1/chat/completions`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${apiKey}`,
+      },
+      body: JSON.stringify({
+        model: config.model,
+        messages: [
+          {
+            role: 'system',
+            content: '你是一个强大的 AI 编程助手。请帮助用户完成任务。',
+          },
+          {
+            role: 'user',
+            content: task,
+          },
+        ],
+        stream: true,
+        max_tokens: Math.max(1, Math.min(config.maxTokens || 4096, 131072)),
+      }),
+    });
+
+    if (!response.ok) {
+      const text = await response.text();
+      console.error(`❌ API 请求失败 (${response.status}): ${text}`);
+      process.exit(1);
+    }
+
+    const reader = response.body?.getReader();
+    if (!reader) {
+      console.error('❌ 无法读取响应流');
+      process.exit(1);
+    }
+
+    const decoder = new TextDecoder();
+    let buffer = '';
+    let fullContent = '';
+    let thinkingContent = '';
+
+    console.log('📝 AI 响应:\n');
+    console.log('─'.repeat(60));
+
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split('\n');
+      buffer = lines.pop() || '';
+
+      for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith('data: ')) continue;
+
+        const data = trimmed.slice(6);
+        if (data === '[DONE]') continue;
+
+        try {
+          const parsed = JSON.parse(data);
+          const delta = parsed.choices?.[0]?.delta;
+
+          if (delta?.thinking) {
+            thinkingContent += delta.thinking;
+          }
+
+          if (delta?.content) {
+            fullContent += delta.content;
+            process.stdout.write(delta.content);
+          }
+        } catch {
+          // 跳过无法解析的行
+        }
+      }
+    }
+
+    console.log('\n' + '─'.repeat(60));
+    console.log();
+
+    if (thinkingContent) {
+      console.log('💭 思考过程:');
+      console.log('─'.repeat(60));
+      console.log(thinkingContent.slice(0, 500));
+      if (thinkingContent.length > 500) {
+        console.log(`... (还有 ${thinkingContent.length - 500} 字符)`);
+      }
+      console.log('─'.repeat(60));
+    }
+
+    const usage = `📊 Token: ~${fullContent.length} 输出`;
+    console.log(usage);
+    console.log();
+
+    console.log('✅ 任务执行完成！');
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    console.error(`❌ 请求失败: ${msg}`);
+    process.exit(1);
+  }
+}

package/src/cli/commands/skill.ts

@@ -0,0 +1,152 @@
+import { readdirSync, existsSync, readFileSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { bootstrap } from '../bootstrap.ts';
+import { DEEPER_SKILLS_DIR, PROJECT_SKILLS_DIR } from '../../core/constants.ts';
+
+export async function skillCommand(args: string[]): Promise<void> {
+  const result = await bootstrap();
+  if (!result.success) {
+    for (const err of result.errors) {
+      console.error(`❌ ${err}`);
+    }
+    process.exit(1);
+  }
+
+  const subcommand = args[0] || 'list';
+
+  switch (subcommand) {
+    case 'list':
+    case 'ls': {
+      console.log('\n🧩 DeeperCode Skills:\n');
+
+      const homeSkills = listSkills(DEEPER_SKILLS_DIR);
+      console.log(`📁 全局 Skills (${DEEPER_SKILLS_DIR}):`);
+      if (homeSkills.length === 0) {
+        console.log('   (无)');
+      } else {
+        for (const skill of homeSkills) {
+          console.log(`   📦 ${skill.name} - ${skill.description}`);
+        }
+      }
+
+      const cwd = process.cwd();
+      const projectSkillsDir = join(cwd, PROJECT_SKILLS_DIR);
+      if (existsSync(projectSkillsDir)) {
+        const projectSkills = listSkills(projectSkillsDir);
+        console.log(`\n📁 项目 Skills (${projectSkillsDir}):`);
+        if (projectSkills.length === 0) {
+          console.log('   (无)');
+        } else {
+          for (const skill of projectSkills) {
+            console.log(`   📦 ${skill.name} - ${skill.description}`);
+          }
+        }
+      }
+
+      console.log();
+      break;
+    }
+
+    case 'create': {
+      const name = args[1];
+      if (!name) {
+        console.error('❌ 用法: deeper skill create <name>');
+        process.exit(1);
+      }
+
+      const targetDir = join(DEEPER_SKILLS_DIR, name);
+      if (existsSync(targetDir)) {
+        console.error(`❌ Skill "${name}" 已存在`);
+        process.exit(1);
+      }
+
+      try {
+        mkdirSync(targetDir, { recursive: true });
+        const skillDef = {
+          name,
+          version: '1.0.0',
+          description: `${name} 技能`,
+          triggers: [],
+          steps: [],
+        };
+        writeFileSync(
+          join(targetDir, 'skill.json'),
+          JSON.stringify(skillDef, null, 2),
+          'utf-8',
+        );
+        console.log(`✅ Skill "${name}" 已创建: ${targetDir}`);
+      } catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        console.error(`❌ 创建失败: ${msg}`);
+        process.exit(1);
+      }
+      break;
+    }
+
+    case 'info': {
+      const name = args[1];
+      if (!name) {
+        console.error('❌ 用法: deeper skill info <name>');
+        process.exit(1);
+      }
+
+      const skillPath = join(DEEPER_SKILLS_DIR, name, 'skill.json');
+      if (!existsSync(skillPath)) {
+        console.error(`❌ Skill "${name}" 不存在`);
+        process.exit(1);
+      }
+
+      try {
+        const content = readFileSync(skillPath, 'utf-8');
+        const skillDef = JSON.parse(content);
+        console.log(JSON.stringify(skillDef, null, 2));
+      } catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        console.error(`❌ 读取失败: ${msg}`);
+        process.exit(1);
+      }
+      break;
+    }
+
+    default: {
+      console.log(`
+🧩 DeeperCode Skill 管理
+
+用法:
+  deeper skill list               列出所有 Skills
+  deeper skill create <name>      创建新 Skill
+  deeper skill info <name>        查看 Skill 详情
+
+示例:
+  deeper skill list
+  deeper skill create my-skill
+  deeper skill info my-skill
+`);
+      break;
+    }
+  }
+}
+
+function listSkills(dir: string): { name: string; description: string }[] {
+  try {
+    if (!existsSync(dir)) return [];
+    const entries = readdirSync(dir, { withFileTypes: true });
+    return entries
+      .filter((e) => e.isDirectory())
+      .map((e) => {
+        const skillFile = join(dir, e.name, 'skill.json');
+        if (existsSync(skillFile)) {
+          try {
+            const content = readFileSync(skillFile, 'utf-8');
+            const def = JSON.parse(content);
+            return { name: def.name || e.name, description: def.description || '' };
+          } catch {
+            return { name: e.name, description: '' };
+          }
+        }
+        return { name: e.name, description: '' };
+      });
+  } catch {
+    return [];
+  }
+}