@nextclaw/ui 0.15.22 → 0.15.24

package/src/shared/lib/api/utils/config.utils.ts

@@ -17,6 +17,9 @@ import type {
   ProviderConfigUpdate,
   ProviderConnectionTestRequest,
   ProviderConnectionTestResult,
+  ProviderModelDiscoveryRequest,
+  ProviderModelDiscoveryResult,
+  ProviderModelCatalogView,
   ProviderAuthStartRequest,
   ProviderAuthStartResult,
   ProviderAuthPollRequest,
@@ -90,6 +93,10 @@ export async function fetchProviderTemplates(): Promise<ProviderTemplatesView> {
   return await nextclawClient.providers.listTemplates();
 }
 
+export async function fetchProviderModelCatalog(): Promise<ProviderModelCatalogView> {
+  return await nextclawClient.providers.listModelCatalog();
+}
+
 export async function fetchConfigSchema(): Promise<ConfigSchemaResponse> {
   return await nextclawClient.config.fetchSchema();
 }
@@ -121,6 +128,13 @@ export async function testProviderConnection(
   return await nextclawClient.providers.testConnection(provider, data);
 }
 
+export async function discoverProviderModels(
+  provider: string,
+  data: ProviderModelDiscoveryRequest
+): Promise<ProviderModelDiscoveryResult> {
+  return await nextclawClient.providers.discoverModels(provider, data);
+}
+
 export async function startProviderAuth(
   provider: string,
   data: ProviderAuthStartRequest = {}

package/src/shared/lib/cron/cron-job-view.utils.ts

@@ -156,6 +156,10 @@ export function describeCronSession(job: CronJobView): string {
   return job.payload.sessionId?.trim() || `cron:${job.id}`;
 }
 
+export function canOpenCronSession(job: CronJobView): boolean {
+  return Boolean(job.payload.sessionId?.trim() || job.state.lastRunAt);
+}
+
 export function isCronJobForSession(
   job: CronJobView,
   sessionKey: string | null | undefined,

package/src/shared/lib/host-capabilities/__tests__/host-capability.manager.test.ts

@@ -47,4 +47,30 @@ describe("HostCapabilityManager", () => {
       reason: "popup-blocked"
     });
   });
+
+  it("reveals a path only through the explicit desktop bridge", async () => {
+    const revealPath = vi.fn(async () => ({ revealed: true as const }));
+    const manager = new HostCapabilityManager(() => ({
+      open: vi.fn(),
+      nextclawDesktop: {
+        host: { revealPath }
+      }
+    } as unknown as Window));
+
+    expect(manager.canRevealPath()).toBe(true);
+    await expect(manager.revealPath(" /tmp/demo.txt ")).resolves.toEqual({ revealed: true });
+    expect(revealPath).toHaveBeenCalledWith("/tmp/demo.txt");
+  });
+
+  it("does not invent a web fallback for revealing local paths", async () => {
+    const manager = new HostCapabilityManager(() => ({
+      open: vi.fn()
+    } as unknown as Window));
+
+    expect(manager.canRevealPath()).toBe(false);
+    await expect(manager.revealPath("/tmp/demo.txt")).resolves.toEqual({
+      revealed: false,
+      reason: "host-unavailable"
+    });
+  });
 });

package/src/shared/lib/host-capabilities/host-capability.manager.ts

@@ -7,10 +7,18 @@ export type OpenExternalUrlResult =
   | { opened: true }
   | { opened: false; reason: OpenExternalUrlFailureReason };
 
+export type RevealPathResult =
+  | { revealed: true }
+  | {
+      revealed: false;
+      reason: "unsupported-path" | "host-unavailable" | "bridge-failed";
+    };
+
 type HostWindow = Pick<Window, "open"> & {
   nextclawDesktop?: {
     host?: {
       openExternalUrl?: (url: string) => Promise<OpenExternalUrlResult>;
+      revealPath?: (path: string) => Promise<RevealPathResult>;
     };
   };
 };
