@geminilight/mindos 0.6.34 → 0.6.36

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

@@ -95,21 +95,12 @@ description: >
 | 列出顶层心智空间 | `mindos_list_spaces` | 只需分区概览却拉整棵 `list_files` |
 | 找文件 | `mindos_search_notes`（2-4 条并行关键词变体）| 单关键词搜索 |
 | 读内容 | `mindos_read_file` 或 `mindos_read_lines`（大文件） | 只需 10 行却读整文件 |
-| 小范围文字修改 | `mindos_update_section` / `update_lines` / `insert_after_heading` | 小修改用 `write_file` |
-| 追加到末尾 | `mindos_append_to_file` | 为了加一行重写整文件 |
-| 整文件替换 | `mindos_write_file` | 用它做章节级编辑 |
-| 新建文件 | `mindos_create_file` | 自动创建父目录，但不会生成空间脚手架文件 |
-| 新建心智空间（目录 + README + INSTRUCTION）| `mindos_create_space` | 创建空间的唯一方式。`create_file` 只创建普通目录 |
-| 重命名空间目录 | `mindos_rename_space` | `rename_file`（仅文件，不能重命名文件夹）|
-| 追加 CSV | `mindos_append_csv`（校验表头）| 手动拼字符串不校验 |
-| 重命名前查影响 | `mindos_get_backlinks` | 不查引用就重命名 |
-| 查看近期变动 | `mindos_get_recent` | 猜最近改了什么 |
-| 恢复历史版本 | `mindos_get_file_at_version` | 让用户回忆之前内容 |
+
+写入、结构变更、历史工具 → [references/write-supplement.md](./references/write-supplement.md)。
 
 ### 回退
 
 - `mindos_bootstrap` 不可用 → 手动读根 `INSTRUCTION.md` + `README.md`。
-- 行级/章节级工具不可用 → 读 + 受限 `mindos_write_file`（模拟最小修改）。
 - 搜索无结果 → 不放弃：(1) 扫上下文中的树；(2) 直接读候选文件；(3) `mindos_list_files` 细化子目录；(4) 用同义词/中英文变体重试。
 
 ---
@@ -119,15 +110,6 @@ description: >
 | 模式 | 适用场景 | 关键步骤 |
 |------|----------|----------|
 | **只读问答** | 查找 / 总结 / 引用 | 目录树推断 → 搜索 → 读取 → 标注来源 → 明确说信息缺口 |
-| **单文件编辑** | 目标文件明确 | 启动协议 → 读目标 + 局部约定 → 最小修改 → 验证 → 总结 |
-| **多文件路由** | 非结构化输入，多个目的地 | 解析为语义单元 → 路由表 → 确认 → 编辑 → 汇总 |
-| **对话复盘** | 提炼 / 沉淀会话 | 确认范围 → 抽取决策/踩坑/下一步 → 路由 → 记录变更 |
-| **SOP 执行** | 可重复流程 | 完整读 SOP → 分步执行 → 更新过时段落 → 偏差则提议更新 |
-| **结构变更** | 重命名 / 移动 / 删除 | `get_backlinks` → 影响报告 → 确认 → 执行 → 更新引用 → 同步 README |
-| **CSV 追加** | 追加表格行 | 读表头 → 校验字段 → `mindos_append_csv` |
-| **跨 Agent 接力** | 继续其他 Agent 的工作 | 读任务状态+决策 → 无需重新探索直接接续 → 回写进度 |
-| **周期性回顾** | 汇总近期变动 | `get_recent`/`get_history` → 读变动文件 → 结构化总结 |
-| **交接文档** | 创建简报 | 读来源 → 合成（背景、决策、状态、待办）→ 放项目目录 |
 
 写入模式详细执行步骤 → [references/write-supplement.md](./references/write-supplement.md)。
 

package/app/lib/acp/subprocess.ts

