@geminilight/mindos 0.5.48 → 0.5.50

package/app/app/help/page.tsx

@@ -0,0 +1,12 @@
+import { redirect } from 'next/navigation';
+import { readSettings } from '@/lib/settings';
+import HelpContent from '@/components/help/HelpContent';
+
+export const dynamic = 'force-dynamic';
+
+export default function HelpPage() {
+  const settings = readSettings();
+  if (settings.setupPending) redirect('/setup');
+
+  return <HelpContent />;
+}

package/app/components/ActivityBar.tsx

@@ -2,7 +2,7 @@
 
 import { useRef, useCallback, useState, useEffect } from 'react';
 import Link from 'next/link';
-import { FolderTree, Search, Settings, RefreshCw, Blocks, Bot, Compass, ChevronLeft, ChevronRight } from 'lucide-react';
+import { FolderTree, Search, Settings, RefreshCw, Blocks, Bot, Compass, HelpCircle, ChevronLeft, ChevronRight } from 'lucide-react';
 import { useLocale } from '@/lib/LocaleContext';
 import { DOT_COLORS, getStatusLevel } from './SyncStatusBar';
 import type { SyncStatus } from './settings/SyncTab';
@@ -20,6 +20,7 @@ interface ActivityBarProps {
   expanded: boolean;
   onExpandedChange: (expanded: boolean) => void;
   onSettingsClick: () => void;
+  onHelpClick: () => void;
   onSyncClick: (rect: DOMRect) => void;
 }
 