@@ -45,6 +53,26 @@ export class HostCapabilityManager {
       return { opened: false, reason: "bridge-failed" };
     }
   };
+
+  canRevealPath = (): boolean => {
+    return Boolean(this.getWindow()?.nextclawDesktop?.host?.revealPath);
+  };
+
+  revealPath = async (rawPath: string): Promise<RevealPathResult> => {
+    const path = rawPath.trim();
+    if (!path) {
+      return { revealed: false, reason: "unsupported-path" };
+    }
+    const revealPath = this.getWindow()?.nextclawDesktop?.host?.revealPath;
+    if (!revealPath) {
+      return { revealed: false, reason: "host-unavailable" };
+    }
+    try {
+      return await revealPath(path);
+    } catch {
+      return { revealed: false, reason: "bridge-failed" };
+    }
+  };
 }
 
 export const hostCapabilityManager = new HostCapabilityManager();

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

@@ -53,8 +53,8 @@
   "chatWorkspaceChildSessionsEmpty": "No child sessions yet.",
   "chatWorkspaceSessionCronJobsDescription": "Review scheduled tasks associated with this session.",
   "chatWorkspaceProjectFiles": "Project files",
-  "chatWorkspaceProjectFilesDescription": "Browse files from this session's project directory.",
-  "chatWorkspaceProjectFilesUnavailable": "This session does not have a project directory yet.",
+  "chatWorkspaceProjectFilesDescription": "Browse files from the selected project directory.",
+  "chatWorkspaceProjectFilesUnavailable": "Select a project directory to browse its files.",
   "chatWorkspaceSideChatDraftTitle": "Side chat",
   "chatWorkspaceSideChatDraftSubtitle": "This draft will inherit the parent session context when you send the first message.",
   "chatWorkspaceChildSessions": "Child sessions",
@@ -73,6 +73,14 @@
   "chatWorkspaceOpenFile": "Open file",
   "chatWorkspaceDirectoryEmpty": "This directory is empty.",
   "chatWorkspaceDirectoryLoadFailed": "Failed to load directory",
+  "chatWorkspaceFileContextMenu": "Project file actions",
+  "chatWorkspaceAddToChat": "Add to chat",
+  "chatWorkspaceExcerptSelectionTooLong": "Selection is too long",
+  "chatWorkspaceRevealInFileManager": "Reveal in file manager",
+  "chatWorkspaceCopyPath": "Copy path",
+  "chatWorkspaceCopyRelativePath": "Copy relative path",
+  "chatWorkspaceCopyPathFailed": "Could not copy the path.",
+  "chatWorkspaceRevealPathFailed": "Could not reveal this item in the file manager.",
   "chatWorkspacePreviewUnsupported": "This file is not supported in the sidebar preview yet.",
   "chatWorkspacePreviewUnsupportedHint": "Legacy Word or PowerPoint files, archives, and other unsupported formats can be downloaded and opened with a local app.",
   "chatWorkspacePreviewFailed": "The file could not be previewed. You can still download it and open it with a local app.",
@@ -285,21 +293,43 @@
   "chatFavoriteModel": "Add to favorites",
   "chatUnfavoriteModel": "Remove from favorites",
   "chatManageModels": "Manage models and providers",
+  "chatDiscoveredModelsSummary": "{count} new models available",
+  "chatDiscoveredModelsView": "View",
+  "chatDiscoveredModelsGroup": "New models",
+  "chatDiscoveredModelsDismiss": "Dismiss this batch",
+  "chatDiscoveredModelsDone": "Done",
+  "chatDiscoveredModelsClose": "Close new models",
+  "chatDiscoveredModelAdd": "Add",
+  "chatDiscoveredModelAddedShort": "Added",
+  "chatDiscoveredModelAdded": "Added {model}",
+  "chatDiscoveredModelUnavailable": "This model is no longer available. Reopen the model selector.",
   "chatPickerAllSkills": "All skills",
   "chatSend": "Send",