@@ -451,14 +451,15 @@ export function installAutoApproval(acpProc: AcpProcess): () => void {
 
       // ── Permission requests (auto-approve all) ──
       case 'session/request_permission': {
-        console.log(`[ACP] Auto-approving permission: ${JSON.stringify(params.toolCall ?? {}).slice(0, 200)}`);
+        // Auto-approve in production; log in dev for debugging
+        if (process.env.NODE_ENV === 'development') console.log(`[ACP] Auto-approving permission: ${JSON.stringify(params.toolCall ?? {}).slice(0, 200)}`);
         sendResponse(acpProc, req.id, { outcome: { selected: { optionId: 'allow_once' } } });
         return;
       }
 
       // ── Unknown methods: auto-approve for backwards compat ──
       default: {
-        console.log(`[ACP] Auto-approving unknown agent request: ${method} (id=${req.id})`);
+        if (process.env.NODE_ENV === 'development') console.log(`[ACP] Auto-approving unknown agent request: ${method} (id=${req.id})`);
         sendResponse(acpProc, req.id, {});
       }
     }

package/app/lib/agent/context.ts

@@ -9,6 +9,15 @@ import type { AgentMessage } from '@mariozechner/pi-agent-core';
 import type { ToolResultMessage, AssistantMessage, UserMessage } from '@mariozechner/pi-ai';
 import { countCjkChars } from '@/lib/core/cjk';
 
+const DEV = process.env.NODE_ENV === 'development';
+
+// AgentMessage is opaque; cast to access role/content at runtime.
+interface AgentMessageFields {
+  role: string;
+  content: string | Array<{ type: string; text?: string }>;
+}
+function asMsg(m: AgentMessage): AgentMessageFields { return m as unknown as AgentMessageFields; }
+
 // ---------------------------------------------------------------------------
 // Token estimation — CJK-aware (CJK ~1.5 tokens/char, ASCII ~0.25 tokens/char)
 // ---------------------------------------------------------------------------
