@geminilight/mindos 0.6.56 → 0.6.58

package/app/data/skills/mindos-zh/SKILL.md

@@ -1,11 +1,20 @@
 ---
 name: mindos-zh
 description: >
-  操作 MindOS 知识库：更新笔记, 搜索知识库, 整理文件, 执行SOP/工作流, 复盘, 追加CSV, 跨Agent交接,
-  路由非结构化输入到对应文件, 提炼经验, 同步关联文档. update notes, search knowledge base, organize,
-  SOP, retrospective, CSV, handoff, route notes, distill experience.
-  仅 mindRoot 知识库内任务。不用于：改代码仓库/项目文档/KB 外路径。
+  MindOS 知识库操作：更新笔记、搜索知识库、整理文件、执行SOP/工作流、复盘、追加CSV、跨Agent交接、
+  路由非结构化输入到对应文件、提炼经验、同步关联文档。
+  仅 mindRoot 知识库内任务。不用于：改代码仓库、项目源码、KB 外路径。
   核心概念：空间、指令(INSTRUCTION.md)、技能(SKILL.md)；笔记可承载指令与技能。
+  触发场景：保存或记录任何内容、搜索历史笔记或上下文、更新或编辑文件、整理或重组文件结构、
+  执行SOP或工作流、捕获对话中的决策、复盘或总结经验、追加表格或CSV数据、跨Agent交接上下文、
+  提炼经验教训、同步关联文档、查找之前是否讨论过某事、查询历史决策、查找模板或SOP、
+  为会议准备上下文。
+  触发词：帮我记下来、搜一下我的笔记、更新知识库、整理文件、执行工作流、保存到知识库、
+  记录一下、整理笔记、复盘、提炼经验、同步文档、查一下之前的记录、有没有相关的笔记、
+  我之前写过什么、把这个存起来、总结一下保存、交接给其他Agent、追加到表格。
+  English triggers: save, record, search notes, organize, retrospective, handoff, lessons learned.
+  当用户的问题暗示可能存在历史记录（过去的决策、之前的讨论、会议纪要）时，
+  即使没有明确提到知识库，也应该考虑搜索 MindOS。
 ---
 
 # MindOS 技能

package/app/hooks/useEditorImageUpload.ts

