@geminilight/mindos 0.6.38 → 0.6.40

package/_standalone/lib/i18n/modules/settings.ts

@@ -9,8 +9,9 @@ export const settingsEn = {
       model: 'Model',
       apiKey: 'API Key',
       baseUrl: 'Base URL',
-      baseUrlHint: 'Optional. Use for proxies or OpenAI-compatible APIs.',
+      baseUrlHint: 'Optional. Use for proxies or custom API endpoints.',
       keyHint: 'Stored locally in ~/.mindos/config.json',
+      keyOptionalHint: 'Optional for local providers. Stored in ~/.mindos/config.json',
       envHint: 'Fields marked env have a value from environment variables. You can override them here, or restore all to env defaults.',
       envFieldNote: (key: string) => `Env var ${key} is set. Clear this field to fall back to it.`,
       resetToEnv: 'Reset to env value',
@@ -58,12 +59,40 @@ export const settingsEn = {
       light: 'Light',
       language: 'Language',
       browserNote: 'Appearance settings are saved in your browser.',
+      labsTitle: 'Labs',
+      labsDesc: 'Experimental features still in development. May change or be removed.',
+      labsEcho: 'Echo',
+      labsEchoDesc: 'Reflective journaling powered by your notes.',
+      labsWorkflows: 'Flows',
+      labsWorkflowsDesc: 'Visual workflow automation for agents.',
       fontPreview: 'The quick brown fox jumps over the lazy dog.',
     },
     knowledge: {
-      sopRoot: 'Knowledge base root',
-      sopRootHint: 'Absolute path to your notes directory. Requires server restart to take effect.',
-      sopRootEnvHint: (key: string) => `MIND_ROOT env var is set to "${key}". Fill in above to override it.`,
+      cardTitle: 'Knowledge Base',
+      securityTitle: 'Security',
+      passwordPlaceholder: 'Leave empty to disable',
+      passwordShow: 'Show',
+      passwordHide: 'Hide',
+      tokenNotSet: '— not set —',
+      mcpUrl: 'MCP URL',
+      tokenGenerated: 'New token generated. Copy it now — it won\'t be shown in full again.',
+      monitoringTitle: 'System Monitoring',
+      monitoringFailed: 'Failed to load monitoring data',
+      monitorHeap: 'Heap',
+      monitorRss: 'RSS',
+      monitorUptime: 'Uptime',
+      monitorNode: 'Node',
+      monitorRequests: 'Requests',
+      monitorToolCalls: 'Tool Calls',
+      monitorTokens: 'Tokens',
+      monitorFiles: 'Files',
+      monitorErrors: 'Errors',
+      monitorMcpRunning: (port: number) => `Running :${port}`,
+      monitorMcpStopped: 'Stopped',
+      cancel: 'Cancel',
+      mindRoot: 'Knowledge base root',
+      mindRootHint: 'Absolute path to your notes directory. Requires server restart to take effect.',
+      mindRootEnvHint: (key: string) => `MIND_ROOT env var is set to "${key}". Fill in above to override it.`,
       envNote: 'MIND_ROOT env var is set. Fill in above to override it — your value takes priority.',
       webPassword: 'Web UI password',
       webPasswordHint: 'Protect the browser UI with a password. Leave empty to disable. Changes take effect on next page load.',
@@ -97,17 +126,63 @@ export const settingsEn = {
       featureMultiDevice: 'Works across devices',
       remoteUrl: 'Git Remote URL',
       invalidUrl: 'Invalid Git URL — use HTTPS (https://...) or SSH (git@...)',
-      sshHint: 'SSH URLs require SSH key configured on this machine. HTTPS with token recommended.',
+      sshBrief: 'one-time key setup, no token needed',
+      httpsBrief: 'works anywhere, token recommended',
+      sshHint: 'Requires SSH key on this machine. Verify with: ssh -T git@github.com',
       accessToken: 'Access Token',
       optional: '(optional, for private repos)',
-      tokenHint: 'GitHub: Settings → Developer settings → Personal access tokens → repo scope',
+      tokenHint: 'GitHub:',
+      tokenLink: 'Create a token (repo scope)',
       branchLabel: 'Branch',
       connectButton: 'Connect & Start Sync',
       connecting: 'Connecting...',
+      stepConnecting: 'Connecting to remote...',
+      stepAuthenticating: 'Authenticating...',
+      stepSyncing: 'Syncing data...',
+      stepAlmostDone: 'Almost done...',
+      stepDone: 'Sync configured successfully!',
+      gitignoreTitle: 'Excluded files',
+      gitignorePlaceholder: '# Files to exclude from sync\n*.tmp\nsecret/',
+      gitignoreSave: 'Save',
+      gitignoreSaved: 'Saved',
+      conflictExplain: 'These files were changed on both this device and the remote. Choose which version to keep.',
+      keepLocal: 'Keep local',
+      keepRemote: 'Keep remote',
+      keepLocalHint: 'Keep this device\'s version',
+      keepRemoteHint: 'Replace with the remote version',
+      viewDiff: 'Click to compare versions',
+      localVersion: 'Local (this device)',
+      remoteVersion: 'Remote',
+      emptyFile: '(empty)',
+      sectionTitle: 'Sync',
+      labelProvider: 'Provider',
+      labelRemote: 'Remote',
+      labelBranch: 'Branch',
+      labelLastSync: 'Last sync',
+      labelUnpushed: 'Unpushed',
+      labelAutoSync: 'Auto-sync',
+      unpushedCommits: (n: number) => `${n} commits`,
+      syncNow: 'Sync Now',
+      disableAutoSync: 'Disable Auto-sync',
+      enableAutoSync: 'Enable Auto-sync',
+      syncComplete: 'Sync complete',
+      syncFailed: 'Sync failed',
+      autoSyncDisabled: 'Auto-sync disabled',
+      autoSyncEnabled: 'Auto-sync enabled',
+      toggleFailed: 'Failed to toggle sync',
+      conflictsTitle: (n: number) => `Conflicts (${n})`,
+      conflictHint: 'Click a file to view your version. Hover and click',
+      conflictHintSuffix: 'to see the remote version.',
+      timeNever: 'never',
+      timeJustNow: 'just now',
+      timeMinAgo: (m: number) => `${m}m ago`,
+      timeHourAgo: (h: number) => `${h}h ago`,
+      timeDayAgo: (d: number) => `${d}d ago`,
     },
     plugins: {
       title: 'Installed Renderers',
       builtinBadge: 'built-in',
+      coreBadge: 'core',
       enabled: 'Enabled',
       disabled: 'Disabled',
       matchHint: 'Auto-activates on',
@@ -193,6 +268,23 @@ export const settingsEn = {
       noAuthWarning: '⚠ No auth token — set one in Settings → General before enabling remote access.',
       showJson: 'Show JSON',
       hideJson: 'Hide JSON',
+      connectionTitle: 'Connection',
+      connectionHint: 'Use these credentials to connect AI agents to your MindOS knowledge base.',
+      tokenLabel: 'Auth Token',
+      tokenMasked: 'Click Show to reveal the full token',
+      tokenShow: 'Show',
+      tokenHide: 'Hide',
+      tokenCopy: 'Copy',
+      tokenCopied: 'Token copied!',
+      tokenNone: 'No token set — your MCP server is open to all requests.',
+      tokenNoneAction: 'Generate a token in Settings → General → Security.',
+      serverUrl: 'MCP Server URL',
+      serverUrlCopy: 'Copy URL',
+      howToConnect: 'How to connect an AI agent',
+      howToStep1: 'Open your agent\'s MCP settings (e.g. Claude Code, Cursor)',
+      howToStep2: 'Add a new MCP server with the URL above',
+      howToStep3: 'Set the Auth Token as the bearer token',
+      howToStep4: 'Save and verify the connection',
     },
     monitoring: {
       system: 'System',
@@ -271,6 +363,22 @@ export const settingsEn = {
       desktopReady: 'Update downloaded. Restart to apply.',
       desktopRestart: 'Restart Now',
       desktopHint: 'Updates are delivered through the Desktop app auto-updater.',
+      // Core Hot Update (Desktop only)
+      coreTitle: 'MindOS Core',
+      coreUpToDate: 'Core is up to date',
+      coreAvailable: (size: string) => `Update available (${size})`,
+      coreDownloading: 'Downloading...',
+      coreCancel: 'Cancel',
+      coreReady: 'Ready — restart services to apply',
+      coreRestartServices: 'Restart Services',
+      coreApplying: 'Applying update...',
+      coreApplied: 'Updated! Reloading...',
+      coreError: 'Core update failed.',
+      coreRetry: 'Retry',
+      coreDesktopTooOld: (version: string) => `v${version} requires a newer Desktop version.`,
+      coreDesktopTooOldHint: 'Please update MindOS Desktop first.',
+      coreHint: 'Core updates only restart services — no app restart needed.',
+      shellTitle: 'MindOS Desktop',
     },
     uninstall: {
       title: 'Uninstall MindOS',
@@ -301,14 +409,15 @@ export const settingsEn = {
 export const settingsZh = {
   settings: {
     title: '设置',
-    tabs: { ai: 'AI', appearance: '外观', knowledge: '通用', sync: '同步', mcp: 'MCP & Skills', plugins: '插件', shortcuts: '快捷键', monitoring: '监控', agents: 'Agents', update: '更新', uninstall: '卸载' },
+    tabs: { ai: 'AI', appearance: '外观', knowledge: '通用', sync: '同步', mcp: 'MCP 与技能', plugins: '插件', shortcuts: '快捷键', monitoring: '监控', agents: '智能体', update: '更新', uninstall: '卸载' },
     ai: {
       provider: '服务商',
       model: '模型',
       apiKey: 'API 密钥',
       baseUrl: '接口地址',
-      baseUrlHint: '可选。用于代理或 OpenAI 兼容 API。',
+      baseUrlHint: '可选。用于代理或自定义 API 端点。',
       keyHint: '本地存储于 ~/.mindos/config.json',
+      keyOptionalHint: '本地服务商可选。存储于 ~/.mindos/config.json',
       envHint: '标有 env 的字段存在环境变量值。你可以在此覆盖，或一键恢复为环境变量默认值。',
       envFieldNote: (key: string) => `环境变量 ${key} 已设置。清空此字段将回退到环境变量值。`,
       resetToEnv: '恢复为环境变量',
@@ -356,12 +465,40 @@ export const settingsZh = {
       light: '浅色',
       language: '语言',
       browserNote: '外观设置保存在浏览器本地。',
+      labsTitle: '实验性功能',
+      labsDesc: '仍在开发中的功能，可能会变更或移除。',
+      labsEcho: '回响',
+      labsEchoDesc: '基于笔记的反思性日记。',
+      labsWorkflows: '工作流',
+      labsWorkflowsDesc: 'Agent 可视化工作流自动化。',
       fontPreview: '人之初，性本善；性相近，习相远。',
     },
     knowledge: {
-      sopRoot: '知识库根目录',
-      sopRootHint: '笔记目录的绝对路径，修改后需要重启服务器。',
-      sopRootEnvHint: (key: string) => `MIND_ROOT 环境变量已设置为 "${key}"，填写上方路径可覆盖它。`,
+      cardTitle: '知识库',
+      securityTitle: '安全',
+      passwordPlaceholder: '留空可禁用',
+      passwordShow: '显示',
+      passwordHide: '隐藏',
+      tokenNotSet: '— 未设置 —',
+      mcpUrl: 'MCP 地址',
+      tokenGenerated: '已生成新令牌。请立即复制 — 之后不会再次完整显示。',
+      monitoringTitle: '系统监控',
+      monitoringFailed: '加载监控数据失败',
+      monitorHeap: '堆内存',
+      monitorRss: 'RSS',
+      monitorUptime: '运行时间',
+      monitorNode: 'Node',
+      monitorRequests: '请求数',
+      monitorToolCalls: '工具调用',
+      monitorTokens: 'Token',
+      monitorFiles: '文件',
+      monitorErrors: '错误',
+      monitorMcpRunning: (port: number) => `运行中 :${port}`,
+      monitorMcpStopped: '已停止',
+      cancel: '取消',
+      mindRoot: '知识库根目录',
+      mindRootHint: '笔记目录的绝对路径，修改后需要重启服务器。',
+      mindRootEnvHint: (key: string) => `MIND_ROOT 环境变量已设置为 "${key}"，填写上方路径可覆盖它。`,
       envNote: 'MIND_ROOT 环境变量已设置。填写上方路径后，你的值优先生效。',
       webPassword: '网页访问密码',
       webPasswordHint: '设置后访问浏览器 UI 需要登录，留空则关闭密码保护。下次刷新页面后生效。',
@@ -395,17 +532,63 @@ export const settingsZh = {
       featureMultiDevice: '多设备同步',
       remoteUrl: 'Git 远程仓库 URL',
       invalidUrl: '无效的 Git URL — 请使用 HTTPS (https://...) 或 SSH (git@...) 格式',
-      sshHint: 'SSH URL 需要在本机配置 SSH 密钥。推荐使用 HTTPS + Token。',
+      sshBrief: '一次配置，无需令牌',
+      httpsBrief: '通用性强，建议配令牌',
+      sshHint: '需要本机已配置 SSH 密钥。验证命令：ssh -T git@github.com',
       accessToken: '访问令牌',
       optional: '（可选，私有仓库需要）',
-      tokenHint: 'GitHub: Settings → Developer settings → Personal access tokens → repo scope',
+      tokenHint: 'GitHub:',
+      tokenLink: '创建令牌（勾选 repo 权限）',
       branchLabel: '分支',
       connectButton: '连接并开始同步',
       connecting: '连接中...',
+      stepConnecting: '正在连接远程仓库...',
+      stepAuthenticating: '正在验证身份...',
+      stepSyncing: '正在同步数据...',
+      stepAlmostDone: '即将完成...',
+      stepDone: '同步配置成功！',
+      gitignoreTitle: '排除文件',
+      gitignorePlaceholder: '# 不同步的文件\n*.tmp\nsecret/',
+      gitignoreSave: '保存',
+      gitignoreSaved: '已保存',
+      conflictExplain: '这些文件在本机和远程都被修改了。请选择保留哪个版本。',
+      keepLocal: '保留本地',
+      keepRemote: '保留远程',
+      keepLocalHint: '保留本机的版本',
+      keepRemoteHint: '替换为远程版本',
+      viewDiff: '点击查看两个版本的差异',
+      localVersion: '本地（本机）',
+      remoteVersion: '远程',
+      emptyFile: '（空）',
+      sectionTitle: '同步',
+      labelProvider: '提供商',
+      labelRemote: '远程',
+      labelBranch: '分支',
+      labelLastSync: '最后同步',
+      labelUnpushed: '未推送',
+      labelAutoSync: '自动同步',
+      unpushedCommits: (n: number) => `${n} 次提交`,
+      syncNow: '立即同步',
+      disableAutoSync: '禁用自动同步',
+      enableAutoSync: '启用自动同步',
+      syncComplete: '同步完成',
+      syncFailed: '同步失败',
+      autoSyncDisabled: '已禁用自动同步',
+      autoSyncEnabled: '已启用自动同步',
+      toggleFailed: '切换同步失败',
+      conflictsTitle: (n: number) => `冲突 (${n})`,
+      conflictHint: '单击文件查看你的版本。悬停并单击',
+      conflictHintSuffix: '查看远程版本。',
+      timeNever: '从未',
+      timeJustNow: '刚刚',
+      timeMinAgo: (m: number) => `${m} 分钟前`,
+      timeHourAgo: (h: number) => `${h} 小时前`,
+      timeDayAgo: (d: number) => `${d} 天前`,
     },
     plugins: {
       title: '已安装渲染器',
       builtinBadge: '内置',
+      coreBadge: '核心',
       enabled: '已启用',
       disabled: '已禁用',
       matchHint: '自动匹配',
@@ -448,14 +631,14 @@ export const settingsZh = {
       installFailed: '安装失败',
       portLabel: 'MCP 端口',
       portHint: '修改后需重启服务',
-      skillsTitle: 'Skills',
+      skillsTitle: '技能',
       skillAutoLoaded: '每次请求自动加载',
       skillSource: '来源',
       skillBuiltin: '内置',
       skillUser: '自定义',
-      addSkill: '+ 添加 Skill',
+      addSkill: '+ 添加技能',
       cliInstallHint: '通过命令行安装：',
-      skillPathHint: 'Skill 文件安装路径：',
+      skillPathHint: '技能文件安装路径：',
       deleteSkill: '删除',
       editSkill: '编辑',
       saveSkill: '保存',
@@ -463,15 +646,15 @@ export const settingsZh = {
       skillName: '名称',
       skillDesc: '描述',
       skillContent: '内容',
-      skillNameConflict: '同名 skill 已存在',
+      skillNameConflict: '同名技能已存在',
       skillDeleteConfirm: (name: string) => `确定删除「${name}」？此操作不可撤销。`,
-      skillLanguage: 'Skill 语言',
+      skillLanguage: '技能语言',
       skillLangEn: 'English',
       skillLangZh: '中文',
-      searchSkills: '搜索 Skill...',
+      searchSkills: '搜索技能...',
       customGroup: '自定义',
       builtinGroup: '内置',
-      noSkillsMatch: (query: string) => `没有匹配「${query}」的 Skill`,
+      noSkillsMatch: (query: string) => `没有匹配「${query}」的技能`,
       skillTemplate: '模板',
       skillTemplateGeneral: '通用',
       skillTemplateToolUse: '工具调用',
@@ -491,6 +674,23 @@ export const settingsZh = {
       noAuthWarning: '⚠ 未设置认证令牌 — 请先在 设置 → 通用 中配置，再启用远程访问。',
       showJson: '显示 JSON',
       hideJson: '隐藏 JSON',
+      connectionTitle: '连接信息',
+      connectionHint: '使用以下凭据将 AI 助手连接到你的 MindOS 知识库。',
+      tokenLabel: '认证令牌',
+      tokenMasked: '点击「显示」查看完整令牌',
+      tokenShow: '显示',
+      tokenHide: '隐藏',
+      tokenCopy: '复制',
+      tokenCopied: '令牌已复制！',
+      tokenNone: '未设置令牌 — MCP 服务对所有请求开放。',
+      tokenNoneAction: '请在 设置 → 通用 → 安全 中生成令牌。',
+      serverUrl: 'MCP 服务地址',
+      serverUrlCopy: '复制地址',
+      howToConnect: '如何连接 AI 助手',
+      howToStep1: '打开你的 AI 助手的 MCP 设置（如 Claude Code、Cursor）',
+      howToStep2: '添加一个新的 MCP 服务，填入上方地址',
+      howToStep3: '将认证令牌设为 Bearer Token',
+      howToStep4: '保存并验证连接',
     },
     monitoring: {
       system: '系统',
@@ -569,6 +769,22 @@ export const settingsZh = {
       desktopReady: '更新已下载，重启后生效。',
       desktopRestart: '立即重启',
       desktopHint: '更新通过桌面端自动更新推送。',
+      // Core Hot Update
+      coreTitle: 'MindOS Core',
+      coreUpToDate: '核心已是最新',
+      coreAvailable: (size: string) => `有新版本可用（${size}）`,
+      coreDownloading: '下载中...',
+      coreCancel: '取消',
+      coreReady: '已就绪 — 重启服务即可生效',
+      coreRestartServices: '重启服务',
+      coreApplying: '正在应用更新...',
+      coreApplied: '更新成功！正在刷新...',
+      coreError: '核心更新失败。',
+      coreRetry: '重试',
+      coreDesktopTooOld: (version: string) => `v${version} 需要更新版本的 Desktop。`,
+      coreDesktopTooOldHint: '请先更新 MindOS Desktop。',
+      coreHint: '核心更新只需重启服务，无需重启应用。',
+      shellTitle: 'MindOS Desktop',
     },
     uninstall: {
       title: '卸载 MindOS',

package/_standalone/lib/inbox-upload.ts

@@ -0,0 +1,93 @@
+import { toast } from '@/lib/toast';
+import type { useLocale } from '@/lib/stores/locale-store';
+
+const MAX_FILE_SIZE = 10 * 1024 * 1024; // 10 MB per file
+
+function arrayBufferToBase64(buf: ArrayBuffer): string {
+  const bytes = new Uint8Array(buf);
+  const chunks: string[] = [];
+  for (let i = 0; i < bytes.length; i += 8192) {
+    chunks.push(String.fromCharCode(...bytes.subarray(i, i + 8192)));
+  }
+  return btoa(chunks.join(''));
+}
+
+function showQuickDropToast(
+  saved: number,
+  formatSkipped: number,
+  oversized: number,
+  t: ReturnType<typeof useLocale>['t'],
+) {
+  if (saved > 0 && oversized > 0 && formatSkipped === 0) {
+    toast.success(t.inbox.savedWithOversized(saved, oversized), 4000);
+  } else if (saved > 0 && (formatSkipped + oversized) > 0) {
+    toast.success(t.inbox.savedWithSkipped(saved, formatSkipped + oversized), 4000);
+  } else if (saved > 0) {
+    toast.success(t.inbox.savedToast(saved), 3000);
+  } else {
+    if (oversized > 0) toast.error(t.inbox.tooLarge(oversized), 4000);
+    if (formatSkipped > 0) toast.error(t.inbox.savedWithSkipped(0, formatSkipped), 4000);
+    if (oversized === 0 && formatSkipped === 0) toast.error(t.inbox.saveFailed, 4000);
+  }
+}
+
+export async function quickDropToInbox(
+  files: File[],
+  t: ReturnType<typeof useLocale>['t'],
+) {
+  const payload: Array<{ name: string; content: string; encoding?: string }> = [];
+  let oversizedCount = 0;
+
+  for (const file of files) {
+    if (file.size > MAX_FILE_SIZE) {
+      oversizedCount++;
+      continue;
+    }
+    try {
+      if (file.name.toLowerCase().endsWith('.pdf')) {
+        const buf = await file.arrayBuffer();
+        payload.push({ name: file.name, content: arrayBufferToBase64(buf), encoding: 'base64' });
+      } else {
+        const text = await file.text();
+        payload.push({ name: file.name, content: text });
+      }
+    } catch {
+      /* skip unreadable files */
+    }
+  }
+
+  if (payload.length === 0) {
+    if (oversizedCount > 0) {
+      toast.error(t.inbox.tooLarge(oversizedCount), 4000);
+    } else if (files.length > 0) {
+      toast.error(t.inbox.saveFailed, 4000);
+    }
+    return;
+  }
+
+  try {
+    const res = await fetch('/api/inbox', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ files: payload }),
+    });
+
+    if (!res.ok) {
+      const data = await res.json().catch(() => ({}));
+      console.error('[QuickDrop] Save failed:', data.error);
+      toast.error(t.inbox.saveFailed, 4000);
+      return;
+    }
+
+    const result = await res.json();
+    const saved = result.saved?.length ?? 0;
+    const formatSkipped = result.skipped?.length ?? 0;
+
+    showQuickDropToast(saved, formatSkipped, oversizedCount, t);
+    window.dispatchEvent(new Event('mindos:files-changed'));
+    window.dispatchEvent(new Event('mindos:inbox-updated'));
+  } catch (err) {
+    console.error('[QuickDrop] Network error:', err);
+    toast.error(t.inbox.saveFailed, 4000);
+  }
+}

package/_standalone/lib/settings-ai-client.ts

@@ -2,25 +2,26 @@
  * Client-side mirror of "can /api/ask run?" using GET /api/settings payload.
  * Must stay aligned with server `effectiveAiConfig()` provider + key resolution.
  */
+import { type ProviderId, PROVIDER_PRESETS, isProviderId, getApiKeyEnvVar } from './agent/providers';
 
 export type SettingsJsonForAi = {
   ai?: {
     provider?: string;
-    providers?: {
-      anthropic?: { apiKey?: string };
-      openai?: { apiKey?: string };
-    };
+    providers?: Partial<Record<string, { apiKey?: string }>>;
   };
-  envOverrides?: Partial<Record<'ANTHROPIC_API_KEY' | 'OPENAI_API_KEY', boolean>>;
+  envOverrides?: Partial<Record<string, boolean>>;
 };
 
 export function isAiConfiguredForAsk(data: SettingsJsonForAi): boolean {
-  const prov = data.ai?.provider === 'openai' ? 'openai' : 'anthropic';
+  const provId = data.ai?.provider;
+  const provider: ProviderId = (provId && isProviderId(provId)) ? provId : 'anthropic';
   const env = data.envOverrides ?? {};
-  if (prov === 'openai') {
-    const k = data.ai?.providers?.openai?.apiKey;
-    return (typeof k === 'string' && k.length > 0) || !!env.OPENAI_API_KEY;
-  }
-  const k = data.ai?.providers?.anthropic?.apiKey;
-  return (typeof k === 'string' && k.length > 0) || !!env.ANTHROPIC_API_KEY;
+
+  const k = data.ai?.providers?.[provider]?.apiKey;
+  if (typeof k === 'string' && k.length > 0) return true;
+
+  const envVar = getApiKeyEnvVar(provider);
+  if (envVar && env[envVar]) return true;
+
+  return false;
 }

package/_standalone/lib/space-ai-init.ts

@@ -0,0 +1,66 @@
+import { apiFetch } from '@/lib/api';
+
+/**
+ * Check if AI is available by inspecting the active provider's API key.
+ */
+export async function checkAiAvailable(): Promise<boolean> {
+  try {
+    const data = await apiFetch<{
+      ai?: { provider?: string; providers?: Record<string, { apiKey?: string }> };
+    }>('/api/settings');
+    const provider = data.ai?.provider ?? '';
+    const providers = data.ai?.providers ?? {};
+    const active = providers[provider as keyof typeof providers];
+    return !!(active?.apiKey);
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Trigger AI to generate README.md and INSTRUCTION.md for a space.
+ * Dispatches `mindos:ai-init` events consumed by SpaceInitToast.
+ * The call is fire-and-forget — returns immediately after starting the stream.
+ */
+export function triggerSpaceAiInit(
+  spaceName: string,
+  spacePath: string,
+  description = '',
+): void {
+  const isZh = typeof document !== 'undefined' && document.documentElement.lang === 'zh';
+  const prompt = isZh
+    ? `初始化新建的心智空间「${spaceName}」，路径为「${spacePath}/」。${description ? `描述：「${description}」。` : ''}两个文件均已存在模板，用 write_file 覆盖：\n1. 「${spacePath}/README.md」— 写入空间用途、结构概览、使用指南\n2. 「${spacePath}/INSTRUCTION.md」— 写入 AI Agent 在此空间中的行为规则和操作约定\n\n内容简洁实用，直接使用工具写入。`
+    : `Initialize the new Mind Space "${spaceName}" at "${spacePath}/". ${description ? `Description: "${description}". ` : ''}Both files already exist with templates — use write_file to overwrite:\n1. "${spacePath}/README.md" — write purpose, structure overview, usage guidelines\n2. "${spacePath}/INSTRUCTION.md" — write rules for AI agents operating in this space\n\nKeep content concise and actionable. Write files directly using tools.`;
+
+  window.dispatchEvent(new CustomEvent('mindos:ai-init', {
+    detail: { spaceName, spacePath, description, state: 'working' },
+  }));
+
+  fetch('/api/ask', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({
+      messages: [{ role: 'user', content: prompt }],
+      currentFile: spacePath + '/INSTRUCTION.md',
+    }),
+  }).then(async (res) => {
+    if (!res.ok || !res.body) throw new Error(`HTTP ${res.status}`);
+    const reader = res.body.getReader();
+    try {
+      while (true) {
+        const { done } = await reader.read();
+        if (done) break;
+      }
+    } finally {
+      reader.releaseLock();
+    }
+    window.dispatchEvent(new CustomEvent('mindos:ai-init', {
+      detail: { spacePath, state: 'done' },
+    }));
+    window.dispatchEvent(new Event('mindos:files-changed'));
+  }).catch(() => {
+    window.dispatchEvent(new CustomEvent('mindos:ai-init', {
+      detail: { spacePath, state: 'error' },
+    }));
+  });
+}

package/_standalone/lib/stores/McpStoreInit.tsx

@@ -0,0 +1,18 @@
+'use client';
+
+import { useEffect } from 'react';
+import { useMcpStore } from '@/lib/stores/mcp-store';
+
+/**
+ * Thin component that initializes MCP store side-effects (polling, event listeners).
+ * Renders nothing — drop it anywhere in the tree that needs MCP data.
+ * Replaces the old <McpProvider> wrapper.
+ */
+export default function McpStoreInit() {
+  useEffect(() => {
+    const cleanup = useMcpStore.getState()._init();
+    return cleanup;
+  }, []);
+
+  return null;
+}

package/_standalone/lib/stores/WalkthroughInit.tsx

@@ -0,0 +1,20 @@
+'use client';
+
+import { useEffect } from 'react';
+import { useWalkthroughStore } from '@/lib/stores/walkthrough-store';
+import WalkthroughOverlay from '@/components/walkthrough/WalkthroughOverlay';
+
+/**
+ * Initializes walkthrough store and conditionally renders the overlay.
+ * Replaces the old <WalkthroughProvider> wrapper.
+ */
+export default function WalkthroughInit() {
+  useEffect(() => {
+    const cleanup = useWalkthroughStore.getState()._init();
+    return cleanup;
+  }, []);
+
+  const status = useWalkthroughStore(s => s.status);
+
+  return status === 'active' ? <WalkthroughOverlay /> : null;
+}

package/_standalone/lib/stores/locale-store.ts

@@ -0,0 +1,55 @@
+'use client';
+
+import { create } from 'zustand';
+import { Locale, messages, Messages } from '@/lib/i18n';
+
+/* ── Store ── */
+
+export interface LocaleStoreState {
+  locale: Locale;
+  t: Messages;
+  setLocale: (l: Locale) => void;
+  /** Hydrate from SSR value + attach listeners. Returns cleanup. */
+  _init: (ssrLocale: Locale) => () => void;
+}
+
+/** Read locale from localStorage, resolving 'system' */
+function getLocaleSnapshot(): Locale {
+  if (typeof window === 'undefined') return 'en';
+  const saved = localStorage.getItem('locale');
+  if (saved === 'zh') return 'zh';
+  if (saved === 'en') return 'en';
+  return navigator.language.startsWith('zh') ? 'zh' : 'en';
+}
+
+export const useLocaleStore = create<LocaleStoreState>((set) => ({
+  locale: 'en',
+  t: messages['en'] as unknown as Messages,
+
+  setLocale: (l: Locale) => {
+    document.cookie = `locale=${l};path=/;max-age=31536000;SameSite=Lax`;
+    document.documentElement.lang = l === 'zh' ? 'zh' : 'en';
+    set({ locale: l, t: messages[l] as unknown as Messages });
+    window.dispatchEvent(new Event('mindos-locale-change'));
+  },
+
+  _init: (ssrLocale: Locale) => {
+    // Hydrate with client value (or SSR fallback)
+    const clientLocale = typeof window !== 'undefined' ? getLocaleSnapshot() : ssrLocale;
+    set({ locale: clientLocale, t: messages[clientLocale] as unknown as Messages });
+
+    // Listen for external changes (e.g. localStorage change in another tab, or pre-hydration script)
+    const handler = () => {
+      const l = getLocaleSnapshot();
+      set({ locale: l, t: messages[l] as unknown as Messages });
+    };
+    window.addEventListener('mindos-locale-change', handler);
+    return () => window.removeEventListener('mindos-locale-change', handler);
+  },
+}));
+
+/* ── Backward-compatible hook ── */
+
+export function useLocale() {
+  return useLocaleStore();
+}