@nextclaw/ui 0.15.25 → 0.15.26

package/src/features/system-status/components/desktop-update-config.tsx

@@ -16,13 +16,15 @@ import {
   type ReleaseNotesLocale,
   type ReleaseNotesSection
 } from '@/features/system-status/utils/update-release-notes.utils';
-import { Download, RefreshCw, RotateCw } from 'lucide-react';
+import { RefreshCw, RotateCw } from 'lucide-react';
 
 const STATUS_LABEL_KEYS: Record<string, string> = {
   checking: 'desktopUpdatesStatusChecking',
   'update-available': 'desktopUpdatesStatusAvailable',
   downloading: 'desktopUpdatesStatusDownloading',
   downloaded: 'desktopUpdatesStatusDownloaded',
+  applying: 'desktopUpdatesStatusApplying',
+  'restart-required': 'desktopUpdatesStatusRestartRequired',
   'up-to-date': 'desktopUpdatesStatusUpToDate',
   blocked: 'desktopUpdatesStatusBlocked',
   failed: 'desktopUpdatesStatusFailed',
@@ -103,7 +105,7 @@ function getStatusLabel(snapshot: UpdateSnapshot): string {
   return t(STATUS_LABEL_KEYS[snapshot.status] ?? 'desktopUpdatesStatusIdle');
 }
 function getStatusTone(status: string): string {
-  if (status === 'downloaded') {
+  if (status === 'downloaded' || status === 'restart-required') {
     return 'bg-emerald-50 text-emerald-700 ring-emerald-100';
   }
   if (status === 'update-available' || status === 'downloading' || status === 'checking') {
@@ -218,9 +220,12 @@ export function DesktopUpdateConfig() {
   const isChecking = busyAction === 'checking';
   const isDownloading = busyAction === 'downloading';
   const isApplying = busyAction === 'applying';
+  const isUpdating = busyAction === 'updating';
   const isSwitchingChannel = busyAction === 'switching-channel';
-  const canDownload = snapshot.status === 'update-available' && !isDownloading && !isApplying;
-  const canApply = snapshot.status === 'downloaded' && !isApplying;
+  const canUpdate = (snapshot.status === 'update-available' || snapshot.status === 'downloaded')
+    && !isDownloading
+    && !isApplying
+    && !isUpdating;
   const overviewStats = [
     [t('runtimeUpdatesHostVersion'), formatVersion(snapshot.hostVersion)],
     [t('desktopUpdatesCurrentBundleVersion'), formatVersion(snapshot.currentVersion)],
@@ -232,7 +237,7 @@ export function DesktopUpdateConfig() {
     <SettingsPage
       title={t('runtimeUpdatesPageTitle')}
       description={t('runtimeUpdatesPageDescription')}
-      actions={<Button variant='outline' onClick={() => void runtimeUpdateManager.checkForUpdates()} disabled={isChecking || isDownloading || isApplying}><RefreshCw className={cn('mr-2 h-4 w-4', isChecking && 'animate-spin')} />{t('desktopUpdatesCheckNow')}</Button>}
+      actions={<Button variant='outline' onClick={() => void runtimeUpdateManager.checkForUpdates()} disabled={isChecking || isDownloading || isApplying || isUpdating}><RefreshCw className={cn('mr-2 h-4 w-4', isChecking && 'animate-spin')} />{t('desktopUpdatesCheckNow')}</Button>}
     >
       <SettingsSection title={t('desktopUpdatesOverviewTitle')} description={t('desktopUpdatesOverviewDescription')}>
         <SettingsGroup>
@@ -278,7 +283,7 @@ export function DesktopUpdateConfig() {
             layout='stacked'
           >
             <div className='space-y-2'>
-              <Select value={snapshot.channel} disabled={isSwitchingChannel || isChecking || isDownloading || isApplying} onValueChange={(value) => void runtimeUpdateManager.updateChannel(value as UpdateSnapshot['channel'])}>
+              <Select value={snapshot.channel} disabled={isSwitchingChannel || isChecking || isDownloading || isApplying || isUpdating} onValueChange={(value) => void runtimeUpdateManager.updateChannel(value as UpdateSnapshot['channel'])}>
                 <SelectTrigger className='w-full max-w-sm'>
                   <SelectValue placeholder={t('desktopUpdatesReleaseChannel')} />
                 </SelectTrigger>
@@ -295,16 +300,12 @@ export function DesktopUpdateConfig() {
       <SettingsSection title={t('desktopUpdatesActionsTitle')} description={t('runtimeUpdatesActionsDescription')}>
         <SettingsGroup>
           <div className='flex flex-wrap items-center gap-3 p-4'>
-            <Button variant='outline' onClick={() => void runtimeUpdateManager.checkForUpdates()} disabled={isChecking || isDownloading || isApplying}>
+            <Button variant='outline' onClick={() => void runtimeUpdateManager.checkForUpdates()} disabled={isChecking || isDownloading || isApplying || isUpdating}>
               <RefreshCw className={cn('mr-2 h-4 w-4', isChecking && 'animate-spin')} />
               {t('desktopUpdatesCheckNow')}
             </Button>
-            <Button onClick={() => void runtimeUpdateManager.downloadUpdate()} disabled={!canDownload}>
-              <Download className={cn('mr-2 h-4 w-4', isDownloading && 'animate-bounce')} />
-              {t('desktopUpdatesDownloadNow')}
-            </Button>
-            <Button variant='secondary' onClick={() => void runtimeUpdateManager.applyDownloadedUpdate()} disabled={!canApply}>
-              <RotateCw className={cn('mr-2 h-4 w-4', isApplying && 'animate-spin')} />
+            <Button onClick={() => void runtimeUpdateManager.updateNow()} disabled={!canUpdate}>
+              <RotateCw className={cn('mr-2 h-4 w-4', isUpdating && 'animate-spin')} />
               {t('runtimeUpdatesApplyNow')}
             </Button>
           </div>

package/src/features/system-status/managers/__tests__/runtime-update.manager.test.ts

@@ -0,0 +1,99 @@
+import type { UpdateSnapshot } from '@nextclaw/shared';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { RuntimeUpdateManager } from '@/features/system-status/managers/runtime-update.manager';
+import { useRuntimeUpdateStore } from '@/features/system-status/stores/runtime-update.store';
+
+const mocks = vi.hoisted(() => ({
+  applyRuntimeUpdate: vi.fn(),
+  checkRuntimeUpdate: vi.fn(),
+  downloadRuntimeUpdate: vi.fn(),
+  fetchRuntimeUpdate: vi.fn(),
+  updateRuntimeUpdateChannel: vi.fn()
+}));
+
+vi.mock('@/shared/lib/api', () => mocks);
+
+const createSnapshot = (patch: Partial<UpdateSnapshot> = {}): UpdateSnapshot => ({
+  status: 'update-available',
+  installationKind: 'npm-runtime-bundle',
+  channel: 'stable',
+  hostVersion: '0.30.0',
+  currentVersion: '0.30.0',
+  availableVersion: '0.31.0',
+  downloadedVersion: null,
+  minimumHostVersion: null,
+  releaseNotesUrl: null,
+  lastCheckedAt: null,
+  progress: null,
+  canApplyInApp: false,
+  requiresRestart: false,
+  blockReason: null,
+  recoveryCommand: null,
+  errorMessage: null,
+  ...patch
+});
+
+describe('RuntimeUpdateManager', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    useRuntimeUpdateStore.setState({
+      supported: false,
+      initialized: false,
+      busyAction: null,
+      snapshot: null
+    });
+    mocks.fetchRuntimeUpdate.mockResolvedValue(createSnapshot());
+  });
+
+  it('downloads and applies an available update from one user action', async () => {
+    const downloaded = createSnapshot({
+      status: 'downloaded',
+      downloadedVersion: '0.31.0',
+      canApplyInApp: true
+    });
+    const applied = createSnapshot({
+      status: 'restart-required',
+      availableVersion: null,
+      downloadedVersion: null,
+      requiresRestart: true
+    });
+    mocks.downloadRuntimeUpdate.mockResolvedValue(downloaded);
+    mocks.applyRuntimeUpdate.mockResolvedValue(applied);
+    const manager = new RuntimeUpdateManager();
+    await manager.start();
+
+    await manager.updateNow();
+
+    expect(mocks.downloadRuntimeUpdate).toHaveBeenCalledTimes(1);
+    expect(mocks.applyRuntimeUpdate).toHaveBeenCalledTimes(1);
+    expect(useRuntimeUpdateStore.getState()).toMatchObject({
+      busyAction: null,
+      snapshot: applied
+    });
+    manager.stop();
+  });
+
+  it('resumes a downloaded update without downloading it again', async () => {
+    const downloaded = createSnapshot({
+      status: 'downloaded',
+      downloadedVersion: '0.31.0',
+      canApplyInApp: true
+    });
+    const applied = createSnapshot({
+      status: 'restart-required',
+      availableVersion: null,
+      downloadedVersion: null,
+      requiresRestart: true
+    });
+    mocks.fetchRuntimeUpdate.mockResolvedValue(downloaded);
+    mocks.applyRuntimeUpdate.mockResolvedValue(applied);
+    const manager = new RuntimeUpdateManager();
+    await manager.start();
+
+    await manager.updateNow();
+
+    expect(mocks.downloadRuntimeUpdate).not.toHaveBeenCalled();
+    expect(mocks.applyRuntimeUpdate).toHaveBeenCalledTimes(1);
+    manager.stop();
+  });
+});

package/src/features/system-status/managers/runtime-update.manager.ts

@@ -208,6 +208,28 @@ export class RuntimeUpdateManager {
     }
   };
 
+  updateNow = async () => {
+    const initialSnapshot = useRuntimeUpdateStore.getState().snapshot;
+    if (initialSnapshot?.status !== 'update-available' && initialSnapshot?.status !== 'downloaded') {
+      return;
+    }
+
+    try {
+      await this.runSnapshotCommand('updating', t('runtimeUpdatesUpdateFailed'), async (source) => {
+        const downloadedSnapshot = initialSnapshot.status === 'downloaded'
+          ? initialSnapshot
+          : await source.downloadUpdate();
+        useRuntimeUpdateStore.setState({ snapshot: downloadedSnapshot });
+        if (downloadedSnapshot.status !== 'downloaded') {
+          return downloadedSnapshot;
+        }
+        return await source.applyDownloadedUpdate();
+      });
+    } catch {
+      return;
+    }
+  };
+
   updateChannel = async (channel: UpdateSnapshot['channel']) => {
     const currentChannel = useRuntimeUpdateStore.getState().snapshot?.channel;
     if (currentChannel === channel) {

package/src/features/system-status/stores/runtime-update.store.ts

@@ -5,6 +5,7 @@ export type RuntimeUpdateBusyAction =
   | 'checking'
   | 'downloading'
   | 'applying'
+  | 'updating'
   | 'switching-channel'
   | null;
 

package/src/shared/components/ui/actions/__tests__/icon-action-button.test.tsx

@@ -34,6 +34,21 @@ describe('IconActionButton', () => {
     expect(button.className).toContain('hover:bg-[var(--interaction-hover)]');
   });
 
+  it('uses surface-relative feedback without introducing a new surface', () => {
+    render(
+      <IconActionButton
+        tone="surface"
+        icon={<span data-testid="icon" />}
+        label="Add project"
+      />,
+    );
+
+    const button = screen.getByRole('button', { name: 'Add project' });
+    expect(button.className).toContain('hover:bg-gray-200/60');
+    expect(button.className).toContain('hover:text-gray-900');
+    expect(button.className).toContain('active:bg-gray-200/80');
+  });
+
   it('ignores restored pointer focus while preserving keyboard tooltip focus', () => {
     render(
       <IconActionButton

package/src/shared/components/ui/actions/icon-action-button.tsx

@@ -8,7 +8,7 @@ import {
 import { cn } from '@/shared/lib/utils';
 
 type IconActionButtonSize = 'sm' | 'md' | 'lg';
-type IconActionButtonTone = 'default' | 'strong';
+type IconActionButtonTone = 'default' | 'surface' | 'strong';
 
 type IconActionButtonProps = Omit<
   React.ButtonHTMLAttributes<HTMLButtonElement>,
@@ -17,7 +17,7 @@ type IconActionButtonProps = Omit<
   icon: React.ReactNode;
   label: string;
   size?: IconActionButtonSize;
-  /** default: soft accent hover. strong: denser gray hover for nested hover surfaces. */
+  /** default: global interaction hover. surface: relative feedback on the current surface. strong: denser feedback for nested hover surfaces. */
   tone?: IconActionButtonTone;
   tooltip?: string | false | null;
   tooltipSide?: 'top' | 'right' | 'bottom' | 'left';
@@ -32,6 +32,8 @@ const SIZE_CLASS: Record<IconActionButtonSize, string> = {
 const TONE_CLASS: Record<IconActionButtonTone, string> = {
   default:
     'text-muted-foreground hover:bg-[var(--interaction-hover)] hover:text-accent-foreground disabled:text-muted-foreground/45 disabled:hover:bg-transparent disabled:hover:text-muted-foreground/45',
+  surface:
+    'text-muted-foreground hover:bg-gray-200/60 hover:text-gray-900 active:bg-gray-200/80 disabled:text-muted-foreground/45 disabled:hover:bg-transparent disabled:hover:text-muted-foreground/45',
   strong:
     'text-muted-foreground hover:bg-black/10 hover:text-foreground disabled:text-muted-foreground/45 disabled:hover:bg-transparent disabled:hover:text-muted-foreground/45',
 };

package/src/shared/hooks/use-system-object-references.ts

@@ -0,0 +1,22 @@
+import { useQuery } from '@tanstack/react-query';
+import { nextclawClient } from '@/shared/lib/api';
+
+export function useSystemObjectReferences(params: {
+  enabled: boolean;
+  query: string;
+  limit?: number;
+  objectType?: string;
+}) {
+  const { enabled, limit, objectType } = params;
+  const query = params.query.trim();
+  return useQuery({
+    queryKey: ['system-object-references', objectType ?? null, query, limit ?? null],
+    queryFn: () => nextclawClient.systemObjectReferences.list({
+      query: query || undefined,
+      limit,
+      objectType,
+    }),
+    enabled,
+    staleTime: 10_000,
+  });
+}

package/src/shared/lib/api/types.ts

@@ -6,6 +6,13 @@ export type {
   ProjectListView,
   ProjectTemplateView,
   ProjectView,
+  SystemObjectReferenceDisplayText,
+  SystemObjectReferenceGroupDescriptor,
+  SystemObjectReferenceGroupIcon,
+  SystemObjectReferenceGroupView,
+  SystemObjectReferenceItem,
+  SystemObjectReferenceListView,
+  SystemObjectResolvedReference,
 } from '@nextclaw/client-sdk';
 export type {
   SessionEntryView,
@@ -461,6 +468,9 @@ export type PanelAppEntryView = {
   clientGranted: boolean;
   lastOpenedAt?: string;
   openCount: number;
+  sourceKind?: 'workspace' | 'package';
+  packageId?: string;
+  packageVersion?: string;
 };
 
 export type PanelAppListView = {

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

@@ -290,20 +290,27 @@
   "chatPanelAppReferenceNoDescription": "No panel app description",
   "chatContextReferenceLoading": "Searching references...",
   "chatContextReferenceSection": "References",
-  "chatContextReferenceNoResult": "No matching files, folders, projects, or panel apps",
-  "chatContextReferenceHint": "Type @ to reference a file, folder, project, or panel app",
+  "chatContextReferenceNoResult": "No matching system objects, files, folders, projects, or panel apps",
+  "chatContextReferenceHint": "Type @ to reference a system object, file, folder, project, or panel app",
   "chatContextReferenceItemHint": "Press Enter to add this reference.",
-  "chatContextReferenceFilesLabel": "Files & Folders",
-  "chatContextReferenceFilesType": "Project Context",
-  "chatContextReferenceFilesDescription": "Search and reference files or folders in the current project.",
-  "chatContextReferenceFilesHint": "Press Enter to browse files and folders.",
+  "chatContextReferenceFilesLabel": "Files",
+  "chatContextReferenceFilesType": "Project Files",
+  "chatContextReferenceFilesDescription": "Browse and reference files in the current project.",
+  "chatContextReferenceFilesHint": "Press Enter to browse files.",
+  "chatContextReferenceFoldersLabel": "Folders",
+  "chatContextReferenceFoldersType": "Project Folders",
+  "chatContextReferenceFoldersDescription": "Browse and reference folders in the current project.",
+  "chatContextReferenceFoldersHint": "Press Enter to browse folders.",
   "chatContextReferenceBack": "Back to all references",
-  "chatContextReferenceBackDescription": "Return to the unified file, folder, project, and panel app reference menu.",
+  "chatContextReferenceBackDescription": "Return to the unified system object, file, folder, project, and panel app reference menu.",
   "chatContextReferenceBackHint": "Press Enter to go back.",
   "chatContextReferenceParent": "Up one folder",
   "chatContextReferenceParentDescription": "Browse the parent folder without closing the reference menu.",
   "chatContextReferenceParentHint": "Press Enter to open the parent folder.",
   "chatContextReferenceCurrentDirectory": "Reference current folder",
+  "chatSystemObjectSection": "System Objects",
+  "chatSystemObjectGroupHint": "Press Enter to browse this category.",
+  "chatSystemObjectResolveFailed": "Could not reference system object",
   "chatContextReferenceFileDescription": "Use this file as explicit context for the current message.",
   "chatContextReferenceDirectoryDescription": "Use this folder as a context scope for the current message.",
   "chatContextReferenceProjectsLabel": "Projects",
@@ -316,8 +323,7 @@
   "chatContextReferenceProjectSection": "Projects",
   "chatContextReferenceProjectsLoadFailed": "Failed to load projects",
   "chatContextReferenceProjectRoot": "Project directory",
-  "chatContextReferenceWorkspaceSection": "Files & Folders",
-  "chatContextReferenceSearchFailed": "File search failed",
+  "chatContextReferenceSearchFailed": "Reference search failed",
   "chatSkillScopeBuiltin": "Built-in",
   "chatSkillScopeGlobal": "Global",
   "chatSkillScopeProject": "Project",
@@ -484,6 +490,7 @@
   "chatSidebarTaskRecords": "Sessions",
   "chatSidebarViewTime": "Time",
   "chatSidebarViewProject": "Project",
+  "chatSidebarViewMode": "Session list view",
   "chatSidebarToday": "Today",
   "chatSidebarYesterday": "Yesterday",
   "chatSidebarPrevious7Days": "Previous 7 Days",

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

@@ -1,18 +1,19 @@
 {
   "updates": "Updates",
   "runtimeUpdatesPageTitle": "Runtime Updates",
-  "runtimeUpdatesPageDescription": "NextClaw checks every two hours; you choose when to download and apply each update.",
+  "runtimeUpdatesPageDescription": "NextClaw checks every two hours; you choose when to start each update.",
   "runtimeUpdatesUnavailableTitle": "Updates Are Currently Unavailable",
   "runtimeUpdatesUnavailableDescription": "This runtime environment does not currently expose an update host.",
   "runtimeUpdatesUnavailableHint": "The update entry appears automatically once the host supports updates.",
   "runtimeUpdatesHostVersion": "Host Version",
-  "runtimeUpdatesDownloadedBannerDescription": "Version {version} has finished downloading and is ready to switch over when you confirm.",
-  "runtimeUpdatesActionsDescription": "Manually check, manually download, and switch to a downloaded version whenever you are ready.",
+  "runtimeUpdatesDownloadedBannerDescription": "Version {version} has finished downloading and is ready to finish updating.",
+  "runtimeUpdatesActionsDescription": "Check manually, then complete the update in one action whenever you are ready.",
   "runtimeUpdatesApplyNow": "Update Now",
   "runtimeUpdatesLoadFailed": "Failed to load update state",
   "runtimeUpdatesCheckFailed": "Failed to check for updates",
   "runtimeUpdatesDownloadFailed": "Failed to download update",
   "runtimeUpdatesApplyFailed": "Failed to apply update",
+  "runtimeUpdatesUpdateFailed": "Failed to update",
   "runtimeUpdatesChannelChangeFailed": "Failed to change the release channel",
   "runtimeUpdatesAlreadyLatest": "You already have the latest version.",
   "runtimeUpdatesReadyToApply": "The update is ready and can be applied now.",
@@ -33,6 +34,8 @@
   "desktopUpdatesStatusAvailable": "Update Available",
   "desktopUpdatesStatusDownloading": "Downloading",
   "desktopUpdatesStatusDownloaded": "Downloaded",
+  "desktopUpdatesStatusApplying": "Updating",
+  "desktopUpdatesStatusRestartRequired": "Restart Required",
   "desktopUpdatesStatusUpToDate": "Up to Date",
   "desktopUpdatesStatusBlocked": "Blocked",
   "desktopUpdatesStatusFailed": "Failed",
@@ -64,7 +67,7 @@
   "desktopUpdatesBlockedRootCause.host-too-old": "Root cause: the host is too old for this runtime bundle; upgrade the NextClaw launcher first.",
   "desktopUpdatesBlockedRootCause.unsupported-installation": "Root cause: this installation or update source does not support auto-update; use a configured build.",
   "desktopUpdatesChannelSettingsTitle": "Update Channel",
-  "desktopUpdatesChannelSettingsDescription": "NextClaw checks every two hours; downloading and applying always require your action.",
+  "desktopUpdatesChannelSettingsDescription": "NextClaw checks every two hours; you choose when an update starts.",
   "desktopUpdatesReleaseChannel": "Release Channel",
   "desktopUpdatesReleaseChannelHelp": "Stable is for everyday use, while Beta lets you try newer builds earlier with more risk.",
   "desktopUpdatesReleaseChannelDowngradeHint": "Switching back to Stable does not force an immediate downgrade. Stable updates resume once that channel catches up with or exceeds your current version.",

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

@@ -29,6 +29,46 @@
   "sideDockVisibilityTitle": "Show SideDock",
   "sideDockVisibilityDescription": "Keep the right shortcut dock visible beside the workspace.",
   "appsTitle": "Apps",
+  "appPackagesLibraryTitle": "Your apps",
+  "appPackagesLibraryDescription": "Enable apps when you need them and open them here. App data stays in a separate local directory.",
+  "appPackagesLoading": "Loading apps…",
+  "appPackagesLoadFailed": "Failed to load apps",
+  "appPackagesRefresh": "Refresh apps",
+  "appPackagesBrowse": "Browse apps",
+  "appPackagesMarketplaceTitle": "Browse Mini APPs",
+  "appPackagesMarketplaceDescription": "Discover apps from the official NextClaw registry and install them in one step.",
+  "appPackagesMarketplaceSearch": "Search apps, features, or tags",
+  "appPackagesMarketplaceLoading": "Loading the app marketplace…",
+  "appPackagesMarketplaceFailed": "The app marketplace is temporarily unavailable. You can still install from a trusted source.",
+  "appPackagesMarketplaceEmpty": "No matching apps found",
+  "appPackagesMarketplaceFeatured": "Featured",
+  "appPackagesMarketplaceDetails": "Details",
+  "appPackagesMarketplaceInstalled": "Installed",
+  "appPackagesMarketplaceTrustHint": "Apps are downloaded from the official registry. Review the app details before enabling a Service that can run local code.",
+  "appPackagesInstall": "Install app",
+  "appPackagesInstallTitle": "Install a Mini APP",
+  "appPackagesInstallDescription": "Enter a trusted .napp file, local app directory, or Marketplace install URL.",
+  "appPackagesInstallSource": "Install source",
+  "appPackagesInstallPlaceholder": "File path or https:// install URL",
+  "appPackagesInstallTrustHint": "Only install sources you trust. Apps with a Service can run local code, and start only after you enable them.",
+  "appPackagesInstalling": "Installing…",
+  "appPackagesEmptyTitle": "No apps available yet",
+  "appPackagesEmptyDescription": "Install a Mini APP, or upgrade to a NextClaw version that includes built-in apps.",
+  "appPackagesEnabled": "Enabled",
+  "appPackagesAvailable": "Available",
+  "appPackagesBuiltIn": "Built into NextClaw",
+  "appPackagesLocalService": "Local data service",
+  "appPackagesEnable": "Enable",
+  "appPackagesDisable": "Disable",
+  "appPackagesWorking": "Working…",
+  "appPackagesEnableToOpen": "Enable this app to open it",
+  "appPackagesMoreActions": "More app actions",
+  "appPackagesCheckUpdate": "Check for updates",
+  "appPackagesRollback": "Switch to",
+  "appPackagesUninstall": "Uninstall",
+  "appPackagesUninstallTitle": "Uninstall this app?",
+  "appPackagesUninstallDescription": "The app code will be removed. Personal data is kept by default so a future reinstall can continue using it.",
+  "appPackagesActionFailed": "App action failed",
   "panelAppsTitle": "Panel Apps",
   "panelAppsLoading": "Loading panel apps...",
   "panelAppsLoadFailed": "Failed to load panel apps",

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

@@ -44,6 +44,9 @@
   "marketplaceNoInstalledMcp": "No installed MCP servers found.",
   "marketplaceUninstallTitle": "Uninstall",
   "marketplaceUninstallDescription": "This will remove the extension. You can install it again from the marketplace.",
+  "marketplaceUpdateConflictTitle": "Overwrite local changes and update?",
+  "marketplaceUpdateConflictDescription": "This skill was changed after installation. Continuing replaces local changes in its skill directory with the latest marketplace version. Canceling leaves the current files unchanged.",
+  "marketplaceUpdateConflictConfirm": "Overwrite and Update",
   "marketplaceInstallSuccessSkill": "Skill installed successfully",
   "marketplaceInstallSuccessMcp": "MCP installed successfully",
   "marketplaceEnableSuccess": "Enabled successfully",

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

@@ -250,7 +250,7 @@
   "chatProcessSummaryCancelled": "已取消",
   "chatRuntimeInitializing": "聊天能力正在初始化。你可以先输入内容，完成后即可发送。",
   "chatRuntimeInitializationFailed": "聊天能力启动失败，请稍后重试或检查服务日志。",
-  "chatInputPlaceholder": "输入消息，/ 选命令、应用或技能，@ 引用文件、目录、项目或面板应用，Enter 发送，Shift + Enter 换行",
+  "chatInputPlaceholder": "输入消息，/ 选命令、应用或技能，@ 引用文件、文件夹、项目或面板应用，Enter 发送，Shift + Enter 换行",
   "chatInputPlaceholderCompact": "发消息...",
   "chatWelcomeInputPlaceholder": "描述你想完成的目标……",
   "chatInputHint": "支持多轮上下文，默认走当前会话。",
@@ -290,22 +290,29 @@
   "chatPanelAppReferenceNoDescription": "暂无面板应用描述",
   "chatContextReferenceLoading": "搜索引用中…",
   "chatContextReferenceSection": "引用",
-  "chatContextReferenceNoResult": "没有匹配的文件、目录、项目或面板应用",
-  "chatContextReferenceHint": "输入 @ 引用文件、目录、项目或面板应用",
+  "chatContextReferenceNoResult": "没有匹配的系统对象、文件、文件夹、项目或面板应用",
+  "chatContextReferenceHint": "输入 @ 引用系统对象、文件、文件夹、项目或面板应用",
   "chatContextReferenceItemHint": "回车添加这个引用。",
-  "chatContextReferenceFilesLabel": "文件与文件夹",
-  "chatContextReferenceFilesType": "项目上下文",
-  "chatContextReferenceFilesDescription": "搜索并引用当前项目中的文件或目录。",
-  "chatContextReferenceFilesHint": "回车进入文件与文件夹。",
+  "chatContextReferenceFilesLabel": "文件",
+  "chatContextReferenceFilesType": "项目文件",
+  "chatContextReferenceFilesDescription": "浏览并引用当前项目中的文件。",
+  "chatContextReferenceFilesHint": "回车进入文件列表。",
+  "chatContextReferenceFoldersLabel": "文件夹",
+  "chatContextReferenceFoldersType": "项目文件夹",
+  "chatContextReferenceFoldersDescription": "浏览并引用当前项目中的文件夹。",
+  "chatContextReferenceFoldersHint": "回车进入文件夹列表。",
   "chatContextReferenceBack": "返回全部引用",
-  "chatContextReferenceBackDescription": "返回文件、目录、项目和面板应用的统一引用入口。",
+  "chatContextReferenceBackDescription": "返回系统对象、文件、文件夹、项目和面板应用的统一引用入口。",
   "chatContextReferenceBackHint": "回车返回。",
   "chatContextReferenceParent": "返回上一级",
   "chatContextReferenceParentDescription": "在不关闭引用菜单的情况下浏览上一级文件夹。",
   "chatContextReferenceParentHint": "回车打开上一级文件夹。",
   "chatContextReferenceCurrentDirectory": "引用当前文件夹",
+  "chatSystemObjectSection": "系统对象",
+  "chatSystemObjectGroupHint": "回车进入该分类。",
+  "chatSystemObjectResolveFailed": "无法引用系统对象",
   "chatContextReferenceFileDescription": "把这个文件作为本次消息的显式上下文。",
-  "chatContextReferenceDirectoryDescription": "把这个目录作为本次消息的上下文范围。",
+  "chatContextReferenceDirectoryDescription": "把这个文件夹作为本次消息的上下文范围。",
   "chatContextReferenceProjectsLabel": "项目",
   "chatContextReferenceProjectsType": "项目上下文",
   "chatContextReferenceProjectsDescription": "从已登记项目中选择一个，作为本次消息的上下文。",
@@ -316,8 +323,7 @@
   "chatContextReferenceProjectSection": "项目",
   "chatContextReferenceProjectsLoadFailed": "项目加载失败",
   "chatContextReferenceProjectRoot": "项目目录",
-  "chatContextReferenceWorkspaceSection": "文件与文件夹",
-  "chatContextReferenceSearchFailed": "文件搜索失败",
+  "chatContextReferenceSearchFailed": "引用搜索失败",
   "chatSkillScopeBuiltin": "内建",
   "chatSkillScopeGlobal": "全局",
   "chatSkillScopeProject": "项目",
@@ -484,6 +490,7 @@
   "chatSidebarTaskRecords": "会话记录",
   "chatSidebarViewTime": "时间",
   "chatSidebarViewProject": "项目",
+  "chatSidebarViewMode": "会话列表视图",
   "chatSidebarToday": "今天",
   "chatSidebarYesterday": "昨天",
   "chatSidebarPrevious7Days": "近 7 天",

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

@@ -1,18 +1,19 @@
 {
   "updates": "更新",
   "runtimeUpdatesPageTitle": "版本更新",
-  "runtimeUpdatesPageDescription": "系统每两小时自动检查新版本；发现更新后，由你手动下载并决定何时应用。",
+  "runtimeUpdatesPageDescription": "系统每两小时自动检查新版本；发现更新后，由你决定何时开始更新。",
   "runtimeUpdatesUnavailableTitle": "当前环境暂不支持更新",
   "runtimeUpdatesUnavailableDescription": "这个运行环境暂时没有可用的更新宿主。",
   "runtimeUpdatesUnavailableHint": "更新入口会在宿主支持后自动出现，不需要前端单独区分环境。",
   "runtimeUpdatesHostVersion": "宿主版本",
-  "runtimeUpdatesDownloadedBannerDescription": "版本 {version} 已下载完成，确认后即可切换到新版本。",
-  "runtimeUpdatesActionsDescription": "支持手动检查、手动下载，以及在你准备好之后切换到已下载的新版本。",
+  "runtimeUpdatesDownloadedBannerDescription": "版本 {version} 已下载完成，可以继续完成更新。",
+  "runtimeUpdatesActionsDescription": "你可以手动检查，并在准备好之后一次完成更新。",
   "runtimeUpdatesApplyNow": "立即更新",
   "runtimeUpdatesLoadFailed": "读取更新状态失败",
   "runtimeUpdatesCheckFailed": "检查更新失败",
   "runtimeUpdatesDownloadFailed": "下载更新失败",
   "runtimeUpdatesApplyFailed": "应用更新失败",
+  "runtimeUpdatesUpdateFailed": "更新失败",
   "runtimeUpdatesChannelChangeFailed": "切换更新通道失败",
   "runtimeUpdatesAlreadyLatest": "当前已经是最新版本。",
   "runtimeUpdatesReadyToApply": "更新已下载完成，已经可以切换到新版本。",
@@ -33,6 +34,8 @@
   "desktopUpdatesStatusAvailable": "有可用更新",
   "desktopUpdatesStatusDownloading": "下载中",
   "desktopUpdatesStatusDownloaded": "已下载待应用",
+  "desktopUpdatesStatusApplying": "更新中",
+  "desktopUpdatesStatusRestartRequired": "等待重启生效",
   "desktopUpdatesStatusUpToDate": "已是最新",
   "desktopUpdatesStatusBlocked": "更新被阻塞",
   "desktopUpdatesStatusFailed": "更新失败",
@@ -64,7 +67,7 @@
   "desktopUpdatesBlockedRootCause.host-too-old": "根因：当前宿主版本太旧，不满足新运行包的最低宿主版本要求；请先升级 NextClaw 启动器。",
   "desktopUpdatesBlockedRootCause.unsupported-installation": "根因：当前安装形态或更新源配置不支持自动更新；请安装支持自动更新的版本，或由维护者补齐更新源配置。",
   "desktopUpdatesChannelSettingsTitle": "更新通道",
-  "desktopUpdatesChannelSettingsDescription": "系统每两小时自动检查更新，下载和应用都由你手动确认。",
+  "desktopUpdatesChannelSettingsDescription": "系统每两小时自动检查更新；是否开始更新由你确认。",
   "desktopUpdatesReleaseChannel": "更新通道",
   "desktopUpdatesReleaseChannelHelp": "Stable 面向日常主力使用；Beta 用于提前体验新版本，但可能更不稳定。",
   "desktopUpdatesReleaseChannelDowngradeHint": "切回 Stable 后不会立刻强制降级；只有当 Stable 追平或超过当前版本时，才会继续提供 Stable 更新。",

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

@@ -29,6 +29,46 @@
   "sideDockVisibilityTitle": "显示快捷栏",
   "sideDockVisibilityDescription": "在工作区右侧显示快捷入口栏。",
   "appsTitle": "应用",
+  "appPackagesLibraryTitle": "你的应用",
+  "appPackagesLibraryDescription": "按需启用应用，并从这里直接打开。应用数据保存在独立的本机目录中。",
+  "appPackagesLoading": "加载应用中…",
+  "appPackagesLoadFailed": "应用加载失败",
+  "appPackagesRefresh": "刷新应用",
+  "appPackagesBrowse": "浏览应用",
+  "appPackagesMarketplaceTitle": "浏览 Mini APP",
+  "appPackagesMarketplaceDescription": "从 NextClaw 官方应用库发现应用，并一步安装到自己的空间。",
+  "appPackagesMarketplaceSearch": "搜索应用、功能或标签",
+  "appPackagesMarketplaceLoading": "正在加载应用市场…",
+  "appPackagesMarketplaceFailed": "应用市场暂时不可用，你仍可从可信来源手动安装。",
+  "appPackagesMarketplaceEmpty": "没有找到匹配的应用",
+  "appPackagesMarketplaceFeatured": "精选",
+  "appPackagesMarketplaceDetails": "查看详情",
+  "appPackagesMarketplaceInstalled": "已安装",
+  "appPackagesMarketplaceTrustHint": "应用从官方 Registry 下载。启用可在本机运行代码的 Service 前，请先查看应用详情。",
+  "appPackagesInstall": "安装应用",
+  "appPackagesInstallTitle": "安装 Mini APP",
+  "appPackagesInstallDescription": "输入可信的 .napp 文件、本机应用目录或 Marketplace 安装地址。",
+  "appPackagesInstallSource": "安装来源",
+  "appPackagesInstallPlaceholder": "文件路径或 https:// 安装地址",
+  "appPackagesInstallTrustHint": "只安装你信任的来源。包含 Service 的应用可在本机运行代码，并仅在启用后启动。",
+  "appPackagesInstalling": "安装中…",
+  "appPackagesEmptyTitle": "还没有可用应用",
+  "appPackagesEmptyDescription": "安装一个 Mini APP，或升级到包含内置应用的 NextClaw 版本。",
+  "appPackagesEnabled": "已启用",
+  "appPackagesAvailable": "可用",
+  "appPackagesBuiltIn": "NextClaw 内置",
+  "appPackagesLocalService": "本地数据服务",
+  "appPackagesEnable": "启用",
+  "appPackagesDisable": "停用",
+  "appPackagesWorking": "处理中…",
+  "appPackagesEnableToOpen": "启用后即可打开",
+  "appPackagesMoreActions": "更多应用操作",
+  "appPackagesCheckUpdate": "检查更新",
+  "appPackagesRollback": "切换到",
+  "appPackagesUninstall": "卸载",
+  "appPackagesUninstallTitle": "卸载这个应用？",
+  "appPackagesUninstallDescription": "应用代码会被移除，个人数据默认保留，之后重新安装仍可继续使用。",
+  "appPackagesActionFailed": "应用操作失败",
   "panelAppsTitle": "面板应用",
   "panelAppsLoading": "加载面板应用中...",
   "panelAppsLoadFailed": "面板应用加载失败",