@miphamai/cli 0.46.0 → 0.48.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miphamai/cli",
-  "version": "0.46.0",
+  "version": "0.48.0",
   "description": "Mipham Code — Multi-model open-core intelligent coding terminal by MiphamAI",
   "keywords": [
     "ai",
@@ -41,6 +41,7 @@
     "test": "vitest run"
   },
   "dependencies": {
+    "@larksuiteoapi/node-sdk": "^1.73.0",
     "commander": "^13.1.0",
     "ink": "^5.2.1",
     "ink-text-input": "^6.0.0",

package/src/agent/agent-context.ts

@@ -102,10 +102,12 @@ export function createAgentContext(
   contextWindow?: number,
   crsiConfig?: Partial<CrsiConfig>,
 ): AgentContextResult {
-  // Create isolated context
+  // Create isolated context, sized to the resolved model's window when known.
+  // Passing contextWindow (not just maxTokens) enables adaptive thresholds.
   const context = new ContextManager({
     maxTokens: contextWindow || 100_000,
     compactionThreshold: 0.85,
+    contextWindow,
   })
 
   // Build system prompt with optional agent memory

package/src/agent/sub-agent.ts

@@ -254,7 +254,35 @@ export class SubAgent {
     const systemPrompt =
       agentDef?.systemPrompt || options.systemPrompt || TYPE_SYSTEM_PROMPTS[agentType]
 
-    // Create isolated context with tool scoping
+    // Resolve the sub-agent's model first, so its context window is known
+    // before the isolated context is created (model-aware sizing).
+    const modelToUse = options.modelOverride || agentDef?.model || model
+    // 'inherit' means use parent model
+    const resolvedModel = modelToUse === 'inherit' ? model : modelToUse
+
+    // Validate resolved model exists in registry; fall back to parent model with warning
+    let finalModel = resolvedModel
+    if (resolvedModel !== model) {
+      const modelExists = this.registry.findModel(resolvedModel) !== undefined
+      if (!modelExists) {
+        const warnMsg = `Warning: model "${resolvedModel}" not found in provider registry. Falling back to "${model}".`
+        console.warn(warnMsg)
+
+        // Post warning to message bus for UI display
+        const bus = getMessageBus()
+        bus.post(
+          'system',
+          'main',
+          `Sub-agent model fallback: ${resolvedModel} → ${model}`,
+          warnMsg,
+          'warning',
+        )
+
+        finalModel = model
+      }
+    }
+
+    // Create isolated context with tool scoping, sized to the resolved model.
     const resolvedDef: AgentDefinition = agentDef || {
       name: agentType,
       description: '',
@@ -264,10 +292,11 @@ export class SubAgent {
       background: false,
       source: 'builtin',
     }
+    const contextWindow = this.registry.findModel(finalModel)?.contextWindow
     const { context, allowedTools } = createAgentContext(
       resolvedDef,
       this.toolRegistry,
-      options.maxContextMessages,
+      contextWindow,
     )
 
     context.setSystemPrompt(systemPrompt)
@@ -291,32 +320,6 @@ export class SubAgent {
           }))
         : undefined
 
-    const modelToUse = options.modelOverride || agentDef?.model || model
-    // 'inherit' means use parent model
-    const resolvedModel = modelToUse === 'inherit' ? model : modelToUse
-
-    // Validate resolved model exists in registry; fall back to parent model with warning
-    let finalModel = resolvedModel
-    if (resolvedModel !== model) {
-      const modelExists = this.registry.findModel(resolvedModel) !== undefined
-      if (!modelExists) {
-        const warnMsg = `Warning: model "${resolvedModel}" not found in provider registry. Falling back to "${model}".`
-        console.warn(warnMsg)
-
-        // Post warning to message bus for UI display
-        const bus = getMessageBus()
-        bus.post(
-          'system',
-          'main',
-          `Sub-agent model fallback: ${resolvedModel} → ${model}`,
-          warnMsg,
-          'warning',
-        )
-
-        finalModel = model
-      }
-    }
-
     const chunks: string[] = []
     const MAX_TOOL_TURNS = options.maxTurns || 5
 

package/src/agent/types.ts

@@ -39,7 +39,6 @@ export interface SubAgentOptions {
   type?: SubAgentType
   agentDef?: AgentDefinition
   systemPrompt?: string
-  maxContextMessages?: number
   allowedTools?: string[]
   modelOverride?: string
   /** Maximum tool-calling turns (default: 5) to prevent infinite loops. */

package/src/core/engine.ts

@@ -1431,7 +1431,7 @@ export class QueryEngine {
         const DISABLE_1M = process.env.MIPHAM_DISABLE_1M_CONTEXT === '1'
         const maxTokens =
           DISABLE_1M && model.contextWindow > 200_000 ? 200_000 : model.contextWindow
-        this.context.updateMaxTokens(maxTokens)
+        this.context.updateMaxTokens(maxTokens, model.contextWindow)
       }
     }
   }

package/src/daemon/feishu/adapter.ts

@@ -0,0 +1,79 @@
+import { createFeishuApi } from './api.js'
+import { createFeishuEventDispatcher } from './events.js'
+import type { FeishuConfig, FeishuTextMessage } from './types.js'
+import type { SessionManager } from '../session-manager'
+import type { SessionWorker } from '../session-worker'
+import type { RateLimiter } from '../rate-limiter'
+
+export interface FeishuAdapterDeps {
+  sm: SessionManager
+  getOrCreateWorker: (sessionId: string) => SessionWorker | null
+  rateLimiter: RateLimiter
+  cwd: string
+  provider: string
+  model: string
+}
+
+export interface FeishuAdapter {
+  handleEvent(request: Request): Promise<Response>
+  isAllowed(openId: string): boolean
+}
+
+export function createFeishuAdapter(config: FeishuConfig, deps: FeishuAdapterDeps): FeishuAdapter {
+  const api = createFeishuApi(config)
+  const allowed = new Set(config.allowedOpenIds)
+
+  const onMessage = async (msg: FeishuTextMessage) => {
+    try {
+      if (!allowed.has(msg.openId)) return
+      if (!deps.rateLimiter.check(`feishu:${msg.openId}`).allowed) return
+
+      const session = deps.sm.getOrCreateByFeishuOpenId(
+        msg.openId,
+        deps.cwd,
+        deps.provider,
+        deps.model,
+      )
+      const worker = deps.getOrCreateWorker(session.id)
+      if (!worker) {
+        await api.sendText(msg.openId, '（会话初始化失败，请稍后重试）')
+        return
+      }
+      await worker.processPrompt(msg.text)
+      const result = worker.getLastAssistantContent()
+      await api.sendText(msg.openId, result ? result.slice(0, 4000) : '（无回复）')
+    } catch (err) {
+      console.error('[feishu] message handling failed:', err)
+      try {
+        await api.sendText(msg.openId, '（处理失败，请稍后重试）')
+      } catch {
+        /* 忽略回送失败，确保不 rethrow → Feishu 不重试 */
+      }
+    }
+  }
+
+  const dispatcher = createFeishuEventDispatcher(config, onMessage)
+
+  return {
+    isAllowed: (openId) => allowed.has(openId),
+    async handleEvent(request: Request): Promise<Response> {
+      let body: unknown = {}
+      try {
+        body = await request.json()
+      } catch {
+        /* 非 JSON body 容忍 */
+      }
+      // URL 验证：回显 challenge（未加密）
+      if (body && typeof body === 'object' && 'challenge' in (body as object)) {
+        return Response.json({ challenge: (body as { challenge: string }).challenge })
+      }
+      const headers: Record<string, string> = {}
+      request.headers.forEach((v, k) => (headers[k] = v))
+      const result = await dispatcher.invoke(body, headers)
+      if (!result.ok) {
+        return Response.json({ code: 1, msg: result.reason }, { status: 400 })
+      }
+      return Response.json({ code: 0 })
+    },
+  }
+}

package/src/daemon/feishu/api.ts

@@ -0,0 +1,23 @@
+import * as lark from '@larksuiteoapi/node-sdk'
+import type { FeishuConfig } from './types.js'
+
+export interface FeishuApi {
+  sendText(openId: string, text: string): Promise<void>
+}
+
+export function createFeishuApi(config: FeishuConfig): FeishuApi {
+  const client = new lark.Client({
+    appId: config.appId,
+    appSecret: config.appSecret,
+    appType: lark.AppType.SelfBuild,
+    domain: lark.Domain.Feishu,
+  })
+  return {
+    async sendText(openId: string, text: string): Promise<void> {
+      await client.im.message.create({
+        params: { receive_id_type: 'open_id' },
+        data: { receive_id: openId, msg_type: 'text', content: JSON.stringify({ text }) },
+      })
+    },
+  }
+}

package/src/daemon/feishu/env.ts

@@ -0,0 +1,22 @@
+import type { FeishuConfig } from './types.js'
+
+export function parseFeishuEnv(): FeishuConfig | null {
+  const appId = process.env.FEISHU_APP_ID
+  const appSecret = process.env.FEISHU_APP_SECRET
+  const encryptKey = process.env.FEISHU_ENCRYPT_KEY || ''
+  const verificationToken = process.env.FEISHU_VERIFICATION_TOKEN || ''
+  // Fail-closed：encryptKey 必填。lark SDK 对 im.message.receive_v1 事件流的签名验证
+  // 只依赖 encryptKey（checkIsEventValidated 在空 key 时静默返回 true）；
+  // verificationToken 仅用于 URL challenge 握手，不保护事件流，故保持可选。
+  if (!appId || !appSecret || !encryptKey) return null
+  return {
+    appId,
+    appSecret,
+    encryptKey,
+    verificationToken,
+    allowedOpenIds: (process.env.FEISHU_ALLOWED_OPEN_IDS || '')
+      .split(',')
+      .map((s) => s.trim())
+      .filter(Boolean),
+  }
+}

package/src/daemon/feishu/events.ts

@@ -0,0 +1,53 @@
+import * as lark from '@larksuiteoapi/node-sdk'
+import type { FeishuConfig, FeishuTextMessage } from './types.js'
+
+export type OnFeishuMessage = (msg: FeishuTextMessage) => Promise<void>
+
+export type FeishuInvokeResult =
+  { ok: true } | { ok: false; reason: 'invalid_signature' | 'no_handler' | 'parse_failed' }
+
+export interface FeishuEventDispatcher {
+  invoke(body: unknown, headers: Record<string, string>): Promise<FeishuInvokeResult>
+}
+
+export function createFeishuEventDispatcher(
+  config: FeishuConfig,
+  onMessage: OnFeishuMessage,
+): FeishuEventDispatcher {
+  const dispatcher = new lark.EventDispatcher({
+    encryptKey: config.encryptKey,
+    verificationToken: config.verificationToken,
+  }).register({
+    'im.message.receive_v1': async (data: any): Promise<true> => {
+      const message = data?.message
+      if (message?.message_type !== 'text') return true
+      let text = ''
+      try {
+        text = JSON.parse(message.content).text ?? ''
+      } catch {
+        return true
+      }
+      const openId = data?.sender?.sender_id?.open_id
+      if (!openId || !text) return true
+      await onMessage({ chatId: message.chat_id, messageId: message.message_id, openId, text })
+      return true
+    },
+  })
+
+  return {
+    async invoke(body, headers): Promise<FeishuInvokeResult> {
+      const assigned = Object.assign(Object.create({ headers }), body)
+      let raw: unknown
+      try {
+        raw = await dispatcher.invoke(assigned)
+      } catch {
+        return { ok: false, reason: 'parse_failed' }
+      }
+      if (raw === undefined) return { ok: false, reason: 'invalid_signature' }
+      if (typeof raw === 'string' && raw.startsWith('no ')) {
+        return { ok: false, reason: 'no_handler' }
+      }
+      return { ok: true }
+    },
+  }
+}

package/src/daemon/feishu/types.ts

@@ -0,0 +1,14 @@
+export interface FeishuConfig {
+  appId: string
+  appSecret: string
+  encryptKey: string
+  verificationToken: string
+  allowedOpenIds: string[]
+}
+
+export interface FeishuTextMessage {
+  chatId: string
+  messageId: string
+  openId: string
+  text: string
+}

package/src/daemon/index.ts

@@ -23,6 +23,9 @@ import { RateLimiter } from './rate-limiter'
 import { PACKAGE_VERSION } from '../shared/package-info'
 import type { DaemonStatus } from './types'
 import { logger } from './logger'
+import { parseFeishuEnv } from './feishu/env.js'
+import type { FeishuConfig } from './feishu/types.js'
+import { loadConfig } from '../config/loader'
 
 const HOME = homedir()
 const MIPHAM_HOME = join(HOME, '.mipham')
@@ -163,6 +166,21 @@ export async function startDaemon(): Promise<{ port: number; token: string }> {
   const rateLimiter = new RateLimiter(100, 60_000)
   activeRateLimiter = rateLimiter
 
+  // Feishu remote-control adapter（env 未配置时跳过；配置则解析 session 默认 provider/model）
+  const feishuConfig = parseFeishuEnv()
+  let feishu: { config: FeishuConfig; cwd: string; provider: string; model: string } | undefined
+  if (feishuConfig) {
+    const cfg = loadConfig()
+    // 取第一个非 upcoming（即非「待上线」）的 provider 及其首个 model
+    const provider = cfg.providers.find((p) => p.status !== 'upcoming') ?? cfg.providers[0]
+    feishu = {
+      config: feishuConfig,
+      cwd: process.env.FEISHU_CWD || process.cwd(),
+      provider: provider?.id ?? 'anthropic',
+      model: provider?.models?.[0]?.id ?? 'claude-sonnet-5',
+    }
+  }
+
   // Start HTTP server (Bun.serve starts listening immediately)
   const server = createServer({
     db,
@@ -177,6 +195,7 @@ export async function startDaemon(): Promise<{ port: number; token: string }> {
     goalManager,
     scheduleManager,
     rateLimiter,
+    feishu,
   })
   activeServer = server
 

package/src/daemon/server.ts

@@ -23,6 +23,8 @@ import { createToolRegistry } from '../tools'
 import { PermissionSystem } from '../core/permission'
 import type { ProviderRegistry } from '../providers/registry'
 import type { ToolDefinition, PermissionMode } from '../shared/types'
+import { createFeishuAdapter } from './feishu/adapter.js'
+import type { FeishuConfig } from './feishu/types.js'
 
 interface ServerConfig {
   db: DaemonDatabase
@@ -37,6 +39,7 @@ interface ServerConfig {
   goalManager: GoalManager
   scheduleManager: ScheduleManager
   rateLimiter: RateLimiter
+  feishu?: { config: FeishuConfig; cwd: string; provider: string; model: string }
 }
 
 interface WsData {
@@ -64,6 +67,22 @@ function resolveDaemonPermission(): PermissionMode {
     : 'default'
 }
 
+const DAEMON_DEFAULT_CONTEXT_WINDOW = 200_000
+
+/**
+ * Resolve the effective context window (in tokens) for the daemon session's
+ * model. Mirrors the CLI's model-aware context sizing so a 1M-context model
+ * isn't silently hard-capped at 200K; falls back when the model isn't in the
+ * registry.
+ */
+export function resolveContextWindow(
+  registry: ProviderRegistry,
+  modelId: string,
+  fallback = DAEMON_DEFAULT_CONTEXT_WINDOW,
+): number {
+  return registry.findModel(modelId)?.contextWindow ?? fallback
+}
+
 export function createServer(config: ServerConfig): Server<WsData> {
   const {
     db,
@@ -78,6 +97,7 @@ export function createServer(config: ServerConfig): Server<WsData> {
     goalManager,
     scheduleManager,
     rateLimiter,
+    feishu,
   } = config
 
   const wsClients = new Map<string, Set<ServerWebSocket<WsData>>>()
@@ -116,7 +136,6 @@ export function createServer(config: ServerConfig): Server<WsData> {
   const engineCache = new Map<string, QueryEngine>()
   let sharedRegistry: ProviderRegistry | null = null
   let sharedTools: Map<string, ToolDefinition> | null = null
-  const DEFAULT_MAX_TOKENS = 200_000
 
   function getOrCreateEngine(
     sessionId: string,
@@ -144,11 +163,13 @@ export function createServer(config: ServerConfig): Server<WsData> {
       sharedTools = createToolRegistry()
     }
 
-    // Create per-session context, restoring previous messages from DB
+    // Create per-session context, restoring previous messages from DB.
+    // Size it to the active model's context window (1M-capable models get 1M).
+    const contextWindow = resolveContextWindow(sharedRegistry!, model)
     const context = new ContextManager({
-      maxTokens: DEFAULT_MAX_TOKENS,
+      maxTokens: contextWindow,
       compactionThreshold: 0.9,
-      contextWindow: DEFAULT_MAX_TOKENS,
+      contextWindow,
     })
 
     const dbMessages = db.getMessages(sessionId, 10000)
@@ -198,6 +219,18 @@ export function createServer(config: ServerConfig): Server<WsData> {
     }
   }
 
+  // ── Feishu remote-control adapter（独立签名验证，复用同一 worker 池）──
+  const feishuAdapter = feishu
+    ? createFeishuAdapter(feishu.config, {
+        sm,
+        getOrCreateWorker,
+        rateLimiter,
+        cwd: feishu.cwd,
+        provider: feishu.provider,
+        model: feishu.model,
+      })
+    : undefined
+
   const server = Bun.serve<WsData>({
     port,
     hostname,
@@ -211,6 +244,11 @@ export function createServer(config: ServerConfig): Server<WsData> {
       const method = req.method
       logger.info('request', { method, path })
 
+      // ── Feishu event callback（独立签名验证，不经过 daemon Bearer 鉴权）──
+      if (feishuAdapter && method === 'POST' && path === '/feishu/event') {
+        return await feishuAdapter.handleEvent(req)
+      }
+
       // ── Rate limiting (skip health endpoint) ──────────
       if (path !== '/api/v1/health') {
         const ip = server.requestIP(req)?.address || 'unknown'

package/src/daemon/session-manager.ts

@@ -23,6 +23,18 @@ export class SessionManager {
     return this.db.listSessions(status)
   }
 
+  getOrCreateByFeishuOpenId(
+    openId: string,
+    cwd: string,
+    provider: string,
+    model: string,
+  ): DaemonSession {
+    const name = `feishu-${openId}`
+    const existing = this.db.listSessions().find((s) => s.name === name && s.status !== 'closed')
+    if (existing) return existing
+    return this.db.createSession({ name, cwd, provider, model })
+  }
+
   closeSession(id: string): void {
     this.db.closeSession(id)
     for (const cb of this.closeCallbacks) {

package/src/daemon/session-worker.ts

@@ -253,6 +253,11 @@ export class SessionWorker {
     return this.session.id
   }
 
+  /** Get the last assistant text content from the underlying engine. */
+  getLastAssistantContent(): string | undefined {
+    return this.engine.getLastAssistantContent()
+  }
+
   // ── Persistence ────────────────────────────────────────────────────────
 
   /**

package/src/i18n-core/locales/en-US.json

@@ -718,6 +718,79 @@
       "shift_tab_cycle": "shift+tab",
       "left_for_agents": "ctrl+g agents to manage",
       "mipham_modes": "Mipham"
+    },
+    "wizard": {
+      "header_subtitle": " — Configuration Wizard",
+      "welcome_title": "Welcome to Mipham Code!",
+      "welcome_intro": "Before you start, you need to configure your AI model connection.",
+      "welcome_time": "This wizard takes about 1 minute — please have your API key ready.",
+      "welcome_start": "Press Enter to start →",
+      "welcome_skip": "Esc to skip",
+      "mode_title": "Choose connection method:",
+      "mode_cloud": "🌐 Cloud AI models (recommended)",
+      "mode_local": "🖥️ Local models (Ollama)",
+      "mode_local_hint": " Requires Ollama installed with models downloaded",
+      "nav_hint": "↑↓ select · Enter confirm · Esc back",
+      "provider_title": "Choose AI model provider:",
+      "provider_count": " ({count} models)",
+      "model_title": "Choose model ({provider}):",
+      "apikey_title": "Paste your API key:",
+      "apikey_provider": "Provider: {provider}",
+      "apikey_model": "Model: {model}",
+      "apikey_placeholder": "Paste API key then press Enter...",
+      "apikey_continue": "Enter to continue · Esc to go back to model",
+      "ollama_title": "Ollama local model configuration:",
+      "ollama_status": "Status: ",
+      "ollama_installed": "✅ installed",
+      "ollama_not_installed": "❌ not installed",
+      "ollama_running": " · running",
+      "ollama_not_running": " · not running (run ollama serve)",
+      "ollama_detecting": "Detecting Ollama...",
+      "ollama_downloaded": "Downloaded models (↑↓ select · Enter confirm):",
+      "ollama_source_hot": "Popular",
+      "ollama_no_models": "No downloaded models found. Run ollama pull <model> to download one.",
+      "ollama_preset_hint": "Below are preset models — switch anytime via /models.",
+      "confirm_title": "Confirm configuration:",
+      "confirm_connection": "Connection: ",
+      "confirm_cloud": "🌐 Cloud",
+      "confirm_local": "🖥️ Local",
+      "confirm_provider": "Provider: {provider}",
+      "confirm_model": "Model: {model}",
+      "confirm_apikey": "API key: {masked}",
+      "confirm_ollama_model": "Ollama model: {model}",
+      "confirm_save_path": "Config will be saved to ~/.mipham/config.yml",
+      "confirm_save": "Press Enter to save and launch →",
+      "confirm_back": "Esc to go back",
+      "done_title": "✅ Configuration complete!",
+      "done_launching": "Mipham Code is starting...",
+      "error_apikey_required": "Please enter your API key",
+      "error_write_failed": "Failed to write config: {err}"
+    },
+    "goal_progress": {
+      "title": "🎯 Goal: {goal}",
+      "no_subtasks": " (no subtasks yet)",
+      "summary": "═══ {done}/{total} done",
+      "in_progress": " · {n} in progress",
+      "failed": " · {n} failed",
+      "tokens": " · {n} tokens",
+      "border_end": " ═══"
+    },
+    "workflow": {
+      "title": "═══ Workflow: {runId} ═══",
+      "phase": "Phase: {name}",
+      "done_count": " [{done}/{total} done]",
+      "footer": "═══ Elapsed: {time} | Agents: {done}/{total}",
+      "running": " ({n} running)",
+      "failed": " ({n} failed)",
+      "cache_hits": " | Cache hits: {n}",
+      "done_marker": " | DONE ═══",
+      "running_marker": " | Status: running ═══"
+    },
+    "error_boundary": {
+      "title": "⚠️ UI Render Error",
+      "unknown": "Unknown rendering error",
+      "recovery": "The terminal interface encountered a rendering issue. Auto-recovery in 5 seconds... Press Enter to attempt immediate recovery.",
+      "preserved": "Your session data and conversation history are preserved."
     }
   },
   "tools": {

package/src/i18n-core/locales/zh-CN.json

@@ -718,6 +718,79 @@
       "shift_tab_cycle": "Shift+Tab",
       "left_for_agents": "ctrl+g 管理代理",
       "mipham_modes": "Mipham独有"
+    },
+    "wizard": {
+      "header_subtitle": " — 配置向导",
+      "welcome_title": "欢迎使用 Mipham Code！",
+      "welcome_intro": "在开始之前，需要先配置 AI 模型连接。",
+      "welcome_time": "此向导只需 1 分钟，需要您准备好 API Key。",
+      "welcome_start": "按 Enter 开始 →",
+      "welcome_skip": "Esc 跳过配置",
+      "mode_title": "选择模型连接方式：",
+      "mode_cloud": "🌐 云端 AI 模型（推荐）",
+      "mode_local": "🖥️ 本地模型（Ollama）",
+      "mode_local_hint": " 需要提前安装 Ollama 并下载模型",
+      "nav_hint": "↑↓ 选择 · Enter 确认 · Esc 返回",
+      "provider_title": "选择 AI 模型提供商：",
+      "provider_count": " ({count} 个模型)",
+      "model_title": "选择模型（{provider}）：",
+      "apikey_title": "粘贴 API Key：",
+      "apikey_provider": "提供商：{provider}",
+      "apikey_model": "模型：{model}",
+      "apikey_placeholder": "粘贴 API Key 后按 Enter...",
+      "apikey_continue": "Enter 继续 · Esc 返回选模型",
+      "ollama_title": "Ollama 本地模型配置：",
+      "ollama_status": "状态：",
+      "ollama_installed": "✅ 已安装",
+      "ollama_not_installed": "❌ 未安装",
+      "ollama_running": " · 运行中",
+      "ollama_not_running": " · 未运行（请执行 ollama serve）",
+      "ollama_detecting": "正在检测 Ollama...",
+      "ollama_downloaded": "已下载模型（↑↓ 选择 · Enter 确认）：",
+      "ollama_source_hot": "热门",
+      "ollama_no_models": "未检测到已下载模型。请先运行 ollama pull <model> 下载模型。",
+      "ollama_preset_hint": "以下为预置模型列表，选择后可在对话中通过 /models 切换。",
+      "confirm_title": "配置确认：",
+      "confirm_connection": "连接方式：",
+      "confirm_cloud": "🌐 云端",
+      "confirm_local": "🖥️ 本地",
+      "confirm_provider": "提供商：{provider}",
+      "confirm_model": "模型：{model}",
+      "confirm_apikey": "API Key：{masked}",
+      "confirm_ollama_model": "Ollama 模型：{model}",
+      "confirm_save_path": "配置文件将保存到 ~/.mipham/config.yml",
+      "confirm_save": "按 Enter 保存并启动 →",
+      "confirm_back": "Esc 返回修改",
+      "done_title": "✅ 配置完成！",
+      "done_launching": "Mipham Code 正在启动...",
+      "error_apikey_required": "请填写 API Key",
+      "error_write_failed": "写入配置失败: {err}"
+    },
+    "goal_progress": {
+      "title": "🎯 目标：{goal}",
+      "no_subtasks": " （暂无子任务）",
+      "summary": "═══ {done}/{total} 完成",
+      "in_progress": " · {n} 进行中",
+      "failed": " · {n} 失败",
+      "tokens": " · {n} tokens",
+      "border_end": " ═══"
+    },
+    "workflow": {
+      "title": "═══ 工作流：{runId} ═══",
+      "phase": "阶段：{name}",
+      "done_count": " [{done}/{total} 完成]",
+      "footer": "═══ 耗时：{time} | Agent：{done}/{total}",
+      "running": " （{n} 运行中）",
+      "failed": " （{n} 失败）",
+      "cache_hits": " | 缓存命中：{n}",
+      "done_marker": " | 完成 ═══",
+      "running_marker": " | 状态：运行中 ═══"
+    },
+    "error_boundary": {
+      "title": "⚠️ UI 渲染错误",
+      "unknown": "未知渲染错误",
+      "recovery": "终端界面遇到渲染问题，5 秒后自动恢复... 按 Enter 尝试立即恢复。",
+      "preserved": "你的会话数据和对话历史已保留。"
     }
   },
   "tools": {

package/src/shared/package-info.ts

@@ -9,7 +9,7 @@
 export const PACKAGE_NAME = '@miphamai/cli' as const
 
 /** 当前发布版本 */
-export const PACKAGE_VERSION = '0.46.0' as const
+export const PACKAGE_VERSION = '0.48.0' as const
 
 /** npm install 全局安装命令 */
 export const NPM_INSTALL_COMMAND = `npm install -g ${PACKAGE_NAME}` as const

package/src/ui/config-wizard.tsx

@@ -10,6 +10,7 @@
 
 import React, { useState, useEffect } from 'react'
 import { Box, Text, useInput } from 'ink'
+import { useI18n } from '../i18n-context'
 import TextInput from 'ink-text-input'
 import { DEFAULT_PROVIDERS, OLLAMA_PRESET_MODELS } from '../shared/constants'
 import type { ProviderConfig, ModelInfo } from '../shared/types'
@@ -167,6 +168,7 @@ function getOllamaModelList(installedModels: string[]): OllamaModelItem[] {
 // ── Component ──
 
 export function ConfigWizard({ onComplete, onSkip }: Props) {
+  const { t } = useI18n()
   const [step, setStep] = useState<Step>('welcome')
 
   // Selections
@@ -202,14 +204,14 @@ export function ConfigWizard({ onComplete, onSkip }: Props) {
 
   const finishCloud = () => {
     if (!providerId || !modelId || !apiKey.trim()) {
-      setError('请填写 API Key')
+      setError(t('ui.wizard.error_apikey_required'))
       return
     }
     try {
       writeConfigFile(providerId, modelId, apiKey.trim())
       onComplete({ providerId, modelId, apiKey: apiKey.trim() })
     } catch (err) {
-      setError(`写入配置失败: ${String(err)}`)
+      setError(t('ui.wizard.error_write_failed', { err: String(err) }))
     }
   }
 
@@ -220,7 +222,7 @@ export function ConfigWizard({ onComplete, onSkip }: Props) {
       writeConfigFile('ollama', model, 'ollama-local')
       onComplete({ providerId: 'ollama', modelId: model, apiKey: 'ollama-local' })
     } catch (err) {
-      setError(`写入配置失败: ${String(err)}`)
+      setError(t('ui.wizard.error_write_failed', { err: String(err) }))
     }
   }
 
@@ -366,7 +368,7 @@ export function ConfigWizard({ onComplete, onSkip }: Props) {
         <Text color="#FFD700" bold>
           Mipham Code
         </Text>
-        <Text dimColor> — 配置向导</Text>
+        <Text dimColor>{t('ui.wizard.header_subtitle')}</Text>
       </Box>
       <Box marginBottom={1}>
         <Text dimColor>━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</Text>
@@ -377,16 +379,16 @@ export function ConfigWizard({ onComplete, onSkip }: Props) {
         <Box flexDirection="column">
           <Box marginBottom={1}>
             <Text bold color="cyan">
-              欢迎使用 Mipham Code！
+              {t('ui.wizard.welcome_title')}
             </Text>
           </Box>
-          <Text>在开始之前，需要先配置 AI 模型连接。</Text>
-          <Text>此向导只需 1 分钟，需要您准备好 API Key。</Text>
+          <Text>{t('ui.wizard.welcome_intro')}</Text>
+          <Text>{t('ui.wizard.welcome_time')}</Text>
           <Box marginTop={1}>
-            <Text color="yellow">按 Enter 开始 →</Text>
+            <Text color="yellow">{t('ui.wizard.welcome_start')}</Text>
           </Box>
           <Box marginTop={1}>
-            <Text dimColor>Esc 跳过配置</Text>
+            <Text dimColor>{t('ui.wizard.welcome_skip')}</Text>
           </Box>
         </Box>
       )}
@@ -395,25 +397,25 @@ export function ConfigWizard({ onComplete, onSkip }: Props) {
       {step === 'mode' && (
         <Box flexDirection="column">
           <Box marginBottom={1}>
-            <Text bold>选择模型连接方式：</Text>
+            <Text bold>{t('ui.wizard.mode_title')}</Text>
           </Box>
 
           <Box marginBottom={1}>
             <Text color={cursor === 0 ? SELECTED_COLOR : undefined}>
-              {cursor === 0 ? '▶' : ' '} 🌐 云端 AI 模型（推荐）
+              {cursor === 0 ? '▶' : ' '} {t('ui.wizard.mode_cloud')}
             </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）
+              {cursor === 1 ? '▶' : ' '} {t('ui.wizard.mode_local')}
             </Text>
           </Box>
-          <Text dimColor> 需要提前安装 Ollama 并下载模型</Text>
+          <Text dimColor>{t('ui.wizard.mode_local_hint')}</Text>
 
           <Box marginTop={2}>
-            <Text dimColor>↑↓ 选择 · Enter 确认 · Esc 返回</Text>
+            <Text dimColor>{t('ui.wizard.nav_hint')}</Text>
           </Box>
         </Box>
       )}
@@ -422,18 +424,22 @@ export function ConfigWizard({ onComplete, onSkip }: Props) {
       {step === 'provider' && (
         <Box flexDirection="column">
           <Box marginBottom={1}>
-            <Text bold>选择 AI 模型提供商：</Text>
+            <Text bold>{t('ui.wizard.provider_title')}</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>
+              <Text dimColor>
+                {t('ui.wizard.provider_count', {
+                  count: String(p.models.filter((m) => m.status === 'active').length),
+                })}
+              </Text>
             </Box>
           ))}
           <Box marginTop={1}>
-            <Text dimColor>↑↓ 选择 · Enter 确认 · Esc 返回</Text>
+            <Text dimColor>{t('ui.wizard.nav_hint')}</Text>
           </Box>
         </Box>
       )}
@@ -443,7 +449,10 @@ export function ConfigWizard({ onComplete, onSkip }: Props) {
         <Box flexDirection="column">
           <Box marginBottom={1}>
             <Text bold>
-              选择模型（{DEFAULT_PROVIDERS.find((p) => p.id === providerId)?.name || providerId}）：
+              {t('ui.wizard.model_title', {
+                provider:
+                  DEFAULT_PROVIDERS.find((p) => p.id === providerId)?.name || providerId || '',
+              })}
             </Text>
           </Box>
           {modelList.map((m, i) => (
@@ -455,7 +464,7 @@ export function ConfigWizard({ onComplete, onSkip }: Props) {
             </Box>
           ))}
           <Box marginTop={1}>
-            <Text dimColor>↑↓ 选择 · Enter 确认 · Esc 返回</Text>
+            <Text dimColor>{t('ui.wizard.nav_hint')}</Text>
           </Box>
         </Box>
       )}
@@ -464,11 +473,17 @@ export function ConfigWizard({ onComplete, onSkip }: Props) {
       {step === 'apikey' && (
         <Box flexDirection="column">
           <Box marginBottom={1}>
-            <Text bold>粘贴 API Key：</Text>
+            <Text bold>{t('ui.wizard.apikey_title')}</Text>
           </Box>
-          <Text dimColor>提供商：{DEFAULT_PROVIDERS.find((p) => p.id === providerId)?.name}</Text>
           <Text dimColor>
-            模型：{getActiveModels(providerId!).find((m) => m.id === modelId)?.name}
+            {t('ui.wizard.apikey_provider', {
+              provider: DEFAULT_PROVIDERS.find((p) => p.id === providerId)?.name || '',
+            })}
+          </Text>
+          <Text dimColor>
+            {t('ui.wizard.apikey_model', {
+              model: getActiveModels(providerId!).find((m) => m.id === modelId)?.name || '',
+            })}
           </Text>
           {error && (
             <Box marginBottom={1}>
@@ -481,11 +496,11 @@ export function ConfigWizard({ onComplete, onSkip }: Props) {
               value={apiKey}
               onChange={setApiKey}
               onSubmit={() => goStep('confirm')}
-              placeholder="粘贴 API Key 后按 Enter..."
+              placeholder={t('ui.wizard.apikey_placeholder')}
             />
           </Box>
           <Box marginTop={1}>
-            <Text dimColor>Enter 继续 · Esc 返回选模型</Text>
+            <Text dimColor>{t('ui.wizard.apikey_continue')}</Text>
           </Box>
         </Box>
       )}
@@ -494,26 +509,29 @@ export function ConfigWizard({ onComplete, onSkip }: Props) {
       {step === 'ollama' && (
         <Box flexDirection="column">
           <Box marginBottom={1}>
-            <Text bold>Ollama 本地模型配置：</Text>
+            <Text bold>{t('ui.wizard.ollama_title')}</Text>
           </Box>
           {ollamaStatus ? (
             <Box flexDirection="column" marginBottom={1}>
               <Text>
-                状态：{ollamaStatus.installed ? '✅ 已安装' : '❌ 未安装'}
+                {t('ui.wizard.ollama_status')}
+                {ollamaStatus.installed
+                  ? t('ui.wizard.ollama_installed')
+                  : t('ui.wizard.ollama_not_installed')}
                 {ollamaStatus.running
-                  ? ' · 运行中'
+                  ? t('ui.wizard.ollama_running')
                   : ollamaStatus.installed
-                    ? ' · 未运行（请执行 ollama serve）'
+                    ? t('ui.wizard.ollama_not_running')
                     : ''}
               </Text>
             </Box>
           ) : (
-            <Text dimColor>正在检测 Ollama...</Text>
+            <Text dimColor>{t('ui.wizard.ollama_detecting')}</Text>
           )}
           {ollamaModelList.length > 0 && (
             <Box flexDirection="column" marginBottom={1}>
               <Box marginBottom={1}>
-                <Text dimColor>已下载模型（↑↓ 选择 · Enter 确认）：</Text>
+                <Text dimColor>{t('ui.wizard.ollama_downloaded')}</Text>
               </Box>
               {ollamaModelList.map((m, i) => (
                 <Box key={m.id}>
@@ -521,7 +539,10 @@ export function ConfigWizard({ onComplete, onSkip }: Props) {
                     {i === ollamaCursor ? '▶' : '  '} {m.id}
                   </Text>
                   {m.source !== 'local' && (
-                    <Text dimColor> [{m.source === 'MiphamAI' ? 'MiphamAI' : '热门'}]</Text>
+                    <Text dimColor>
+                      {' '}
+                      [{m.source === 'MiphamAI' ? 'MiphamAI' : t('ui.wizard.ollama_source_hot')}]
+                    </Text>
                   )}
                 </Box>
               ))}
@@ -529,14 +550,12 @@ export function ConfigWizard({ onComplete, onSkip }: Props) {
           )}
           {ollamaStatus && ollamaModelList.length === 0 && (
             <Box marginBottom={1}>
-              <Text dimColor>
-                未检测到已下载模型。请先运行 ollama pull &lt;model&gt; 下载模型。
-              </Text>
-              <Text dimColor>以下为预置模型列表，选择后可在对话中通过 /models 切换。</Text>
+              <Text dimColor>{t('ui.wizard.ollama_no_models')}</Text>
+              <Text dimColor>{t('ui.wizard.ollama_preset_hint')}</Text>
             </Box>
           )}
           <Box marginTop={1}>
-            <Text dimColor>↑↓ 选择 · Enter 确认 · Esc 返回</Text>
+            <Text dimColor>{t('ui.wizard.nav_hint')}</Text>
           </Box>
         </Box>
       )}
@@ -546,26 +565,37 @@ export function ConfigWizard({ onComplete, onSkip }: Props) {
         <Box flexDirection="column">
           <Box marginBottom={1}>
             <Text bold color="cyan">
-              配置确认：
+              {t('ui.wizard.confirm_title')}
             </Text>
           </Box>
-          <Text>连接方式：{mode === 'cloud' ? '🌐 云端' : '🖥️ 本地'}</Text>
+          <Text>
+            {t('ui.wizard.confirm_connection')}
+            {mode === 'cloud' ? t('ui.wizard.confirm_cloud') : t('ui.wizard.confirm_local')}
+          </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)}
+                {t('ui.wizard.confirm_provider', {
+                  provider: DEFAULT_PROVIDERS.find((p) => p.id === providerId)?.name || '',
+                })}
+              </Text>
+              <Text>{t('ui.wizard.confirm_model', { model: modelId || '' })}</Text>
+              <Text>
+                {t('ui.wizard.confirm_apikey', {
+                  masked: `${apiKey.slice(0, 8)}...${apiKey.slice(-4)}`,
+                })}
               </Text>
             </>
           )}
           {mode === 'local' && (
             <Text>
-              Ollama 模型：{ollamaModelList[ollamaCursor]?.id || ollamaModel.trim() || 'llama3.2'}
+              {t('ui.wizard.confirm_ollama_model', {
+                model: ollamaModelList[ollamaCursor]?.id || ollamaModel.trim() || 'llama3.2',
+              })}
             </Text>
           )}
           <Box marginTop={1}>
-            <Text dimColor>配置文件将保存到 ~/.mipham/config.yml</Text>
+            <Text dimColor>{t('ui.wizard.confirm_save_path')}</Text>
           </Box>
           {error && (
             <Box marginBottom={1}>
@@ -573,10 +603,10 @@ export function ConfigWizard({ onComplete, onSkip }: Props) {
             </Box>
           )}
           <Box marginTop={1}>
-            <Text color="yellow">按 Enter 保存并启动 →</Text>
+            <Text color="yellow">{t('ui.wizard.confirm_save')}</Text>
           </Box>
           <Box marginTop={1}>
-            <Text dimColor>Esc 返回修改</Text>
+            <Text dimColor>{t('ui.wizard.confirm_back')}</Text>
           </Box>
         </Box>
       )}
@@ -586,10 +616,10 @@ export function ConfigWizard({ onComplete, onSkip }: Props) {
         <Box flexDirection="column">
           <Box marginBottom={1}>
             <Text color="green" bold>
-              ✅ 配置完成！
+              {t('ui.wizard.done_title')}
             </Text>
           </Box>
-          <Text>Mipham Code 正在启动...</Text>
+          <Text>{t('ui.wizard.done_launching')}</Text>
         </Box>
       )}
     </Box>

package/src/ui/error-boundary.tsx

@@ -11,6 +11,7 @@
 
 import React, { Component } from 'react'
 import { Text, Box } from 'ink'
+import { useI18n } from '../i18n-context'
 
 interface Props {
   children: React.ReactNode
@@ -63,23 +64,25 @@ export class ErrorBoundary extends Component<Props, State> {
 
   override render(): React.ReactNode {
     if (this.state.hasError) {
-      return (
-        <Box flexDirection="column" padding={1}>
-          <Text color="red" bold>
-            ⚠️ UI Render Error
-          </Text>
-          <Text dimColor>{this.state.error?.message || 'Unknown rendering error'}</Text>
-          <Text> </Text>
-          <Text dimColor>
-            The terminal interface encountered a rendering issue. Auto-recovery in 5 seconds...
-            Press Enter to attempt immediate recovery.
-          </Text>
-          <Text> </Text>
-          <Text color="yellow">Your session data and conversation history are preserved.</Text>
-        </Box>
-      )
+      return <ErrorFallback error={this.state.error} />
     }
 
     return this.props.children
   }
 }
+
+function ErrorFallback({ error }: { error: Error | null }): React.ReactNode {
+  const { t } = useI18n()
+  return (
+    <Box flexDirection="column" padding={1}>
+      <Text color="red" bold>
+        {t('ui.error_boundary.title')}
+      </Text>
+      <Text dimColor>{error?.message || t('ui.error_boundary.unknown')}</Text>
+      <Text> </Text>
+      <Text dimColor>{t('ui.error_boundary.recovery')}</Text>
+      <Text> </Text>
+      <Text color="yellow">{t('ui.error_boundary.preserved')}</Text>
+    </Box>
+  )
+}

package/src/ui/goal-progress.tsx

@@ -1,5 +1,6 @@
 import { useState, useEffect, useRef } from 'react'
 import { Box, Text } from 'ink'
+import { useI18n } from '../i18n-context'
 import { getTasks } from '../tools/exec/task.js'
 import type { Task } from '../tools/exec/task.js'
 
@@ -61,6 +62,7 @@ function taskIcon(status: Task['status']): { icon: string; color?: string; dim?:
 
 /** Live goal progress panel — mirrors ZCode's goal view: title + subtasks + done/total · elapsed · tokens. */
 export function GoalProgress({ goal, getTokens, listTasks }: GoalProgressProps) {
+  const { t } = useI18n()
   const [tasks, setTasks] = useState<Task[]>([])
   const [tokens, setTokens] = useState(0)
   const [elapsedMs, setElapsedMs] = useState(0)
@@ -103,11 +105,11 @@ export function GoalProgress({ goal, getTokens, listTasks }: GoalProgressProps)
       marginBottom={1}
     >
       <Text bold color="green">
-        🎯 Goal: {goal}
+        {t('ui.goal_progress.title', { goal })}
       </Text>
 
       {visibleTasks.length === 0 ? (
-        <Text dimColor> (no subtasks yet)</Text>
+        <Text dimColor>{t('ui.goal_progress.no_subtasks')}</Text>
       ) : (
         visibleTasks.map((t) => {
           const meta = taskIcon(t.status)
@@ -123,13 +125,17 @@ export function GoalProgress({ goal, getTokens, listTasks }: GoalProgressProps)
 
       <Box marginTop={1}>
         <Text dimColor>
-          ═══ {summary.done}/{summary.total} done
-          {summary.inProgress > 0 && ` · ${summary.inProgress} in progress`}
-          {summary.failed > 0 && ` · ${summary.failed} failed`}
+          {t('ui.goal_progress.summary', {
+            done: String(summary.done),
+            total: String(summary.total),
+          })}
+          {summary.inProgress > 0 &&
+            t('ui.goal_progress.in_progress', { n: String(summary.inProgress) })}
+          {summary.failed > 0 && t('ui.goal_progress.failed', { n: String(summary.failed) })}
           {' · '}
           {formatElapsed(elapsedMs)}
-          {tokens > 0 && ` · ${formatTokens(tokens)} tokens`}
-          {' ═══'}
+          {tokens > 0 && t('ui.goal_progress.tokens', { n: formatTokens(tokens) })}
+          {t('ui.goal_progress.border_end')}
         </Text>
       </Box>
     </Box>

package/src/ui/workflow-progress.tsx

@@ -1,5 +1,6 @@
 import React, { useState, useEffect, useMemo } from 'react'
 import { Box, Text } from 'ink'
+import { useI18n } from '../i18n-context'
 import { getEventBus } from '../workflow/event-bus.js'
 import type { WorkflowEvent } from '../workflow/event-bus.js'
 
@@ -16,6 +17,7 @@ interface WorkflowProgressProps {
 }
 
 export function WorkflowProgress({ runId }: WorkflowProgressProps) {
+  const { t } = useI18n()
   const [activeRunId, setActiveRunId] = useState<string | null>(null)
   const [phases, setPhases] = useState<Array<{ name: string; done: boolean }>>([])
   const [agents, setAgents] = useState<Map<string, AgentState>>(new Map())
@@ -129,7 +131,7 @@ export function WorkflowProgress({ runId }: WorkflowProgressProps) {
     <Box flexDirection="column" borderStyle="round" borderColor="cyan" paddingX={1}>
       <Box>
         <Text bold color="cyan">
-          ═══ Workflow: {activeRunId || runId} ═══
+          {t('ui.workflow.title', { runId: activeRunId ?? runId ?? '' })}
         </Text>
       </Box>
 
@@ -139,9 +141,12 @@ export function WorkflowProgress({ runId }: WorkflowProgressProps) {
         return (
           <Box key={i} flexDirection="column" marginTop={1}>
             <Text>
-              {phase.done ? '●' : '◌'} Phase: {phase.name}
+              {phase.done ? '●' : '◌'} {t('ui.workflow.phase', { name: phase.name })}
               {phaseAgents.length > 0 &&
-                ` [${phaseAgents.filter((a) => a.status === 'done').length}/${phaseAgents.length} done]`}
+                t('ui.workflow.done_count', {
+                  done: String(phaseAgents.filter((a) => a.status === 'done').length),
+                  total: String(phaseAgents.length),
+                })}
             </Text>
             {phaseAgents.map((agent, j) => (
               <Box key={j} marginLeft={2}>
@@ -163,12 +168,16 @@ export function WorkflowProgress({ runId }: WorkflowProgressProps) {
       {/* Summary footer */}
       <Box marginTop={1}>
         <Text dimColor>
-          ═══ Elapsed: {elapsedStr} | Agents: {doneCount}/{agentList.length}
-          {runningCount > 0 && ` (${runningCount} running)`}
-          {failedCount > 0 && ` (${failedCount} failed)`}
-          {done && ` | Cache hits: ${cacheHits}`}
-          {done && ' | DONE ═══'}
-          {!done && ' | Status: running ═══'}
+          {t('ui.workflow.footer', {
+            time: elapsedStr,
+            done: String(doneCount),
+            total: String(agentList.length),
+          })}
+          {runningCount > 0 && t('ui.workflow.running', { n: String(runningCount) })}
+          {failedCount > 0 && t('ui.workflow.failed', { n: String(failedCount) })}
+          {done && t('ui.workflow.cache_hits', { n: String(cacheHits) })}
+          {done && t('ui.workflow.done_marker')}
+          {!done && t('ui.workflow.running_marker')}
         </Text>
       </Box>
     </Box>