@nextclaw/ui 0.12.23 → 0.12.25

package/src/features/marketplace/hooks/use-marketplace.ts

@@ -1,4 +1,4 @@
-import { useInfiniteQuery, useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
+import { useInfiniteQuery, useMutation, useQueries, useQuery, useQueryClient } from '@tanstack/react-query';
 import { toast } from 'sonner';
 import { t } from '@/shared/lib/i18n';
 import {
@@ -10,6 +10,7 @@ import {
   fetchMarketplaceInstalled,
   fetchMarketplaceItems,
   fetchMarketplaceRecommendations,
+  fetchMarketplaceSkillScenes,
   installMarketplaceItem,
   manageMarketplaceItem,
   type MarketplaceListParams
@@ -18,7 +19,8 @@ import type {
   MarketplaceInstallRequest,
   MarketplaceInstalledView,
   MarketplaceItemType,
-  MarketplaceManageRequest
+  MarketplaceManageRequest,
+  MarketplaceSceneView
 } from '@/shared/lib/api';
 import { collapseMarketplaceListPages } from '@/features/marketplace/utils/marketplace-list-pages.utils';
 import { useMemo } from 'react';
@@ -36,7 +38,12 @@ export function useMarketplaceItems(params: MarketplaceListParams) {
       }
 
       const previousType = 'type' in previousParams ? previousParams.type : undefined;
-      return previousType === params.type ? previousData : undefined;
+      return previousType === params.type && hasSameMarketplaceListIdentity(
+        previousParams as MarketplaceListParams,
+        params
+      )
+        ? previousData
+        : undefined;
     },
     staleTime: 15_000
   });
@@ -49,6 +56,17 @@ export function useMarketplaceItems(params: MarketplaceListParams) {
   };
 }
 
