@geminilight/mindos 0.1.9 → 0.2.1

package/app/components/settings/SyncTab.tsx

@@ -0,0 +1,311 @@
+'use client';
+
+import { useState, useEffect, useCallback } from 'react';
+import { RefreshCw, AlertCircle, CheckCircle2, Loader2, GitBranch, Copy, Check, ExternalLink } from 'lucide-react';
+import { SectionLabel } from './Primitives';
+import { apiFetch } from '@/lib/api';
+
+export interface SyncStatus {
+  enabled: boolean;
+  provider?: string;
+  remote?: string;
+  branch?: string;
+  lastSync?: string | null;
+  lastPull?: string | null;
+  unpushed?: string;
+  conflicts?: Array<{ file: string; time: string }>;
+  lastError?: string | null;
+  autoCommitInterval?: number;
+  autoPullInterval?: number;
+}
+
+interface SyncTabProps {
+  t: any;
+}
+
+export function timeAgo(iso: string | null | undefined): string {
+  if (!iso) return 'never';
+  const diff = Date.now() - new Date(iso).getTime();
+  if (diff < 60000) return 'just now';
+  if (diff < 3600000) return `${Math.floor(diff / 60000)}m ago`;
+  if (diff < 86400000) return `${Math.floor(diff / 3600000)}h ago`;
+  return `${Math.floor(diff / 86400000)}d ago`;
+}
+
+/* ── Copy-to-clipboard button ──────────────────────────────────── */
+
+function CopyButton({ text }: { text: string }) {
+  const [copied, setCopied] = useState(false);
+  const handleCopy = async () => {
+    await navigator.clipboard.writeText(text);
+    setCopied(true);
+    setTimeout(() => setCopied(false), 2000);
+  };
+  return (
+    <button
+      type="button"
+      onClick={handleCopy}
+      className="p-1 rounded hover:bg-muted text-muted-foreground hover:text-foreground transition-colors shrink-0"
+      title="Copy command"
+    >
+      {copied ? <Check size={12} className="text-green-500" /> : <Copy size={12} />}
+    </button>
+  );
+}
+
+/* ── Empty state (Task D) ──────────────────────────────────────── */
+
+function SyncEmptyState({ t }: { t: any }) {
+  const syncT = t.settings?.sync;
+  const cmd = 'mindos sync init';
+
+  return (
+    <div className="space-y-6">
+      {/* Header */}
+      <div className="flex items-center gap-3">
+        <div className="w-9 h-9 rounded-lg bg-muted flex items-center justify-center shrink-0">
+          <GitBranch size={18} className="text-muted-foreground" />
+        </div>
+        <div>
+          <h3 className="text-sm font-medium text-foreground">
+            {syncT?.emptyTitle ?? 'Cross-device Sync'}
+          </h3>
+          <p className="text-xs text-muted-foreground mt-0.5">
+            {syncT?.emptyDesc ?? 'Automatically sync your knowledge base across devices via Git.'}
+          </p>
+        </div>
+      </div>
+
+      {/* Steps */}
+      <div className="space-y-3">
+        <SectionLabel>{syncT?.emptyStepsTitle ?? 'Setup'}</SectionLabel>
+        <ol className="space-y-2.5 text-xs text-muted-foreground">
+          <li className="flex items-start gap-2.5">
+            <span className="w-5 h-5 rounded-full bg-muted flex items-center justify-center shrink-0 text-[10px] font-medium text-foreground mt-0.5">1</span>
+            <span>{syncT?.emptyStep1 ?? 'Create a private Git repo (GitHub, GitLab, etc.) or use an existing one.'}</span>
+          </li>
+          <li className="flex items-start gap-2.5">
+            <span className="w-5 h-5 rounded-full bg-muted flex items-center justify-center shrink-0 text-[10px] font-medium text-foreground mt-0.5">2</span>
+            <div className="flex-1">
+              <span>{syncT?.emptyStep2 ?? 'Run this command in your terminal:'}</span>
+              <div className="flex items-center gap-1.5 mt-1.5 px-3 py-2 bg-muted rounded-lg font-mono text-xs text-foreground">
+                <code className="flex-1 select-all">{cmd}</code>
+                <CopyButton text={cmd} />
+              </div>
+            </div>
+          </li>
+          <li className="flex items-start gap-2.5">
+            <span className="w-5 h-5 rounded-full bg-muted flex items-center justify-center shrink-0 text-[10px] font-medium text-foreground mt-0.5">3</span>
+            <span>{syncT?.emptyStep3 ?? 'Follow the prompts to connect your repo. Sync starts automatically.'}</span>
+          </li>
+        </ol>
+      </div>
+
+      {/* Features */}
+      <div className="grid grid-cols-2 gap-2 text-[11px] text-muted-foreground">
+        {[
+          syncT?.featureAutoCommit ?? 'Auto-commit on save',
+          syncT?.featureAutoPull ?? 'Auto-pull from remote',
+          syncT?.featureConflict ?? 'Conflict detection',
+          syncT?.featureMultiDevice ?? 'Works across devices',
+        ].map((f, i) => (
+          <div key={i} className="flex items-center gap-1.5">
+            <CheckCircle2 size={11} className="text-green-500/60 shrink-0" />
+            <span>{f}</span>
+          </div>
+        ))}
+      </div>
+    </div>
+  );
+}
+
+/* ── Main SyncTab ──────────────────────────────────────────────── */
+
+export function SyncTab({ t }: SyncTabProps) {
+  const [status, setStatus] = useState<SyncStatus | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [syncing, setSyncing] = useState(false);
+  const [toggling, setToggling] = useState(false);
+  const [message, setMessage] = useState<{ type: 'success' | 'error'; text: string } | null>(null);
+
+  const fetchStatus = useCallback(async () => {
+    try {
+      const data = await apiFetch<SyncStatus>('/api/sync');
+      setStatus(data);
+    } catch {
+      setStatus(null);
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useEffect(() => { fetchStatus(); }, [fetchStatus]);
+
+  const handleSyncNow = async () => {
+    setSyncing(true);
+    setMessage(null);
+    try {
+      await apiFetch('/api/sync', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ action: 'now' }),
+      });
+      setMessage({ type: 'success', text: 'Sync complete' });
+      await fetchStatus();
+    } catch {
+      setMessage({ type: 'error', text: 'Sync failed' });
+    } finally {
+      setSyncing(false);
+      setTimeout(() => setMessage(null), 3000);
+    }
+  };
+
+  const handleToggle = async () => {
+    if (!status) return;
+    setToggling(true);
+    setMessage(null);
+    const action = status.enabled ? 'off' : 'on';
+    try {
+      await apiFetch('/api/sync', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ action }),
+      });
+      await fetchStatus();
+      setMessage({ type: 'success', text: status.enabled ? 'Auto-sync disabled' : 'Auto-sync enabled' });
+    } catch {
+      setMessage({ type: 'error', text: 'Failed to toggle sync' });
+    } finally {
+      setToggling(false);
+      setTimeout(() => setMessage(null), 3000);
+    }
+  };
+
+  if (loading) {
+    return (
+      <div className="flex justify-center py-8">
+        <Loader2 size={18} className="animate-spin text-muted-foreground" />
+      </div>
+    );
+  }
+
+  if (!status || !status.enabled) {
+    return <SyncEmptyState t={t} />;
+  }
+
+  const conflicts = status.conflicts || [];
+
+  return (
+    <div className="space-y-5">
+      <SectionLabel>Sync</SectionLabel>
+
+      {/* Status overview */}
+      <div className="space-y-2 text-sm">
+        <div className="flex items-center gap-2">
+          <span className="text-muted-foreground w-24 shrink-0">Provider</span>
+          <span className="font-mono text-xs">{status.provider}</span>
+        </div>
+        <div className="flex items-center gap-2">
+          <span className="text-muted-foreground w-24 shrink-0">Remote</span>
+          <span className="font-mono text-xs truncate" title={status.remote}>{status.remote}</span>
+        </div>
+        <div className="flex items-center gap-2">
+          <span className="text-muted-foreground w-24 shrink-0">Branch</span>
+          <span className="font-mono text-xs">{status.branch}</span>
+        </div>
+        <div className="flex items-center gap-2">
+          <span className="text-muted-foreground w-24 shrink-0">Last sync</span>
+          <span className="text-xs">{timeAgo(status.lastSync)}</span>
+        </div>
+        <div className="flex items-center gap-2">
+          <span className="text-muted-foreground w-24 shrink-0">Unpushed</span>
+          <span className="text-xs">{status.unpushed} commits</span>
+        </div>
+        <div className="flex items-center gap-2">
+          <span className="text-muted-foreground w-24 shrink-0">Auto-sync</span>
+          <span className="text-xs">
+            commit: {status.autoCommitInterval}s, pull: {Math.floor((status.autoPullInterval || 300) / 60)}min
+          </span>
+        </div>
+      </div>
+
+      {/* Actions */}
+      <div className="flex items-center gap-2 pt-2">
+        <button
+          type="button"
+          onClick={handleSyncNow}
+          disabled={syncing}
+          className="flex items-center gap-1.5 px-3 py-1.5 text-xs rounded-lg border border-border text-muted-foreground hover:text-foreground hover:bg-muted disabled:opacity-40 disabled:cursor-not-allowed transition-colors"
+        >
+          <RefreshCw size={12} className={syncing ? 'animate-spin' : ''} />
+          Sync Now
+        </button>
+        <button
+          type="button"
+          onClick={handleToggle}
+          disabled={toggling}
+          className={`flex items-center gap-1.5 px-3 py-1.5 text-xs rounded-lg border transition-colors disabled:opacity-40 disabled:cursor-not-allowed ${
+            status.enabled
+              ? 'border-border text-muted-foreground hover:text-destructive hover:border-destructive/50'
+              : 'border-green-500/30 text-green-500 hover:bg-green-500/10'
+          }`}
+        >
+          {status.enabled ? 'Disable Auto-sync' : 'Enable Auto-sync'}
+        </button>
+      </div>
+
+      {/* Message */}
+      {message && (
+        <div className="flex items-center gap-1.5 text-xs">
+          {message.type === 'success' ? (
+            <><CheckCircle2 size={13} className="text-green-500" /><span className="text-green-500">{message.text}</span></>
+          ) : (
+            <><AlertCircle size={13} className="text-destructive" /><span className="text-destructive">{message.text}</span></>
+          )}
+        </div>
+      )}
+
+      {/* Conflicts (Task H — enhanced with links) */}
+      {conflicts.length > 0 && (
+        <div className="pt-2 border-t border-border">
+          <SectionLabel>Conflicts ({conflicts.length})</SectionLabel>
+          <div className="space-y-1.5">
+            {conflicts.map((c, i) => (
+              <div key={i} className="flex items-center gap-2 text-xs group">
+                <AlertCircle size={12} className="text-red-500 shrink-0" />
+                <a
+                  href={`/view/${encodeURIComponent(c.file)}`}
+                  className="font-mono truncate hover:text-foreground hover:underline transition-colors"
+                  title={`Open ${c.file}`}
+                >
+                  {c.file}
+                </a>
+                <a
+                  href={`/view/${encodeURIComponent(c.file + '.sync-conflict')}`}
+                  className="opacity-0 group-hover:opacity-100 transition-opacity shrink-0 text-muted-foreground hover:text-foreground"
+                  title="View remote version (.sync-conflict)"
+                >
+                  <ExternalLink size={11} />
+                </a>
+                <span className="text-muted-foreground shrink-0 ml-auto">{timeAgo(c.time)}</span>
+              </div>
+            ))}
+          </div>
+          <p className="text-xs text-muted-foreground mt-2">
+            Click a file to view your version. Hover and click <ExternalLink size={10} className="inline" /> to see the remote version.
+          </p>
+        </div>
+      )}
+
+      {/* Error */}
+      {status.lastError && (
+        <div className="pt-2 border-t border-border">
+          <div className="flex items-start gap-2 text-xs text-destructive">
+            <AlertCircle size={12} className="shrink-0 mt-0.5" />
+            <span>{status.lastError}</span>
+          </div>
+        </div>
+      )}
+    </div>
+  );
+}