+  "chatContinueRun": "Continue",
+  "chatEditMessage": "Edit message",
+  "chatEditMessageCancel": "Cancel",
+  "chatEditMessagePlaceholder": "Edit your message",
+  "chatEditMessageSubmit": "Send",
   "chatStop": "Stop",
   "chatStopPreparing": "Preparing stoppable run…",
   "chatStopUnavailable": "Manual stop is not supported by the current backend engine.",
   "chatContextWindow": "Context window",
   "chatContextWindowUsed": "Projected use",
+  "chatContextWindowFixed": "System and tools",
+  "chatContextWindowDynamic": "Conversation",
+  "chatContextWindowTrigger": "Auto-compaction threshold",
+  "chatContextWindowReserve": "Output reserve",
   "chatContextWindowTotal": "Total",
   "chatContextWindowAvailable": "Available",
+  "chatContextWindowAvailableBeforeCompaction": "Until auto-compaction",
   "chatContextWindowPruned": "After safety pruning",
   "chatContextWindowDroppedHistory": "Dropped history",
   "chatContextWindowTruncatedTools": "Truncated tool results",
   "chatContextWindowUpdatedAt": "Updated",
   "chatContextCompactionCompressing": "Compressing earlier context",
   "chatContextCompactionCompressed": "Earlier context was auto-compacted",
+  "chatContextCompactionCancelled": "Context compaction was cancelled",
+  "chatContextCompactionFailed": "Context compaction failed",
   "chatContextCompactionCoveredMessages": "Covered messages",
   "chatContextCompactionOriginalTokens": "Estimated before compaction",
   "chatContextCompactionProjectedTokens": "Estimated after compaction",
@@ -357,7 +387,6 @@
   "chatSessionErrorTitle": "Something went wrong",
   "chatSessionActivityInterrupted": "The run was interrupted. Send the message again.",
   "chatSendFailed": "Failed to send message",
-  "chatErrorDetails": "Details",
   "chatRoleUser": "You",
   "chatRoleAssistant": "Assistant",
   "chatRoleTool": "Tool",
@@ -403,6 +432,9 @@
   "chatMermaidExpand": "Expand diagram",
   "chatMermaidLoading": "Rendering diagram…",
   "chatMermaidRenderError": "Diagram could not be rendered; showing source instead",
+  "chatPreviewZoomIn": "Zoom in",
+  "chatPreviewZoomOut": "Zoom out",
+  "chatPreviewResetZoom": "Reset zoom",
   "chatSidebarNewTask": "New Task",
   "chatSidebarSearchPlaceholder": "Search conversations...",
   "chatSidebarScheduledTasks": "Scheduled Tasks",
@@ -429,7 +461,8 @@
   "chatWelcomeContextLabel": "Task context",
   "chatWelcomeProjectPickerLabel": "Choose working directory",
   "chatWelcomeProjectPickerPlaceholder": "Choose working directory",
-  "chatWelcomeProjectRecentTitle": "Recent projects",
+  "chatWelcomeProjectRecentTitle": "Working directories",
+  "chatWelcomeProjectDefaultBadge": "Default",
   "chatWelcomeProjectNoRecent": "No recent projects yet",
   "chatWelcomeProjectOpenFolder": "Open folder",
   "chatWelcomeSessionTypePickerLabel": "Choose session type",
@@ -448,6 +481,8 @@
   "chatSkillPreviewUnavailable": "This skill file is unavailable. It may have been moved or removed.",
   "chatInputAdd": "Add content",
   "chatInputAttach": "Attach file",
+  "chatInputRemoveReference": "Remove reference",
+  "chatWorkspaceExcerptCharacterCount": "{count} characters",
   "chatInputAttachmentUnsupported": "This file type is not supported in the current upload flow.",
   "chatInputAttachmentTooLarge": "Files must be {maxMb} MB or smaller.",
   "chatInputAttachmentReadFailed": "Failed to read the file. Please try again."

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

