@geminilight/mindos 0.5.21 → 0.5.23

package/app/lib/i18n-zh.ts

@@ -41,7 +41,7 @@ export const zh = {
     createToActivate: '创建 {file} 以启用此插件',
     shortcuts: {
       searchFiles: '搜索文件',
-      askAI: '问 AI',
+      askAI: 'MindOS Agent',
       editFile: '编辑文件',
       save: '保存',
       settings: '设置',
@@ -55,7 +55,7 @@ export const zh = {
   },
   sidebar: {
     searchTitle: '搜索 (⌘K)',
-    askTitle: '问 AI (⌘/)',
+    askTitle: 'MindOS Agent (⌘/)',
     settingsTitle: '设置 (⌘,)',
     collapseTitle: '收起侧栏',
     expandTitle: '展开侧栏',
@@ -129,7 +129,7 @@ export const zh = {
   },
   settings: {
     title: '设置',
-    tabs: { ai: 'AI', appearance: '外观', knowledge: '知识库', sync: '同步', mcp: 'MCP', plugins: '插件', shortcuts: '快捷键' },
+    tabs: { ai: 'AI', appearance: '外观', knowledge: '通用', sync: '同步', mcp: 'MCP & Skills', plugins: '插件', shortcuts: '快捷键', monitoring: '监控', agents: 'Agents' },
     ai: {
       provider: '服务商',
       model: '模型',
@@ -287,6 +287,49 @@ export const zh = {
       configureFor: '配置目标',
       configPath: '配置路径',
     },
+    monitoring: {
+      system: '系统',
+      heapMemory: '堆内存',
+      rss: 'RSS',
+      uptime: '运行时间',
+      nodeVersion: 'Node',
+      application: '应用',
+      requests: '请求数',
+      toolCalls: '工具调用',
+      avgResponse: '平均响应',
+      tokens: 'Token',
+      errors: '错误',
+      knowledgeBase: '知识库',
+      files: '文件数',
+      totalSize: '总大小',
+      rootPath: '根目录',
+      mcpStatus: '状态',
+      mcpRunning: '运行中',
+      mcpStopped: '已停止',
+      mcpPort: '端口',
+      autoRefresh: '每 5 秒自动刷新',
+      fetchError: '加载监控数据失败',
+    },
+    agents: {
+      mcpServer: 'MCP 服务器',
+      running: '运行中',
+      stopped: '未运行',
+      onPort: (port: number) => `端口 :${port}`,
+      refresh: '刷新',
+      refreshing: '刷新中...',
+      connected: '已连接',
+      connectedCount: (n: number) => `已连接 (${n})`,
+      detectedNotConfigured: '已检测未配置',
+      detectedCount: (n: number) => `已检测未配置 (${n})`,
+      notDetected: '未检测到',
+      notDetectedCount: (n: number) => `未检测到 (${n})`,
+      showAll: '显示全部',
+      hideAll: '收起',
+      connect: '连接',
+      noAgents: '本机未检测到任何 Agent。',
+      fetchError: '加载 Agent 数据失败',
+      autoRefresh: '每 30 秒自动刷新',
+    },
     save: '保存',
     saved: '已保存',
     saveFailed: '保存失败',
@@ -305,7 +348,7 @@ export const zh = {
   },
   shortcuts: [
     { keys: ['⌘', 'K'], description: '搜索' },
-    { keys: ['⌘', '/'], description: '问 AI' },
+    { keys: ['⌘', '/'], description: 'MindOS Agent' },
     { keys: ['⌘', ','], description: '设置' },
     { keys: ['E'], description: '编辑当前文件' },
     { keys: ['⌘', 'S'], description: '保存' },
@@ -450,7 +493,7 @@ export const zh = {
     welcomeTitle: '欢迎使用 MindOS！',
     welcomeDesc: '初始化完成。可以开始向 AI 提问、浏览知识库，或配置 MCP Agent。',
     welcomeLinkReconfigure: '重新配置',
-    welcomeLinkAskAI: '问 AI',
+    welcomeLinkAskAI: 'MindOS Agent',
     welcomeLinkMCP: 'MCP 设置',
   },
   guide: {

package/app/lib/metrics.ts

@@ -0,0 +1,81 @@
+/**
+ * In-memory metrics collector for MindOS runtime observability.
+ *
+ * Singleton — import { metrics } from '@/lib/metrics' in any server-side code.
+ * Data resets when the process restarts (no persistence needed).
+ */
+
+export interface MetricsSnapshot {
+  processStartTime: number;
+  agentRequests: number;
+  toolExecutions: number;
+  totalTokens: { input: number; output: number };
+  avgResponseTimeMs: number;
+  errors: number;
+}
+
+const MAX_RESPONSE_TIMES = 100;
+
+class MetricsCollector {
+  private processStartTime = Date.now();
+  private agentRequests = 0;
+  private toolExecutions = 0;
+  private totalTokens = { input: 0, output: 0 };
+  private responseTimes: number[] = [];
+  private errors = 0;
+
+  /** Record a completed agent request with its duration. */
+  recordRequest(durationMs: number): void {
+    this.agentRequests++;
+    this.responseTimes.push(durationMs);
+    if (this.responseTimes.length > MAX_RESPONSE_TIMES) {
+      this.responseTimes.shift();
+    }
+  }
+
+  /** Increment the tool execution counter. */
+  recordToolExecution(): void {
+    this.toolExecutions++;
+  }
+
+  /** Accumulate token usage. */
+  recordTokens(input: number, output: number): void {
+    this.totalTokens.input += input;
+    this.totalTokens.output += output;
+  }
+
+  /** Increment the error counter. */
+  recordError(): void {
+    this.errors++;
+  }
+
+  /** Return a read-only snapshot of all metrics. */
+  getSnapshot(): MetricsSnapshot {
+    const avg =
+      this.responseTimes.length > 0
+        ? Math.round(this.responseTimes.reduce((a, b) => a + b, 0) / this.responseTimes.length)
+        : 0;
+
+    return {
+      processStartTime: this.processStartTime,
+      agentRequests: this.agentRequests,
+      toolExecutions: this.toolExecutions,
+      totalTokens: { ...this.totalTokens },
+      avgResponseTimeMs: avg,
+      errors: this.errors,
+    };
+  }
+
+  /** Reset all counters (useful for testing). */
+  reset(): void {
+    this.processStartTime = Date.now();
+    this.agentRequests = 0;
+    this.toolExecutions = 0;
+    this.totalTokens = { input: 0, output: 0 };
+    this.responseTimes = [];
+    this.errors = 0;
+  }
+}
+
+/** Global singleton — shared across all requests in the same Node process. */
+export const metrics = new MetricsCollector();

package/app/next-env.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/types/routes.d.ts";
+import "./.next/dev/types/routes.d.ts";
 
 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/app/next.config.ts

@@ -3,7 +3,7 @@ import path from "path";
 
 const nextConfig: NextConfig = {
   transpilePackages: ['github-slugger'],
-  serverExternalPackages: ['pdfjs-dist', 'pdf-parse', 'chokidar'],
+  serverExternalPackages: ['pdfjs-dist', 'pdf-parse', 'chokidar', 'openai', '@mariozechner/pi-ai', '@mariozechner/pi-agent-core'],
   outputFileTracingRoot: path.join(__dirname),
   turbopack: {
     root: path.join(__dirname),

package/app/package.json

@@ -16,8 +16,8 @@
     "@codemirror/state": "^6.5.4",
     "@codemirror/theme-one-dark": "^6.1.3",
     "@codemirror/view": "^6.39.16",
-    "@mariozechner/pi-agent-core": "^0.60.0",
-    "@mariozechner/pi-ai": "^0.60.0",
+    "@mariozechner/pi-agent-core": "^0.61.0",
+    "@mariozechner/pi-ai": "^0.61.0",
     "@sinclair/typebox": "^0.34.33",
     "@tiptap/extension-image": "^3.20.1",
     "@tiptap/extension-link": "^3.20.1",

package/bin/cli.js

@@ -245,7 +245,7 @@ const commands = {
         // Do NOT call start() here — kickstart -k would kill the just-started process,
         // causing a port-conflict race condition with KeepAlive restart loops.
         console.log(dim('  (First run may take a few minutes to install dependencies and build the app.)'));
-        const ready = await waitForHttp(Number(webPort), { retries: 60, intervalMs: 2000, label: 'Web UI', logFile: LOG_PATH });
+        const ready = await waitForHttp(Number(webPort), { retries: 120, intervalMs: 2000, label: 'Web UI', logFile: LOG_PATH });
         if (!ready) {
           console.error(red('\n✘ Service started but Web UI did not become ready in time.'));
           console.error(dim('  Check logs with: mindos logs\n'));
@@ -271,36 +271,22 @@ const commands = {
     const webPort = process.env.MINDOS_WEB_PORT || '3456';
     const mcpPort = process.env.MINDOS_MCP_PORT || '8781';
 
-    // ── Auto-migrate skill rules (v3 split → v4 merged) ──────────────────
+    // ── Auto-migrate user-rules.md to root user-skill-rules.md ─────────────
     try {
       const cfg = JSON.parse(readFileSync(CONFIG_PATH, 'utf-8'));
       const mr = cfg.mindRoot;
       if (mr && existsSync(mr)) {
         const isZh = cfg.disabledSkills?.includes('mindos');
         const sName = isZh ? 'mindos-zh' : 'mindos';
-        const lang = isZh ? 'zh' : 'en';
         const sDir = resolve(mr, '.agents', 'skills', sName);
-        const merged = resolve(sDir, 'skill-rules.md');
-        const legacyRules = resolve(sDir, 'rules.md');
-        // Migrate if legacy exists but merged doesn't
-        if (existsSync(legacyRules) && !existsSync(merged)) {
-          const tpl = resolve(ROOT, 'templates', 'skill-rules', lang, 'skill-rules.md');
-          if (existsSync(tpl)) {
-            cpSync(tpl, merged);
-            for (const f of ['rules.md', 'patterns.md', 'proactive.md']) {
-              const p = resolve(sDir, f);
-              if (existsSync(p)) rmSync(p);
-            }
-            console.log(`  ${green('✓')} ${dim('Skill rules migrated to skill-rules.md')}`);
-          }
-        }
-        // Init if .agents/skills/ doesn't exist at all
-        if (!existsSync(sDir)) {
-          const srcDir = resolve(ROOT, 'templates', 'skill-rules', lang);
-          if (existsSync(srcDir)) {
-            mkdirSync(sDir, { recursive: true });
-            cpSync(srcDir, sDir, { recursive: true });
-            console.log(`  ${green('✓')} ${dim('Skill rules initialized')}`);
+        const rootUserRules = resolve(mr, 'user-skill-rules.md');
+
+        // Migrate: .agents/skills/{name}/user-rules.md → {mindRoot}/user-skill-rules.md
+        if (!existsSync(rootUserRules)) {
+          const oldUserRules = resolve(sDir, 'user-rules.md');
+          if (existsSync(oldUserRules)) {
+            cpSync(oldUserRules, rootUserRules);
+            console.log(`  ${green('✓')} ${dim('Migrated user-rules.md → user-skill-rules.md')}`);
           }
         }
       }
@@ -440,7 +426,6 @@ ${dim('Shortcut: mindos start --daemon  →  install + start in one step')}
 
   // ── init-skills ──────────────────────────────────────────────────────────
   'init-skills': async () => {
-    const force = process.argv.includes('--force');
     console.log(`\n${bold('📦 Initialize Skill Rules')}\n`);
 
     if (!existsSync(CONFIG_PATH)) {
@@ -460,56 +445,23 @@ ${dim('Shortcut: mindos start --daemon  →  install + start in one step')}
       process.exit(1);
     }
 
-    const isZh = config.disabledSkills?.includes('mindos');
-    const skillName = isZh ? 'mindos-zh' : 'mindos';
-    const lang = isZh ? 'zh' : 'en';
-    const skillDir = resolve(mindRoot, '.agents', 'skills', skillName);
-    const sourceDir = resolve(ROOT, 'templates', 'skill-rules', lang);
-
-    if (!existsSync(sourceDir)) {
-      console.log(`  ${red('✘')} Template not found: ${dim(sourceDir)}\n`);
-      process.exit(1);
-    }
-
-    const files = ['skill-rules.md', 'user-rules.md'];
-    mkdirSync(skillDir, { recursive: true });
-
-    let count = 0;
-    for (const file of files) {
-      const dest = resolve(skillDir, file);
-      const src = resolve(sourceDir, file);
-      if (!existsSync(src)) continue;
-
-      // Never overwrite user-rules.md even with --force
-      if (file === 'user-rules.md' && existsSync(dest)) {
-        console.log(`  ${dim('skip')}  ${file} (user rules preserved)`);
-        continue;
-      }
-
-      if (existsSync(dest) && !force) {
-        console.log(`  ${dim('skip')}  ${file} (already exists)`);
-        continue;
-      }
-
-      cpSync(src, dest);
-      console.log(`  ${green('✓')}  ${file}${force ? ' (reset)' : ''}`);
-      count++;
-    }
-
-    // Clean up legacy split files from v3
-    for (const legacy of ['rules.md', 'patterns.md', 'proactive.md']) {
-      const legacyPath = resolve(skillDir, legacy);
-      if (existsSync(legacyPath)) {
-        rmSync(legacyPath);
-        console.log(`  ${dim('cleanup')}  ${legacy} (merged into skill-rules.md)`);
-      }
-    }
-
-    if (count === 0) {
-      console.log(`\n  ${dim('All files already exist. Use --force to reset defaults (user-rules.md is always preserved).')}\n`);
+    // Skill operating rules are now built into SKILL.md (shipped with the app).
+    // This command only initializes user-skill-rules.md for personalization.
+    const dest = resolve(mindRoot, 'user-skill-rules.md');
+    if (existsSync(dest)) {
+      console.log(`  ${dim('skip')}  user-skill-rules.md (already exists)\n`);
     } else {
-      console.log(`\n  ${green('✔')} Skill rules initialized at ${dim(skillDir)}\n`);
+      const isZh = config.disabledSkills?.includes('mindos');
+      const lang = isZh ? 'zh' : 'en';
+      const src = resolve(ROOT, 'templates', 'skill-rules', lang, 'user-rules.md');
+      if (existsSync(src)) {
+        cpSync(src, dest);
+        console.log(`  ${green('✓')}  user-skill-rules.md created at ${dim(mindRoot)}\n`);
+      } else {
+        console.log(`  ${dim('skip')}  Template not found, create user-skill-rules.md manually if needed.\n`);
+      }
     }
+    console.log(`  ${dim('Note: Operating rules are now built into the app. No install needed.')}\n`);
   },
 
   // ── doctor ─────────────────────────────────────────────────────────────────
@@ -727,7 +679,7 @@ ${dim('Shortcut: mindos start --daemon  →  install + start in one step')}
       const webPort = updateConfig.port ?? 3456;
       const mcpPort = updateConfig.mcpPort ?? 8781;
       console.log(dim('  (Waiting for Web UI to come back up — first run after update includes a rebuild...)'));
-      const ready = await waitForHttp(Number(webPort), { retries: 60, intervalMs: 2000, label: 'Web UI', logFile: LOG_PATH });
+      const ready = await waitForHttp(Number(webPort), { retries: 120, intervalMs: 2000, label: 'Web UI', logFile: LOG_PATH });
       if (ready) {
         const localIP = getLocalIP();
         console.log(`\n${'─'.repeat(53)}`);
@@ -746,28 +698,6 @@ ${dim('Shortcut: mindos start --daemon  →  install + start in one step')}
       console.log(dim('  Run `mindos start` — it will rebuild automatically.'));
       console.log(`  ${dim('View changelog:')}  ${cyan('https://github.com/GeminiLight/MindOS/releases')}\n`);
     }
-
-    // ── Check if skill rules need updating ──────────────────────────────────
-    try {
-      const updateCfg = JSON.parse(readFileSync(CONFIG_PATH, 'utf-8'));
-      const mindRoot = updateCfg.mindRoot;
-      if (mindRoot && existsSync(mindRoot)) {
-        const isZh = updateCfg.disabledSkills?.includes('mindos');
-        const sName = isZh ? 'mindos-zh' : 'mindos';
-        const lang = isZh ? 'zh' : 'en';
-        const installedRules = resolve(mindRoot, '.agents', 'skills', sName, 'skill-rules.md');
-        const tplRules = resolve(ROOT, 'templates', 'skill-rules', lang, 'skill-rules.md');
-        if (existsSync(installedRules) && existsSync(tplRules)) {
-          const uVer = readFileSync(installedRules, 'utf-8').match(/<!--\s*version:\s*(\S+)\s*-->/)?.[1];
-          const tVer = readFileSync(tplRules, 'utf-8').match(/<!--\s*version:\s*(\S+)\s*-->/)?.[1];
-          if (uVer && tVer && uVer !== tVer) {
-            console.log(`  ${yellow('!')} Skill rules ${dim(uVer)} → ${bold(tVer)} available. Run ${cyan('mindos init-skills --force')} to update ${dim('(user-rules.md preserved)')}\n`);
-          }
-        } else if (!existsSync(resolve(mindRoot, '.agents', 'skills', sName))) {
-          console.log(`  ${dim('Tip:')} Run ${cyan('mindos init-skills')} to enable skill rules in your knowledge base.\n`);
-        }
-      }
-    } catch {}
   },
 
   // ── uninstall ──────────────────────────────────────────────────────────────
@@ -1212,7 +1142,7 @@ ${row('mindos gateway <subcommand>',       'Manage background service (install/u
 ${bold('Config & Diagnostics:')}
 ${row('mindos config <subcommand>',        'View/update config (show/validate/set/unset)')}
 ${row('mindos doctor',                     'Health check (config, ports, build, daemon)')}
-${row('mindos init-skills [--force]',       'Initialize skill rules in knowledge base')}
+${row('mindos init-skills',                 'Create user-skill-rules.md for personalization')}
 ${row('mindos update',                     'Update MindOS to the latest version')}
 ${row('mindos uninstall',                  'Fully uninstall MindOS (stop, remove daemon, npm uninstall)')}
 ${row('mindos logs',                       'Tail service logs (~/.mindos/mindos.log)')}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geminilight/mindos",
-  "version": "0.5.21",
+  "version": "0.5.23",
   "description": "MindOS — Human-Agent Collaborative Mind System. Local-first knowledge base that syncs your mind to all AI Agents via MCP.",
   "keywords": [
     "mindos",
@@ -57,7 +57,9 @@
     "!assets/images",
     "!mcp/node_modules",
     "!mcp/dist",
-    "!mcp/package-lock.json"
+    "!mcp/package-lock.json",
+    "!mcp/*.tgz",
+    "!app/package-lock.json"
   ],
   "scripts": {
     "setup": "node scripts/setup.js",

package/scripts/setup.js

@@ -1205,18 +1205,8 @@ async function main() {
   writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + '\n');
   console.log(`\n${c.green(t('cfgSaved'))}: ${c.dim(CONFIG_PATH)}`);
 
-  // ── Init skill rules in knowledge base ────────────────────────────────────
-  const skillName = selectedTemplate === 'zh' ? 'mindos-zh' : 'mindos';
-  const skillRulesDir = resolve(mindDir, '.agents', 'skills', skillName);
-  if (!existsSync(skillRulesDir)) {
-    const skillRulesLang = selectedTemplate === 'zh' ? 'zh' : 'en';
-    const skillRulesSource = resolve(ROOT, 'templates', 'skill-rules', skillRulesLang);
-    if (existsSync(skillRulesSource)) {
-      mkdirSync(skillRulesDir, { recursive: true });
-      cpSync(skillRulesSource, skillRulesDir, { recursive: true });
-      console.log(`${c.green('✓')} ${c.dim(`Skill rules initialized: ${skillRulesDir}`)}`);
-    }
-  }
+  // ── Skill rules are now built into SKILL.md — no install needed ──────────
+  // user-skill-rules.md will be created on first preference capture or via `mindos init-skills`.
 
   // ── Step 7: MCP Agent Install ──────────────────────────────────────────────
   write('\n');