@@ -0,0 +1,113 @@
+/**
+ * Hook for uploading images to the .media/ directory in the editor.
+ *
+ * Unlike useImageUpload (for chat image attachments), this hook uploads
+ * images to the knowledge base's .media/ directory and returns file paths
+ * suitable for use in markdown `![alt](path)` syntax.
+ *
+ * Usage:
+ *   const { uploadToMedia, isUploading } = useEditorImageUpload();
+ *   const paths = await uploadToMedia([file1, file2]);
+ *   // paths = ['/.media/2026-04-07_abc123.png', ...]
+ */
+
+import { useState, useCallback } from 'react';
+
+const MAX_IMAGE_SIZE = 10 * 1024 * 1024; // 10 MB per image
+const ALLOWED_IMAGE_TYPES = new Set([
+  'image/png',
+  'image/jpeg',
+  'image/gif',
+  'image/webp',
+  'image/svg+xml',
+  'image/bmp',
+  'image/x-icon',
+  'image/vnd.microsoft.icon',
+]);
+
+/**
+ * Generates a unique filename: YYYY-MM-DD_randomhash.ext
+ */
+function generateImageFileName(originalName: string): string {
+  const ext = originalName.split('.').pop()?.toLowerCase() || 'png';
+  const timestamp = new Date().toISOString().split('T')[0];
+  const randomHash = Math.random().toString(36).slice(2, 10);
+  return `${timestamp}_${randomHash}.${ext}`;
+}
+
+/** Converts a File to base64 string (without data URL prefix). */
+async function fileToBase64(file: File): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onload = () => {
+      const result = reader.result as string;
+      resolve(result.split(',')[1]); // Strip "data:image/...;base64," prefix
+    };
+    reader.onerror = reject;
+    reader.readAsDataURL(file);
+  });
+}
+
+export function useEditorImageUpload() {
+  const [isUploading, setIsUploading] = useState(false);
+
+  const uploadToMedia = useCallback(async (files: File[]): Promise<string[]> => {
+    setIsUploading(true);
+
+    try {
+      // Filter valid images
+      const validFiles: Array<{ base64: string; newName: string }> = [];
+      const skippedReasons: string[] = [];
+
+      for (const file of files) {
+        if (!ALLOWED_IMAGE_TYPES.has(file.type)) {
+          skippedReasons.push(`${file.name}: unsupported format`);
+          continue;
+        }
+        if (file.size > MAX_IMAGE_SIZE) {
+          skippedReasons.push(`${file.name}: exceeds 10MB limit`);
+          continue;
+        }
+
+        const base64 = await fileToBase64(file);
+        const newName = generateImageFileName(file.name);
+        validFiles.push({ base64, newName });
+      }
+
+      if (validFiles.length === 0) {
+        throw new Error(skippedReasons.length > 0
+          ? skippedReasons.join('; ')
+          : 'No valid images to upload');
+      }
+
+      const response = await fetch('/api/file/import', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          files: validFiles.map((img) => ({
+            name: img.newName,
+            content: img.base64,
+            encoding: 'base64',
+          })),
+          targetSpace: '.media',
+          organize: false,  // Don't trigger AI organize for media files
+          conflict: 'rename',
+        }),
+      });
+
+      if (!response.ok) {
+        const data = await response.json().catch(() => ({}));
+        throw new Error(data.error || `Upload failed: ${response.statusText}`);
+      }
+
+      const result = await response.json();
+      return (result.created ?? []).map(
+        (item: { path: string }) => `/${item.path}`,
+      );
+    } finally {
+      setIsUploading(false);
+    }
+  }, []);
+
+  return { uploadToMedia, isUploading };
+}

package/app/lib/agent/model.ts

@@ -84,6 +84,12 @@ function resolveModel(providerId: ProviderId, modelName: string, baseUrl: string
     };
   }
 
+  // 2.5. Apply preset fixedBaseUrl when registry lookup succeeded but needs endpoint override
+  // (zai-cn: domestic endpoint, deepseek: fixed baseUrl, ollama: localhost)
+  if (preset.fixedBaseUrl && !hasCustomBase) {
+    model = { ...model, baseUrl: preset.fixedBaseUrl };
+  }
+
   // 3. Apply user's custom baseUrl
   if (hasCustomBase) {
     model = { ...model, baseUrl };
@@ -93,7 +99,7 @@ function resolveModel(providerId: ProviderId, modelName: string, baseUrl: string
     }
   }
 
