@geminilight/mindos 0.6.39 → 0.6.41

package/_standalone/data/skills/mindos-zh/references/write-supplement.md

@@ -0,0 +1,119 @@
+# MindOS 写入与工作流补充
+
+<!-- 随 SKILL.md 一起由 route.ts 注入到每次请求的上下文中。 -->
+<!-- 只读查阅、问答、总结时此上下文同样可用。 -->
+
+---
+
+## 绝对不要（写路径专属）
+
+- **绝不把 `mindos_write_file` 当第一步。** 没读过当前内容就覆写 = 在黑暗中操作。哪怕你"应该知道"文件里有什么，也先读——你的假设可能已过时。
+- **绝不用 `mindos_create_file` 创建心智空间。** 这只会建一个普通目录，缺少 README + INSTRUCTION 脚手架。缺少治理文件的空间从诞生起就是残缺的。必须用 `mindos_create_space`。
+- **绝不 bootstrap 后直接写入。** Bootstrap 告诉你顶层结构，不代表目标路径附近的局部 `INSTRUCTION.md` 没有覆盖全局规则。写入前必须读目标路径附近的治理文件。
+- **绝不在没有展示路由表的情况下执行多文件写入。** 即使目标看起来显而易见——用户的心智模型和你的判断不一致的概率远高于你的直觉。展示路由表，等确认。
+- **绝不把 `mindos_append_to_file` 用于有结构要求的文件。** 盲目追加会忽略章节顺序。如果文件有标题层级、必填字段或 schema 约束，用 `insert_after_heading` 或 `update_section` 把内容落在正确位置。
+
+---
+
+## 写入工具选型
+
+| 意图 | 推荐工具 | 避免 |
+|------|----------|------|
+| 小范围文字修改 | `mindos_update_section` / `mindos_update_lines` / `mindos_insert_after_heading` | 小修改用 `mindos_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` | 让用户回忆之前内容 |
+
+**回退：** 行级/章节级工具不可用 → 读 + 受限 `mindos_write_file`（模拟最小修改）。
+
+---
+
+## 启动协议
+
+所有写入任务执行前运行：
+
+1. **Bootstrap** — `mindos_bootstrap`（首选），或手动读根 `INSTRUCTION.md` + `README.md`。
+2. **发现结构**
+   - 只需确认顶层分区 → `mindos_list_spaces`（更轻量，含 README 摘要）
+   - 需要找具体文件路径 → 先用 `mindos_list_spaces` 确认目标分区，再在该分区下 `mindos_list_files`
+   - 已知关键词 → 并行 2-4 条 `mindos_search_notes`，覆盖中英文和缩写变体
+   - **绝不假设顶层目录名**——用户可能用中文、拼音或自定义层级
+3. **加载局部治理** — 读取目标路径附近的 `README.md` / `INSTRUCTION.md`。局部约定覆盖全局假设。
+4. **匹配已有 SOP** — 任务偏流程时：从树中识别存放流程的目录（`Workflows/`、`SOPs/`、`流程/` 等仅为常见名，不假设一定存在）。用关键词 + `<!-- keywords: -->` 元数据搜索。找到则读取并执行；偏差则任务后提议更新。
+5. **写前检查** — 确认：路径存在或应创建；位置在子目录下（非根）；现有内容已读；修改范围最小；路径变更的反链影响已评估。
+6. **执行编辑。**
+
+上下文缺失时，按最佳努力继续并明确写出假设。
+
+---
+
+## 执行模式
+
+| 模式 | 适用场景 | 关键步骤 |
+|------|----------|----------|
+| **单文件编辑** | 目标文件明确 | 启动协议 → 读目标 + 局部约定 → 最小修改 → 验证 → 总结 |
+| **多文件路由** | 非结构化输入，多个目的地 | 解析为语义单元 → 路由表 → 确认 → 编辑 → 汇总 |
+| **对话复盘** | 提炼 / 沉淀会话 | 确认范围 → 抽取决策/踩坑/下一步 → 路由 → 记录变更 |
+| **SOP 执行** | 可重复流程 | 完整读 SOP → 分步执行 → 更新过时段落 → 偏差则提议更新 |
+| **结构变更** | 重命名 / 移动 / 删除 | `get_backlinks` → 影响报告 → 确认 → 执行 → 更新引用 → 同步 README |
+| **CSV 追加** | 追加表格行 | 读表头 → 校验字段 → `mindos_append_csv` |
+| **跨 Agent 接力** | 继续其他 Agent 的工作 | 读任务状态+决策 → 无需重新探索直接接续 → 回写进度 |
+| **周期性回顾** | 汇总近期变动 | `get_recent`/`get_history` → 读变动文件 → 结构化总结 |
+| **交接文档** | 创建简报 | 读来源 → 合成（背景、决策、状态、待办）→ 放项目目录 |
+
+---
+
+## 详细执行步骤
+
+### 单文件编辑
+搜索 → 读目标文件 + 读 1-2 个同目录文件了解本地约定 → 应用最小修改（优先 `update_section` / `update_lines` / `insert_after_heading`，避免整文件覆写）→ 验证标题/风格匹配 → 总结改了什么。
+
+### 多文件路由
+将非结构化输入拆解为离散语义单元 → 每个单元并行搜索 2-4 个关键词变体找最合适文件 → **展示路由表**（内容片段 → 目标文件 → 插入位置）→ 等用户确认 → 逐文件执行编辑 → 用文件路径汇总全部变更。
+
+### 对话复盘
+确认范围（哪次会话？哪些主题？）→ 抽取：已做决策、决策理由、遇到的坑、下一步行动 → 为每个产物通过搜索找最合适的现有文件 → 各归其位 → 每个改动文件追加一行变更说明。
+
+### SOP 执行
+开始前完整读 SOP（不要略读）→ 逐步执行，完成一步确认一步 → 遇到过时或与当前 KB 状态不符的步骤，记录下来 → 完成后，针对偏差步骤提议定向 SOP 更新。
+**创建新 SOP** → 先读 [references/sop-template.md](./references/sop-template.md) 了解必需结构。
+
+### 结构变更
+对要变更的路径执行 `get_backlinks` → 展示影响报告（N 个文件需要更新）→ 等确认 → 执行重命名/移动/删除 → 更新每一条反链 → 同步受影响的 `README.md`。
+
+### 交接 / 跨 Agent 接力
+读交接文档或上一个 Agent 的进度记录 → 识别：当前状态、已做决策、待处理事项 → 从该状态直接接续，不重复已完成的探索 → 完成后将进度回写到同一份交接文档。
+
+---
+
+## 任务后 Hooks
+
+**写入任务**完成后（简单单文件修改或只读查阅跳过），扫描下表。命中则发起一句话提议，最多 1 条，选优先级最高项。先查 `.mindos/user-preferences.md` 的抑制区；用户要求安静模式时全部跳过。
+
+| Hook | 优先级 | 触发条件 |
+|------|--------|---------|
+| 经验沉淀 | 高 | 调试、排错、踩坑，或多轮才解决 |
+| 一致性同步 | 高 | 编辑了有反链的文件（查 `get_backlinks`） |
+| SOP 偏差 | 中 | 按 SOP 执行但实际步骤与文档不符 |
+| 联动更新 | 中 | 改了 CSV/TODO 状态且存在关联文档 |
+| 结构归类 | 中 | 在临时目录或收件箱新建了文件 |
+| 模式提炼 | 低 | 本会话 3+ 次结构相似操作 |
+| 对话复盘 | 低 | 会话 >10 轮且涉及决策或权衡 |
+
+有 hook 命中 → 读 [references/post-task-hooks.md](./references/post-task-hooks.md) 获取提议措辞和用户自定义 hooks。都不命中则安静结束，不读此文件。
+
+## 偏好捕获
+
+用户表达要长期记住的偏好（「以后不要…」「这个该放在…」）时，读 [references/preference-capture.md](./references/preference-capture.md) 并按确认后写入流程存入 `.mindos/user-preferences.md`。
+**不要读** preference-capture 除非用户真的表达了要持久化的偏好。
+
+## SOP 编写
+
+创建或改写工作流 SOP 时，**必须 — 读 [references/sop-template.md](./references/sop-template.md)**（前置条件、分支步骤、退出条件、踩坑记录）。
+**不要读** sop-template 用于 SOP 执行（仅用于 SOP 创建/编辑）。