@@ -40,6 +40,7 @@
   "saving": "Saving...",
   "remove": "Remove",
   "more": "More",
+  "notificationDismiss": "Dismiss notification",
   "all": "All",
   "yes": "Yes",
   "no": "No",
@@ -56,6 +57,7 @@
   "themeDawn": "Dawn",
   "themeGraphite": "Graphite",
   "themeNight": "Night",
+  "themeCharcoal": "Charcoal",
   "themeProbe": "Probe",
   "isRequired": "is required",
   "duplicate": "duplicate",
@@ -115,6 +117,30 @@
   "providerTestConnectionSuccess": "Connection test passed",
   "providerTestConnectionFailed": "Connection test failed",
   "providerModelsTitle": "Available Models",
+  "providerModelsFetch": "Fetch model list",
+  "providerModelsFetching": "Fetching...",
+  "providerModelsFetchSuccess": "Model list fetched",
+  "providerModelsFetchFailed": "Failed to fetch model list",
+  "providerModelsApiKeyRequired": "Please enter an API Key before fetching the model list",
+  "providerModelsAuthorizationFailed": "Authentication failed. Check the API Key and API address",
+  "providerModelsSuggestionsChecking": "Loading the model catalog…",
+  "providerModelsSuggestionsFailed": "Unable to load the model catalog. Check the API Key, API address, or network connection; you can still add models manually.",
+  "providerModelsSuggestionsSummary": "Catalog models not added: {count}",
+  "providerModelsFetchedSuggestionsSummary": "{count} fetched models available to add",
+  "providerModelsFetchedAllConfigured": "Fetched {count} models; all are already in the current list",
+  "providerModelsSuggestionsAddAll": "Add all",
+  "providerModelsSuggestionSelect": "Select model {model}",
+  "providerModelsSuggestionsSelected": "{count} selected",
+  "providerModelsSuggestionsAddSelected": "Add selected",
+  "providerModelsSuggestionsSaveHint": "Save to apply the added models.",
+  "providerModelsSuggestionsSearchPlaceholder": "Search catalog models",
+  "providerModelsSuggestionsSearchEmpty": "No matching models",
+  "providerModelsSuggestionsShowing": "Showing the first {visible} of {count} matches; refine your search to narrow the list",
+  "providerModelsBulkRemove": "Bulk delete",
+  "providerModelsSelectAll": "Select all",
+  "providerModelsClearSelection": "Clear selection",
+  "providerModelsRemoveSelected": "Delete selected",
+  "providerModelsRemoveSaveHint": "Deletion only changes this draft and applies after you save.",
   "providerModelInputPlaceholder": "Enter provider-local model id (may contain /)",
   "providerModelInputHint": "The list is only a reference. You can type and add models that are not listed.",
   "providerAddModel": "Add Model",

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

@@ -68,6 +68,7 @@
   "serviceAppsEmptyTitle": "No service apps",
   "serviceAppsEmptyDescription": "Service apps expose local runtimes and actions that panel apps can call.",
   "serviceAppsRefresh": "Refresh service apps",
+  "serviceAppsConnect": "Connect",
   "serviceAppsDiscoverActions": "Connect and discover actions",
   "serviceAppsDiscoverActionsHint": "Connect to the service app runtime and discover its available actions.",
   "serviceAppsDisconnectRuntime": "Disconnect runtime",

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

@@ -15,6 +15,7 @@
   "searchProviderBochaDescription": "AI-ready search that works better for mainland China users.",
   "searchProviderTavilyDescription": "Research-focused search with configurable answer synthesis.",
   "searchProviderBraveDescription": "Keep Brave as an optional provider.",
+  "searchProviderExaDescription": "Semantic search with page content for research and discovery.",
   "searchStatusConfigured": "Configured",
   "searchStatusNeedsSetup": "Needs Setup",
   "searchFreshnessNoLimit": "No Limit",

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

