@geminilight/mindos 0.6.39 → 0.6.41

package/app/lib/agent/tools.ts

@@ -4,7 +4,7 @@ import type { AgentTool, AgentToolResult } from '@mariozechner/pi-agent-core';
 import {
   searchFiles, getFileContent, getFileTree, getRecentlyModified,
   saveFileContent, createFile, appendToFile, insertAfterHeading, updateSection,
-  deleteFile, renameFile, moveFile, findBacklinks, gitLog, gitShowFile, appendCsvRow,
+  moveToTrashFile, renameFile, moveFile, findBacklinks, gitLog, gitShowFile, appendCsvRow,
   getMindRoot,
 } from '@/lib/fs';
 import { readSkillContentByName, scanSkillDirs } from '@/lib/pi-integration/skills';
@@ -239,6 +239,28 @@ export function getOrganizeTools(): AgentTool<any>[] {
   return knowledgeBaseTools.filter(t => ORGANIZE_TOOL_NAMES.has(t.name));
 }
 
+/**
+ * Read-only tool set for Chat mode.
+ *
+ * Allows searching and reading the knowledge base + web access,
+ * but blocks all write operations. Extensible: add tool names here
+ * to grant more read-only capabilities to Chat mode.
+ */
+const CHAT_TOOL_NAMES = new Set([
+  'list_files',
+  'read_file',
+  'read_file_chunk',
+  'search',
+  'get_recent',
+  'get_backlinks',
+  'web_search',
+  'web_fetch',
+]);
+
+export function getChatTools(): AgentTool<any>[] {
+  return knowledgeBaseTools.filter(t => CHAT_TOOL_NAMES.has(t.name));
+}
+
 export async function getRequestScopedTools(): Promise<AgentTool<any>[]> {
   const baseTools = [...knowledgeBaseTools, ...a2aTools, ...acpTools];
   try {
@@ -685,11 +707,11 @@ export const knowledgeBaseTools: AgentTool<any>[] = [
   {
     name: 'delete_file',
     label: 'Delete File',
-    description: 'Permanently delete a file from the knowledge base. This is destructive and cannot be undone.',
+    description: 'Delete a file from the knowledge base. The file is moved to trash and can be recovered within 30 days.',
     parameters: PathParam,
     execute: safeExecute(async (_id, params: Static<typeof PathParam>) => {
-      deleteFile(params.path);
-      return textResult(`File deleted: ${params.path}`);
+      const meta = moveToTrashFile(params.path);
+      return textResult(`Moved to trash: ${params.path} (recoverable for 30 days, trashId: ${meta.id})`);
     }),
   },
 

package/app/lib/api.ts

@@ -36,7 +36,9 @@ export async function apiFetch<T>(url: string, opts: ApiFetchOptions = {}): Prom
   }
 
   if (timeout > 0 && controller) {
-    timeoutId = setTimeout(() => controller.abort(), timeout);
+    timeoutId = setTimeout(() => {
+      controller.abort(new Error(`Request timed out after ${Math.round(timeout / 1000)}s`));
+    }, timeout);
   }
 
   // Bridge caller-provided AbortSignal so both timeout and external cancel work.

package/app/lib/core/agent-audit-log.ts

@@ -9,6 +9,8 @@ export interface AgentAuditEvent {
   result: 'ok' | 'error';
   message?: string;
   durationMs?: number;
+  /** Name of the agent that performed this operation (e.g. "claude-code", "cursor"). */
+  agentName?: string;
   op?: 'append' | 'legacy_agent_audit_md_import' | 'legacy_agent_log_jsonl_import';
 }
 
@@ -19,6 +21,8 @@ export interface AgentAuditInput {
   result: 'ok' | 'error';
   message?: string;
   durationMs?: number;
+  /** Name of the agent that performed this operation. */
+  agentName?: string;
 }
 
 interface AgentAuditState {
@@ -111,6 +115,7 @@ interface LegacyAgentOp {
   result?: 'ok' | 'error';
   message?: string;
   durationMs?: number;
+  agentName?: string;
 }
 
 function parseLegacyMdBlocks(raw: string): LegacyAgentOp[] {
@@ -253,6 +258,7 @@ export function appendAgentAuditEvent(mindRoot: string, input: AgentAuditInput):
     result: input.result === 'error' ? 'error' : 'ok',
     message: normalizeMessage(input.message),
     durationMs: typeof input.durationMs === 'number' ? input.durationMs : undefined,
+    agentName: typeof input.agentName === 'string' && input.agentName.trim() ? input.agentName.trim() : undefined,
     op: 'append',
   };
   state.events.unshift(event);
@@ -275,6 +281,7 @@ export function parseAgentAuditJsonLines(raw: string): AgentAuditInput[] {
     result: entry.result === 'error' ? 'error' : 'ok',
     message: normalizeMessage(entry.message),
     durationMs: typeof entry.durationMs === 'number' ? entry.durationMs : undefined,
+    agentName: typeof entry.agentName === 'string' ? entry.agentName : undefined,
   }));
 }
 