-  // 4. For deepseek or any custom endpoint, apply conservative compat
+  // 4. For deepseek/zai-cn/ollama or any custom endpoint, apply conservative compat
   if (hasCustomBase || preset.fixedBaseUrl) {
     model = {
       ...model,

package/app/lib/agent/providers.ts

@@ -16,8 +16,8 @@ import {
 export type ProviderId =
   | 'anthropic' | 'openai' | 'google' | 'groq'
   | 'xai' | 'openrouter' | 'mistral' | 'deepseek'
-  | 'zai' | 'kimi-coding'
-  | 'cerebras' | 'minimax' | 'huggingface'
+  | 'zai' | 'zai-cn' | 'kimi-coding'
+  | 'cerebras' | 'minimax' | 'minimax-cn' | 'huggingface'
   | 'ollama';
 
 /**
@@ -135,13 +135,26 @@ export const PROVIDER_PRESETS: Record<ProviderId, ProviderPreset> = {
   zai: {
     id: 'zai',
     name: 'ZhipuAI (GLM)',
-    nameZh: '智谱 AI (GLM)',
+    nameZh: '智谱 AI (GLM 国际版)',
     defaultModel: 'glm-4-plus',
     supportsBaseUrl: false,
     supportsThinking: true,
     supportsListModels: false,
     category: 'more',
   },
+  'zai-cn': {
+    id: 'zai-cn',
+    name: 'ZhipuAI (GLM China)',
+    nameZh: '智谱 AI (GLM 国内版)',
+    defaultModel: 'glm-4-plus',
+    piProviderOverride: 'zai' as KnownProvider,
+    fixedBaseUrl: 'https://open.bigmodel.cn/api/coding/paas/v4',
+    supportsBaseUrl: false,
+    supportsThinking: true,
+    supportsListModels: false,
+    signupUrl: 'https://open.bigmodel.cn/',
+    category: 'more',
+  },
   'kimi-coding': {
     id: 'kimi-coding',
     name: 'Kimi Coding',
@@ -165,10 +178,20 @@ export const PROVIDER_PRESETS: Record<ProviderId, ProviderPreset> = {
   minimax: {
     id: 'minimax',
     name: 'MiniMax',
-    nameZh: 'MiniMax',
-    defaultModel: 'MiniMax-M1',
+    nameZh: 'MiniMax (国际版)',
+    defaultModel: 'MiniMax-M2.5',
     supportsBaseUrl: false,
-    supportsThinking: false,
+    supportsThinking: true,
+    supportsListModels: false,
+    category: 'more',
+  },
+  'minimax-cn': {
+    id: 'minimax-cn',
+    name: 'MiniMax (China)',
+    nameZh: 'MiniMax (国内版)',
+    defaultModel: 'MiniMax-M2.5',
+    supportsBaseUrl: false,
+    supportsThinking: true,
     supportsListModels: false,
     category: 'more',
   },
@@ -288,8 +311,10 @@ const PI_ENV_MAP: Record<string, string> = {
   xai: 'XAI_API_KEY',
   openrouter: 'OPENROUTER_API_KEY',
   zai: 'ZAI_API_KEY',
+  'zai-cn': 'ZAI_API_KEY',
   mistral: 'MISTRAL_API_KEY',
   minimax: 'MINIMAX_API_KEY',
+  'minimax-cn': 'MINIMAX_API_KEY',
   huggingface: 'HF_TOKEN',
   'kimi-coding': 'KIMI_API_KEY',
 };

package/app/lib/core/organize.ts

@@ -14,7 +14,7 @@ const STOP_WORDS = new Set([
   'readme', 'instruction', 'md',
 ]);
 
-const SKIP_DIRS = new Set(['.git', 'node_modules', '.next', '.DS_Store']);
+const SKIP_DIRS = new Set(['.git', 'node_modules', '.next', '.DS_Store', '.media', 'mcp']);
 
 function extractKeywords(filePath: string): string[] {
   const stem = path.basename(filePath, path.extname(filePath));

package/app/lib/core/tree.ts

@@ -3,7 +3,7 @@ import fsp from 'fs/promises';
 import path from 'path';
 import type { FileNode } from './types';
 
-const DEFAULT_IGNORED_DIRS = new Set(['.git', 'node_modules', 'app', '.next', '.DS_Store', 'mcp']);
+const DEFAULT_IGNORED_DIRS = new Set(['.git', 'node_modules', 'app', '.next', '.DS_Store', 'mcp', '.media']);
 const DEFAULT_ALLOWED_EXTENSIONS = new Set([
   '.md', '.csv', '.pdf',
   '.png', '.jpg', '.jpeg', '.gif', '.webp', '.svg', '.bmp', '.ico',

package/app/lib/custom-agents.ts

@@ -0,0 +1,322 @@
+/**
+ * Custom Agent registration: types, slugify, defaults inference, and persistence.
+ *
+ * CustomAgentDef is stored in config.json.customAgents[].
+ * At runtime, toAgentDef() converts it into the standard AgentDef that all
+ * downstream detection / snippet / UI code already understands.
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { expandHome, MCP_AGENTS } from './mcp-agents';
+import type { AgentDef } from './mcp-agents';
+import { readSettings, writeSettings } from './settings';
+
+/* ─── Types ─── */
+
+export interface CustomAgentDef {
+  name: string;
+  key: string;
+  baseDir: string;
+  global: string;
+  project?: string | null;
+  configKey: string;
+  format: 'json' | 'toml';
+  preferredTransport: 'stdio' | 'http';
+  presenceDirs: string[];
+  presenceCli?: string;
+  globalNestedKey?: string;
+  /** Skills directory path. Defaults to `baseDir + 'skills/'`. */
+  skillDir?: string;
+}
+
+export interface DetectResult {
+  exists: boolean;
+  detectedConfig?: string;
+  detectedFormat?: 'json' | 'toml';
+  detectedConfigKey?: string;
+  hasSkillsDir: boolean;
+  detectedSkillDir?: string;
+  skillCount?: number;
+  skillNames?: string[];
+  suggestedName?: string;
+}
+
+/* ─── Slugify ─── */
+
+export function slugify(name: string): string {
+  const slug = name
+    .toLowerCase()
+    .replace(/[^\x20-\x7E]/g, '')
+    .replace(/[_\s]+/g, '-')
+    .replace(/[^a-z0-9-]/g, '')
+    .replace(/-{2,}/g, '-')
+    .replace(/^-|-$/g, '');
+
+  return slug || '';
+}
+
+/**
+ * Generate a unique key from a name, avoiding collisions with built-in
+ * and existing custom agents.
+ */
+export function generateUniqueKey(
+  name: string,
+  existingKeys: Set<string>,
+): string {
+  let base = slugify(name);
+
+  if (!base) {
+    let n = 1;
+    while (existingKeys.has(`custom-${n}`)) n++;
+    return `custom-${n}`;
+  }
+
+  if (!existingKeys.has(base)) return base;
+
+  let n = 2;
+  while (existingKeys.has(`${base}-${n}`)) n++;
+  return `${base}-${n}`;
+}
+
+/* ─── Defaults Inference ─── */
+
+export function inferDefaults(name: string, baseDir: string): Omit<CustomAgentDef, 'key'> {
+  const dir = baseDir.endsWith('/') ? baseDir : baseDir + '/';
+  return {
+    name,
+    baseDir: dir,
+    global: dir + 'mcp.json',
+    project: null,
+    configKey: 'mcpServers',
+    format: 'json',
+    preferredTransport: 'stdio',
+    presenceDirs: [dir],
+    skillDir: dir + 'skills/',
+  };
+}
+
+/* ─── Auto-detection ─── */
+
+export function detectBaseDir(baseDir: string): DetectResult {
+  const expanded = expandHome(baseDir);
+
+  if (!fs.existsSync(expanded)) {
+    const dirName = path.basename(expanded.replace(/\/$/, ''));
+    return {
+      exists: false,
+      hasSkillsDir: false,
+      suggestedName: dirName.charAt(0).toUpperCase() + dirName.slice(1),
+    };
+  }
+
+  const result: DetectResult = {
+    exists: true,
+    hasSkillsDir: false,
+  };
+
+  const dirName = path.basename(expanded.replace(/\/$/, ''));
+  result.suggestedName = dirName.charAt(0).toUpperCase() + dirName.slice(1);
+
+  // Check for skills/ subdirectory and scan contents
+  const skillsPath = path.join(expanded, 'skills');
+  if (fs.existsSync(skillsPath)) {
+    result.hasSkillsDir = true;
+    result.detectedSkillDir = baseDir.endsWith('/') ? baseDir + 'skills/' : baseDir + '/skills/';
+    try {
+      const skillEntries = fs.readdirSync(skillsPath, { withFileTypes: true });
+      const skillNames = skillEntries
+        .filter(e => (e.isDirectory() || e.isSymbolicLink()) && !e.name.startsWith('.'))
+        .map(e => e.name)
+        .sort((a, b) => a.localeCompare(b));
+      result.skillCount = skillNames.length;
+      result.skillNames = skillNames;
+    } catch {
+      result.skillCount = 0;
+    }
+  }
+
+  // Scan top-level files (max 20)
+  let entries: string[];
+  try {
+    entries = fs.readdirSync(expanded).slice(0, 20);
+  } catch {
+    return result;
+  }
+
+  // Try JSON files first
+  for (const entry of entries) {
+    if (!entry.endsWith('.json')) continue;
+    const filePath = path.join(expanded, entry);
+    try {
+      const stat = fs.statSync(filePath);
+      if (!stat.isFile() || stat.size > 1_000_000) continue;
+      const raw = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+      if (raw && typeof raw === 'object') {
+        if ('mcpServers' in raw) {
+          result.detectedConfig = baseDir.endsWith('/') ? baseDir + entry : baseDir + '/' + entry;
+          result.detectedFormat = 'json';
+          result.detectedConfigKey = 'mcpServers';
+          return result;
+        }
+        if ('servers' in raw) {
+          result.detectedConfig = baseDir.endsWith('/') ? baseDir + entry : baseDir + '/' + entry;
+          result.detectedFormat = 'json';
+          result.detectedConfigKey = 'servers';
+          return result;
+        }
+      }
+    } catch { /* skip unparseable files */ }
+  }
+
+  // Try TOML files
+  for (const entry of entries) {
+    if (!entry.endsWith('.toml')) continue;
+    const filePath = path.join(expanded, entry);
+    try {
+      const stat = fs.statSync(filePath);
+      if (!stat.isFile() || stat.size > 1_000_000) continue;
+      const lines = fs.readFileSync(filePath, 'utf-8').split('\n').slice(0, 50);
+      for (const line of lines) {
+        if (/^\s*\[mcp_servers/i.test(line) || /^\s*\[mcpServers/i.test(line)) {
+          const lower = line.toLowerCase();
+          const key = lower.includes('mcp_servers') ? 'mcp_servers' : 'mcpServers';
+          result.detectedConfig = baseDir.endsWith('/') ? baseDir + entry : baseDir + '/' + entry;
+          result.detectedFormat = 'toml';
+          result.detectedConfigKey = key;
+          return result;
+        }
+      }
+    } catch { /* skip */ }
+  }
+
+  return result;
+}
+
+/* ─── AgentDef Conversion ─── */
+
+/**
+ * Convert a CustomAgentDef into the standard AgentDef that all downstream
+ * code (detectInstalled, generateSnippet, etc.) expects.
+ *
+ * Note: AgentDef.key is the *config key* (e.g. "mcpServers"), not the agent identifier.
+ * The agent identifier is the key in the MCP_AGENTS record, which comes from CustomAgentDef.key.
+ */
+export function toAgentDef(custom: CustomAgentDef): AgentDef {
+  return {
+    name: custom.name,
+    project: custom.project ?? null,
+    global: custom.global,
+    key: custom.configKey,
+    preferredTransport: custom.preferredTransport,
+    format: custom.format,
+    globalNestedKey: custom.globalNestedKey,
+    presenceCli: custom.presenceCli,
+    presenceDirs: custom.presenceDirs,
+  };
+}
+
+/* ─── Persistence ─── */
+
+export function loadCustomAgents(): CustomAgentDef[] {
+  try {
+    const settings = readSettings();
+    const raw = settings.customAgents;
+    if (!Array.isArray(raw)) return [];
+    return raw.filter(
+      (item): item is CustomAgentDef => {
+        if (item == null || typeof item !== 'object') return false;
+        const obj = item as unknown as Record<string, unknown>;
+        return typeof obj.name === 'string' && typeof obj.key === 'string' && typeof obj.baseDir === 'string';
+      },
+    );
+  } catch {
+    console.warn('[custom-agents] Failed to parse, using empty list');
+    return [];
+  }
+}
+
+export function saveCustomAgents(agents: CustomAgentDef[]): void {
+  const settings = readSettings();
+  settings.customAgents = agents;
+  writeSettings(settings);
+}
+
+/* ─── Merged Registry ─── */
+
+/**
+ * Returns all agents (built-in + custom) as a Record<agentId, AgentDef>.
+ * Built-in agents take priority on key collision.
+ */
+export function getAllAgents(): Record<string, AgentDef> {
+  const result: Record<string, AgentDef> = { ...MCP_AGENTS };
+  const customs = loadCustomAgents();
+
+  for (const custom of customs) {
+    if (custom.key in result) continue; // built-in priority
+    result[custom.key] = toAgentDef(custom);
+  }
+
+  return result;
+}
+
+/* ─── Skill Scanning ─── */
+
+/**
+ * Scan skills installed in a custom agent's skill directory.
+ * Returns the same shape as detectAgentInstalledSkills.
+ */
+export function scanCustomAgentSkills(custom: CustomAgentDef): { skills: string[]; sourcePath: string } {
+  const skillDir = custom.skillDir || (custom.baseDir.endsWith('/') ? custom.baseDir + 'skills/' : custom.baseDir + '/skills/');
+  const expanded = expandHome(skillDir);
+  if (!fs.existsSync(expanded)) return { skills: [], sourcePath: expanded };
+  try {
+    const entries = fs.readdirSync(expanded, { withFileTypes: true });
+    const skills = entries
+      .filter(e => (e.isDirectory() || e.isSymbolicLink()) && !e.name.startsWith('.'))
+      .map(e => e.name)
+      .sort((a, b) => a.localeCompare(b));
+    return { skills, sourcePath: expanded };
+  } catch {
+    return { skills: [], sourcePath: expanded };
+  }
+}
+
+/* ─── Validation ─── */
+
+export function validateCustomAgentInput(input: {
+  name?: string;
+  baseDir?: string;
+  key?: string;
+}, existingKeys: Set<string>, isEdit = false): string | null {
+  if (!input.name || !input.name.trim()) {
+    return 'Agent name is required';
+  }
+
+  if (!input.baseDir || !input.baseDir.trim()) {
+    return 'Config directory is required';
+  }
+
+  const dir = input.baseDir.trim();
+  if (!dir.startsWith('~/') && !dir.startsWith('/')) {
+    if (process.platform === 'win32' && /^[A-Z]:\\/i.test(dir)) {
+      // Windows absolute path — OK
+    } else {
+      return 'Must be an absolute path (e.g. ~/.qclaw/)';
+    }
+  }
+
+  if (!isEdit) {
+    const key = input.key || slugify(input.name.trim());
+    if (!key) return 'Cannot generate a valid key from this name';
+    if (key in MCP_AGENTS) {
+      const builtIn = MCP_AGENTS[key];
+      return `Conflicts with built-in agent "${builtIn.name}"`;
+    }
+    if (existingKeys.has(key)) {
+      return `An agent with key "${key}" already exists`;
+    }
+  }
+
+  return null;
+}

package/app/lib/fs.ts

@@ -49,7 +49,7 @@ export function getMindRoot(): string {
   return effectiveSopRoot();
 }
 
-const IGNORED_DIRS = new Set(['.git', 'node_modules', 'app', '.next', '.DS_Store']);
+const IGNORED_DIRS = new Set(['.git', 'node_modules', 'app', '.next', '.DS_Store', '.media', 'mcp']);
 const ALLOWED_EXTENSIONS = new Set([
   '.md', '.csv', '.json', '.pdf',
   '.png', '.jpg', '.jpeg', '.gif', '.webp', '.svg', '.bmp', '.ico',