package/_standalone/hooks/useAcpDetection.ts

@@ -30,7 +30,7 @@ interface AcpDetectionState {
 
 const STORAGE_KEY = 'mindos:acp-detection';
 const STALE_TTL_MS = 30 * 60 * 1000;
-const REVALIDATE_TTL_MS = 5 * 60 * 1000;
+const REVALIDATE_TTL_MS = 30 * 60 * 1000;
 
 interface DetectionCache {
   installed: DetectedAgent[];

package/_standalone/hooks/useAskChat.ts

@@ -0,0 +1,248 @@
+'use client';
+
+import { useRef, useState, useCallback } from 'react';
+import type { Message, ImagePart, AskMode } from '@/lib/types';
+import type { ProviderId } from '@/lib/agent/providers';
+import { consumeUIMessageStream } from '@/lib/agent/stream-consumer';
+import { isRetryableError, retryDelay, sleep } from '@/lib/agent/reconnect';
+
+export type LoadingPhase = 'connecting' | 'thinking' | 'streaming' | 'reconnecting';
+
+export interface AskChatRefs {
+  inputValueRef: React.RefObject<string>;
+  mentionRef: React.RefObject<{ mentionQuery: string | null }>;
+  slashRef: React.RefObject<{ slashQuery: string | null }>;
+  imageUploadRef: React.RefObject<{ images: ImagePart[]; clearImages: () => void }>;
+  sessionRef: React.RefObject<{
+    messages: Message[];
+    setMessages: React.Dispatch<React.SetStateAction<Message[]>>;
+  }>;
+  uploadRef: React.RefObject<{
+    localAttachments: { name: string; content: string }[];
+  }>;
+  selectedSkillRef: React.RefObject<{ name: string } | null>;
+  selectedAcpAgentRef: React.RefObject<unknown>;
+  attachedFilesRef: React.RefObject<string[]>;
+}
+
+interface UseAskChatOpts {
+  currentFile?: string;
+  chatMode: AskMode;
+  providerOverride: ProviderId | null;
+  onFirstMessage?: () => void;
+  refs: AskChatRefs;
+  errorLabels: { noResponse: string; stopped: string };
+  resetInputState: () => void;
+}
+
+export function useAskChat({
+  currentFile,
+  chatMode,
+  providerOverride,
+  onFirstMessage,
+  refs,
+  errorLabels,
+  resetInputState,
+}: UseAskChatOpts) {
+  const [isLoading, setIsLoading] = useState(false);
+  const [loadingPhase, setLoadingPhase] = useState<LoadingPhase>('connecting');
+  const [reconnectAttempt, setReconnectAttempt] = useState(0);
+  const reconnectMaxRef = useRef(3);
+  const abortRef = useRef<AbortController | null>(null);
+  const firstMessageFired = useRef(false);
+
+  const stop = useCallback(() => { abortRef.current?.abort(); }, []);
+
+  const submit = useCallback(async (e: React.FormEvent) => {
+    e.preventDefault();
+    const m = refs.mentionRef.current;
+    const s = refs.slashRef.current;
+    const img = refs.imageUploadRef.current;
+    const sess = refs.sessionRef.current;
+    const upl = refs.uploadRef.current;
+    if (!m || !s || !img || !sess || !upl) return;
+    if (m.mentionQuery !== null || s.slashQuery !== null) return;
+    const text = refs.inputValueRef.current?.trim() ?? '';
+    if ((!text && img.images.length === 0) || isLoadingRef.current) return;
+
+    const skill = refs.selectedSkillRef.current;
+    const acpAgent = refs.selectedAcpAgentRef.current;
+    const pendingImages = img.images.length > 0 ? [...img.images] : undefined;
+    const userMsg: Message = {
+      role: 'user',
+      content: text,
+      timestamp: Date.now(),
+      ...(skill && { skillName: skill.name }),
+      ...(pendingImages && { images: pendingImages }),
+    };
+    img.clearImages();
+    const requestMessages = [...sess.messages, userMsg];
+    sess.setMessages([...requestMessages, { role: 'assistant', content: '', timestamp: Date.now() }]);
+
+    resetInputState();
+
+    if (onFirstMessage && !firstMessageFired.current) {
+      firstMessageFired.current = true;
+      onFirstMessage();
+    }
+    setIsLoading(true);
+    setLoadingPhase('connecting');
+    setReconnectAttempt(0);
+
+    const controller = new AbortController();
+    abortRef.current = controller;
+
+    let maxRetries = 3;
+    try {
+      const stored = localStorage.getItem('mindos-reconnect-retries');
+      if (stored !== null) { const n = parseInt(stored, 10); if (Number.isFinite(n)) maxRetries = Math.max(0, Math.min(10, n)); }
+    } catch { /* localStorage unavailable */ }
+    reconnectMaxRef.current = maxRetries;
+
+    const requestBody = JSON.stringify({
+      messages: requestMessages,
+      currentFile,
+      attachedFiles: refs.attachedFilesRef.current,
+      uploadedFiles: upl.localAttachments.map(f => ({
+        name: f.name,
+        content: f.content.length > 20_000
+          ? f.content.slice(0, 20_000) + '\n\n[...truncated to first ~20000 chars]'
+          : f.content,
+      })),
+      selectedAcpAgent: acpAgent,
+      mode: chatMode,
+      providerOverride: providerOverride ?? undefined,
+    });
+
+    const doFetch = async (): Promise<{ finalMessage: Message }> => {
+      const res = await fetch('/api/ask', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: requestBody,
+        signal: controller.signal,
+      });
+
+      if (!res.ok) {
+        let errorMsg = `Request failed (${res.status})`;
+        try {
+          const errBody = await res.json() as { error?: { message?: string } | string; message?: string };
+          if (typeof errBody?.error === 'string' && errBody.error.trim()) {
+            errorMsg = errBody.error;
+          } else if (typeof errBody?.error === 'object' && typeof errBody.error?.message === 'string' && errBody.error.message.trim()) {
+            errorMsg = errBody.error.message;
+          } else if (typeof errBody?.message === 'string' && errBody.message.trim()) {
+            errorMsg = errBody.message;
+          }
+        } catch (err) { console.warn("[useAskChat] error body parse failed:", err); }
+        const err = new Error(errorMsg);
+        (err as Error & { httpStatus?: number }).httpStatus = res.status;
+        throw err;
+      }
+
+      if (!res.body) throw new Error('No response body');
+
+      setLoadingPhase('thinking');
+
+      const finalMessage = await consumeUIMessageStream(
+        res.body,
+        (msg) => {
+          setLoadingPhase('streaming');
+          refs.sessionRef.current?.setMessages(prev => {
+            const updated = [...prev];
+            updated[updated.length - 1] = msg;
+            return updated;
+          });
+        },
+        controller.signal,
+      );
+      return { finalMessage };
+    };
+
+    try {
+      let lastError: Error | null = null;
+
+      for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        if (controller.signal.aborted) break;
+
+        if (attempt > 0) {
+          setReconnectAttempt(attempt);
+          setLoadingPhase('reconnecting');
+          refs.sessionRef.current?.setMessages(prev => {
+            const updated = [...prev];
+            updated[updated.length - 1] = { role: 'assistant', content: '', timestamp: Date.now() };
+            return updated;
+          });
+          await sleep(retryDelay(attempt - 1), controller.signal);
+          setLoadingPhase('connecting');
+        }
+
+        try {
+          const { finalMessage } = await doFetch();
+          if (!finalMessage.content.trim() && (!finalMessage.parts || finalMessage.parts.length === 0)) {
+            refs.sessionRef.current?.setMessages(prev => {
+              const updated = [...prev];
+              updated[updated.length - 1] = { role: 'assistant', content: `__error__${errorLabels.noResponse}` };
+              return updated;
+            });
+          }
+          return;
+        } catch (err) {
+          lastError = err instanceof Error ? err : new Error(String(err));
+          const httpStatus = (err as Error & { httpStatus?: number }).httpStatus;
+          if (!isRetryableError(err, httpStatus) || attempt >= maxRetries) break;
+        }
+      }
+
+      if (lastError) throw lastError;
+    } catch (err) {
+      if ((err as Error).name === 'AbortError') {
+        refs.sessionRef.current?.setMessages(prev => {
+          const updated = [...prev];
+          const lastIdx = updated.length - 1;
+          if (lastIdx >= 0 && updated[lastIdx].role === 'assistant') {
+            const last = updated[lastIdx];
+            const hasContent = last.content.trim() || (last.parts && last.parts.length > 0);
+            if (!hasContent) {
+              updated[lastIdx] = { role: 'assistant', content: `__error__${errorLabels.stopped}` };
+            }
+          }
+          return updated;
+        });
+      } else {
+        const errMsg = err instanceof Error ? err.message : 'Something went wrong';
+        refs.sessionRef.current?.setMessages(prev => {
+          const updated = [...prev];
+          const lastIdx = updated.length - 1;
+          if (lastIdx >= 0 && updated[lastIdx].role === 'assistant') {
+            const last = updated[lastIdx];
+            const hasContent = last.content.trim() || (last.parts && last.parts.length > 0);
+            if (!hasContent) {
+              updated[lastIdx] = { role: 'assistant', content: `__error__${errMsg}` };
+              return updated;
+            }
+          }
+          return [...updated, { role: 'assistant', content: `__error__${errMsg}` }];
+        });
+      }
+    } finally {
+      setIsLoading(false);
+      setReconnectAttempt(0);
+      abortRef.current = null;
+    }
+  }, [currentFile, chatMode, providerOverride, errorLabels.noResponse, errorLabels.stopped, onFirstMessage, refs, resetInputState]);
+
+  const isLoadingRef = useRef(isLoading);
+  isLoadingRef.current = isLoading;
+
+  return {
+    isLoading,
+    isLoadingRef,
+    loadingPhase,
+    reconnectAttempt,
+    reconnectMaxRef,
+    abortRef,
+    firstMessageFired,
+    submit,
+    stop,
+  };
+}