package/app/lib/core/fs-ops.ts

@@ -38,11 +38,16 @@ export function writeFile(mindRoot: string, filePath: string, content: string):
  */
 export function createFile(mindRoot: string, filePath: string, initialContent = ''): void {
   const resolved = resolveSafe(mindRoot, filePath);
-  if (fs.existsSync(resolved)) {
-    throw new MindOSError(ErrorCodes.FILE_ALREADY_EXISTS, `File already exists: ${filePath}`, { filePath });
-  }
   fs.mkdirSync(path.dirname(resolved), { recursive: true });
-  fs.writeFileSync(resolved, initialContent, 'utf-8');
+  try {
+    // 'wx' flag: create exclusively — fails atomically if file already exists (no TOCTOU race)
+    fs.writeFileSync(resolved, initialContent, { encoding: 'utf-8', flag: 'wx' });
+  } catch (err: unknown) {
+    if (err instanceof Error && 'code' in err && (err as NodeJS.ErrnoException).code === 'EEXIST') {
+      throw new MindOSError(ErrorCodes.FILE_ALREADY_EXISTS, `File already exists: ${filePath}`, { filePath });
+    }
+    throw err;
+  }
 }
 
 /**

package/app/lib/core/inbox.ts

@@ -0,0 +1,181 @@
+import fs from 'fs';
+import path from 'path';
+import { resolveSafe } from './security';
+import { sanitizeFileName, convertToMarkdown, ALLOWED_IMPORT_EXTENSIONS } from './file-convert';
+
+export const INBOX_DIR = 'Inbox';
+const AGING_THRESHOLD_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+
+const INBOX_INSTRUCTION = `# Inbox Instruction Set
+
+## Goal
+This is the **Inbox** — a staging area for unprocessed files.
+Files here are waiting to be organized into the right location in the knowledge base.
+
+## Rules
+- New files dropped here should be preserved as-is until the user triggers organization.
+- When organizing, analyze file content and move each file to the most appropriate Space/directory.
+- If a file belongs to an existing topic, merge or append rather than creating duplicates.
+- After organizing, the Inbox should be empty or contain only files that don't fit anywhere.
+- Never delete files from Inbox — always move them to a better location.
+
+## Boundary
+- Root INSTRUCTION.md rules take precedence.
+- This INSTRUCTION.md only applies to the Inbox directory.
+`;
+
+const INBOX_README = `# Inbox
+
+Quick capture staging area. Drop files here and organize them later with AI.
+
+## Usage
+- Drag files onto the MindOS window to save them here instantly.
+- Click "AI Organize" on the homepage to sort everything into the right place.
+`;
+
+export interface InboxFileInfo {
+  name: string;
+  path: string;
+  size: number;
+  modifiedAt: string;
+  isAging: boolean;
+}
+
+export interface InboxSaveResult {
+  saved: Array<{ original: string; path: string }>;
+  skipped: Array<{ name: string; reason: string }>;
+}
+
+export interface InboxSaveInput {
+  name: string;
+  content: string;
+  encoding?: 'text' | 'base64';
+}
+
+/**
+ * Creates the Inbox space if it doesn't exist.
+ * Idempotent — safe to call multiple times concurrently.
+ */
+export function ensureInboxSpace(mindRoot: string): string {
+  const inboxDir = path.resolve(mindRoot, INBOX_DIR);
+  fs.mkdirSync(inboxDir, { recursive: true });
+
+  const instructionPath = path.join(inboxDir, 'INSTRUCTION.md');
+  if (!fs.existsSync(instructionPath)) {
+    fs.writeFileSync(instructionPath, INBOX_INSTRUCTION, 'utf-8');
+  }
+
+  const readmePath = path.join(inboxDir, 'README.md');
+  if (!fs.existsSync(readmePath)) {
+    fs.writeFileSync(readmePath, INBOX_README, 'utf-8');
+  }
+
+  return inboxDir;
+}
+
+/**
+ * Lists non-system files in the Inbox directory with metadata.
+ * Returns files sorted by modification time (newest first).
+ */
+export function listInboxFiles(mindRoot: string): InboxFileInfo[] {
+  const inboxDir = path.resolve(mindRoot, INBOX_DIR);
+  if (!fs.existsSync(inboxDir)) return [];
+
+  const entries = fs.readdirSync(inboxDir, { withFileTypes: true });
+  const now = Date.now();
+  const results: InboxFileInfo[] = [];
+
+  for (const entry of entries) {
+    if (!entry.isFile()) continue;
+    const lowerName = entry.name.toLowerCase();
+    if (lowerName === 'instruction.md' || lowerName === 'readme.md') continue;
+    if (entry.name.startsWith('.')) continue;
+
+    const filePath = path.join(inboxDir, entry.name);
+    try {
+      const stat = fs.statSync(filePath);
+      results.push({
+        name: entry.name,
+        path: `${INBOX_DIR}/${entry.name}`,
+        size: stat.size,
+        modifiedAt: stat.mtime.toISOString(),
+        isAging: now - stat.mtime.getTime() > AGING_THRESHOLD_MS,
+      });
+    } catch {
+      // file may have been deleted between readdir and stat
+    }
+  }
+
+  results.sort((a, b) => new Date(b.modifiedAt).getTime() - new Date(a.modifiedAt).getTime());
+  return results;
+}
+
+function decodeContent(encoding: string | undefined, content: string): string {
+  if (encoding === 'base64') {
+    return Buffer.from(content, 'base64').toString('utf-8');
+  }
+  return content;
+}
+
+function resolveUniqueName(inboxDir: string, targetName: string): string {
+  let resolved = path.join(inboxDir, targetName);
+  if (!fs.existsSync(resolved)) return targetName;
+
+  const ext = path.extname(targetName);
+  const stem = ext ? targetName.slice(0, -ext.length) : targetName;
+  let n = 1;
+  while (fs.existsSync(resolved)) {
+    const candidate = `${stem}-${n}${ext}`;
+    resolved = path.join(inboxDir, candidate);
+    if (!fs.existsSync(resolved)) return candidate;
+    n++;
+  }
+  return targetName;
+}
+
+/**
+ * Saves files to the Inbox directory.
+ * Handles format conversion (txt→md, html→md, etc.) and deduplication.
+ */
+export function saveToInbox(mindRoot: string, files: InboxSaveInput[]): InboxSaveResult {
+  const inboxDir = ensureInboxSpace(mindRoot);
+  const saved: InboxSaveResult['saved'] = [];
+  const skipped: InboxSaveResult['skipped'] = [];
+
+  for (const file of files) {
+    if (!file.name || typeof file.name !== 'string') {
+      skipped.push({ name: file.name || '(empty)', reason: 'Invalid file name' });
+      continue;
+    }
+
+    if (file.content == null || typeof file.content !== 'string') {
+      skipped.push({ name: file.name, reason: 'Missing or invalid content' });
+      continue;
+    }
+
+    const ext = path.extname(file.name).toLowerCase();
+    if (!ALLOWED_IMPORT_EXTENSIONS.has(ext)) {
+      skipped.push({ name: file.name, reason: `Unsupported format: ${ext}` });
+      continue;
+    }
+
+    try {
+      const sanitized = sanitizeFileName(file.name);
+      const raw = decodeContent(file.encoding, file.content);
+      const { content, targetName } = convertToMarkdown(sanitized, raw);
+      const uniqueName = resolveUniqueName(inboxDir, targetName);
+
+      // Security: resolve within mindRoot
+      const targetPath = `${INBOX_DIR}/${uniqueName}`;
+      resolveSafe(mindRoot, targetPath);
+
+      const absPath = path.join(inboxDir, uniqueName);
+      fs.writeFileSync(absPath, content, 'utf-8');
+      saved.push({ original: file.name, path: targetPath });
+    } catch (err) {
+      skipped.push({ name: file.name, reason: (err as Error).message });
+    }
+  }
+
+  return { saved, skipped };
+}

