@geminilight/mindos 0.5.3 → 0.5.6

package/app/lib/i18n.ts

@@ -171,6 +171,7 @@ export const messages = {
         enabled: 'Enabled',
         disabled: 'Disabled',
         matchHint: 'Auto-activates on',
+        coreHint: 'Core renderer — always enabled',
         noPlugins: 'No renderers installed.',
         comingSoon: 'Plugin marketplace coming soon.',
       },
@@ -198,6 +199,7 @@ export const messages = {
         notInstalled: 'Not installed',
         transportStdio: 'stdio (recommended)',
         transportHttp: 'http',
+        transportAuto: 'auto (recommended)',
         httpUrl: 'MCP URL',
         httpToken: 'Auth Token',
         installSelected: 'Install Selected',
@@ -221,8 +223,10 @@ export const messages = {
         skillContent: 'Content',
         skillNameConflict: 'A skill with this name already exists',
         skillDeleteConfirm: (name: string) => `Delete skill "${name}"? This cannot be undone.`,
-      },
-      save: 'Save',
+        skillLanguage: 'Skill Language',
+        skillLangEn: 'English',
+        skillLangZh: '中文',
+      },      save: 'Save',
       saved: 'Saved',
       saveFailed: 'Save failed',
       reconfigure: 'Reconfigure',