@@ -53,8 +53,8 @@
   "chatWorkspaceChildSessionsEmpty": "当前还没有子会话。",
   "chatWorkspaceSessionCronJobsDescription": "查看与当前会话关联的定时任务。",
   "chatWorkspaceProjectFiles": "项目文件",
-  "chatWorkspaceProjectFilesDescription": "浏览当前会话项目目录中的文件。",
-  "chatWorkspaceProjectFilesUnavailable": "当前会话还没有项目目录。",
+  "chatWorkspaceProjectFilesDescription": "浏览已选项目目录中的文件。",
+  "chatWorkspaceProjectFilesUnavailable": "请先选择项目目录，再浏览其中的文件。",
   "chatWorkspaceSideChatDraftTitle": "侧边对话",
   "chatWorkspaceSideChatDraftSubtitle": "发送第一条消息后，会继承父会话上下文并创建真实 child 会话。",
   "chatWorkspaceChildSessions": "子会话",
@@ -73,6 +73,14 @@
   "chatWorkspaceOpenFile": "打开文件",
   "chatWorkspaceDirectoryEmpty": "这个目录为空。",
   "chatWorkspaceDirectoryLoadFailed": "读取目录失败",
+  "chatWorkspaceFileContextMenu": "项目文件操作",
+  "chatWorkspaceAddToChat": "添加到聊天",
+  "chatWorkspaceExcerptSelectionTooLong": "选择内容过长",
+  "chatWorkspaceRevealInFileManager": "在文件管理器中显示",
+  "chatWorkspaceCopyPath": "复制路径",
+  "chatWorkspaceCopyRelativePath": "复制相对路径",
+  "chatWorkspaceCopyPathFailed": "无法复制路径。",
+  "chatWorkspaceRevealPathFailed": "无法在文件管理器中显示该项目。",
   "chatWorkspacePreviewUnsupported": "该文件暂不支持在侧栏预览。",
   "chatWorkspacePreviewUnsupportedHint": "旧版 Word、PowerPoint、压缩包等暂不支持的格式，可以下载后用本机应用打开。",
   "chatWorkspacePreviewFailed": "文件预览失败。你仍可以下载后用本机应用打开。",
@@ -285,21 +293,43 @@
   "chatFavoriteModel": "收藏模型",
   "chatUnfavoriteModel": "取消收藏",
   "chatManageModels": "管理模型与提供商",
+  "chatDiscoveredModelsSummary": "发现 {count} 个可添加的新模型",
+  "chatDiscoveredModelsView": "查看",
+  "chatDiscoveredModelsGroup": "新模型",
+  "chatDiscoveredModelsDismiss": "忽略这批提醒",
+  "chatDiscoveredModelsDone": "完成",
+  "chatDiscoveredModelsClose": "关闭新模型窗口",
+  "chatDiscoveredModelAdd": "添加",
+  "chatDiscoveredModelAddedShort": "已添加",
+  "chatDiscoveredModelAdded": "已添加 {model}",
+  "chatDiscoveredModelUnavailable": "这个模型已不可用，请重新打开模型选择器",
   "chatPickerAllSkills": "全部技能",
   "chatSend": "发送",
+  "chatContinueRun": "继续运行",
+  "chatEditMessage": "编辑消息",
+  "chatEditMessageCancel": "取消",
+  "chatEditMessagePlaceholder": "编辑消息",
+  "chatEditMessageSubmit": "发送",
   "chatStop": "停止",
   "chatStopPreparing": "正在建立可停止会话，请稍候…",
   "chatStopUnavailable": "当前后端引擎不支持手动停止。",
   "chatContextWindow": "上下文窗口",
   "chatContextWindowUsed": "预计占用",
+  "chatContextWindowFixed": "系统与工具",
+  "chatContextWindowDynamic": "会话内容",
+  "chatContextWindowTrigger": "自动压缩线",
+  "chatContextWindowReserve": "输出预留",
   "chatContextWindowTotal": "总窗口",
   "chatContextWindowAvailable": "剩余",
