@miphamai/cli 0.29.0 → 0.30.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miphamai/cli",
-  "version": "0.29.0",
+  "version": "0.30.1",
   "description": "Mipham Code — Multi-model open-core intelligent coding terminal by MiphamAI",
   "keywords": [
     "ai",

package/src/index.tsx

@@ -24,7 +24,7 @@ import { ContextManager } from './core/context'
 import { QueryEngine } from './core/engine'
 import { ExperienceRuleEngine } from './core/rule-engine.js'
 import { SessionStore } from './core/session-store'
-import type { PermissionLevel } from './shared/types'
+import type { PermissionLevel, MiphamConfig } from './shared/types'
 import { SkillsLoader } from './skills/loader'
 import { PluginManager } from './plugin/plugin-manager'
 import { loadPlugins } from './plugin/plugin-loader'
@@ -42,6 +42,7 @@ import { AgentViewDashboard } from './agent-view/dashboard'
 import { createT } from './i18n-core/t'
 import { detectLocale } from './i18n-core/detect'
 import { I18nProvider } from './i18n-context'
+import { ConfigWizard } from './ui/config-wizard'
 import enUS from './i18n-core/locales/en-US.json' with { type: 'json' }
 import zhCN from './i18n-core/locales/zh-CN.json' with { type: 'json' }
 import type { TranslationMap } from './i18n-core/types'
@@ -111,6 +112,70 @@ async function checkWorkspaceTrust(): Promise<void> {
   }
 }
 
+// ── SetupGate: first-run wizard → App bridge ──
+
+interface SetupGateProps {
+  needsSetup: boolean
+  engine: QueryEngine
+  config: MiphamConfig
+  defaultProvider: string
+  defaultModel: string
+  lang?: string
+  skillsLoader?: SkillsLoader
+  pluginManager?: PluginManager
+  version?: string
+  sessionId: string
+  agentViewManager?: AgentViewManager
+  locale: string
+  t: (key: string) => string
+}
+
+function SetupGate(props: SetupGateProps) {
+  const [showWizard, setShowWizard] = React.useState(props.needsSetup)
+  const [wizardProvider, setWizardProvider] = React.useState<string | null>(null)
+  const [wizardModel, setWizardModel] = React.useState<string | null>(null)
+
+  // When wizard completes: write config, switch provider, proceed to App
+  const handleWizardComplete = React.useCallback(
+    (wizardConfig: { providerId: string; modelId: string; apiKey: string }) => {
+      // Switch the engine to the newly configured provider
+      try {
+        props.engine.switchProvider(wizardConfig.providerId, wizardConfig.modelId)
+      } catch {
+        // If switch fails (e.g. provider not yet in registry), just use as-is
+      }
+      setWizardProvider(wizardConfig.providerId)
+      setWizardModel(wizardConfig.modelId)
+      setShowWizard(false)
+    },
+    [props.engine],
+  )
+
+  const handleWizardSkip = React.useCallback(() => {
+    setShowWizard(false)
+  }, [])
+
+  if (showWizard) {
+    return React.createElement(ConfigWizard, {
+      onComplete: handleWizardComplete,
+      onSkip: handleWizardSkip,
+    })
+  }
+
+  return React.createElement(App, {
+    engine: props.engine,
+    config: props.config,
+    initialProvider: wizardProvider || props.defaultProvider,
+    initialModel: wizardModel || props.defaultModel,
+    lang: props.lang,
+    skillsLoader: props.skillsLoader,
+    pluginManager: props.pluginManager,
+    version: props.version,
+    sessionId: props.sessionId,
+    agentViewManager: props.agentViewManager,
+  })
+}
+
 export async function runApp(options: RunOptions): Promise<void> {
   // Metrics: count CLI invocation
   getMetrics().cliInvocations.inc()
@@ -481,21 +546,29 @@ export async function runApp(options: RunOptions): Promise<void> {
     }
   })
 