@@ -292,7 +296,7 @@ export const messages = {
       webPort: 'Web UI port',
       mcpPort: 'MCP server port',
       portHint: 'Valid range: 1024–65535',
-      portRestartWarning: 'Port changes take effect after server restart.',
+      portRestartWarning: 'The service will start on these ports after setup completes.',
       portInUse: (p: number) => `Port ${p} is already in use.`,
       portSuggest: (p: number) => `Use ${p}`,
       portChecking: 'Checking…',
@@ -324,6 +328,17 @@ export const messages = {
       agentStatusOk: 'configured',
       agentStatusError: 'failed',
       agentInstalling: 'Configuring…',
+      agentTransportAuto: 'Auto (recommended)',
+      agentTransportLabel: 'Transport',
+      agentVerified: 'verified',
+      agentUnverified: 'unverified',
+      agentVerifyNote: 'stdio agents are verified after restart',
+      // Skill auto-install
+      skillAutoHint: (name: string) => `Based on your template, the "${name}" skill will be installed to selected agents.`,
+      skillLabel: 'Skill',
+      skillInstalling: 'Installing skill…',
+      skillInstalled: 'Skill installed',
+      skillFailed: 'Skill install failed',
       // Step 2 — AI skip card
       aiSkipTitle: 'Skip for now',
       aiSkipDesc: 'You can add an API key later in Settings → AI.',
@@ -525,6 +540,7 @@ export const messages = {
         enabled: '已启用',
         disabled: '已禁用',
         matchHint: '自动匹配',
+        coreHint: '核心渲染器 — 始终启用',
         noPlugins: '暂无渲染器。',
         comingSoon: '插件市场即将上线。',
       },
@@ -552,6 +568,7 @@ export const messages = {
         notInstalled: '未安装',
         transportStdio: 'stdio（推荐）',
         transportHttp: 'http',
+        transportAuto: '自动（推荐）',
         httpUrl: 'MCP URL',
         httpToken: '认证 Token',
         installSelected: '安装选中',
@@ -575,8 +592,10 @@ export const messages = {
         skillContent: '内容',
         skillNameConflict: '同名 skill 已存在',
         skillDeleteConfirm: (name: string) => `确定删除「${name}」？此操作不可撤销。`,
-      },
-      save: '保存',
+        skillLanguage: 'Skill 语言',
+        skillLangEn: 'English',
+        skillLangZh: '中文',
+      },      save: '保存',
       saved: '已保存',
       saveFailed: '保存失败',
       reconfigure: '重新配置',
@@ -646,7 +665,7 @@ export const messages = {
       webPort: 'Web UI 端口',
       mcpPort: 'MCP 服务端口',
       portHint: '有效范围：1024–65535',
-      portRestartWarning: '端口修改需重启服务后生效。',
+      portRestartWarning: '完成配置后，服务将以这些端口启动。',
       portInUse: (p: number) => `端口 ${p} 已被占用。`,
       portSuggest: (p: number) => `使用 ${p}`,
       portChecking: '检测中…',
@@ -678,6 +697,17 @@ export const messages = {
       agentStatusOk: '已配置',
       agentStatusError: '失败',
       agentInstalling: '配置中…',
+      agentTransportAuto: '自动（推荐）',
+      agentTransportLabel: '传输方式',
+      agentVerified: '已验证',
+      agentUnverified: '未验证',
+      agentVerifyNote: 'stdio agent 需重启后验证',
+      // Skill auto-install
+      skillAutoHint: (name: string) => `根据您选择的模板，将向选中的 Agent 安装「${name}」Skill。`,
+      skillLabel: 'Skill',
+      skillInstalling: '正在安装 Skill…',
+      skillInstalled: 'Skill 已安装',
+      skillFailed: 'Skill 安装失败',
       // Step 2 — AI skip card
       aiSkipTitle: '暂时跳过',
       aiSkipDesc: '稍后可在 设置 → AI 中添加 API 密钥。',

package/app/lib/mcp-agents.ts

@@ -11,18 +11,19 @@ export interface AgentDef {
   project: string | null;
   global: string;
   key: string;
+  preferredTransport: 'stdio' | 'http';
 }
 
 export const MCP_AGENTS: Record<string, AgentDef> = {
-  'claude-code':    { name: 'Claude Code',    project: '.mcp.json',                       global: '~/.claude.json',    key: 'mcpServers' },
-  'claude-desktop': { name: 'Claude Desktop', project: null,                               global: process.platform === 'darwin' ? '~/Library/Application Support/Claude/claude_desktop_config.json' : '~/.config/Claude/claude_desktop_config.json', key: 'mcpServers' },
-  'cursor':         { name: 'Cursor',          project: '.cursor/mcp.json',                global: '~/.cursor/mcp.json', key: 'mcpServers' },
-  'windsurf':       { name: 'Windsurf',        project: null,                               global: '~/.codeium/windsurf/mcp_config.json', key: 'mcpServers' },
-  'cline':          { name: 'Cline',           project: null,                               global: process.platform === 'darwin' ? '~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json' : '~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json', key: 'mcpServers' },
-  'trae':           { name: 'Trae',            project: '.trae/mcp.json',                  global: '~/.trae/mcp.json', key: 'mcpServers' },
-  'gemini-cli':     { name: 'Gemini CLI',      project: '.gemini/settings.json',           global: '~/.gemini/settings.json', key: 'mcpServers' },
-  'openclaw':       { name: 'OpenClaw',        project: null,                               global: '~/.openclaw/mcp.json', key: 'mcpServers' },
-  'codebuddy':      { name: 'CodeBuddy',       project: null,                               global: '~/.claude-internal/.claude.json', key: 'mcpServers' },
+  'claude-code':    { name: 'Claude Code',    project: '.mcp.json',                       global: '~/.claude.json',    key: 'mcpServers', preferredTransport: 'stdio' },
+  'claude-desktop': { name: 'Claude Desktop', project: null,                               global: process.platform === 'darwin' ? '~/Library/Application Support/Claude/claude_desktop_config.json' : '~/.config/Claude/claude_desktop_config.json', key: 'mcpServers', preferredTransport: 'http' },
+  'cursor':         { name: 'Cursor',          project: '.cursor/mcp.json',                global: '~/.cursor/mcp.json', key: 'mcpServers', preferredTransport: 'stdio' },
+  'windsurf':       { name: 'Windsurf',        project: null,                               global: '~/.codeium/windsurf/mcp_config.json', key: 'mcpServers', preferredTransport: 'stdio' },
+  'cline':          { name: 'Cline',           project: null,                               global: process.platform === 'darwin' ? '~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json' : '~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json', key: 'mcpServers', preferredTransport: 'stdio' },
+  'trae':           { name: 'Trae',            project: '.trae/mcp.json',                  global: '~/.trae/mcp.json', key: 'mcpServers', preferredTransport: 'stdio' },
+  'gemini-cli':     { name: 'Gemini CLI',      project: '.gemini/settings.json',           global: '~/.gemini/settings.json', key: 'mcpServers', preferredTransport: 'stdio' },
+  'openclaw':       { name: 'OpenClaw',        project: null,                               global: '~/.openclaw/mcp.json', key: 'mcpServers', preferredTransport: 'stdio' },
+  'codebuddy':      { name: 'CodeBuddy',       project: null,                               global: '~/.claude-internal/.claude.json', key: 'mcpServers', preferredTransport: 'stdio' },
 };
 
 export function detectInstalled(agentKey: string): { installed: boolean; scope?: string; transport?: string; configPath?: string } {

package/app/lib/renderers/index.ts

@@ -8,14 +8,14 @@ import { manifest as backlinks } from '@/components/renderers/backlinks/manifest
 import { manifest as config } from '@/components/renderers/config/manifest';
 import { manifest as csv } from '@/components/renderers/csv/manifest';
 import { manifest as diff } from '@/components/renderers/diff/manifest';
-import { manifest as graph } from '@/components/renderers/graph/manifest';
 import { manifest as summary } from '@/components/renderers/summary/manifest';
 import { manifest as timeline } from '@/components/renderers/timeline/manifest';
 import { manifest as todo } from '@/components/renderers/todo/manifest';
 import { manifest as workflow } from '@/components/renderers/workflow/manifest';
+import { manifest as graph } from '@/components/renderers/graph/manifest';
 
 const manifests = [
-  agentInspector, backlinks, config, csv, diff, graph, summary, timeline, todo, workflow,
+  agentInspector, backlinks, config, csv, diff, summary, timeline, todo, workflow, graph,
 ];
 
 for (const m of manifests) {

package/app/lib/renderers/registry.ts

@@ -15,6 +15,7 @@ export interface RendererDefinition {
   icon: string;          // emoji or short string
   tags: string[];
   builtin: boolean;      // true = ships with MindOS; false = user-installed (future)
+  core?: boolean;        // true = default renderer for a file type, cannot be disabled by user
   entryPath?: string;    // canonical entry file shown on home page (e.g. 'TODO.md')
   match: (ctx: Pick<RendererContext, 'filePath' | 'extension'>) => boolean;
   // Provide either `component` (eager) or `load` (lazy). Prefer `load` for code-splitting.
@@ -38,6 +39,9 @@ export function loadDisabledState() {
 }
 
 export function setRendererEnabled(id: string, enabled: boolean) {
+  // Core renderers cannot be disabled
+  const def = registry.find(r => r.id === id);
+  if (def?.core) return;
   if (enabled) {
     _disabledIds.delete(id);
   } else {
@@ -49,6 +53,9 @@ export function setRendererEnabled(id: string, enabled: boolean) {
 }
 
 export function isRendererEnabled(id: string): boolean {
+  // Core renderers cannot be disabled
+  const def = registry.find(r => r.id === id);
+  if (def?.core) return true;
   return !_disabledIds.has(id);
 }
 

package/app/lib/renderers/useRendererState.ts

@@ -0,0 +1,114 @@
+'use client';
+
+import { useSyncExternalStore, useCallback, useRef } from 'react';
+
+/**
+ * Unified per-file state hook for renderers.
+ *
+ * Each renderer stores its state under a namespaced localStorage key:
+ *   `mindos-renderer:{rendererId}:{filePath}`
+ *
+ * Usage:
+ *   const [cfg, setCfg] = useRendererState<CsvConfig>('csv', filePath, defaultCfg);
+ *
+ * The state is reactive — changes from other tabs/windows or from other
+ * components calling the setter will trigger a re-render via
+ * `useSyncExternalStore`.
+ */
+
+const CHANGE_EVENT = 'mindos-renderer-state-change';
+
+function storageKey(rendererId: string, filePath: string): string {
+  return `mindos-renderer:${rendererId}:${filePath}`;
+}
+
+export function useRendererState<T>(
+  rendererId: string,
+  filePath: string,
+  defaultValue: T,
+): [T, (value: T | ((prev: T) => T)) => void] {
+  const key = storageKey(rendererId, filePath);
+
+  // Cache parsed value to maintain referential stability for useSyncExternalStore.
+  // Without this, JSON.parse returns a new object on every getSnapshot call,
+  // causing Object.is to fail → infinite re-renders for non-primitive types.
+  const cacheRef = useRef<{ key: string; raw: string | null; parsed: T }>({ key, raw: null, parsed: defaultValue });
+
+  // Reset cache when key changes (different file or different renderer)
+  if (cacheRef.current.key !== key) {
+    cacheRef.current = { key, raw: null, parsed: defaultValue };
+  }
+
+  const state = useSyncExternalStore(
+    (onStoreChange) => {
+      const listener = () => onStoreChange();
+      window.addEventListener('storage', listener);
+      window.addEventListener(CHANGE_EVENT, listener);
+      return () => {
+        window.removeEventListener('storage', listener);
+        window.removeEventListener(CHANGE_EVENT, listener);
+      };
+    },
+    () => {
+      try {
+        const raw = localStorage.getItem(key);
+        if (raw === cacheRef.current.raw) return cacheRef.current.parsed;
+        if (raw === null) {
+          cacheRef.current = { key, raw: null, parsed: defaultValue };
+          return defaultValue;
+        }
+        const parsed = JSON.parse(raw) as T;
+        cacheRef.current = { key, raw, parsed };
+        return parsed;
+      } catch {
+        return defaultValue;
+      }
+    },
+    () => defaultValue,
+  );
+
+  const setState = useCallback(
+    (value: T | ((prev: T) => T)) => {
+      try {
+        const current = (() => {
+          try {
+            const raw = localStorage.getItem(key);
+            return raw !== null ? (JSON.parse(raw) as T) : defaultValue;
+          } catch {
+            return defaultValue;
+          }
+        })();
+        const next = typeof value === 'function' ? (value as (prev: T) => T)(current) : value;
+        const serialized = JSON.stringify(next);
+        localStorage.setItem(key, serialized);
+        // Update cache eagerly so the next getSnapshot returns stable ref
+        cacheRef.current = { key, raw: serialized, parsed: next };
+      } catch { /* ignore quota errors */ }
+      window.dispatchEvent(new Event(CHANGE_EVENT));
+    },
+    [key, defaultValue],
+  );
+
+  return [state, setState];
+}
+
+/**
+ * Non-hook helpers for reading/writing renderer state outside React components.
+ */
+export function getRendererState<T>(rendererId: string, filePath: string, defaultValue: T): T {
+  if (typeof window === 'undefined') return defaultValue;
+  try {
+    const raw = localStorage.getItem(storageKey(rendererId, filePath));
+    return raw !== null ? (JSON.parse(raw) as T) : defaultValue;
+  } catch {
+    return defaultValue;
+  }
+}
+
+export function setRendererState<T>(rendererId: string, filePath: string, value: T): void {
+  if (typeof window === 'undefined') return;
+  try {
+    localStorage.setItem(storageKey(rendererId, filePath), JSON.stringify(value));
+  } catch { /* ignore */ }
+  window.dispatchEvent(new Event(CHANGE_EVENT));
+}