@nextclaw/ui 0.12.8 → 0.12.9

package/src/components/chat/presenter/chat-presenter-context.tsx

@@ -1,4 +1,8 @@
-import type { ChatComposerNode, ChatToolActionViewModel } from '@nextclaw/agent-chat-ui';
+import type {
+  ChatComposerNode,
+  ChatFileOpenActionViewModel,
+  ChatToolActionViewModel,
+} from '@nextclaw/agent-chat-ui';
 import type { NcpDraftAttachment } from '@nextclaw/ncp-react';
 import { createContext, useContext } from 'react';
 import type { ReactNode } from 'react';
@@ -37,9 +41,16 @@ export type ChatThreadManagerLike = {
   deleteSession: () => void;
   createSession: () => void;
   goToProviders: () => void;
+  openChildSessionPanel: (params: {
+    parentSessionKey: string;
+    activeChildSessionKey?: string | null;
+  }) => void;
+  openFilePreview: (action: ChatFileOpenActionViewModel) => void;
   openSessionFromToolAction: (action: ChatToolActionViewModel) => void;
   selectChildSessionDetail: (sessionKey: string) => void;
-  closeChildSessionDetail: () => void;
+  selectWorkspaceFile: (fileKey: string) => void;
+  closeWorkspaceFile: (fileKey: string) => void;
+  closeWorkspacePanel: () => void;
   goToParentSession: () => void;
 };
 

package/src/components/chat/session-header/chat-session-header-actions.test.tsx