package/_standalone/hooks/useAskPanel.ts

@@ -1,6 +1,6 @@
 'use client';
 
-import { useState, useEffect, useCallback } from 'react';
+import { useState, useEffect, useCallback, useRef } from 'react';
 import { RIGHT_ASK_DEFAULT_WIDTH, RIGHT_ASK_MIN_WIDTH, RIGHT_ASK_MAX_WIDTH } from '@/components/RightAskPanel';
 import { useAskModal, type AcpAgentSelection } from './useAskModal';
 
@@ -35,6 +35,7 @@ export function useAskPanel(): AskPanelState {
   const [askMaximized, setAskMaximized] = useState(false);
   const [askOpenSource, setAskOpenSource] = useState<'user' | 'guide' | 'guide-next'>('user');
   const [askAcpAgent, setAskAcpAgent] = useState<AcpAgentSelection | null>(null);
+  const prevWidthRef = useRef(RIGHT_ASK_DEFAULT_WIDTH);
 
   const askModal = useAskModal();
 
@@ -44,7 +45,10 @@ export function useAskPanel(): AskPanelState {
       const stored = localStorage.getItem('right-ask-panel-width');
       if (stored) {
         const w = parseInt(stored, 10);
-        if (w >= RIGHT_ASK_MIN_WIDTH && w <= RIGHT_ASK_MAX_WIDTH) setAskPanelWidth(w);
+        if (w >= RIGHT_ASK_MIN_WIDTH && w <= RIGHT_ASK_MAX_WIDTH) {
+          setAskPanelWidth(w);
+          prevWidthRef.current = w;
+        }
       }
       const mode = localStorage.getItem('ask-mode');
       if (mode === 'popup') setAskMode('popup');
@@ -88,8 +92,24 @@ export function useAskPanel(): AskPanelState {
     }
   }, [askMode]);
 