@@ -28,7 +37,7 @@ export function estimateStringTokens(text: string): number {
 /** Rough token count for a single AgentMessage */
 function messageTokens(msg: AgentMessage): number {
   if ('content' in msg) {
-    const content = (msg as any).content;
+    const content = asMsg(msg).content;
     if (typeof content === 'string') return estimateStringTokens(content);
     if (Array.isArray(content)) {
       let tokens = 0;
@@ -121,11 +130,11 @@ export function truncateToolOutputs(messages: AgentMessage[]): AgentMessage[] {
   // Find the index of the last 'toolResult' role message
   let lastToolIdx = -1;
   for (let i = messages.length - 1; i >= 0; i--) {
-    if ((messages[i] as any).role === 'toolResult') { lastToolIdx = i; break; }
+    if (asMsg(messages[i]).role === 'toolResult') { lastToolIdx = i; break; }
   }
 
   return messages.map((msg, idx) => {
-    const m = msg as any;
+    const m = asMsg(msg);
     if (m.role !== 'toolResult' || idx === lastToolIdx) return msg;
 
     const toolMsg = m as ToolResultMessage;
@@ -160,7 +169,7 @@ Be concise and factual. Output only the summary, no preamble.`;
 
 /** Extract a short text representation from an AgentMessage for summarization */
 function messageToText(m: AgentMessage): string {
-  const msg = m as any;
+  const msg = asMsg(m);
   const role = msg.role;
   let content = '';
 
@@ -202,7 +211,7 @@ export async function compactMessages(
   // Adjust split point to avoid cutting between an assistant (with tool calls)
   // and its tool result.
   let splitIdx = messages.length - 6;
-  while (splitIdx > 0 && (messages[splitIdx] as any).role === 'toolResult') {
+  while (splitIdx > 0 && asMsg(messages[splitIdx]).role === 'toolResult') {
     splitIdx--;
   }
   if (splitIdx < 2) {
@@ -230,17 +239,17 @@ export async function compactMessages(
 
     const summaryText = summaryMessage.content
       .filter(p => p.type === 'text')
-      .map(p => (p as any).text)
+      .map(p => (p as { text?: string }).text)
       .join('');
 
-    console.log(`[ask] Compacted ${earlyMessages.length} early messages into summary (${summaryText.length} chars)`);
+    if (DEV) console.log(`[ask] Compacted ${earlyMessages.length} early messages into summary (${summaryText.length} chars)`);
 
     const summaryContent = `[System Note: Older conversation history has been truncated due to context length limits, but here is an AI-generated summary of what was discussed so far.]\n\n${summaryText}`;
 
     // If first recent message is also 'user', merge summary into it to avoid
     // consecutive user messages (Anthropic rejects user→user sequences).
-    if ((recentMessages[0] as any)?.role === 'user') {
-      const merged = { ...(recentMessages[0] as any) };
+    if (asMsg(recentMessages[0])?.role === 'user') {
+      const merged = { ...asMsg(recentMessages[0]) } as AgentMessageFields;
       if (typeof merged.content === 'string') {
         merged.content = `${summaryContent}\n\n---\n\n${merged.content}`;
       } else if (Array.isArray(merged.content)) {
@@ -270,7 +279,7 @@ export async function compactMessages(
     console.warn('[ask] Compact failed, applying hard prune as fallback:', err);
     const pruned = hardPrune(messages, systemPrompt, modelName);
     if (pruned.length < messages.length) {
-      console.log(`[ask] Hard prune fallback succeeded (${messages.length} → ${pruned.length} messages)`);
+      if (DEV) console.log(`[ask] Hard prune fallback succeeded (${messages.length} → ${pruned.length} messages)`);
       return { messages: pruned, compacted: false };
     }
     // If pruning also can't help, let it bubble up so request fails safely
@@ -307,28 +316,28 @@ export function hardPrune(
   }
 
   // Ensure we don't cut between an assistant (with tool calls) and its tool result.
-  while (cutIdx < messages.length - 1 && (messages[cutIdx] as any).role === 'toolResult') {
+  while (cutIdx < messages.length - 1 && asMsg(messages[cutIdx]).role === 'toolResult') {
     total -= messageTokens(messages[cutIdx]);
     cutIdx++;
   }
 
   // Ensure first message is 'user' (Anthropic requirement)
-  while (cutIdx < messages.length - 1 && (messages[cutIdx] as any).role !== 'user') {
+  while (cutIdx < messages.length - 1 && asMsg(messages[cutIdx]).role !== 'user') {
     total -= messageTokens(messages[cutIdx]);
     cutIdx++;
   }
 
   // Fallback: if no user message found in remaining messages, inject a synthetic one
   const pruned = cutIdx > 0 ? messages.slice(cutIdx) : messages;
-  if (pruned.length > 0 && (pruned[0] as any).role !== 'user') {
-    console.log(`[ask] Hard pruned ${cutIdx} messages, injecting synthetic user message (${messages.length} → ${pruned.length + 1})`);
+  if (pruned.length > 0 && asMsg(pruned[0]).role !== 'user') {
+    if (DEV) console.log(`[ask] Hard pruned ${cutIdx} messages, injecting synthetic user message (${messages.length} → ${pruned.length + 1})`);
     const syntheticUser: UserMessage = {
       role: 'user',
       content: '[System Note: Older conversation history has been truncated due to context length limits. The user may refer to things you can no longer see. If so, kindly ask them to repeat the context.]',
       timestamp: Date.now(),
     };
     return [syntheticUser as AgentMessage, ...pruned];
-  } else if (cutIdx > 0 && pruned.length > 0 && (pruned[0] as any).role === 'user') {
+  } else if (cutIdx > 0 && pruned.length > 0 && asMsg(pruned[0]).role === 'user') {
     // If we pruned and the first message IS a user message, prepend the warning to it
     const firstMsg = { ...pruned[0] } as UserMessage;
     firstMsg.content = `[System Note: Older conversation history has been truncated due to context length limits. The user may refer to things you can no longer see. If so, kindly ask them to repeat the context.]\n\n` + firstMsg.content;
@@ -336,7 +345,7 @@ export function hardPrune(
   }
 
   if (cutIdx > 0) {
-    console.log(`[ask] Hard pruned ${cutIdx} messages (${messages.length} → ${messages.length - cutIdx})`);
+    if (DEV) console.log(`[ask] Hard pruned ${cutIdx} messages (${messages.length} → ${messages.length - cutIdx})`);
     return pruned;
   }
 
@@ -365,11 +374,11 @@ export function createTransformContext(
     const preTokens = estimateTokens(result);
     const sysTokens = estimateStringTokens(systemPrompt);
     const ctxLimit = getContextLimit(modelName);
-    console.log(`[ask] Context: ~${preTokens + sysTokens} tokens (messages=${preTokens}, system=${sysTokens}), limit=${ctxLimit}`);
+    if (DEV) console.log(`[ask] Context: ~${preTokens + sysTokens} tokens (messages=${preTokens}, system=${sysTokens}), limit=${ctxLimit}`);
 
     // 2. Compact if >70% context limit (skip if user disabled)
     if (contextStrategy === 'auto' && needsCompact(result, systemPrompt, modelName)) {
-      console.log('[ask] Context >70% limit, compacting...');
+      if (DEV) console.log('[ask] Context >70% limit, compacting...');
       const compactResult = await compactMessages(
         result,
         getCompactModel(),
@@ -380,9 +389,9 @@ export function createTransformContext(
       result = compactResult.messages;
       if (compactResult.compacted) {
         const postTokens = estimateTokens(result);
-        console.log(`[ask] After compact: ~${postTokens + sysTokens} tokens`);
+        if (DEV) console.log(`[ask] After compact: ~${postTokens + sysTokens} tokens`);
       } else {
-        console.log('[ask] Compact skipped (too few messages or fallback used), hard prune will handle overflow if needed');
+        if (DEV) console.log('[ask] Compact skipped (too few messages or fallback used), hard prune will handle overflow if needed');
       }
     }
 

package/app/lib/fs.ts

@@ -323,10 +323,19 @@ export function listMindSpaces(): MindSpaceSummary[] {
   return summarizeTopLevelSpaces(getMindRoot(), ensureCache().tree);
 }
 
+/** Appends a structured change event to the change log. */
 export function appendContentChange(input: ContentChangeInput): ContentChangeEvent {
   return coreAppendContentChange(getMindRoot(), input);
 }
 
+/**
+ * Lists content change events with optional filtering.
+ * @param options.path   Filter by file path (prefix match)
+ * @param options.limit  Max events to return (default: unlimited)
+ * @param options.source Filter by source: 'user' | 'agent' | 'system'
+ * @param options.op     Filter by operation type (e.g. 'create', 'update', 'delete')
+ * @param options.q      Free-text search within change descriptions
+ */
 export function listContentChanges(options: {
   path?: string;
   limit?: number;
@@ -337,10 +346,12 @@ export function listContentChanges(options: {
   return coreListContentChanges(getMindRoot(), options);
 }
 
+/** Marks all unseen content changes as seen. */
 export function markContentChangesSeen(): void {
   coreMarkContentChangesSeen(getMindRoot());
 }
 
+/** Returns a summary of content changes (total, unseen count, latest timestamp). */
 export function getContentChangeSummary(): ContentChangeSummary {
   return coreGetContentChangeSummary(getMindRoot());
 }
@@ -411,6 +422,10 @@ export function getDirEntries(dirPath: string): FileNode[] {
   return nodes;
 }
 
+/**
+ * Returns the N most recently modified files.
+ * @param limit Max files to return (default: 10)
+ */
 export function getRecentlyModified(limit = 10): Array<{ path: string; mtime: number }> {
   const root = getMindRoot();
   const allFiles = collectAllFiles();
@@ -447,6 +462,10 @@ export function createFile(filePath: string, initialContent = ''): void {
   invalidateCacheForNewFile(filePath);
 }
 
+/**
+ * Deletes a file and moves it to the trash.
+ * @returns Trash metadata for undo support
+ */
 export function deleteFile(filePath: string): void {
   coreDeleteFile(getMindRoot(), filePath);
   invalidateCacheForDeletedFile(filePath);
@@ -480,20 +499,41 @@ export function convertToSpace(dirPath: string): void {
 
 // ─── Public API: Line-level operations (delegated to @mindos/core) ───────────
 
+/**
+ * Reads all lines of a file as an array of strings.
+ * @param filePath Relative path from MIND_ROOT
+ */
 export function readLines(filePath: string): string[] {
   return coreReadLines(getMindRoot(), filePath);
 }
 
+/**
+ * Inserts lines after the given index (0-based).
+ * @param filePath   Relative path from MIND_ROOT
+ * @param afterIndex Insert after this line index (-1 = prepend)
+ * @param lines      Lines to insert
+ */
 export function insertLines(filePath: string, afterIndex: number, lines: string[]): void {
   coreInsertLines(getMindRoot(), filePath, afterIndex, lines);
   invalidateCacheForFile(filePath);
 }
 
+/**
+ * Replaces lines in the range [startIndex, endIndex] (inclusive, 0-based).
+ * @param filePath   Relative path from MIND_ROOT
+ * @param startIndex First line to replace
+ * @param endIndex   Last line to replace
+ * @param newLines   Replacement lines
+ */
 export function updateLines(filePath: string, startIndex: number, endIndex: number, newLines: string[]): void {
   coreUpdateLines(getMindRoot(), filePath, startIndex, endIndex, newLines);
   invalidateCacheForFile(filePath);
 }
 
+/**
+ * Deletes lines in the range [startIndex, endIndex] (inclusive, 0-based).
+ * @throws {MindOSError} If indices are out of range
+ */
 export function deleteLines(filePath: string, startIndex: number, endIndex: number): void {
   const existing = readLines(filePath);
   if (startIndex < 0 || endIndex < 0) throw new MindOSError(ErrorCodes.INVALID_RANGE, 'Invalid line index: indices must be >= 0', { startIndex, endIndex });
@@ -505,16 +545,19 @@ export function deleteLines(filePath: string, startIndex: number, endIndex: numb
 
 // ─── Public API: High-level semantic operations (delegated to @mindos/core) ──
 
+/** Appends content to the end of a file with a leading newline separator. */
 export function appendToFile(filePath: string, content: string): void {
   coreAppendToFile(getMindRoot(), filePath, content);
   invalidateCacheForFile(filePath);
 }
 
+/** Inserts content after the first occurrence of a markdown heading. */
 export function insertAfterHeading(filePath: string, heading: string, content: string): void {
   coreInsertAfterHeading(getMindRoot(), filePath, heading, content);
   invalidateCacheForFile(filePath);
 }
 
+/** Replaces the content of a markdown section (heading to next heading of same or higher level). */
 export function updateSection(filePath: string, heading: string, newContent: string): void {
   coreUpdateSection(getMindRoot(), filePath, heading, newContent);
   invalidateCacheForFile(filePath);
@@ -668,6 +711,10 @@ function generateSnippet(
 
 // ─── Public API: CSV (delegated to @mindos/core) ────────────────────────────
 
+/**
+ * Appends a row to a CSV file.
+ * @returns Object with the new total row count
+ */
 export function appendCsvRow(filePath: string, row: string[]): { newRowCount: number } {
   const result = coreAppendCsvRow(getMindRoot(), filePath, row);
   invalidateCache();
@@ -676,6 +723,10 @@ export function appendCsvRow(filePath: string, row: string[]): { newRowCount: nu
 
 // ─── Public API: Move file (delegated to @mindos/core) ──────────────────────
 
+/**
+ * Moves a file from one path to another, updating internal wikilinks.
+ * @returns The new path and list of files whose links were updated
+ */
 export function moveFile(fromPath: string, toPath: string): { newPath: string; affectedFiles: string[] } {
   const result = coreMoveFile(getMindRoot(), fromPath, toPath, coreFindBacklinks);
   invalidateCache();
@@ -684,14 +735,25 @@ export function moveFile(fromPath: string, toPath: string): { newPath: string; a
 
 // ─── Public API: Git operations (delegated to @mindos/core) ─────────────────
 
+/** Returns whether the knowledge base root is a git repository. */
 export function isGitRepo(): boolean {
   return coreIsGitRepo(getMindRoot());
 }
 
+/**
+ * Returns git log entries for a file.
+ * @param filePath Relative path from MIND_ROOT
+ * @param limit    Max entries (default: 10)
+ */
 export function gitLog(filePath: string, limit = 10): Array<{ hash: string; date: string; message: string; author: string }> {
   return coreGitLog(getMindRoot(), filePath, limit);
 }
 
+/**
+ * Shows file content at a specific git commit.
+ * @param filePath Relative path from MIND_ROOT
+ * @param commit   Git commit hash or ref
+ */
 export function gitShowFile(filePath: string, commit: string): string {
   return coreGitShowFile(getMindRoot(), filePath, commit);
 }
@@ -716,40 +778,55 @@ import {
 } from './core/trash';
 export type { TrashMeta } from './core/trash';
 
+/** Moves a file to the .mindos/.trash/ directory for later recovery. */
 export function moveToTrashFile(filePath: string) {
   const result = coreMoveToTrash(getMindRoot(), filePath);
   invalidateCache();
   return result;
 }
 
+/**
+ * Restores a file from trash to its original path.
+ * @param trashId   The trash entry ID
+ * @param overwrite If true, overwrite existing file at original path
+ */
 export function restoreFromTrash(trashId: string, overwrite = false) {
   const result = coreRestoreFromTrash(getMindRoot(), trashId, overwrite);
   invalidateCache();
   return result;
 }
 
+/** Restores a file from trash as a copy (appends suffix to avoid conflict). */
 export function restoreAsCopy(trashId: string) {
   const result = coreRestoreAsCopy(getMindRoot(), trashId);
   invalidateCache();
   return result;
 }
 
+/** Permanently deletes a file from trash (no recovery possible). */
 export function permanentlyDeleteFromTrash(trashId: string) {
   corePermanentlyDelete(getMindRoot(), trashId);
 }
 
+/** Lists all items currently in the trash. */
 export function listTrash() {
   return coreListTrash(getMindRoot());
 }
 
+/** Permanently deletes all items in the trash. */
 export function emptyTrashAll() {
   return coreEmptyTrash(getMindRoot());
 }
 
+/** Removes trash items older than 30 days. Called automatically on listTrash. */
 export function purgeExpiredTrash() {
   return corePurgeExpired(getMindRoot());
 }
 
+/**
+ * Finds all files that link to the given target path via wikilinks.
+ * Uses the pre-built LinkIndex for O(1) source lookup.
+ */
 export function findBacklinks(targetPath: string): BacklinkEntry[] {
   const mindRoot = getMindRoot();
   // Use LinkIndex for O(1) source lookup, then only scan matching files

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

@@ -15,7 +15,7 @@ export const onboardingEn = {
     dismiss: 'Dismiss',
   },
   setup: {
-    stepTitles: ['Knowledge Base', 'AI Provider', 'Ports', 'Security', 'Agent Tools', 'Review'],
+    stepTitles: ['Knowledge Base', 'AI Configuration', 'Agent Tools', 'Confirm'],
     // Step 1
     kbPath: 'Knowledge base path',
     kbPathHint: 'Absolute path to your notes directory.',
@@ -56,8 +56,12 @@ export const onboardingEn = {
     generateToken: 'Generate',
     copyToken: 'Copy',
     copiedToken: 'Copied!',
-    webPassword: 'Web UI Password',
-    webPasswordHint: 'Optional. Protect browser access with a password.',
+    webPassword: 'Web Password',
+    webPasswordHint: 'Protect your knowledge base from unauthorized browser access.',
+    webPasswordRequired: 'Password is required to protect your data.',
+    advancedPorts: 'Advanced Settings',
+    tokenSectionTitle: 'MCP Auth Token (auto-generated)',
+    tokenSectionHint: 'Used by AI agents to connect to your MindOS server.',
     // Step 5 — Agent Tools
     agentToolsTitle: 'Agent Tools',
     agentToolsHint: 'Select AI agents to configure with MindOS MCP. Agents marked "not installed" can be configured now — they will work once you install the app.',
@@ -210,7 +214,7 @@ export const onboardingZh = {
     dismiss: '关闭',
   },
   setup: {
-    stepTitles: ['知识库', 'AI 服务商', '端口', '安全', 'Agent 工具', '确认'],
+    stepTitles: ['知识库', 'AI 配置', 'Agent 工具', '确认'],
     // Step 1
     kbPath: '知识库路径',
     kbPathHint: '笔记目录的绝对路径。',
@@ -251,8 +255,12 @@ export const onboardingZh = {
     generateToken: '生成',
     copyToken: '复制',
     copiedToken: '已复制！',
-    webPassword: '网页访问密码',
-    webPasswordHint: '可选。设置后浏览器访问需要登录。',
+    webPassword: '访问密码',
+    webPasswordHint: '保护你的知识库，防止未授权的浏览器访问。',
+    webPasswordRequired: '密码是必填项，用于保护你的数据。',
+    advancedPorts: '高级设置',
+    tokenSectionTitle: 'MCP 认证令牌（已自动生成）',
+    tokenSectionHint: 'AI Agent 连接你的 MindOS 服务器时使用。',
     // Step 5 — Agent Tools
     agentToolsTitle: 'Agent 工具',
     agentToolsHint: '选择要与 MindOS MCP 配置的 AI Agent。标注「未安装」的 agent 可以先行配置，安装应用后即可生效。',

package/app/lib/settings.ts

@@ -48,6 +48,7 @@ export interface ServerSettings {
   webPassword?: string;
   startMode?: 'dev' | 'start' | 'daemon';
   setupPending?: boolean;  // true → / redirects to /setup
+  setupPort?: number;      // temporary port used by GUI setup; cleared on completion
   disabledSkills?: string[];
   guideState?: GuideState;
   /** Per-agent ACP overrides (command, args, env, enabled). Keyed by agent ID. */
@@ -204,6 +205,11 @@ export function writeSettings(settings: ServerSettings): void {
     if (settings.setupPending) merged.setupPending = true;
     else delete merged.setupPending;
   }
+  // setupPort: clear when explicitly set to undefined/0 (setup completed)
+  if ('setupPort' in settings) {
+    if (settings.setupPort) merged.setupPort = settings.setupPort;
+    else delete merged.setupPort;
+  }
   fs.writeFileSync(SETTINGS_PATH, JSON.stringify(merged, null, 2) + '\n', 'utf-8');
 }
 

package/bin/cli.js

@@ -53,7 +53,7 @@ import { loadConfig, getStartMode, isDaemonMode } from './lib/config.js';
 import { needsBuild, writeBuildStamp, cleanNextDir, ensureAppDeps, hasPrebuiltStandalone } from './lib/build.js';
 import { isPortInUse, assertPortFree } from './lib/port.js';
 import { savePids, clearPids } from './lib/pid.js';
-import { stopMindos } from './lib/stop.js';
+import { stopMindos, killByPort } from './lib/stop.js';
 import { printStartupInfo, getLocalIP } from './lib/startup.js';
 import { spawnMcp } from './lib/mcp-spawn.js';
 import { parseArgs, EXIT } from './lib/command.js';
@@ -360,12 +360,22 @@ const commands = {
     const webPort = process.env.MINDOS_WEB_PORT;
     const mcpPort = process.env.MINDOS_MCP_PORT;
 
+    // Clean up zombie processes from an abandoned GUI setup session.
+    // setup.js records a temporary port (setupPort) in config; if the user
+    // closed the browser without completing setup, that process is still
+    // running.  Kill it before we proceed.
+    // Also read config for auto-migration below (avoids double readFileSync).
+    let startupCfg = {};
+    try { startupCfg = JSON.parse(readFileSync(CONFIG_PATH, 'utf-8')); } catch {}
+    if (startupCfg.setupPort && Number(startupCfg.setupPort) !== Number(webPort)) {
+      killByPort(Number(startupCfg.setupPort));
+    }
+
     // ── 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;
+      const mr = startupCfg.mindRoot;
       if (mr && existsSync(mr)) {
-        const isZh = cfg.disabledSkills?.includes('mindos');
+        const isZh = startupCfg.disabledSkills?.includes('mindos');
         const sName = isZh ? 'mindos-zh' : 'mindos';
         const sDir = resolve(mr, '.agents', 'skills', sName);
         const rootUserRules = resolve(mr, 'user-skill-rules.md');

package/bin/lib/stop.js

@@ -9,7 +9,7 @@ import { CONFIG_PATH } from './constants.js';
  * Tries lsof first, then falls back to parsing `ss` output.
  * Returns number of processes killed.
  */
-function killByPort(port) {
+export function killByPort(port) {
   const pidsToKill = new Set();
 
   // Method 1: lsof
@@ -82,11 +82,13 @@ export function stopMindos(opts = {}) {
   }
 
   // Read ports from config for port-based cleanup
-  let webPort = '3456', mcpPort = '8781';
+  let webPort = '3456', mcpPort = '8781', setupPort = null;
   try {
     const config = JSON.parse(readFileSync(CONFIG_PATH, 'utf-8'));
     if (config.port) webPort = String(config.port);
     if (config.mcpPort) mcpPort = String(config.mcpPort);
+    // Temporary port used by GUI setup — may still have a zombie process
+    if (config.setupPort) setupPort = String(config.setupPort);
   } catch {}
 
   const pids = loadPids();
@@ -106,6 +108,7 @@ export function stopMindos(opts = {}) {
   // are not recorded in the PID file and would otherwise become orphaned.
   // Include any extra ports (e.g. old ports from before a config change).
   const portsToClean = new Set([webPort, mcpPort]);
+  if (setupPort) portsToClean.add(setupPort);
   if (opts.extraPorts) {
     for (const p of opts.extraPorts) portsToClean.add(String(p));
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geminilight/mindos",
-  "version": "0.6.34",
+  "version": "0.6.36",
   "description": "MindOS — Human-Agent Collaborative Mind System. Local-first knowledge base that syncs your mind to all AI Agents via MCP.",
   "keywords": [
     "mindos",
@@ -19,6 +19,10 @@
     "type": "git",
     "url": "https://github.com/GeminiLight/MindOS"
   },
+  "homepage": "https://mindos.app",
+  "bugs": {
+    "url": "https://github.com/GeminiLight/MindOS/issues"
+  },
   "bin": {
     "mindos": "bin/cli.js"
   },
@@ -58,7 +62,7 @@
     "!app/package-lock.json"
   ],
   "scripts": {
-    "prepack": "cd mcp && npm install --include=dev && npm run build && cd ../app && npm install --no-workspaces && ./node_modules/.bin/next build --webpack && cd .. && node scripts/prepare-standalone.mjs",
+    "prepack": "rm -rf _standalone && cd mcp && npm install --include=dev && npm run build && cd ../app && npm install --no-workspaces && ./node_modules/.bin/next build --webpack && cd .. && node scripts/prepare-standalone.mjs",
     "setup": "node scripts/setup.js",
     "dev": "mindos dev",
     "build": "mindos build",

package/scripts/setup.js

@@ -843,6 +843,17 @@ async function startGuiSetup() {
   try { config = JSON.parse(readFileSync(CONFIG_PATH, 'utf-8')); } catch { /* ignore */ }
 
   const isFirstTime = !config.mindRoot;
+
+  // Clean up zombie process from a previous abandoned setup session.
+  if (config.setupPort) {
+    try {
+      const { killByPort } = await import('../bin/lib/stop.js');
+      killByPort(Number(config.setupPort));
+      // Brief wait for port to free
+      await new Promise(r => setTimeout(r, 500));
+    } catch { /* best effort */ }
+  }
+
   config.setupPending = true;
   writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + '\n');
 
@@ -890,6 +901,11 @@ async function startGuiSetup() {
   write(c.yellow(t('guiStarting') + '\n'));
 
   // Start the server in the background
+  // Record the temporary setup port in config so stopMindos() can clean it up
+  // if the user abandons setup mid-way or closes the browser without completing.
+  config.setupPort = usePort;
+  writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + '\n');
+
   // Pass MINDOS_WEB_PORT (not PORT) so loadConfig() won't override with the
   // config file port — this is critical when we need a temporary port.
   const cliPath = resolve(__dirname, '../bin/cli.js');