@geminilight/mindos 0.5.0 → 0.5.2

package/scripts/setup.js

@@ -6,7 +6,7 @@
  * Usage: npm run setup  OR  mindos onboard
  *
  * Steps:
- *   1. Choose knowledge base path → default ~/MindOS
+ *   1. Choose knowledge base path → default ~/MindOS/mind (same as GUI)
  *   2. Choose template (en / zh / empty / custom) → copy to knowledge base path
  *   3. Choose ports (web + mcp) — checked for conflicts upfront
  *   4. Auth token (auto-generated or passphrase-seeded)
@@ -29,6 +29,8 @@ import { pipeline } from 'node:stream/promises';
 import { execSync, spawn } from 'node:child_process';
 import { randomBytes, createHash } from 'node:crypto';
 import { createConnection } from 'node:net';
+import http from 'node:http';
+import { MCP_AGENTS } from '../bin/lib/mcp-agents.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const ROOT = resolve(__dirname, '..');
@@ -39,21 +41,21 @@ const CONFIG_PATH = resolve(MINDOS_DIR, 'config.json');
 
 const T = {
   title:          { en: '🧠 MindOS Setup', zh: '🧠 MindOS 初始化' },
-  langHint:       { en: '  ← → switch language / 切换语言    ↑ ↓ navigate    Enter confirm', zh: '  ← → switch language / 切换语言    ↑ ↓ 上下切换    Enter 确认' },
+  langHint:       { en: '  ← → 切换中文    ↑ ↓ navigate    Enter confirm', zh: '  ← → switch to English    ↑ ↓ 上下切换    Enter 确认' },
 
   // mode selection
-  modePrompt:     { en: 'Setup mode', zh: '配置方式' },
-  modeOpts:       { en: ['CLI — terminal wizard', 'GUI — browser wizard (recommended)'], zh: ['CLI — 终端向导', 'GUI — 浏览器向导（推荐）'] },
+  modePrompt:     { en: 'How would you like to set up?', zh: '选择配置方式' },
+  modeOpts:       { en: ['Continue here in terminal (CLI)', 'Open browser to set up (recommended)'], zh: ['在终端继续配置（CLI）', '打开浏览器配置（推荐）'] },
   modeVals:       ['cli', 'gui'],
-  guiStarting:    { en: '⏳ Starting server for GUI setup...', zh: '⏳ 正在启动服务...' },
-  guiReady:       { en: (url) => `🌐 Complete setup in browser: ${url}`, zh: (url) => `🌐 在浏览器中完成配置: ${url}` },
+  guiStarting:    { en: '⏳ Starting MindOS, please wait...', zh: '⏳ 正在启动 MindOS，请稍候...' },
+  guiReady:       { en: (url) => `🌐 Opening setup in browser: ${url}`, zh: (url) => `🌐 在浏览器中打开配置页面: ${url}` },
   guiOpenFailed:  { en: (url) => `  Could not open browser automatically. Open this URL manually:\n  ${url}`, zh: (url) => `  无法自动打开浏览器，请手动访问：\n  ${url}` },
 
   // step labels
   step:           { en: (n, total) => `Step ${n}/${total}`, zh: (n, total) => `步骤 ${n}/${total}` },
   stepTitles:     {
-    en: ['Knowledge Base', 'Template', 'Ports', 'Auth Token', 'Web Password', 'AI Provider', 'Start Mode', 'Agent Tools'],
-    zh: ['知识库',         '模板',     '端口',   'Auth Token', 'Web 密码',     'AI 服务商',    '启动方式',    'Agent 工具'],
+    en: ['Knowledge Base', 'AI Provider', 'Ports', 'Auth Token', 'Web Password', 'Start Mode', 'Agent Tools'],
+    zh: ['知识库',         'AI 服务商',    '端口',   'Auth Token', 'Web 密码',     '启动方式',    'Agent 工具'],
   },
 
   // path
@@ -131,6 +133,11 @@ const T = {
   mcpInstallDone: { en: (n) => `✔ ${n} agent(s) configured`, zh: (n) => `✔ 已配置 ${n} 个 Agent` },
   mcpSkipped:     { en: '  → Skipped. Run `mindos mcp install` anytime to configure agents.', zh: '  → 已跳过。随时运行 `mindos mcp install` 配置 Agent。' },
 
+  // restart prompts (re-onboard with config changes)
+  restartRequired:   { en: 'Config changed. Service restart required.', zh: '配置已变更，需要重启服务。' },
+  restartNow:        { en: 'Restart now?', zh: '立即重启？' },
+  changesOnNextStart: { en: 'Changes will take effect on next start.', zh: '变更将在下次启动时生效。' },
+
   // next steps (onboard — keep it minimal, details shown on `mindos start`)
   nextSteps: {
     en: (cmd) => [
@@ -171,7 +178,26 @@ function write(s) { process.stdout.write(s); }
 
 // ── State ─────────────────────────────────────────────────────────────────────
 
-let uiLang = 'en';
+function detectSystemLang() {
+  // Check env vars first (Linux / macOS / WSL)
+  const vars = [
+    process.env.LANG,
+    process.env.LC_ALL,
+    process.env.LC_MESSAGES,
+    process.env.LANGUAGE,
+  ].filter(Boolean).join(' ').toLowerCase();
+  if (vars.includes('zh')) return 'zh';
+
+  // Fallback: Intl API (works on Windows where LANG is often unset)
+  try {
+    const locale = Intl.DateTimeFormat().resolvedOptions().locale;
+    if (locale.toLowerCase().startsWith('zh')) return 'zh';
+  } catch {}
+
+  return 'en';
+}
+
+let uiLang = detectSystemLang();
 const t = (key) => T[key]?.[uiLang] ?? T[key]?.en ?? '';
 const tf = (key, ...args) => {
   const v = T[key]?.[uiLang] ?? T[key]?.en;
@@ -180,7 +206,7 @@ const tf = (key, ...args) => {
 
 // ── Step header ───────────────────────────────────────────────────────────────
 
-const TOTAL_STEPS = 8;
+const TOTAL_STEPS = 7;
 function stepHeader(n) {
   const title = T.stepTitles[uiLang][n - 1] ?? T.stepTitles.en[n - 1];
   const stepLabel = tf('step', n, TOTAL_STEPS);
@@ -397,7 +423,7 @@ function isPortInUse(port) {
   return new Promise((resolve) => {
     const sock = createConnection({ port, host: '127.0.0.1' });
     const cleanup = (result) => { sock.destroy(); resolve(result); };
-    sock.setTimeout(500, () => cleanup(false));
+    sock.setTimeout(500, () => cleanup(true));
     sock.once('connect', () => cleanup(true));
     sock.once('error', (err) => {
       // ECONNREFUSED = nothing listening → free; other errors = treat as in-use
@@ -406,6 +432,25 @@ function isPortInUse(port) {
   });
 }
 
+async function isSelfPort(port) {
+  try {
+    return await new Promise((resolve) => {
+      const req = http.get(`http://127.0.0.1:${port}/api/health`, { timeout: 800 }, (res) => {
+        let body = '';
+        res.on('data', chunk => { body += chunk; });
+        res.on('end', () => {
+          try {
+            const data = JSON.parse(body);
+            resolve(data.service === 'mindos');
+          } catch { resolve(false); }
+        });
+      });
+      req.on('error', () => resolve(false));
+      req.on('timeout', () => { req.destroy(); resolve(false); });
+    });
+  } catch { return false; }
+}
+
 async function findFreePort(from) {
   for (let p = from; p <= 65535; p++) {
     if (!await isPortInUse(p)) return p;
@@ -414,7 +459,15 @@ async function findFreePort(from) {
 }
 
 async function askPort(labelKey, defaultPort) {
-  let port = await findFreePort(defaultPort);
+  let port = defaultPort;
+  // If the default port is in use, check if it's our own service (self = ok to keep)
+  if (await isPortInUse(port)) {
+    if (await isSelfPort(port)) {
+      // Already running on this port — keep it as default
+    } else {
+      port = await findFreePort(port + 1);
+    }
+  }
   while (true) {
     const input = (await askText(labelKey, String(port))).trim();
     const parsed = parseInt(input, 10);
@@ -423,6 +476,10 @@ async function askPort(labelKey, defaultPort) {
       continue;
     }
     if (await isPortInUse(parsed)) {
+      // Check if it's our own service — acceptable to keep
+      if (await isSelfPort(parsed)) {
+        return parsed;
+      }
       const next = await findFreePort(parsed + 1);
       write(c.yellow(tf('portInUse', parsed) + '\n'));
       port = next;
@@ -518,19 +575,7 @@ async function applyTemplate(tpl, mindDir) {
   }
 }
 
-// ── MCP Agent definitions (mirrors bin/lib/mcp-install.js) ───────────────────
-
-const MCP_AGENTS_SETUP = {
-  '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' },
-};
+// MCP_AGENTS imported from bin/lib/mcp-agents.js
 
 function expandHomePath(p) {
   return p.startsWith('~/') ? resolve(homedir(), p.slice(2)) : p;
@@ -538,7 +583,7 @@ function expandHomePath(p) {
 
 /** Detect if an agent already has mindos configured (for pre-selection). */
 function isAgentInstalled(agentKey) {
-  const agent = MCP_AGENTS_SETUP[agentKey];
+  const agent = MCP_AGENTS[agentKey];
   if (!agent) return false;
   for (const cfgPath of [agent.global, agent.project]) {
     if (!cfgPath) continue;
@@ -558,13 +603,13 @@ function isAgentInstalled(agentKey) {
  * because this script uses its own raw-mode helpers).
  */
 async function runMcpInstallStep(mcpPort, authToken) {
-  const keys = Object.keys(MCP_AGENTS_SETUP);
+  const keys = Object.keys(MCP_AGENTS);
 
   // Build options with installed status shown as hint
   const options = keys.map(k => {
     const installed = isAgentInstalled(k);
     return {
-      label: MCP_AGENTS_SETUP[k].name,
+      label: MCP_AGENTS[k].name,
       hint:  installed ? (uiLang === 'zh' ? '已安装' : 'installed') : (uiLang === 'zh' ? '未安装' : 'not installed'),
       value: k,
       preselect: installed,
@@ -636,7 +681,7 @@ async function runMcpInstallStep(mcpPort, authToken) {
   let okCount = 0;
 
   for (const agentKey of selected) {
-    const agent = MCP_AGENTS_SETUP[agentKey];
+    const agent = MCP_AGENTS[agentKey];
     // prefer global scope; fall back to project
     const cfgPath = agent.global || agent.project;
     if (!cfgPath) {
@@ -778,7 +823,7 @@ async function main() {
       const existingMode     = existing.startMode || 'start';
       const existingMcpPort  = existing.mcpPort   || 8787;
       const existingAuth     = existing.authToken || '';
-      const existingMindRoot = existing.mindRoot  || resolve(MINDOS_DIR, 'my-mind');
+      const existingMindRoot = existing.mindRoot  || resolve(homedir(), 'MindOS', 'mind');
       console.log(`\n${c.green(t('cfgKept'))}  ${c.dim(CONFIG_PATH)}`);
       write(c.dim(t('cfgKeptNote') + '\n'));
       const installDaemon = process.argv.includes('--install-daemon');
@@ -790,12 +835,23 @@ async function main() {
   // ── Step 1: Knowledge base path ───────────────────────────────────────────
   stepHeader(1);
 
+  // Resume: read existing config to offer current values as defaults
+  let resumeCfg = {};
+  try { resumeCfg = JSON.parse(readFileSync(CONFIG_PATH, 'utf-8')); } catch { /* first run */ }
+
   const { readdirSync } = await import('node:fs');
   let mindDir;
 
+  // Default KB path: existing mindRoot if set, otherwise ~/MindOS (same as GUI default)
+  const HOME = homedir();
+  const kbDefault = resumeCfg.mindRoot || resolve(HOME, 'MindOS', 'mind');
+
   while (true) {
-    const input = (await askText('pathPrompt', 'my-mind', 'pathHintInline', MINDOS_DIR)).trim();
-    const resolved = input.startsWith('/') ? input : resolve(MINDOS_DIR, input);
+    const input = (await askText('pathPrompt', kbDefault)).trim();
+    // If absolute path entered, use as-is; if relative (no leading /), resolve from home
+    const resolved = input.startsWith('/') || input.startsWith('~/')
+      ? (input.startsWith('~/') ? resolve(HOME, input.slice(2)) : input)
+      : resolve(HOME, input);
     write(tf('pathResolved', resolved) + '\n');
     mindDir = resolved;
 
@@ -817,9 +873,8 @@ async function main() {
       if (choice === 'reselect') { write('\n'); continue; }
       break;
     } else {
-      // ── Step 2: Template ────────────────────────────────────────────────
+      // ── Template selection (part of Step 1) ─────────────────────────────
       write('\n');
-      stepHeader(2);
       const tpl = await select('tplPrompt', 'tplOptions', 'tplValues');
       mkdirSync(mindDir, { recursive: true });
       await applyTemplate(tpl, mindDir);
@@ -827,60 +882,27 @@ async function main() {
     }
   }
 
-  // ── Step 3: Ports ─────────────────────────────────────────────────────────
+  // ── Step 2: AI Provider + API Key ─────────────────────────────────────────
   write('\n');
-  stepHeader(3);
-  let webPort, mcpPort;
-  while (true) {
-    webPort = await askPort('webPortPrompt', 3000);
-    mcpPort = await askPort('mcpPortPrompt', webPort === 8787 ? 8788 : 8787);
-    if (webPort !== mcpPort) break;
-    write(c.yellow(`  ⚠ ${uiLang === 'zh' ? 'Web 端口和 MCP 端口不能相同，请重新选择' : 'Web port and MCP port must be different — please choose again'}\n`));
-  }
-
-  // ── Step 4: Auth token ────────────────────────────────────────────────────
-  write('\n');
-  stepHeader(4);
-  const authSeed = await askText('authPrompt');
-  const authToken = generateToken(authSeed);
-  console.log(`${c.green(t('tokenGenerated'))}: ${c.cyan(authToken)}`);
-
-  // ── Step 5: Web UI password ───────────────────────────────────────────────
-  write('\n');
-  stepHeader(5);
-  let webPassword = '';
-  while (true) {
-    webPassword = await askText('webPassPrompt');
-    if (webPassword) break;
-    write(c.yellow(t('webPassWarn') + '\n'));
-    const confirmed = await askYesNo('webPassSkip');
-    if (confirmed) break;
-  }
-
-  // ── Step 6: AI Provider + API Key ─────────────────────────────────────────
-  write('\n');
-  stepHeader(6);
+  stepHeader(2);
 
   const provider = await select('providerPrompt', 'providerOpts', 'providerVals');
   const isSkip = provider === 'skip';
   const isAnthropic = provider === 'anthropic';
 
-  // preserve existing provider configs
+  // preserve existing provider configs (use resumeCfg already read at top of main)
   let existingProviders = {
     anthropic: { apiKey: '', model: 'claude-sonnet-4-6' },
     openai:    { apiKey: '', model: 'gpt-5.4', baseUrl: '' },
   };
   let existingAiProvider = 'anthropic';
-  try {
-    const existing = JSON.parse(readFileSync(CONFIG_PATH, 'utf-8'));
-    if (existing.ai?.providers) {
-      existingProviders = { ...existingProviders, ...existing.ai.providers };
-    } else if (existing.ai?.anthropicApiKey) {
-      existingProviders.anthropic = { apiKey: existing.ai.anthropicApiKey || '', model: existing.ai.anthropicModel || 'claude-sonnet-4-6' };
-      existingProviders.openai    = { apiKey: existing.ai.openaiApiKey || '', model: existing.ai.openaiModel || 'gpt-5.4', baseUrl: existing.ai.openaiBaseUrl || '' };
-    }
-    if (existing.ai?.provider) existingAiProvider = existing.ai.provider;
-  } catch { /* ignore */ }
+  if (resumeCfg.ai?.providers) {
+    existingProviders = { ...existingProviders, ...resumeCfg.ai.providers };
+  } else if (resumeCfg.ai?.anthropicApiKey) {
+    existingProviders.anthropic = { apiKey: resumeCfg.ai.anthropicApiKey || '', model: resumeCfg.ai.anthropicModel || 'claude-sonnet-4-6' };
+    existingProviders.openai    = { apiKey: resumeCfg.ai.openaiApiKey || '', model: resumeCfg.ai.openaiModel || 'gpt-5.4', baseUrl: resumeCfg.ai.openaiBaseUrl || '' };
+  }
+  if (resumeCfg.ai?.provider) existingAiProvider = resumeCfg.ai.provider;
 
   if (isSkip) {
     write(c.dim(t('providerSkip') + '\n'));
@@ -905,9 +927,69 @@ async function main() {
     }
   }
 
-  // ── Step 7: Start Mode ──────────────────────────────────────────────────
+  // ── Step 3: Ports ─────────────────────────────────────────────────────────
   write('\n');
-  stepHeader(7);
+  stepHeader(3);
+  const existingCfg = resumeCfg;
+  const defaultWebPort = typeof existingCfg.port === 'number' ? existingCfg.port : 3000;
+  const defaultMcpPort = typeof existingCfg.mcpPort === 'number' ? existingCfg.mcpPort : (defaultWebPort === 8787 ? 8788 : 8787);
+  let webPort, mcpPort;
+  while (true) {
+    webPort = await askPort('webPortPrompt', defaultWebPort);
+    mcpPort = await askPort('mcpPortPrompt', defaultMcpPort);
+    if (webPort !== mcpPort) break;
+    write(c.yellow(`  ⚠ ${uiLang === 'zh' ? 'Web 端口和 MCP 端口不能相同，请重新选择' : 'Web port and MCP port must be different — please choose again'}\n`));
+  }
+
+  // ── Step 4: Auth token ────────────────────────────────────────────────────
+  write('\n');
+  stepHeader(4);
+  // Resume: if config already has a token, offer it as the default (Enter = keep)
+  const existingToken = existingCfg.authToken || '';
+  let authToken;
+  if (existingToken) {
+    const masked = existingToken.length > 8 ? existingToken.slice(0, 8) + '····' : existingToken;
+    write(c.dim(`  ${uiLang === 'zh' ? '现有 token：' : 'Current token:'} ${c.cyan(masked)}\n`));
+    const keepToken = await askYesNoDefault('cfgConfirm');
+    if (keepToken) {
+      authToken = existingToken;
+      console.log(`${c.green(t('tokenGenerated'))}: ${c.cyan(existingToken.slice(0, 8) + '····')}`);
+    } else {
+      const authSeed = await askText('authPrompt');
+      authToken = generateToken(authSeed);
+      console.log(`${c.green(t('tokenGenerated'))}: ${c.cyan(authToken)}`);
+    }
+  } else {
+    const authSeed = await askText('authPrompt');
+    authToken = generateToken(authSeed);
+    console.log(`${c.green(t('tokenGenerated'))}: ${c.cyan(authToken)}`);
+  }
+
+  // ── Step 5: Web UI password ───────────────────────────────────────────────
+  write('\n');
+  stepHeader(5);
+  let webPassword = '';
+  const existingPassword = existingCfg.webPassword || '';
+  if (existingPassword) {
+    write(c.dim(`  ${uiLang === 'zh' ? '已设置密码（Enter 保留）' : 'Password is set (Enter to keep)'}\n`));
+    const keepPass = await askYesNoDefault('cfgConfirm');
+    if (keepPass) {
+      webPassword = existingPassword;
+    }
+  }
+  if (!webPassword) {
+    while (true) {
+      webPassword = await askText('webPassPrompt');
+      if (webPassword) break;
+      write(c.yellow(t('webPassWarn') + '\n'));
+      const confirmed = await askYesNo('webPassSkip');
+      if (confirmed) break;
+    }
+  }
+
+  // ── Step 6: Start Mode ──────────────────────────────────────────────────
+  write('\n');
+  stepHeader(6);
 
   let startMode = 'start';
   const daemonPlatform = process.platform === 'darwin' || process.platform === 'linux';
@@ -952,13 +1034,22 @@ async function main() {
     process.exit(0);
   }
 
+  const isResuming = Object.keys(resumeCfg).length > 0;
+  const needsRestart = isResuming && (
+    config.port        !== (resumeCfg.port        ?? 3000) ||
+    config.mcpPort     !== (resumeCfg.mcpPort     ?? 8787) ||
+    config.mindRoot    !== (resumeCfg.mindRoot     ?? '')   ||
+    config.authToken   !== (resumeCfg.authToken   ?? '')   ||
+    config.webPassword !== (resumeCfg.webPassword ?? '')
+  );
+
   mkdirSync(MINDOS_DIR, { recursive: true });
   writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + '\n');
   console.log(`\n${c.green(t('cfgSaved'))}: ${c.dim(CONFIG_PATH)}`);
 
-  // ── Step 8: MCP Agent Install ──────────────────────────────────────────────
+  // ── Step 7: MCP Agent Install ──────────────────────────────────────────────
   write('\n');
-  stepHeader(8);
+  stepHeader(7);
   write(c.dim(tf('mcpStepHint') + '\n\n'));
 
   await runMcpInstallStep(mcpPort, authToken);
@@ -973,7 +1064,7 @@ async function main() {
   }
 
   const installDaemon = startMode === 'daemon' || process.argv.includes('--install-daemon');
-  finish(mindDir, config.startMode, config.mcpPort, config.authToken, installDaemon);
+  finish(mindDir, config.startMode, config.mcpPort, config.authToken, installDaemon, needsRestart, resumeCfg.port ?? 3000);
 }
 
 function getLocalIP() {
@@ -985,7 +1076,25 @@ function getLocalIP() {
   return null;
 }
 
-async function finish(mindDir, startMode = 'start', mcpPort = 8787, authToken = '', installDaemon = false) {
+async function finish(mindDir, startMode = 'start', mcpPort = 8787, authToken = '', installDaemon = false, needsRestart = false, oldPort = 3000) {
+  if (needsRestart) {
+    const isRunning = await isSelfPort(oldPort);
+    if (isRunning) {
+      write(c.yellow(t('restartRequired') + '\n'));
+      const doRestart = await askYesNoDefault('restartNow');
+      if (doRestart) {
+        const cliPath = resolve(__dirname, '../bin/cli.js');
+        execSync(`node "${cliPath}" start`, { stdio: 'inherit' });
+      } else {
+        write(c.dim(t('restartManual') + '\n'));
+      }
+      return;
+    } else {
+      write(c.dim(t('changesOnNextStart') + '\n'));
+      // fall through to normal Start now? prompt
+    }
+  }
+
   const startCmd = installDaemon ? 'mindos start --daemon' : (startMode === 'dev' ? 'mindos dev' : 'mindos start');
   const lines = T.nextSteps[uiLang](startCmd);
   console.log('');
@@ -993,13 +1102,13 @@ async function finish(mindDir, startMode = 'start', mcpPort = 8787, authToken =
 
   const doStart = await askYesNoDefault('startNow');
   if (doStart) {
-    const { execSync } = await import('node:child_process');
+    const { execSync: exec } = await import('node:child_process');
     const cliPath = resolve(__dirname, '../bin/cli.js');
     if (installDaemon) {
       // Install and start as background service — returns immediately
-      execSync(`node "${cliPath}" start --daemon`, { stdio: 'inherit' });
+      exec(`node "${cliPath}" start --daemon`, { stdio: 'inherit' });
     } else {
-      execSync(`node "${cliPath}" ${startMode}`, { stdio: 'inherit' });
+      exec(`node "${cliPath}" ${startMode}`, { stdio: 'inherit' });
     }
   }
 }

package/skills/human-insights/SKILL.md

@@ -0,0 +1,143 @@
+---
+name: human-insights
+description: "捕捉、记录和提炼人机协作过程中产生的隐性知识，存入项目 human-insights/ 目录。当用户说「记录下这个发现」「这个方法很有效，存一下」「回顾下我们的协作」「总结下 SOP」「这个 AI 总是犯这个错」「把这个变成规则」「整理下 insights」「提炼下规律」「升华到 CLAUDE.md」时使用此 Skill。对话中出现值得沉淀的协作模式、认知升级、反模式时也应触发。"
+---
+
+# Human Insights Skill
+
+捕捉人机协作中产生的隐性知识，让它不随对话消失，并定期提炼为可复用的 SOP。
+
+核心设计原则：**零摩擦**。记录的成本越低，记录的频率越高，积累的价值越大。所有让用户需要思考"怎么配合"的设计都是反模式。
+
+---
+
+## 核心理念
+
+insights 不是终点，是 CLAUDE.md 的原材料。生命周期：
+
+```
+对话碎片 → 捕捉 → human-insights/ → 定期回顾提炼 → CLAUDE.md / Skill
+```
+
+已升华进 CLAUDE.md 的 insight 标记为 `[已采纳]`，避免重复处理。
+
+---
+
+## 三种模式
+
+### 模式一：捕捉（用户主动触发）
+
+用户说"记录下这个"、"这个很有用"时触发。
+
+1. 理解内容 — 读懂要记录什么，必要时追问一句
+2. **AI 判断分类**，用户不需要选（见下方分类体系）
+3. 检查目标文件，避免重复记录
+4. 写入，自动填写时间，来源一句话
+5. 告知用户记录到了哪里
+
+### 模式二：主动提议（AI 识别信号）
+
+对话中出现以下信号时，AI 在回答完后顺带问一句"这个发现值得记进 human-insights，要我记一下吗？"
+
+**值得提议的信号（需同时满足：有新意 + 可复用）：**
+- 用户明确纠正了 AI 的错误认知或行为模式
+- 用户发现某个做法比之前的方式明显更高效，且说清楚了为什么
+- 对话中归纳出了一条可以跨场景复用的规律或原则
+
+**不需要提议的情况：**
+- 只是某个任务执行得顺利（不代表有可复用的模式）
+- 用户已经在说"记一下"（模式一已覆盖）
+- 同一对话中已经提议过一次（避免反复打断）
+
+用户说"好"/"记一下"即执行，说"不用"则跳过。不打断主流程，轻量提议。
+
+### 模式三：回顾提炼（定期整理）
+
+用户说"回顾下协作"、"总结 SOP"、"升华到 CLAUDE.md" 时触发。
+
+1. 读取 `human-insights/` 下所有文件，统计各类别条目数和"待提炼"数量
+2. 识别模式 — 找出：① 反复出现的主题 ② 相互印证的发现 ③ 已有足够证据支撑的规律
+3. 起草提炼结果，每条产出明确其形态：
+   - **规则**：适合写进 CLAUDE.md 的行为约束（"做 X 之前先做 Y"）
+   - **流程**：可复用的步骤序列（适合写成 Skill 或 CLAUDE.md 流程节）
+   - **Prompt 模板**：可直接复用的指令结构
+4. 展示给用户确认，用户可修改或拒绝某条
+5. 写入 CLAUDE.md 对应章节，原 insight 标记 `[已采纳 → CLAUDE.md #章节名]`
+6. 更新 `README.md` 各文件摘要
+
+---
+
+## 分类体系（AI 判断，用户无感）
+
+| 类别 | 文件 | 记录什么 |
+|------|------|---------|
+| Prompt 模式 | `prompt-patterns.md` | 有效的提问方式、指令结构、上下文给法 |
+| 工作流发现 | `workflow.md` | 有效的协作流程、任务拆分方式、节奏把握 |
+| AI 行为规律 | `ai-behavior.md` | AI 在特定场景下的规律性表现、容易犯的错 |
+| 认知升级 | `mindset.md` | 对某个概念/方法的新理解，之前认知被纠正 |
+| 反模式 | `anti-patterns.md` | 踩过的坑、低效做法、应该避免的模式 |
+
+一条 insight 可以属于多个类别时，以最主要的类别为准写入一个文件，不重复写入。
+
+---
+
+## 记录格式
+
+轻量为主，自动填时间，来源一句话够了：
+
+```markdown
+## <标题>
+
+**时间：** YYYY-MM-DD  **来源：** <一句话场景，如"MindOS CLAUDE.md 整理中">
+
+<发现了什么、为什么有价值、怎么用。1-3 句话。>
+
+**状态：** 待提炼 / [已采纳 → CLAUDE.md #章节名]
+```
+
+---
+
+## 目录结构
+
+```
+human-insights/
+├── README.md           # 索引 + 各文件一句话摘要（只列已创建的文件）
+├── prompt-patterns.md
+├── workflow.md
+├── ai-behavior.md
+├── mindset.md
+└── anti-patterns.md
+```
+
+首次使用时只创建 `README.md` 和当前需要写入的文件，其余按需创建。
+
+---
+
+## 初始化
+
+`human-insights/` 不存在时自动创建目录和 `README.md`：
+
+```markdown
+# Human Insights
+
+记录人机协作过程中产生的隐性知识，定期提炼为可复用的 SOP。
+
+## 文件索引
+
+（按需添加，创建新文件时同步更新此表）
+
+| 文件 | 摘要 |
+|------|------|
+
+## 升华路径
+
+积累 → 回顾提炼 → 写入 CLAUDE.md → 标记 [已采纳]
+```
+
+---
+
+## 边界说明
+
+- vs `wiki/80-known-pitfalls.md`：pitfalls 记客观技术坑（别人也会踩），insights 记主观协作发现（你个人的认知）
+- vs `wiki/06-conventions.md`：conventions 是已确定的规范，insights 是还在验证中的发现
+- vs `CLAUDE.md`：CLAUDE.md 是已固化的规则，insights 是原材料

package/skills/mindos/SKILL.md

@@ -1,14 +1,15 @@
 ---
 name: mindos
 description: >
-  MindOS knowledge base operation guide for agent tasks on local markdown/csv knowledge bases.
-  Use proactively whenever work touches note files, SOP/workflow docs, profile/context docs,
-  CSV tables, knowledge-base organization, cross-agent handoff, or decision sync through MindOS MCP tools.
-  Trigger on requests like "update notes", "search knowledge base", "organize files", "execute SOP",
+  MindOS knowledge base operation guide, only for agent tasks on files inside the MindOS knowledge base (mindRoot path).
+  Trigger only when the target files are inside the MindOS knowledge base directory.
+  Typical requests: "update notes", "search knowledge base", "organize files", "execute SOP",
   "review with our standards", "handoff to another agent", "sync decisions", "append CSV",
   "retrospective", "distill this conversation", "capture key learnings", "update related docs adaptively",
-  "route this to the right files", "update everything related", "sync this across my knowledge base",
-  and generally any local knowledge-maintenance workflow even if the user does not explicitly mention MindOS.
+  "route this to the right files", "update everything related", "sync this across my knowledge base".
+  Do NOT trigger when: the target is a local code repository file (e.g. /code/xxx/wiki/*.md),
+  the user provides an absolute path that is not under MindOS mindRoot,
+  or the task involves modifying project source code or project documentation.
 ---
 
 # MindOS Knowledge Base Operation Guide