+function hasSameMarketplaceListIdentity(
+  previousParams: MarketplaceListParams,
+  nextParams: MarketplaceListParams
+): boolean {
+  return previousParams.q === nextParams.q
+    && previousParams.tag === nextParams.tag
+    && previousParams.scene === nextParams.scene
+    && previousParams.sort === nextParams.sort
+    && previousParams.pageSize === nextParams.pageSize;
+}
+
 export function useMarketplaceRecommendations(type: MarketplaceItemType, params: { scene?: string; limit?: number }) {
   return useQuery({
     queryKey: ['marketplace-recommendations', type, params],
@@ -57,6 +75,44 @@ export function useMarketplaceRecommendations(type: MarketplaceItemType, params:
   });
 }
 
+export function useMarketplaceSkillScenes(enabled = true) {
+  return useQuery({
+    queryKey: ['marketplace-skill-scenes'],
+    queryFn: fetchMarketplaceSkillScenes,
+    enabled,
+    staleTime: 60_000
+  });
+}
+
+export function useMarketplaceSkillSceneCounts(
+  scenes: MarketplaceSceneView[],
+  enabled = true
+) {
+  const queries = useQueries({
+    queries: scenes.map((scene) => ({
+      queryKey: ['marketplace-skill-scene-count', scene.scene],
+      queryFn: () => fetchMarketplaceItems({
+        type: 'skill',
+        scene: scene.scene,
+        pageSize: 1
+      }),
+      enabled: enabled && typeof scene.count !== 'number',
+      staleTime: 60_000
+    }))
+  });
+
+  return useMemo(() => {
+    const counts = new Map<string, number>();
+    scenes.forEach((scene, index) => {
+      const knownCount = typeof scene.count === 'number' ? scene.count : queries[index]?.data?.total;
+      if (typeof knownCount === 'number') {
+        counts.set(scene.scene, knownCount);
+      }
+    });
+    return counts;
+  }, [queries, scenes]);
+}
+
 export function useMarketplaceItem(slug: string | null, type?: MarketplaceItemType) {
   return useQuery({
     queryKey: ['marketplace-item', slug, type],

package/src/features/system-status/components/config/runtime-agent-list-card.tsx

@@ -13,16 +13,12 @@ export function RuntimeAgentListCard(props: {
   onRemoveAgent: (index: number) => void;
   onAddAgent: () => void;
   onSetDefaultAgent: (index: number, checked: boolean) => void;
-  label?: string;
-  help?: string;
-  contextTokensLabel?: string;
-  engineLabel?: string;
 }) {
   return (
     <Card>
       <CardHeader>
-        <CardTitle>{props.label ?? t('agentList')}</CardTitle>
-        <CardDescription>{props.help ?? t('agentListHelp')}</CardDescription>
+        <CardTitle>{t('agentList')}</CardTitle>
+        <CardDescription>{t('agentListHelp')}</CardDescription>
       </CardHeader>
       <CardContent className="space-y-3">
         {props.agents.map((agent, index) => (
@@ -31,7 +27,7 @@ export function RuntimeAgentListCard(props: {
               <Input value={agent.id} onChange={(event) => props.onUpdateAgent(index, { id: event.target.value })} placeholder={t('agentIdPlaceholder')} />
               <Input value={agent.workspace ?? ''} onChange={(event) => props.onUpdateAgent(index, { workspace: event.target.value })} placeholder={t('workspaceOverridePlaceholder')} />
               <Input value={agent.model ?? ''} onChange={(event) => props.onUpdateAgent(index, { model: event.target.value })} placeholder={t('modelOverridePlaceholder')} />
-              <Input value={agent.runtime ?? agent.engine ?? ''} onChange={(event) => props.onUpdateAgent(index, { runtime: event.target.value })} placeholder={props.engineLabel ?? t('engineOverridePlaceholder')} />
+              <Input value={agent.runtime ?? agent.engine ?? ''} onChange={(event) => props.onUpdateAgent(index, { runtime: event.target.value })} placeholder={t('engineOverridePlaceholder')} />
               <div className="grid grid-cols-1 md:grid-cols-2 gap-2">
                 <Input
                   type="number"
@@ -39,7 +35,7 @@ export function RuntimeAgentListCard(props: {
                   step={1000}
                   value={agent.contextTokens ?? ''}
                   onChange={(event) => props.onUpdateAgent(index, { contextTokens: parseOptionalInt(event.target.value) })}
-                  placeholder={props.contextTokensLabel ?? t('contextTokensPlaceholder')}
+                  placeholder={t('contextTokensPlaceholder')}
                 />
                 <Input
                   type="number"

package/src/features/system-status/components/config/runtime-binding-list-card.tsx

@@ -12,14 +12,12 @@ export function RuntimeBindingListCard(props: {
   onUpdateBinding: (index: number, next: AgentBindingView) => void;
   onRemoveBinding: (index: number) => void;
   onAddBinding: () => void;
-  label?: string;
-  help?: string;
 }) {
   return (
     <Card>
       <CardHeader>
-        <CardTitle>{props.label ?? t('bindings')}</CardTitle>
-        <CardDescription>{props.help ?? t('bindingsHelp')}</CardDescription>
+        <CardTitle>{t('bindings')}</CardTitle>
+        <CardDescription>{t('bindingsHelp')}</CardDescription>
       </CardHeader>
       <CardContent className="space-y-3">
         {props.bindings.map((binding, index) => {
@@ -47,9 +45,9 @@ export function RuntimeBindingListCard(props: {
                   </SelectTrigger>
                   <SelectContent>
                     <SelectItem value="__none__">{t('peerKindOptional')}</SelectItem>
-                    <SelectItem value="direct">direct</SelectItem>
-                    <SelectItem value="group">group</SelectItem>
-                    <SelectItem value="channel">channel</SelectItem>
+                    <SelectItem value="direct">{t('peerKindDirect')}</SelectItem>
+                    <SelectItem value="group">{t('peerKindGroup')}</SelectItem>
+                    <SelectItem value="channel">{t('peerKindChannel')}</SelectItem>
                   </SelectContent>
                 </Select>
                 <Input

package/src/features/system-status/components/config/runtime-config-editor.tsx

@@ -1,9 +1,8 @@
 import { useMemo, useState } from 'react';
 import { Save } from 'lucide-react';
-import type { ConfigUiHints, ConfigView, RuntimeConfigUpdate } from '@/shared/lib/api';
+import type { ConfigView, RuntimeConfigUpdate } from '@/shared/lib/api';
 import { Button } from '@/shared/components/ui/button';
 import { PageLayout } from '@/app/components/layout/page-layout';
-import { hintForPath } from '@/shared/lib/config-hints';
 import { t } from '@/shared/lib/i18n';
 import { RuntimeConfigOverview } from '@/features/system-status/components/config/runtime-config-overview';
 import { RuntimeAgentListCard } from '@/features/system-status/components/config/runtime-agent-list-card';
@@ -27,7 +26,6 @@ type UpdateRuntimeMutation = {
 
 export function RuntimeConfigEditor(props: {
   config: ConfigView;
-  uiHints?: ConfigUiHints;
   updateRuntime: UpdateRuntimeMutation;
 }) {
   const initialState = useMemo(() => createRuntimeConfigEditorState(props.config), [props.config]);
@@ -88,22 +86,12 @@ export function RuntimeConfigEditor(props: {
         onDmScopeChange={setDmScope}
         onDefaultContextTokensChange={setDefaultContextTokens}
         onDefaultEngineChange={setDefaultEngine}
-        companionEnabledLabel={hintForPath('companion.enabled', props.uiHints)?.label}
-        companionEnabledHelp={hintForPath('companion.enabled', props.uiHints)?.help}
-        dmScopeLabel={hintForPath('session.dmScope', props.uiHints)?.label}
-        dmScopeHelp={hintForPath('session.dmScope', props.uiHints)?.help}
-        defaultContextTokensLabel={hintForPath('agents.defaults.contextTokens', props.uiHints)?.label}
-        defaultContextTokensHelp={hintForPath('agents.defaults.contextTokens', props.uiHints)?.help}
-        defaultEngineLabel={hintForPath('agents.defaults.engine', props.uiHints)?.label}
-        defaultEngineHelp={hintForPath('agents.defaults.engine', props.uiHints)?.help}
       />
       <RuntimeEntryListCard
         entries={runtimeEntries}
         onUpdateEntry={updateRuntimeEntry}
         onRemoveEntry={(index) => setRuntimeEntries((previous) => previous.filter((_, cursor) => cursor !== index))}
         onAddEntry={() => setRuntimeEntries((previous) => [...previous, createEmptyRuntimeEntry()])}
-        label={hintForPath('agents.runtimes.entries', props.uiHints)?.label}
-        help={hintForPath('agents.runtimes.entries', props.uiHints)?.help}
       />
       <RuntimeAgentListCard
         agents={agents}
@@ -113,18 +101,12 @@ export function RuntimeConfigEditor(props: {
         onSetDefaultAgent={(index, checked) =>
           setAgents((previous) => checked ? previous.map((entry, cursor) => ({ ...entry, default: cursor === index })) : previous.map((entry, cursor) => (cursor === index ? { ...entry, default: false } : entry)))
         }
-        label={hintForPath('agents.list', props.uiHints)?.label}
-        help={hintForPath('agents.list', props.uiHints)?.help}
-        contextTokensLabel={hintForPath('agents.list.*.contextTokens', props.uiHints)?.label}
-        engineLabel={hintForPath('agents.list.*.engine', props.uiHints)?.label}
       />
       <RuntimeBindingListCard
         bindings={bindings}
         onUpdateBinding={updateBinding}
         onRemoveBinding={(index) => setBindings((previous) => previous.filter((_, cursor) => cursor !== index))}
         onAddBinding={() => setBindings((previous) => [...previous, createEmptyRuntimeBinding()])}
-        label={hintForPath('bindings', props.uiHints)?.label}
-        help={hintForPath('bindings', props.uiHints)?.help}
       />
       <div className="flex justify-end">
         <Button type="button" onClick={handleSave} disabled={props.updateRuntime.isPending}>

package/src/features/system-status/components/config/runtime-entry-list-card.tsx

@@ -3,6 +3,7 @@ import { Button } from '@/shared/components/ui/button';
 import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/shared/components/ui/card';
 import { Input } from '@/shared/components/ui/input';
 import { Switch } from '@/shared/components/ui/switch';
+import { t } from '@/shared/lib/i18n';
 import type { RuntimeEntryDraft } from '@/features/system-status/utils/runtime-config-agent.utils';
 
 export function RuntimeEntryListCard(props: {
@@ -10,29 +11,27 @@ export function RuntimeEntryListCard(props: {
   onUpdateEntry: (index: number, patch: Partial<RuntimeEntryDraft>) => void;
   onRemoveEntry: (index: number) => void;
   onAddEntry: () => void;
-  label?: string;
-  help?: string;
 }) {
   return (
     <Card>
       <CardHeader>
-        <CardTitle>{props.label ?? 'Runtime Entries'}</CardTitle>
-        <CardDescription>{props.help ?? '统一管理可见的 runtime entry 与其配置。'}</CardDescription>
+        <CardTitle>{t('runtimeEntries')}</CardTitle>
+        <CardDescription>{t('runtimeEntriesHelp')}</CardDescription>
       </CardHeader>
       <CardContent className="space-y-3">
         {props.entries.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) => props.onUpdateEntry(index, { id: event.target.value })} placeholder="entry id，例如 hermes" />
-              <Input value={entry.label ?? ''} onChange={(event) => props.onUpdateEntry(index, { label: event.target.value })} placeholder="展示名称，例如 Hermes" />
-              <Input value={entry.type} onChange={(event) => props.onUpdateEntry(index, { type: event.target.value })} placeholder="runtime type，例如 narp-stdio" />
+              <Input value={entry.id} onChange={(event) => props.onUpdateEntry(index, { id: event.target.value })} placeholder={t('runtimeEntryIdPlaceholder')} />
+              <Input value={entry.label ?? ''} onChange={(event) => props.onUpdateEntry(index, { label: event.target.value })} placeholder={t('runtimeEntryLabelPlaceholder')} />
+              <Input value={entry.type} onChange={(event) => props.onUpdateEntry(index, { type: event.target.value })} placeholder={t('runtimeEntryTypePlaceholder')} />
               <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>
+                <span className="text-sm text-gray-700">{t('enabled')}</span>
                 <Switch checked={entry.enabled !== false} onCheckedChange={(checked) => props.onUpdateEntry(index, { enabled: checked })} />
               </div>
             </div>
             <div className="space-y-2">
-              <label className="text-sm font-medium text-gray-800">Config JSON</label>
+              <label className="text-sm font-medium text-gray-800">{t('runtimeEntryConfigJson')}</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}
@@ -43,14 +42,14 @@ export function RuntimeEntryListCard(props: {
             <div className="flex justify-end">
               <Button type="button" variant="outline" onClick={() => props.onRemoveEntry(index)}>
                 <Trash2 className="mr-2 h-4 w-4" />
-                Delete
+                {t('delete')}
               </Button>
             </div>
           </div>
         ))}
         <Button type="button" variant="outline" onClick={props.onAddEntry}>
           <Plus className="mr-2 h-4 w-4" />
-          Add Runtime Entry
+          {t('addRuntimeEntry')}
         </Button>
       </CardContent>
     </Card>

package/src/features/system-status/components/config/runtime-settings-card.tsx

@@ -5,11 +5,11 @@ import { Switch } from '@/shared/components/ui/switch';
 import { t } from '@/shared/lib/i18n';
 import type { DmScope } from '@/features/system-status/utils/runtime-config-agent.utils';
 
-const DM_SCOPE_OPTIONS: Array<{ value: DmScope; label: string }> = [
-  { value: 'main', label: 'main' },
-  { value: 'per-peer', label: 'per-peer' },
-  { value: 'per-channel-peer', label: 'per-channel-peer' },
-  { value: 'per-account-channel-peer', label: 'per-account-channel-peer' }
+const DM_SCOPE_OPTIONS: Array<{ value: DmScope; labelKey: string }> = [
+  { value: 'main', labelKey: 'dmScopeMain' },
+  { value: 'per-peer', labelKey: 'dmScopePerPeer' },
+  { value: 'per-channel-peer', labelKey: 'dmScopePerChannelPeer' },
+  { value: 'per-account-channel-peer', labelKey: 'dmScopePerAccountChannelPeer' }
 ];
 
 export function RuntimeSettingsCard(props: {
@@ -21,31 +21,23 @@ export function RuntimeSettingsCard(props: {
   onDmScopeChange: (value: DmScope) => void;
   onDefaultContextTokensChange: (value: number) => void;
   onDefaultEngineChange: (value: string) => void;
-  companionEnabledLabel?: string;
-  companionEnabledHelp?: string;
-  dmScopeLabel?: string;
-  dmScopeHelp?: string;
-  defaultContextTokensLabel?: string;
-  defaultContextTokensHelp?: string;
-  defaultEngineLabel?: string;
-  defaultEngineHelp?: string;
 }) {
   return (
     <Card>
       <CardHeader>
-        <CardTitle>{props.dmScopeLabel ?? t('dmScope')}</CardTitle>
-        <CardDescription>{props.dmScopeHelp ?? t('dmScopeHelp')}</CardDescription>
+        <CardTitle>{t('dmScope')}</CardTitle>
+        <CardDescription>{t('dmScopeHelp')}</CardDescription>
       </CardHeader>
       <CardContent className="space-y-4">
         <div className="flex items-start justify-between gap-4 rounded-md border border-gray-200 px-4 py-3">
           <div className="space-y-1">
-            <div className="text-sm font-medium text-gray-800">{props.companionEnabledLabel ?? t('runtimeCompanionEnabled')}</div>
-            <p className="text-xs text-gray-500">{props.companionEnabledHelp ?? t('runtimeCompanionEnabledHelp')}</p>
+            <div className="text-sm font-medium text-gray-800">{t('runtimeCompanionEnabled')}</div>
+            <p className="text-xs text-gray-500">{t('runtimeCompanionEnabledHelp')}</p>
           </div>
           <Switch checked={props.companionEnabled} onCheckedChange={props.onCompanionEnabledChange} />
         </div>
         <div className="space-y-2">
-          <label className="text-sm font-medium text-gray-800">{props.defaultContextTokensLabel ?? t('defaultContextTokens')}</label>
+          <label className="text-sm font-medium text-gray-800">{t('defaultContextTokens')}</label>
           <Input
             type="number"
             min={1000}
@@ -53,19 +45,19 @@ export function RuntimeSettingsCard(props: {
             value={props.defaultContextTokens}
             onChange={(event) => props.onDefaultContextTokensChange(Math.max(1000, Number.parseInt(event.target.value, 10) || 1000))}
           />
-          <p className="text-xs text-gray-500">{props.defaultContextTokensHelp ?? t('defaultContextTokensHelp')}</p>
+          <p className="text-xs text-gray-500">{t('defaultContextTokensHelp')}</p>
         </div>
         <div className="space-y-2">
-          <label className="text-sm font-medium text-gray-800">{props.defaultEngineLabel ?? t('defaultEngine')}</label>
+          <label className="text-sm font-medium text-gray-800">{t('defaultEngine')}</label>
           <Input
             value={props.defaultEngine}
             onChange={(event) => props.onDefaultEngineChange(event.target.value)}
             placeholder={t('defaultEnginePlaceholder')}
           />
-          <p className="text-xs text-gray-500">{props.defaultEngineHelp ?? t('defaultEngineHelp')}</p>
+          <p className="text-xs text-gray-500">{t('defaultEngineHelp')}</p>
         </div>
         <div className="space-y-2">
-          <label className="text-sm font-medium text-gray-800">{props.dmScopeLabel ?? t('dmScope')}</label>
+          <label className="text-sm font-medium text-gray-800">{t('dmScope')}</label>
           <Select value={props.dmScope} onValueChange={(value) => props.onDmScopeChange(value as DmScope)}>
             <SelectTrigger>
               <SelectValue />
@@ -73,7 +65,7 @@ export function RuntimeSettingsCard(props: {
             <SelectContent>
               {DM_SCOPE_OPTIONS.map((option) => (
                 <SelectItem key={option.value} value={option.value}>
-                  {option.label}
+                  {t(option.labelKey)}
                 </SelectItem>
               ))}
             </SelectContent>

package/src/features/system-status/components/runtime-control-card.test.tsx

@@ -15,7 +15,7 @@ const baseControlView = {
     available: false,
     requiresConfirmation: false,
     impact: 'brief-ui-disconnect' as const,
-    reasonIfUnavailable: '当前页面已经由运行中的本地服务托管。'
+    reasonIfUnavailable: 'This page is already hosted by the running local service.'
   },
   canRestartService: {
     available: true,
@@ -31,9 +31,9 @@ const baseControlView = {
     available: false,
     requiresConfirmation: true,
     impact: 'full-app-relaunch' as const,
-    reasonIfUnavailable: 'desktop only'
+    reasonIfUnavailable: 'App restart is only available in the desktop shell.'
   },
-  managementHint: 'This page is served by the running local service.'
+  managementHint: 'This page is served by the running local service. Closing the browser does not stop it.'
 };
 
 const mocks = vi.hoisted(() => ({
@@ -87,7 +87,9 @@ describe('RuntimeControlCard', () => {
     expect(screen.getByRole('button', { name: '停止服务' })).toBeTruthy();
     expect(startButton.disabled).toBe(true);
     expect(restartAppButton.disabled).toBe(true);
-    expect(screen.getByText('desktop only')).toBeTruthy();
+    expect(screen.getByText('运行时正常')).toBeTruthy();
+    expect(screen.getByText('此页面由正在运行的本地服务提供。关闭浏览器不会停止它。')).toBeTruthy();
+    expect(screen.getByText('只有桌面壳环境支持重启整个应用。')).toBeTruthy();
   });
 
   it('runs the restart service flow through the system status manager', async () => {
@@ -106,7 +108,7 @@ describe('RuntimeControlCard', () => {
     await waitFor(() => {
       expect(mocks.runRuntimeControlAction).toHaveBeenCalledWith('restart-service');
     });
-    expect(toast.success).toHaveBeenCalledWith('Restart scheduled. This page may disconnect for a few seconds.');
+    expect(toast.success).toHaveBeenCalledWith('重启已安排。此页面可能会短暂断开。');
   });
 
   it('runs the stop service flow after confirmation', async () => {
@@ -127,7 +129,7 @@ describe('RuntimeControlCard', () => {
       expect(confirmSpy).toHaveBeenCalledTimes(1);
       expect(mocks.runRuntimeControlAction).toHaveBeenCalledWith('stop-service');
     });
-    expect(toast.success).toHaveBeenCalledWith('Stop scheduled. This page will disconnect shortly.');
+    expect(toast.success).toHaveBeenCalledWith('停止已安排。此页面即将断开。');
   });
 
   it('runs the desktop restart app flow after confirmation', async () => {

package/src/features/system-status/components/runtime-control-card.tsx

@@ -8,6 +8,7 @@ import type {
 import { Button } from '@/shared/components/ui/button';
 import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/shared/components/ui/card';
 import { useRuntimeControlPanelView, systemStatusManager } from '@/features/system-status';
+import { localizeRuntimeControlMessage } from '@/features/system-status/utils/system-status.utils';
 import { t } from '@/shared/lib/i18n';
 import { Loader2, Play, RotateCw, Square } from 'lucide-react';
 import { toast } from 'sonner';
@@ -140,7 +141,7 @@ export function RuntimeControlCard() {
     const capability = resolveActionCapability(controlView, action);
 
     if (!capability?.available) {
-      toast.error(capability?.reasonIfUnavailable ?? t('runtimeControlLoadFailed'));
+      toast.error(localizeRuntimeControlMessage(capability?.reasonIfUnavailable) ?? t('runtimeControlLoadFailed'));
       return;
     }
     if (
@@ -153,7 +154,7 @@ export function RuntimeControlCard() {
 
     try {
       const result = await systemStatusManager.runRuntimeControlAction(action);
-      toast.success(result.message);
+      toast.success(localizeRuntimeControlMessage(result.message) ?? result.message);
     } catch (error) {
       const message = error instanceof Error ? error.message : t('runtimeControlActionFailed');
       toast.error(`${t('runtimeControlActionFailed')}: ${message}`);
@@ -162,7 +163,7 @@ export function RuntimeControlCard() {
 
   const handleRestartApp = async () => {
     if (!controlView?.canRestartApp.available) {
-      toast.error(controlView?.canRestartApp.reasonIfUnavailable ?? t('runtimeRestartAppUnavailable'));
+      toast.error(localizeRuntimeControlMessage(controlView?.canRestartApp.reasonIfUnavailable) ?? t('runtimeRestartAppUnavailable'));
       return;
     }
     if (!window.confirm(t('runtimeControlRestartAppConfirm'))) {
@@ -171,7 +172,7 @@ export function RuntimeControlCard() {
 
     try {
       const result = await systemStatusManager.runRuntimeControlAction('restart-app');
-      toast.success(result.message);
+      toast.success(localizeRuntimeControlMessage(result.message) ?? result.message);
     } catch (error) {
       const message = error instanceof Error ? error.message : t('runtimeControlActionFailed');
       toast.error(`${t('runtimeControlActionFailed')}: ${message}`);
@@ -194,7 +195,7 @@ export function RuntimeControlCard() {
           </div>
           <p className="text-sm text-gray-600">{displayedMessage}</p>
           <div className="text-xs text-gray-500">{resolveLifecycleLabel(displayedLifecycle)}</div>
-          {controlView?.managementHint ? <p className="text-xs text-gray-500">{controlView.managementHint}</p> : null}
+          {controlView?.managementHint ? <p className="text-xs text-gray-500">{localizeRuntimeControlMessage(controlView.managementHint)}</p> : null}
           {errorMessage && !busy ? <p className="text-sm text-amber-700">{errorMessage}</p> : null}
         </div>
 
@@ -251,7 +252,7 @@ export function RuntimeControlCard() {
           .filter((item) => !item.capability.available && item.capability.reasonIfUnavailable)
           .map((item) => (
             <p key={`${item.action}-reason`} className="text-xs text-gray-500">
-              {item.capability.reasonIfUnavailable}
+              {localizeRuntimeControlMessage(item.capability.reasonIfUnavailable)}
             </p>
           ))}
       </CardContent>

package/src/features/system-status/pages/runtime-config-page.test.tsx

@@ -9,15 +9,11 @@ const mocks = vi.hoisted(() => ({
   useConfigResult: null as unknown as {
     data: Record<string, unknown> | null;
     isLoading: boolean;
-  },
-  useConfigSchemaResult: null as unknown as {
-    data: Record<string, unknown> | null;
   }
 }));
 
 vi.mock('@/shared/hooks/use-config', () => ({
   useConfig: () => mocks.useConfigResult,
-  useConfigSchema: () => mocks.useConfigSchemaResult,
   useUpdateRuntime: () => ({
     mutate: mocks.mutate,
     isPending: false
@@ -68,16 +64,14 @@ describe('RuntimeConfig', () => {
             }
           }
         ],
+        companion: {
+          enabled: false
+        },
         session: {
           dmScope: 'per-peer'
         }
       }
     };
-    mocks.useConfigSchemaResult = {
-      data: {
-        uiHints: {}
-      }
-    };
   });
 
   it('saves the migrated runtime page through the system-status feature root', async () => {
@@ -131,10 +125,26 @@ describe('RuntimeConfig', () => {
             }
           }
         ],
+        companion: {
+          enabled: false
+        },
         session: {
           dmScope: 'per-peer'
         }
       }
     });
   });
+
+  it('renders runtime settings labels in Chinese when the UI language is Chinese', () => {
+    setLanguage('zh');
+
+    render(<RuntimeConfig />);
+
+    expect(screen.getByText('保存运行时设置')).toBeTruthy();
+    expect(screen.getByText('运行时入口')).toBeTruthy();
+    expect(screen.getByText('启用')).toBeTruthy();
+    expect(screen.getByText('配置 JSON')).toBeTruthy();
+    expect(screen.getByPlaceholderText('默认运行时（如 native 或 codex）')).toBeTruthy();
+    expect(screen.getByPlaceholderText('入口 ID，例如 hermes')).toBeTruthy();
+  });
 });

package/src/features/system-status/pages/runtime-config-page.tsx

@@ -1,15 +1,14 @@
-import { useConfig, useConfigSchema, useUpdateRuntime } from '@/shared/hooks/use-config';
+import { useConfig, useUpdateRuntime } from '@/shared/hooks/use-config';
 import { RuntimeConfigEditor } from '@/features/system-status/components/config/runtime-config-editor';
 import { t } from '@/shared/lib/i18n';
 
 export function RuntimeConfig() {
   const { data: config, isLoading } = useConfig();
-  const { data: schema } = useConfigSchema();
   const updateRuntime = useUpdateRuntime();
 
   if (isLoading || !config) {
     return <div className="p-8 text-gray-400">{t('runtimeLoading')}</div>;
   }
 
-  return <RuntimeConfigEditor config={config} uiHints={schema?.uiHints} updateRuntime={updateRuntime} />;
+  return <RuntimeConfigEditor config={config} updateRuntime={updateRuntime} />;
 }

package/src/features/system-status/utils/runtime-config-agent.utils.ts

@@ -122,11 +122,11 @@ export function createRuntimeConfigUpdatePayload(input: {
   const normalizedRuntimeEntries = input.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}`);
+    if (!id) throw new Error(t('runtimeEntryIdRequired').replace('{index}', String(index)));
+    if (!type) throw new Error(t('runtimeEntryTypeRequired').replace('{id}', id));
+    if (entries[id]) throw new Error(`${t('runtimeEntryDuplicate')}: ${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.`);
+    if (configValue && (typeof configValue !== 'object' || Array.isArray(configValue))) throw new Error(t('runtimeEntryConfigObjectRequired').replace('{id}', id));
     entries[id] = {
       enabled: entry.enabled !== false,
       ...(entry.label?.trim() ? { label: entry.label.trim() } : {}),