@geminilight/mindos 0.6.53 → 0.6.54

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

@@ -52,6 +52,10 @@ export const knowledgeEn = {
     showMore: 'Show more',
     showLess: 'Show less',
     viewAll: 'View all',
+    wikiTagline: 'Your knowledge spaces, organized.',
+    sortRecent: 'Recent',
+    sortName: 'A-Z',
+    sortCount: 'File Count',
     createToActivate: 'Create {file} to activate',
     shortcuts: {
       searchFiles: 'Search files',
@@ -95,6 +99,8 @@ export const knowledgeEn = {
     organizing: 'Organizing...',
     viewAll: 'View all',
     more: (n: number) => `${n} more`,
+    viewAllFiles: (n: number) => `View all ${n} files in Inbox`,
+    viewAllHistory: (n: number) => `View all ${n} records →`,
     agingHint: '7+ days',
     savedToast: (n: number) => `${n} file${n === 1 ? '' : 's'} saved to Capture`,
     savedWithSkipped: (saved: number, skipped: number) =>
@@ -324,8 +330,17 @@ export const knowledgeEn = {
   importHistory: {
     title: 'Import History',
     clearAll: 'Clear history',
+    clearConfirm: 'Clear all history? This cannot be undone.',
     emptyTitle: 'No import history yet',
     emptyDesc: 'AI organize results will appear here',
+    back: '← Back',
+    sourceLabel: 'Source',
+    changesCount: (ok: number, total: number) => `${ok}/${total} changes`,
+    recordCount: (n: number) => `${n} record${n !== 1 ? 's' : ''}`,
+    today: 'Today',
+    yesterday: 'Yesterday',
+    older: 'Older',
+    processedArchive: 'Processed files are archived in Inbox/.processed/',
   },
   dirView: {
     gridView: 'Grid view',
@@ -415,6 +430,10 @@ export const knowledgeZh = {
     showMore: '查看更多',
     showLess: '收起',
     viewAll: '查看全部',
+    wikiTagline: '你的知识空间，井然有序。',
+    sortRecent: '最近',
+    sortName: '字母序',
+    sortCount: '文件数',
     createToActivate: '创建 {file} 以启用',
     shortcuts: {
       searchFiles: '搜索文件',
@@ -458,6 +477,8 @@ export const knowledgeZh = {
     organizing: '整理中...',
     viewAll: '查看全部',
     more: (n: number) => `还有 ${n} 个`,
+    viewAllFiles: (n: number) => `查看 Inbox 中全部 ${n} 个文件`,
+    viewAllHistory: (n: number) => `查看全部 ${n} 条记录 →`,
     agingHint: '7天+',
     savedToast: (n: number) => `${n} 个文件已保存到暂存台`,
     savedWithSkipped: (saved: number, skipped: number) =>
@@ -687,8 +708,17 @@ export const knowledgeZh = {
   importHistory: {
     title: '导入历史',
     clearAll: '清空历史',
+    clearConfirm: '清空所有历史记录？此操作不可撤销。',
     emptyTitle: '暂无导入记录',
     emptyDesc: 'AI 整理的结果会出现在这里',
+    back: '← 返回',
+    sourceLabel: '来源',
+    changesCount: (ok: number, total: number) => `${ok}/${total} 处变更`,
+    recordCount: (n: number) => `${n} 条记录`,
+    today: '今天',
+    yesterday: '昨天',
+    older: '更早',
+    processedArchive: '已处理的文件归档在 Inbox/.processed/ 中',
   },
   dirView: {
     gridView: '网格视图',

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

@@ -2,7 +2,7 @@
 
 export const navigationEn = {
   sidebar: {
-    files: 'Spaces',
+    files: 'Wiki',
     search: 'Search',
     searchTitle: 'Search',
     askTitle: 'MindOS Agent',
@@ -26,6 +26,7 @@ export const navigationEn = {
     newFile: 'New file',
     newSpace: 'New Space',
     more: 'More',
+    capture: 'Capture',
     showHiddenFiles: 'Show hidden files',
     sync: {
       synced: 'Synced',
@@ -80,7 +81,7 @@ export const navigationEn = {
 
 export const navigationZh = {
   sidebar: {
-    files: '空间',
+    files: '知识库',
     search: '搜索',
     searchTitle: '搜索',
     askTitle: 'MindOS Agent',
@@ -104,6 +105,7 @@ export const navigationZh = {
     newFile: '新建文件',
     newSpace: '新建空间',
     more: '更多',
+    capture: '暂存台',
     showHiddenFiles: '显示隐藏文件',
     sync: {
       synced: '已同步',

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

@@ -88,8 +88,15 @@ export const panelsEn = {
       a2aDelegationFailed: 'Failed',
       a2aDelegationPending: 'Pending',
       // ACP / Network tab
-      acpSectionTitle: 'ACP Agents',
-      acpSectionDesc: (n: number) => `${n} agent${n !== 1 ? 's' : ''} available`,
+      acpSectionTitle: 'Installed Agents',
+      acpSectionDesc: (n: number) => `${n} agent${n !== 1 ? 's' : ''} detected`,
+      acpNoInstalled: 'No coding agents detected. Install one to delegate tasks directly from MindOS.',
+      acpAvailableTitle: 'Available in Registry',
+      acpAvailableDesc: (n: number) => `${n} more agent${n !== 1 ? 's' : ''} available`,
+      acpShowAvailable: 'Show',
+      acpHideAvailable: 'Hide',
+      acpCopyCmd: 'Copy',
+      acpCopied: 'Copied',
       acpTransportNpx: 'npx',
       acpTransportBinary: 'binary',
       acpTransportUvx: 'uvx',
@@ -380,6 +387,8 @@ export const panelsEn = {
       reconnectAllRunning: 'Reconnecting...',
       reconnectAllDone: (ok: number, failed: number) => `Done: ${ok} reconnected${failed > 0 ? `, ${failed} failed` : ''}.`,
       serverTransport: (t: string) => `Transport: ${t}`,
+      mcpDisabledMessage: 'MCP mode is not enabled.',
+      mcpDisabledHint: 'Enable it in Settings → Connections to use MCP agents.',
     },
     skills: {
       title: 'Skills',
@@ -715,8 +724,15 @@ export const panelsZh = {
       a2aDelegationFailed: '失败',
       a2aDelegationPending: '进行中',
       // ACP / Network tab
-      acpSectionTitle: 'ACP 智能体',
-      acpSectionDesc: (n: number) => `${n} 个智能体可用`,
+      acpSectionTitle: '已安装智能体',
+      acpSectionDesc: (n: number) => `已检测到 ${n} 个智能体`,
+      acpNoInstalled: '未检测到编程智能体。安装一个即可在 MindOS 中直接委派任务。',
+      acpAvailableTitle: '注册表中可用',
+      acpAvailableDesc: (n: number) => `还有 ${n} 个智能体可安装`,
+      acpShowAvailable: '展开',
+      acpHideAvailable: '收起',
+      acpCopyCmd: '复制',
+      acpCopied: '已复制',
       acpTransportNpx: 'npx',
       acpTransportBinary: '二进制',
       acpTransportUvx: 'uvx',
@@ -1007,6 +1023,8 @@ export const panelsZh = {
       reconnectAllRunning: '正在重连...',
       reconnectAllDone: (ok: number, failed: number) => `完成：${ok} 已重连${failed > 0 ? `，${failed} 失败` : ''}。`,
       serverTransport: (t: string) => `传输：${t}`,
+      mcpDisabledMessage: 'MCP 模式未启用。',
+      mcpDisabledHint: '请在设置 → 连接中启用，以使用 MCP 智能体。',
     },
     skills: {
       title: '技能',

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

@@ -193,6 +193,19 @@ export const settingsEn = {
       comingSoon: 'Plugin marketplace coming soon.',
     },
     mcp: {
+      // Connection Mode Card
+      modeCardTitle: 'Connection Mode',
+      modeCardDesc: 'Choose how agents connect to MindOS.',
+      cliLabel: 'CLI',
+      cliModeDesc: 'Claude Code, Gemini CLI, Codex, etc.',
+      mcpLabel: 'MCP',
+      mcpModeDesc: 'Claude Desktop, Cursor, Windsurf, etc.',
+      alwaysOn: 'Always On',
+      mcpRunning: 'Running',
+      mcpStopped: 'Stopped',
+      mcpEnabledHint: 'MCP mode enabled. Disable to simplify the interface if you only use CLI agents.',
+      mcpDisabledHint: 'Enable MCP to connect Desktop clients like Claude Desktop or Cursor.',
+      // Rest of existing MCP section...
       serverTitle: 'MindOS MCP Server',
       status: 'Status',
       running: 'Running',
@@ -637,6 +650,19 @@ export const settingsZh = {
       comingSoon: '插件市场即将上线。',
     },
     mcp: {
+      // 连接模式卡片
+      modeCardTitle: '连接模式',
+      modeCardDesc: '选择 Agent 如何连接到 MindOS。',
+      cliLabel: 'CLI',
+      cliModeDesc: 'Claude Code、Gemini CLI、Codex 等。',
+      mcpLabel: 'MCP',
+      mcpModeDesc: 'Claude Desktop、Cursor、Windsurf 等。',
+      alwaysOn: '始终开启',
+      mcpRunning: '运行中',
+      mcpStopped: '已停止',
+      mcpEnabledHint: 'MCP 模式已启用。若仅使用 CLI Agent，可禁用此项以简化界面。',
+      mcpDisabledHint: '启用 MCP 以连接 Claude Desktop 或 Cursor 等桌面客户端。',
+      // 其余 MCP 配置...
       serverTitle: 'MindOS MCP 服务',
       status: '状态',
       running: '运行中',

package/app/lib/organize-history.ts

@@ -12,6 +12,8 @@ export interface OrganizeHistoryFile {
   undone?: boolean;
 }
 
+export type OrganizeSource = 'upload' | 'drag-drop' | 'inbox-organize' | 'import-modal' | 'plugin' | 'web-clipper';
+
 export interface OrganizeHistoryEntry {
   id: string;
   /** Unix ms */
@@ -20,6 +22,10 @@ export interface OrganizeHistoryEntry {
   sourceFiles: string[];
   files: OrganizeHistoryFile[];
   status: 'completed' | 'partial' | 'undone';
+  /** How the files were ingested */
+  source?: OrganizeSource;
+  /** Processing time in milliseconds */
+  durationMs?: number;
 }
 
 const STORAGE_KEY = 'mindos:organize-history';

package/app/lib/renderers/index.ts

@@ -4,17 +4,21 @@
  */
 import { registerRenderer } from './registry';
 import { manifest as agentInspector } from '@/components/renderers/agent-inspector/manifest';
+import { manifest as audio } from '@/components/renderers/audio/manifest';
 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 image } from '@/components/renderers/image/manifest';
+import { manifest as pdf } from '@/components/renderers/pdf/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 video } from '@/components/renderers/video/manifest';
 import { manifest as workflowYaml } from '@/components/renderers/workflow-yaml/manifest';
 import { manifest as graph } from '@/components/renderers/graph/manifest';
 
 const manifests = [
-  agentInspector, backlinks, config, csv, summary, timeline, todo, workflowYaml, graph,
+  agentInspector, audio, backlinks, config, csv, image, pdf, summary, timeline, todo, video, workflowYaml, graph,
 ];
 
 for (const m of manifests) {

package/app/lib/settings.ts

@@ -53,6 +53,11 @@ export interface ServerSettings {
   acpAgents?: Record<string, import('./acp/agent-descriptors').AcpAgentOverride>;
   /** Proxy compatibility cache: keyed by baseUrl, value is detected mode. */
   baseUrlCompat?: Record<string, 'streaming' | 'non-streaming'>;
+  /** User's connection mode preference: CLI always on, MCP is optional */
+  connectionMode?: {
+    cli: boolean;   // Always true (CLI is mandatory)
+    mcp: boolean;   // User's explicit choice during onboarding
+  };
 }
 
 const DEFAULTS: ServerSettings = {
@@ -164,6 +169,26 @@ function parseGuideState(raw: unknown): GuideState | undefined {
   };
 }
 
+/** Infer connectionMode from old config.
+ *  Old configs don't have connectionMode — both CLI and MCP were always available.
+ *  So we default to { cli: true, mcp: true } for existing users to avoid breaking change. */
+function inferConnectionMode(parsed: Record<string, unknown>): { cli: boolean; mcp: boolean } {
+  // If already has explicit connectionMode, return it
+  if (parsed.connectionMode && typeof parsed.connectionMode === 'object') {
+    const obj = parsed.connectionMode as Record<string, unknown>;
+    if (typeof obj.cli === 'boolean' && typeof obj.mcp === 'boolean') {
+      return { cli: obj.cli, mcp: obj.mcp };
+    }
+  }
+  // Old config without connectionMode: default to both enabled (backwards-compat)
+  // Only fresh installs (setupPending=true or missing config) get mcp: false
+  const isNewInstall = parsed.setupPending === true || !parsed.mindRoot;
+  return {
+    cli: true,
+    mcp: !isNewInstall, // Existing users keep MCP, new users start with CLI-only
+  };
+}
+
 export function readSettings(): ServerSettings {
   try {
     const raw = fs.readFileSync(SETTINGS_PATH, 'utf-8');
@@ -190,6 +215,7 @@ export function readSettings(): ServerSettings {
         }
         return Object.keys(result).length > 0 ? result : undefined;
       })(),
+      connectionMode: inferConnectionMode(parsed),
     };
   } catch {
     // Config file missing or corrupt → force setup wizard
@@ -197,6 +223,7 @@ export function readSettings(): ServerSettings {
       ...DEFAULTS,
       ai: { ...DEFAULTS.ai, providers: { ...DEFAULTS.ai.providers } },
       setupPending: true,
+      connectionMode: { cli: true, mcp: false },
     };
   }
 }
@@ -218,6 +245,7 @@ export function writeSettings(settings: ServerSettings): void {
   if (settings.guideState !== undefined) merged.guideState = settings.guideState;
   if (settings.acpAgents !== undefined) merged.acpAgents = settings.acpAgents;
   if (settings.baseUrlCompat !== undefined) merged.baseUrlCompat = settings.baseUrlCompat;
+  if (settings.connectionMode !== undefined) merged.connectionMode = settings.connectionMode;
   // setupPending: false/undefined → remove the field (cleanup); true → set it
   if ('setupPending' in settings) {
     if (settings.setupPending) merged.setupPending = true;

package/bin/commands/doctor.js

@@ -5,12 +5,13 @@
 
 import { execSync } from 'node:child_process';
 import { existsSync, readFileSync } from 'node:fs';
-import { resolve } from 'node:path';
+import { resolve, delimiter } from 'node:path';
 import { homedir } from 'node:os';
 import { CONFIG_PATH, ROOT } from '../lib/constants.js';
 import { bold, dim, cyan, green, red, yellow } from '../lib/colors.js';
 import { isPortInUse } from '../lib/port.js';
 import { EXIT } from '../lib/command.js';
+import { stripBom } from '../lib/jsonc.js';
 
 export const meta = {
   name: 'doctor',
@@ -45,7 +46,7 @@ export const run = async (_args, flags) => {
   }
   let config;
   try {
-    config = JSON.parse(readFileSync(CONFIG_PATH, 'utf-8'));
+    config = JSON.parse(stripBom(readFileSync(CONFIG_PATH, 'utf-8')));
     ok(`Config file found and valid JSON  ${dim(CONFIG_PATH)}`, 'config');
   } catch {
     err(`Config file exists but failed to parse  ${dim(CONFIG_PATH)}`, 'config');
@@ -58,7 +59,7 @@ export const run = async (_args, flags) => {
     if (!mindRoot) {
       err('Config missing required field: mindRoot');
       hasError = true;
-    } else if (!existsSync(mindRoot.replace(/^~/, homedir()))) {
+    } else if (!existsSync(mindRoot === '~' ? homedir() : mindRoot.replace(/^~[/\\]/, homedir() + '/'))) {
       warn(`mindRoot path does not exist: ${dim(mindRoot)}  (will be created on first start)`);
     } else {
       ok(`Knowledge base path exists  ${dim(mindRoot)}`);
@@ -100,14 +101,19 @@ export const run = async (_args, flags) => {
     ok(`npm ${npmVersion} reachable`);
   } catch {
     err('npm not found in PATH — app dependencies cannot be installed');
-    console.log(dim('     Node.js may be installed via nvm/fnm/volta and not visible to /bin/sh.'));
-    console.log(dim('     Fix: add your Node.js bin path to ~/.profile so non-interactive shells can find it.'));
+    if (process.platform === 'win32') {
+      console.log(dim('     Ensure Node.js is installed and its bin directory is in your system PATH.'));
+      console.log(dim('     Fix: reinstall Node.js from https://nodejs.org (the installer adds it to PATH).'));
+    } else {
+      console.log(dim('     Node.js may be installed via nvm/fnm/volta and not visible to /bin/sh.'));
+      console.log(dim('     Fix: add your Node.js bin path to ~/.profile so non-interactive shells can find it.'));
+    }
     hasError = true;
   }
 
   // 4c. ~/.mindos/bin in PATH (CLI shim)
   const mindosBin = resolve(homedir(), '.mindos', 'bin');
-  const pathDirs = (process.env.PATH || '').split(':');
+  const pathDirs = (process.env.PATH || '').split(delimiter);
   if (pathDirs.some(d => d === mindosBin || d === '$HOME/.mindos/bin' || d === '~/.mindos/bin')) {
     ok(`~/.mindos/bin is in PATH`);
   } else {

package/bin/commands/file.js

@@ -7,7 +7,7 @@
  */
 
 import { existsSync, readFileSync, writeFileSync, appendFileSync, unlinkSync, renameSync, mkdirSync, readdirSync, statSync, openSync, readSync, closeSync } from 'node:fs';
-import { resolve, basename, dirname, relative } from 'node:path';
+import { resolve, basename, dirname, relative, sep } from 'node:path';
 import { execFileSync } from 'node:child_process';
 import { bold, dim, cyan, green, red, yellow } from '../lib/colors.js';
 import { loadConfig } from '../lib/config.js';
@@ -28,9 +28,12 @@ function getMindRoot() {
 
 function resolvePath(root, filePath) {
   const resolved = resolve(root, filePath);
-  if (resolved !== root && !resolved.startsWith(root + '/')) {
-    console.error(red(`Access denied: path outside knowledge base`));
-    process.exit(EXIT.ERROR);
+  if (resolved !== root) {
+    const rel = relative(root, resolved);
+    if (rel === '..' || rel.startsWith(`..${sep}`) || rel.startsWith('../')) {
+      console.error(red(`Access denied: path outside knowledge base`));
+      process.exit(EXIT.ERROR);
+    }
   }
   return resolved;
 }

package/bin/commands/logs.js

@@ -1,9 +1,8 @@
 /**
- * mindos logs — Tail service logs
+ * mindos logs — Tail service logs (cross-platform, no external tools)
  */
 
-import { execSync } from 'node:child_process';
-import { existsSync } from 'node:fs';
+import { existsSync, readFileSync, statSync, watch as fsWatch, openSync, readSync, closeSync } from 'node:fs';
 import { LOG_PATH } from '../lib/constants.js';
 import { dim } from '../lib/colors.js';
 
@@ -17,6 +16,38 @@ export const meta = {
   ],
 };
 
+function tailLines(filePath, count) {
+  const content = readFileSync(filePath, 'utf-8');
+  const lines = content.split('\n');
+  return lines.slice(-count).join('\n');
+}
+
+function followFile(filePath) {
+  let size = statSync(filePath).size;
+
+  const readNew = () => {
+    let newSize;
+    try { newSize = statSync(filePath).size; } catch { return; }
+    if (newSize <= size) { size = newSize; return; }
+    const fd = openSync(filePath, 'r');
+    try {
+      const buf = Buffer.alloc(newSize - size);
+      readSync(fd, buf, 0, buf.length, size);
+      process.stdout.write(buf.toString('utf-8'));
+    } finally {
+      closeSync(fd);
+    }
+    size = newSize;
+  };
+
+  const watcher = fsWatch(filePath, { persistent: true }, readNew);
+  // Also poll as a fallback — fs.watch is unreliable on some network/VM mounts
+  const interval = setInterval(readNew, 1000);
+
+  process.on('SIGINT', () => { watcher.close(); clearInterval(interval); process.exit(0); });
+  process.on('SIGTERM', () => { watcher.close(); clearInterval(interval); process.exit(0); });
+}
+
 export const run = async (args, flags) => {
   const { ensureMindosDir } = await import('../lib/gateway.js');
   await ensureMindosDir();
@@ -28,5 +59,9 @@ export const run = async (args, flags) => {
   }
 
   const noFollow = flags['no-follow'] === true;
-  execSync(noFollow ? `tail -n 100 ${LOG_PATH}` : `tail -f ${LOG_PATH}`, { stdio: 'inherit' });
+  console.log(tailLines(LOG_PATH, 100));
+
+  if (!noFollow) {
+    followFile(LOG_PATH);
+  }
 };

package/bin/commands/onboard.js

@@ -21,5 +21,5 @@ export const meta = {
 
 export const run = (args, flags) => {
   const daemonFlag = flags['install-daemon'] ? ' --install-daemon' : '';
-  execInherited(`node ${resolve(ROOT, 'scripts/setup.js')}${daemonFlag}`);
+  execInherited(`node "${resolve(ROOT, 'scripts/setup.js')}"${daemonFlag}`);
 };

package/bin/commands/open.js

@@ -33,7 +33,12 @@ export const run = () => {
   }
 
   try {
-    execSync(`${cmd} ${url}`, { stdio: 'ignore' });
+    if (process.platform === 'win32') {
+      // Windows `start` treats the first quoted arg as a window title
+      execSync(`start "" "${url}"`, { stdio: 'ignore' });
+    } else {
+      execSync(`${cmd} ${url}`, { stdio: 'ignore' });
+    }
     console.log(`${green('✔')} Opening ${cyan(url)}`);
   } catch {
     console.log(dim(`Could not open browser automatically. Visit: ${cyan(url)}`));

package/bin/commands/space.js

@@ -7,7 +7,7 @@
  */
 
 import { existsSync, readdirSync, statSync, mkdirSync, writeFileSync, rmSync, renameSync } from 'node:fs';
-import { resolve, basename } from 'node:path';
+import { resolve, basename, relative, sep } from 'node:path';
 import { bold, dim, cyan, green, red, yellow } from '../lib/colors.js';
 import { loadConfig } from '../lib/config.js';
 import { output, isJsonMode, EXIT } from '../lib/command.js';
@@ -93,9 +93,12 @@ function countFiles(dir) {
 
 function resolvePath(root, relPath) {
   const full = relPath ? resolve(root, relPath) : root;
-  if (full !== root && !full.startsWith(root + '/')) {
-    console.error(red(`Access denied: path outside knowledge base`));
-    process.exit(EXIT.ERROR);
+  if (full !== root) {
+    const rel = relative(root, full);
+    if (rel === '..' || rel.startsWith(`..${sep}`) || rel.startsWith('../')) {
+      console.error(red(`Access denied: path outside knowledge base`));
+      process.exit(EXIT.ERROR);
+    }
   }
   if (!existsSync(full)) {
     console.error(red(`Not found: ${relPath || '(root)'}`));

package/bin/commands/update.js

@@ -5,7 +5,7 @@
  */
 
 import { execSync, spawn as nodeSpawn } from 'node:child_process';
-import { existsSync, readFileSync, writeFileSync, rmSync } from 'node:fs';
+import { existsSync, readFileSync, writeFileSync, rmSync, realpathSync } from 'node:fs';
 import { dirname, resolve } from 'node:path';
 
 import { ROOT, BUILD_STAMP, CONFIG_PATH, LOG_PATH } from '../lib/constants.js';
@@ -16,6 +16,7 @@ import { stopMindos } from '../lib/stop.js';
 import { getLocalIP } from '../lib/startup.js';
 import { isPortInUse } from '../lib/port.js';
 import { cleanEnvForRestart } from '../lib/clean-env.js';
+import { stripBom } from '../lib/jsonc.js';
 
 /**
  * Dynamically resolve the new ROOT after `npm install -g`.
@@ -23,27 +24,16 @@ import { cleanEnvForRestart } from '../lib/clean-env.js';
  */
 function getUpdatedRoot() {
   try {
-    const mindosBin = execSync('which mindos', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'] }).trim();
+    const whichCmd = process.platform === 'win32' ? 'where mindos' : 'which mindos';
+    const mindosBin = execSync(whichCmd, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'] }).trim().split(/\r?\n/)[0];
     if (mindosBin) {
-      // mindos bin is usually at <root>/bin/cli.js or a symlink to it
       let cliPath;
-      try {
-        cliPath = execSync(`readlink -f "${mindosBin}"`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'] }).trim();
-      } catch {
-        try {
-          cliPath = execSync(`realpath "${mindosBin}"`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'] }).trim();
-        } catch {
-          cliPath = mindosBin;
-        }
-      }
+      try { cliPath = realpathSync(mindosBin); } catch { cliPath = mindosBin; }
       if (cliPath) {
-        // cliPath is like /path/to/node_modules/@geminilight/mindos/bin/cli.js
-        // ROOT is /path/to/node_modules/@geminilight/mindos
         return resolve(dirname(cliPath), '..');
       }
     }
   } catch {}
-  // Fallback to static ROOT
   return ROOT;
 }
 
@@ -85,7 +75,7 @@ function buildIfNeeded(newRoot) {
   }
   const nextDir = resolve(newRoot, 'app', '.next');
   if (existsSync(nextDir)) {
-    execInherited(`rm -rf "${nextDir}"`, newRoot);
+    rmSync(nextDir, { recursive: true, force: true });
   }
   execInherited('node scripts/gen-renderer-index.js', newRoot);
   execInherited(`${newNextBin} build`, resolve(newRoot, 'app'));
@@ -176,7 +166,7 @@ export const run = async () => {
     writeUpdateStatus('restarting', vOpts);
     await gateway.runGatewayCommand('install');
     const updateConfig = (() => {
-      try { return JSON.parse(readFileSync(CONFIG_PATH, 'utf-8')); } catch { return {}; }
+      try { return JSON.parse(stripBom(readFileSync(CONFIG_PATH, 'utf-8'))); } catch { return {}; }
     })();
     const webPort = updateConfig.port ?? 3456;
     const mcpPort = updateConfig.mcpPort ?? 8781;
@@ -205,7 +195,7 @@ export const run = async () => {
     // (e.g. user started via `mindos start`, or GUI triggered this update).
     // If so, stop it and restart from the NEW installation path.
     const updateConfig = (() => {
-      try { return JSON.parse(readFileSync(CONFIG_PATH, 'utf-8')); } catch { return {}; }
+      try { return JSON.parse(stripBom(readFileSync(CONFIG_PATH, 'utf-8'))); } catch { return {}; }
     })();
     const webPort = Number(updateConfig.port ?? 3456);
     const mcpPort = Number(updateConfig.mcpPort ?? 8781);

package/bin/lib/build.js

@@ -118,13 +118,19 @@ export function ensureAppDeps({ force = false } = {}) {
   } catch {
     console.error(red('\n\u2718 npm not found in PATH.\n'));
     console.error('  MindOS needs npm to install its app dependencies on first run.');
-    console.error('  This usually means Node.js is installed via a version manager (nvm, fnm, volta, etc.)');
-    console.error('  that only loads in interactive shells, but not in /bin/sh.\n');
-    console.error('  Fix: add your Node.js bin directory to a profile that /bin/sh reads (~/.profile).');
-    console.error('  Example:');
-    console.error(dim('    echo \'export PATH="$HOME/.nvm/versions/node/$(node --version)/bin:$PATH"\' >> ~/.profile'));
-    console.error(dim('    source ~/.profile\n'));
-    console.error('  Then run `mindos start` again.\n');
+    if (process.platform === 'win32') {
+      console.error('  Ensure Node.js is installed and added to your system PATH.\n');
+      console.error('  Fix: reinstall Node.js from https://nodejs.org (the installer adds it to PATH).');
+      console.error('  Then open a new terminal and run `mindos start` again.\n');
+    } else {
+      console.error('  This usually means Node.js is installed via a version manager (nvm, fnm, volta, etc.)');
+      console.error('  that only loads in interactive shells, but not in /bin/sh.\n');
+      console.error('  Fix: add your Node.js bin directory to a profile that /bin/sh reads (~/.profile).');
+      console.error('  Example:');
+      console.error(dim('    echo \'export PATH="$HOME/.nvm/versions/node/$(node --version)/bin:$PATH"\' >> ~/.profile'));
+      console.error(dim('    source ~/.profile\n'));
+      console.error('  Then run `mindos start` again.\n');
+    }
     process.exit(1);
   }
 
@@ -142,7 +148,12 @@ export function ensureAppDeps({ force = false } = {}) {
     run('npm install --no-workspaces', resolve(ROOT, 'app'));
     if (!verifyDeps()) {
       console.error(red('\n✘ Failed to install dependencies after retry.\n'));
-      console.error('  Try manually: cd ' + resolve(ROOT, 'app') + ' && rm -rf node_modules && npm install');
+      const appDir = resolve(ROOT, 'app');
+      if (process.platform === 'win32') {
+        console.error(`  Try manually: cd "${appDir}" && rmdir /s /q node_modules && npm install`);
+      } else {
+        console.error(`  Try manually: cd ${appDir} && rm -rf node_modules && npm install`);
+      }
       process.exit(1);
     }
   }