@geminilight/mindos 0.6.27 → 0.6.29

package/app/lib/acp/types.ts

@@ -0,0 +1,136 @@
+/**
+ * ACP (Agent Client Protocol) — Core Types for MindOS ACP integration.
+ * ACP uses JSON-RPC 2.0 over stdio (subprocess model), not HTTP.
+ * Sessions are stateful with prompt turns, tool calls, and streaming updates.
+ * Reference: https://agentclientprotocol.com
+ */
+
+/* ── Transport ────────────────────────────────────────────────────────── */
+
+/** How an ACP agent is spawned */
+export type AcpTransportType = 'stdio' | 'npx' | 'uvx' | 'binary';
+
+/* ── Capabilities ─────────────────────────────────────────────────────── */
+
+/** What MindOS exposes as an ACP agent */
+export interface AcpCapabilities {
+  streaming: boolean;
+  toolCalls: boolean;
+  multiTurn: boolean;
+  cancellation: boolean;
+}
+
+/* ── Session ──────────────────────────────────────────────────────────── */
+
+export type AcpSessionState = 'idle' | 'active' | 'error';
+
+export interface AcpSession {
+  id: string;
+  agentId: string;
+  state: AcpSessionState;
+  createdAt: string;
+  lastActivityAt: string;
+}
+
+/* ── JSON-RPC (ACP uses JSON-RPC 2.0 over stdio) ─────────────────────── */
+
+export interface AcpJsonRpcRequest {
+  jsonrpc: '2.0';
+  id: string | number;
+  method: string;
+  params?: Record<string, unknown>;
+}
+
+export interface AcpJsonRpcResponse {
+  jsonrpc: '2.0';
+  id: string | number | null;
+  result?: unknown;
+  error?: AcpJsonRpcError;
+}
+
+export interface AcpJsonRpcError {
+  code: number;
+  message: string;
+  data?: unknown;
+}
+
+/* ── Prompt ────────────────────────────────────────────────────────────── */
+
+export interface AcpPromptRequest {
+  sessionId: string;
+  text: string;
+  metadata?: Record<string, unknown>;
+}
+
+export interface AcpPromptResponse {
+  sessionId: string;
+  text: string;
+  done: boolean;
+  toolCalls?: AcpToolCall[];
+  metadata?: Record<string, unknown>;
+}
+
+/* ── Session Updates (streaming) ──────────────────────────────────────── */
+
+export type AcpUpdateType = 'text' | 'tool_call' | 'tool_result' | 'done' | 'error';
+
+export interface AcpSessionUpdate {
+  sessionId: string;
+  type: AcpUpdateType;
+  text?: string;
+  toolCall?: AcpToolCall;
+  toolResult?: AcpToolResult;
+  error?: string;
+}
+
+/* ── Tool Calls ───────────────────────────────────────────────────────── */
+
+export interface AcpToolCall {
+  id: string;
+  name: string;
+  arguments: Record<string, unknown>;
+}
+
+export interface AcpToolResult {
+  callId: string;
+  result: string;
+  isError?: boolean;
+}
+
+/* ── Registry ─────────────────────────────────────────────────────────── */
+
+/** An entry from the ACP registry (registry.json) */
+export interface AcpRegistryEntry {
+  id: string;
+  name: string;
+  description: string;
+  version?: string;
+  transport: AcpTransportType;
+  command: string;
+  args?: string[];
+  env?: Record<string, string>;
+  tags?: string[];
+  homepage?: string;
+}
+
+/** Parsed registry response */
+export interface AcpRegistry {
+  version: string;
+  agents: AcpRegistryEntry[];
+  fetchedAt: string;
+}
+
+/* ── Error Codes ──────────────────────────────────────────────────────── */
+
+export const ACP_ERRORS = {
+  SESSION_NOT_FOUND: { code: -32001, message: 'Session not found' },
+  SESSION_BUSY: { code: -32002, message: 'Session is busy' },
+  AGENT_NOT_FOUND: { code: -32003, message: 'Agent not found in registry' },
+  SPAWN_FAILED: { code: -32004, message: 'Failed to spawn agent process' },
+  TRANSPORT_ERROR: { code: -32005, message: 'Transport error' },
+  PARSE_ERROR: { code: -32700, message: 'Parse error' },
+  INVALID_REQUEST: { code: -32600, message: 'Invalid request' },
+  METHOD_NOT_FOUND: { code: -32601, message: 'Method not found' },
+  INVALID_PARAMS: { code: -32602, message: 'Invalid params' },
+  INTERNAL_ERROR: { code: -32603, message: 'Internal error' },
+} as const;

