@geminilight/mindos 0.6.58 → 0.6.60

package/app/lib/custom-agents.ts

@@ -8,7 +8,7 @@
 
 import fs from 'fs';
 import path from 'path';
-import { expandHome, MCP_AGENTS } from './mcp-agents';
+import { expandHome, MCP_AGENTS, parseJsonc } from './mcp-agents';
 import type { AgentDef } from './mcp-agents';
 import { readSettings, writeSettings } from './settings';
 
@@ -39,6 +39,8 @@ export interface DetectResult {
   detectedSkillDir?: string;
   skillCount?: number;
   skillNames?: string[];
+  mcpServers?: string[];
+  mcpParseError?: string;
   suggestedName?: string;
 }
 
@@ -282,6 +284,112 @@ export function scanCustomAgentSkills(custom: CustomAgentDef): { skills: string[
   }
 }
 
+/* ─── Enhanced Skill & MCP Detection ─── */
+
+/**
+ * Parse JSON config to extract MCP server names from a config key.
+ */
+function parseJsonMcpServers(content: string, key: string): string[] {
+  try {
+    const config = parseJsonc(content);
+    const servers = config[key];
+    if (servers && typeof servers === 'object') {
+      return Object.keys(servers).sort();
+    }
+  } catch {
+    return [];
+  }
+  return [];
+}
+
+/**
+ * Parse TOML config to extract MCP server names from a section key.
+ */
+function parseTomlMcpServers(content: string, sectionKey: string): string[] {
+  const names = new Set<string>();
+  const lines = content.split('\n');
+  const sectionPrefix = `${sectionKey}.`;
+
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+      const section = trimmed.slice(1, -1).trim();
+      if (section.startsWith(sectionPrefix)) {
+        const name = section.slice(sectionPrefix.length).split('.')[0];
+        if (name) names.add(name);
+      }
+    }
+  }
+
+  return [...names].sort();
+}
+
+/**
+ * Detect config format from file extension.
+ */
+function detectConfigFormat(configPath: string): 'json' | 'toml' {
+  return configPath.toLowerCase().endsWith('.toml') ? 'toml' : 'json';
+}
+
+/**
+ * Comprehensive profile detection for a custom agent.
+ * Returns MCP servers, skills, and any parse errors.
+ */
+export function detectCustomAgentProfile(
+  baseDir: string,
+  configPath: string,
+  configKey: string,
+): {
+  mcpServers: string[];
+  skillNames: string[];
+  skillDir: string;
+  configFormat: 'json' | 'toml';
+  parseError?: string;
+} {
+  const expanded = expandHome(baseDir);
+  const configAbsPath = expandHome(configPath);
+
+  const result = {
+    mcpServers: [] as string[],
+    skillNames: [] as string[],
+    skillDir: '',
+    configFormat: detectConfigFormat(configPath) as 'json' | 'toml',
+    parseError: undefined as string | undefined,
+  };
+
+  // 1. Read MCP servers from config
+  if (fs.existsSync(configAbsPath)) {
+    try {
+      const content = fs.readFileSync(configAbsPath, 'utf-8');
+      result.mcpServers =
+        result.configFormat === 'json'
+          ? parseJsonMcpServers(content, configKey)
+          : parseTomlMcpServers(content, configKey);
+    } catch (err) {
+      result.parseError = `Failed to parse MCP config: ${err instanceof Error ? err.message : 'Unknown error'}`;
+    }
+  }
+
+  // 2. Scan Skill directory
+  const skillDirPath = path.join(expanded, 'skills');
+  if (fs.existsSync(skillDirPath)) {
+    result.skillDir = baseDir.endsWith('/') ? baseDir + 'skills/' : baseDir + '/skills/';
+    try {
+      const entries = fs.readdirSync(skillDirPath, { withFileTypes: true });
+      result.skillNames = entries
+        .filter(e => (e.isDirectory() || e.isSymbolicLink()) && !e.name.startsWith('.'))
+        .map(e => e.name)
+        .sort((a, b) => a.localeCompare(b));
+    } catch {
+      // Skill dir exists but not readable, continue
+    }
+  } else {
+    result.skillDir = baseDir.endsWith('/') ? baseDir + 'skills/' : baseDir + '/skills/';
+  }
+
+  return result;
+}
+
 /* ─── Validation ─── */
 
 export function validateCustomAgentInput(input: {

package/app/lib/file-ops.ts

@@ -0,0 +1,58 @@
+/**
+ * File operations utilities.
+ * Used for recursive directory copying and other file system tasks.
+ */
+
+import fs from 'fs';
+import path from 'path';
+
+/**
+ * Recursively copy a directory and all its contents.
+ *
+ * @param src Source directory path
+ * @param dst Destination directory path
+ * @throws Error if source doesn't exist or copy fails
+ */
+export async function copyDir(src: string, dst: string): Promise<void> {
+  // Create destination directory
+  await fs.promises.mkdir(dst, { recursive: true });
+
+  // Read source directory
+  const entries = await fs.promises.readdir(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const dstPath = path.join(dst, entry.name);
+
+    if (entry.isDirectory()) {
+      // Recursively copy subdirectory
+      await copyDir(srcPath, dstPath);
+    } else if (entry.isFile()) {
+      // Copy file
+      await fs.promises.copyFile(srcPath, dstPath);
+    } else if (entry.isSymbolicLink()) {
+      // Copy symbolic link target
+      const linkTarget = await fs.promises.readlink(srcPath);
+      await fs.promises.symlink(linkTarget, dstPath);
+    }
+  }
+}
+
+/**
+ * Check if a directory exists.
+ */
+export function dirExists(dir: string): boolean {
+  try {
+    const stat = fs.statSync(dir);
+    return stat.isDirectory();
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Create a directory recursively.
+ */
+export async function ensureDir(dir: string): Promise<void> {
+  await fs.promises.mkdir(dir, { recursive: true });
+}

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

@@ -6,7 +6,12 @@ export const aiChatEn = {
     fabLabel: 'Ask AI',
     placeholder: 'Ask a question... @ files, / skills',
     emptyPrompt: 'How can I help?',
-    emptyHint: 'Type @ to reference files · / to use skills',
+    emptyHint: 'Type @ to reference files · / to use skills · drag images',
+    executingTool: 'Executing tool…',
+    toolRunning: 'Running...',
+    copyMessage: 'Copy',
+    toolInput: 'Input',
+    toolOutput: 'Output',
     send: 'send',
     newlineHint: 'new line',
     panelComposerResize: 'Drag up to enlarge the input area',
@@ -36,10 +41,49 @@ export const aiChatEn = {
     proxyCompatAlsoFailed: (err: string) => `Compatibility mode also failed: ${err}. Please check your Base URL, API key, and model name.`,
     retry: 'Retry',
     suggestions: [
-      'Summarize this document',
-      'Organize my recent notes',
-      'Find related notes',
-      'Draft a new note',
+      { label: 'Organize inbox', prompt: 'Organize my inbox files into the right spaces' },
+      { label: 'Research a topic', prompt: 'Research the latest trends in AI agents' },
+      { label: 'Draft weekly review', prompt: 'Draft a weekly review based on my recent notes' },
+      { label: 'Brainstorm ideas', prompt: 'Brainstorm 3 creative ideas for my next project' },
+    ],
+    /** Categorized prompts for homepage explore section */
+    homeCategories: [
+      {
+        label: 'Knowledge',
+        items: [
+          { label: 'Organize into Spaces', desc: 'Sort scattered notes by topic', prompt: 'Help me organize my recent unstructured notes into appropriate spaces with proper tags' },
+          { label: 'Sync & Deduplicate', desc: 'Clean up cross-platform overlap', prompt: 'Find duplicate or overlapping content across my spaces and help me consolidate them' },
+          { label: 'Auto-tag & Categorize', desc: 'Add structure to raw notes', prompt: 'Review my untagged notes and suggest categories and tags for each' },
+          { label: 'Weekly Digest', desc: 'Summarize this week\'s changes', prompt: 'Summarize everything I added or changed this week across all spaces' },
+        ],
+      },
+      {
+        label: 'Writing',
+        items: [
+          { label: 'Blog from Notes', desc: 'Turn drafts into polished posts', prompt: 'Turn my draft notes into a polished blog post with clear structure' },
+          { label: 'Product Copy', desc: 'Landing page & descriptions', prompt: 'Write compelling product description and landing page copy based on my notes' },
+          { label: 'Polish & Refine', desc: 'Improve clarity and tone', prompt: 'Review this document for clarity, tone, and structure, then rewrite the weak parts' },
+          { label: 'Slide Deck Outline', desc: 'Presentation structure from notes', prompt: 'Create a slide deck outline from my notes on this topic' },
+        ],
+      },
+      {
+        label: 'Analysis',
+        items: [
+          { label: 'Competitive Overview', desc: 'Compare products & differentiators', prompt: 'Compare the products in my research notes and identify key differentiators' },
+          { label: 'Extract Insights', desc: 'Patterns across reading notes', prompt: 'What are the most important insights and patterns across my reading notes?' },
+          { label: 'Decision Framework', desc: 'Pros, cons, recommendation', prompt: 'Help me structure this decision with pros, cons, risks, and a recommendation' },
+          { label: 'GTM Strategy', desc: 'Go-to-market from research', prompt: 'Help me build a go-to-market plan based on my product and market research notes' },
+        ],
+      },
+      {
+        label: 'Innovation',
+        items: [
+          { label: 'Challenge My Assumptions', desc: 'Find blind spots in my thinking', prompt: 'Review my notes and challenge the key assumptions I\'m making. What am I missing?' },
+          { label: 'What If Scenarios', desc: 'Explore alternative futures', prompt: 'Based on my research, generate 3 contrarian "what if" scenarios I haven\'t considered' },
+          { label: 'Combine & Remix Ideas', desc: 'Cross-pollinate across domains', prompt: 'Find unexpected connections between ideas in different spaces and suggest novel combinations' },
+          { label: 'Spot the Opportunity', desc: 'Gaps others are missing', prompt: 'Analyze my market research notes and identify underserved niches or emerging opportunities' },
+        ],
+      },
     ],
     modeChat: 'Chat',
     modeAgent: 'Agent',
@@ -81,6 +125,7 @@ export const aiChatEn = {
     },
     loading: 'Loading changes...',
     empty: 'No content changes yet.',
+    emptyHint: 'Changes made to your files will appear here when you or an agent edits content.',
     open: 'Open',
     unchangedLines: (n: number) => `... ${n} unchanged lines ...`,
     operations: {
@@ -100,6 +145,24 @@ export const aiChatEn = {
       import_file: 'Import file',
       legacy_agent_diff_import: 'Import from Agent Diff',
     },
+    /** Frontend-side summary translations for known backend summary patterns */
+    summaries: {
+      updatedFileContent: 'Updated file content',
+      appendedContent: 'Appended content to file',
+      insertedLines: (n: number) => `Inserted ${n} line(s)`,
+      updatedLines: (start: number, end: number) => `Updated lines ${start}-${end}`,
+      insertedAfterHeading: (h: string) => `Inserted content after heading "${h}"`,
+      updatedSection: (h: string) => `Updated section "${h}"`,
+      movedToTrash: 'Moved to trash',
+      renamedFile: (name: string) => `Renamed file to ${name}`,
+      createdFile: 'Created file',
+      movedFile: (p: string) => `Moved file to ${p}`,
+      createdSpace: 'Created space',
+      renamedSpace: (name: string) => `Renamed space to ${name}`,
+      appendedCsvRow: (n: number) => `Appended CSV row (${n} cell${n === 1 ? '' : 's'})`,
+      importedFile: 'Imported file into knowledge base',
+      importedLegacyDiff: 'Imported legacy agent diff',
+    },
     relativeTime: {
       justNow: 'just now',
       minutesAgo: (n: number) => `${n}m ago`,
@@ -145,7 +208,12 @@ export const aiChatZh = {
     fabLabel: 'AI 助手',
     placeholder: '输入问题… @ 附加文件，/ 技能',
     emptyPrompt: '有什么可以帮你？',
-    emptyHint: '输入 @ 引用文件 · / 使用技能',
+    emptyHint: '输入 @ 引用文件 · / 使用技能 · 拖拽图片',
+    executingTool: '正在执行工具…',
+    toolRunning: '运行中...',
+    copyMessage: '复制',
+    toolInput: '输入',
+    toolOutput: '输出',
     send: '发送',
     newlineHint: '换行',
     panelComposerResize: '向上拖拽以拉高输入区',
@@ -175,10 +243,48 @@ export const aiChatZh = {
     proxyCompatAlsoFailed: (err: string) => `兼容模式也失败了：${err}。请检查 Base URL、API Key 和模型名称。`,
     retry: '重试',
     suggestions: [
-      '总结这篇文档',
-      '整理最近的笔记',
-      '查找相关笔记',
-      '起草一篇新笔记',
+      { label: '整理收件箱', prompt: '把收件箱的文件整理到对应空间' },
+      { label: '调研一个话题', prompt: '调研一下 AI Agent 的最新趋势' },
+      { label: '起草周报', prompt: '根据最近的笔记起草一份周报' },
+      { label: '想新 idea', prompt: '为我的下一个项目想 3 个新 idea' },
+    ],
+    homeCategories: [
+      {
+        label: '知识管理',
+        items: [
+          { label: '整理到 Space', desc: '按主题归类零散笔记', prompt: '帮我把最近的零散笔记整理到合适的 Space，并打好标签' },
+          { label: '同步去重', desc: '清理跨平台重复内容', prompt: '找出我各个 Space 中重复或重叠的内容，帮我合并整理' },
+          { label: '自动打标签', desc: '给未分类笔记加结构', prompt: '检查我未标记的笔记，建议合适的分类和标签' },
+          { label: '每周摘要', desc: '汇总本周变更', prompt: '总结我这周在所有 Space 中新增和修改的内容' },
+        ],
+      },
+      {
+        label: '内容创作',
+        items: [
+          { label: '笔记变博客', desc: '草稿变成精修文章', prompt: '把我的草稿笔记改写成一篇结构清晰的博客文章' },
+          { label: '产品文案', desc: '落地页与产品描述', prompt: '根据我的笔记写一段有吸引力的产品描述和落地页文案' },
+          { label: '润色优化', desc: '提升清晰度和语气', prompt: '审阅这篇文档的清晰度、语气和结构，重写不好的部分' },
+          { label: '演示大纲', desc: '从笔记生成演讲结构', prompt: '根据我关于这个主题的笔记，创建一个演示文稿大纲' },
+        ],
+      },
+      {
+        label: '分析洞察',
+        items: [
+          { label: '竞品对比', desc: '比较产品差异化', prompt: '对比我调研笔记中的产品，找出关键差异点' },
+          { label: '提炼洞察', desc: '发现阅读笔记中的规律', prompt: '我的阅读笔记中有哪些最重要的见解和规律？' },
+          { label: '决策框架', desc: '利弊分析与建议', prompt: '帮我用利弊、风险和建议来结构化这个决策' },
+          { label: 'GTM 策略', desc: '从调研到上市方案', prompt: '根据我的产品和市场调研笔记，帮我制定一份上市计划' },
+        ],
+      },
+      {
+        label: '启发创新',
+        items: [
+          { label: '挑战假设', desc: '找出思维盲点', prompt: '审视我的笔记，挑战我正在做的关键假设。我遗漏了什么？' },
+          { label: '反常识探索', desc: '探索替代可能性', prompt: '根据我的调研，生成 3 个我没考虑过的反常识场景' },
+          { label: '跨域融合', desc: '不同领域的创意碰撞', prompt: '在我不同 Space 的想法中找到意想不到的联系，并建议新颖的组合' },
+          { label: '发现机会', desc: '别人没看到的空白', prompt: '分析我的市场调研笔记，找出未被充分服务的小众市场或新兴机会' },
+        ],
+      },
     ],
     modeChat: '对话',
     modeAgent: 'Agent',
@@ -220,6 +326,7 @@ export const aiChatZh = {
     },
     loading: '正在加载变更...',
     empty: '暂无内容变更。',
+    emptyHint: '你或 Agent 编辑文件时，变更会显示在这里。',
     open: '打开',
     unchangedLines: (n: number) => `... ${n} 行未变更 ...`,
     operations: {
@@ -239,6 +346,23 @@ export const aiChatZh = {
       import_file: '导入文件',
       legacy_agent_diff_import: '从 Agent Diff 导入',
     },
+    summaries: {
+      updatedFileContent: '更新了文件内容',
+      appendedContent: '追加了文件内容',
+      insertedLines: (n: number) => `插入了 ${n} 行`,
+      updatedLines: (start: number, end: number) => `更新了第 ${start}-${end} 行`,
+      insertedAfterHeading: (h: string) => `在标题「${h}」后插入了内容`,
+      updatedSection: (h: string) => `更新了章节「${h}」`,
+      movedToTrash: '移到了回收站',
+      renamedFile: (name: string) => `重命名为 ${name}`,
+      createdFile: '创建了文件',
+      movedFile: (p: string) => `移动到了 ${p}`,
+      createdSpace: '创建了空间',
+      renamedSpace: (name: string) => `重命名空间为 ${name}`,
+      appendedCsvRow: (n: number) => `追加了 CSV 行（${n} 个单元格）`,
+      importedFile: '导入了文件到知识库',
+      importedLegacyDiff: '从 Agent Diff 导入了变更',
+    },
     relativeTime: {
       justNow: '刚刚',
       minutesAgo: (n: number) => `${n} 分钟前`,

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

@@ -103,6 +103,7 @@ export const knowledgeEn = {
     viewAllHistory: (n: number) => `View all ${n} records →`,
     agingHint: '7+ days',
     savedToast: (n: number) => `${n} file${n === 1 ? '' : 's'} saved to Capture`,
+    savedToDir: (n: number, dir: string) => `${n} file${n === 1 ? '' : 's'} saved to ${dir}`,
     savedWithSkipped: (saved: number, skipped: number) =>
       saved > 0
         ? `${saved} saved, ${skipped} skipped (unsupported format)`
@@ -481,6 +482,7 @@ export const knowledgeZh = {
     viewAllHistory: (n: number) => `查看全部 ${n} 条记录 →`,
     agingHint: '7天+',
     savedToast: (n: number) => `${n} 个文件已保存到暂存台`,
+    savedToDir: (n: number, dir: string) => `${n} 个文件已保存到 ${dir}`,
     savedWithSkipped: (saved: number, skipped: number) =>
       saved > 0
         ? `已保存 ${saved} 个，跳过 ${skipped} 个（格式不支持）`

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

@@ -174,17 +174,17 @@ export const onboardingEn = {
       button: 'Import Files',
     },
     ai: {
-      title: 'See AI read your content',
+      title: 'Save with AI',
       cta: 'Try it',
-      desc: 'Your files are in the knowledge base. Ask MindOS Agent what it learned:',
-      prompt: 'Introduce me based on my knowledge base — who am I and what am I working on?',
+      desc: 'Ask MindOS Agent to capture knowledge from this conversation into your KB:',
+      prompt: 'Help me distill the key takeaways from our conversation into a reusable SOP in my knowledge base.',
       promptEmpty: 'Help me design a knowledge base folder structure that fits my needs',
     },
     agent: {
-      title: 'Try in another Agent',
+      title: 'Connect other Agents',
       cta: 'Copy prompt',
-      desc: 'Open Cursor, Claude Code, or any MCP-connected Agent and paste this:',
-      copyPrompt: 'Read my MindOS knowledge base and summarize my background, then suggest what I should focus on next.',
+      desc: 'Open Cursor, Claude Code, or any Agent with MindOS CLI and paste:',
+      copyPrompt: 'Summarize what we discussed and save it to my MindOS knowledge base as a reusable SOP.',
       copy: 'Copy',
       copied: 'Copied!',
     },
@@ -396,17 +396,17 @@ export const onboardingZh = {
       button: '导入文件',
     },
     ai: {
-      title: '感受 AI 读取内容',
+      title: 'AI 帮你沉淀',
       cta: '试试',
-      desc: '你的文件已在知识库中。问问 MindOS Agent 它了解了什么：',
-      prompt: '根据我的知识库介绍一下我——我是谁、在做什么？',
+      desc: '让 MindOS Agent 把对话中的经验沉淀到知识库：',
+      prompt: '帮我把这次对话的关键收获整理成一份可复用的 SOP，存到我的知识库里。',
       promptEmpty: '帮我设计一个适合我的知识库目录结构',
     },
     agent: {
-      title: '在其他 Agent 验证',
+      title: '连接其他 Agent',
       cta: '复制提示词',
-      desc: '打开 Cursor、Claude Code 或任意连接了 MCP 的 Agent，粘贴以下提示词：',
-      copyPrompt: '读取我的 MindOS 知识库，概括我的背景，然后建议我接下来该做什么。',
+      desc: '打开 Cursor、Claude Code 或任意 MCP Agent，粘贴以下提示词，让知识流入 MindOS：',
+      copyPrompt: '把我们刚才讨论的内容总结一下，存到我的 MindOS 知识库里，形成可复用的 SOP。',
       copy: '复制',
       copied: '已复制！',
     },

package/app/lib/inbox-upload.ts

@@ -91,3 +91,89 @@ export async function quickDropToInbox(
     toast.error(t.inbox.saveFailed, 4000);
   }
 }
+
+/**
+ * Drop files into a specific directory via /api/file/import.
+ * Used when user drags external files onto a directory in the file tree.
+ */
+export async function quickDropToDirectory(
+  files: File[],
+  targetDir: string,
+  t: ReturnType<typeof useLocale>['t'],
+) {
+  const payload: Array<{ name: string; content: string; encoding?: string }> = [];
+  let oversizedCount = 0;
+
+  const BINARY_EXTS = new Set([
+    'pdf', 'png', 'jpg', 'jpeg', 'gif', 'webp', 'bmp', 'ico',
+    'mp3', 'wav', 'm4a', 'ogg', 'flac', 'aac', 'mp4', 'webm', 'mov', 'mkv',
+  ]);
+
+  for (const file of files) {
+    if (file.size > MAX_FILE_SIZE) {
+      oversizedCount++;
+      continue;
+    }
+    try {
+      const ext = (file.name.split('.').pop() ?? '').toLowerCase();
+      if (BINARY_EXTS.has(ext)) {
+        const buf = await file.arrayBuffer();
+        payload.push({ name: file.name, content: arrayBufferToBase64(buf), encoding: 'base64' });
+      } else {
+        const text = await file.text();
+        payload.push({ name: file.name, content: text });
+      }
+    } catch {
+      /* skip unreadable files */
+    }
+  }
+
+  if (payload.length === 0) {
+    if (oversizedCount > 0) {
+      toast.error(t.inbox.tooLarge(oversizedCount), 4000);
+    } else if (files.length > 0) {
+      toast.error(t.inbox.saveFailed, 4000);
+    }
+    return;
+  }
+
+  const dirName = targetDir.split('/').pop() || targetDir;
+
+  try {
+    const res = await fetch('/api/file/import', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        files: payload,
+        targetSpace: targetDir,
+        organize: false,
+        conflict: 'rename',
+      }),
+    });
+
+    if (!res.ok) {
+      const data = await res.json().catch(() => ({}));
+      console.error('[TreeDrop] Save failed:', data.error);
+      toast.error(t.inbox.saveFailed, 4000);
+      return;
+    }
+
+    const result = await res.json();
+    const saved = result.created?.length ?? 0;
+    const skipped = result.skipped?.length ?? 0;
+
+    if (saved > 0 && (skipped + oversizedCount) > 0) {
+      toast.success(t.inbox.savedWithSkipped(saved, skipped + oversizedCount), 4000);
+    } else if (saved > 0) {
+      toast.success(t.inbox.savedToDir(saved, dirName), 3000);
+    } else {
+      if (oversizedCount > 0) toast.error(t.inbox.tooLarge(oversizedCount), 4000);
+      if (skipped > 0) toast.error(t.inbox.savedWithSkipped(0, skipped), 4000);
+    }
+
+    window.dispatchEvent(new Event('mindos:files-changed'));
+  } catch (err) {
+    console.error('[TreeDrop] Network error:', err);
+    toast.error(t.inbox.saveFailed, 4000);
+  }
+}

package/app/lib/mcp-agents.ts

@@ -5,7 +5,7 @@ import { execSync } from 'child_process';
 
 /** Parse JSONC — strips single-line (//) and block comments before JSON.parse */
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
-function parseJsonc(text: string): any {
+export function parseJsonc(text: string): any {
   let stripped = text.replace(/\\"|"(?:\\"|[^"])*"|(\/\/.*$)/gm, (m, g) => g ? '' : m);
   stripped = stripped.replace(/\/\*[\s\S]*?\*\//g, '');
   if (!stripped.trim()) return {};
@@ -244,6 +244,24 @@ export const MCP_AGENTS: Record<string, AgentDef> = {
     presenceCli: 'agy',
     presenceDirs: ['~/.gemini/antigravity/'],
   },
+  'qclaw': {
+    name: 'QClaw',
+    project: null,
+    global: '~/.qclaw/mcp.json',
+    key: 'mcpServers',
+    preferredTransport: 'stdio',
+    presenceCli: 'qclaw',
+    presenceDirs: ['~/.qclaw/'],
+  },
+  'workbuddy': {
+    name: 'WorkBuddy',
+    project: null,
+    global: '~/.workbuddy/mcp.json',
+    key: 'mcpServers',
+    preferredTransport: 'stdio',
+    presenceCli: 'workbuddy',
+    presenceDirs: ['~/.workbuddy/'],
+  },
 };
 
 /**
@@ -271,6 +289,8 @@ export const SKILL_AGENT_REGISTRY: Record<string, SkillAgentRegistration> = {
   'github-copilot': { mode: 'universal' },
   'codex': { mode: 'universal' },
   'antigravity': { mode: 'additional', skillAgentName: 'antigravity' },
+  'qclaw': { mode: 'unsupported' },
+  'workbuddy': { mode: 'unsupported' },
 };
 
 export interface SkillWorkspaceProfile {

package/app/lib/stores/LocaleStoreInit.tsx

@@ -1,14 +1,37 @@
 'use client';
 
-import { useEffect } from 'react';
+import { useEffect, useRef } from 'react';
 import { useLocaleStore } from '@/lib/stores/locale-store';
 import type { Locale } from '@/lib/i18n';
+import { messages } from '@/lib/i18n';
 
 /**
  * Initializes locale store with SSR value and attaches event listeners.
  * Renders nothing. Place once near the root.
+ *
+ * During the first client render, synchronously updates the Zustand store
+ * to match ssrLocale (from server cookie). This ensures the first client
+ * render produces identical HTML to the server, preventing hydration mismatch.
+ * After hydration, _init() reconciles with localStorage/navigator for
+ * the true client preference.
  */
 export default function LocaleStoreInit({ ssrLocale }: { ssrLocale: Locale }) {
+  const didSync = useRef(false);
+
+  // Synchronous store update during first render — before React commits.
+  // The store defaults to 'en'; if ssrLocale is 'zh' (from cookie), update
+  // immediately so all sibling/child components read 'zh' in the same pass.
+  if (!didSync.current) {
+    didSync.current = true;
+    const state = useLocaleStore.getState();
+    if (state.locale !== ssrLocale) {
+      useLocaleStore.setState({
+        locale: ssrLocale,
+        t: messages[ssrLocale] as unknown as typeof state.t,
+      });
+    }
+  }
+
   useEffect(() => {
     const cleanup = useLocaleStore.getState()._init(ssrLocale);
     return cleanup;

package/app/lib/stores/locale-store.ts

@@ -22,23 +22,37 @@ function getLocaleSnapshot(): Locale {
   return navigator.language.startsWith('zh') ? 'zh' : 'en';
 }
 
+/**
+ * Read the locale that the inline <script> in layout.tsx already resolved.
+ * Returns 'en' to match SSR default — the LocaleStoreInit component
+ * reconciles to the real locale synchronously before first commit.
+ */
+function getPreHydrateLocale(): Locale {
+  return 'en';
+}
+
+const initialLocale = getPreHydrateLocale();
+
 export const useLocaleStore = create<LocaleStoreState>((set) => ({
-  locale: 'en',
-  t: messages['en'] as unknown as Messages,
+  locale: initialLocale,
+  t: messages[initialLocale] as unknown as Messages,
 
   setLocale: (l: Locale) => {
     document.cookie = `locale=${l};path=/;max-age=31536000;SameSite=Lax`;
     document.documentElement.lang = l === 'zh' ? 'zh' : 'en';
+    (window as any).__mindos_locale__ = l;
     set({ locale: l, t: messages[l] as unknown as Messages });
     window.dispatchEvent(new Event('mindos-locale-change'));
   },
 
   _init: (ssrLocale: Locale) => {
-    // Hydrate with client value (or SSR fallback)
-    const clientLocale = typeof window !== 'undefined' ? getLocaleSnapshot() : ssrLocale;
-    set({ locale: clientLocale, t: messages[clientLocale] as unknown as Messages });
+    // Reconcile: if client localStorage disagrees with current store, update once
+    const clientLocale = getLocaleSnapshot();
+    const current = useLocaleStore.getState().locale;
+    if (clientLocale !== current) {
+      set({ locale: clientLocale, t: messages[clientLocale] as unknown as Messages });
+    }
 
-    // Listen for external changes (e.g. localStorage change in another tab, or pre-hydration script)
     const handler = () => {
       const l = getLocaleSnapshot();
       set({ locale: l, t: messages[l] as unknown as Messages });