@@ -79,6 +80,7 @@ export default function ActivityBar({
   expanded,
   onExpandedChange,
   onSettingsClick,
+  onHelpClick,
   onSyncClick,
 }: ActivityBarProps) {
   const lastClickRef = useRef(0);
@@ -167,6 +169,12 @@ export default function ActivityBar({
         {/* ── Bottom: Action buttons (not panel toggles) ── */}
         <div className={`${expanded ? 'mx-3' : 'mx-auto w-6'} border-t border-border`} />
         <div className={`flex flex-col ${expanded ? 'px-1.5' : 'items-center'} gap-1 py-2`}>
+          <RailButton
+            icon={<HelpCircle size={18} />}
+            label={t.sidebar.help}
+            expanded={expanded}
+            onClick={() => debounced(onHelpClick)}
+          />
           <RailButton
             icon={<Settings size={18} />}
             label={t.sidebar.settingsTitle}

package/app/components/GuideCard.tsx

@@ -118,7 +118,8 @@ export default function GuideCard({ onNavigate, spaces = [], recentFiles = [] }:
   }, [guideState, g, patchGuide]);
 
   const handleSyncClick = useCallback(() => {
-    window.dispatchEvent(new KeyboardEvent('keydown', { key: ',', metaKey: true, bubbles: true }));
+    // Open settings directly to the Sync tab (SidebarLayout listens for this event)
+    window.dispatchEvent(new CustomEvent('mindos:open-settings', { detail: { tab: 'sync' } }));
   }, []);
 
   // Auto-dismiss final state after 8 seconds

package/app/components/SidebarLayout.tsx

@@ -152,6 +152,10 @@ export default function SidebarLayout({ fileTree, children }: SidebarLayoutProps
     setSettingsTab(undefined);
   }, []);
 
+  const handleHelpClick = useCallback(() => {
+    router.push('/help');
+  }, [router]);
+
   const closeSettings = useCallback(() => {
     setSettingsOpen(false);
     setSettingsTab(undefined);
@@ -188,6 +192,7 @@ export default function SidebarLayout({ fileTree, children }: SidebarLayoutProps
         expanded={lp.railExpanded}
         onExpandedChange={handleExpandedChange}
         onSettingsClick={handleSettingsClick}
+        onHelpClick={handleHelpClick}
         onSyncClick={handleSyncClick}
       />
 

package/app/components/help/HelpContent.tsx

@@ -0,0 +1,229 @@
+'use client';
+
+import { useState, useMemo, useCallback } from 'react';
+import { BookOpen, Rocket, Brain, Keyboard, HelpCircle, Bot, ChevronDown, Copy, Check } from 'lucide-react';
+import { useLocale } from '@/lib/LocaleContext';
+
+/* ── Collapsible Section ── */
+function Section({ icon, title, defaultOpen = false, children }: {
+  icon: React.ReactNode;
+  title: string;
+  defaultOpen?: boolean;
+  children: React.ReactNode;
+}) {
+  const [open, setOpen] = useState(defaultOpen);
+
+  return (
+    <div className="bg-card border border-border rounded-lg overflow-hidden">
+      <button
+        onClick={() => setOpen(v => !v)}
+        className="w-full flex items-center gap-3 px-5 py-4 text-left hover:bg-muted/50 transition-colors focus-visible:ring-2 focus-visible:ring-ring"
+        aria-expanded={open}
+      >
+        <span className="text-[var(--amber)]">{icon}</span>
+        <span className="text-base font-medium font-display text-foreground flex-1">{title}</span>
+        <ChevronDown size={16} className={`text-muted-foreground transition-transform duration-200 ${open ? 'rotate-180' : ''}`} />
+      </button>
+      {open && (
+        <div className="px-5 pb-5 pt-0">
+          <div className="border-t border-border pt-4">
+            {children}
+          </div>
+        </div>
+      )}
+    </div>
+  );
+}
+
+/* ── Step Card ── */
+function StepCard({ step, title, desc }: { step: number; title: string; desc: string }) {
+  return (
+    <div className="flex gap-4 items-start">
+      <div className="shrink-0 w-8 h-8 rounded-full flex items-center justify-center text-sm font-bold font-mono" style={{ background: 'var(--amber-dim)', color: 'var(--amber)' }}>
+        {step}
+      </div>
+      <div className="min-w-0">
+        <p className="text-sm font-medium text-foreground">{title}</p>
+        <p className="text-sm text-muted-foreground mt-0.5">{desc}</p>
+      </div>
+    </div>
+  );
+}
+
+/* ── Copyable Prompt Block ── */
+function PromptBlock({ text, copyLabel }: { text: string; copyLabel: string }) {
+  const [copied, setCopied] = useState(false);
+
+  const handleCopy = useCallback(() => {
+    const clean = text.replace(/^[""]|[""]$/g, '');
+    navigator.clipboard.writeText(clean).then(() => {
+      setCopied(true);
+      setTimeout(() => setCopied(false), 1500);
+    });
+  }, [text]);
+
+  return (
+    <div className="group/prompt mt-2 flex items-start gap-2 bg-background border border-border rounded-md px-3 py-2">
+      <p className="flex-1 text-xs font-mono leading-relaxed" style={{ color: 'var(--amber)' }}>{text}</p>
+      <button
+        onClick={handleCopy}
+        className="shrink-0 p-1 rounded hover:bg-muted text-muted-foreground hover:text-foreground transition-colors opacity-0 group-hover/prompt:opacity-100 focus-visible:opacity-100"
+        aria-label={copyLabel}
+        title={copyLabel}
+      >
+        {copied ? <Check size={13} className="text-success" /> : <Copy size={13} />}
+      </button>
+    </div>
+  );
+}
+
+/* ── FAQ Item ── */
+function FaqItem({ q, a }: { q: string; a: string }) {
+  const [open, setOpen] = useState(false);
+
+  return (
+    <div className="border-b border-border last:border-b-0">
+      <button
+        onClick={() => setOpen(v => !v)}
+        className="w-full flex items-center justify-between py-3 text-left focus-visible:ring-2 focus-visible:ring-ring"
+        aria-expanded={open}
+      >
+        <span className="text-sm font-medium text-foreground pr-4">{q}</span>
+        <ChevronDown size={14} className={`shrink-0 text-muted-foreground transition-transform duration-200 ${open ? 'rotate-180' : ''}`} />
+      </button>
+      {open && (
+        <p className="text-sm text-muted-foreground pb-3 leading-relaxed">{a}</p>
+      )}
+    </div>
+  );
+}
+
+/* ── Shortcut Row ── */
+function ShortcutRow({ keys, label }: { keys: string; label: string }) {
+  return (
+    <div className="flex items-center justify-between py-1.5">
+      <span className="text-sm text-foreground">{label}</span>
+      <div className="flex items-center gap-1">
+        {keys.split(' ').map((key, i) => (
+          <kbd
+            key={i}
+            className="px-1.5 py-0.5 text-xs rounded border border-border bg-muted text-muted-foreground font-mono min-w-[24px] text-center"
+          >
+            {key}
+          </kbd>
+        ))}
+      </div>
+    </div>
+  );
+}
+
+/* ── Main Component ── */
+export default function HelpContent() {
+  const { t } = useLocale();
+  const h = t.help;
+
+  const isMac = typeof navigator !== 'undefined' && /Mac|iPhone|iPad/.test(navigator.userAgent);
+  const mod = isMac ? '⌘' : 'Ctrl';
+
+  const shortcuts = useMemo(() => [
+    { keys: `${mod} K`, label: h.shortcuts.search },
+    { keys: `${mod} /`, label: h.shortcuts.askAI },
+    { keys: `${mod} ,`, label: h.shortcuts.settings },
+    { keys: `${mod} ?`, label: h.shortcuts.shortcutPanel },
+    { keys: 'E', label: h.shortcuts.editFile },
+    { keys: `${mod} S`, label: h.shortcuts.save },
+    { keys: 'Esc', label: h.shortcuts.closePanel },
+    { keys: '@', label: h.shortcuts.attachFile },
+  ], [mod, h.shortcuts]);
+
+  return (
+    <div className="content-width px-4 md:px-6 py-8 md:py-12">
+      {/* ── Header ── */}
+      <div className="mb-8">
+        <div className="flex items-center gap-2 mb-1">
+          <div className="w-1 h-6 rounded-full" style={{ background: 'var(--amber)' }} />
+          <h1 className="text-2xl font-bold font-display text-foreground">{h.title}</h1>
+        </div>
+        <p className="text-muted-foreground text-sm ml-3 mt-1">{h.subtitle}</p>
+      </div>
+
+      {/* ── Sections ── */}
+      <div className="space-y-3">
+        {/* 1. What is MindOS */}
+        <Section icon={<BookOpen size={18} />} title={h.whatIs.title} defaultOpen>
+          <p className="text-sm text-muted-foreground leading-relaxed">{h.whatIs.body}</p>
+        </Section>
+
+        {/* 2. Core Concepts */}
+        <Section icon={<Brain size={18} />} title={h.concepts.title} defaultOpen>
+          <div className="space-y-4">
+            <div>
+              <p className="text-sm font-medium text-foreground">{h.concepts.spaceTitle}</p>
+              <p className="text-sm text-muted-foreground mt-0.5">{h.concepts.spaceDesc}</p>
+            </div>
+            <div>
+              <p className="text-sm font-medium text-foreground">{h.concepts.instructionTitle}</p>
+              <p className="text-sm text-muted-foreground mt-0.5">{h.concepts.instructionDesc}</p>
+            </div>
+            <div>
+              <p className="text-sm font-medium text-foreground">{h.concepts.skillTitle}</p>
+              <p className="text-sm text-muted-foreground mt-0.5">{h.concepts.skillDesc}</p>
+            </div>
+          </div>
+        </Section>
+
+        {/* 3. Quick Start */}
+        <Section icon={<Rocket size={18} />} title={h.quickStart.title} defaultOpen>
+          <div className="space-y-4">
+            <StepCard step={1} title={h.quickStart.step1Title} desc={h.quickStart.step1Desc} />
+            <StepCard step={2} title={h.quickStart.step2Title} desc={h.quickStart.step2Desc} />
+            <StepCard step={3} title={h.quickStart.step3Title} desc={h.quickStart.step3Desc} />
+          </div>
+        </Section>
+
+        {/* 4. Using MindOS with AI Agents */}
+        <Section icon={<Bot size={18} />} title={h.agentUsage.title} defaultOpen>
+          <p className="text-sm text-muted-foreground leading-relaxed mb-4">{h.agentUsage.intro}</p>
+
+          <div className="space-y-3">
+            {h.agentUsage.scenarios.map((sc, i) => {
+              const prompts = sc.prompt.split('\n');
+              return (
+                <div key={i} className="bg-muted/50 rounded-md px-4 py-3">
+                  <div className="flex items-center gap-2">
+                    <span className="text-base leading-none" role="img" suppressHydrationWarning>{sc.emoji}</span>
+                    <p className="text-sm font-medium text-foreground">{sc.title}</p>
+                  </div>
+                  <p className="text-sm text-muted-foreground mt-1">{sc.desc}</p>
+                  {prompts.map((p, j) => (
+                    <PromptBlock key={j} text={p} copyLabel={h.agentUsage.copy} />
+                  ))}
+                </div>
+              );
+            })}
+          </div>
+
+          <p className="text-xs text-muted-foreground mt-4">{h.agentUsage.hint}</p>
+        </Section>
+
+        {/* 5. Keyboard Shortcuts */}
+        <Section icon={<Keyboard size={18} />} title={h.shortcutsTitle}>
+          <div className="space-y-0">
+            {shortcuts.map((s) => (
+              <ShortcutRow key={s.keys} keys={s.keys} label={s.label} />
+            ))}
+          </div>
+        </Section>
+
+        {/* 6. FAQ */}
+        <Section icon={<HelpCircle size={18} />} title={h.faq.title}>
+          <div>
+            {h.faq.items.map((item, i) => (
+              <FaqItem key={i} q={item.q} a={item.a} />
+            ))}
+          </div>
+        </Section>
+      </div>
+    </div>
+  );
+}

package/app/lib/i18n-en.ts

@@ -60,6 +60,7 @@ export const en = {
     plugins: 'Plugins',
     agents: 'Agents',
     discover: 'Discover',
+    help: 'Help',
     syncLabel: 'Sync',
     collapseTitle: 'Collapse sidebar',
     expandTitle: 'Expand sidebar',
@@ -659,7 +660,7 @@ export const en = {
       promptEmpty: 'Help me design a knowledge base folder structure that fits my needs',
     },
     sync: {
-      title: 'Set up sync',
+      title: 'Sync Notes',
       optional: 'Optional',
       cta: 'Configure',
     },
@@ -770,4 +771,66 @@ export const en = {
       },
     ],
   },
+  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 is my resume, read it and organize my identity, skills, and preferences into MindOS Profile."' },
+        { 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.' },
+      ],
+    },
+  },
 } as const;

package/app/lib/i18n-zh.ts

@@ -85,6 +85,7 @@ export const zh = {
     plugins: '插件',
     agents: '智能体',
     discover: '探索',
+    help: '帮助',
     syncLabel: '同步',
     collapseTitle: '收起侧栏',
     expandTitle: '展开侧栏',
@@ -684,7 +685,7 @@ export const zh = {
       promptEmpty: '帮我设计一个适合我的知识库目录结构',
     },
     sync: {
-      title: '配置同步',
+      title: '同步笔记',
       optional: '可选',
       cta: '设置',
     },
@@ -795,4 +796,66 @@ export const zh = {
       },
     ],
   },
+  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 Profile 里。"' },
+        { 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 文件，你也可以直接在文件系统中创建。' },
+      ],
+    },
+  },
 } as const satisfies Widen<typeof en>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geminilight/mindos",
-  "version": "0.5.48",
+  "version": "0.5.50",
   "description": "MindOS — Human-Agent Collaborative Mind System. Local-first knowledge base that syncs your mind to all AI Agents via MCP.",
   "keywords": [
     "mindos",