package/app/lib/agent/tools.ts

@@ -10,6 +10,7 @@ import {
 import { readSkillContentByName, scanSkillDirs } from '@/lib/pi-integration/skills';
 import { callMcporterTool, createMcporterAgentTools, listMcporterServers, listMcporterTools } from '@/lib/pi-integration/mcporter';
 import { a2aTools } from '@/lib/a2a/a2a-tools';
+import { acpTools } from '@/lib/acp/acp-tools';
 
 // Max chars per file to avoid token overflow (~100k chars ≈ ~25k tokens)
 const MAX_FILE_CHARS = 20_000;
@@ -187,7 +188,7 @@ export function getOrganizeTools(): AgentTool<any>[] {
 }
 
 export async function getRequestScopedTools(): Promise<AgentTool<any>[]> {
-  const baseTools = [...knowledgeBaseTools, ...a2aTools];
+  const baseTools = [...knowledgeBaseTools, ...a2aTools, ...acpTools];
   try {
     const result = await listMcporterServers();
     const okServers = (result.servers ?? []).filter((server) => server.status === 'ok');

package/app/lib/i18n/_core.ts

@@ -0,0 +1,22 @@
+/**
+ * Recursively widen literal string types to `string` so zh values can differ from en.
+ *
+ * Without Widen<T>, TypeScript would require zh strings to be the *exact* literal values from en.
+ * E.g., if en has `common: { hello: "hello" as const }`, zh would be required to also have "hello".
+ *
+ * This type converts all string literals to generic `string`, allowing Chinese translations to use
+ * completely different values while maintaining structure compatibility.
+ *
+ * Example:
+ * ```
+ * en = { msg: "Hello" as const }                // string literal "Hello"
+ * zh_without = { msg: "你好" } satisfies typeof en  // ❌ ERROR: "你好" not assignable to "Hello"
+ * zh_with = { msg: "你好" } satisfies Widen<typeof en>  // ✅ OK: string satisfies string
+ * ```
+ */
+export type Widen<T> =
+  T extends string ? string :
+  T extends readonly (infer U)[] ? readonly Widen<U>[] :
+  T extends (...args: infer A) => infer R ? (...args: A) => Widen<R> :
+  T extends object ? { [K in keyof T]: Widen<T[K]> } :
+  T;

package/app/lib/i18n/index.ts

@@ -0,0 +1,35 @@
+import type { Widen } from './_core';
+import { commonEn, commonZh } from './modules/common';
+import { navigationEn, navigationZh } from './modules/navigation';
+import { aiChatEn, aiChatZh } from './modules/ai-chat';
+import { knowledgeEn, knowledgeZh } from './modules/knowledge';
+import { panelsEn, panelsZh } from './modules/panels';
+import { settingsEn, settingsZh } from './modules/settings';
+import { onboardingEn, onboardingZh } from './modules/onboarding';
+import { featuresEn, featuresZh } from './modules/features';
+
+export const en = {
+  ...commonEn,
+  ...navigationEn,
+  ...aiChatEn,
+  ...knowledgeEn,
+  ...panelsEn,
+  ...settingsEn,
+  ...onboardingEn,
+  ...featuresEn,
+} as const;
+
+export const zh: Widen<typeof en> = {
+  ...commonZh,
+  ...navigationZh,
+  ...aiChatZh,
+  ...knowledgeZh,
+  ...panelsZh,
+  ...settingsZh,
+  ...onboardingZh,
+  ...featuresZh,
+};
+
+export type Locale = 'en' | 'zh';
+export const messages = { en, zh } as const;
+export type Messages = typeof en;

package/app/lib/i18n/modules/ai-chat.ts

@@ -0,0 +1,215 @@
+// ask + changes + hints
+
+export const aiChatEn = {
+  ask: {
+    title: 'MindOS Agent',
+    fabLabel: 'Ask AI',
+    placeholder: 'Ask a question... @ files, / skills',
+    emptyPrompt: 'Ask anything about your knowledge base',
+    send: 'send',
+    newlineHint: 'new line',
+    panelComposerResize: 'Drag up to enlarge the input area',
+    panelComposerFooter: 'Resize height',
+    panelComposerResetHint: 'Double-click to reset height',
+    panelComposerKeyboard: 'Arrow keys adjust height; Home/End min/max',
+    attachFile: 'Context',
+    uploadedFiles: 'Uploaded',
+    skillsHint: 'skills',
+    attachCurrent: 'attach current file',
+    stopTitle: 'Stop',
+    cancelReconnect: 'Cancel reconnect',
+    connecting: 'Thinking with you...',
+    thinking: 'Thinking...',
+    thinkingLabel: 'Thinking',
+    searching: 'Searching knowledge base...',
+    generating: 'Generating response...',
+    stopped: 'Generation stopped.',
+    errorNoResponse: 'AI returned no content. Possible causes: model does not support streaming, proxy compatibility issue, or request exceeds context limit.',
+    reconnecting: (attempt: number, max: number) => `Connection lost. Reconnecting (${attempt}/${max})...`,
+    reconnectFailed: 'Connection failed after multiple attempts.',
+    retry: 'Retry',
+    suggestions: [
+      'Summarize this document',
+      'List all action items and TODOs',
+      'What are the key points?',
+      'Find related notes on this topic',
+    ],
+    sessionHistory: 'Session History',
+    clearAll: 'Clear all',
+    confirmClear: 'Confirm clear?',
+    noSessions: 'No saved sessions.',
+    draftingHint: 'AI is still running — you can draft the next step now.',
+  },
+  changes: {
+    unreadBanner: (n: number) => `${n} content change${n === 1 ? '' : 's'} unread`,
+    reviewNow: 'Review now',
+    dismiss: 'Dismiss notification',
+    title: 'Content changes',
+    subtitle: 'Review recent edits across user and agent operations.',
+    eventsCount: (n: number) => `${n} event${n === 1 ? '' : 's'}`,
+    unreadCount: (n: number) => `${n} unread`,
+    refresh: 'Refresh',
+    markSeen: 'Mark seen',
+    markAllRead: 'Mark all read',
+    filters: {
+      filePath: 'File path',
+      filePathPlaceholder: 'e.g. Projects/plan.md',
+      source: 'Agents (source)',
+      operation: 'Tools (operation)',
+      operationAll: 'All operations',
+      keyword: 'Keyword',
+      keywordPlaceholder: 'summary / op / path',
+      all: 'All',
+      agent: 'Agent',
+      user: 'User',
+      system: 'System',
+    },
+    loading: 'Loading changes...',
+    empty: 'No content changes yet.',
+    open: 'Open',
+    unchangedLines: (n: number) => `... ${n} unchanged lines ...`,
+    relativeTime: {
+      justNow: 'just now',
+      minutesAgo: (n: number) => `${n}m ago`,
+      hoursAgo: (n: number) => `${n}h ago`,
+      daysAgo: (n: number) => `${n}d ago`,
+    },
+  },
+  /** Disabled-state and contextual tooltip hints */
+  hints: {
+    noValidFiles: 'No valid files selected',
+    aiOrganizing: 'AI is organizing',
+    importInProgress: 'Import in progress',
+    templateInitializing: 'Another template is being initialized',
+    configureAiKey: 'Configure API key in Settings → AI',
+    syncInProgress: 'Sync already in progress',
+    toggleInProgress: 'Toggle operation in progress',
+    typeMessage: 'Type a message',
+    mentionInProgress: 'Mention or command in progress',
+    cleanupInProgress: 'Cleanup already in progress',
+    tokenResetInProgress: 'Token reset in progress',
+    aiNotConfigured: 'AI not configured or generation in progress',
+    generationInProgress: 'Generation in progress or AI not configured',
+    cannotJumpForward: 'Cannot jump forward in setup',
+    testInProgressOrNoKey: 'Test in progress or no API key',
+    workflowStepRunning: 'Workflow step already running',
+    workflowRunning: 'Workflow step is running',
+    sessionHistory: 'Session history',
+    newSession: 'New session',
+    attachFile: 'Attach local file',
+    maximizePanel: 'Maximize panel',
+    restorePanel: 'Restore panel',
+    dockToSide: 'Dock to side panel',
+    openAsPopup: 'Open as popup',
+    closePanel: 'Close',
+    newChat: 'New chat',
+    closeSession: 'Close session',
+  },
+} as const;
+
+export const aiChatZh = {
+  ask: {
+    title: 'MindOS Agent',
+    fabLabel: 'AI 助手',
+    placeholder: '输入问题… @ 附加文件，/ 技能',
+    emptyPrompt: '可以问任何关于知识库的问题',
+    send: '发送',
+    newlineHint: '换行',
+    panelComposerResize: '向上拖拽以拉高输入区',
+    panelComposerFooter: '拉高输入区',
+    panelComposerResetHint: '双击恢复默认高度',
+    panelComposerKeyboard: '方向键调节高度；Home/End 最小或最大',
+    attachFile: '上下文',
+    uploadedFiles: '已上传',
+    skillsHint: '技能',
+    attachCurrent: '附加当前文件',
+    stopTitle: '停止',
+    cancelReconnect: '取消重连',
+    connecting: '正在和你一起思考...',
+    thinking: '思考中...',
+    thinkingLabel: '思考中',
+    searching: '正在搜索知识库...',
+    generating: '正在生成回复...',
+    stopped: '已停止生成。',
+    errorNoResponse: 'AI 未返回有效内容。可能原因：模型不支持流式输出、中转站兼容性问题、或请求超出上下文限制。',
+    reconnecting: (attempt: number, max: number) => `连接中断，正在重连 (${attempt}/${max})...`,
+    reconnectFailed: '多次重连失败，请检查网络后重试。',
+    retry: '重试',
+    suggestions: [
+      '总结这篇文档',
+      '列出所有待办事项',
+      '这篇文档的核心要点是什么？',
+      '查找与这个主题相关的笔记',
+    ],
+    sessionHistory: '对话历史',
+    clearAll: '清除全部',
+    confirmClear: '确认清除？',
+    noSessions: '暂无历史对话。',
+    draftingHint: 'AI 仍在执行，你可以先输入下一步。',
+  },
+  changes: {
+    unreadBanner: (n: number) => `${n} 条内容变更未读`,
+    reviewNow: '立即查看',
+    dismiss: '关闭提醒',
+    title: '内容变更',
+    subtitle: '集中查看用户与 Agent 的最近编辑记录。',
+    eventsCount: (n: number) => `${n} 条事件`,
+    unreadCount: (n: number) => `${n} 条未读`,
+    refresh: '刷新',
+    markSeen: '标记已读',
+    markAllRead: '全部已读',
+    filters: {
+      filePath: '文件路径',
+      filePathPlaceholder: '例如：Projects/plan.md',
+      source: 'Agents（来源）',
+      operation: 'Tools（操作）',
+      operationAll: '全部操作',
+      keyword: '关键词',
+      keywordPlaceholder: '摘要 / 操作 / 路径',
+      all: '全部',
+      agent: 'Agent',
+      user: '用户',
+      system: '系统',
+    },
+    loading: '正在加载变更...',
+    empty: '暂无内容变更。',
+    open: '打开',
+    unchangedLines: (n: number) => `... ${n} 行未变更 ...`,
+    relativeTime: {
+      justNow: '刚刚',
+      minutesAgo: (n: number) => `${n} 分钟前`,
+      hoursAgo: (n: number) => `${n} 小时前`,
+      daysAgo: (n: number) => `${n} 天前`,
+    },
+  },
+  /** 禁用态和上下文提示文案 */
+  hints: {
+    noValidFiles: '未选择有效文件',
+    aiOrganizing: 'AI 正在整理中',
+    importInProgress: '正在导入',
+    templateInitializing: '正在初始化另一个模板',
+    configureAiKey: '请在 设置 → AI 中配置 API 密钥',
+    syncInProgress: '正在同步中',
+    toggleInProgress: '正在切换中',
+    typeMessage: '请输入消息',
+    mentionInProgress: '正在输入提及或命令',
+    cleanupInProgress: '正在清理中',
+    tokenResetInProgress: '正在重置令牌',
+    aiNotConfigured: 'AI 未配置或正在生成',
+    generationInProgress: '正在生成或 AI 未配置',
+    cannotJumpForward: '无法跳过前序步骤',
+    testInProgressOrNoKey: '正在测试或未配置 API 密钥',
+    workflowStepRunning: '工作流步骤正在运行',
+    workflowRunning: '工作流步骤正在运行',
+    sessionHistory: '会话历史',
+    newSession: '新会话',
+    attachFile: '附加本地文件',
+    maximizePanel: '最大化面板',
+    restorePanel: '还原面板',
+    dockToSide: '停靠到侧边栏',
+    openAsPopup: '弹窗模式',
+    closePanel: '关闭',
+    newChat: '新对话',
+    closeSession: '关闭会话',
+  },
+};

package/app/lib/i18n/modules/common.ts

@@ -0,0 +1,71 @@
+// common + app + login + notFound + updateBanner
+
+export const commonEn = {
+  common: {
+    relatedFiles: 'Related Files',
+  },
+  app: {
+    tagline: 'You think here, Agents act there.',
+    footer: 'MindOS · human-agent collaborative mind system',
+  },
+  login: {
+    tagline: 'You think here, Agents act there.',
+    subtitle: 'Enter your password to continue',
+    passwordLabel: 'Password',
+    passwordPlaceholder: 'Enter password',
+    signIn: 'Sign in',
+    signingIn: 'Signing in…',
+    incorrectPassword: 'Incorrect password. Please try again.',
+    connectionError: 'Connection error. Please try again.',
+  },
+  notFound: {
+    title: 'File not found',
+    description: 'This file does not exist in your knowledge base.',
+    createButton: 'Create this file',
+    creating: 'Creating...',
+    goToParent: 'Go to parent folder',
+    goHome: 'Home',
+  },
+  updateBanner: {
+    newVersion: (latest: string, current: string) => `MindOS v${latest} available (current: v${current})`,
+    updateNow: 'Update',
+    runUpdate: 'Run',
+    orSee: 'or',
+    releaseNotes: 'release notes',
+  },
+} as const;
+
+export const commonZh = {
+  common: {
+    relatedFiles: '关联视图',
+  },
+  app: {
+    tagline: '你在此思考，Agent 依此行动。',
+    footer: 'MindOS · 人机共生知识系统',
+  },
+  login: {
+    tagline: '人类在此思考，Agent 依此行动。',
+    subtitle: '请输入密码以继续',
+    passwordLabel: '密码',
+    passwordPlaceholder: '输入密码',
+    signIn: '登录',
+    signingIn: '登录中…',
+    incorrectPassword: '密码错误，请重试。',
+    connectionError: '连接错误，请重试。',
+  },
+  notFound: {
+    title: '文件未找到',
+    description: '该文件不存在于你的知识库中。',
+    createButton: '创建此文件',
+    creating: '创建中...',
+    goToParent: '返回上级目录',
+    goHome: '首页',
+  },
+  updateBanner: {
+    newVersion: (latest: string, current: string) => `MindOS v${latest} 可用（当前 v${current}）`,
+    updateNow: '更新',
+    runUpdate: '终端运行',
+    orSee: '或',
+    releaseNotes: '查看更新说明',
+  },
+};

package/app/lib/i18n/modules/features.ts

@@ -0,0 +1,153 @@
+// shortcuts + help
+
+export const featuresEn = {
+  shortcuts: [
+    { keys: ['⌘', 'K'], description: 'Search' },
+    { keys: ['⌘', '/'], description: 'MindOS Agent' },
+    { keys: ['⌘', ','], description: 'Settings' },
+    { keys: ['E'], description: 'Edit current file' },
+    { keys: ['⌘', 'S'], description: 'Save' },
+    { keys: ['Esc'], description: 'Cancel edit / close modal' },
+    { keys: ['@'], description: 'Attach file in MindOS Agent' },
+  ],
+  help: {
+    title: 'Help & Guide',
+    subtitle: 'Everything you need to get started with MindOS',
+    whatIs: {
+      title: 'What is MindOS?',
+      body: 'MindOS is where you think, and where your AI agents act. You and AI share the same brain — when you correct AI, that correction is captured automatically; next time AI understands you better, and your own thinking gets sharper along the way. You and AI grow together. In an age of AI anxiety, MindOS focuses on human growth — think clearly, make better decisions, ship faster, and build up knowledge that\'s truly yours.',
+    },
+    quickStart: {
+      title: 'Quick Start',
+      step1Title: 'Browse your knowledge base',
+      step1Desc: 'Click the Spaces icon in the left sidebar to explore your files. Each top-level folder is a "Space" — a themed area like Profile, Notes, or Projects.',
+      step2Title: 'Chat with AI',
+      step2Desc: 'Press ⌘/ (or Ctrl/) to open the AI panel. Ask anything about your knowledge base, or use @ to attach a specific file for context.',
+      step3Title: 'Connect your AI agents',
+      step3Desc: 'Go to Settings → MCP to connect external agents like Claude Code, Cursor, or Windsurf. Once connected, they can read and write your knowledge base directly.',
+    },
+    concepts: {
+      title: 'Core Concepts',
+      spaceTitle: 'Space',
+      spaceDesc: 'Spaces are knowledge partitions organized the way you think. You decide the structure, and AI agents follow it to read, write, and manage automatically.',
+      instructionTitle: 'Instruction',
+      instructionDesc: 'A rules file that all AI agents obey. You write the boundaries once, and every agent connected to your knowledge base follows them.',
+      skillTitle: 'Skill',
+      skillDesc: 'Teaches agents how to operate your knowledge base — reading, writing, organizing. Agents don\'t guess; they follow the skills you\'ve installed.',
+    },
+    shortcutsTitle: 'Keyboard Shortcuts',
+    agentUsage: {
+      title: 'Using MindOS with AI Agents',
+      intro: 'Once you connect an agent (Claude Code, Cursor, Windsurf, etc.) via MCP, just talk to it naturally. The agent can read and write your knowledge base directly — no special commands needed. Here are the most common scenarios:',
+      scenarios: [
+        { emoji: '🪪', title: 'Inject Your Identity', desc: 'Tell all AI agents who you are — preferences, tech stack, communication style — in one shot.', prompt: "\"Here's my resume, read it and organize my info into MindOS.\"" },
+        { emoji: '🔄', title: 'Cross-Agent Handoff', desc: 'Brainstorm ideas in GPT, then execute in Claude Code — zero context loss.', prompt: '"Save this conversation to MindOS."\n"Read the plan in MindOS and help me start coding."' },
+        { emoji: '📋', title: 'Experience → SOP', desc: 'Turn hard-won debugging sessions into reusable workflows that prevent future mistakes.', prompt: '"Help me distill this conversation into a reusable workflow in MindOS."' },
+        { emoji: '🚀', title: 'Project Cold Start', desc: 'Spin up a new project in minutes — your profile and SOPs guide the scaffolding automatically.', prompt: '"Help me start a new project following the Startup SOP in MindOS."' },
+        { emoji: '🔍', title: 'Research & Archive', desc: 'Let agents research competitors or topics for you, then file structured results in your knowledge base.', prompt: '"Help me research X, Y, Z products and save results to the MindOS product library."' },
+      ],
+      copy: 'Copy prompt',
+      hint: 'Tip: The agent auto-discovers your knowledge base structure. Just mention "MindOS" in your prompt and it will know where to look. Click "Explore" in the left sidebar for more scenarios.',
+    },
+    shortcuts: {
+      search: 'Search files',
+      askAI: 'Toggle AI panel',
+      settings: 'Open Settings',
+      shortcutPanel: 'Keyboard shortcuts panel',
+      editFile: 'Edit current file',
+      save: 'Save file',
+      closePanel: 'Close panel / Exit modal',
+      attachFile: 'Attach file in AI chat',
+    },
+    faq: {
+      title: 'FAQ',
+      items: [
+        { q: 'How do I change the language?', a: 'Go to Settings → Appearance → Language. You can switch between English and Chinese.' },
+        { q: 'How do I connect an AI agent?', a: 'Go to Settings → MCP & Skills. MindOS auto-detects installed agents (Claude Code, Cursor, etc.) and lets you connect them with one click.' },
+        { q: 'Where is my data stored?', a: 'All your data stays on your local machine as plain Markdown files. MindOS never uploads your data to any cloud service. You own everything.' },
+        { q: 'How do I sync across devices?', a: 'Go to Settings → Sync. MindOS uses Git for cross-device sync. Enter your Git remote URL and access token to start syncing.' },
+        { q: 'Can I use my own AI provider?', a: 'Yes! Go to Settings → AI. You can use OpenAI, Anthropic, Google, or any OpenAI-compatible API with a custom base URL.' },
+        { q: 'What file formats are supported?', a: 'MindOS works best with Markdown (.md) files, but also supports JSON, CSV, and plain text. Plugins extend rendering for special formats like Kanban boards or timelines.' },
+        { q: 'How do I create a new note?', a: 'Click the + icon next to any folder in the file tree, or ask AI to create one for you. Notes are just Markdown files — you can also create them from your file system.' },
+      ],
+    },
+  },
+
+  /** Disabled-state and contextual tooltip hints */
+} as const;
+
+export const featuresZh = {
+  shortcuts: [
+    { keys: ['⌘', 'K'], description: '搜索' },
+    { keys: ['⌘', '/'], description: 'MindOS Agent' },
+    { keys: ['⌘', ','], description: '设置' },
+    { keys: ['E'], description: '编辑当前文件' },
+    { keys: ['⌘', 'S'], description: '保存' },
+    { keys: ['Esc'], description: '取消编辑 / 关闭弹窗' },
+    { keys: ['@'], description: '在 AI 对话中添加附件' },
+  ],
+  help: {
+    title: '帮助与指南',
+    subtitle: '开始使用 MindOS 所需的一切',
+    whatIs: {
+      title: '什么是 MindOS？',
+      body: 'MindOS 是你思考的地方，也是 AI Agent 行动的起点。你和 AI 共享同一个大脑——你纠正了 AI，这个纠正自动沉淀；AI 下次更懂你，你自己的思路也跟着变清晰。人和 AI 一起成长。在 AI 焦虑蔓延的时代，MindOS 更关注人的成长——想清楚问题、做好判断、快速实践、攒下属于自己的认知。',
+    },
+    quickStart: {
+      title: '快速开始',
+      step1Title: '浏览你的知识库',
+      step1Desc: '点击左侧边栏的"空间"图标来浏览你的文件。每个顶级文件夹是一个"空间"——比如 Profile、Notes 或 Projects。',
+      step2Title: '和 AI 对话',
+      step2Desc: '按 ⌘/（或 Ctrl/）打开 AI 面板。询问任何关于知识库的问题，或使用 @ 附加特定文件作为上下文。',
+      step3Title: '连接你的 AI Agent',
+      step3Desc: '前往 设置 → MCP 连接外部 Agent，如 Claude Code、Cursor 或 Windsurf。连接后，它们可以直接读写你的知识库。',
+    },
+    concepts: {
+      title: '核心概念',
+      spaceTitle: '空间（Space）',
+      spaceDesc: '空间是按你的思维方式组织的知识分区。你怎么想，就怎么分，AI Agent 遵循同样的结构来自动读写和管理。',
+      instructionTitle: '指令（Instruction）',
+      instructionDesc: '一份所有 AI Agent 都遵守的规则文件。你写一次边界，每个连接到知识库的 Agent 都会照做。',
+      skillTitle: '技能（Skill）',
+      skillDesc: '教 Agent 如何操作你的知识库——读取、写入、整理。Agent 不是瞎猜，而是按你安装的 Skill 来执行。',
+    },
+    shortcutsTitle: '快捷键',
+    agentUsage: {
+      title: '在 AI Agent 中使用 MindOS',
+      intro: '通过 MCP 连接 Agent（Claude Code、Cursor、Windsurf 等）后，直接用自然语言对话即可。Agent 能自动读写你的知识库，不需要特殊指令。以下是最常见的使用场景：',
+      scenarios: [
+        { emoji: '🪪', title: '注入身份', desc: '让所有 AI Agent 一次认识你——偏好、技术栈、沟通风格。', prompt: '"这是我的简历，读一下，把我的信息整理到 MindOS 里。"' },
+        { emoji: '🔄', title: '跨 Agent 切换', desc: '在 GPT 里聊想法，到 Claude Code 去执行——上下文零丢失。', prompt: '"帮我把刚才的对话整理到 MindOS。"\n"读一下 MindOS 里的方案，帮我开始写代码。"' },
+        { emoji: '📋', title: '经验→SOP', desc: '把踩坑经验沉淀为可复用的工作流，下次 3 分钟搞定。', prompt: '"帮我把这次对话的经验沉淀到 MindOS，形成可复用的工作流。"' },
+        { emoji: '🚀', title: '项目冷启动', desc: '几分钟搭建新项目——Profile 和 SOP 自动引导脚手架。', prompt: '"帮我按 MindOS 里的 Startup SOP 启动一个新项目。"' },
+        { emoji: '🔍', title: '调研入库', desc: '让 Agent 替你调研竞品或话题，结果结构化存入知识库。', prompt: '"帮我调研 X、Y、Z 这几个产品，结果写入 MindOS 产品库。"' },
+      ],
+      copy: '复制 Prompt',
+      hint: '提示：Agent 会自动发现你的知识库结构。在 prompt 中提到"MindOS"，它就知道去哪里找。点击左侧"探索"查看更多场景。',
+    },
+    shortcuts: {
+      search: '搜索文件',
+      askAI: '切换 AI 面板',
+      settings: '打开设置',
+      shortcutPanel: '快捷键面板',
+      editFile: '编辑当前文件',
+      save: '保存文件',
+      closePanel: '关闭面板 / 退出弹窗',
+      attachFile: '在 AI 对话中附加文件',
+    },
+    faq: {
+      title: '常见问题',
+      items: [
+        { q: '如何切换语言？', a: '前往 设置 → 外观 → 语言。支持中文和英文切换。' },
+        { q: '如何连接 AI Agent？', a: '前往 设置 → MCP & Skills。MindOS 会自动检测已安装的 Agent（Claude Code、Cursor 等），一键即可连接。' },
+        { q: '我的数据存储在哪里？', a: '所有数据以纯 Markdown 文件的形式存储在你的本地机器上。MindOS 不会将你的数据上传到任何云服务。数据完全由你掌控。' },
+        { q: '如何跨设备同步？', a: '前往 设置 → 同步。MindOS 使用 Git 进行跨设备同步。输入 Git 远程仓库 URL 和访问令牌即可开始同步。' },
+        { q: '可以使用自己的 AI 服务商吗？', a: '可以！前往 设置 → AI。支持 OpenAI、Anthropic、Google，或任何 OpenAI 兼容的 API（自定义 Base URL）。' },
+        { q: '支持哪些文件格式？', a: 'MindOS 最适合 Markdown（.md）文件，但也支持 JSON、CSV 和纯文本。插件可以扩展特殊格式的渲染，如看板或时间线。' },
+        { q: '如何创建新笔记？', a: '点击文件树中任意文件夹旁的 + 图标，或让 AI 帮你创建。笔记就是 Markdown 文件，你也可以直接在文件系统中创建。' },
+      ],
+    },
+  },
+
+  /** 禁用态和上下文提示文案 */
+};