+  "chatContextWindowAvailableBeforeCompaction": "距自动压缩",
   "chatContextWindowPruned": "安全裁剪后",
   "chatContextWindowDroppedHistory": "已丢弃历史消息",
   "chatContextWindowTruncatedTools": "已截断工具结果",
   "chatContextWindowUpdatedAt": "更新时间",
   "chatContextCompactionCompressing": "正在压缩较早上下文",
   "chatContextCompactionCompressed": "较早上下文已自动压缩",
+  "chatContextCompactionCancelled": "上下文压缩已取消",
+  "chatContextCompactionFailed": "上下文压缩失败",
   "chatContextCompactionCoveredMessages": "覆盖消息数",
   "chatContextCompactionOriginalTokens": "压缩前估算",
   "chatContextCompactionProjectedTokens": "压缩后估算",
@@ -357,7 +387,6 @@
   "chatSessionErrorTitle": "出错了",
   "chatSessionActivityInterrupted": "运行意外中断，请重新发送消息。",
   "chatSendFailed": "发送消息失败",
-  "chatErrorDetails": "查看详情",
   "chatRoleUser": "你",
   "chatRoleAssistant": "助手",
   "chatRoleTool": "工具",
@@ -403,6 +432,9 @@
   "chatMermaidExpand": "放大图表",
   "chatMermaidLoading": "正在渲染图表…",
   "chatMermaidRenderError": "图表无法渲染，已显示源代码",
+  "chatPreviewZoomIn": "放大",
+  "chatPreviewZoomOut": "缩小",
+  "chatPreviewResetZoom": "重置缩放",
   "chatSidebarNewTask": "新任务",
   "chatSidebarSearchPlaceholder": "搜索对话...",
   "chatSidebarScheduledTasks": "定时任务",
@@ -429,7 +461,8 @@
   "chatWelcomeContextLabel": "任务上下文",
   "chatWelcomeProjectPickerLabel": "选择工作目录",
   "chatWelcomeProjectPickerPlaceholder": "选择工作目录",
-  "chatWelcomeProjectRecentTitle": "最近项目",
+  "chatWelcomeProjectRecentTitle": "工作目录",
+  "chatWelcomeProjectDefaultBadge": "默认",
   "chatWelcomeProjectNoRecent": "暂无最近项目",
   "chatWelcomeProjectOpenFolder": "打开文件夹",
   "chatWelcomeSessionTypePickerLabel": "选择会话类型",
@@ -448,6 +481,8 @@
   "chatSkillPreviewUnavailable": "无法打开这个技能文件，它可能已被移动或删除。",
   "chatInputAdd": "添加内容",
   "chatInputAttach": "添加附件",
+  "chatInputRemoveReference": "移除引用",
+  "chatWorkspaceExcerptCharacterCount": "{count} 个字符",
   "chatInputAttachmentUnsupported": "当前上传流程不支持该文件类型。",
   "chatInputAttachmentTooLarge": "文件不能超过 {maxMb} MB。",
   "chatInputAttachmentReadFailed": "读取文件失败，请重试。"

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

@@ -40,6 +40,7 @@
   "saving": "保存中...",
   "remove": "移除",
   "more": "更多",
+  "notificationDismiss": "关闭通知",
   "all": "全部",
   "yes": "是",
   "no": "否",
@@ -56,6 +57,7 @@
   "themeDawn": "晨砂",
   "themeGraphite": "石墨",
   "themeNight": "暗夜",
+  "themeCharcoal": "炭夜",
   "themeProbe": "探针",
   "isRequired": "必填",
   "duplicate": "重复",
@@ -115,6 +117,30 @@
   "providerTestConnectionSuccess": "连接测试通过",
   "providerTestConnectionFailed": "连接测试失败",
   "providerModelsTitle": "可用模型列表",