package/app/lib/core/index.ts

@@ -68,6 +68,10 @@ export { createSpaceFilesystem, generateReadmeTemplate } from './create-space';
 export { summarizeTopLevelSpaces } from './list-spaces';
 export type { MindSpaceSummary } from './list-spaces';
 
+// Inbox
+export { INBOX_DIR, ensureInboxSpace, listInboxFiles, saveToInbox } from './inbox';
+export type { InboxFileInfo, InboxSaveResult, InboxSaveInput } from './inbox';
+
 // Content changes
 export {
   appendContentChange,

package/app/lib/core/tree.ts

@@ -5,6 +5,7 @@ import type { FileNode } from './types';
 
 const DEFAULT_IGNORED_DIRS = new Set(['.git', 'node_modules', 'app', '.next', '.DS_Store', 'mcp']);
 const DEFAULT_ALLOWED_EXTENSIONS = new Set(['.md', '.csv']);
+const SYSTEM_FILES = new Set(['INSTRUCTION.md', 'README.md', 'CONFIG.json', 'CHANGELOG.md']);
 
 export interface TreeOptions {
   ignoredDirs?: Set<string>;
@@ -86,6 +87,7 @@ export function collectAllFiles(
       if (ignoredDirs.has(entry.name)) continue;
       files.push(...collectAllFiles(mindRoot, fullPath, opts));
     } else if (entry.isFile()) {
+      if (dir === root && SYSTEM_FILES.has(entry.name)) continue;
       const ext = path.extname(entry.name).toLowerCase();
       if (allowedExtensions.has(ext)) {
         files.push(path.relative(root, fullPath));
@@ -147,6 +149,7 @@ export async function collectAllFilesAsync(
       if (ignoredDirs.has(entry.name)) continue;
       subdirPromises.push(collectAllFilesAsync(mindRoot, fullPath, opts));
     } else if (entry.isFile()) {
+      if (dir === root && SYSTEM_FILES.has(entry.name)) continue;
       const ext = path.extname(entry.name).toLowerCase();
       if (allowedExtensions.has(ext)) {
         files.push(path.relative(root, fullPath));

package/app/lib/core/types.ts

@@ -1,6 +1,8 @@
 export interface SpacePreview {
   instructionLines: string[];
   readmeLines: string[];
+  /** True when both files still contain only the default scaffold template. */
+  isTemplate?: boolean;
 }
 
 export interface FileNode {

package/app/lib/fs.ts

@@ -49,6 +49,7 @@ export function getMindRoot(): string {
 
 const IGNORED_DIRS = new Set(['.git', 'node_modules', 'app', '.next', '.DS_Store']);
 const ALLOWED_EXTENSIONS = new Set(['.md', '.csv', '.json']);
+const SYSTEM_FILES = new Set(['INSTRUCTION.md', 'README.md', 'CONFIG.json', 'CHANGELOG.md']);
 
 // ─── In-memory cache ──────────────────────────────────────────────────────────
 
@@ -231,10 +232,27 @@ function extractBodyLines(filePath: string, maxLines: number): string[] {
   } catch { return []; }
 }
 
+const TEMPLATE_MARKERS = [
+  'Define local execution rules for this directory.',
+  '(your files here)',
+  '(Describe the purpose and usage of this space.)',
+  '(Add usage guidelines for this space.)',
+];
+
+function isTemplateContent(filePath: string): boolean {
+  try {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return TEMPLATE_MARKERS.some(m => content.includes(m));
+  } catch { return false; }
+}
+
 function buildSpacePreview(dirAbsPath: string) {
+  const instructionPath = path.join(dirAbsPath, 'INSTRUCTION.md');
+  const readmePath = path.join(dirAbsPath, 'README.md');
   return {
-    instructionLines: extractBodyLines(path.join(dirAbsPath, 'INSTRUCTION.md'), SPACE_PREVIEW_MAX_LINES),
-    readmeLines: extractBodyLines(path.join(dirAbsPath, 'README.md'), SPACE_PREVIEW_MAX_LINES),
+    instructionLines: extractBodyLines(instructionPath, SPACE_PREVIEW_MAX_LINES),
+    readmeLines: extractBodyLines(readmePath, SPACE_PREVIEW_MAX_LINES),
+    isTemplate: isTemplateContent(instructionPath) && isTemplateContent(readmePath),
   };
 }
 

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

@@ -5,7 +5,8 @@ export const aiChatEn = {
     title: 'MindOS Agent',
     fabLabel: 'Ask AI',
     placeholder: 'Ask a question... @ files, / skills',
-    emptyPrompt: 'Ask anything about your knowledge base',
+    emptyPrompt: 'How can I help?',
+    emptyHint: 'Type @ to reference files · / to use skills',
     send: 'send',
     newlineHint: 'new line',
     panelComposerResize: 'Drag up to enlarge the input area',
@@ -13,6 +14,8 @@ export const aiChatEn = {
     panelComposerResetHint: 'Double-click to reset height',
     panelComposerKeyboard: 'Arrow keys adjust height; Home/End min/max',
     attachFile: 'Context',
+    attachFileLabel: 'Document',
+    attachImageLabel: 'Image',
     uploadedFiles: 'Uploaded',
     skillsHint: 'skills',
     attachCurrent: 'attach current file',
@@ -30,15 +33,23 @@ export const aiChatEn = {
     retry: 'Retry',
     suggestions: [
       'Summarize this document',
-      'List all action items and TODOs',
-      'What are the key points?',
-      'Find related notes on this topic',
+      'Organize my recent notes',
+      'Find related notes',
+      'Draft a new note',
     ],
+    modeChat: 'Chat',
+    modeAgent: 'Agent',
+    modeChatHint: 'Can search / read KB · saves tokens',
+    modeAgentHint: 'Full tool access · can modify KB',
     sessionHistory: 'Session History',
     clearAll: 'Clear all',
     confirmClear: 'Confirm clear?',
     noSessions: 'No saved sessions.',
+    renameSession: 'Rename',
     draftingHint: 'AI is still running — you can draft the next step now.',
+    providerCapsule: 'Switch model provider',
+    providerDefault: 'Default',
+    providerNoKey: 'No configured providers',
   },
   changes: {
     unreadBanner: (n: number) => `${n} content change${n === 1 ? '' : 's'} unread`,
@@ -97,8 +108,8 @@ export const aiChatEn = {
     sessionHistory: 'Session history',
     newSession: 'New session',
     attachFile: 'Attach local file',
-    maximizePanel: 'Maximize panel',
-    restorePanel: 'Restore panel',
+    maximizePanel: 'Focus mode',
+    restorePanel: 'Exit focus',
     dockToSide: 'Dock to side panel',
     openAsPopup: 'Open as popup',
     closePanel: 'Close',
@@ -112,7 +123,8 @@ export const aiChatZh = {
     title: 'MindOS Agent',
     fabLabel: 'AI 助手',
     placeholder: '输入问题… @ 附加文件，/ 技能',
-    emptyPrompt: '可以问任何关于知识库的问题',
+    emptyPrompt: '有什么可以帮你？',
+    emptyHint: '输入 @ 引用文件 · / 使用技能',
     send: '发送',
     newlineHint: '换行',
     panelComposerResize: '向上拖拽以拉高输入区',
@@ -120,6 +132,8 @@ export const aiChatZh = {
     panelComposerResetHint: '双击恢复默认高度',
     panelComposerKeyboard: '方向键调节高度；Home/End 最小或最大',
     attachFile: '上下文',
+    attachFileLabel: '文档',
+    attachImageLabel: '图片',
     uploadedFiles: '已上传',
     skillsHint: '技能',
     attachCurrent: '附加当前文件',
@@ -137,15 +151,23 @@ export const aiChatZh = {
     retry: '重试',
     suggestions: [
       '总结这篇文档',
-      '列出所有待办事项',
-      '这篇文档的核心要点是什么？',
-      '查找与这个主题相关的笔记',
+      '整理最近的笔记',
+      '查找相关笔记',
+      '起草一篇新笔记',
     ],
+    modeChat: '对话',
+    modeAgent: 'Agent',
+    modeChatHint: '可搜索/阅读知识库 · 省 token',
+    modeAgentHint: '完整工具权限 · 可修改知识库',
     sessionHistory: '对话历史',
     clearAll: '清除全部',
     confirmClear: '确认清除？',
     noSessions: '暂无历史对话。',
+    renameSession: '重命名',
     draftingHint: 'AI 仍在执行，你可以先输入下一步。',
+    providerCapsule: '切换模型服务商',
+    providerDefault: '默认',
+    providerNoKey: '暂无已配置的服务商',
   },
   changes: {
     unreadBanner: (n: number) => `${n} 条内容变更未读`,
@@ -162,7 +184,7 @@ export const aiChatZh = {
       filePath: '文件路径',
       filePathPlaceholder: '例如：Projects/plan.md',
       source: 'Agents（来源）',
-      operation: 'Tools（操作）',
+      operation: '工具（操作）',
       operationAll: '全部操作',
       keyword: '关键词',
       keywordPlaceholder: '摘要 / 操作 / 路径',
@@ -204,8 +226,8 @@ export const aiChatZh = {
     sessionHistory: '会话历史',
     newSession: '新会话',
     attachFile: '附加本地文件',
-    maximizePanel: '最大化面板',
-    restorePanel: '还原面板',
+    maximizePanel: '专注模式',
+    restorePanel: '退出专注',
     dockToSide: '停靠到侧边栏',
     openAsPopup: '弹窗模式',
     closePanel: '关闭',

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

@@ -24,7 +24,7 @@ export const featuresEn = {
       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.',
+      step3Desc: 'Go to Settings → Connections 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',
@@ -63,7 +63,7 @@ export const featuresEn = {
       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: 'How do I connect an AI agent?', a: 'Go to Settings → Connections. 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.' },
@@ -96,11 +96,11 @@ export const featuresZh = {
     quickStart: {
       title: '快速开始',
       step1Title: '浏览你的知识库',
-      step1Desc: '点击左侧边栏的"空间"图标来浏览你的文件。每个顶级文件夹是一个"空间"——比如 Profile、Notes 或 Projects。',
+      step1Desc: '点击左侧边栏的"空间"图标来浏览你的文件。每个顶级文件夹是一个"空间"——比如个人档案、笔记或项目。',
       step2Title: '和 AI 对话',
       step2Desc: '按 ⌘/（或 Ctrl/）打开 AI 面板。询问任何关于知识库的问题，或使用 @ 附加特定文件作为上下文。',
       step3Title: '连接你的 AI Agent',
-      step3Desc: '前往 设置 → MCP 连接外部 Agent，如 Claude Code、Cursor 或 Windsurf。连接后，它们可以直接读写你的知识库。',
+      step3Desc: '前往 设置 → 连接 以连接外部 Agent，如 Claude Code、Cursor 或 Windsurf。连接后，它们可以直接读写你的知识库。',
     },
     concepts: {
       title: '核心概念',
@@ -139,7 +139,7 @@ export const featuresZh = {
       title: '常见问题',
       items: [
         { q: '如何切换语言？', a: '前往 设置 → 外观 → 语言。支持中文和英文切换。' },
-        { q: '如何连接 AI Agent？', a: '前往 设置 → MCP & Skills。MindOS 会自动检测已安装的 Agent（Claude Code、Cursor 等），一键即可连接。' },
+        { q: '如何连接 AI Agent？', a: '前往 设置 → 连接。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）。' },