@@ -6,6 +6,7 @@ import { ChatSessionHeaderActions } from '@/components/chat/session-header/chat-
 const mocks = vi.hoisted(() => ({
   updateSessionProject: vi.fn(),
   onDeleteSession: vi.fn(),
+  onOpenChildSessions: vi.fn(),
 }));
 
 vi.mock('@/components/chat/hooks/use-chat-session-project', () => ({
@@ -20,6 +21,7 @@ describe('ChatSessionHeaderActions', () => {
   beforeEach(() => {
     mocks.updateSessionProject.mockReset();
     mocks.onDeleteSession.mockReset();
+    mocks.onOpenChildSessions.mockReset();
   });
 
   it('keeps only the set-project action in the more-actions menu when a project is already attached', async () => {
@@ -31,6 +33,8 @@ describe('ChatSessionHeaderActions', () => {
         canDeleteSession
         isDeletePending={false}
         projectRoot="/tmp/project-alpha"
+        childSessionCount={0}
+        onOpenChildSessions={mocks.onOpenChildSessions}
         onDeleteSession={mocks.onDeleteSession}
       />
     );
@@ -51,6 +55,8 @@ describe('ChatSessionHeaderActions', () => {
         canDeleteSession={false}
         isDeletePending={false}
         projectRoot={null}
+        childSessionCount={0}
+        onOpenChildSessions={mocks.onOpenChildSessions}
         onDeleteSession={mocks.onDeleteSession}
       />
     );
@@ -60,4 +66,24 @@ describe('ChatSessionHeaderActions', () => {
     expect(screen.getByText('Set Project Directory')).toBeTruthy();
     expect(screen.queryByText('Clear Project Directory')).toBeNull();
   });
+
+  it('shows a dedicated child-session entry button when the current session has child sessions', async () => {
+    const user = userEvent.setup();
+
+    render(
+      <ChatSessionHeaderActions
+        sessionKey="session-children"
+        canDeleteSession
+        isDeletePending={false}
+        projectRoot={null}
+        childSessionCount={2}
+        onOpenChildSessions={mocks.onOpenChildSessions}
+        onDeleteSession={mocks.onDeleteSession}
+      />
+    );
+
+    await user.click(screen.getByRole('button', { name: 'View child sessions' }));
+
+    expect(mocks.onOpenChildSessions).toHaveBeenCalledTimes(1);
+  });
 });

package/src/components/chat/session-header/chat-session-header-actions.tsx

@@ -1,5 +1,5 @@
 import { useState } from 'react';
-import { FolderOpen, MoreHorizontal, Trash2 } from 'lucide-react';
+import { FolderOpen, GitBranch, MoreHorizontal, Trash2 } from 'lucide-react';
 import { Button } from '@/components/ui/button';
 import { Popover, PopoverContent, PopoverTrigger } from '@/components/ui/popover';
 import { useChatSessionProject } from '@/components/chat/hooks/use-chat-session-project';
@@ -12,6 +12,8 @@ type ChatSessionHeaderActionsProps = {
   canDeleteSession: boolean;
   isDeletePending: boolean;
   projectRoot?: string | null;
+  childSessionCount?: number;
+  onOpenChildSessions?: () => void;
   onDeleteSession: () => void;
 };
 
@@ -20,6 +22,8 @@ export function ChatSessionHeaderActions({
   canDeleteSession,
   isDeletePending,
   projectRoot,
+  childSessionCount = 0,
+  onOpenChildSessions,
   onDeleteSession,
 }: ChatSessionHeaderActionsProps) {
   const updateSessionProject = useChatSessionProject();
@@ -46,6 +50,20 @@ export function ChatSessionHeaderActions({
 
   return (
     <>
+      {childSessionCount > 0 && onOpenChildSessions ? (
+        <Button
+          type="button"
+          variant="ghost"
+          size="icon"
+          className="rounded-lg shrink-0 text-gray-400 hover:text-gray-700"
+          aria-label={t('chatSessionOpenChildSessions')}
+          title={t('chatSessionOpenChildSessions')}
+          onClick={onOpenChildSessions}
+          disabled={isBusy}
+        >
+          <GitBranch className="h-4 w-4" />
+        </Button>
+      ) : null}
       <Popover open={isMenuOpen} onOpenChange={setIsMenuOpen}>
         <PopoverTrigger asChild>
           <Button

package/src/components/chat/stores/chat-thread.store.ts

@@ -1,6 +1,7 @@
 import { create } from 'zustand';
 import type { MutableRefObject } from 'react';
 import type { NcpMessage } from '@nextclaw/ncp';
+import type { ChatFileOperationLineViewModel } from '@nextclaw/agent-chat-ui';
 import type { ChatModelOption } from '@/components/chat/chat-input.types';
 import type { AgentProfileView } from '@/api/types';
 
@@ -11,6 +12,23 @@ export type ChatChildSessionTab = {
   agentId?: string | null;
 };
 
+export type ChatWorkspaceFileTab = {
+  key: string;
+  parentSessionKey: string | null;
+  path: string;
+  label?: string | null;
+  viewMode: 'preview' | 'diff';
+  line?: number | null;
+  column?: number | null;
+  rawText?: string | null;
+  beforeText?: string | null;
+  afterText?: string | null;
+  patchText?: string | null;
+  oldStartLine?: number | null;
+  newStartLine?: number | null;
+  fullLines?: ChatFileOperationLineViewModel[];
+};
+
 export type ChatThreadSnapshot = {
   isProviderStateResolved: boolean;
   modelOptions: ChatModelOption[];
@@ -34,8 +52,11 @@ export type ChatThreadSnapshot = {
   isAwaitingAssistantOutput: boolean;
   parentSessionKey?: string | null;
   parentSessionLabel?: string | null;
+  workspacePanelParentKey?: string | null;
   childSessionTabs: ChatChildSessionTab[];
   activeChildSessionKey?: string | null;
+  workspaceFileTabs: ChatWorkspaceFileTab[];
+  activeWorkspaceFileKey?: string | null;
 };
 
 type ChatThreadStore = {
@@ -66,8 +87,11 @@ const initialSnapshot: ChatThreadSnapshot = {
   isAwaitingAssistantOutput: false,
   parentSessionKey: null,
   parentSessionLabel: null,
+  workspacePanelParentKey: null,
   childSessionTabs: [],
   activeChildSessionKey: null,
+  workspaceFileTabs: [],
+  activeWorkspaceFileKey: null,
 };
 
 export const useChatThreadStore = create<ChatThreadStore>((set) => ({

package/src/components/config/RuntimeConfig.tsx

@@ -1,6 +1,6 @@
 import { useEffect, useMemo, useState } from 'react';
 import { useConfig, useConfigSchema, useUpdateRuntime } from '@/hooks/useConfig';
-import type { AgentBindingView, AgentProfileView } from '@/api/types';
+import type { AgentBindingView, AgentProfileView, RuntimeEntryView } from '@/api/types';
 import { Button } from '@/components/ui/button';
 import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card';
 import { RuntimeControlCard } from '@/components/config/runtime-control-card';
@@ -19,11 +19,16 @@ import {
 import { hintForPath } from '@/lib/config-hints';
 import { t } from '@/lib/i18n';
 import { PageLayout, PageHeader } from '@/components/layout/page-layout';
+import { PwaInstallCard } from '@/pwa/components/pwa-install-entry';
 import { Plus, Save, Trash2 } from 'lucide-react';
 import { toast } from 'sonner';
 
 type DmScope = 'main' | 'per-peer' | 'per-channel-peer' | 'per-account-channel-peer';
 type PeerKind = '' | 'direct' | 'group' | 'channel';
+type RuntimeEntryDraft = RuntimeEntryView & {
+  id: string;
+  configText: string;
+};
 
 const DM_SCOPE_OPTIONS: Array<{ value: DmScope; label: string }> = [
   { value: 'main', label: 'main' },
@@ -32,12 +37,25 @@ const DM_SCOPE_OPTIONS: Array<{ value: DmScope; label: string }> = [
   { value: 'per-account-channel-peer', label: 'per-account-channel-peer' }
 ];
 
+const DEFAULT_NARP_STDIO_ENTRY_CONFIG = {
+  wireDialect: 'acp',
+  processScope: 'per-session',
+  command: '',
+  args: ['acp'],
+  env: {},
+  cwd: '',
+  startupTimeoutMs: 8000,
+  probeTimeoutMs: 3000,
+  requestTimeoutMs: 120000
+};
+
 function RuntimeConfigOverview() {
   return (
     <>
       <PageHeader title={t('runtimePageTitle')} description={t('runtimePageDescription')} />
       <RuntimeControlCard />
       <RuntimePresenceCard />
+      <PwaInstallCard />
     </>
   );
 }
@@ -49,6 +67,7 @@ export function RuntimeConfig() {
 
   const [agents, setAgents] = useState<AgentProfileView[]>([]);
   const [bindings, setBindings] = useState<AgentBindingView[]>([]);
+  const [runtimeEntries, setRuntimeEntries] = useState<RuntimeEntryDraft[]>([]);
   const [dmScope, setDmScope] = useState<DmScope>('per-channel-peer');
   const [defaultContextTokens, setDefaultContextTokens] = useState(200000);
   const [defaultEngine, setDefaultEngine] = useState('native');
@@ -59,6 +78,16 @@ export function RuntimeConfig() {
     }
     setAgents((config.agents.list ?? []).map(hydrateRuntimeAgent));
     setBindings((config.bindings ?? []).map(hydrateRuntimeBinding));
+    setRuntimeEntries(
+      Object.entries(config.agents.runtimes?.entries ?? {}).map(([id, entry]) => ({
+        id,
+        enabled: entry.enabled !== false,
+        label: entry.label ?? '',
+        type: entry.type,
+        config: entry.config ?? {},
+        configText: JSON.stringify(entry.config ?? {}, null, 2)
+      }))
+    );
     setDmScope((config.session?.dmScope as DmScope) ?? 'per-channel-peer');
     setDefaultContextTokens(config.agents.defaults.contextTokens ?? 200000);
     setDefaultEngine(config.agents.defaults.engine ?? 'native');
@@ -72,6 +101,7 @@ export function RuntimeConfig() {
   const agentEngineHint = hintForPath('agents.list.*.engine', uiHints);
   const agentsHint = hintForPath('agents.list', uiHints);
   const bindingsHint = hintForPath('bindings', uiHints);
+  const runtimeEntriesHint = hintForPath('agents.runtimes.entries', uiHints);
 
   const knownAgentIds = useMemo(() => {
     const ids = new Set<string>(['main']);
@@ -91,6 +121,29 @@ export function RuntimeConfig() {
   const updateBinding = (index: number, next: AgentBindingView) => {
     setBindings((prev) => prev.map((binding, cursor) => (cursor === index ? next : binding)));
   };
+
+  const updateRuntimeEntry = (index: number, patch: Partial<RuntimeEntryDraft>) => {
+    setRuntimeEntries((prev) => prev.map((entry, cursor) => (cursor === index ? { ...entry, ...patch } : entry)));
+  };
+
+  const removeRuntimeEntry = (index: number) => {
+    setRuntimeEntries((prev) => prev.filter((_, cursor) => cursor !== index));
+  };
+
+  const addRuntimeEntry = () => {
+    setRuntimeEntries((prev) => [
+      ...prev,
+      {
+        id: '',
+        enabled: true,
+        label: '',
+        type: 'narp-stdio',
+        config: DEFAULT_NARP_STDIO_ENTRY_CONFIG,
+        configText: JSON.stringify(DEFAULT_NARP_STDIO_ENTRY_CONFIG, null, 2)
+      }
+    ]);
+  };
+
   const handleSave = () => {
     try {
       const normalizedAgents = agents.map((agent, index) => {
@@ -150,6 +203,33 @@ export function RuntimeConfig() {
         return normalized;
       });
 
+      const normalizedRuntimeEntries = runtimeEntries.reduce<Record<string, RuntimeEntryView>>((entries, entry, index) => {
+        const id = entry.id.trim();
+        const type = entry.type.trim();
+        if (!id) {
+          throw new Error(`Runtime entry id is required at index ${index}.`);
+        }
+        if (!type) {
+          throw new Error(`Runtime entry type is required for "${id}".`);
+        }
+        if (entries[id]) {
+          throw new Error(`Duplicate runtime entry id: ${id}`);
+        }
+
+        const configValue = entry.configText.trim() ? JSON.parse(entry.configText) : {};
+        if (configValue && (typeof configValue !== 'object' || Array.isArray(configValue))) {
+          throw new Error(`Runtime entry config for "${id}" must be a JSON object.`);
+        }
+
+        entries[id] = {
+          enabled: entry.enabled !== false,
+          ...(entry.label?.trim() ? { label: entry.label.trim() } : {}),
+          type,
+          config: (configValue as Record<string, unknown>) ?? {}
+        };
+        return entries;
+      }, {});
+
       updateRuntime.mutate({
         data: {
           agents: {
@@ -157,7 +237,10 @@ export function RuntimeConfig() {
               contextTokens: Math.max(1000, defaultContextTokens),
               engine: defaultEngine.trim() || 'native'
             },
-            list: normalizedAgents
+            list: normalizedAgents,
+            runtimes: {
+              entries: normalizedRuntimeEntries
+            }
           },
           bindings: normalizedBindings,
           session: {
@@ -228,6 +311,62 @@ export function RuntimeConfig() {
         </CardContent>
       </Card>
 
+      <Card>
+        <CardHeader>
+          <CardTitle>{runtimeEntriesHint?.label ?? 'Runtime Entries'}</CardTitle>
+          <CardDescription>{runtimeEntriesHint?.help ?? '统一管理可见的 runtime entry 与其配置。'}</CardDescription>
+        </CardHeader>
+        <CardContent className="space-y-3">
+          {runtimeEntries.map((entry, index) => (
+            <div key={`${index}-${entry.id || 'runtime-entry'}`} className="rounded-xl border border-gray-200 p-3 space-y-3">
+              <div className="grid grid-cols-1 md:grid-cols-2 gap-3">
+                <Input
+                  value={entry.id}
+                  onChange={(event) => updateRuntimeEntry(index, { id: event.target.value })}
+                  placeholder="entry id，例如 hermes"
+                />
+                <Input
+                  value={entry.label ?? ''}
+                  onChange={(event) => updateRuntimeEntry(index, { label: event.target.value })}
+                  placeholder="展示名称，例如 Hermes"
+                />
+                <Input
+                  value={entry.type}
+                  onChange={(event) => updateRuntimeEntry(index, { type: event.target.value })}
+                  placeholder="runtime type，例如 narp-stdio"
+                />
+                <div className="flex items-center justify-between rounded-lg border border-gray-200 px-3 py-2">
+                  <span className="text-sm text-gray-700">Enabled</span>
+                  <Switch
+                    checked={entry.enabled !== false}
+                    onCheckedChange={(checked) => updateRuntimeEntry(index, { enabled: checked })}
+                  />
+                </div>
+              </div>
+              <div className="space-y-2">
+                <label className="text-sm font-medium text-gray-800">Config JSON</label>
+                <textarea
+                  className="min-h-32 w-full rounded-md border border-gray-200 px-3 py-2 text-sm font-mono"
+                  value={entry.configText}
+                  onChange={(event) => updateRuntimeEntry(index, { configText: event.target.value })}
+                  spellCheck={false}
+                />
+              </div>
+              <div className="flex justify-end">
+                <Button type="button" variant="outline" onClick={() => removeRuntimeEntry(index)}>
+                  <Trash2 className="mr-2 h-4 w-4" />
+                  {t('deleteButton')}
+                </Button>
+              </div>
+            </div>
+          ))}
+          <Button type="button" variant="outline" onClick={addRuntimeEntry}>
+            <Plus className="mr-2 h-4 w-4" />
+            Add Runtime Entry
+          </Button>
+        </CardContent>
+      </Card>
+
       <Card>
         <CardHeader>
           <CardTitle>{agentsHint?.label ?? t('agentList')}</CardTitle>

package/src/components/layout/AppLayout.tsx

@@ -54,7 +54,7 @@ function AppLayoutInner({ children }: AppLayoutProps) {
           ) : (
             <main
               className={cn(
-                'flex-1 custom-scrollbar p-8',
+                'flex-1 custom-scrollbar p-8 pb-24',
                 lockPageScroll ? 'overflow-auto xl:overflow-hidden' : 'overflow-auto'
               )}
             >

package/src/components/providers/ThemeProvider.tsx

@@ -14,6 +14,7 @@ import {
   subscribeThemeChange,
   type UiTheme,
 } from '@/lib/theme';
+import { pwaShellThemeManager } from '@/pwa/managers/pwa-shell-theme.manager';
 
 type ThemeContextValue = {
   theme: UiTheme;
@@ -25,6 +26,10 @@ const ThemeContext = createContext<ThemeContextValue | null>(null);
 export function ThemeProvider({ children }: { children: ReactNode }) {
   const [theme, setThemeState] = useState<UiTheme>(() => initializeTheme());
 
+  useEffect(() => {
+    pwaShellThemeManager.syncTheme(theme);
+  }, [theme]);
+
   useEffect(() => {
     const unsubscribe = subscribeThemeChange((nextTheme) => {
       setThemeState(nextTheme);

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/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/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.ts

@@ -15,6 +15,7 @@ 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';
@@ -24,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 : '-';
@@ -517,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' },
@@ -531,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,
 };