+  "providerModelsFetch": "获取模型列表",
+  "providerModelsFetching": "获取中...",
+  "providerModelsFetchSuccess": "模型列表获取成功",
+  "providerModelsFetchFailed": "获取模型列表失败",
+  "providerModelsApiKeyRequired": "请先填写 API Key，再获取模型列表",
+  "providerModelsAuthorizationFailed": "认证失败，请检查 API Key 是否正确，以及 API 地址是否匹配",
+  "providerModelsSuggestionsChecking": "正在读取模型目录…",
+  "providerModelsSuggestionsFailed": "模型目录读取失败。请检查 API Key、API 地址或网络连接；你仍可手动添加模型。",
+  "providerModelsSuggestionsSummary": "目录中有 {count} 个未添加模型",
+  "providerModelsFetchedSuggestionsSummary": "已获取 {count} 个可添加模型",
+  "providerModelsFetchedAllConfigured": "已获取 {count} 个模型，当前列表已全部包含",
+  "providerModelsSuggestionsAddAll": "全部添加",
+  "providerModelsSuggestionSelect": "选择模型 {model}",
+  "providerModelsSuggestionsSelected": "已选择 {count} 个",
+  "providerModelsSuggestionsAddSelected": "添加所选",
+  "providerModelsSuggestionsSaveHint": "添加后请保存以应用配置。",
+  "providerModelsSuggestionsSearchPlaceholder": "搜索目录模型",
+  "providerModelsSuggestionsSearchEmpty": "没有匹配的模型",
+  "providerModelsSuggestionsShowing": "显示前 {visible} 个匹配项，共 {count} 个；继续搜索可缩小范围",
+  "providerModelsBulkRemove": "批量删除",
+  "providerModelsSelectAll": "全选",
+  "providerModelsClearSelection": "取消全选",
+  "providerModelsRemoveSelected": "删除所选",
+  "providerModelsRemoveSaveHint": "删除只会修改当前草稿，保存后才会应用。",
   "providerModelInputPlaceholder": "输入 provider 本地模型 ID（可包含 /）",
   "providerModelInputHint": "列表仅作参考，不在列表也可直接输入并添加。",
   "providerAddModel": "添加模型",

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

@@ -68,6 +68,7 @@
   "serviceAppsEmptyTitle": "暂无服务应用",
   "serviceAppsEmptyDescription": "服务应用提供本地运行时与动作，供面板应用调用。",
   "serviceAppsRefresh": "刷新服务应用",
+  "serviceAppsConnect": "连接",
   "serviceAppsDiscoverActions": "连接并发现动作",
   "serviceAppsDiscoverActionsHint": "连接服务应用运行时，并发现它当前可用的动作。",
   "serviceAppsDisconnectRuntime": "断开连接",

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

@@ -15,6 +15,7 @@
   "searchProviderBochaDescription": "更适合中国大陆用户的 AI 搜索。",
   "searchProviderTavilyDescription": "更适合调研和网页信息整合的搜索 provider。",
   "searchProviderBraveDescription": "保留 Brave 作为可选 provider。",
+  "searchProviderExaDescription": "语义搜索并提取网页正文，适合调研和资料发现。",
   "searchStatusConfigured": "已配置",
   "searchStatusNeedsSetup": "待配置",
   "searchFreshnessNoLimit": "不限",

package/src/shared/lib/session-project/__tests__/workspace-file-breadcrumb.test.ts

@@ -1,5 +1,8 @@
 import { describe, expect, it } from "vitest";
