@nextclaw/ui 0.12.7 → 0.12.9

package/src/desktop/desktop-update.types.ts

@@ -7,6 +7,8 @@ export type DesktopUpdateStatus =
   | 'up-to-date'
   | 'failed';
 
+export type DesktopReleaseChannel = 'stable' | 'beta';
+
 export type DesktopUpdatePreferences = {
   automaticChecks: boolean;
   autoDownload: boolean;
@@ -14,6 +16,7 @@ export type DesktopUpdatePreferences = {
 
 export type DesktopUpdateSnapshot = {
   status: DesktopUpdateStatus;
+  channel: DesktopReleaseChannel;
   launcherVersion: string;
   currentVersion: string | null;
   availableVersion: string | null;
@@ -24,6 +27,23 @@ export type DesktopUpdateSnapshot = {
   preferences: DesktopUpdatePreferences;
 };
 
+export type DesktopRuntimeControlResult = {
+  accepted: boolean;
+  action: 'restart-service' | 'restart-app';
+  lifecycle: 'restarting-service' | 'restarting-app';
+  message: string;
+};
+
+export type DesktopPresencePreferences = {
+  closeToBackground: boolean;
+  launchAtLogin: boolean;
+};
+
+export type DesktopPresenceSnapshot = DesktopPresencePreferences & {
+  supportsLaunchAtLogin: boolean;
+  launchAtLoginReason: string | null;
+};
+
 export type NextClawDesktopBridge = {
   platform: string;
   version: string;
@@ -32,5 +52,10 @@ export type NextClawDesktopBridge = {
   downloadUpdate: () => Promise<DesktopUpdateSnapshot>;
   applyDownloadedUpdate: () => Promise<DesktopUpdateSnapshot>;
   updatePreferences: (preferences: Partial<DesktopUpdatePreferences>) => Promise<DesktopUpdateSnapshot>;
+  updateChannel: (channel: DesktopReleaseChannel) => Promise<DesktopUpdateSnapshot>;
+  restartService: () => Promise<DesktopRuntimeControlResult>;
+  restartApp: () => Promise<DesktopRuntimeControlResult>;
+  getPresenceState: () => Promise<DesktopPresenceSnapshot>;
+  updatePresencePreferences: (preferences: Partial<DesktopPresencePreferences>) => Promise<DesktopPresenceSnapshot>;
   onUpdateStateChanged: (listener: (snapshot: DesktopUpdateSnapshot) => void) => () => void;
 };

package/src/desktop/managers/desktop-presence.manager.ts

@@ -0,0 +1,91 @@
+import type {
+  DesktopPresencePreferences,
+  NextClawDesktopBridge
+} from '@/desktop/desktop-update.types';
+import { useDesktopPresenceStore } from '@/desktop/stores/desktop-presence.store';
+import { t } from '@/lib/i18n';
+import { toast } from 'sonner';
+
+export class DesktopPresenceManager {
+  start = async () => {
+    const desktopApi = this.getDesktopApi();
+    if (!desktopApi) {
+      this.markUnsupported();
+      return;
+    }
+
+    useDesktopPresenceStore.setState({
+      supported: true,
+      initialized: false,
+      busyAction: 'loading'
+    });
+
+    try {
+      const snapshot = await desktopApi.getPresenceState();
+      useDesktopPresenceStore.setState({
+        supported: true,
+        initialized: true,
+        busyAction: null,
+        snapshot
+      });
+    } catch (error) {
+      useDesktopPresenceStore.setState({
+        supported: true,
+        initialized: true,
+        busyAction: null
+      });
+      toast.error(`${t('runtimePresenceLoadFailed')}: ${this.getErrorMessage(error)}`);
+    }
+  };
+
+  markUnsupported = () => {
+    useDesktopPresenceStore.setState({
+      supported: false,
+      initialized: true,
+      busyAction: null,
+      snapshot: null
+    });
+  };
+
+  updatePreferences = async (preferences: Partial<DesktopPresencePreferences>) => {
+    const desktopApi = this.getDesktopApi();
+    if (!desktopApi) {
+      throw new Error(t('runtimePresenceLaunchAtLoginUnavailable'));
+    }
+
+    useDesktopPresenceStore.setState({
+      busyAction: 'saving-preferences'
+    });
+
+    try {
+      const snapshot = await desktopApi.updatePresencePreferences(preferences);
+      useDesktopPresenceStore.setState({
+        supported: true,
+        initialized: true,
+        snapshot
+      });
+      toast.success(t('runtimePresenceSaved'));
+      return snapshot;
+    } catch (error) {
+      toast.error(`${t('runtimePresenceSaveFailed')}: ${this.getErrorMessage(error)}`);
+      throw error;
+    } finally {
+      useDesktopPresenceStore.setState({
+        busyAction: null
+      });
+    }
+  };
+
+  private getDesktopApi = (): NextClawDesktopBridge | null => {
+    if (typeof window === 'undefined') {
+      return null;
+    }
+    return window.nextclawDesktop ?? null;
+  };
+
+  private getErrorMessage = (error: unknown): string => {
+    return error instanceof Error ? error.message : t('error');
+  };
+}
+
+export const desktopPresenceManager = new DesktopPresenceManager();

package/src/desktop/managers/desktop-update.manager.ts

@@ -1,4 +1,5 @@
 import type {
+  DesktopReleaseChannel,
   DesktopUpdatePreferences,
   DesktopUpdateSnapshot,
   NextClawDesktopBridge
@@ -7,7 +8,7 @@ import { useDesktopUpdateStore } from '@/desktop/stores/desktop-update.store';
 import { t } from '@/lib/i18n';
 import { toast } from 'sonner';
 
-type DesktopUpdateBusyAction = 'checking' | 'downloading' | 'applying' | 'saving-preferences';
+type DesktopUpdateBusyAction = 'checking' | 'downloading' | 'applying' | 'saving-preferences' | 'switching-channel';
 
 export class DesktopUpdateManager {
   private unsubscribe: (() => void) | null = null;
@@ -125,6 +126,37 @@ export class DesktopUpdateManager {
     }
   };
 
+  updateChannel = async (channel: DesktopReleaseChannel) => {
+    const currentChannel = useDesktopUpdateStore.getState().snapshot?.channel;
+    if (currentChannel === channel) {
+      return;
+    }
+
+    let snapshot: DesktopUpdateSnapshot;
+    try {
+      snapshot = await this.runSnapshotCommand(
+        'switching-channel',
+        t('desktopUpdatesChannelChangeFailed'),
+        async (desktopApi) => await desktopApi.updateChannel(channel)
+      );
+    } catch {
+      return;
+    }
+
+    if (snapshot.status === 'update-available' && snapshot.availableVersion) {
+      toast.success(
+        t('desktopUpdatesChannelChangedWithUpdate')
+          .replace('{channel}', this.getChannelLabel(channel))
+          .replace('{version}', snapshot.availableVersion)
+      );
+      return;
+    }
+
+    toast.success(
+      t('desktopUpdatesChannelChanged').replace('{channel}', this.getChannelLabel(channel))
+    );
+  };
+
   private runSnapshotCommand = async (
     busyAction: DesktopUpdateBusyAction,
     fallbackMessage: string,
@@ -158,6 +190,10 @@ export class DesktopUpdateManager {
   private getErrorMessage = (error: unknown): string => {
     return error instanceof Error ? error.message : t('error');
   };
+
+  private getChannelLabel = (channel: DesktopReleaseChannel): string => {
+    return channel === 'beta' ? t('desktopUpdatesChannelBeta') : t('desktopUpdatesChannelStable');
+  };
 }
 
 export const desktopUpdateManager = new DesktopUpdateManager();

package/src/desktop/stores/desktop-presence.store.ts

@@ -0,0 +1,18 @@
+import type { DesktopPresenceSnapshot } from '@/desktop/desktop-update.types';
+import { create } from 'zustand';
+
+type DesktopPresenceBusyAction = 'loading' | 'saving-preferences' | null;
+
+type DesktopPresenceStoreState = {
+  supported: boolean;
+  initialized: boolean;
+  busyAction: DesktopPresenceBusyAction;
+  snapshot: DesktopPresenceSnapshot | null;
+};
+
+export const useDesktopPresenceStore = create<DesktopPresenceStoreState>(() => ({
+  supported: false,
+  initialized: false,
+  busyAction: null,
+  snapshot: null
+}));

package/src/desktop/stores/desktop-update.store.ts

@@ -1,7 +1,13 @@
 import type { DesktopUpdateSnapshot } from '@/desktop/desktop-update.types';
 import { create } from 'zustand';
 
-type DesktopUpdateBusyAction = 'checking' | 'downloading' | 'applying' | 'saving-preferences' | null;
+type DesktopUpdateBusyAction =
+  | 'checking'
+  | 'downloading'
+  | 'applying'
+  | 'saving-preferences'
+  | 'switching-channel'
+  | null;
 
 type DesktopUpdateStoreState = {
   supported: boolean;

package/src/hooks/server-path/use-server-path-read.ts

@@ -0,0 +1,20 @@
+import { useQuery } from '@tanstack/react-query';
+import { fetchServerPathRead } from '@/api/server-path';
+
+export function useServerPathRead(params: {
+  path?: string | null;
+  basePath?: string | null;
+  enabled?: boolean;
+}) {
+  const normalizedPath = params.path?.trim() ?? '';
+  return useQuery({
+    queryKey: ['server-path-read', normalizedPath, params.basePath ?? null],
+    queryFn: () =>
+      fetchServerPathRead({
+        path: normalizedPath,
+        basePath: params.basePath,
+      }),
+    enabled: (params.enabled ?? true) && normalizedPath.length > 0,
+    staleTime: 0,
+  });
+}

package/src/hooks/use-runtime-control.ts

@@ -0,0 +1,24 @@
+import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
+import type { RuntimeControlView } from '@/api/runtime-control.types';
+import { runtimeControlManager } from '@/runtime-control/runtime-control.manager';
+
+export function useRuntimeControl() {
+  return useQuery({
+    queryKey: ['runtime-control'],
+    queryFn: async (): Promise<RuntimeControlView> => await runtimeControlManager.getControl(),
+    staleTime: 5_000,
+    refetchOnWindowFocus: true
+  });
+}
+
+export function useRuntimeServiceAction() {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (action: 'start-service' | 'restart-service' | 'stop-service') =>
+      await runtimeControlManager.controlService(action),
+    onSuccess: async () => {
+      await queryClient.invalidateQueries({ queryKey: ['runtime-control'] });
+    }
+  });
+}

package/src/lib/chat-message.ts

@@ -24,6 +24,17 @@ function truncateText(value: string, maxChars = 2400): string {
   return `${value.slice(0, maxChars)}\n…`;
 }
 
+function truncateInlineText(value: string, maxChars = 120): string {
+  const normalized = value.replace(/\s+/g, ' ').trim();
+  if (normalized.length <= maxChars) {
+    return normalized;
+  }
+  if (maxChars <= 1) {
+    return '…';
+  }
+  return `${normalized.slice(0, maxChars - 1)}…`;
+}
+
 export function stringifyUnknown(value: unknown): string {
   if (typeof value === 'string') {
     return value;
@@ -64,7 +75,7 @@ export function summarizeToolArgs(args: unknown): string | undefined {
   const parsed = parseArgsObject(args);
   if (!parsed) {
     const text = stringifyUnknown(args).trim();
-    return text ? truncateText(text, 120) : undefined;
+    return text ? truncateInlineText(text, 120) : undefined;
   }
 
   const items: string[] = [];
@@ -80,9 +91,9 @@ export function summarizeToolArgs(args: unknown): string | undefined {
     }
   }
   if (items.length > 0) {
-    return items.join(' · ');
+    return truncateInlineText(items.join(' · '), 120);
   }
-  return truncateText(stringifyUnknown(parsed), 140);
+  return truncateInlineText(stringifyUnknown(parsed), 140);
 }
 
 function toToolName(value: unknown): string {

package/src/lib/desktop-update-labels.utils.ts

@@ -28,9 +28,10 @@ export const DESKTOP_UPDATE_LABELS: Record<string, { zh: string; en: string }> =
   desktopUpdatesStatusUpToDate: { zh: '已是最新', en: 'Up to Date' },
   desktopUpdatesStatusFailed: { zh: '更新失败', en: 'Failed' },
   desktopUpdatesLauncherVersion: { zh: '桌面壳版本', en: 'Launcher Version' },
-  desktopUpdatesCurrentBundleVersion: { zh: '当前产品版本', en: 'Current Product Version' },
+  desktopUpdatesCurrentBundleVersion: { zh: '当前内核版本', en: 'Current Kernel Version' },
   desktopUpdatesAvailableVersion: { zh: '可用版本', en: 'Available Version' },
   desktopUpdatesLastCheckedAt: { zh: '上次检查时间', en: 'Last Checked' },
+  desktopUpdatesCurrentChannel: { zh: '当前更新通道', en: 'Current Release Channel' },
   desktopUpdatesDownloadedBannerTitle: { zh: '更新已就绪', en: 'Update Ready' },
   desktopUpdatesDownloadedBannerDescription: {
     zh: '版本 {version} 已下载完成，等你确认后即可重启应用并完成更新。',
@@ -41,6 +42,22 @@ export const DESKTOP_UPDATE_LABELS: Record<string, { zh: string; en: string }> =
     zh: '默认自动检查更新，但是否后台下载由你决定。',
     en: 'Automatic checks stay on by default, while background download remains under your control.'
   },
+  desktopUpdatesReleaseChannel: { zh: '更新通道', en: 'Release Channel' },
+  desktopUpdatesReleaseChannelHelp: {
+    zh: 'Stable 面向日常主力使用；Beta 用于提前体验新版本，但可能更不稳定。',
+    en: 'Stable is for everyday use, while Beta lets you try newer builds earlier with more risk.'
+  },
+  desktopUpdatesReleaseChannelDowngradeHint: {
+    zh: '切回 Stable 后不会立刻强制降级；只有当 Stable 追平或超过当前版本时，才会继续提供 Stable 更新。',
+    en: 'Switching back to Stable does not force an immediate downgrade. Stable updates resume once that channel catches up with or exceeds your current version.'
+  },
+  desktopUpdatesChannelStable: { zh: 'Stable', en: 'Stable' },
+  desktopUpdatesChannelBeta: { zh: 'Beta', en: 'Beta' },
+  desktopUpdatesBetaBadgeTitle: { zh: '当前正在跟随 Beta 通道', en: 'Following the Beta Channel' },
+  desktopUpdatesBetaBadgeDescription: {
+    zh: '你会更早收到新版本，但也可能遇到更多变动和回归。',
+    en: 'You will receive new versions earlier, but you may also encounter more change and regression risk.'
+  },
   desktopUpdatesAutomaticChecks: { zh: '自动检查更新', en: 'Automatic Update Checks' },
   desktopUpdatesAutomaticChecksHelp: {
     zh: '启动应用后自动检查是否有新版本。',
@@ -65,8 +82,17 @@ export const DESKTOP_UPDATE_LABELS: Record<string, { zh: string; en: string }> =
   desktopUpdatesDownloadFailed: { zh: '下载更新失败', en: 'Failed to download update' },
   desktopUpdatesApplyFailed: { zh: '应用更新失败', en: 'Failed to apply update' },
   desktopUpdatesPreferencesFailed: { zh: '保存更新偏好失败', en: 'Failed to save update preferences' },
+  desktopUpdatesChannelChangeFailed: { zh: '切换更新通道失败', en: 'Failed to change the release channel' },
   desktopUpdatesAlreadyLatest: { zh: '当前已经是最新版本。', en: 'You already have the latest version.' },
   desktopUpdatesReadyToApply: { zh: '更新已下载完成，可以在方便的时候重启应用。', en: 'The update is ready. Restart the app whenever you want to apply it.' },
   desktopUpdatesAvailable: { zh: '发现新版本 {version}。', en: 'Version {version} is available.' },
-  desktopUpdatesUnknownVersion: { zh: '新版本', en: 'a new version' }
+  desktopUpdatesUnknownVersion: { zh: '新版本', en: 'a new version' },
+  desktopUpdatesChannelChanged: {
+    zh: '已切换到 {channel} 更新通道。',
+    en: 'Switched to the {channel} release channel.'
+  },
+  desktopUpdatesChannelChangedWithUpdate: {
+    zh: '已切换到 {channel} 通道，发现版本 {version}。',
+    en: 'Switched to the {channel} channel and found version {version}.'
+  }
 };

package/src/lib/i18n.chat.ts

@@ -43,9 +43,20 @@ export const CHAT_LABELS: Record<string, { zh: string; en: string }> = {
   chatHistoryLoading: { zh: '加载会话历史中...', en: 'Loading session history...' },
   chatNoMessages: { zh: '暂无消息，发送一条开始对话。', en: 'No messages yet. Send one to start.' },
   chatBackToParent: { zh: '返回父会话', en: 'Back to parent' },
+  chatSessionOpenChildSessions: { zh: '查看子会话', en: 'View child sessions' },
   chatChildSessionLoading: { zh: '正在加载子会话…', en: 'Loading child session…' },
   chatChildSessionEmpty: { zh: '子会话还没有消息。', en: 'No child session messages yet.' },
-  chatChildSessionClosePanel: { zh: '关闭子会话侧栏', en: 'Close child session panel' },
+  chatWorkspaceClosePanel: { zh: '关闭工作区侧栏', en: 'Close workspace panel' },
+  chatWorkspaceChildSessions: { zh: '子会话', en: 'Child sessions' },
+  chatWorkspaceOpenFiles: { zh: '打开的文件', en: 'Open files' },
+  chatWorkspacePreview: { zh: '预览', en: 'Preview' },
+  chatWorkspaceDiff: { zh: 'Diff', en: 'Diff' },
+  chatWorkspaceCloseFile: { zh: '关闭文件', en: 'Close file' },
+  chatWorkspaceLoadingFile: { zh: '正在加载文件…', en: 'Loading file…' },
+  chatWorkspacePreviewUnsupported: { zh: '该文件暂不支持在侧栏预览。', en: 'This file is not supported in the sidebar preview yet.' },
+  chatWorkspacePreviewEmpty: { zh: '当前没有可显示的文件内容。', en: 'No file content is available for preview.' },
+  chatWorkspaceDiffEmpty: { zh: '当前没有可显示的 diff 内容。', en: 'No diff content is available.' },
+  chatWorkspacePreviewTruncated: { zh: '内容已截断', en: 'Preview truncated' },
   chatSessionUnread: { zh: '会话有未读更新', en: 'Session has unread updates' },
   chatTyping: { zh: 'Agent 正在思考...', en: 'Agent is thinking...' },
   chatInputPlaceholder: { zh: '输入消息，输入 / 选择技能，Enter 发送，Shift + Enter 换行', en: 'Type a message, type / to select skills, Enter to send, Shift + Enter for newline' },

package/src/lib/i18n.pwa.ts

@@ -0,0 +1,62 @@
+export const PWA_LABELS: Record<string, { zh: string; en: string }> = {
+  pwaInstallTitle: { zh: '安装为应用', en: 'Install as App' },
+  pwaInstallDescription: {
+    zh: '把当前 NextClaw UI 安装为独立入口，方便从桌面、启动器或任务栏直接打开。',
+    en: 'Install this NextClaw UI as a standalone entry point you can launch from your desktop, launcher, or dock.'
+  },
+  pwaInstallAction: { zh: '安装 NextClaw', en: 'Install NextClaw' },
+  pwaInstallDismiss: { zh: '不再提示', en: "Don't Ask Again" },
+  pwaInstallAccepted: { zh: '已打开安装面板。', en: 'Install prompt opened.' },
+  pwaInstalledToast: { zh: 'NextClaw 已安装为应用入口。', en: 'NextClaw is now installed as an app.' },
+  pwaInstallStatusAvailable: { zh: '可安装', en: 'Installable' },
+  pwaInstallStatusInstalled: { zh: '已安装', en: 'Installed' },
+  pwaInstallStatusDesktopHost: { zh: '桌面宿主已接管', en: 'Desktop Host Active' },
+  pwaInstallStatusUnavailable: { zh: '当前不可安装', en: 'Unavailable' },
+  pwaInstallCardPrompt: {
+    zh: '当前浏览器已经准备好安装面板。安装后，NextClaw 会以独立窗口形态打开，但仍沿用同一套 Web UI 和运行时连接逻辑。',
+    en: 'Your browser is ready to install NextClaw. Once installed, it opens in a standalone window while keeping the same Web UI and runtime behavior.'
+  },
+  pwaInstallCardManual: {
+    zh: '当前环境支持把 NextClaw 安装为应用，但浏览器没有提供即时安装弹窗。你仍可通过浏览器菜单中的“安装应用”或“添加到主屏幕”完成安装。',
+    en: 'This environment can install NextClaw as an app, but the browser did not expose an immediate install prompt. Use your browser menu to install or add it to the home screen.'
+  },
+  pwaInstallCardInstalled: {
+    zh: '当前已经以应用形态运行。浏览器访问与已安装形态共用同一套 NextClaw UI，不会分叉成第二套产品逻辑。',
+    en: 'NextClaw is already running as an installed app. Browser access and the installed experience share the same UI and product behavior.'
+  },
+  pwaInstallCardSuppressed: {
+    zh: '当前 UI 已运行在 Electron 桌面宿主中，原生桌面壳优先于 PWA 入口，因此这里不会继续展示安装入口。',
+    en: 'This UI is already running inside the Electron desktop host. The native desktop shell takes priority, so the PWA install entry stays hidden here.'
+  },
+  pwaInstallCardInsecureContext: {
+    zh: '当前地址不是浏览器允许安装 PWA 的安全上下文。请使用 `localhost`、`127.0.0.1` 或 HTTPS 域名访问。',
+    en: 'This address is not a secure context for browser-managed app installation. Use localhost, 127.0.0.1, or an HTTPS origin instead.'
+  },
+  pwaInstallCardDevServer: {
+    zh: '当前是 Vite 开发环境。为避免 service worker 缓存和 HMR 热更新互相干扰，开发态默认关闭 PWA 安装与更新能力；请使用 preview 或正式构建验证 PWA。',
+    en: 'This is the Vite development server. PWA install and update are disabled in dev to avoid service worker caching conflicts with HMR; use preview or a production build to verify the PWA.'
+  },
+  pwaInstallCardUnsupported: {
+    zh: '当前浏览器环境不支持这套安装能力，或缺少 PWA 所需的关键运行能力。',
+    en: 'This browser environment does not support the required installation capabilities for this PWA shell.'
+  },
+  pwaInstallPromptHint: {
+    zh: '安装后仍然连接当前本地或远端 NextClaw 服务，不会额外生成一套离线副本。',
+    en: 'The installed app still connects to the same local or remote NextClaw service instead of creating an offline copy.'
+  },
+  pwaInstallManualHint: {
+    zh: '如果浏览器没有弹出安装面板，请打开浏览器菜单，选择“安装应用”“安装此站点”或“添加到主屏幕”等同类入口。',
+    en: 'If the browser does not show an install prompt, open the browser menu and look for actions such as Install App, Install Site, or Add to Home Screen.'
+  },
+  pwaInstallBannerTitle: { zh: '把 NextClaw 固定成桌面入口', en: 'Pin NextClaw as an App' },
+  pwaInstallBannerDescription: {
+    zh: '当前站点已经满足安装条件。安装后你可以像打开普通应用一样直接进入 NextClaw。',
+    en: 'This site is ready to install. Once installed, you can launch NextClaw like a regular app.'
+  },
+  pwaUpdateBannerTitle: { zh: 'NextClaw 已准备好更新', en: 'NextClaw Update Ready' },
+  pwaUpdateBannerDescription: {
+    zh: '检测到新的 PWA 壳版本，刷新后即可切换到最新 UI 资源。',
+    en: 'A newer PWA shell version is ready. Refresh to switch to the latest UI assets.'
+  },
+  pwaUpdateAction: { zh: '刷新更新', en: 'Refresh Now' }
+};

package/src/lib/i18n.runtime-control.ts

@@ -0,0 +1,120 @@
+export const RUNTIME_CONTROL_LABELS: Record<string, { zh: string; en: string }> = {
+  runtimePageTitle: { zh: '路由与运行时', en: 'Routing & Runtime' },
+  runtimePageDescription: {
+    zh: '对齐 OpenClaw 的多 Agent 路由：绑定规则、Agent 池、私聊范围。',
+    en: 'Align multi-agent routing with OpenClaw: bindings, agent pool, and DM scope.'
+  },
+  runtimeLoading: { zh: '加载运行时配置中...', en: 'Loading runtime settings...' },
+  runtimeControlTitle: { zh: '服务管理', en: 'Service Management' },
+  runtimeControlDescription: {
+    zh: '明确当前服务状态，并在宿主允许的范围内执行启动、重启、停止或桌面应用重启。',
+    en: 'Make the current service state explicit and manage start, restart, stop, or full desktop app restart when the host allows it.'
+  },
+  runtimePresenceTitle: { zh: '运行形态与常驻', en: 'Presence & Lifecycle' },
+  runtimePresenceDescription: {
+    zh: '明确当前环境里“关闭窗口/页面”会发生什么，以及哪些后台能力由宿主层负责。',
+    en: 'Make the current environment explicit: what happens when the window or page closes, and which background behaviors belong to the host.'
+  },
+  runtimePresenceLoading: { zh: '正在读取常驻状态...', en: 'Loading presence settings...' },
+  runtimePresenceLoadFailed: { zh: '读取桌面端常驻状态失败', en: 'Failed to load desktop presence settings' },
+  runtimePresenceBehaviorLabel: { zh: '当前关闭行为', en: 'Current Close Behavior' },
+  runtimePresenceBehaviorBackground: { zh: '关闭窗口时隐藏到后台', en: 'Closing the window hides it to the background' },
+  runtimePresenceBehaviorQuit: { zh: '关闭窗口时退出应用', en: 'Closing the window quits the app' },
+  runtimePresenceCloseToBackground: { zh: '关闭窗口时继续在后台运行', en: 'Keep running in background when closing the window' },
+  runtimePresenceCloseToBackgroundHelp: {
+    zh: '开启后，关闭桌面窗口只会隐藏到托盘，不会停止本地 NextClaw 服务。',
+    en: 'When enabled, closing the desktop window hides it to the tray instead of stopping the local NextClaw service.'
+  },
+  runtimePresenceLaunchAtLogin: { zh: '登录系统时自动启动 NextClaw', en: 'Launch NextClaw at login' },
+  runtimePresenceLaunchAtLoginHelp: {
+    zh: '开启后，桌面端会在登录系统后自动启动，并默认保持后台运行。',
+    en: 'When enabled, the desktop app starts automatically after login and stays in the background by default.'
+  },
+  runtimePresenceLaunchAtLoginUnavailable: {
+    zh: '当前环境暂不支持在这里配置开机自启。',
+    en: 'Launch-at-login is not configurable in this environment yet.'
+  },
+  runtimePresenceSaved: { zh: '桌面端常驻设置已保存', en: 'Desktop presence settings saved' },
+  runtimePresenceSaveFailed: { zh: '保存桌面端常驻设置失败', en: 'Failed to save desktop presence settings' },
+  runtimePresenceManagedLocalTitle: { zh: '浏览器只是本地服务控制面', en: 'The browser is only a control surface for the local service' },
+  runtimePresenceManagedLocalDescription: {
+    zh: '关闭浏览器标签页不会停止本地 NextClaw 服务。服务生命周期由本地受管服务负责，而不是由页面生命周期决定。',
+    en: 'Closing the browser tab does not stop the local NextClaw service. The local managed service owns the lifecycle, not the page.'
+  },
+  runtimePresenceSelfHostedTitle: { zh: '页面不拥有自托管服务生命周期', en: 'The page does not own the self-hosted service lifecycle' },
+  runtimePresenceSelfHostedDescription: {
+    zh: '关闭浏览器页面不会影响自托管实例。服务启停和开机常驻应由宿主环境或部署层管理。',
+    en: 'Closing the browser page does not affect the self-hosted instance. Service start, stop, and auto-start belong to the host environment or deployment layer.'
+  },
+  runtimePresenceSharedTitle: { zh: '共享网页端只暴露状态，不暴露进程控制', en: 'Shared web exposes service state, not process ownership' },
+  runtimePresenceSharedDescription: {
+    zh: '关闭页面只会结束当前连接或会话，不会影响共享服务本体。服务生命周期由平台托管层负责。',
+    en: 'Closing the page only ends the current connection or session, not the shared service itself. The platform owns the lifecycle.'
+  },
+  runtimeControlLoading: { zh: '读取运行时控制能力中...', en: 'Loading runtime control capabilities...' },
+  runtimeControlLoadFailed: { zh: '读取运行时控制状态失败', en: 'Failed to load runtime control state' },
+  runtimeControlServiceRunning: { zh: '服务运行中', en: 'Service running' },
+  runtimeControlServiceStopped: { zh: '服务已停止', en: 'Service stopped' },
+  runtimeControlServiceStarting: { zh: '正在启动服务', en: 'Starting service' },
+  runtimeControlServiceStopping: { zh: '正在停止服务', en: 'Stopping service' },
+  runtimeControlServiceRestarting: { zh: '正在重启服务', en: 'Restarting service' },
+  runtimeControlServiceUnknown: { zh: '服务状态未知', en: 'Service state unknown' },
+  runtimeControlHealthy: { zh: '运行时正常', en: 'Runtime healthy' },
+  runtimeControlStartingService: { zh: '正在启动服务', en: 'Starting service' },
+  runtimeControlRestartingService: { zh: '正在重启服务', en: 'Restarting service' },
+  runtimeControlStoppingService: { zh: '正在停止服务', en: 'Stopping service' },
+  runtimeControlRestartingApp: { zh: '正在重启应用', en: 'Restarting app' },
+  runtimeControlRecovering: { zh: '正在恢复连接', en: 'Recovering connection' },
+  runtimeControlFailed: { zh: '重启失败', en: 'Restart failed' },
+  runtimeControlUnavailable: { zh: '当前不可用', en: 'Currently unavailable' },
+  runtimeControlEnvironmentDesktop: { zh: '桌面端内嵌运行时', en: 'Desktop embedded runtime' },
+  runtimeControlEnvironmentManagedService: { zh: '本地托管服务', en: 'Managed local service' },
+  runtimeControlEnvironmentSelfHosted: { zh: '自托管网页端', en: 'Self-hosted web' },
+  runtimeControlEnvironmentSharedWeb: { zh: '共享网页端', en: 'Shared web' },
+  runtimeControlStartService: { zh: '启动服务', en: 'Start Service' },
+  runtimeControlRestartService: { zh: '重启服务', en: 'Restart Service' },
+  runtimeControlStopService: { zh: '停止服务', en: 'Stop Service' },
+  runtimeControlRestartApp: { zh: '重启应用', en: 'Restart App' },
+  runtimeControlStartingServiceHelp: {
+    zh: '正在启动 NextClaw 服务，页面可能会在服务恢复后重新连接。',
+    en: 'Starting the NextClaw service. The page may reconnect after the service becomes available.'
+  },
+  runtimeControlRestartingServiceHelp: {
+    zh: '正在重启 NextClaw 服务，页面可能会短暂断开。',
+    en: 'Restarting the NextClaw service. The page may disconnect briefly.'
+  },
+  runtimeControlStoppingServiceHelp: {
+    zh: '正在停止 NextClaw 服务，当前页面会很快断开。',
+    en: 'Stopping the NextClaw service. This page will disconnect shortly.'
+  },
+  runtimeControlRestartingAppHelp: {
+    zh: '正在重新启动桌面应用，当前窗口会短暂关闭并立即拉起。',
+    en: 'Restarting the desktop app. The current window will close briefly and relaunch.'
+  },
+  runtimeControlRecoveringHelp: {
+    zh: '正在等待服务恢复连接...',
+    en: 'Waiting for the service to come back...'
+  },
+  runtimeControlRecovered: { zh: '运行时已恢复连接', en: 'Runtime connection restored' },
+  runtimeControlActionFailed: { zh: '服务管理动作失败', en: 'Service management action failed' },
+  runtimeControlRestartAppConfirm: {
+    zh: '这会重启整个 NextClaw 桌面应用，并中断当前窗口。确定继续吗？',
+    en: 'This restarts the entire NextClaw desktop app and interrupts the current window. Continue?'
+  },
+  runtimeControlStopServiceConfirm: {
+    zh: '这会停止当前 NextClaw 服务，当前页面会立即断开。确定继续吗？',
+    en: 'This stops the current NextClaw service and disconnects the page immediately. Continue?'
+  },
+  runtimeRestartAppUnavailable: {
+    zh: '当前环境不支持从前端重启整个应用。',
+    en: 'This environment does not support restarting the entire app from the UI.'
+  },
+  runtimeControlDesktopServiceHint: {
+    zh: '桌面端由 Launcher 持有应用生命周期；普通用户无需单独停止内嵌服务。',
+    en: 'The desktop launcher owns the app lifecycle, so end users do not stop the embedded service separately.'
+  },
+  runtimeRecoveryTimedOut: {
+    zh: '等待运行时恢复超时，请稍后重试或查看日志。',
+    en: 'Timed out waiting for the runtime to recover. Try again or inspect the logs.'
+  }
+};

package/src/lib/i18n.ts

@@ -15,7 +15,9 @@ import {
 import { DESKTOP_UPDATE_LABELS } from './desktop-update-labels.utils';
 import { MARKETPLACE_LABELS } from './i18n.marketplace';
 import { PATH_PICKER_LABELS } from './i18n-runtime/i18n.path-picker';
+import { PWA_LABELS } from './i18n.pwa';
 import { REMOTE_LABELS } from './i18n.remote';
+import { RUNTIME_CONTROL_LABELS } from './i18n.runtime-control';
 import { SEARCH_LABELS } from './i18n.search';
 export type { I18nLanguage };
 export { getLanguage, getLocale, initializeI18n, LANGUAGE_OPTIONS, resolveInitialLanguage, setLanguage, subscribeLanguageChange };
@@ -23,7 +25,6 @@ export function formatDateTime(value?: string | Date, lang: I18nLanguage = getLa
   if (!value) {
     return '-';
   }
-
   const date = value instanceof Date ? value : new Date(value);
   if (Number.isNaN(date.getTime())) {
     return typeof value === 'string' ? value : '-';
@@ -301,10 +302,7 @@ export const LABELS: Record<string, { zh: string; en: string }> = {
   authRetryStatus: { zh: '重试', en: 'Retry' },
   authStatusLoadFailed: { zh: '无法获取认证状态，请检查 UI 服务是否正常。', en: 'Failed to load authentication status. Check whether the UI server is healthy.' },
 
-  // Runtime
-  runtimePageTitle: { zh: '路由与运行时', en: 'Routing & Runtime' },
-  runtimePageDescription: { zh: '对齐 OpenClaw 的多 Agent 路由：绑定规则、Agent 池、私聊范围。', en: 'Align multi-agent routing with OpenClaw: bindings, agent pool, and DM scope.' },
-  runtimeLoading: { zh: '加载运行时配置中...', en: 'Loading runtime settings...' },
+  ...RUNTIME_CONTROL_LABELS,
   authSecurityTitle: { zh: 'Security', en: 'Security' },
   authSecurityDescription: {
     zh: '保持本机控制台默认简单；只有在你需要远程暴露时，再给 UI 加一层登录门。',
@@ -519,7 +517,6 @@ export const LABELS: Record<string, { zh: string; en: string }> = {
   enterTag: { zh: '输入后按回车...', en: 'Type and press Enter...' },
   headerName: { zh: 'Header 名称', en: 'Header Name' },
   headerValue: { zh: 'Header 值', en: 'Header Value' },
-
   // Doc Browser
   docBrowserTitle: { zh: '内嵌浏览器', en: 'Embedded Browser' },
   docBrowserSearchPlaceholder: { zh: '搜索，也可以输入文档地址直接打开', en: 'Search, or enter a doc URL to open' },
@@ -533,6 +530,7 @@ export const LABELS: Record<string, { zh: string; en: string }> = {
   docBrowserCloseTab: { zh: '关闭标签', en: 'Close Tab' },
   docBrowserTabUntitled: { zh: '未命名', en: 'Untitled' },
   ...PATH_PICKER_LABELS,
+  ...PWA_LABELS,
   ...CHANNEL_AUTH_LABELS,
 };
 

package/src/main.tsx

@@ -1,7 +1,7 @@
 import { StrictMode } from 'react';
 import { createRoot } from 'react-dom/client';
 import { BrowserRouter } from 'react-router-dom';
-import App from './App';
+import App from './app';
 import { I18nProvider } from '@/components/providers/I18nProvider';
 import { ThemeProvider } from '@/components/providers/ThemeProvider';
 import './index.css';