-  const closeAskPanel = useCallback(() => { setAskPanelOpen(false); setAskMaximized(false); }, []);
-  const toggleAskMaximized = useCallback(() => setAskMaximized(v => !v), []);
+  const closeAskPanel = useCallback(() => {
+    setAskPanelOpen(false);
+    if (askMaximized) {
+      setAskPanelWidth(prevWidthRef.current);
+      setAskMaximized(false);
+    }
+  }, [askMaximized]);
+
+  const toggleAskMaximized = useCallback(() => {
+    setAskMaximized(prev => {
+      if (!prev) {
+        prevWidthRef.current = askPanelWidth;
+      } else {
+        setAskPanelWidth(prevWidthRef.current);
+      }
+      return !prev;
+    });
+  }, [askPanelWidth]);
   const closeDesktopAskPopup = useCallback(() => setDesktopAskPopupOpen(false), []);
 
   const handleAskWidthChange = useCallback((w: number) => setAskPanelWidth(w), []);

package/_standalone/hooks/useAskSession.ts

@@ -18,6 +18,7 @@ function createSession(currentFile?: string): ChatSession {
 }
 
 export function sessionTitle(s: ChatSession): string {
+  if (s.title) return s.title;
   const firstUser = s.messages.find((m) => m.role === 'user');
   if (!firstUser) return '(empty session)';
   const line = firstUser.content.replace(/\s+/g, ' ').trim();
@@ -213,6 +214,19 @@ export function useAskSession(currentFile?: string) {
     [activeSessionId, currentFile, sessions],
   );
 
+  const renameSession = useCallback((id: string, newTitle: string) => {
+    const trimmed = newTitle.trim();
+    setSessions((prev) => {
+      const idx = prev.findIndex((s) => s.id === id);
+      if (idx < 0) return prev;
+      const updated = { ...prev[idx], title: trimmed || undefined };
+      const next = [...prev];
+      next[idx] = updated;
+      void upsertSession(updated);
+      return next;
+    });
+  }, []);
+
   const clearAllSessions = useCallback(() => {
     // Only delete sessions that have messages (were persisted)
     const persistedIds = sessions.filter(s => s.messages.length > 0).map(s => s.id);
@@ -236,6 +250,7 @@ export function useAskSession(currentFile?: string) {
     resetSession,
     loadSession,
     deleteSession,
+    renameSession,
     clearAllSessions,
   };
 }

package/_standalone/lib/acp/types.ts

@@ -265,7 +265,7 @@ export const ACP_ERRORS = {
   SPAWN_FAILED: { code: -32004, message: 'Failed to spawn agent process' },
   TRANSPORT_ERROR: { code: -32005, message: 'Transport error' },
   AUTH_REQUIRED: { code: -32000, message: 'Authentication required' },
-  RESOURCE_NOT_FOUND: { code: -32002, message: 'Resource not found' },
+  RESOURCE_NOT_FOUND: { code: -32006, message: 'Resource not found' },
   PARSE_ERROR: { code: -32700, message: 'Parse error' },
   INVALID_REQUEST: { code: -32600, message: 'Invalid request' },
   METHOD_NOT_FOUND: { code: -32601, message: 'Method not found' },

package/_standalone/lib/api.ts

@@ -36,7 +36,9 @@ export async function apiFetch<T>(url: string, opts: ApiFetchOptions = {}): Prom
   }
 
   if (timeout > 0 && controller) {
-    timeoutId = setTimeout(() => controller.abort(), timeout);
+    timeoutId = setTimeout(() => {
+      controller.abort(new Error(`Request timed out after ${Math.round(timeout / 1000)}s`));
+    }, timeout);
   }
 
   // Bridge caller-provided AbortSignal so both timeout and external cancel work.

package/_standalone/lib/core/types.ts

@@ -1,6 +1,8 @@
 export interface SpacePreview {
   instructionLines: string[];
   readmeLines: string[];
+  /** True when both files still contain only the default scaffold template. */
+  isTemplate?: boolean;
 }
 
 export interface FileNode {

package/_standalone/lib/i18n/modules/ai-chat.ts

@@ -5,7 +5,8 @@ export const aiChatEn = {
     title: 'MindOS Agent',
     fabLabel: 'Ask AI',
     placeholder: 'Ask a question... @ files, / skills',
-    emptyPrompt: 'Ask anything about your knowledge base',
+    emptyPrompt: 'How can I help?',
+    emptyHint: 'Type @ to reference files · / to use skills',
     send: 'send',
     newlineHint: 'new line',
     panelComposerResize: 'Drag up to enlarge the input area',
@@ -13,6 +14,8 @@ export const aiChatEn = {
     panelComposerResetHint: 'Double-click to reset height',
     panelComposerKeyboard: 'Arrow keys adjust height; Home/End min/max',
     attachFile: 'Context',
+    attachFileLabel: 'Document',
+    attachImageLabel: 'Image',
     uploadedFiles: 'Uploaded',
     skillsHint: 'skills',
     attachCurrent: 'attach current file',
@@ -30,15 +33,23 @@ export const aiChatEn = {
     retry: 'Retry',
     suggestions: [
       'Summarize this document',
-      'List all action items and TODOs',
-      'What are the key points?',
-      'Find related notes on this topic',
+      'Organize my recent notes',
+      'Find related notes',
+      'Draft a new note',
     ],
+    modeChat: 'Chat',
+    modeAgent: 'Agent',
+    modeChatHint: 'Can search / read KB · saves tokens',
+    modeAgentHint: 'Full tool access · can modify KB',
     sessionHistory: 'Session History',
     clearAll: 'Clear all',
     confirmClear: 'Confirm clear?',
     noSessions: 'No saved sessions.',
+    renameSession: 'Rename',
     draftingHint: 'AI is still running — you can draft the next step now.',
+    providerCapsule: 'Switch model provider',
+    providerDefault: 'Default',
+    providerNoKey: 'No configured providers',
   },
   changes: {
     unreadBanner: (n: number) => `${n} content change${n === 1 ? '' : 's'} unread`,
@@ -97,8 +108,8 @@ export const aiChatEn = {
     sessionHistory: 'Session history',
     newSession: 'New session',
     attachFile: 'Attach local file',
-    maximizePanel: 'Maximize panel',
-    restorePanel: 'Restore panel',
+    maximizePanel: 'Focus mode',
+    restorePanel: 'Exit focus',
     dockToSide: 'Dock to side panel',
     openAsPopup: 'Open as popup',
     closePanel: 'Close',
@@ -112,7 +123,8 @@ export const aiChatZh = {
     title: 'MindOS Agent',
     fabLabel: 'AI 助手',
     placeholder: '输入问题… @ 附加文件，/ 技能',
-    emptyPrompt: '可以问任何关于知识库的问题',
+    emptyPrompt: '有什么可以帮你？',
+    emptyHint: '输入 @ 引用文件 · / 使用技能',
     send: '发送',
     newlineHint: '换行',
     panelComposerResize: '向上拖拽以拉高输入区',
@@ -120,6 +132,8 @@ export const aiChatZh = {
     panelComposerResetHint: '双击恢复默认高度',
     panelComposerKeyboard: '方向键调节高度；Home/End 最小或最大',
     attachFile: '上下文',
+    attachFileLabel: '文档',
+    attachImageLabel: '图片',
     uploadedFiles: '已上传',
     skillsHint: '技能',
     attachCurrent: '附加当前文件',
@@ -137,15 +151,23 @@ export const aiChatZh = {
     retry: '重试',
     suggestions: [
       '总结这篇文档',
-      '列出所有待办事项',
-      '这篇文档的核心要点是什么？',
-      '查找与这个主题相关的笔记',
+      '整理最近的笔记',
+      '查找相关笔记',
+      '起草一篇新笔记',
     ],
+    modeChat: '对话',
+    modeAgent: 'Agent',
+    modeChatHint: '可搜索/阅读知识库 · 省 token',
+    modeAgentHint: '完整工具权限 · 可修改知识库',
     sessionHistory: '对话历史',
     clearAll: '清除全部',
     confirmClear: '确认清除？',
     noSessions: '暂无历史对话。',
+    renameSession: '重命名',
     draftingHint: 'AI 仍在执行，你可以先输入下一步。',
+    providerCapsule: '切换模型服务商',
+    providerDefault: '默认',
+    providerNoKey: '暂无已配置的服务商',
   },
   changes: {
     unreadBanner: (n: number) => `${n} 条内容变更未读`,
@@ -162,7 +184,7 @@ export const aiChatZh = {
       filePath: '文件路径',
       filePathPlaceholder: '例如：Projects/plan.md',
       source: 'Agents（来源）',
-      operation: 'Tools（操作）',
+      operation: '工具（操作）',
       operationAll: '全部操作',
       keyword: '关键词',
       keywordPlaceholder: '摘要 / 操作 / 路径',
@@ -204,8 +226,8 @@ export const aiChatZh = {
     sessionHistory: '会话历史',
     newSession: '新会话',
     attachFile: '附加本地文件',
-    maximizePanel: '最大化面板',
-    restorePanel: '还原面板',
+    maximizePanel: '专注模式',
+    restorePanel: '退出专注',
     dockToSide: '停靠到侧边栏',
     openAsPopup: '弹窗模式',
     closePanel: '关闭',

package/_standalone/lib/i18n/modules/features.ts

@@ -24,7 +24,7 @@ export const featuresEn = {
       step2Title: 'Chat with AI',
       step2Desc: 'Press ⌘/ (or Ctrl/) to open the AI panel. Ask anything about your knowledge base, or use @ to attach a specific file for context.',
       step3Title: 'Connect your AI agents',
-      step3Desc: 'Go to Settings → MCP to connect external agents like Claude Code, Cursor, or Windsurf. Once connected, they can read and write your knowledge base directly.',
+      step3Desc: 'Go to Settings → Connections to connect external agents like Claude Code, Cursor, or Windsurf. Once connected, they can read and write your knowledge base directly.',
     },
     concepts: {
       title: 'Core Concepts',
@@ -63,7 +63,7 @@ export const featuresEn = {
       title: 'FAQ',
       items: [
         { q: 'How do I change the language?', a: 'Go to Settings → Appearance → Language. You can switch between English and Chinese.' },
-        { q: 'How do I connect an AI agent?', a: 'Go to Settings → MCP & Skills. MindOS auto-detects installed agents (Claude Code, Cursor, etc.) and lets you connect them with one click.' },
+        { q: 'How do I connect an AI agent?', a: 'Go to Settings → Connections. MindOS auto-detects installed agents (Claude Code, Cursor, etc.) and lets you connect them with one click.' },
         { q: 'Where is my data stored?', a: 'All your data stays on your local machine as plain Markdown files. MindOS never uploads your data to any cloud service. You own everything.' },
         { q: 'How do I sync across devices?', a: 'Go to Settings → Sync. MindOS uses Git for cross-device sync. Enter your Git remote URL and access token to start syncing.' },
         { q: 'Can I use my own AI provider?', a: 'Yes! Go to Settings → AI. You can use OpenAI, Anthropic, Google, or any OpenAI-compatible API with a custom base URL.' },
@@ -96,11 +96,11 @@ export const featuresZh = {
     quickStart: {
       title: '快速开始',
       step1Title: '浏览你的知识库',
-      step1Desc: '点击左侧边栏的"空间"图标来浏览你的文件。每个顶级文件夹是一个"空间"——比如 Profile、Notes 或 Projects。',
+      step1Desc: '点击左侧边栏的"空间"图标来浏览你的文件。每个顶级文件夹是一个"空间"——比如个人档案、笔记或项目。',
       step2Title: '和 AI 对话',
       step2Desc: '按 ⌘/（或 Ctrl/）打开 AI 面板。询问任何关于知识库的问题，或使用 @ 附加特定文件作为上下文。',
       step3Title: '连接你的 AI Agent',
-      step3Desc: '前往 设置 → MCP 连接外部 Agent，如 Claude Code、Cursor 或 Windsurf。连接后，它们可以直接读写你的知识库。',
+      step3Desc: '前往 设置 → 连接 以连接外部 Agent，如 Claude Code、Cursor 或 Windsurf。连接后，它们可以直接读写你的知识库。',
     },
     concepts: {
       title: '核心概念',
@@ -139,7 +139,7 @@ export const featuresZh = {
       title: '常见问题',
       items: [
         { q: '如何切换语言？', a: '前往 设置 → 外观 → 语言。支持中文和英文切换。' },
-        { q: '如何连接 AI Agent？', a: '前往 设置 → MCP & Skills。MindOS 会自动检测已安装的 Agent（Claude Code、Cursor 等），一键即可连接。' },
+        { q: '如何连接 AI Agent？', a: '前往 设置 → 连接。MindOS 会自动检测已安装的 Agent（Claude Code、Cursor 等），一键即可连接。' },
         { q: '我的数据存储在哪里？', a: '所有数据以纯 Markdown 文件的形式存储在你的本地机器上。MindOS 不会将你的数据上传到任何云服务。数据完全由你掌控。' },
         { q: '如何跨设备同步？', a: '前往 设置 → 同步。MindOS 使用 Git 进行跨设备同步。输入 Git 远程仓库 URL 和访问令牌即可开始同步。' },
         { q: '可以使用自己的 AI 服务商吗？', a: '可以！前往 设置 → AI。支持 OpenAI、Anthropic、Google，或任何 OpenAI 兼容的 API（自定义 Base URL）。' },