@geminilight/mindos 0.3.0 → 0.5.0

package/app/components/settings/SyncTab.tsx

@@ -1,7 +1,7 @@
 'use client';
 
 import { useState, useEffect, useCallback } from 'react';
-import { RefreshCw, AlertCircle, CheckCircle2, Loader2, GitBranch, Copy, Check, ExternalLink } from 'lucide-react';
+import { RefreshCw, AlertCircle, CheckCircle2, Loader2, GitBranch, ExternalLink, Eye, EyeOff } from 'lucide-react';
 import { SectionLabel } from './Primitives';
 import { apiFetch } from '@/lib/api';
 
@@ -32,35 +32,53 @@ export function timeAgo(iso: string | null | undefined): string {
   return `${Math.floor(diff / 86400000)}d ago`;
 }
 
-/* ── Copy-to-clipboard button ──────────────────────────────────── */
+/* ── Empty state — GUI sync init form ─────────────────────────── */
 
-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>
-  );
+function isValidGitUrl(url: string): 'https' | 'ssh' | false {
+  if (/^https:\/\/.+/.test(url)) return 'https';
+  if (/^git@[\w.-]+:.+/.test(url)) return 'ssh';
+  return false;
 }
 
-/* ── Empty state (Task D) ──────────────────────────────────────── */
-
-function SyncEmptyState({ t }: { t: any }) {
+function SyncEmptyState({ t, onInitComplete }: { t: any; onInitComplete: () => void }) {
   const syncT = t.settings?.sync;
-  const cmd = 'mindos sync init';
+
+  const [remoteUrl, setRemoteUrl] = useState('');
+  const [token, setToken] = useState('');
+  const [branch, setBranch] = useState('main');
+  const [showToken, setShowToken] = useState(false);
+  const [connecting, setConnecting] = useState(false);
+  const [error, setError] = useState('');
+
+  const urlType = remoteUrl.trim() ? isValidGitUrl(remoteUrl.trim()) : null;
+  const isValid = urlType === 'https' || urlType === 'ssh';
+  const showTokenField = urlType === 'https';
+
+  const handleConnect = async () => {
+    setConnecting(true);
+    setError('');
+    try {
+      await apiFetch('/api/sync', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          action: 'init',
+          remote: remoteUrl.trim(),
+          token: token.trim() || undefined,
+          branch: branch.trim() || 'main',
+        }),
+      });
+      onInitComplete();
+    } catch (err: unknown) {
+      const msg = err instanceof Error ? err.message : 'Connection failed';
+      setError(msg);
+    } finally {
+      setConnecting(false);
+    }
+  };
 
   return (
-    <div className="space-y-6">
+    <div className="space-y-5">
       {/* 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">
@@ -76,33 +94,104 @@ function SyncEmptyState({ t }: { t: any }) {
         </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>
+      {/* Git Remote URL */}
+      <div className="space-y-1.5">
+        <label className="text-xs font-medium text-foreground block">
+          {syncT?.remoteUrl ?? 'Git Remote URL'}
+        </label>
+        <input
+          type="text"
+          value={remoteUrl}
+          onChange={e => { setRemoteUrl(e.target.value); setError(''); }}
+          placeholder="https://github.com/user/my-mind.git"
+          className="w-full px-3 py-2 text-sm rounded-lg border bg-transparent font-mono text-xs transition-colors focus:outline-none focus:ring-1"
+          style={{
+            borderColor: remoteUrl.trim() && !isValid ? 'var(--destructive, red)' : 'var(--border)',
+            color: 'var(--foreground)',
+          }}
+        />
+        {remoteUrl.trim() && !isValid && (
+          <p className="text-[11px]" style={{ color: 'var(--destructive, red)' }}>
+            {syncT?.invalidUrl ?? 'Invalid Git URL — use HTTPS (https://...) or SSH (git@...)'}
+          </p>
+        )}
+        {urlType === 'ssh' && (
+          <p className="text-[11px] text-muted-foreground flex items-center gap-1">
+            <AlertCircle size={11} className="shrink-0" />
+            {syncT?.sshHint ?? 'SSH URLs require SSH key configured on this machine. HTTPS with token recommended.'}
+          </p>
+        )}
       </div>
 
+      {/* Access Token (HTTPS only) */}
+      {showTokenField && (
+        <div className="space-y-1.5">
+          <label className="text-xs font-medium text-foreground block">
+            {syncT?.accessToken ?? 'Access Token'}{' '}
+            <span className="text-muted-foreground font-normal">{syncT?.optional ?? '(optional, for private repos)'}</span>
+          </label>
+          <div className="relative">
+            <input
+              type={showToken ? 'text' : 'password'}
+              value={token}
+              onChange={e => setToken(e.target.value)}
+              placeholder="ghp_xxxxxxxxxxxx"
+              className="w-full px-3 py-2 pr-9 text-sm rounded-lg border bg-transparent font-mono text-xs transition-colors focus:outline-none focus:ring-1"
+              style={{ borderColor: 'var(--border)', color: 'var(--foreground)' }}
+            />
+            <button
+              type="button"
+              onClick={() => setShowToken(!showToken)}
+              className="absolute right-2 top-1/2 -translate-y-1/2 p-0.5 rounded hover:bg-muted text-muted-foreground transition-colors"
+            >
+              {showToken ? <EyeOff size={14} /> : <Eye size={14} />}
+            </button>
+          </div>
+          <p className="text-[11px] text-muted-foreground">
+            {syncT?.tokenHint ?? 'GitHub: Settings → Developer settings → Personal access tokens → repo scope'}
+          </p>
+        </div>
+      )}
+
+      {/* Branch */}
+      <div className="space-y-1.5">
+        <label className="text-xs font-medium text-foreground block">
+          {syncT?.branchLabel ?? 'Branch'}
+        </label>
+        <input
+          type="text"
+          value={branch}
+          onChange={e => setBranch(e.target.value)}
+          placeholder="main"
+          className="w-full max-w-[200px] px-3 py-2 text-sm rounded-lg border bg-transparent font-mono text-xs transition-colors focus:outline-none focus:ring-1"
+          style={{ borderColor: 'var(--border)', color: 'var(--foreground)' }}
+        />
+      </div>
+
+      {/* Connect button */}
+      <button
+        type="button"
+        onClick={handleConnect}
+        disabled={!isValid || connecting}
+        className="flex items-center gap-2 px-4 py-2 text-sm font-medium rounded-lg transition-colors disabled:opacity-40 disabled:cursor-not-allowed"
+        style={{ background: 'var(--amber)', color: '#131210' }}
+      >
+        {connecting && <Loader2 size={14} className="animate-spin" />}
+        {connecting
+          ? (syncT?.connecting ?? 'Connecting...')
+          : (syncT?.connectButton ?? 'Connect & Start Sync')}
+      </button>
+
+      {/* Error */}
+      {error && (
+        <div className="flex items-start gap-2 text-xs p-3 rounded-lg" role="alert" aria-live="polite" style={{ background: 'rgba(239,68,68,0.1)', color: 'var(--destructive, red)' }}>
+          <AlertCircle size={13} className="shrink-0 mt-0.5" />
+          <span>{error}</span>
+        </div>
+      )}
+
       {/* Features */}
-      <div className="grid grid-cols-2 gap-2 text-[11px] text-muted-foreground">
+      <div className="grid grid-cols-2 gap-2 text-[11px] text-muted-foreground pt-2">
         {[
           syncT?.featureAutoCommit ?? 'Auto-commit on save',
           syncT?.featureAutoPull ?? 'Auto-pull from remote',
@@ -190,7 +279,7 @@ export function SyncTab({ t }: SyncTabProps) {
   }
 
   if (!status || !status.enabled) {
-    return <SyncEmptyState t={t} />;
+    return <SyncEmptyState t={t} onInitComplete={fetchStatus} />;
   }
 
   const conflicts = status.conflicts || [];
@@ -256,7 +345,7 @@ export function SyncTab({ t }: SyncTabProps) {
 
       {/* Message */}
       {message && (
-        <div className="flex items-center gap-1.5 text-xs">
+        <div className="flex items-center gap-1.5 text-xs" role="status" aria-live="polite">
           {message.type === 'success' ? (
             <><CheckCircle2 size={13} className="text-green-500" /><span className="text-green-500">{message.text}</span></>
           ) : (

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' | 'sync';
+export type Tab = 'ai' | 'appearance' | 'knowledge' | 'mcp' | 'plugins' | 'shortcuts' | 'sync';
 
 export const CONTENT_WIDTHS = [
   { value: '680px', label: 'Narrow (680px)' },

package/app/lib/i18n.ts

@@ -16,6 +16,7 @@ export const messages = {
       plugins: 'Plugins',
       showMore: 'Show more',
       showLess: 'Show less',
+      createToActivate: 'Create {file} to activate',
       shortcuts: {
         searchFiles: 'Search files',
         askAI: 'Ask AI',
@@ -96,10 +97,16 @@ export const messages = {
       listView: 'List view',
       emptyFolder: 'This folder is empty.',
       fileCount: (n: number) => `${n} files`,
+      newFile: 'New file',
+    },
+    findInPage: {
+      placeholder: 'Find in document…',
+      matchCount: (current: number, total: number) => `${current} of ${total}`,
+      noResults: 'No results',
     },
     settings: {
       title: 'Settings',
-      tabs: { ai: 'AI', appearance: 'Appearance', knowledge: 'Knowledge Base', sync: 'Sync', plugins: 'Plugins', shortcuts: 'Shortcuts' },
+      tabs: { ai: 'AI', appearance: 'Appearance', knowledge: 'Knowledge Base', sync: 'Sync', mcp: 'MCP', plugins: 'Plugins', shortcuts: 'Shortcuts' },
       ai: {
         provider: 'Provider',
         model: 'Model',
@@ -144,14 +151,19 @@ export const messages = {
       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',
+        remoteUrl: 'Git Remote URL',
+        invalidUrl: 'Invalid Git URL — use HTTPS (https://...) or SSH (git@...)',
+        sshHint: 'SSH URLs require SSH key configured on this machine. HTTPS with token recommended.',
+        accessToken: 'Access Token',
+        optional: '(optional, for private repos)',
+        tokenHint: 'GitHub: Settings → Developer settings → Personal access tokens → repo scope',
+        branchLabel: 'Branch',
+        connectButton: 'Connect & Start Sync',
+        connecting: 'Connecting...',
       },
       plugins: {
         title: 'Installed Renderers',
@@ -162,6 +174,54 @@ export const messages = {
         noPlugins: 'No renderers installed.',
         comingSoon: 'Plugin marketplace coming soon.',
       },
+      mcp: {
+        serverTitle: 'MindOS MCP Server',
+        status: 'Status',
+        running: 'Running',
+        stopped: 'Stopped',
+        transport: 'Transport',
+        endpoint: 'Endpoint',
+        tools: 'Tools',
+        toolsRegistered: (n: number) => `${n} registered`,
+        auth: 'Auth',
+        authSet: 'Token set',
+        authNotSet: 'No token',
+        copyEndpoint: 'Copy Endpoint',
+        copyConfig: 'Copy Config',
+        copied: 'Copied!',
+        agentsTitle: 'Agent Configuration',
+        agent: 'Agent',
+        scope: 'Scope',
+        project: 'Project',
+        global: 'Global',
+        installed: 'Installed',
+        notInstalled: 'Not installed',
+        transportStdio: 'stdio (recommended)',
+        transportHttp: 'http',
+        httpUrl: 'MCP URL',
+        httpToken: 'Auth Token',
+        installSelected: 'Install Selected',
+        installing: 'Installing...',
+        installSuccess: (n: number) => `${n} agent(s) configured`,
+        installFailed: 'Install failed',
+        portLabel: 'MCP Port',
+        portHint: 'Changes require server restart',
+        skillsTitle: 'Skills',
+        skillAutoLoaded: 'Auto-loaded on every request',
+        skillSource: 'Source',
+        skillBuiltin: 'Built-in',
+        skillUser: 'Custom',
+        addSkill: '+ Add Skill',
+        deleteSkill: 'Delete',
+        editSkill: 'Edit',
+        saveSkill: 'Save',
+        cancelSkill: 'Cancel',
+        skillName: 'Name',
+        skillDesc: 'Description',
+        skillContent: 'Content',
+        skillNameConflict: 'A skill with this name already exists',
+        skillDeleteConfirm: (name: string) => `Delete skill "${name}"? This cannot be undone.`,
+      },
       save: 'Save',
       saved: 'Saved',
       saveFailed: 'Save failed',
@@ -186,8 +246,32 @@ export const messages = {
       { keys: ['Esc'], description: 'Cancel edit / close modal' },
       { keys: ['@'], description: 'Attach file in Ask AI' },
     ],
+    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})`,
+      runUpdate: 'Run',
+      orSee: 'or',
+      releaseNotes: 'view release notes',
+    },
     setup: {
-      stepTitles: ['Knowledge Base', 'AI Provider', 'Ports', 'Security', 'Review'],
+      stepTitles: ['Knowledge Base', 'AI Provider', 'Ports', 'Security', 'Agent Tools', 'Review'],
       // Step 1
       kbPath: 'Knowledge base path',
       kbPathHint: 'Absolute path to your notes directory.',
@@ -207,6 +291,11 @@ export const messages = {
       mcpPort: 'MCP server port',
       portHint: 'Valid range: 1024–65535',
       portRestartWarning: 'Port changes take effect after server restart.',
+      portInUse: (p: number) => `Port ${p} is already in use.`,
+      portSuggest: (p: number) => `Use ${p}`,
+      portChecking: 'Checking…',
+      portConflict: 'Web UI and MCP ports must be different.',
+      portVerifyHint: 'Click outside each field to verify, or wait for auto-check.',
       // Step 4
       authToken: 'Auth Token',
       authTokenHint: 'Bearer token for MCP / API clients. Auto-generated.',
@@ -217,16 +306,30 @@ export const messages = {
       copiedToken: 'Copied!',
       webPassword: 'Web UI Password',
       webPasswordHint: 'Optional. Protect browser access with a password.',
-      // Step 5
-      reviewTitle: 'Review Configuration',
+      // Step 5 — Agent Tools
+      agentToolsTitle: 'Agent Tools',
+      agentToolsHint: 'Select AI agents to configure with MindOS MCP. Agents marked "not installed" can be configured now — they will work once you install the app.',
+      agentTransport: 'Transport',
+      agentScope: 'Scope',
+      agentToolsLoading: 'Loading agents…',
+      agentToolsEmpty: 'No supported agents detected.',
+      agentNoneSelected: 'No agents selected — you can configure later in Settings → MCP.',
+      agentNotInstalled: 'not installed',
+      agentStatusOk: 'configured',
+      agentStatusError: 'failed',
+      agentInstalling: 'Configuring…',
+      // Step 2 — AI skip card
+      aiSkipTitle: 'Skip for now',
+      aiSkipDesc: 'You can add an API key later in Settings → AI.',
+      // Step 6 — Review
       reviewHint: 'Verify your settings before completing setup.',
-      keyMasked: (key: string) => key.slice(0, 6) + '•••' + key.slice(-3),
+      reviewInstallResults: 'Agent configuration results:',
+      portAvailable: 'Available',
       portChanged: 'Port changed — please restart the server for it to take effect.',
       // Buttons
       back: 'Back',
       next: 'Next',
       complete: 'Complete Setup',
-      skip: 'Skip',
       // Status
       completing: 'Saving...',
       completeDone: 'Setup complete!',
@@ -248,6 +351,7 @@ export const messages = {
       plugins: '插件',
       showMore: '查看更多',
       showLess: '收起',
+      createToActivate: '创建 {file} 以启用此插件',
       shortcuts: {
         searchFiles: '搜索文件',
         askAI: '问 AI',
@@ -328,10 +432,16 @@ export const messages = {
       listView: '列表视图',
       emptyFolder: '此目录为空。',
       fileCount: (n: number) => `${n} 个文件`,
+      newFile: '新建文件',
+    },
+    findInPage: {
+      placeholder: '在文档中查找…',
+      matchCount: (current: number, total: number) => `${current} / ${total}`,
+      noResults: '无结果',
     },
     settings: {
       title: '设置',
-      tabs: { ai: 'AI', appearance: '外观', knowledge: '知识库', sync: '同步', plugins: '插件', shortcuts: '快捷键' },
+      tabs: { ai: 'AI', appearance: '外观', knowledge: '知识库', sync: '同步', mcp: 'MCP', plugins: '插件', shortcuts: '快捷键' },
       ai: {
         provider: '服务商',
         model: '模型',
@@ -376,14 +486,19 @@ export const messages = {
       sync: {
         emptyTitle: '跨设备同步',
         emptyDesc: '通过 Git 自动同步知识库到所有设备。',
-        emptyStepsTitle: '配置步骤',
-        emptyStep1: '创建一个私有 Git 仓库（GitHub、GitLab 等），或使用现有仓库。',
-        emptyStep2: '在终端中运行以下命令：',
-        emptyStep3: '按照提示连接仓库，同步将自动开始。',
         featureAutoCommit: '保存时自动提交',
         featureAutoPull: '自动拉取远程更新',
         featureConflict: '冲突检测',
         featureMultiDevice: '多设备同步',
+        remoteUrl: 'Git 远程仓库 URL',
+        invalidUrl: '无效的 Git URL — 请使用 HTTPS (https://...) 或 SSH (git@...) 格式',
+        sshHint: 'SSH URL 需要在本机配置 SSH 密钥。推荐使用 HTTPS + Token。',
+        accessToken: '访问令牌',
+        optional: '（可选，私有仓库需要）',
+        tokenHint: 'GitHub: Settings → Developer settings → Personal access tokens → repo scope',
+        branchLabel: '分支',
+        connectButton: '连接并开始同步',
+        connecting: '连接中...',
       },
       plugins: {
         title: '已安装渲染器',
@@ -394,6 +509,54 @@ export const messages = {
         noPlugins: '暂无渲染器。',
         comingSoon: '插件市场即将上线。',
       },
+      mcp: {
+        serverTitle: 'MindOS MCP 服务',
+        status: '状态',
+        running: '运行中',
+        stopped: '已停止',
+        transport: '传输方式',
+        endpoint: '端点',
+        tools: '工具',
+        toolsRegistered: (n: number) => `已注册 ${n} 个`,
+        auth: '认证',
+        authSet: '已设置 Token',
+        authNotSet: '未设置',
+        copyEndpoint: '复制端点',
+        copyConfig: '复制配置',
+        copied: '已复制！',
+        agentsTitle: 'Agent 配置',
+        agent: 'Agent',
+        scope: '范围',
+        project: '项目',
+        global: '全局',
+        installed: '已安装',
+        notInstalled: '未安装',
+        transportStdio: 'stdio（推荐）',
+        transportHttp: 'http',
+        httpUrl: 'MCP URL',
+        httpToken: '认证 Token',
+        installSelected: '安装选中',
+        installing: '安装中...',
+        installSuccess: (n: number) => `已配置 ${n} 个 agent`,
+        installFailed: '安装失败',
+        portLabel: 'MCP 端口',
+        portHint: '修改后需重启服务',
+        skillsTitle: 'Skills',
+        skillAutoLoaded: '每次请求自动加载',
+        skillSource: '来源',
+        skillBuiltin: '内置',
+        skillUser: '自定义',
+        addSkill: '+ 添加 Skill',
+        deleteSkill: '删除',
+        editSkill: '编辑',
+        saveSkill: '保存',
+        cancelSkill: '取消',
+        skillName: '名称',
+        skillDesc: '描述',
+        skillContent: '内容',
+        skillNameConflict: '同名 skill 已存在',
+        skillDeleteConfirm: (name: string) => `确定删除「${name}」？此操作不可撤销。`,
+      },
       save: '保存',
       saved: '已保存',
       saveFailed: '保存失败',
@@ -418,8 +581,32 @@ export const messages = {
       { keys: ['Esc'], description: '取消编辑 / 关闭弹窗' },
       { keys: ['@'], description: '在 AI 对话中添加附件' },
     ],
+    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}）`,
+      runUpdate: '终端运行',
+      orSee: '或',
+      releaseNotes: '查看更新说明',
+    },
     setup: {
-      stepTitles: ['知识库', 'AI 服务商', '端口', '安全', '确认'],
+      stepTitles: ['知识库', 'AI 服务商', '端口', '安全', 'Agent 工具', '确认'],
       // Step 1
       kbPath: '知识库路径',
       kbPathHint: '笔记目录的绝对路径。',
@@ -439,6 +626,11 @@ export const messages = {
       mcpPort: 'MCP 服务端口',
       portHint: '有效范围：1024–65535',
       portRestartWarning: '端口修改需重启服务后生效。',
+      portInUse: (p: number) => `端口 ${p} 已被占用。`,
+      portSuggest: (p: number) => `使用 ${p}`,
+      portChecking: '检测中…',
+      portConflict: 'Web UI 端口和 MCP 端口不能相同。',
+      portVerifyHint: '点击输入框外部验证，或等待自动检测。',
       // Step 4
       authToken: 'Auth Token',
       authTokenHint: 'MCP / API 客户端使用的 Bearer Token，自动生成。',
@@ -449,10 +641,25 @@ export const messages = {
       copiedToken: '已复制！',
       webPassword: '网页访问密码',
       webPasswordHint: '可选。设置后浏览器访问需要登录。',
-      // Step 5
-      reviewTitle: '确认配置',
+      // Step 5 — Agent Tools
+      agentToolsTitle: 'Agent 工具',
+      agentToolsHint: '选择要与 MindOS MCP 配置的 AI Agent。标注「未安装」的 agent 可以先行配置，安装应用后即可生效。',
+      agentTransport: '传输方式',
+      agentScope: '范围',
+      agentToolsLoading: '正在加载 Agent…',
+      agentToolsEmpty: '未检测到受支持的 Agent。',
+      agentNoneSelected: '未选择 agent — 可稍后在 设置 → MCP 中配置。',
+      agentNotInstalled: '未安装',
+      agentStatusOk: '已配置',
+      agentStatusError: '失败',
+      agentInstalling: '配置中…',
+      // Step 2 — AI skip card
+      aiSkipTitle: '暂时跳过',
+      aiSkipDesc: '稍后可在 设置 → AI 中添加 API 密钥。',
+      // Step 6 — Review
       reviewHint: '完成设置前请确认以下信息。',
-      keyMasked: (key: string) => key.slice(0, 6) + '•••' + key.slice(-3),
+      reviewInstallResults: 'Agent 配置结果：',
+      portAvailable: '可用',
       portChanged: '端口已变更 — 请重启服务以使其生效。',
       // Buttons
       back: '上一步',