@nextclaw/ui 0.24.2 → 0.25.0

package/src/shared/lib/api/ncp-session-query-cache.utils.ts

@@ -1,4 +1,4 @@
-import type { QueryClient } from '@tanstack/react-query';
+import type { InfiniteData, QueryClient } from '@tanstack/react-query';
 import type { NcpSessionSummaryView, NcpSessionsListView, WsEvent } from '@/shared/lib/api';
 
 function readSessionActivityAt(summary: NcpSessionSummaryView): string {
@@ -26,6 +26,73 @@ function queryKeyAcceptsSessionSummary(queryKey: readonly unknown[], summary: Nc
   return !peerId || summary.peerId === peerId;
 }
 
+function updateSessionPages(
+  current: InfiniteData<NcpSessionsListView> | undefined,
+  update: (sessions: NcpSessionsListView) => NcpSessionsListView | undefined
+): InfiniteData<NcpSessionsListView> | undefined {
+  if (!current) return current;
+  const pageLengths = current.pages.map((page) => page.sessions.length);
+  const sessions = current.pages.flatMap((page) => page.sessions);
+  const updated = update({
+    sessions,
+    total: current.pages[0]?.total ?? sessions.length
+  });
+  if (!updated) return current;
+  let offset = 0;
+  return {
+    ...current,
+    pages: current.pages.map((page, index) => {
+      const nextOffset = offset + (pageLengths[index] ?? 0);
+      const nextPage = {
+        ...page,
+        sessions: updated.sessions.slice(offset, nextOffset)
+      };
+      offset = nextOffset;
+      return nextPage;
+    })
+  };
+}
+
+function updateExistingNcpSessionSummaryPages(
+  queryClient: QueryClient | undefined,
+  summary: NcpSessionSummaryView
+): void {
+  if (!queryClient) return;
+  const entries = queryClient.getQueriesData<InfiniteData<NcpSessionsListView>>({
+    queryKey: ['ncp-session-pages']
+  });
+  for (const [queryKey, current] of entries) {
+    const query = typeof queryKey[2] === 'string' ? queryKey[2].trim() : '';
+    const containsSession = current?.pages.some((page) =>
+      page.sessions.some((session) => session.sessionId === summary.sessionId)
+    );
+    if (query || !containsSession) {
+      void queryClient.invalidateQueries({ queryKey, exact: true });
+      continue;
+    }
+    queryClient.setQueryData<InfiniteData<NcpSessionsListView>>(
+      queryKey,
+      (value) => updateSessionPages(
+        value,
+        (sessions) => upsertNcpSessionSummaryList(sessions, summary)
+      )
+    );
+  }
+}
+
+function updateNcpSessionRunStatusPages(
+  queryClient: QueryClient | undefined,
+  payload: { sessionKey: string; status: 'running' | 'idle' }
+): void {
+  queryClient?.setQueriesData<InfiniteData<NcpSessionsListView>>(
+    { queryKey: ['ncp-session-pages'] },
+    (current) => updateSessionPages(
+      current,
+      (sessions) => updateNcpSessionRunStatusList(sessions, payload)
+    )
+  );
+}
+
 export function upsertNcpSessionSummaryList(
   current: NcpSessionsListView | undefined,
   summary: NcpSessionSummaryView
@@ -149,13 +216,14 @@ export function applyNcpSessionRealtimeEvent(
   queryClient: QueryClient | undefined,
   event: Extract<WsEvent, { type: 'session.run-status' | 'session.summary.upsert' | 'session.summary.delete' }>
 ): void {
-  void queryClient?.invalidateQueries({ queryKey: ['ncp-session-pages'] });
   if (event.type === 'session.run-status') {
     updateNcpSessionRunStatusInQueryClient(queryClient, event.payload);
+    updateNcpSessionRunStatusPages(queryClient, event.payload);
     return;
   }
   if (event.type === 'session.summary.upsert') {
     upsertNcpSessionSummaryInQueryClient(queryClient, event.payload.summary);
+    updateExistingNcpSessionSummaryPages(queryClient, event.payload.summary);
     void queryClient?.invalidateQueries({
       queryKey: ['ncp-session-token-usage', event.payload.summary.sessionId],
       exact: true,
@@ -164,4 +232,5 @@ export function applyNcpSessionRealtimeEvent(
   }
 
   deleteNcpSessionSummaryInQueryClient(queryClient, event.payload.sessionKey);
+  void queryClient?.invalidateQueries({ queryKey: ['ncp-session-pages'] });
 }

package/src/shared/lib/i18n/locales/en-US/chat.json

@@ -638,5 +638,36 @@
   "chatWorkspaceExcerptCharacterCount": "{count} characters",
   "chatInputAttachmentUnsupported": "This file type is not supported in the current upload flow.",
   "chatInputAttachmentTooLarge": "Files must be {maxMb} MB or smaller.",
-  "chatInputAttachmentReadFailed": "Failed to read the file. Please try again."
+  "chatInputAttachmentReadFailed": "Failed to read the file. Please try again.",
+  "chatInputVoice": "Voice input",
+  "chatInputVoicePermissionDenied": "Microphone permission was denied. Allow it in the browser or system settings and retry.",
+  "chatInputVoiceUnsupported": "Speech input is not supported in this browser.",
+  "chatInputVoiceNoSpeech": "Could not hear you. Please try again.",
+  "chatInputVoiceFailed": "Voice input failed. Please try again.",
+  "chatInputVoicePrivacy": "Click to dictate at the cursor. Underlined words are still being recognized. Your browser may process audio online. Nothing is sent automatically.",
+  "chatInputVoiceStart": "Start recording",
+  "chatInputVoiceFinish": "Finish recording",
+  "chatInputVoiceCancel": "Cancel",
+  "chatInputVoiceStarting": "Connecting to microphone…",
+  "chatInputVoiceRecording": "Listening",
+  "chatInputVoiceFinishing": "Finishing transcription…",
+  "chatInputVoiceReview": "Recording stopped",
+  "chatInputVoiceSpeak": "Speak now. Your transcript will appear here.",
+  "chatInputVoiceReviewHint": "Confirmed words remain in your draft; provisional words were removed. Continue editing or try again.",
+  "chatInputVoiceTranscript": "Recognized text",
+  "chatInputVoiceInsert": "Keep in draft",
+  "chatInputVoiceRetry": "Retry",
+  "chatInputVoiceNetwork": "Could not connect to the speech service. Check your network and try again.",
+  "chatInputVoiceDevice": "Microphone unavailable. Check your device and system permissions.",
+  "chatInputVoiceInterrupted": "Recording stopped because the page or window lost focus.",
+  "chatInputVoiceTimeout": "The speech service timed out. Recording has stopped. Try again.",
+  "chatInputVoiceShortcut": "Voice shortcut",
+  "chatInputVoiceCloseSettings": "Close settings",
+  "chatInputVoiceBind": "Bind a key",
+  "chatInputVoiceUnbind": "Disable",
+  "chatInputVoiceCapture": "Press your shortcut…",
+  "chatInputVoiceCaptureHelp": "Use a letter, F6–F10, or Ctrl/⌘ + Alt/⌥ + a letter. Esc cancels; Tab exits. Common shortcuts such as copy and paste are reserved.",
+  "chatInputVoiceShortcutHelp": "Hold to speak; release to finish. Single keys work outside text inputs; combinations also work inside. Only active in this chat page. System shortcuts may take priority.",
+  "chatInputVoiceBindInvalid": "This key may interfere with normal controls. Choose one of the suggested keys.",
+  "chatInputVoiceSaveFailed": "Could not save the shortcut. Check browser storage permissions."
 }

package/src/shared/lib/i18n/locales/en-US/core.json

@@ -15,6 +15,8 @@
   "settingsGroupBasic": "Basic Configuration",
   "settingsGroupAdvanced": "Advanced Configuration",
   "appearance": "Appearance",
+  "keyboardShortcuts": "Keyboard shortcuts",
+  "keyboardShortcutsDesktopOnly": "Keyboard shortcuts can be configured on desktop. Use the microphone button on mobile.",
   "chatMessageLayoutTitle": "Message layout",
   "chatMessageLayoutDescription": "Choose how chat messages are displayed.",
   "chatMessageLayoutCard": "Cards",

package/src/shared/lib/i18n/locales/en-US/projects.json

@@ -6,28 +6,22 @@
   "projectsSkills": "Skills",
   "projectsSkillsCountSuffix": "skills",
   "projectsAgreement": "Working rules",
-  "projectsVisionAndContext": "Vision and context",
+  "projectsAgreementFile": "AGENTS.md",
+  "projectsAgreementDescription": "Project working rules come from AGENTS.md at the project root.",
+  "projectsAgreementOpen": "Open working rules",
+  "projectsNoAgreement": "No AGENTS.md exists at the project root",
   "projectsLoading": "Loading project…",
   "projectsLoadFailed": "Failed to load project",
   "projectsEmpty": "No registered projects",
   "projectsChoose": "Choose a project",
+  "projectsMoreActions": "More actions for {name}",
   "projectsRemoveFromList": "Remove from project list",
   "projectsRemoveConfirmTitle": "Remove from project list",
   "projectsRemoveConfirmDescription": "The local folder, previous sessions, and project work records will not be deleted. Existing sessions remain available in the session list, and adding the same folder again restores the original project.",
   "projectsRemoveConfirmAction": "Remove project",
   "projectsRemoveSuccess": "Project removed from the list",
   "projectsRemoveFailed": "Failed to remove project",
-  "projectsAsOf": "Observed at",
-  "projectsQuality": "Data quality",
-  "projectsQuality_complete": "Complete",
-  "projectsQuality_partial": "Partially available",
-  "projectsQuality_unavailable": "Unavailable",
-  "projectsNoSummary": "This project has no configured summary. Existing sources remain available under Working rules.",
-  "projectsObservationSetupTitle": "Set up project observation",
-  "projectsObservationSetupDescription": "This project has no observation convention yet. Ask AI to inspect existing materials, recommend a work-item lifecycle and artifact scope, and prepare the project configuration, always-on rule, and project tracking Skill. Nothing is written until you confirm.",
-  "projectsObservationSetupAction": "Let AI set up project observation",
-  "projectsObservationSetupPrompt": "Follow the built-in project observation setup guidance to establish a durable work-tracking convention for this project. Read the existing materials, then directly propose one editable recommendation containing all three assets: .nextclaw/project.yaml, the minimal always-on section in the root AGENTS.md, and the project-specific .agents/skills/project-work-tracking/SKILL.md. A Workflow describes how one work item progresses; it is not the macro lifecycle of the whole project. Markers must be emitted before a stage starts, never batched at the end. Do not turn this into a long interview; recommend directly when the evidence is sufficient. Write nothing until I confirm, then write and verify all three files together.",
-  "projectsNoData": "No observable data",
+  "projectsNoData": "No work items in this view",
   "projectsUnavailable": "Currently unavailable",
   "projectsWorkList": "List",
   "projectsWorkBoard": "Board",
@@ -35,64 +29,19 @@
   "projectsWorkViews": "Work item views",
   "projectsWorkDetails": "Work item details",
   "projectsCloseDetails": "Close details",
-  "projectsNoWork": "No work items explicitly reported by AI",
-  "projectsWorkNeedsSetup": "Set up project observation first so AI can report real progress using this project's workflow.",
-  "projectsWorkNoSessions": "No conversation has started in this project yet. Once substantive project work begins, AI-reported progress will appear here.",
-  "projectsWorkNoReports": "AI has not explicitly reported any work items from the existing project conversations yet. Real progress will appear here as the work continues.",
-  "projectsAiActivity": "AI runs",
-  "projectsAiRun": "Project session",
-  "projectsRunUnreported": "Work item and stage not reported yet",
-  "projectsRunState_running": "Running",
-  "projectsRunState_completed": "Finished",
-  "projectsRunState_failed": "Failed",
-  "projectsRunState_cancelled": "Cancelled",
-  "projectsRunState_idle": "Idle",
-  "projectsStartProjectWork": "Start project work",
-  "projectsStartProjectWorkPrompt": "Start working on this project. First read the project configuration and the materials relevant to this goal; I will add or revise the specific goal before sending.",
-  "projectsBoardNeedsWorkflow": "No workflow stages are available. The board does not invent stages.",
-  "projectsGanttNeedsSchedule": "No schedule markers are available. The Gantt view does not infer dates from files.",
-  "projectsUnstaged": "Stage not reported",
-  "projectsStage": "Stage",
-  "projectsSchedule": "Schedule",
-  "projectsNoArtifacts": "No artifacts matched by configuration or reported by AI",
-  "projectsNoSkills": "No project Skills are available",
-  "projectsNoContext": "No vision or working-rule sources are configured",
-  "projectsRequests": "Waiting for your reply",
-  "projectsConfirm": "Confirm",
-  "projectsReject": "Reject",
-  "projectsResponseSent": "Reply sent; waiting for AI to update",
-  "projectsResponseWaiting": "Replied; waiting for AI to update",
-  "projectsResponseFailed": "Failed to send reply",
+  "projectsNoArtifacts": "No linked artifacts yet. Link a file from a work item to show it here.",
+  "projectsNoSkills": "No project Skills found in .agents/skills",
   "projectsActivity": "Recent activity",
-  "projectsNoActivity": "No AI-reported activity",
-  "projectsOpenSession": "Open source session",
-  "projectsAttention": "Needs attention",
-  "projectsNoAttention": "No open attention signals",
-  "projectsSourceHealth": "Sources and diagnostics",
   "projectsArtifactsCountSuffix": "artifacts",
   "projectsArtifactsSearchPlaceholder": "Search artifacts",
   "projectsArtifactsShowMore": "Show more",
   "projectsArtifactsNoMatches": "No matching artifacts",
-  "projectsArtifactsSort": "Sort",
-  "projectsArtifactsSortUpdatedDesc": "Recently updated",
-  "projectsArtifactsSortUpdatedAsc": "Oldest updated",
-  "projectsArtifactsSortCreatedDesc": "Recently created",
-  "projectsArtifactsSortName": "File name",
   "projectsTimeJustNow": "Just now",
   "projectsTimeMinutesAgo": "{count} minutes ago",
   "projectsTimeHoursAgo": "{count} hours ago",
   "projectsTimeYesterday": "Yesterday",
   "projectsTimeDaysAgo": "{count} days ago",
-  "projectsReadable": "Readable",
   "projectsStatus": "Status",
-  "projectsUpdated": "Updated",
-  "projectsStatus_active": "Active",
-  "projectsStatus_blocked": "Blocked",
-  "projectsStatus_completed": "Completed",
-  "projectsStatus_cancelled": "Cancelled",
-  "projectsSource_available": "Available",
-  "projectsSource_empty": "No data",
-  "projectsSource_error": "Failed",
   "projectsWorkNewItem": "Add a work item",
   "projectsWorkEmpty": "No work items yet. Add one here or ask AI from a project conversation.",
   "projectsWorkShowDeleted": "Show deleted work items",

package/src/shared/lib/i18n/locales/zh-CN/chat.json

@@ -638,5 +638,36 @@
   "chatWorkspaceExcerptCharacterCount": "{count} 个字符",
   "chatInputAttachmentUnsupported": "当前上传流程不支持该文件类型。",
   "chatInputAttachmentTooLarge": "文件不能超过 {maxMb} MB。",
-  "chatInputAttachmentReadFailed": "读取文件失败，请重试。"
+  "chatInputAttachmentReadFailed": "读取文件失败，请重试。",
+  "chatInputVoice": "语音输入",
+  "chatInputVoicePermissionDenied": "麦克风权限被拒绝，请在浏览器或系统中允许后重试。",
+  "chatInputVoiceUnsupported": "当前浏览器不支持语音输入。",
+  "chatInputVoiceNoSpeech": "没有听清，请再试一次。",
+  "chatInputVoiceFailed": "语音输入失败，请重试。",
+  "chatInputVoicePrivacy": "点击录音，文字实时显示在光标处，下划线表示尚未确定的内容。浏览器语音服务可能联网处理声音，不会自动发送。",
+  "chatInputVoiceStart": "开始录音",
+  "chatInputVoiceFinish": "结束录音",
+  "chatInputVoiceCancel": "取消",
+  "chatInputVoiceStarting": "正在连接麦克风…",
+  "chatInputVoiceRecording": "正在聆听",
+  "chatInputVoiceFinishing": "正在完成转写…",
+  "chatInputVoiceReview": "录音已停止",
+  "chatInputVoiceSpeak": "请说话，转写会显示在这里",
+  "chatInputVoiceReviewHint": "已确认的文字保留在草稿中，未确定的片段已撤回。你可以继续编辑或重试。",
+  "chatInputVoiceTranscript": "已识别的文字",
+  "chatInputVoiceInsert": "保留到输入框",
+  "chatInputVoiceRetry": "重试",
+  "chatInputVoiceNetwork": "语音服务连接失败，请检查网络后重试。",
+  "chatInputVoiceDevice": "无法访问麦克风，请检查设备连接和系统权限。",
+  "chatInputVoiceInterrupted": "录音已因离开页面或窗口失焦而停止。",
+  "chatInputVoiceTimeout": "语音服务响应超时，录音已停止，请重试。",
+  "chatInputVoiceShortcut": "语音快捷键",
+  "chatInputVoiceCloseSettings": "关闭设置",
+  "chatInputVoiceBind": "绑定按键",
+  "chatInputVoiceUnbind": "停用",
+  "chatInputVoiceCapture": "请按下快捷键…",
+  "chatInputVoiceCaptureHelp": "支持单字母、F6–F10，或 Ctrl/⌘ + Alt/⌥ + 字母。Esc 取消，Tab 离开。复制、粘贴等常用组合键不接受。",
+  "chatInputVoiceShortcutHelp": "按住说话，松开结束。单键仅在输入框外生效；输入框内可用组合键。仅当前聊天页生效，系统已占用的键可能无法使用。",
+  "chatInputVoiceBindInvalid": "这个按键可能影响正常操作，请选择提示中的按键。",
+  "chatInputVoiceSaveFailed": "无法保存快捷键，请检查浏览器存储权限。"
 }

package/src/shared/lib/i18n/locales/zh-CN/core.json

@@ -15,6 +15,8 @@
   "settingsGroupBasic": "基础配置",
   "settingsGroupAdvanced": "高级配置",
   "appearance": "外观",
+  "keyboardShortcuts": "快捷键",
+  "keyboardShortcutsDesktopOnly": "请在桌面端配置键盘快捷键。手机可使用麦克风按钮输入。",
   "chatMessageLayoutTitle": "消息布局",
   "chatMessageLayoutDescription": "选择聊天消息的展示方式。",
   "chatMessageLayoutCard": "卡片式",

package/src/shared/lib/i18n/locales/zh-CN/projects.json

@@ -6,28 +6,22 @@
   "projectsSkills": "Skills",
   "projectsSkillsCountSuffix": "个 Skills",
   "projectsAgreement": "工作约定",
-  "projectsVisionAndContext": "愿景与上下文",
+  "projectsAgreementFile": "AGENTS.md",
+  "projectsAgreementDescription": "项目工作约定统一来自项目根目录的 AGENTS.md。",
+  "projectsAgreementOpen": "打开工作约定",
+  "projectsNoAgreement": "项目根目录还没有 AGENTS.md",
   "projectsLoading": "正在读取项目…",
   "projectsLoadFailed": "项目读取失败",
   "projectsEmpty": "还没有注册项目",
   "projectsChoose": "选择项目",
+  "projectsMoreActions": "{name} 的更多操作",
   "projectsRemoveFromList": "从项目列表移除",
   "projectsRemoveConfirmTitle": "从项目列表移除",
   "projectsRemoveConfirmDescription": "本地目录、历史会话和项目工作记录不会删除。已有会话仍可在会话列表中使用；以后重新添加同一目录时，会恢复原项目。",
   "projectsRemoveConfirmAction": "移除项目",
   "projectsRemoveSuccess": "项目已从列表移除",
   "projectsRemoveFailed": "项目移除失败",
-  "projectsAsOf": "观测时间",
-  "projectsQuality": "数据质量",
-  "projectsQuality_complete": "完整",
-  "projectsQuality_partial": "部分可用",
-  "projectsQuality_unavailable": "暂不可用",
-  "projectsNoSummary": "项目没有配置摘要，可在工作约定中查看已有来源。",
-  "projectsObservationSetupTitle": "建立项目观察",
-  "projectsObservationSetupDescription": "项目还没有建立观察约定。让 AI 阅读已有材料，推荐工作项流程和产物范围，并同时准备项目配置、常驻规则与项目追踪 Skill；确认后再统一写入。",
-  "projectsObservationSetupAction": "让 AI 帮我建立项目观察",
-  "projectsObservationSetupPrompt": "请按内置的项目观察 setup 规范，为当前项目建立可持续生效的工作追踪约定。先读取已有材料，根据项目实际情况直接给出一套可修改的推荐，完整包含：.nextclaw/project.yaml、根 AGENTS.md 的最小常驻规则，以及 .agents/skills/project-work-tracking/SKILL.md 的项目日常追踪方法。Workflow 描述单个工作项如何推进，不是整个项目的宏观阶段。Marker 必须在节点开始前报告，不能在结束时批量补写。不要反复提问；信息足够时直接推荐。未经我确认不要写入，确认后一次写入并复核三份文件。",
-  "projectsNoData": "暂无可观测数据",
+  "projectsNoData": "当前没有工作项",
   "projectsUnavailable": "暂不可用",
   "projectsWorkList": "列表",
   "projectsWorkBoard": "看板",
@@ -35,64 +29,19 @@
   "projectsWorkViews": "工作项视图",
   "projectsWorkDetails": "工作项详情",
   "projectsCloseDetails": "关闭详情",
-  "projectsNoWork": "暂无 AI 明确报告的工作项",
-  "projectsWorkNeedsSetup": "先建立项目观察配置，AI 才能按这个项目的流程报告真实进展。",
-  "projectsWorkNoSessions": "还没有在这个项目中开始会话。开始实际项目工作后，AI 报告的进展会显示在这里。",
-  "projectsWorkNoReports": "项目会话中还没有 AI 明确报告的工作项。继续实际工作后，真实进展会显示在这里。",
-  "projectsAiActivity": "AI 运行",
-  "projectsAiRun": "项目会话",
-  "projectsRunUnreported": "尚未报告工作项与阶段",
-  "projectsRunState_running": "运行中",
-  "projectsRunState_completed": "已结束",
-  "projectsRunState_failed": "运行失败",
-  "projectsRunState_cancelled": "已中止",
-  "projectsRunState_idle": "空闲",
-  "projectsStartProjectWork": "开始项目工作",
-  "projectsStartProjectWorkPrompt": "请开始处理这个项目。先读取项目配置和与本次目标相关的材料；我会在发送前补充或修改具体目标。",
-  "projectsBoardNeedsWorkflow": "没有可用的 Workflow 阶段；看板不会自动生成阶段。",
-  "projectsGanttNeedsSchedule": "没有 schedule Marker；甘特图不会从文件时间推断日期。",
-  "projectsUnstaged": "未声明阶段",
-  "projectsStage": "阶段",
-  "projectsSchedule": "计划",
-  "projectsNoArtifacts": "暂无配置匹配或 AI 标记的产物",
-  "projectsNoSkills": "项目目录中暂无可用 Skills",
-  "projectsNoContext": "项目没有配置愿景或工作约定来源",
-  "projectsRequests": "等待你回复",
-  "projectsConfirm": "确认",
-  "projectsReject": "拒绝",
-  "projectsResponseSent": "回复已发送，等待 AI 更新",
-  "projectsResponseWaiting": "已回复，等待 AI 更新",
-  "projectsResponseFailed": "回复发送失败",
+  "projectsNoArtifacts": "还没有关联产物。从工作项关联文件后会显示在这里。",
+  "projectsNoSkills": ".agents/skills 中暂无项目 Skills",
   "projectsActivity": "最近动态",
-  "projectsNoActivity": "暂无 AI 报告的动态",
-  "projectsOpenSession": "打开原会话",
-  "projectsAttention": "待关注",
-  "projectsNoAttention": "暂无待关注信号",
-  "projectsSourceHealth": "来源与诊断",
   "projectsArtifactsCountSuffix": "个产物",
   "projectsArtifactsSearchPlaceholder": "搜索产物",
   "projectsArtifactsShowMore": "显示更多",
   "projectsArtifactsNoMatches": "没有匹配的产物",
-  "projectsArtifactsSort": "排序",
-  "projectsArtifactsSortUpdatedDesc": "最近更新",
-  "projectsArtifactsSortUpdatedAsc": "最早更新",
-  "projectsArtifactsSortCreatedDesc": "最近创建",
-  "projectsArtifactsSortName": "文件名",
   "projectsTimeJustNow": "刚刚",
   "projectsTimeMinutesAgo": "{count} 分钟前",
   "projectsTimeHoursAgo": "{count} 小时前",
   "projectsTimeYesterday": "昨天",
   "projectsTimeDaysAgo": "{count} 天前",
-  "projectsReadable": "可读取",
   "projectsStatus": "状态",
-  "projectsUpdated": "更新时间",
-  "projectsStatus_active": "进行中",
-  "projectsStatus_blocked": "受阻",
-  "projectsStatus_completed": "已完成",
-  "projectsStatus_cancelled": "已取消",
-  "projectsSource_available": "可用",
-  "projectsSource_empty": "暂无数据",
-  "projectsSource_error": "读取失败",
   "projectsWorkNewItem": "添加工作项",
   "projectsWorkEmpty": "还没有工作项。你可以在这里添加，也可以在项目会话中让 AI 创建。",
   "projectsWorkShowDeleted": "显示已删除的工作项",

package/src/shared/lib/transport/__tests__/browser-realtime-recovery.service.test.ts

@@ -0,0 +1,42 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { BrowserRealtimeRecoveryService } from '@/shared/lib/transport/browser-realtime-recovery.service';
+
+describe('BrowserRealtimeRecoveryService', () => {
+  afterEach(() => {
+    vi.restoreAllMocks();
+  });
+
+  it('requests recovery only when the page can actively reconnect', () => {
+    let visibilityState: DocumentVisibilityState = 'hidden';
+    vi.spyOn(document, 'visibilityState', 'get').mockImplementation(() => visibilityState);
+    const requestRecovery = vi.fn();
+    const recovery = new BrowserRealtimeRecoveryService(requestRecovery);
+
+    recovery.start();
+    window.dispatchEvent(new Event('online'));
+    expect(requestRecovery).not.toHaveBeenCalled();
+
+    visibilityState = 'visible';
+    document.dispatchEvent(new Event('visibilitychange'));
+    window.dispatchEvent(new Event('online'));
+    expect(requestRecovery).toHaveBeenCalledTimes(2);
+
+    recovery.stop();
+    document.dispatchEvent(new Event('visibilitychange'));
+    expect(requestRecovery).toHaveBeenCalledTimes(2);
+  });
+
+  it('keeps start and stop idempotent', () => {
+    vi.spyOn(document, 'visibilityState', 'get').mockReturnValue('visible');
+    const requestRecovery = vi.fn();
+    const recovery = new BrowserRealtimeRecoveryService(requestRecovery);
+
+    recovery.start();
+    recovery.start();
+    document.dispatchEvent(new Event('visibilitychange'));
+    expect(requestRecovery).toHaveBeenCalledTimes(1);
+
+    recovery.stop();
+    recovery.stop();
+  });
+});

package/src/shared/lib/transport/__tests__/local-transport.service.test.ts

@@ -0,0 +1,85 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { LocalAppTransport } from '@/shared/lib/transport/local-transport.service';
+
+class MockWebSocket {
+  static readonly CONNECTING = 0;
+  static readonly OPEN = 1;
+  static readonly CLOSING = 2;
+  static readonly CLOSED = 3;
+  static instances: MockWebSocket[] = [];
+
+  readyState = MockWebSocket.CONNECTING;
+  onopen: ((event: Event) => void) | null = null;
+  onmessage: ((event: MessageEvent) => void) | null = null;
+  onerror: ((event: Event) => void) | null = null;
+  onclose: ((event: CloseEvent) => void) | null = null;
+
+  constructor(public readonly url: string) {
+    MockWebSocket.instances.push(this);
+  }
+
+  send = vi.fn();
+
+  close = vi.fn(() => {
+    this.readyState = MockWebSocket.CLOSED;
+  });
+
+  open = (): void => {
+    this.readyState = MockWebSocket.OPEN;
+    this.onopen?.({} as Event);
+  };
+
+  finishClose = (): void => {
+    this.readyState = MockWebSocket.CLOSED;
+    this.onclose?.({} as CloseEvent);
+  };
+}
+
+describe('LocalAppTransport browser connection recovery', () => {
+  beforeEach(() => {
+    MockWebSocket.instances = [];
+    vi.stubGlobal('WebSocket', MockWebSocket as unknown as typeof WebSocket);
+  });
+
+  afterEach(() => {
+    vi.restoreAllMocks();
+    vi.unstubAllGlobals();
+  });
+
+  it('replaces a possibly stale open socket when a mobile page becomes visible again', () => {
+    let visibilityState: DocumentVisibilityState = 'hidden';
+    vi.spyOn(document, 'visibilityState', 'get').mockImplementation(() => visibilityState);
+
+    const transport = new LocalAppTransport({ apiBase: 'https://vps.example.com' });
+    const handler = vi.fn();
+    const unsubscribe = transport.subscribe(handler);
+    const staleSocket = MockWebSocket.instances[0];
+    staleSocket?.open();
+
+    visibilityState = 'visible';
+    document.dispatchEvent(new Event('visibilitychange'));
+    window.dispatchEvent(new Event('online'));
+
+    expect(staleSocket?.close).toHaveBeenCalledTimes(1);
+    expect(MockWebSocket.instances).toHaveLength(2);
+    expect(handler).toHaveBeenCalledWith({ type: 'connection.close', payload: {} });
+
+    const replacementSocket = MockWebSocket.instances[1];
+    replacementSocket?.open();
+    staleSocket?.finishClose();
+
+    expect(MockWebSocket.instances).toHaveLength(2);
+    expect(handler).toHaveBeenLastCalledWith({ type: 'connection.open', payload: {} });
+    window.dispatchEvent(new Event('online'));
+    const secondReplacement = MockWebSocket.instances[2];
+    secondReplacement?.open();
+    replacementSocket?.finishClose();
+    const event = { type: 'session.updated', payload: { sessionKey: 'after-second-recovery' } };
+    secondReplacement?.onmessage?.({ data: JSON.stringify(event) } as MessageEvent);
+    expect(handler).toHaveBeenLastCalledWith(event);
+    expect(MockWebSocket.instances).toHaveLength(3);
+    unsubscribe();
+    window.dispatchEvent(new Event('online'));
+    expect(MockWebSocket.instances).toHaveLength(3);
+  });
+});

package/src/shared/lib/transport/__tests__/remote.transport.test.ts

@@ -25,7 +25,6 @@ class MockWebSocket {
 
   close = (): void => {
     this.readyState = MockWebSocket.CLOSED;
-    this.onclose?.({} as CloseEvent);
   }
 
   open = (): void => {
@@ -39,6 +38,11 @@ class MockWebSocket {
     } as MessageEvent);
   }
 
+  finishClose = (): void => {
+    this.readyState = MockWebSocket.CLOSED;
+    this.onclose?.({} as CloseEvent);
+  }
+
   static reset(): void {
     MockWebSocket.instances = [];
   }
@@ -144,4 +148,53 @@ describe('RemoteSessionMultiplexTransport request path', () => {
 
     await timeoutExpectation;
   });
+
+  it('replaces a possibly stale open socket when a mobile page becomes visible again', async () => {
+    let visibilityState: DocumentVisibilityState = 'hidden';
+    vi.spyOn(document, 'visibilityState', 'get').mockImplementation(() => visibilityState);
+    const transport = new RemoteSessionMultiplexTransport({
+      mode: 'remote',
+      protocolVersion: 1,
+      wsPath: '/_remote/ws'
+    }, 'https://remote.claw.cool');
+
+    const handler = vi.fn();
+    const unsubscribe = transport.subscribe(handler);
+    const staleSocket = MockWebSocket.instances[0];
+    staleSocket?.open();
+    await Promise.resolve();
+
+    const pending = transport.request({ method: 'POST', path: '/api/ncp/agent/messages', body: { text: 'once' } });
+    const pendingFailure = expect(pending).rejects.toThrow('connection replaced');
+    await Promise.resolve();
+    expect(staleSocket?.sent).toHaveLength(1);
+
+    visibilityState = 'visible';
+    document.dispatchEvent(new Event('visibilitychange'));
+
+    expect(staleSocket?.readyState).toBe(MockWebSocket.CLOSED);
+    expect(MockWebSocket.instances).toHaveLength(2);
+    expect(handler).toHaveBeenCalledWith({ type: 'connection.close', payload: {} });
+
+    const replacementSocket = MockWebSocket.instances[1];
+    replacementSocket?.open();
+    staleSocket?.finishClose();
+
+    expect(MockWebSocket.instances).toHaveLength(2);
+    expect(handler).toHaveBeenLastCalledWith({ type: 'connection.open', payload: {} });
+    await pendingFailure;
+    await Promise.resolve();
+    expect(replacementSocket?.sent).toHaveLength(0);
+    window.dispatchEvent(new Event('online'));
+    const secondReplacement = MockWebSocket.instances[2];
+    secondReplacement?.open();
+    await Promise.resolve();
+    const recovered = transport.request({ method: 'GET', path: '/api/sessions' });
+    await Promise.resolve();
+    const frame = lastSentRequestFrame(secondReplacement!);
+    secondReplacement?.receive({ type: 'response', id: frame.id, status: 200, body: { ok: true, data: { total: 1 } } });
+    await expect(recovered).resolves.toEqual({ total: 1 });
+    expect(MockWebSocket.instances).toHaveLength(3);
+    unsubscribe();
+  });
 });

package/src/shared/lib/transport/browser-realtime-recovery.service.ts

@@ -0,0 +1,35 @@
+export class BrowserRealtimeRecoveryService {
+  private started = false;
+
+  constructor(private readonly requestRecovery: () => void) {}
+
+  start = (): void => {
+    if (this.started) {
+      return;
+    }
+    this.started = true;
+    document.addEventListener('visibilitychange', this.handleVisibilityChange);
+    window.addEventListener('online', this.handleOnline);
+  };
+
+  stop = (): void => {
+    if (!this.started) {
+      return;
+    }
+    this.started = false;
+    document.removeEventListener('visibilitychange', this.handleVisibilityChange);
+    window.removeEventListener('online', this.handleOnline);
+  };
+
+  private readonly handleVisibilityChange = (): void => {
+    if (document.visibilityState === 'visible') {
+      this.requestRecovery();
+    }
+  };
+
+  private readonly handleOnline = (): void => {
+    if (document.visibilityState === 'visible') {
+      this.requestRecovery();
+    }
+  };
+}