+  // ── First-run detection: show interactive ConfigWizard if no config exists ──
+  const hasUserConfig = existsSync(join(homedir(), '.mipham', 'config.yml'))
+  const hasProjectConfig = existsSync(join(process.cwd(), '.mipham', 'config.yml'))
+  const needsSetup = !hasUserConfig && !hasProjectConfig
+
   const { waitUntilExit } = render(
     React.createElement(I18nProvider, {
       locale,
       t,
-      children: React.createElement(App, {
+      children: React.createElement(SetupGate, {
+        needsSetup,
         engine,
         config,
-        initialProvider: defaultProvider,
-        initialModel: defaultModel,
+        defaultProvider,
+        defaultModel,
         lang: options.lang,
         skillsLoader,
         pluginManager,
         version: options.version,
         sessionId: sessionName,
         agentViewManager,
+        locale,
+        t,
       }),
     }),
   )

package/src/shared/constants.ts

@@ -35,6 +35,33 @@ export const DEFAULT_PROVIDERS: ProviderConfig[] = [
         vision: true,
         status: 'active',
       },
+      {
+        id: 'claude-fable-5',
+        name: 'Claude Fable 5',
+        providerId: 'anthropic',
+        contextWindow: 1_000_000,
+        maxOutput: 128_000,
+        vision: true,
+        status: 'active',
+      },
+      {
+        id: 'claude-sonnet-5',
+        name: 'Claude Sonnet 5',
+        providerId: 'anthropic',
+        contextWindow: 1_000_000,
+        maxOutput: 128_000,
+        vision: true,
+        status: 'active',
+      },
+      {
+        id: 'claude-opus-5',
+        name: 'Claude Opus 5',
+        providerId: 'anthropic',
+        contextWindow: 1_000_000,
+        maxOutput: 128_000,
+        vision: true,
+        status: 'active',
+      },
     ],
   },
   {

package/src/ui/config-wizard.tsx

@@ -0,0 +1,483 @@
+/**
+ * Interactive first-run Config Wizard
+ *
+ * Replaces manual config.yml editing for non-technical users.
+ * Flow: Welcome → Mode → Provider → Model → API Key → Confirm → Done
+ *
+ * Local path: Ollama setup
+ * Cloud path: pick provider → pick model → paste API key → auto-configure
+ */
+
+import React, { useState, useEffect } from 'react'
+import { Box, Text, useInput } from 'ink'
+import TextInput from 'ink-text-input'
+import { DEFAULT_PROVIDERS } from '../shared/constants'
+import type { ProviderConfig, ModelInfo } from '../shared/types'
+import { mkdirSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { homedir } from 'node:os'
+import { execSync } from 'node:child_process'
+
+// ── Types ──
+
+type Step = 'welcome' | 'mode' | 'provider' | 'model' | 'apikey' | 'ollama' | 'confirm' | 'done'
+
+interface Props {
+  onComplete: (config: { providerId: string; modelId: string; apiKey: string }) => void
+  onSkip: () => void
+}
+
+// ── Constants ──
+
+const CLOUD_PROVIDERS = DEFAULT_PROVIDERS.filter((p) => p.id !== 'ollama' && p.id !== 'mipham')
+
+const SELECTED_COLOR = 'cyan'
+
+// ── Helpers ──
+
+function getActiveModels(providerId: string): ModelInfo[] {
+  const provider = DEFAULT_PROVIDERS.find((p) => p.id === providerId)
+  return provider?.models.filter((m) => m.status === 'active') || []
+}
+
+function writeConfigFile(providerId: string, modelId: string, apiKey: string): void {
+  const configDir = join(homedir(), '.mipham')
+  mkdirSync(configDir, { recursive: true })
+
+  const provider = DEFAULT_PROVIDERS.find((p) => p.id === providerId)
+  const models = getActiveModels(providerId)
+  const lines = [
+    '# Mipham Code Configuration',
+    `# Generated by Config Wizard — ${new Date().toISOString()}`,
+    '',
+    'version: 1',
+    `defaultProvider: ${providerId}`,
+    `defaultModel: ${modelId}`,
+    'permission: default',
+    '',
+    'providers:',
+    `  - id: ${providerId}`,
+    `    name: ${provider?.name || providerId}`,
+    `    protocol: ${provider?.protocol || 'openai-compatible'}`,
+    ...(provider?.baseUrl ? [`    baseUrl: ${provider.baseUrl}`] : []),
+    `    apiKey: ${apiKey}`,
+    `    models:`,
+    ...models.map((m) => `      - id: ${m.id}`),
+  ]
+
+  writeFileSync(join(configDir, 'config.yml'), lines.join('\n'), 'utf-8')
+}
+
+function checkOllama(): { installed: boolean; running: boolean; models: string[] } {
+  try {
+    execSync('ollama --version', { timeout: 5000, stdio: 'ignore' })
+    const out = execSync('ollama list', { timeout: 5000, encoding: 'utf-8' })
+    const models = out
+      .split('\n')
+      .slice(1)
+      .filter(Boolean)
+      .map((l) => l.split(/\s+/)[0]!)
+    return { installed: true, running: true, models }
+  } catch {
+    try {
+      execSync('ollama --version', { timeout: 5000, stdio: 'ignore' })
+      return { installed: true, running: false, models: [] }
+    } catch {
+      return { installed: false, running: false, models: [] }
+    }
+  }
+}
+
+// ── Component ──
+
+export function ConfigWizard({ onComplete, onSkip }: Props) {
+  const [step, setStep] = useState<Step>('welcome')
+
+  // Selections
+  const [mode, setMode] = useState<'cloud' | 'local' | null>(null)
+  const [providerId, setProviderId] = useState<string | null>(null)
+  const [modelId, setModelId] = useState<string | null>(null)
+  const [apiKey, setApiKey] = useState('')
+  const [error, setError] = useState<string | null>(null)
+
+  // List navigation cursor
+  const [cursor, setCursor] = useState(0)
+
+  // Ollama
+  const [ollamaModel, setOllamaModel] = useState('')
+  const [ollamaStatus, setOllamaStatus] = useState<ReturnType<typeof checkOllama> | null>(null)
+
+  // ── Derived data ──
+
+  const providerList = CLOUD_PROVIDERS
+  const modelList = providerId ? getActiveModels(providerId) : []
+
+  // Reset cursor when step changes
+  const goStep = (s: Step) => {
+    setCursor(0)
+    setError(null)
+    setStep(s)
+  }
+
+  // ── Completion handlers ──
+
+  const finishCloud = () => {
+    if (!providerId || !modelId || !apiKey.trim()) {
+      setError('请填写 API Key')
+      return
+    }
+    try {
+      writeConfigFile(providerId, modelId, apiKey.trim())
+      onComplete({ providerId, modelId, apiKey: apiKey.trim() })
+    } catch (err) {
+      setError(`写入配置失败: ${String(err)}`)
+    }
+  }
+
+  const finishLocal = () => {
+    const model = ollamaModel.trim() || 'llama3.2'
+    try {
+      writeConfigFile('ollama', model, 'ollama-local')
+      onComplete({ providerId: 'ollama', modelId: model, apiKey: 'ollama-local' })
+    } catch (err) {
+      setError(`写入配置失败: ${String(err)}`)
+    }
+  }
+
+  // ── Ollama initialization ──
+
+  useEffect(() => {
+    if (step === 'ollama' && !ollamaStatus) {
+      setOllamaStatus(checkOllama())
+    }
+  }, [step, ollamaStatus])
+
+  // ── Keyboard: list navigation steps (no TextInput) ──
+
+  useInput((_input, key) => {
+    // Esc always skips
+    if (key.escape) {
+      if (step === 'welcome') {
+        onSkip()
+        return
+      }
+      // Go back one step
+      if (step === 'mode') {
+        goStep('welcome')
+        return
+      }
+      if (step === 'provider') {
+        goStep('mode')
+        return
+      }
+      if (step === 'model') {
+        goStep('provider')
+        return
+      }
+      if (step === 'apikey') {
+        goStep('model')
+        return
+      }
+      if (step === 'ollama') {
+        goStep('mode')
+        return
+      }
+      if (step === 'confirm') {
+        if (mode === 'cloud') {
+          goStep('apikey')
+          return
+        }
+        if (mode === 'local') {
+          goStep('ollama')
+          return
+        }
+      }
+      return
+    }
+
+    // ── Welcome ──
+    if (step === 'welcome') {
+      if (key.return) goStep('mode')
+      return
+    }
+
+    // ── Mode selection ──
+    if (step === 'mode') {
+      if (key.upArrow) setCursor((c) => (c === 0 ? 1 : 0))
+      if (key.downArrow) setCursor((c) => (c === 0 ? 1 : 0))
+      if (key.return) {
+        if (cursor === 0) {
+          // Cloud
+          setMode('cloud')
+          goStep('provider')
+        } else {
+          // Local
+          setMode('local')
+          setOllamaStatus(checkOllama())
+          goStep('ollama')
+        }
+      }
+      return
+    }
+
+    // ── Cloud provider selection ──
+    if (step === 'provider') {
+      if (key.upArrow) setCursor((c) => (c > 0 ? c - 1 : providerList.length - 1))
+      if (key.downArrow) setCursor((c) => (c < providerList.length - 1 ? c + 1 : 0))
+      if (key.return) {
+        const p = providerList[cursor]
+        if (p) {
+          setProviderId(p.id)
+          goStep('model')
+        }
+      }
+      return
+    }
+
+    // ── Cloud model selection ──
+    if (step === 'model') {
+      if (modelList.length === 0) return
+      if (key.upArrow) setCursor((c) => (c > 0 ? c - 1 : modelList.length - 1))
+      if (key.downArrow) setCursor((c) => (c < modelList.length - 1 ? c + 1 : 0))
+      if (key.return) {
+        const m = modelList[cursor]
+        if (m) {
+          setModelId(m.id)
+          goStep('apikey')
+        }
+      }
+      return
+    }
+
+    // ── Confirm ──
+    if (step === 'confirm') {
+      if (key.return) {
+        if (mode === 'cloud') finishCloud()
+        else finishLocal()
+      }
+      return
+    }
+  })
+
+  // ── Render ──
+
+  const dim = 'gray'
+
+  return (
+    <Box flexDirection="column" padding={1}>
+      {/* Header */}
+      <Box marginBottom={1}>
+        <Text color="#FFD700" bold>
+          Mipham Code
+        </Text>
+        <Text dimColor> — 配置向导</Text>
+      </Box>
+      <Box marginBottom={1}>
+        <Text dimColor>━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</Text>
+      </Box>
+
+      {/* ── Welcome ── */}
+      {step === 'welcome' && (
+        <Box flexDirection="column">
+          <Box marginBottom={1}>
+            <Text bold color="cyan">
+              欢迎使用 Mipham Code！
+            </Text>
+          </Box>
+          <Text>在开始之前，需要先配置 AI 模型连接。</Text>
+          <Text>此向导只需 1 分钟，需要您准备好 API Key。</Text>
+          <Box marginTop={1}>
+            <Text color="yellow">按 Enter 开始 →</Text>
+          </Box>
+          <Box marginTop={1}>
+            <Text dimColor>Esc 跳过配置</Text>
+          </Box>
+        </Box>
+      )}
+
+      {/* ── Mode ── */}
+      {step === 'mode' && (
+        <Box flexDirection="column">
+          <Box marginBottom={1}>
+            <Text bold>选择模型连接方式：</Text>
+          </Box>
+
+          <Box marginBottom={1}>
+            <Text color={cursor === 0 ? SELECTED_COLOR : undefined}>
+              {cursor === 0 ? '▶' : ' '} 🌐 云端 AI 模型（推荐）
+            </Text>
+          </Box>
+          <Text dimColor> Claude · DeepSeek · Gemini · 豆包 · Qwen · 混元 · OpenAI</Text>
+
+          <Box marginTop={2} marginBottom={1}>
+            <Text color={cursor === 1 ? SELECTED_COLOR : undefined}>
+              {cursor === 1 ? '▶' : ' '} 🖥️ 本地模型（Ollama）
+            </Text>
+          </Box>
+          <Text dimColor> 需要提前安装 Ollama 并下载模型</Text>
+
+          <Box marginTop={2}>
+            <Text dimColor>↑↓ 选择 · Enter 确认 · Esc 返回</Text>
+          </Box>
+        </Box>
+      )}
+
+      {/* ── Cloud Provider ── */}
+      {step === 'provider' && (
+        <Box flexDirection="column">
+          <Box marginBottom={1}>
+            <Text bold>选择 AI 模型提供商：</Text>
+          </Box>
+          {providerList.map((p, i) => (
+            <Box key={p.id} marginBottom={1}>
+              <Text color={i === cursor ? SELECTED_COLOR : undefined}>
+                {i === cursor ? '▶' : '  '} {p.name}
+              </Text>
+              <Text dimColor> ({p.models.filter((m) => m.status === 'active').length} 个模型)</Text>
+            </Box>
+          ))}
+          <Box marginTop={1}>
+            <Text dimColor>↑↓ 选择 · Enter 确认 · Esc 返回</Text>
+          </Box>
+        </Box>
+      )}
+
+      {/* ── Cloud Model ── */}
+      {step === 'model' && (
+        <Box flexDirection="column">
+          <Box marginBottom={1}>
+            <Text bold>
+              选择模型（{DEFAULT_PROVIDERS.find((p) => p.id === providerId)?.name || providerId}）：
+            </Text>
+          </Box>
+          {modelList.map((m, i) => (
+            <Box key={m.id} marginBottom={1}>
+              <Text color={i === cursor ? SELECTED_COLOR : undefined}>
+                {i === cursor ? '▶' : '  '} {m.name}
+              </Text>
+              <Text dimColor> ({m.id})</Text>
+            </Box>
+          ))}
+          <Box marginTop={1}>
+            <Text dimColor>↑↓ 选择 · Enter 确认 · Esc 返回</Text>
+          </Box>
+        </Box>
+      )}
+
+      {/* ── API Key input ── */}
+      {step === 'apikey' && (
+        <Box flexDirection="column">
+          <Box marginBottom={1}>
+            <Text bold>粘贴 API Key：</Text>
+          </Box>
+          <Text dimColor>提供商：{DEFAULT_PROVIDERS.find((p) => p.id === providerId)?.name}</Text>
+          <Text dimColor>
+            模型：{getActiveModels(providerId!).find((m) => m.id === modelId)?.name}
+          </Text>
+          {error && (
+            <Box marginBottom={1}>
+              <Text color="red">⚠ {error}</Text>
+            </Box>
+          )}
+          <Box marginTop={1}>
+            <Text color="yellow">🔑 </Text>
+            <TextInput
+              value={apiKey}
+              onChange={setApiKey}
+              onSubmit={() => goStep('confirm')}
+              placeholder="粘贴 API Key 后按 Enter..."
+            />
+          </Box>
+          <Box marginTop={1}>
+            <Text dimColor>Enter 继续 · Esc 返回选模型</Text>
+          </Box>
+        </Box>
+      )}
+
+      {/* ── Ollama ── */}
+      {step === 'ollama' && (
+        <Box flexDirection="column">
+          <Box marginBottom={1}>
+            <Text bold>Ollama 本地模型配置：</Text>
+          </Box>
+          {ollamaStatus ? (
+            <Box flexDirection="column" marginBottom={1}>
+              <Text>
+                状态：{ollamaStatus.installed ? '✅ 已安装' : '❌ 未安装'}
+                {ollamaStatus.running ? ' · 运行中' : ''}
+              </Text>
+              {ollamaStatus.models.length > 0 && (
+                <Text dimColor>已下载模型：{ollamaStatus.models.join(', ')}</Text>
+              )}
+            </Box>
+          ) : (
+            <Text dimColor>正在检测 Ollama...</Text>
+          )}
+          <Box marginTop={1}>
+            <Text dimColor>输入 Ollama 模型名称（如 llama3.2, qwen2.5, deepseek-r1）：</Text>
+          </Box>
+          <Box marginTop={1}>
+            <Text color="yellow">🖥️ </Text>
+            <TextInput
+              value={ollamaModel}
+              onChange={setOllamaModel}
+              onSubmit={() => goStep('confirm')}
+              placeholder="模型名，默认 llama3.2"
+            />
+          </Box>
+          <Box marginTop={1}>
+            <Text dimColor>Enter 继续 · Esc 返回</Text>
+          </Box>
+        </Box>
+      )}
+
+      {/* ── Confirm ── */}
+      {step === 'confirm' && (
+        <Box flexDirection="column">
+          <Box marginBottom={1}>
+            <Text bold color="cyan">
+              配置确认：
+            </Text>
+          </Box>
+          <Text>连接方式：{mode === 'cloud' ? '🌐 云端' : '🖥️ 本地'}</Text>
+          {mode === 'cloud' && (
+            <>
+              <Text>提供商：{DEFAULT_PROVIDERS.find((p) => p.id === providerId)?.name}</Text>
+              <Text>模型：{modelId}</Text>
+              <Text>
+                API Key：{apiKey.slice(0, 8)}...{apiKey.slice(-4)}
+              </Text>
+            </>
+          )}
+          {mode === 'local' && <Text>Ollama 模型：{ollamaModel.trim() || 'llama3.2'}</Text>}
+          <Box marginTop={1}>
+            <Text dimColor>配置文件将保存到 ~/.mipham/config.yml</Text>
+          </Box>
+          {error && (
+            <Box marginBottom={1}>
+              <Text color="red">⚠ {error}</Text>
+            </Box>
+          )}
+          <Box marginTop={1}>
+            <Text color="yellow">按 Enter 保存并启动 →</Text>
+          </Box>
+          <Box marginTop={1}>
+            <Text dimColor>Esc 返回修改</Text>
+          </Box>
+        </Box>
+      )}
+
+      {/* ── Done ── */}
+      {step === 'done' && (
+        <Box flexDirection="column">
+          <Box marginBottom={1}>
+            <Text color="green" bold>
+              ✅ 配置完成！
+            </Text>
+          </Box>
+          <Text>Mipham Code 正在启动...</Text>
+        </Box>
+      )}
+    </Box>
+  )
+}