-import { buildWorkspaceFileBreadcrumb } from "@/shared/lib/session-project";
+import {
+  buildWorkspaceFileBreadcrumb,
+  resolveWorkspaceRelativePath,
+} from "@/shared/lib/session-project";
 
 describe("buildWorkspaceFileBreadcrumb", () => {
   it("builds project-relative breadcrumbs for files inside the active workspace", () => {
@@ -92,3 +95,27 @@ describe("buildWorkspaceFileBreadcrumb", () => {
     expect(breadcrumb.segments[1]?.label).toBe("README.md");
   });
 });
+
+describe("resolveWorkspaceRelativePath", () => {
+  it("normalizes relative and project-contained absolute file paths", () => {
+    expect(resolveWorkspaceRelativePath({
+      path: "src\\chat\\example.tsx",
+      sessionProjectRoot: "C:\\work\\nextclaw",
+    })).toBe("src/chat/example.tsx");
+    expect(resolveWorkspaceRelativePath({
+      path: "/Users/demo/project-alpha/src/chat/example.tsx",
+      sessionProjectRoot: "/Users/demo/project-alpha",
+    })).toBe("src/chat/example.tsx");
+  });
+
+  it("rejects project-external and parent-traversing paths", () => {
+    expect(resolveWorkspaceRelativePath({
+      path: "/tmp/example.ts",
+      sessionProjectRoot: "/Users/demo/project-alpha",
+    })).toBeNull();
+    expect(resolveWorkspaceRelativePath({
+      path: "../secrets.txt",
+      sessionProjectRoot: "/Users/demo/project-alpha",
+    })).toBeNull();
+  });
+});

package/src/shared/lib/session-project/workspace-file-breadcrumb.utils.ts

@@ -127,6 +127,29 @@ function readRelativeSegments(params: {
   return normalizedPath.slice(rootPrefix.length).split("/").filter(Boolean);
 }
 
+export function resolveWorkspaceRelativePath(params: {
+  path: string;
+  sessionProjectRoot: string | null;
+}): string | null {
+  const projectRoot = params.sessionProjectRoot?.trim();
+  if (!projectRoot) {
+    return null;
+  }
+
+  const segments = readRelativeSegments({
+    path: params.path,
+    sessionProjectRoot: projectRoot,
+  });
+  if (
+    !segments?.length ||
+    segments.some((segment) => segment === "." || segment === "..")
+  ) {
+    return null;
+  }
+
+  return segments.join("/");
+}
+
 function buildSegmentsFromLabels(params: {
   labels: string[];
   basePath?: string | null;

package/src/shared/lib/theme/index.test.ts

@@ -1,6 +1,8 @@
 import { beforeEach, describe, expect, it } from 'vitest';
 import {
   DEFAULT_UI_THEME,
+  getThemeAppearance,
+  normalizeTheme,
   resolveInitialTheme,
   THEME_OPTIONS,
 } from './index';
@@ -18,4 +20,13 @@ describe('ui theme defaults', () => {
   it('lists the default theme first', () => {
     expect(THEME_OPTIONS[0]?.value).toBe(DEFAULT_UI_THEME);
   });
+
+  it('recognizes charcoal as a dark theme', () => {
+    expect(normalizeTheme('charcoal')).toBe('charcoal');
+    expect(getThemeAppearance('charcoal')).toBe('dark');
+    expect(THEME_OPTIONS).toContainEqual({
+      value: 'charcoal',
+      labelKey: 'themeCharcoal',
+    });
+  });
 });

package/src/shared/lib/theme/index.ts

@@ -7,6 +7,7 @@ export type UiTheme =
   | 'dawn'
   | 'graphite'
   | 'night'
+  | 'charcoal'
   | 'probe';
 export type UiThemeAppearance = 'light' | 'dark';
 
@@ -22,6 +23,7 @@ export const DEFAULT_UI_THEME: UiTheme = 'work';
 const THEME_DEFINITIONS: readonly UiThemeDefinition[] = [
   { value: 'work', labelKey: 'themeWork', appearance: 'light' },
   { value: 'night', labelKey: 'themeNight', appearance: 'dark' },
+  { value: 'charcoal', labelKey: 'themeCharcoal', appearance: 'dark' },
   { value: 'natural', labelKey: 'themeNatural', appearance: 'light' },
   { value: 'minimal', labelKey: 'themeMinimal', appearance: 'light' },
   { value: 'warm', labelKey: 'themeWarm', appearance: 'light' },