package/app/components/settings/types.ts

@@ -24,7 +24,7 @@ export interface SettingsData {
   envValues?: Record<string, string>;
 }
 
-export type Tab = 'ai' | 'appearance' | 'knowledge' | 'plugins' | 'shortcuts';
+export type Tab = 'ai' | 'appearance' | 'knowledge' | 'plugins' | 'shortcuts' | 'sync';
 
 export const CONTENT_WIDTHS = [
   { value: '680px', label: 'Narrow (680px)' },

package/app/lib/agent/log.ts

@@ -0,0 +1,44 @@
+import fs from 'fs';
+import path from 'path';
+import { getMindRoot } from '@/lib/fs';
+
+const LOG_FILE = '.agent-log.json';
+const MAX_SIZE = 500 * 1024; // 500KB
+
+interface AgentOpEntry {
+  ts: string;
+  tool: string;
+  params: Record<string, unknown>;
+  result: 'ok' | 'error';
+  message?: string;
+}
+
+/**
+ * Append an agent operation entry to .agent-log.json (JSON Lines format).
+ * Each line is a self-contained JSON object — easy to parse, grep, and tail.
+ * Auto-truncates when file exceeds MAX_SIZE.
+ */
+export function logAgentOp(entry: AgentOpEntry): void {
+  try {
+    const root = getMindRoot();
+    const logPath = path.join(root, LOG_FILE);
+
+    const line = JSON.stringify(entry) + '\n';
+
+    // Check size and truncate if needed
+    if (fs.existsSync(logPath)) {
+      const stat = fs.statSync(logPath);
+      if (stat.size > MAX_SIZE) {
+        const content = fs.readFileSync(logPath, 'utf-8');
+        const lines = content.trimEnd().split('\n');
+        // Keep the newer half
+        const kept = lines.slice(Math.floor(lines.length / 2));
+        fs.writeFileSync(logPath, kept.join('\n') + '\n');
+      }
+    }
+
+    fs.appendFileSync(logPath, line);
+  } catch {
+    // Logging should never break tool execution
+  }
+}

package/app/lib/agent/tools.ts

@@ -5,6 +5,7 @@ import {
   saveFileContent, createFile, appendToFile, insertAfterHeading, updateSection,
 } from '@/lib/fs';
 import { assertNotProtected } from '@/lib/core';
+import { logAgentOp } from './log';
 
 // Max chars per file to avoid token overflow (~100k chars ≈ ~25k tokens)
 const MAX_FILE_CHARS = 20_000;
@@ -19,47 +20,67 @@ export function assertWritable(filePath: string): void {
   assertNotProtected(filePath, 'modified by AI agent');
 }
 
+/** Helper: wrap a tool execute fn with agent-op logging */
+function logged<P extends Record<string, unknown>>(
+  toolName: string,
+  fn: (params: P) => Promise<string>,
+): (params: P) => Promise<string> {
+  return async (params: P) => {
+    const ts = new Date().toISOString();
+    try {
+      const result = await fn(params);
+      const isError = result.startsWith('Error:');
+      logAgentOp({ ts, tool: toolName, params, result: isError ? 'error' : 'ok', message: result.slice(0, 200) });
+      return result;
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      logAgentOp({ ts, tool: toolName, params, result: 'error', message: msg.slice(0, 200) });
+      throw e;
+    }
+  };
+}
+
 // ─── Knowledge base tools ─────────────────────────────────────────────────────
 
 export const knowledgeBaseTools = {
   list_files: tool({
     description: 'List the full file tree of the knowledge base. Use this to browse what files exist.',
     inputSchema: z.object({}),
-    execute: async () => {
+    execute: logged('list_files', async () => {
       const tree = getFileTree();
       return JSON.stringify(tree, null, 2);
-    },
+    }),
   }),
 
   read_file: tool({
     description: 'Read the content of a file by its relative path. Always read a file before modifying it.',
     inputSchema: z.object({ path: z.string().describe('Relative file path, e.g. "Profile/👤 Identity.md"') }),
-    execute: async ({ path }) => {
+    execute: logged('read_file', async ({ path }) => {
       try {
         return truncate(getFileContent(path));
       } catch (e: unknown) {
         return `Error: ${e instanceof Error ? e.message : String(e)}`;
       }
-    },
+    }),
   }),
 
   search: tool({
     description: 'Full-text search across all files in the knowledge base. Returns matching files with context snippets.',
     inputSchema: z.object({ query: z.string().describe('Search query (case-insensitive)') }),
-    execute: async ({ query }) => {
+    execute: logged('search', async ({ query }) => {
       const results = searchFiles(query);
       if (results.length === 0) return 'No results found.';
       return results.map(r => `- **${r.path}**: ${r.snippet}`).join('\n');
-    },
+    }),
   }),
 
   get_recent: tool({
     description: 'Get the most recently modified files in the knowledge base.',
     inputSchema: z.object({ limit: z.number().min(1).max(50).default(10).describe('Number of files to return') }),
-    execute: async ({ limit }) => {
+    execute: logged('get_recent', async ({ limit }) => {
       const files = getRecentlyModified(limit);
       return files.map(f => `- ${f.path} (${new Date(f.mtime).toISOString()})`).join('\n');
-    },
+    }),
   }),
 
   write_file: tool({
@@ -68,7 +89,7 @@ export const knowledgeBaseTools = {
       path: z.string().describe('Relative file path'),
       content: z.string().describe('New full content'),
     }),
-    execute: async ({ path, content }) => {
+    execute: logged('write_file', async ({ path, content }) => {
       try {
         assertWritable(path);
         saveFileContent(path, content);
@@ -76,7 +97,7 @@ export const knowledgeBaseTools = {
       } catch (e: unknown) {
         return `Error: ${e instanceof Error ? e.message : String(e)}`;
       }
-    },
+    }),
   }),
 
   create_file: tool({
@@ -85,7 +106,7 @@ export const knowledgeBaseTools = {
       path: z.string().describe('Relative file path (must end in .md or .csv)'),
       content: z.string().default('').describe('Initial file content'),
     }),
-    execute: async ({ path, content }) => {
+    execute: logged('create_file', async ({ path, content }) => {
       try {
         assertWritable(path);
         createFile(path, content);
@@ -93,7 +114,7 @@ export const knowledgeBaseTools = {
       } catch (e: unknown) {
         return `Error: ${e instanceof Error ? e.message : String(e)}`;
       }
-    },
+    }),
   }),
 
   append_to_file: tool({
@@ -102,7 +123,7 @@ export const knowledgeBaseTools = {
       path: z.string().describe('Relative file path'),
       content: z.string().describe('Content to append'),
     }),
-    execute: async ({ path, content }) => {
+    execute: logged('append_to_file', async ({ path, content }) => {
       try {
         assertWritable(path);
         appendToFile(path, content);
@@ -110,7 +131,7 @@ export const knowledgeBaseTools = {
       } catch (e: unknown) {
         return `Error: ${e instanceof Error ? e.message : String(e)}`;
       }
-    },
+    }),
   }),
 
   insert_after_heading: tool({
@@ -120,7 +141,7 @@ export const knowledgeBaseTools = {
       heading: z.string().describe('Heading text to find (e.g. "## Tasks" or just "Tasks")'),
       content: z.string().describe('Content to insert after the heading'),
     }),
-    execute: async ({ path, heading, content }) => {
+    execute: logged('insert_after_heading', async ({ path, heading, content }) => {
       try {
         assertWritable(path);
         insertAfterHeading(path, heading, content);
@@ -128,7 +149,7 @@ export const knowledgeBaseTools = {
       } catch (e: unknown) {
         return `Error: ${e instanceof Error ? e.message : String(e)}`;
       }
-    },
+    }),
   }),
 
   update_section: tool({
@@ -138,7 +159,7 @@ export const knowledgeBaseTools = {
       heading: z.string().describe('Heading text to find (e.g. "## Status")'),
       content: z.string().describe('New content for the section'),
     }),
-    execute: async ({ path, heading, content }) => {
+    execute: logged('update_section', async ({ path, heading, content }) => {
       try {
         assertWritable(path);
         updateSection(path, heading, content);
@@ -146,6 +167,6 @@ export const knowledgeBaseTools = {
       } catch (e: unknown) {
         return `Error: ${e instanceof Error ? e.message : String(e)}`;
       }
-    },
+    }),
   }),
 };

package/app/lib/i18n.ts

@@ -36,6 +36,22 @@ export const messages = {
       settingsTitle: 'Settings (⌘,)',
       collapseTitle: 'Collapse sidebar',
       expandTitle: 'Expand sidebar',
+      sync: {
+        synced: 'Synced',
+        unpushed: 'awaiting push',
+        unpushedHint: 'commit(s) not yet pushed to remote — will sync automatically',
+        conflicts: 'conflicts',
+        conflictsHint: 'file(s) have merge conflicts — open Settings > Sync to resolve',
+        syncError: 'Sync error',
+        syncOff: 'Sync off',
+        syncing: 'Syncing...',
+        syncNow: 'Sync now',
+        syncDone: 'Sync complete',
+        syncFailed: 'Sync failed',
+        syncRestored: 'Sync restored',
+        enableSync: 'Enable sync',
+        enableHint: 'Set up cross-device sync',
+      },
     },
     search: {
       placeholder: 'Search files...',
@@ -83,7 +99,7 @@ export const messages = {
     },
     settings: {
       title: 'Settings',
-      tabs: { ai: 'AI', appearance: 'Appearance', knowledge: 'Knowledge Base', plugins: 'Plugins', shortcuts: 'Shortcuts' },
+      tabs: { ai: 'AI', appearance: 'Appearance', knowledge: 'Knowledge Base', sync: 'Sync', plugins: 'Plugins', shortcuts: 'Shortcuts' },
       ai: {
         provider: 'Provider',
         model: 'Model',
@@ -125,6 +141,18 @@ export const messages = {
         authTokenResetConfirm: 'Regenerate token? All existing MCP clients will need to update their config.',
         authTokenMcpPort: 'MCP port',
       },
+      sync: {
+        emptyTitle: 'Cross-device Sync',
+        emptyDesc: 'Automatically sync your knowledge base across devices via Git.',
+        emptyStepsTitle: 'Setup',
+        emptyStep1: 'Create a private Git repo (GitHub, GitLab, etc.) or use an existing one.',
+        emptyStep2: 'Run this command in your terminal:',
+        emptyStep3: 'Follow the prompts to connect your repo. Sync starts automatically.',
+        featureAutoCommit: 'Auto-commit on save',
+        featureAutoPull: 'Auto-pull from remote',
+        featureConflict: 'Conflict detection',
+        featureMultiDevice: 'Works across devices',
+      },
       plugins: {
         title: 'Installed Renderers',
         builtinBadge: 'built-in',
@@ -138,6 +166,17 @@ export const messages = {
       saved: 'Saved',
       saveFailed: 'Save failed',
     },
+    onboarding: {
+      subtitle: 'Your knowledge base is empty. Pick a starter template to get going.',
+      templates: {
+        en: { title: 'English', desc: 'Pre-built structure with Profile, Notes, Projects, and more.' },
+        zh: { title: '中文', desc: '预置画像、笔记、项目等中文目录结构。' },
+        empty: { title: 'Empty', desc: 'Just the essentials — README, CONFIG, and INSTRUCTION.' },
+      },
+      importHint: 'Already have notes? Set MIND_ROOT to your existing directory in Settings.',
+      syncHint: 'Want cross-device sync? Run',
+      syncHintSuffix: 'in the terminal after setup.',
+    },
     shortcuts: [
       { keys: ['⌘', 'K'], description: 'Search' },
       { keys: ['⌘', '/'], description: 'Ask AI' },
@@ -183,6 +222,22 @@ export const messages = {
       settingsTitle: '设置 (⌘,)',
       collapseTitle: '收起侧栏',
       expandTitle: '展开侧栏',
+      sync: {
+        synced: '已同步',
+        unpushed: '待推送',
+        unpushedHint: '个提交尚未推送到远程 — 将自动同步',
+        conflicts: '冲突',
+        conflictsHint: '个文件存在合并冲突 — 前往 设置 > 同步 解决',
+        syncError: '同步出错',
+        syncOff: '同步关闭',
+        syncing: '同步中...',
+        syncNow: '立即同步',
+        syncDone: '同步完成',
+        syncFailed: '同步失败',
+        syncRestored: '同步已恢复',
+        enableSync: '启用同步',
+        enableHint: '设置跨设备同步',
+      },
     },
     search: {
       placeholder: '搜索文件...',
@@ -230,7 +285,7 @@ export const messages = {
     },
     settings: {
       title: '设置',
-      tabs: { ai: 'AI', appearance: '外观', knowledge: '知识库', plugins: '插件', shortcuts: '快捷键' },
+      tabs: { ai: 'AI', appearance: '外观', knowledge: '知识库', sync: '同步', plugins: '插件', shortcuts: '快捷键' },
       ai: {
         provider: '服务商',
         model: '模型',
@@ -272,6 +327,18 @@ export const messages = {
         authTokenResetConfirm: '重新生成令牌？所有 MCP 客户端配置都需要更新。',
         authTokenMcpPort: 'MCP 端口',
       },
+      sync: {
+        emptyTitle: '跨设备同步',
+        emptyDesc: '通过 Git 自动同步知识库到所有设备。',
+        emptyStepsTitle: '配置步骤',
+        emptyStep1: '创建一个私有 Git 仓库（GitHub、GitLab 等），或使用现有仓库。',
+        emptyStep2: '在终端中运行以下命令：',
+        emptyStep3: '按照提示连接仓库，同步将自动开始。',
+        featureAutoCommit: '保存时自动提交',
+        featureAutoPull: '自动拉取远程更新',
+        featureConflict: '冲突检测',
+        featureMultiDevice: '多设备同步',
+      },
       plugins: {
         title: '已安装渲染器',
         builtinBadge: '内置',
@@ -285,6 +352,17 @@ export const messages = {
       saved: '已保存',
       saveFailed: '保存失败',
     },
+    onboarding: {
+      subtitle: '知识库为空，选择一个模板快速开始。',
+      templates: {
+        en: { title: 'English', desc: '预置 Profile、Notes、Projects 等英文目录结构。' },
+        zh: { title: '中文', desc: '预置画像、笔记、项目等中文目录结构。' },
+        empty: { title: '空白', desc: '仅包含 README、CONFIG 和 INSTRUCTION 基础文件。' },
+      },
+      importHint: '已有笔记？在设置中将 MIND_ROOT 指向已有目录即可。',
+      syncHint: '需要跨设备同步？完成初始化后在终端运行',
+      syncHintSuffix: '即可。',
+    },
     shortcuts: [
       { keys: ['⌘', 'K'], description: '搜索' },
       { keys: ['⌘', '/'], description: '问 AI' },