Merge branch 'main' into feat/onboarding-patch-preference

Resolve conflicts, take main's version for all files.

.agents/skills/docs-changelog/SKILL.md

@@ -0,0 +1,155 @@
+---
+name: docs-changelog
+description: 'Writing guide for website changelog pages under docs/changelog/*.mdx. Use when creating or editing product update posts in EN/ZH. Not for GitHub Release notes.'
+---
+
+# Docs Changelog Writing Guide
+
+## Scope Boundary (Important)
+
+This skill is only for changelog pages in:
+
+- `docs/changelog/*.mdx`
+
+This skill is **not** for GitHub Releases.\
+If the user asks for release PR body / GitHub Release notes, load `../version-release/SKILL.md`.
+
+## Mandatory Companion Skills
+
+For every docs changelog task, you MUST load:
+
+- `../microcopy/SKILL.md`
+- `../i18n/SKILL.md` (when EN/ZH pair is involved)
+
+## File and Naming Convention
+
+Use date-based file names:
+
+- English: `docs/changelog/YYYY-MM-DD-topic.mdx`
+- Chinese: `docs/changelog/YYYY-MM-DD-topic.zh-CN.mdx`
+
+EN and ZH files must exist as a pair and describe the same release facts.
+
+## Frontmatter Requirements
+
+Each file should include:
+
+```md
+---
+title: <Title>
+description: <1 sentence summary>
+tags:
+  - <Tag 1>
+  - <Tag 2>
+---
+```
+
+Rules:
+
+1. `title` should match the H1 title in meaning.
+2. `description` should be concise and user-facing.
+3. `tags` should be feature-oriented, not internal-team labels.
+
+## Content Structure (Recommended)
+
+Use this shape unless the user requests otherwise:
+
+1. `# <Title>`
+2. Opening paragraph (2-4 sentences): user-visible impact
+3. 1-3 capability sections (optional `##` headings)
+4. `## Improvements and fixes` / `## 体验优化与修复` with concise bullets
+
+Keep heading count low and avoid heading-per-bullet structure.
+
+## Writing Rules
+
+1. Keep all claims factual and tied to actual shipped changes.
+2. Explain user value first, implementation second.
+3. Prefer natural narrative paragraphs over pure bullet dumps.
+4. Avoid marketing exaggeration and vague adjectives.
+5. Keep internal terms consistent across EN/ZH files.
+6. Keep EN/ZH section order aligned and scope-aligned.
+
+## EN/ZH Synchronization Rules
+
+When generating bilingual changelogs:
+
+1. Keep the same key facts in the same order.
+2. Localize naturally; do not do literal sentence-by-sentence translation.
+3. If one version has an `Improvements and fixes` bullet list, the other should have equivalent list intent.
+4. Do not introduce capabilities in only one language unless explicitly requested.
+
+## Length Guidance
+
+- Small update: 3-5 short paragraphs total
+- Medium update: 4-7 short paragraphs + concise fix bullets
+- Large update: 6-10 short paragraphs split into 2-4 sections
+
+Do not pad content when changes are limited.
+
+## Authoring Workflow
+
+1. Collect source facts from PRs/commits/issues.
+2. Group changes by user workflow (not by internal module path).
+3. Draft EN and ZH versions with aligned structure.
+4. Verify terminology using `microcopy`/`i18n` guidance.
+5. Final pass: remove AI-like filler and tighten sentences.
+
+## Docs Changelog Template (English)
+
+```md
+---
+title: <Feature title>
+description: <One-sentence summary for users>
+tags:
+  - <Tag A>
+  - <Tag B>
+---
+
+# <Feature title>
+
+<Opening paragraph: what changed for users and why it matters.>
+
+<Optional section paragraph for key capability 1.>
+
+<Optional section paragraph for key capability 2.>
+
+## Improvements and fixes
+
+- <Fix or optimization 1>
+- <Fix or optimization 2>
+```
+
+## Docs Changelog Template (Chinese)
+
+```md
+---
+title: <功能标题>
+description: <一句话说明>
+tags:
+  - <标签 A>
+  - <标签 B>
+---
+
+# <功能标题>
+
+<开场段：这次更新给用户带来的直接变化。>
+
+<可选能力段 1。>
+
+<可选能力段 2。>
+
+## 体验优化与修复
+
+- <优化或修复 1>
+- <优化或修复 2>
+```
+
+## Quick Checklist
+
+- [ ] File path matches `docs/changelog` naming convention
+- [ ] EN and ZH versions both exist and match in facts
+- [ ] Opening paragraph explains user-facing outcome
+- [ ] Main body is narrative-first, not bullet-only
+- [ ] `Improvements and fixes` section is concise and concrete
+- [ ] No fabricated claims or unsupported scope

.agents/skills/local-testing/SKILL.md

@@ -173,6 +173,10 @@ agent-browser state save auth.json
 agent-browser state load auth.json
 ```
 
+### LobeHub dev server — inject better-auth cookie
+
+`agent-browser --headed` on macOS can create an off-screen Chromium window, blocking manual login. For a local LobeHub dev server (e.g. `localhost:3011`), copy the `better-auth.session_token` cookie out of a **Network request** in the user's own Chrome DevTools and load it via `state load`. See [references/agent-browser-login.md](./references/agent-browser-login.md) for the full recipe.
+
 ## Semantic Locators (Alternative to Refs)
 
 ```bash

.agents/skills/local-testing/references/agent-browser-login.md

@@ -0,0 +1,110 @@
+# Log `agent-browser` into a local LobeHub dev server
+
+`agent-browser --headed` on macOS often creates the Chromium window off-screen — the user can't see or interact with it, so manual login inside the agent-browser session fails. Instead of sharing the user's real Chrome profile, copy the **better-auth session cookie** out of a request in DevTools and inject it into the agent-browser session as a Playwright-style state file.
+
+## When to use
+
+- You need `agent-browser` to reach an authenticated page on `http://localhost:<port>` (e.g. `localhost:3011`).
+- The user already has a logged-in tab of the same dev server in their own Chrome.
+- Spawning a headed Chromium to let the user log in manually is unreliable (window off-screen, no interaction).
+
+Do **not** use this on production URLs — only local dev. Treat the cookie as a secret: don't paste it into shared logs, PRs, or commit it anywhere.
+
+## Step 1 — Ask the user to copy the cookie from a Network request, NOT `document.cookie`
+
+`document.cookie` will not return HttpOnly cookies, which is exactly where better-auth puts its session. Instruct the user:
+
+1. Open the logged-in tab (`http://localhost:<port>/…`) in their own Chrome.
+2. `Cmd+Option+I` → **Network** tab.
+3. Refresh, click any same-origin request (e.g. the top-level document request).
+4. In the right pane under **Request Headers**, right-click the `Cookie:` line → **Copy value** (or copy the entire header).
+5. Paste the string into chat.
+
+You only need the better-auth pieces. Everything else (Clerk, `LOBE_LOCALE`, HMR hash, theme vars) is noise and can stay. The minimum viable set is:
+
+```
+better-auth.session_token=<value>; better-auth.state=<value>
+```
+
+## Step 2 — Build a Playwright-style state file
+
+`agent-browser state load` expects Playwright's `storageState` format: a JSON with a `cookies` array and an `origins` array.
+
+```bash
+cat > /tmp/mkstate.py << 'PY'
+import json, sys, time
+
+# Read the Cookie header from stdin (allows optional "Cookie: " prefix).
+raw = sys.stdin.read().strip()
+if raw.lower().startswith("cookie:"):
+    raw = raw.split(":", 1)[1].strip()
+
+# Keep only better-auth cookies. Extend this set if the app genuinely needs more.
+WANTED = {"better-auth.session_token", "better-auth.state"}
+
+cookies = []
+exp = int(time.time()) + 30 * 24 * 3600  # 30 days
+for pair in raw.split("; "):
+    if "=" not in pair:
+        continue
+    name, _, value = pair.partition("=")
+    if name not in WANTED:
+        continue
+    cookies.append({
+        "name": name,
+        "value": value,
+        "domain": "localhost",
+        "path": "/",
+        "expires": exp,
+        "httpOnly": False,
+        "secure": False,
+        "sameSite": "Lax",
+    })
+
+if not cookies:
+    sys.stderr.write("no better-auth cookies found in input\n")
+    sys.exit(1)
+
+print(json.dumps({"cookies": cookies, "origins": []}, indent=2))
+PY
+
+# Feed the copied Cookie header in via env var or heredoc.
+printf '%s' "$COOKIE_HEADER" | python3 /tmp/mkstate.py > /tmp/state.json
+```
+
+**Note on `httpOnly`**: the real cookie in the user's browser is HttpOnly, but `storageState` doesn't enforce the flag on load — it just attaches the value. Storing with `httpOnly: false` is fine for local dev and sidesteps a CDP-context quirk where HttpOnly cookies sometimes fail to attach.
+
+## Step 3 — Load state and navigate
+
+```bash
+SESSION="my-test" # any stable session name
+
+agent-browser --session "$SESSION" state load /tmp/state.json
+agent-browser --session "$SESSION" open "http://localhost:3011/"
+agent-browser --session "$SESSION" get url
+# Expect NOT /signin?callbackUrl=… — if you still see signin, cookie didn't apply.
+```
+
+## Step 4 — Verify
+
+```bash
+agent-browser --session "$SESSION" snapshot -i | head -20
+# Look for the user's avatar/name in the sidebar, or absence of the signin form.
+```
+
+## Common failure modes
+
+| Symptom                                         | Cause                                                                   | Fix                                                  |
+| ----------------------------------------------- | ----------------------------------------------------------------------- | ---------------------------------------------------- |
+| Still redirects to `/signin` after `state load` | User pasted from `document.cookie` → missed HttpOnly session            | Re-pull from Network request Headers, not console    |
+| `state load` reports 0 cookies                  | Separator wrong, or user pasted URL-decoded value                       | Keep the raw `Cookie:` header as-is; split on `"; "` |
+| Login works briefly then expires                | `better-auth.session_token` rotated (user logged out / signed in again) | Re-copy and re-load                                  |
+| Domain mismatch                                 | Use `domain: "localhost"` literally, no leading dot for local dev       | —                                                    |
+
+## Scope
+
+Only covers authenticating an **agent-browser** session into a **local** LobeHub dev server. It does not:
+
+- Work for production — production cookies are `Secure; HttpOnly; Domain=.lobehub.com` and must be delivered over HTTPS.
+- Replace real OAuth flows — tests that must exercise the login UI need a real Chromium with `--remote-debugging-port` or a bot account.
+- Flow cookies back to the user's Chrome — injection is one-way (into agent-browser only).

.agents/skills/modal/SKILL.md

@@ -1,64 +1,76 @@
 ---
 name: modal
-description: Modal imperative API guide. Use when creating modal dialogs using createModal from @lobehub/ui. Triggers on modal component implementation or dialog creation tasks.
+description: MUST use when creating, editing, or writing modal dialogs or imperative modals. Prefer createModal / useModalContext / confirmModal from @lobehub/ui/base-ui; root @lobehub/ui is legacy (antd Modal). Covers patterns, ModalHost, and migration notes.
 user-invocable: false
 ---
 
 # Modal Imperative API Guide
 
-Use `createModal` from `@lobehub/ui` for imperative modal dialogs.
+## Recommended: `@lobehub/ui/base-ui`
 
-## Why Imperative?
+New code should use the **base-ui** modal stack (headless primitives, not antd `Modal`):
 
-| Mode        | Characteristics                       | Recommended |
-| ----------- | ------------------------------------- | ----------- |
-| Declarative | Need `open` state, render `<Modal />` | ❌          |
-| Imperative  | Call function directly, no state      | ✅          |
+- `createModal`, `confirmModal`, `ModalHost` from `@lobehub/ui/base-ui`
+- `useModalContext` from `@lobehub/ui/base-ui` inside modal **content**
 
-## File Structure
+Body slot: pass **`content`** (or `children`; runtime uses `content ?? children`).
+
+### Global `ModalHost` (required)
+
+Base-ui `createModal` renders through a **separate** host from the root package. The app must mount **`ModalHost`** from `@lobehub/ui/base-ui` once near the root (e.g. next to other global hosts). Without it, `createModal` calls will not appear.
+
+If the project only mounts `ModalHost` from `@lobehub/ui`, add a second lazy `ModalHost` from `@lobehub/ui/base-ui` until all imperative modals are migrated.
+
+### Why imperative?
+
+| Mode        | Characteristics                      | Recommended |
+| ----------- | ------------------------------------ | ----------- |
+| Declarative | `open` state + `<Modal />`           | ❌          |
+| Imperative  | Call `createModal()`, no local state | ✅          |
+
+### File structure
 
 ```
 features/
 └── MyFeatureModal/
-    ├── index.tsx           # Export createXxxModal
-    └── MyFeatureContent.tsx # Modal content
+    ├── index.tsx            # export createXxxModal
+    └── MyFeatureContent.tsx # modal body
 ```
 
-## Implementation
-
-### 1. Content Component (`MyFeatureContent.tsx`)
+### 1. Content (`MyFeatureContent.tsx`)
 
 ```tsx
 'use client';
 
-import { useModalContext } from '@lobehub/ui';
+import { useModalContext } from '@lobehub/ui/base-ui';
 import { useTranslation } from 'react-i18next';
 
 export const MyFeatureContent = () => {
   const { t } = useTranslation('namespace');
-  const { close } = useModalContext(); // Optional: get close method
+  const { close } = useModalContext();
 
-  return <div>{/* Modal content */}</div>;
+  return <div>{/* ... */}</div>;
 };
 ```
 
-### 2. Export createModal (`index.tsx`)
+### 2. `createModal` (`index.tsx`)
 
 ```tsx
 'use client';
 
-import { createModal } from '@lobehub/ui';
-import { t } from 'i18next'; // Note: use i18next, not react-i18next
+import { createModal } from '@lobehub/ui/base-ui';
+import { t } from 'i18next';
 
 import { MyFeatureContent } from './MyFeatureContent';
 
 export const createMyFeatureModal = () =>
   createModal({
-    allowFullscreen: true,
-    children: <MyFeatureContent />,
-    destroyOnHidden: false,
+    content: <MyFeatureContent />,
     footer: null,
-    styles: { body: { overflow: 'hidden', padding: 0 } },
+    maskClosable: true,
+    styles: {
+      content: { overflow: 'hidden', padding: 0 },
+    },
     title: t('myFeature.title', { ns: 'setting' }),
     width: 'min(80%, 800px)',
   });
@@ -76,27 +88,52 @@ const handleOpen = useCallback(() => {
 return <Button onClick={handleOpen}>Open</Button>;
 ```
 
-## i18n Handling
+### i18n
 
-- **Content component**: `useTranslation` hook (React context)
-- **createModal params**: `import { t } from 'i18next'` (non-hook, imperative)
+- **Content**: `useTranslation` in components.
+- **`createModal` options**: `import { t } from 'i18next'` where hooks are unavailable.
 
-## useModalContext Hook
+### `useModalContext`
 
 ```tsx
 const { close, setCanDismissByClickOutside } = useModalContext();
 ```
 
-## Common Config
+### Common options (base-ui)
 
-| Property          | Type                | Description              |
-| ----------------- | ------------------- | ------------------------ |
-| `allowFullscreen` | `boolean`           | Allow fullscreen mode    |
-| `destroyOnHidden` | `boolean`           | Destroy content on close |
-| `footer`          | `ReactNode \| null` | Footer content           |
-| `width`           | `string \| number`  | Modal width              |
+`ImperativeModalProps` builds on `BaseModalProps`: `title`, `width`, `maskClosable`, `open`, `onOpenChange`, `footer`, `styles` / `classNames` (keys: `backdrop`, `popup`, `header`, `title`, `close`, `content`, …).
+
+| Property       | Notes                                    |
+| -------------- | ---------------------------------------- |
+| `content`      | Main body (preferred name vs `children`) |
+| `maskClosable` | Click outside to dismiss                 |
+| `styles.*`     | Semantic regions, not antd `styles.body` |
+
+### Confirm
+
+```tsx
+import { confirmModal } from '@lobehub/ui/base-ui';
+
+confirmModal({
+  title: '…',
+  content: '…',
+  okText: '…',
+  cancelText: '…',
+  onOk: async () => {},
+});
+```
+
+---
+
+## Legacy: `@lobehub/ui` (root)
+
+Older call sites use **`createModal` from `@lobehub/ui`**, which is typed as **antd `Modal` props** (`children`, `allowFullscreen`, `getContainer`, `destroyOnHidden`, `styles.body`, etc.). Prefer migrating new work to **`@lobehub/ui/base-ui`**.
+
+Examples (legacy): `src/features/SkillStore/index.tsx`, `src/features/LibraryModal/CreateNew/index.tsx`.
+
+---
 
 ## Examples
 
-- `src/features/SkillStore/index.tsx`
-- `src/features/LibraryModal/CreateNew/index.tsx`
+- Base-ui (preferred): follow sections above; ensure **base-ui `ModalHost`** is mounted.
+- Legacy: `src/features/SkillStore/index.tsx`, `src/features/LibraryModal/CreateNew/index.tsx`

.agents/skills/react/SKILL.md

@@ -67,7 +67,7 @@ import { dynamicElement, redirectElement, ErrorBoundary } from '@/utils/router';
 
 element: dynamicElement(() => import('./chat'), 'Desktop > Chat');
 element: redirectElement('/settings/profile');
-errorElement: <ErrorBoundary resetPath="/chat" />;
+errorElement: <ErrorBoundary />;
 ```
 
 ### Navigation

.github/workflows/test.yml

@@ -97,8 +97,8 @@ jobs:
     if: needs.check-duplicate-run.outputs.should_skip != 'true'
     strategy:
       matrix:
-        shard: [1, 2]
-    name: Test App (shard ${{ matrix.shard }}/2)
+        shard: [1, 2, 3]
+    name: Test App (shard ${{ matrix.shard }}/3)
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
@@ -110,7 +110,7 @@ jobs:
         run: pnpm install
 
       - name: Run tests
-        run: bunx vitest --coverage --silent='passed-only' --reporter=default --reporter=blob --shard=${{ matrix.shard }}/2
+        run: bunx vitest --coverage --silent='passed-only' --reporter=default --reporter=blob --shard=${{ matrix.shard }}/3
 
       - name: Upload blob report
         if: ${{ !cancelled() }}

.gitignore

@@ -146,4 +146,4 @@ apps/desktop/resources/cli-package.json
 
 # Superpowers plugin brainstorm/spec outputs (local only; do not commit)
 .superpowers/
-docs/superpowers/
+.heerogeneous-tracing

apps/cli/src/commands/task/index.ts

@@ -466,7 +466,12 @@ export function registerTaskCommand(program: Command) {
                   : act.priority === 'normal'
                     ? pc.yellow(' [normal]')
                     : '';
-              const resolved = act.resolvedAction ? pc.green(` ✏️ ${act.resolvedAction}`) : '';
+              const resolvedLabel = act.resolvedAction
+                ? act.resolvedComment
+                  ? `${act.resolvedAction}: ${act.resolvedComment}`
+                  : act.resolvedAction
+                : '';
+              const resolved = resolvedLabel ? pc.green(` ✏️ ${resolvedLabel}`) : '';
               const typeLabel = pc.dim(`[${act.briefType}]`);
               console.log(
                 `  ${icon} ${pc.dim(ago.padStart(7))} Brief ${typeLabel} ${act.title}${pri}${resolved}${idSuffix}`,

apps/desktop/electron.vite.config.ts

@@ -15,15 +15,64 @@ import {
 import { getExternalDependencies } from './native-deps.config.mjs';
 
 /**
- * Rewrite `/` to `/apps/desktop/index.html` so the electron-vite dev server
- * serves the desktop HTML entry when root is the monorepo root.
+ * Force `base: '/'` in renderer config. The `electron-vite` preset
+ * unconditionally rewrites base to `'./'` in production (with `enforce: 'pre'`),
+ * which produces relative asset URLs like `../../assets/...`. Those break in
+ * the popup window because its SPA URL (`/popup/agent/:aid/:tid`) is deep
+ * enough that relative resolution lands at `/popup/assets/...` instead of the
+ * actual `/assets/...`. Our `app://` protocol handler resolves absolute
+ * `/assets/...` correctly regardless of URL depth.
+ */
+function forceAbsoluteBasePlugin(): PluginOption {
+  return {
+    name: 'electron-desktop-force-base',
+    config(config) {
+      config.base = '/';
+    },
+  };
+}
+
+/**
+ * Rewrite SPA routes to their corresponding HTML entry so the electron-vite
+ * dev server serves the right HTML when root is the monorepo root.
+ *
+ * - `/popup/*` → `/apps/desktop/popup.html` (topic popup SPA)
+ * - `/`, `/index.html`, and everything else → `/apps/desktop/index.html`
  */
 function electronDesktopHtmlPlugin(): PluginOption {
   return {
     configureServer(server: ViteDevServer) {
       server.middlewares.use((req, _res, next) => {
-        if (req.url === '/' || req.url === '/index.html') {
+        const rawUrl = req.url ?? '';
+        const pathname = rawUrl.split('?')[0];
+
+        // Explicit document-entry requests — always rewrite.
+        if (pathname === '/' || pathname === '/index.html') {
           req.url = '/apps/desktop/index.html';
+          next();
+          return;
+        }
+        if (pathname === '/popup.html') {
+          req.url = '/apps/desktop/popup.html';
+          next();
+          return;
+        }
+
+        // For SPA deep links (e.g. `/popup/agent/A/T`) rewrite to the popup
+        // HTML — but skip asset / module requests that happen to share the
+        // prefix (e.g. `/popup/@vite/client` would have been generated by a
+        // mis-resolved relative import).
+        const lastSegment = pathname.split('/').pop() ?? '';
+        const looksLikeAsset =
+          lastSegment.includes('.') ||
+          pathname.startsWith('/@') ||
+          pathname.startsWith('/src/') ||
+          pathname.startsWith('/node_modules/') ||
+          pathname.startsWith('/apps/') ||
+          pathname.startsWith('/packages/');
+
+        if (!looksLikeAsset && (pathname === '/popup' || pathname.startsWith('/popup/'))) {
+          req.url = '/apps/desktop/popup.html';
         }
         next();
       });
@@ -102,7 +151,10 @@ export default defineConfig({
     build: {
       outDir: path.resolve(__dirname, 'dist/renderer'),
       rollupOptions: {
-        input: path.resolve(__dirname, 'index.html'),
+        input: {
+          main: path.resolve(__dirname, 'index.html'),
+          popup: path.resolve(__dirname, 'popup.html'),
+        },
         output: sharedRollupOutput,
       },
     },
@@ -112,6 +164,7 @@ export default defineConfig({
     },
     optimizeDeps: sharedOptimizeDeps,
     plugins: [
+      forceAbsoluteBasePlugin(),
       electronDesktopHtmlPlugin(),
       ...(sharedRendererPlugins({ platform: 'desktop' }) as PluginOption[]),
     ],

apps/desktop/pnpm-workspace.yaml

@@ -1,8 +1,11 @@
 packages:
+  - '../../packages/const'
   - '../../packages/electron-server-ipc'
   - '../../packages/electron-client-ipc'
   - '../../packages/file-loaders'
   - '../../packages/desktop-bridge'
   - '../../packages/device-gateway-client'
   - '../../packages/local-file-shell'
+  - './stubs/business-const'
+  - './stubs/types'
   - '.'

apps/desktop/popup.html

@@ -0,0 +1,114 @@
+<!doctype html>
+<html class="desktop">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <style>
+      html,
+      body {
+        margin: 0;
+        height: 100%;
+        background: transparent;
+      }
+      html[data-theme='dark'] {
+        background: #141414;
+      }
+      html[data-theme='light'] {
+        background: #fafafa;
+      }
+      #loading-screen {
+        position: fixed;
+        inset: 0;
+        z-index: 99999;
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        justify-content: center;
+        background: inherit;
+        gap: 12px;
+      }
+      @keyframes loading-draw {
+        0% {
+          stroke-dashoffset: 1000;
+        }
+        100% {
+          stroke-dashoffset: 0;
+        }
+      }
+      @keyframes loading-fill {
+        30% {
+          fill-opacity: 0.05;
+        }
+        100% {
+          fill-opacity: 1;
+        }
+      }
+      #loading-brand {
+        display: flex;
+        align-items: center;
+        gap: 12px;
+        color: #1f1f1f;
+      }
+      #loading-brand svg path {
+        fill: currentcolor;
+        fill-opacity: 0;
+        stroke: currentcolor;
+        stroke-dasharray: 1000;
+        stroke-dashoffset: 1000;
+        stroke-width: 0.25em;
+        animation:
+          loading-draw 2s cubic-bezier(0.4, 0, 0.2, 1) infinite,
+          loading-fill 2s cubic-bezier(0.4, 0, 0.2, 1) infinite;
+      }
+      html[data-theme='dark'] #loading-brand {
+        color: #f0f0f0;
+      }
+    </style>
+  </head>
+  <body>
+    <script>
+      (function () {
+        var theme = 'system';
+        try {
+          theme = localStorage.getItem('theme') || 'system';
+        } catch (_) {}
+        var systemTheme =
+          window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches
+            ? 'dark'
+            : 'light';
+        var resolvedTheme = theme === 'system' ? systemTheme : theme;
+        if (resolvedTheme === 'dark' || resolvedTheme === 'light') {
+          document.documentElement.setAttribute('data-theme', resolvedTheme);
+        }
+        var urlParams = new URLSearchParams(window.location.search);
+        var locale = urlParams.get('lng') || navigator.language || 'en-US';
+        document.documentElement.lang = locale;
+        var rtl = ['ar', 'arc', 'dv', 'fa', 'ha', 'he', 'khw', 'ks', 'ku', 'ps', 'ur', 'yi'];
+        document.documentElement.dir =
+          rtl.indexOf(locale.split('-')[0].toLowerCase()) >= 0 ? 'rtl' : 'ltr';
+      })();
+    </script>
+    <div id="loading-screen">
+      <div id="loading-brand" aria-label="Loading" role="status">
+        <svg
+          fill="currentColor"
+          fill-rule="evenodd"
+          height="40"
+          style="flex: none; line-height: 1"
+          viewBox="0 0 940 320"
+          xmlns="http://www.w3.org/2000/svg"
+        >
+          <title>LobeHub</title>
+          <path
+            d="M15 240.035V87.172h39.24V205.75h66.192v34.285H15zM183.731 242c-11.759 0-22.196-2.621-31.313-7.862-9.116-5.241-16.317-12.447-21.601-21.619-5.153-9.317-7.729-19.945-7.729-31.883 0-11.937 2.576-22.492 7.729-31.664 5.164-8.963 12.159-15.98 20.982-21.05l.619-.351c9.117-5.241 19.554-7.861 31.313-7.861s22.196 2.62 31.313 7.861c9.248 5.096 16.449 12.229 21.601 21.401 5.153 9.172 7.729 19.727 7.729 31.664 0 11.938-2.576 22.566-7.729 31.883-5.152 9.172-12.353 16.378-21.601 21.619-9.117 5.241-19.554 7.862-31.313 7.862zm0-32.975c4.36 0 8.191-1.092 11.494-3.275 3.436-2.184 6.144-5.387 8.126-9.609 1.982-4.367 2.973-9.536 2.973-15.505 0-5.968-.991-10.991-2.973-15.067-1.906-4.06-4.483-7.177-7.733-9.352l-.393-.257c-3.303-2.184-7.134-3.276-11.494-3.276-4.228 0-8.059 1.092-11.495 3.276-3.303 2.184-6.011 5.387-8.125 9.609-1.982 4.076-2.973 9.099-2.973 15.067 0 5.969.991 11.138 2.973 15.505 2.114 4.222 4.822 7.425 8.125 9.609 3.436 2.183 7.267 3.275 11.495 3.275zM295.508 78l-.001 54.042a34.071 34.071 0 016.541-5.781c6.474-4.367 14.269-6.551 23.385-6.551 9.777 0 18.629 2.475 26.557 7.424 7.872 4.835 14.105 11.684 18.7 20.546l.325.637c4.756 9.026 7.135 19.799 7.135 32.319 0 12.666-2.379 23.585-7.135 32.757-4.624 9.026-10.966 16.087-19.025 21.182-7.928 4.95-16.78 7.425-26.557 7.425-9.644 0-17.704-2.184-24.178-6.551-2.825-1.946-5.336-4.355-7.532-7.226l.001 11.812h-35.87V78h37.654zm21.998 74.684c-4.228 0-8.059 1.092-11.494 3.276-3.303 2.184-6.012 5.387-8.126 9.609-1.982 4.076-2.972 9.099-2.972 15.067 0 5.969.99 11.138 2.972 15.505 2.114 4.222 4.823 7.425 8.126 9.609 3.435 2.183 7.266 3.275 11.494 3.275s7.994-1.092 11.297-3.275c3.435-2.184 6.143-5.387 8.125-9.609 2.114-4.367 3.171-9.536 3.171-15.505 0-5.968-1.057-10.991-3.171-15.067-1.906-4.06-4.483-7.177-7.732-9.352l-.393-.257c-3.303-2.184-7.069-3.276-11.297-3.276zm105.335 38.653l.084.337a27.857 27.857 0 002.057 5.559c2.246 4.222 5.417 7.498 9.513 9.827 4.096 2.184 8.984 3.276 14.665 3.276 5.285 0 9.777-.801 13.477-2.403 3.579-1.632 7.1-4.025 10.564-7.182l.732-.679 19.818 22.711c-5.153 6.26-11.494 11.064-19.025 14.413-7.531 3.203-16.449 4.804-26.755 4.804-12.683 0-23.782-2.621-33.294-7.862-9.381-5.386-16.713-12.665-21.998-21.837-5.153-9.317-7.729-19.872-7.729-31.665 0-11.792 2.51-22.274 7.53-31.446 5.036-9.105 11.902-16.195 20.596-21.268l.61-.351c8.984-5.241 19.091-7.861 30.322-7.861 10.311 0 19.743 2.286 28.294 6.859l.64.347c8.72 4.659 15.656 11.574 20.809 20.746 5.153 9.172 7.729 20.309 7.729 33.411 0 1.294-.052 2.761-.156 4.4l-.042.623-.17 2.353c-.075 1.01-.151 1.973-.227 2.888h-78.044zm21.365-42.147c-4.492 0-8.456 1.092-11.891 3.276-3.303 2.184-5.879 5.314-7.729 9.39a26.04 26.04 0 00-1.117 2.79 30.164 30.164 0 00-1.121 4.499l-.058.354h43.96l-.015-.106c-.401-2.638-1.122-5.055-2.163-7.252l-.246-.503c-1.776-3.774-4.282-6.742-7.519-8.906l-.409-.266c-3.303-2.184-7.2-3.276-11.692-3.276zm111.695-62.018l-.001 57.432h53.51V87.172h39.24v152.863h-39.24v-59.617H555.9l.001 59.617h-39.24V87.172h39.24zM715.766 242c-8.72 0-16.581-1.893-23.583-5.678-6.87-3.785-12.287-9.681-16.251-17.688-3.832-8.153-5.747-18.417-5.747-30.791v-66.168h37.654v59.398c0 9.172 1.519 15.723 4.558 19.654 3.171 3.931 7.597 5.896 13.278 5.896 3.7 0 7.069-.946 10.108-2.839 3.038-1.892 5.483-4.877 7.332-8.953 1.85-4.222 2.775-9.609 2.775-16.16v-56.996h37.654v118.36h-35.871l.004-12.38c-2.642 3.197-5.682 5.868-9.12 8.012-7.002 4.222-14.599 6.333-22.791 6.333zM841.489 78l-.001 54.041a34.1 34.1 0 016.541-5.78c6.474-4.367 14.269-6.551 23.385-6.551 9.777 0 18.629 2.475 26.556 7.424 7.873 4.835 14.106 11.684 18.701 20.546l.325.637c4.756 9.026 7.134 19.799 7.134 32.319 0 12.666-2.378 23.585-7.134 32.757-4.624 9.026-10.966 16.087-19.026 21.182-7.927 4.95-16.779 7.425-26.556 7.425-9.645 0-17.704-2.184-24.178-6.551-2.825-1.946-5.336-4.354-7.531-7.224v11.81h-35.87V78h37.654zm21.998 74.684c-4.228 0-8.059 1.092-11.495 3.276-3.303 2.184-6.011 5.387-8.125 9.609-1.982 4.076-2.973 9.099-2.973 15.067 0 5.969.991 11.138 2.973 15.505 2.114 4.222 4.822 7.425 8.125 9.609 3.436 2.183 7.267 3.275 11.495 3.275 4.228 0 7.993-1.092 11.296-3.275 3.435-2.184 6.144-5.387 8.126-9.609 2.114-4.367 3.171-9.536 3.171-15.505 0-5.968-1.057-10.991-3.171-15.067-1.906-4.06-4.484-7.177-7.733-9.352l-.393-.257c-3.303-2.184-7.068-3.276-11.296-3.276z"
+          />
+        </svg>
+      </div>
+    </div>
+    <div id="root" style="height: 100%"></div>
+    <script>
+      window.__SERVER_CONFIG__ = undefined;
+    </script>
+    <script type="module" src="/src/spa/entry.popup.tsx"></script>
+  </body>
+</html>

apps/desktop/src/main/appBrowsers.ts

@@ -66,6 +66,20 @@ export const windowTemplates = {
     titleBarStyle: 'hidden',
     width: 900,
   },
+  // Dedicated single-topic popup window. Loads the popup.html SPA entry
+  // (no sidebar / portal), one window per (scope, id) pair.
+  topicPopup: {
+    allowMultipleInstances: true,
+    autoHideMenuBar: true,
+    baseIdentifier: 'topicPopup',
+    basePath: '/popup',
+    height: 720,
+    keepAlive: false,
+    minWidth: 480,
+    parentIdentifier: 'app',
+    titleBarStyle: 'hidden',
+    width: 900,
+  },
 } satisfies Record<string, WindowTemplate>;
 
 export type AppBrowsersIdentifiers = keyof typeof appBrowsers;

apps/desktop/src/main/const/store.ts

@@ -1,11 +1,11 @@
 /**
  * Application settings storage related constants
  */
+import { DEFAULT_ELECTRON_DESKTOP_SHORTCUTS } from '@lobechat/const/desktopGlobalShortcuts';
 import type { NetworkProxySettings } from '@lobechat/electron-client-ipc';
 
 import { appStorageDir } from '@/const/dir';
 import { UPDATE_CHANNEL } from '@/modules/updater/configs';
-import { DEFAULT_SHORTCUTS_CONFIG } from '@/shortcuts';
 import type { ElectronMainStore } from '@/types/store';
 
 /**
@@ -35,7 +35,7 @@ export const STORE_DEFAULTS: ElectronMainStore = {
   gatewayUrl: 'https://device-gateway.lobehub.com',
   locale: 'auto',
   networkProxy: defaultProxySettings,
-  shortcuts: DEFAULT_SHORTCUTS_CONFIG,
+  shortcuts: DEFAULT_ELECTRON_DESKTOP_SHORTCUTS,
   storagePath: appStorageDir,
   themeMode: 'system',
   updateChannel: UPDATE_CHANNEL,

apps/desktop/src/main/controllers/BrowserWindowsCtr.ts

@@ -1,4 +1,5 @@
 import type {
+  FocusTopicPopupParams,
   InterceptRouteParams,
   OpenSettingsWindowOptions,
   WindowMinimumSizeParams,
@@ -80,6 +81,30 @@ export default class BrowserWindowsCtr extends ControllerModule {
     });
   }
 
+  @IpcMethod()
+  setWindowAlwaysOnTop(flag: boolean) {
+    this.withSenderIdentifier((identifier) => {
+      this.app.browserManager.setWindowAlwaysOnTop(identifier, flag);
+    });
+  }
+
+  @IpcMethod()
+  isWindowAlwaysOnTop() {
+    return this.withSenderIdentifier((identifier) => {
+      return this.app.browserManager.isWindowAlwaysOnTop(identifier);
+    });
+  }
+
+  @IpcMethod()
+  listTopicPopups() {
+    return this.app.browserManager.listTopicPopups();
+  }
+
+  @IpcMethod()
+  focusTopicPopup(params: FocusTopicPopupParams) {
+    return this.app.browserManager.focusTopicPopup(params.identifier);
+  }
+
   @IpcMethod()
   setWindowSize(params: WindowSizeParams) {
     this.withSenderIdentifier((identifier) => {

apps/desktop/src/main/controllers/HeterogeneousAgentCtr.ts

@@ -0,0 +1,436 @@
+import type { ChildProcess } from 'node:child_process';
+import { spawn } from 'node:child_process';
+import { createHash, randomUUID } from 'node:crypto';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import type { Readable, Writable } from 'node:stream';
+
+import { app as electronApp, BrowserWindow } from 'electron';
+
+import { createLogger } from '@/utils/logger';
+
+import { ControllerModule, IpcMethod } from './index';
+
+const logger = createLogger('controllers:HeterogeneousAgentCtr');
+
+/** Directory under appStoragePath for caching downloaded files */
+const FILE_CACHE_DIR = 'heteroAgent/files';
+
+// ─── CLI presets per agent type ───
+// Mirrors @lobechat/heterogeneous-agents/registry but runs in main process
+// (can't import from the workspace package in Electron main directly)
+
+interface CLIPreset {
+  baseArgs: string[];
+  promptMode: 'positional' | 'stdin';
+  resumeArgs?: (sessionId: string) => string[];
+}
+
+const CLI_PRESETS: Record<string, CLIPreset> = {
+  'claude-code': {
+    baseArgs: [
+      '-p',
+      '--input-format',
+      'stream-json',
+      '--output-format',
+      'stream-json',
+      '--verbose',
+      '--include-partial-messages',
+      '--permission-mode',
+      'bypassPermissions',
+    ],
+    promptMode: 'stdin',
+    resumeArgs: (sid) => ['--resume', sid],
+  },
+  // Future presets:
+  // 'codex': { baseArgs: [...], promptMode: 'positional' },
+  // 'kimi-cli': { baseArgs: [...], promptMode: 'positional' },
+};
+
+// ─── IPC types ───
+
+interface StartSessionParams {
+  /** Agent type key (e.g., 'claude-code'). Defaults to 'claude-code'. */
+  agentType?: string;
+  /** Additional CLI arguments */
+  args?: string[];
+  /** Command to execute */
+  command: string;
+  /** Working directory */
+  cwd?: string;
+  /** Environment variables */
+  env?: Record<string, string>;
+  /** Session ID to resume (for multi-turn) */
+  resumeSessionId?: string;
+}
+
+interface StartSessionResult {
+  sessionId: string;
+}
+
+interface ImageAttachment {
+  id: string;
+  url: string;
+}
+
+interface SendPromptParams {
+  /** Image attachments to include in the prompt (downloaded from url, cached by id) */
+  imageList?: ImageAttachment[];
+  prompt: string;
+  sessionId: string;
+}
+
+interface CancelSessionParams {
+  sessionId: string;
+}
+
+interface StopSessionParams {
+  sessionId: string;
+}
+
+interface GetSessionInfoParams {
+  sessionId: string;
+}
+
+interface SessionInfo {
+  agentSessionId?: string;
+}
+
+// ─── Internal session tracking ───
+
+interface AgentSession {
+  agentSessionId?: string;
+  agentType: string;
+  args: string[];
+  command: string;
+  cwd?: string;
+  env?: Record<string, string>;
+  process?: ChildProcess;
+  sessionId: string;
+}
+
+/**
+ * External Agent Controller — manages external agent CLI processes via Electron IPC.
+ *
+ * Agent-agnostic: uses CLI presets from a registry to support Claude Code,
+ * Codex, Kimi CLI, etc. Only handles process lifecycle and raw stdout line
+ * broadcasting. All event parsing and DB persistence happens on the Renderer side.
+ *
+ * Lifecycle: startSession → sendPrompt → (heteroAgentRawLine broadcasts) → stopSession
+ */
+export default class HeterogeneousAgentCtr extends ControllerModule {
+  static override readonly groupName = 'heterogeneousAgent';
+
+  private sessions = new Map<string, AgentSession>();
+
+  // ─── Broadcast ───
+
+  private broadcast<T>(channel: string, data: T) {
+    for (const win of BrowserWindow.getAllWindows()) {
+      if (!win.isDestroyed()) {
+        win.webContents.send(channel, data);
+      }
+    }
+  }
+
+  // ─── File cache ───
+
+  private get fileCacheDir(): string {
+    return path.join(this.app.appStoragePath, FILE_CACHE_DIR);
+  }
+
+  /**
+   * Derive a filesystem-safe cache key for attachments.
+   *
+   * Never use the raw image id as a path segment — upstream callers can persist
+   * arbitrary ids and path.join would treat traversal sequences as real
+   * directories. A stable hash preserves cache hits without trusting the id as a
+   * filename.
+   */
+  private getImageCacheKey(imageId: string): string {
+    return createHash('sha256').update(imageId).digest('hex');
+  }
+
+  /**
+   * Download an image by URL, with local disk cache keyed by id.
+   */
+  private async resolveImage(
+    image: ImageAttachment,
+  ): Promise<{ buffer: Buffer; mimeType: string }> {
+    const cacheDir = this.fileCacheDir;
+    const cacheKey = this.getImageCacheKey(image.id);
+    const metaPath = path.join(cacheDir, `${cacheKey}.meta`);
+    const dataPath = path.join(cacheDir, cacheKey);
+
+    // Check cache first
+    try {
+      const metaRaw = await readFile(metaPath, 'utf8');
+      const meta = JSON.parse(metaRaw);
+      const buffer = await readFile(dataPath);
+      logger.debug('Image cache hit:', image.id);
+      return { buffer, mimeType: meta.mimeType || 'image/png' };
+    } catch {
+      // Cache miss — download
+    }
+
+    logger.info('Downloading image:', image.id);
+
+    const res = await fetch(image.url);
+    if (!res.ok)
+      throw new Error(`Failed to download image ${image.id}: ${res.status} ${res.statusText}`);
+
+    const arrayBuffer = await res.arrayBuffer();
+    const buffer = Buffer.from(arrayBuffer);
+    const mimeType = res.headers.get('content-type') || 'image/png';
+
+    // Write to cache
+    await mkdir(cacheDir, { recursive: true });
+    await writeFile(dataPath, buffer);
+    await writeFile(metaPath, JSON.stringify({ id: image.id, mimeType }));
+    logger.debug('Image cached:', image.id, `${buffer.length} bytes`);
+
+    return { buffer, mimeType };
+  }
+
+  /**
+   * Build a stream-json user message with text + optional image content blocks.
+   */
+  private async buildStreamJsonInput(
+    prompt: string,
+    imageList: ImageAttachment[] = [],
+  ): Promise<string> {
+    const content: any[] = [{ text: prompt, type: 'text' }];
+
+    for (const image of imageList) {
+      try {
+        const { buffer, mimeType } = await this.resolveImage(image);
+        content.push({
+          source: {
+            data: buffer.toString('base64'),
+            media_type: mimeType,
+            type: 'base64',
+          },
+          type: 'image',
+        });
+      } catch (err) {
+        logger.error(`Failed to resolve image ${image.id}:`, err);
+      }
+    }
+
+    return JSON.stringify({
+      message: { content, role: 'user' },
+      type: 'user',
+    });
+  }
+
+  // ─── IPC methods ───
+
+  /**
+   * Create a session (stores config, process spawned on sendPrompt).
+   */
+  @IpcMethod()
+  async startSession(params: StartSessionParams): Promise<StartSessionResult> {
+    const sessionId = randomUUID();
+    const agentType = params.agentType || 'claude-code';
+
+    this.sessions.set(sessionId, {
+      // If resuming, pre-set the agent session ID so sendPrompt adds --resume
+      agentSessionId: params.resumeSessionId,
+      agentType,
+      args: params.args || [],
+      command: params.command,
+      cwd: params.cwd,
+      env: params.env,
+      sessionId,
+    });
+
+    logger.info('Session created:', { agentType, sessionId });
+    return { sessionId };
+  }
+
+  /**
+   * Send a prompt to an agent session.
+   *
+   * Spawns the CLI process with preset flags. Broadcasts each stdout line
+   * as an `heteroAgentRawLine` event — Renderer side parses and adapts.
+   */
+  @IpcMethod()
+  async sendPrompt(params: SendPromptParams): Promise<void> {
+    const session = this.sessions.get(params.sessionId);
+    if (!session) throw new Error(`Session not found: ${params.sessionId}`);
+
+    const preset = CLI_PRESETS[session.agentType];
+    if (!preset) throw new Error(`Unknown agent type: ${session.agentType}`);
+
+    const useStdin = preset.promptMode === 'stdin';
+
+    // Build stream-json payload up-front so any image download errors
+    // surface before the process is spawned.
+    let stdinPayload: string | undefined;
+    if (useStdin) {
+      stdinPayload = await this.buildStreamJsonInput(params.prompt, params.imageList ?? []);
+    }
+
+    return new Promise<void>((resolve, reject) => {
+      // Build CLI args: base preset + resume + user args
+      const cliArgs = [
+        ...preset.baseArgs,
+        ...(session.agentSessionId && preset.resumeArgs
+          ? preset.resumeArgs(session.agentSessionId)
+          : []),
+        ...session.args,
+      ];
+
+      if (!useStdin && preset.promptMode === 'positional') {
+        // Positional mode: append prompt as a CLI arg (legacy / non-CC presets).
+        cliArgs.push(params.prompt);
+      }
+
+      // Fall back to the user's Desktop so the process never inherits
+      // the Electron parent's cwd (which is `/` when launched from Finder).
+      const cwd = session.cwd || electronApp.getPath('desktop');
+
+      logger.info('Spawning agent:', session.command, cliArgs.join(' '), `(cwd: ${cwd})`);
+
+      const proc = spawn(session.command, cliArgs, {
+        cwd,
+        env: { ...process.env, ...session.env },
+        stdio: [useStdin ? 'pipe' : 'ignore', 'pipe', 'pipe'],
+      });
+
+      // In stdin mode, write the stream-json message and close stdin.
+      if (useStdin && stdinPayload && proc.stdin) {
+        const stdin = proc.stdin as Writable;
+        stdin.write(stdinPayload + '\n', () => {
+          stdin.end();
+        });
+      }
+
+      session.process = proc;
+      let buffer = '';
+
+      // Stream stdout lines as raw events to Renderer
+      const stdout = proc.stdout as Readable;
+      stdout.on('data', (chunk: Buffer) => {
+        buffer += chunk.toString('utf8');
+        const lines = buffer.split('\n');
+        buffer = lines.pop() || '';
+
+        for (const line of lines) {
+          const trimmed = line.trim();
+          if (!trimmed) continue;
+
+          try {
+            const parsed = JSON.parse(trimmed);
+
+            // Extract agent session ID from init event (for multi-turn)
+            if (parsed.type === 'system' && parsed.subtype === 'init' && parsed.session_id) {
+              session.agentSessionId = parsed.session_id;
+            }
+
+            // Broadcast raw parsed JSON — Renderer handles all adaptation
+            this.broadcast('heteroAgentRawLine', {
+              line: parsed,
+              sessionId: session.sessionId,
+            });
+          } catch {
+            // Not valid JSON, skip
+          }
+        }
+      });
+
+      // Capture stderr
+      const stderrChunks: string[] = [];
+      const stderr = proc.stderr as Readable;
+      stderr.on('data', (chunk: Buffer) => {
+        stderrChunks.push(chunk.toString('utf8'));
+      });
+
+      proc.on('error', (err) => {
+        logger.error('Agent process error:', err);
+        this.broadcast('heteroAgentSessionError', {
+          error: err.message,
+          sessionId: session.sessionId,
+        });
+        reject(err);
+      });
+
+      proc.on('exit', (code) => {
+        logger.info('Agent process exited:', { code, sessionId: session.sessionId });
+        session.process = undefined;
+
+        if (code === 0) {
+          this.broadcast('heteroAgentSessionComplete', { sessionId: session.sessionId });
+          resolve();
+        } else {
+          const stderrOutput = stderrChunks.join('').trim();
+          const errorMsg = stderrOutput || `Agent exited with code ${code}`;
+          this.broadcast('heteroAgentSessionError', {
+            error: errorMsg,
+            sessionId: session.sessionId,
+          });
+          reject(new Error(errorMsg));
+        }
+      });
+    });
+  }
+
+  /**
+   * Get session info (agent's internal session ID for multi-turn resume).
+   */
+  @IpcMethod()
+  async getSessionInfo(params: GetSessionInfoParams): Promise<SessionInfo> {
+    const session = this.sessions.get(params.sessionId);
+    return { agentSessionId: session?.agentSessionId };
+  }
+
+  /**
+   * Cancel an ongoing session.
+   */
+  @IpcMethod()
+  async cancelSession(params: CancelSessionParams): Promise<void> {
+    const session = this.sessions.get(params.sessionId);
+    if (session?.process) {
+      session.process.kill('SIGINT');
+    }
+  }
+
+  /**
+   * Stop and clean up a session.
+   */
+  @IpcMethod()
+  async stopSession(params: StopSessionParams): Promise<void> {
+    const session = this.sessions.get(params.sessionId);
+    if (!session) return;
+
+    if (session.process && !session.process.killed) {
+      session.process.kill('SIGTERM');
+      setTimeout(() => {
+        if (session.process && !session.process.killed) {
+          session.process.kill('SIGKILL');
+        }
+      }, 3000);
+    }
+
+    this.sessions.delete(params.sessionId);
+  }
+
+  @IpcMethod()
+  async respondPermission(): Promise<void> {
+    // No-op for CLI mode (permissions handled by --permission-mode flag)
+  }
+
+  /**
+   * Cleanup on app quit.
+   */
+  afterAppReady() {
+    electronApp.on('before-quit', () => {
+      for (const [, session] of this.sessions) {
+        if (session.process && !session.process.killed) {
+          session.process.kill('SIGTERM');
+        }
+      }
+      this.sessions.clear();
+    });
+  }
+}

apps/desktop/src/main/controllers/NotificationCtr.ts

@@ -178,6 +178,28 @@ export default class NotificationCtr extends ControllerModule {
     }
   }
 
+  /**
+   * Set the app-level badge count (dock red dot on macOS, Unity counter on Linux,
+   * overlay icon on Windows). Pass 0 to clear.
+   *
+   * On macOS we pair `app.setBadgeCount` with `app.dock.setBadge` — the former
+   * keeps Electron's internal count (cross-platform), the latter is the
+   * reliable Dock repaint trigger. Note: macOS Focus Mode / DND suppresses the
+   * badge visually until the user exits Focus.
+   */
+  @IpcMethod()
+  setBadgeCount(count: number): void {
+    try {
+      const next = Math.max(0, Math.floor(count));
+      app.setBadgeCount(next);
+      if (macOS() && app.dock) {
+        app.dock.setBadge(next > 0 ? String(next) : '');
+      }
+    } catch (error) {
+      logger.error('Failed to set badge count:', error);
+    }
+  }
+
   /**
    * Check if the main window is hidden
    */

apps/desktop/src/main/controllers/SystemCtr.ts

@@ -1,8 +1,18 @@
+import { execFile } from 'node:child_process';
 import { readFile } from 'node:fs/promises';
 import path from 'node:path';
 import process from 'node:process';
+import { promisify } from 'node:util';
 
-import type { ElectronAppState, ThemeMode } from '@lobechat/electron-client-ipc';
+import type {
+  ElectronAppState,
+  GitBranchInfo,
+  GitBranchListItem,
+  GitCheckoutResult,
+  GitLinkedPullRequestResult,
+  GitWorkingTreeStatus,
+  ThemeMode,
+} from '@lobechat/electron-client-ipc';
 import { app, dialog, nativeTheme, shell } from 'electron';
 import { macOS } from 'electron-is';
 import { pathExists, readdir } from 'fs-extra';
@@ -235,7 +245,8 @@ export default class SystemController extends ControllerModule {
     }
   }
 
-  private async detectRepoType(dirPath: string): Promise<'git' | 'github' | undefined> {
+  @IpcMethod()
+  async detectRepoType(dirPath: string): Promise<'git' | 'github' | undefined> {
     const gitConfigPath = path.join(dirPath, '.git', 'config');
     try {
       const config = await readFile(gitConfigPath, 'utf8');
@@ -246,6 +257,213 @@ export default class SystemController extends ControllerModule {
     }
   }
 
+  /**
+   * Read current git branch from `.git/HEAD`. Returns short sha on detached HEAD.
+   * Handles both standard `.git` directories and `.git` worktree pointer files.
+   */
+  @IpcMethod()
+  async getGitBranch(dirPath: string): Promise<GitBranchInfo> {
+    try {
+      const gitDir = await this.resolveGitDir(dirPath);
+      if (!gitDir) return {};
+
+      const head = (await readFile(path.join(gitDir, 'HEAD'), 'utf8')).trim();
+      const refMatch = /^ref:\s*refs\/heads\/(.+)$/.exec(head);
+      if (refMatch) {
+        return { branch: refMatch[1] };
+      }
+      // Detached HEAD — HEAD file contains the full sha
+      if (/^[\da-f]{40}$/i.test(head)) {
+        return { branch: head.slice(0, 7), detached: true };
+      }
+      return {};
+    } catch {
+      return {};
+    }
+  }
+
+  /**
+   * Query `gh` CLI for an open pull request whose head branch matches `branch`.
+   * Returns status = 'gh-missing' when `gh` is not installed / not authenticated,
+   * so the UI can render a helpful tooltip instead of an error.
+   */
+  @IpcMethod()
+  async getLinkedPullRequest(payload: {
+    branch: string;
+    path: string;
+  }): Promise<GitLinkedPullRequestResult> {
+    const { path: dirPath, branch } = payload;
+    if (!branch) {
+      return { pullRequest: null, status: 'ok' };
+    }
+
+    const execFileAsync = promisify(execFile);
+    try {
+      const { stdout } = await execFileAsync(
+        'gh',
+        [
+          'pr',
+          'list',
+          '--head',
+          branch,
+          '--state',
+          'open',
+          '--limit',
+          '5',
+          '--json',
+          'number,url,title,state',
+        ],
+        { cwd: dirPath, timeout: 8000 },
+      );
+      const parsed = JSON.parse(stdout.trim() || '[]') as Array<{
+        number: number;
+        state: string;
+        title: string;
+        url: string;
+      }>;
+      if (parsed.length === 0) {
+        return { pullRequest: null, status: 'ok' };
+      }
+      const [primary, ...rest] = parsed;
+      return {
+        extraCount: rest.length,
+        pullRequest: primary,
+        status: 'ok',
+      };
+    } catch (error: any) {
+      const code = error?.code;
+      const stderr: string = error?.stderr ?? '';
+      // `gh` binary not on PATH
+      if (code === 'ENOENT') {
+        return { pullRequest: null, status: 'gh-missing' };
+      }
+      // gh reports auth issues via stderr; treat as a soft-fail
+      if (/auth\s+login|not\s+logged\s+in|authentication/i.test(stderr)) {
+        return { pullRequest: null, status: 'gh-missing' };
+      }
+      logger.debug('[getLinkedPullRequest] failed', { branch, code, stderr });
+      return { pullRequest: null, status: 'error' };
+    }
+  }
+
+  /**
+   * List local git branches ordered by most recent commit.
+   * `current` is true for the checked-out branch.
+   */
+  @IpcMethod()
+  async listGitBranches(dirPath: string): Promise<GitBranchListItem[]> {
+    const execFileAsync = promisify(execFile);
+    try {
+      const { stdout } = await execFileAsync(
+        'git',
+        [
+          'for-each-ref',
+          '--sort=-committerdate',
+          '--format=%(HEAD)%09%(refname:short)%09%(upstream:short)',
+          'refs/heads',
+        ],
+        { cwd: dirPath, timeout: 5000 },
+      );
+      return stdout
+        .replaceAll('\r', '')
+        .split('\n')
+        .filter((line) => line.length > 0)
+        .map((line) => {
+          // Line format: "<HEAD-marker>\t<branch>\t<upstream>" where HEAD-marker is '*' or ' '
+          const [head, name, upstream] = line.split('\t');
+          return {
+            current: head === '*',
+            name: name ?? '',
+            upstream: upstream || undefined,
+          };
+        })
+        .filter((b) => b.name);
+    } catch (error: any) {
+      logger.warn('[listGitBranches] git command failed', {
+        code: error?.code,
+        cwd: dirPath,
+        message: error?.message,
+        stderr: error?.stderr?.toString?.() ?? error?.stderr,
+      });
+      return [];
+    }
+  }
+
+  /**
+   * Count unstaged / staged / untracked files via `git status --porcelain`.
+   */
+  @IpcMethod()
+  async getGitWorkingTreeStatus(dirPath: string): Promise<GitWorkingTreeStatus> {
+    const execFileAsync = promisify(execFile);
+    try {
+      const { stdout } = await execFileAsync('git', ['status', '--porcelain'], {
+        cwd: dirPath,
+        timeout: 5000,
+      });
+      const lines = stdout.split('\n').filter((line) => line.trim().length > 0);
+      return { clean: lines.length === 0, modified: lines.length };
+    } catch {
+      return { clean: true, modified: 0 };
+    }
+  }
+
+  /**
+   * Check out (or create + check out) a branch.
+   * Relies on git itself to reject unsafe checkouts (dirty tree, non-fast-forward, etc.)
+   * and surfaces git's stderr so the UI can display a meaningful error.
+   */
+  @IpcMethod()
+  async checkoutGitBranch(payload: {
+    branch: string;
+    create?: boolean;
+    path: string;
+  }): Promise<GitCheckoutResult> {
+    const { path: dirPath, branch, create } = payload;
+    if (!branch?.trim()) {
+      return { error: 'Branch name is required', success: false };
+    }
+    // Reject obviously invalid refs early to avoid a confusing git error
+    if (/[\s~^:?*[\\]/.test(branch) || branch.startsWith('-') || branch.includes('..')) {
+      return { error: `Invalid branch name: ${branch}`, success: false };
+    }
+
+    const execFileAsync = promisify(execFile);
+    const args = create ? ['checkout', '-b', branch] : ['checkout', branch];
+    try {
+      await execFileAsync('git', args, { cwd: dirPath, timeout: 10_000 });
+      return { success: true };
+    } catch (error: any) {
+      const stderr: string = (error?.stderr ?? error?.message ?? '').toString().trim();
+      logger.debug('[checkoutGitBranch] failed', { args, stderr });
+      return { error: stderr || 'git checkout failed', success: false };
+    }
+  }
+
+  /**
+   * Resolve the actual `.git` directory for a working tree.
+   * Supports both standard layouts and worktree pointer files (`.git` as a regular file).
+   */
+  private async resolveGitDir(dirPath: string): Promise<string | undefined> {
+    const gitPath = path.join(dirPath, '.git');
+    try {
+      const content = await readFile(gitPath, 'utf8');
+      const worktreeMatch = /^gitdir:\s*(\S.*)$/m.exec(content.trim());
+      if (worktreeMatch) {
+        const resolved = worktreeMatch[1].trim();
+        return path.isAbsolute(resolved) ? resolved : path.resolve(dirPath, resolved);
+      }
+    } catch {
+      // `.git` is a directory (EISDIR) or missing — fall through
+    }
+    try {
+      const stat = await readdir(gitPath);
+      if (stat.length > 0) return gitPath;
+    } catch {
+      return undefined;
+    }
+    return undefined;
+  }
+
   private async setSystemThemeMode(themeMode: ThemeMode) {
     nativeTheme.themeSource = themeMode;
   }

apps/desktop/src/main/controllers/ToolDetectorCtr.ts

@@ -1,8 +1,15 @@
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+
+import type { ClaudeAuthStatus } from '@lobechat/electron-client-ipc';
+
 import type { ToolCategory, ToolStatus } from '@/core/infrastructure/ToolDetectorManager';
 import { createLogger } from '@/utils/logger';
 
 import { ControllerModule, IpcMethod } from './index';
 
+const execPromise = promisify(exec);
+
 const logger = createLogger('controllers:ToolDetectorCtr');
 
 /**
@@ -112,4 +119,19 @@ export default class ToolDetectorCtr extends ControllerModule {
       priority: detector.priority,
     }));
   }
+
+  /**
+   * Get Claude Code CLI auth/account status by running `claude auth status --json`.
+   * Returns null if the CLI is unavailable or the command fails.
+   */
+  @IpcMethod()
+  async getClaudeAuthStatus(): Promise<ClaudeAuthStatus | null> {
+    try {
+      const { stdout } = await execPromise('claude auth status --json', { timeout: 5000 });
+      return JSON.parse(stdout.trim()) as ClaudeAuthStatus;
+    } catch (error) {
+      logger.debug('Failed to get claude auth status:', error);
+      return null;
+    }
+  }
 }

apps/desktop/src/main/controllers/__tests__/HeterogeneousAgentCtr.test.ts

@@ -0,0 +1,216 @@
+import { EventEmitter } from 'node:events';
+import { access, mkdtemp, readdir, readFile, rm, unlink, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { PassThrough } from 'node:stream';
+
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import HeterogeneousAgentCtr from '../HeterogeneousAgentCtr';
+
+const FAKE_DESKTOP_PATH = '/Users/fake/Desktop';
+
+vi.mock('electron', () => ({
+  BrowserWindow: { getAllWindows: () => [] },
+  app: {
+    getPath: vi.fn((name: string) => (name === 'desktop' ? FAKE_DESKTOP_PATH : `/fake/${name}`)),
+    on: vi.fn(),
+  },
+  ipcMain: { handle: vi.fn() },
+}));
+
+vi.mock('@/utils/logger', () => ({
+  createLogger: () => ({
+    debug: vi.fn(),
+    error: vi.fn(),
+    info: vi.fn(),
+    verbose: vi.fn(),
+    warn: vi.fn(),
+  }),
+}));
+
+// Captures the most recent spawn() call so sendPrompt tests can assert on argv.
+const spawnCalls: Array<{ args: string[]; command: string; options: any }> = [];
+let nextFakeProc: any = null;
+vi.mock('node:child_process', () => ({
+  spawn: (command: string, args: string[], options: any) => {
+    spawnCalls.push({ args, command, options });
+    return nextFakeProc;
+  },
+}));
+
+/**
+ * Build a fake ChildProcess that immediately exits cleanly. Records every
+ * stdin write on the returned `writes` array so tests can inspect the payload.
+ */
+const createFakeProc = () => {
+  const proc = new EventEmitter() as any;
+  const stdout = new PassThrough();
+  const stderr = new PassThrough();
+  const writes: string[] = [];
+  proc.stdout = stdout;
+  proc.stderr = stderr;
+  proc.stdin = {
+    end: vi.fn(),
+    write: vi.fn((chunk: string, cb?: () => void) => {
+      writes.push(chunk);
+      cb?.();
+      return true;
+    }),
+  };
+  proc.kill = vi.fn();
+  proc.killed = false;
+  // Exit asynchronously so the Promise returned by sendPrompt resolves cleanly.
+  setImmediate(() => {
+    stdout.end();
+    stderr.end();
+    proc.emit('exit', 0);
+  });
+  return { proc, writes };
+};
+
+describe('HeterogeneousAgentCtr', () => {
+  let appStoragePath: string;
+
+  beforeEach(async () => {
+    appStoragePath = await mkdtemp(path.join(tmpdir(), 'lobehub-hetero-'));
+  });
+
+  afterEach(async () => {
+    await rm(appStoragePath, { force: true, recursive: true });
+  });
+
+  describe('resolveImage', () => {
+    it('stores traversal-looking ids inside the cache root via a stable hash key', async () => {
+      const ctr = new HeterogeneousAgentCtr({ appStoragePath } as any);
+      const cacheDir = path.join(appStoragePath, 'heteroAgent/files');
+      const escapedTargetName = `${path.basename(appStoragePath)}-outside-storage`;
+      const escapePath = path.join(cacheDir, `../../../${escapedTargetName}`);
+
+      try {
+        await unlink(escapePath);
+      } catch {
+        // best-effort cleanup
+      }
+
+      await (ctr as any).resolveImage({
+        id: `../../../${escapedTargetName}`,
+        url: 'data:text/plain;base64,T1VUU0lERQ==',
+      });
+
+      const cacheEntries = await readdir(cacheDir);
+
+      expect(cacheEntries).toHaveLength(2);
+      expect(cacheEntries.every((entry) => /^[a-f0-9]{64}(?:\.meta)?$/.test(entry))).toBe(true);
+      await expect(access(escapePath)).rejects.toThrow();
+
+      try {
+        await unlink(escapePath);
+      } catch {
+        // best-effort cleanup
+      }
+    });
+
+    it('does not trust pre-seeded out-of-root traversal cache files as cache hits', async () => {
+      const ctr = new HeterogeneousAgentCtr({ appStoragePath } as any);
+      const cacheDir = path.join(appStoragePath, 'heteroAgent/files');
+      const traversalId = '../../preexisting-secret';
+      const outOfRootDataPath = path.join(cacheDir, traversalId);
+      const outOfRootMetaPath = path.join(cacheDir, `${traversalId}.meta`);
+
+      await writeFile(outOfRootDataPath, 'SECRET');
+      await writeFile(
+        outOfRootMetaPath,
+        JSON.stringify({ id: traversalId, mimeType: 'text/plain' }),
+      );
+
+      const result = await (ctr as any).resolveImage({
+        id: traversalId,
+        url: 'data:text/plain;base64,SUdOT1JFRA==',
+      });
+
+      expect(Buffer.from(result.buffer).toString('utf8')).toBe('IGNORED');
+      expect(result.mimeType).toBe('text/plain');
+      await expect(readFile(outOfRootDataPath, 'utf8')).resolves.toBe('SECRET');
+    });
+  });
+
+  describe('sendPrompt (claude-code)', () => {
+    beforeEach(() => {
+      spawnCalls.length = 0;
+    });
+
+    const runSendPrompt = async (prompt: string, sessionOverrides: Record<string, any> = {}) => {
+      const { proc, writes } = createFakeProc();
+      nextFakeProc = proc;
+
+      const ctr = new HeterogeneousAgentCtr({ appStoragePath } as any);
+      const { sessionId } = await ctr.startSession({
+        agentType: 'claude-code',
+        command: 'claude',
+        ...sessionOverrides,
+      });
+      await ctr.sendPrompt({ prompt, sessionId });
+
+      const { args: cliArgs, command, options } = spawnCalls[0];
+      return { cliArgs, command, options, writes };
+    };
+
+    it('passes prompt via stdin stream-json — never as a positional arg', async () => {
+      const prompt = '-- 这是破折号测试 --help';
+      const { cliArgs, writes } = await runSendPrompt(prompt);
+
+      // Prompt must never appear in argv (that is what previously broke CC's arg parser).
+      expect(cliArgs).not.toContain(prompt);
+
+      // Stream-json input must be wired up.
+      expect(cliArgs).toContain('--input-format');
+      expect(cliArgs).toContain('--output-format');
+      expect(cliArgs.filter((a) => a === 'stream-json')).toHaveLength(2);
+
+      // Exactly one stdin write, carrying the prompt as a user message JSON line.
+      expect(writes).toHaveLength(1);
+      const line = writes[0].trimEnd();
+      expect(line.endsWith('\n') || writes[0].endsWith('\n')).toBe(true);
+      const msg = JSON.parse(line);
+      expect(msg).toMatchObject({
+        message: {
+          content: [{ text: prompt, type: 'text' }],
+          role: 'user',
+        },
+        type: 'user',
+      });
+    });
+
+    it.each([
+      '-flag-looking-prompt',
+      '--help please',
+      '- dash at start',
+      '-p -- mixed',
+      'normal prompt with -dash- inside',
+    ])('accepts dash-containing prompt without leaking to argv: %s', async (prompt) => {
+      const { cliArgs, writes } = await runSendPrompt(prompt);
+
+      expect(cliArgs).not.toContain(prompt);
+      expect(writes).toHaveLength(1);
+      const msg = JSON.parse(writes[0].trimEnd());
+      expect(msg.message.content[0].text).toBe(prompt);
+    });
+
+    it('falls back to the user Desktop when no cwd is supplied', async () => {
+      const { options } = await runSendPrompt('hello');
+
+      // When launched from Finder the Electron parent cwd is `/` — the
+      // controller must override that with the user's Desktop so CC writes
+      // land somewhere sensible.
+      expect(options.cwd).toBe(FAKE_DESKTOP_PATH);
+    });
+
+    it('respects an explicit cwd passed to startSession', async () => {
+      const explicitCwd = '/Users/fake/projects/my-repo';
+      const { options } = await runSendPrompt('hello', { cwd: explicitCwd });
+
+      expect(options.cwd).toBe(explicitCwd);
+    });
+  });
+});

apps/desktop/src/main/controllers/index.ts

@@ -1,6 +1,7 @@
+import type { DesktopHotkeyId } from '@lobechat/types';
+
 import type { App } from '@/core/App';
 import { IoCContainer } from '@/core/infrastructure/IoCContainer';
-import type { ShortcutActionType } from '@/shortcuts';
 import { IpcService } from '@/utils/ipc';
 
 const shortcutDecorator = (name: string) => (target: any, methodName: string, descriptor?: any) => {
@@ -15,7 +16,7 @@ const shortcutDecorator = (name: string) => (target: any, methodName: string, de
 /**
  *  shortcut inject decorator
  */
-export const shortcut = (method: ShortcutActionType) => shortcutDecorator(method);
+export const shortcut = (method: DesktopHotkeyId) => shortcutDecorator(method);
 
 const protocolDecorator =
   (urlType: string, action: string) => (target: any, methodName: string, descriptor?: any) => {

apps/desktop/src/main/controllers/registry.ts

@@ -5,6 +5,7 @@ import BrowserWindowsCtr from './BrowserWindowsCtr';
 import CliCtr from './CliCtr';
 import DevtoolsCtr from './DevtoolsCtr';
 import GatewayConnectionCtr from './GatewayConnectionCtr';
+import HeterogeneousAgentCtr from './HeterogeneousAgentCtr';
 import LocalFileCtr from './LocalFileCtr';
 import McpCtr from './McpCtr';
 import McpInstallCtr from './McpInstallCtr';
@@ -22,6 +23,7 @@ import UpdaterCtr from './UpdaterCtr';
 import UploadFileCtr from './UploadFileCtr';
 
 export const controllerIpcConstructors = [
+  HeterogeneousAgentCtr,
   AuthCtr,
   BrowserWindowsCtr,
   CliCtr,

apps/desktop/src/main/core/App.ts

@@ -17,6 +17,7 @@ import { generateCliWrapper, getCliWrapperDir } from '@/modules/cliEmbedding';
 import {
   astSearchDetectors,
   browserAutomationDetectors,
+  cliAgentDetectors,
   contentSearchDetectors,
   fileSearchDetectors,
   type IToolDetector,
@@ -190,6 +191,7 @@ export class App {
 
     const detectorCategories: Partial<Record<ToolCategory, IToolDetector[]>> = {
       'runtime-environment': runtimeEnvironmentDetectors,
+      'cli-agents': cliAgentDetectors,
       'ast-search': astSearchDetectors,
       'browser-automation': browserAutomationDetectors,
       'content-search': contentSearchDetectors,

apps/desktop/src/main/core/browser/Browser.ts

@@ -4,7 +4,7 @@ import { join } from 'node:path';
 import { APP_WINDOW_MIN_SIZE } from '@lobechat/desktop-bridge';
 import type { MainBroadcastEventKey, MainBroadcastParams } from '@lobechat/electron-client-ipc';
 import type { BrowserWindowConstructorOptions } from 'electron';
-import { BrowserWindow, ipcMain, screen, session as electronSession, shell } from 'electron';
+import { app, BrowserWindow, ipcMain, screen, session as electronSession, shell } from 'electron';
 
 import { preloadDir, resourcesDir } from '@/const/dir';
 import { isMac } from '@/const/env';
@@ -259,6 +259,13 @@ export default class Browser {
     browserWindow.on('focus', () => {
       logger.debug(`[${this.identifier}] Window 'focus' event fired.`);
       this.broadcast('windowFocused');
+      // Clear any completion badge once the user returns to the app.
+      try {
+        app.setBadgeCount(0);
+        if (process.platform === 'darwin' && app.dock) app.dock.setBadge('');
+      } catch {
+        /* noop — some platforms may not support badge counts */
+      }
     });
   }
 

apps/desktop/src/main/core/browser/BrowserManager.ts

@@ -1,4 +1,8 @@
-import type { MainBroadcastEventKey, MainBroadcastParams } from '@lobechat/electron-client-ipc';
+import type {
+  MainBroadcastEventKey,
+  MainBroadcastParams,
+  TopicPopupInfo,
+} from '@lobechat/electron-client-ipc';
 import type { WebContents } from 'electron';
 
 import { isLinux } from '@/const/env';
@@ -11,6 +15,9 @@ import type { App } from '../App';
 import type { BrowserWindowOpts } from './Browser';
 import Browser from './Browser';
 
+const TOPIC_POPUP_TEMPLATE_ID: WindowTemplateIdentifiers = 'topicPopup';
+const TOPIC_POPUP_PATH_RE = /^\/popup\/(agent|group)\/([^/?#]+)\/([^/?#]+)/;
+
 // Create logger
 const logger = createLogger('core:BrowserManager');
 
@@ -145,12 +152,62 @@ export class BrowserManager {
 
     const browser = this.retrieveOrInitialize(browserOpts);
 
+    if (templateId === TOPIC_POPUP_TEMPLATE_ID) {
+      // Notify main-window SPAs so they can redirect to the popup instead of
+      // rendering the same conversation in two places. Re-emit on close to
+      // release the "topic is in popup" guard.
+      this.emitTopicPopupsChanged();
+      browser.browserWindow.once('closed', () => {
+        this.emitTopicPopupsChanged();
+      });
+    }
+
     return {
       browser,
       identifier: windowId,
     };
   }
 
+  /**
+   * List currently-open topic popup windows (alive only). Used by the main
+   * SPA to decide whether to render the conversation or a redirect-to-popup
+   * guard.
+   */
+  listTopicPopups(): TopicPopupInfo[] {
+    const popups: TopicPopupInfo[] = [];
+    this.browsers.forEach((browser, identifier) => {
+      if (!identifier.startsWith(`${TOPIC_POPUP_TEMPLATE_ID}_`)) return;
+      const webContents = browser.webContents;
+      if (!webContents || webContents.isDestroyed()) return;
+      const match = browser.options.path.match(TOPIC_POPUP_PATH_RE);
+      if (!match) return;
+      const scope = match[1] as 'agent' | 'group';
+      const id = match[2];
+      const topicId = match[3];
+      popups.push({
+        identifier,
+        scope,
+        topicId,
+        ...(scope === 'agent' ? { agentId: id } : { groupId: id }),
+      });
+    });
+    return popups;
+  }
+
+  focusTopicPopup(identifier: string): boolean {
+    const browser = this.browsers.get(identifier);
+    if (!browser) return false;
+    const win = browser.browserWindow;
+    if (win.isMinimized()) win.restore();
+    win.show();
+    win.focus();
+    return true;
+  }
+
+  private emitTopicPopupsChanged(): void {
+    this.broadcastToAllWindows('topicPopupsChanged', { popups: this.listTopicPopups() });
+  }
+
   /**
    * Get all windows based on template
    * @param templateId Template identifier
@@ -278,6 +335,16 @@ export class BrowserManager {
     browser?.setWindowMinimumSize(size);
   }
 
+  setWindowAlwaysOnTop(identifier: string, flag: boolean) {
+    const browser = this.browsers.get(identifier);
+    browser?.browserWindow.setAlwaysOnTop(flag);
+  }
+
+  isWindowAlwaysOnTop(identifier: string) {
+    const browser = this.browsers.get(identifier);
+    return browser?.browserWindow.isAlwaysOnTop() ?? false;
+  }
+
   getIdentifierByWebContents(webContents: WebContents): string | null {
     return this.webContentsMap.get(webContents) || null;
   }

apps/desktop/src/main/core/browser/__tests__/Browser.test.ts

@@ -4,76 +4,89 @@ import { type App as AppCore } from '../../App';
 import Browser, { type BrowserWindowOpts } from '../Browser';
 
 // Use vi.hoisted to define mocks before hoisting
-const { mockBrowserWindow, mockNativeTheme, mockIpcMain, mockScreen, MockBrowserWindow } =
-  vi.hoisted(() => {
-    const mockBrowserWindow = {
-      center: vi.fn(),
-      close: vi.fn(),
-      focus: vi.fn(),
-      getBounds: vi.fn().mockReturnValue({ height: 600, width: 800, x: 0, y: 0 }),
-      getContentBounds: vi.fn().mockReturnValue({ height: 600, width: 800 }),
-      hide: vi.fn(),
-      isDestroyed: vi.fn().mockReturnValue(false),
-      isFocused: vi.fn().mockReturnValue(true),
-      isFullScreen: vi.fn().mockReturnValue(false),
-      isMaximized: vi.fn().mockReturnValue(false),
-      isVisible: vi.fn().mockReturnValue(true),
-      loadFile: vi.fn().mockResolvedValue(undefined),
-      loadURL: vi.fn().mockResolvedValue(undefined),
-      maximize: vi.fn(),
-      minimize: vi.fn(),
-      on: vi.fn(),
-      once: vi.fn(),
-      setBackgroundColor: vi.fn(),
-      setBounds: vi.fn(),
-      setFullScreen: vi.fn(),
-      setPosition: vi.fn(),
-      setTitleBarOverlay: vi.fn(),
-      show: vi.fn(),
-      unmaximize: vi.fn(),
-      webContents: {
-        openDevTools: vi.fn(),
-        send: vi.fn(),
-        session: {
-          webRequest: {
-            onBeforeSendHeaders: vi.fn(),
-            onHeadersReceived: vi.fn(),
-          },
+const {
+  mockElectronApp,
+  mockBrowserWindow,
+  mockNativeTheme,
+  mockIpcMain,
+  mockScreen,
+  MockBrowserWindow,
+} = vi.hoisted(() => {
+  const mockBrowserWindow = {
+    center: vi.fn(),
+    close: vi.fn(),
+    focus: vi.fn(),
+    getBounds: vi.fn().mockReturnValue({ height: 600, width: 800, x: 0, y: 0 }),
+    getContentBounds: vi.fn().mockReturnValue({ height: 600, width: 800 }),
+    hide: vi.fn(),
+    isDestroyed: vi.fn().mockReturnValue(false),
+    isFocused: vi.fn().mockReturnValue(true),
+    isFullScreen: vi.fn().mockReturnValue(false),
+    isMaximized: vi.fn().mockReturnValue(false),
+    isVisible: vi.fn().mockReturnValue(true),
+    loadFile: vi.fn().mockResolvedValue(undefined),
+    loadURL: vi.fn().mockResolvedValue(undefined),
+    maximize: vi.fn(),
+    minimize: vi.fn(),
+    on: vi.fn(),
+    once: vi.fn(),
+    setBackgroundColor: vi.fn(),
+    setBounds: vi.fn(),
+    setFullScreen: vi.fn(),
+    setPosition: vi.fn(),
+    setTitleBarOverlay: vi.fn(),
+    show: vi.fn(),
+    unmaximize: vi.fn(),
+    webContents: {
+      openDevTools: vi.fn(),
+      send: vi.fn(),
+      session: {
+        webRequest: {
+          onBeforeSendHeaders: vi.fn(),
+          onHeadersReceived: vi.fn(),
         },
-        on: vi.fn(),
-        setWindowOpenHandler: vi.fn(),
       },
-    };
+      on: vi.fn(),
+      setWindowOpenHandler: vi.fn(),
+    },
+  };
 
-    return {
-      MockBrowserWindow: vi.fn().mockImplementation(() => mockBrowserWindow),
-      mockBrowserWindow,
-      mockIpcMain: {
-        handle: vi.fn(),
-        removeHandler: vi.fn(),
-      },
-      mockNativeTheme: {
-        off: vi.fn(),
-        on: vi.fn(),
-        shouldUseDarkColors: false,
-        themeSource: 'system',
-      },
-      mockScreen: {
-        getDisplayMatching: vi.fn().mockReturnValue({
-          workArea: { height: 1080, width: 1920, x: 0, y: 0 },
-        }),
-        getDisplayNearestPoint: vi.fn().mockReturnValue({
-          workArea: { height: 1080, width: 1920, x: 0, y: 0 },
-        }),
-        getPrimaryDisplay: vi.fn().mockReturnValue({
-          workArea: { height: 1080, width: 1920, x: 0, y: 0 },
-        }),
-      },
-    };
-  });
+  const mockElectronApp = {
+    dock: { setBadge: vi.fn() },
+    setBadgeCount: vi.fn(),
+  };
+
+  return {
+    MockBrowserWindow: vi.fn().mockImplementation(() => mockBrowserWindow),
+    mockElectronApp,
+    mockBrowserWindow,
+    mockIpcMain: {
+      handle: vi.fn(),
+      removeHandler: vi.fn(),
+    },
+    mockNativeTheme: {
+      off: vi.fn(),
+      on: vi.fn(),
+      shouldUseDarkColors: false,
+      themeSource: 'system',
+    },
+    mockScreen: {
+      getDisplayMatching: vi.fn().mockReturnValue({
+        workArea: { height: 1080, width: 1920, x: 0, y: 0 },
+      }),
+      getDisplayNearestPoint: vi.fn().mockReturnValue({
+        workArea: { height: 1080, width: 1920, x: 0, y: 0 },
+      }),
+      getPrimaryDisplay: vi.fn().mockReturnValue({
+        workArea: { height: 1080, width: 1920, x: 0, y: 0 },
+      }),
+    },
+  };
+});
 
 // Mock electron
 vi.mock('electron', () => ({
+  app: mockElectronApp,
   BrowserWindow: MockBrowserWindow,
   ipcMain: mockIpcMain,
   nativeTheme: mockNativeTheme,

apps/desktop/src/main/core/infrastructure/RendererUrlManager.ts

@@ -12,8 +12,9 @@ import { RendererProtocolManager } from './RendererProtocolManager';
 const logger = createLogger('core:RendererUrlManager');
 
 // Vite build with root=monorepo preserves input path structure,
-// so index.html ends up at apps/desktop/index.html in outDir.
+// so index.html / popup.html end up under apps/desktop/ in outDir.
 const SPA_ENTRY_HTML = join(rendererDir, 'apps', 'desktop', 'index.html');
+const POPUP_ENTRY_HTML = join(rendererDir, 'apps', 'desktop', 'popup.html');
 
 export class RendererUrlManager {
   private readonly rendererProtocolManager: RendererProtocolManager;
@@ -66,7 +67,8 @@ export class RendererUrlManager {
 
   /**
    * Resolve renderer file path in production.
-   * Static assets map directly; all routes fall back to index.html (SPA).
+   * Static assets map directly; popup routes go to popup.html, all other
+   * routes fall back to index.html (SPA).
    */
   resolveRendererFilePath = async (url: URL): Promise<string | null> => {
     const pathname = url.pathname;
@@ -77,7 +79,12 @@ export class RendererUrlManager {
       return pathExistsSync(filePath) ? filePath : null;
     }
 
-    // All routes fallback to index.html (SPA)
+    // Topic popup window has its own SPA bundle.
+    if (pathname === '/popup' || pathname.startsWith('/popup/')) {
+      return POPUP_ENTRY_HTML;
+    }
+
+    // All other routes fallback to index.html (SPA)
     return SPA_ENTRY_HTML;
   };
 

apps/desktop/src/main/core/infrastructure/ToolDetectorManager.ts

@@ -41,6 +41,7 @@ export type ToolCategory =
   | 'file-search'
   | 'browser-automation'
   | 'runtime-environment'
+  | 'cli-agents'
   | 'system'
   | 'custom';
 

apps/desktop/src/main/core/ui/ShortcutManager.ts

@@ -1,6 +1,6 @@
+import { DEFAULT_ELECTRON_DESKTOP_SHORTCUTS } from '@lobechat/const/desktopGlobalShortcuts';
 import { globalShortcut } from 'electron';
 
-import { DEFAULT_SHORTCUTS_CONFIG } from '@/shortcuts';
 import { createLogger } from '@/utils/logger';
 
 import type { App } from '../App';
@@ -77,8 +77,8 @@ export class ShortcutManager {
     try {
       logger.debug(`Updating shortcut ${id} to ${accelerator}`);
 
-      // 1. Check if ID is valid
-      if (!DEFAULT_SHORTCUTS_CONFIG[id]) {
+      // 1. Check if ID is valid (value may be empty string when disabled by default)
+      if (!(id in DEFAULT_ELECTRON_DESKTOP_SHORTCUTS)) {
         logger.error(`Invalid shortcut ID: ${id}`);
         return { errorType: 'INVALID_ID', success: false };
       }
@@ -231,15 +231,15 @@ export class ShortcutManager {
       // If no configuration, use default configuration
       if (!config || Object.keys(config).length === 0) {
         logger.debug('No shortcuts config found, using defaults');
-        this.shortcutsConfig = { ...DEFAULT_SHORTCUTS_CONFIG };
+        this.shortcutsConfig = { ...DEFAULT_ELECTRON_DESKTOP_SHORTCUTS };
         this.saveShortcutsConfig();
       } else {
-        // Filter out invalid shortcuts that are not in DEFAULT_SHORTCUTS_CONFIG
+        // Filter out invalid shortcuts that are not in DEFAULT_ELECTRON_DESKTOP_SHORTCUTS
         const filteredConfig: Record<string, string> = {};
         let hasInvalidKeys = false;
 
         Object.entries(config).forEach(([id, accelerator]) => {
-          if (DEFAULT_SHORTCUTS_CONFIG[id]) {
+          if (id in DEFAULT_ELECTRON_DESKTOP_SHORTCUTS) {
             filteredConfig[id] = accelerator;
           } else {
             hasInvalidKeys = true;
@@ -248,7 +248,7 @@ export class ShortcutManager {
         });
 
         // Ensure all default shortcuts are present
-        Object.entries(DEFAULT_SHORTCUTS_CONFIG).forEach(([id, defaultAccelerator]) => {
+        Object.entries(DEFAULT_ELECTRON_DESKTOP_SHORTCUTS).forEach(([id, defaultAccelerator]) => {
           if (!(id in filteredConfig)) {
             filteredConfig[id] = defaultAccelerator;
             logger.debug(`Adding missing default shortcut: ${id} = ${defaultAccelerator}`);
@@ -267,7 +267,7 @@ export class ShortcutManager {
       logger.debug('Loaded shortcuts config:', this.shortcutsConfig);
     } catch (error) {
       logger.error('Error loading shortcuts config:', error);
-      this.shortcutsConfig = { ...DEFAULT_SHORTCUTS_CONFIG };
+      this.shortcutsConfig = { ...DEFAULT_ELECTRON_DESKTOP_SHORTCUTS };
       this.saveShortcutsConfig();
     }
   }
@@ -295,9 +295,9 @@ export class ShortcutManager {
     Object.entries(this.shortcutsConfig).forEach(([id, accelerator]) => {
       logger.debug(`Registering shortcut '${id}' with ${accelerator}`);
 
-      // Only register shortcuts that exist in DEFAULT_SHORTCUTS_CONFIG
-      if (!DEFAULT_SHORTCUTS_CONFIG[id]) {
-        logger.debug(`Skipping shortcut '${id}' - not found in DEFAULT_SHORTCUTS_CONFIG`);
+      // Only register shortcuts that exist in DEFAULT_ELECTRON_DESKTOP_SHORTCUTS
+      if (!(id in DEFAULT_ELECTRON_DESKTOP_SHORTCUTS)) {
+        logger.debug(`Skipping shortcut '${id}' - not found in DEFAULT_ELECTRON_DESKTOP_SHORTCUTS`);
         return;
       }
 

apps/desktop/src/main/core/ui/__tests__/ShortcutManager.test.ts

@@ -1,8 +1,7 @@
+import { DEFAULT_ELECTRON_DESKTOP_SHORTCUTS } from '@lobechat/const/desktopGlobalShortcuts';
 import { globalShortcut } from 'electron';
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 
-import { DEFAULT_SHORTCUTS_CONFIG } from '@/shortcuts';
-
 import type { App } from '../../App';
 import { ShortcutManager } from '../ShortcutManager';
 
@@ -26,10 +25,10 @@ vi.mock('@/utils/logger', () => ({
   }),
 }));
 
-// Mock DEFAULT_SHORTCUTS_CONFIG
-vi.mock('@/shortcuts', () => ({
-  DEFAULT_SHORTCUTS_CONFIG: {
-    showApp: 'Control+E',
+// Mock desktop global shortcut defaults
+vi.mock('@lobechat/const/desktopGlobalShortcuts', () => ({
+  DEFAULT_ELECTRON_DESKTOP_SHORTCUTS: {
+    showApp: '',
     openSettings: 'CommandOrControl+,',
   },
 }));
@@ -115,7 +114,7 @@ describe('ShortcutManager', () => {
 
       expect(mockStoreManager.get).toHaveBeenCalledWith('shortcuts');
       expect(globalShortcut.unregisterAll).toHaveBeenCalled();
-      expect(globalShortcut.register).toHaveBeenCalledWith('Control+E', expect.any(Function));
+      expect(globalShortcut.register).not.toHaveBeenCalledWith('Control+E', expect.any(Function));
       expect(globalShortcut.register).toHaveBeenCalledWith(
         'CommandOrControl+,',
         expect.any(Function),
@@ -145,7 +144,7 @@ describe('ShortcutManager', () => {
       shortcutManager.initialize();
 
       const config = shortcutManager.getShortcutsConfig();
-      expect(config).toEqual(DEFAULT_SHORTCUTS_CONFIG);
+      expect(config).toEqual(DEFAULT_ELECTRON_DESKTOP_SHORTCUTS);
     });
   });
 
@@ -346,8 +345,11 @@ describe('ShortcutManager', () => {
 
       shortcutManager['loadShortcutsConfig']();
 
-      expect(shortcutManager['shortcutsConfig']).toEqual(DEFAULT_SHORTCUTS_CONFIG);
-      expect(mockStoreManager.set).toHaveBeenCalledWith('shortcuts', DEFAULT_SHORTCUTS_CONFIG);
+      expect(shortcutManager['shortcutsConfig']).toEqual(DEFAULT_ELECTRON_DESKTOP_SHORTCUTS);
+      expect(mockStoreManager.set).toHaveBeenCalledWith(
+        'shortcuts',
+        DEFAULT_ELECTRON_DESKTOP_SHORTCUTS,
+      );
     });
 
     it('should use defaults when config is empty', () => {
@@ -355,7 +357,7 @@ describe('ShortcutManager', () => {
 
       shortcutManager['loadShortcutsConfig']();
 
-      expect(shortcutManager['shortcutsConfig']).toEqual(DEFAULT_SHORTCUTS_CONFIG);
+      expect(shortcutManager['shortcutsConfig']).toEqual(DEFAULT_ELECTRON_DESKTOP_SHORTCUTS);
     });
 
     it('should filter invalid keys from stored config', () => {
@@ -413,8 +415,11 @@ describe('ShortcutManager', () => {
 
       shortcutManager['loadShortcutsConfig']();
 
-      expect(shortcutManager['shortcutsConfig']).toEqual(DEFAULT_SHORTCUTS_CONFIG);
-      expect(mockStoreManager.set).toHaveBeenCalledWith('shortcuts', DEFAULT_SHORTCUTS_CONFIG);
+      expect(shortcutManager['shortcutsConfig']).toEqual(DEFAULT_ELECTRON_DESKTOP_SHORTCUTS);
+      expect(mockStoreManager.set).toHaveBeenCalledWith(
+        'shortcuts',
+        DEFAULT_ELECTRON_DESKTOP_SHORTCUTS,
+      );
     });
   });
 
@@ -458,7 +463,7 @@ describe('ShortcutManager', () => {
       expect(globalShortcut.register).toHaveBeenCalledWith('Ctrl+P', expect.any(Function));
     });
 
-    it('should skip shortcuts not in DEFAULT_SHORTCUTS_CONFIG', () => {
+    it('should skip shortcuts not defined in default electron desktop shortcuts', () => {
       shortcutManager['shortcutsConfig'] = {
         showApp: 'Alt+E',
         invalidKey: 'Ctrl+I',

apps/desktop/src/main/libs/acp/client.ts

@@ -0,0 +1,435 @@
+import type { ChildProcess } from 'node:child_process';
+import { spawn } from 'node:child_process';
+import type { Readable } from 'node:stream';
+
+import { createLogger } from '@/utils/logger';
+
+import type {
+  ACPInitializeParams,
+  ACPPermissionRequest,
+  ACPPermissionResponse,
+  ACPServerCapabilities,
+  ACPSessionCancelParams,
+  ACPSessionInfo,
+  ACPSessionNewParams,
+  ACPSessionPromptParams,
+  ACPSessionUpdate,
+  FSReadTextFileParams,
+  FSReadTextFileResult,
+  FSWriteTextFileParams,
+  JsonRpcError,
+  JsonRpcNotification,
+  JsonRpcRequest,
+  JsonRpcResponse,
+  TerminalCreateParams,
+  TerminalCreateResult,
+  TerminalKillParams,
+  TerminalOutputParams,
+  TerminalOutputResult,
+  TerminalReleaseParams,
+  TerminalWaitForExitParams,
+  TerminalWaitForExitResult,
+} from './types';
+
+const logger = createLogger('libs:acp:client');
+
+type PendingRequest = {
+  reject: (error: Error) => void;
+  resolve: (result: unknown) => void;
+};
+
+export interface ACPClientParams {
+  args?: string[];
+  command: string;
+  cwd?: string;
+  env?: Record<string, string>;
+}
+
+export interface ACPClientCallbacks {
+  onPermissionRequest?: (request: ACPPermissionRequest) => Promise<ACPPermissionResponse>;
+  onSessionComplete?: (sessionId: string) => void;
+  onSessionUpdate?: (update: ACPSessionUpdate) => void;
+}
+
+/**
+ * ACP Client that communicates with an ACP agent (e.g. Claude Code) over stdio JSON-RPC 2.0.
+ *
+ * Bidirectional: sends requests to agent AND handles incoming requests from agent
+ * (fs/read_text_file, fs/write_text_file, terminal/*, session/request_permission).
+ */
+export class ACPClient {
+  private buffer = '';
+  private callbacks: ACPClientCallbacks = {};
+  private nextId = 1;
+  private pendingRequests = new Map<number | string, PendingRequest>();
+  private process: ChildProcess | null = null;
+  private stderrLogs: string[] = [];
+
+  // Client-side method handlers (agent calls these)
+  private clientMethodHandlers = new Map<string, (params: any) => Promise<unknown>>();
+
+  constructor(private readonly params: ACPClientParams) {}
+
+  /**
+   * Register handlers for client-side methods that the agent can call back.
+   */
+  registerClientMethods(handlers: {
+    'fs/read_text_file'?: (params: FSReadTextFileParams) => Promise<FSReadTextFileResult>;
+    'fs/write_text_file'?: (params: FSWriteTextFileParams) => Promise<void>;
+    'terminal/create'?: (params: TerminalCreateParams) => Promise<TerminalCreateResult>;
+    'terminal/kill'?: (params: TerminalKillParams) => Promise<void>;
+    'terminal/output'?: (params: TerminalOutputParams) => Promise<TerminalOutputResult>;
+    'terminal/release'?: (params: TerminalReleaseParams) => Promise<void>;
+    'terminal/wait_for_exit'?: (
+      params: TerminalWaitForExitParams,
+    ) => Promise<TerminalWaitForExitResult>;
+  }) {
+    for (const [method, handler] of Object.entries(handlers)) {
+      if (handler) {
+        this.clientMethodHandlers.set(method, handler);
+      }
+    }
+  }
+
+  setCallbacks(callbacks: ACPClientCallbacks) {
+    this.callbacks = callbacks;
+  }
+
+  /**
+   * Spawn the agent process and initialize the ACP connection.
+   */
+  async connect(): Promise<ACPServerCapabilities> {
+    const { command, args = [], env, cwd } = this.params;
+
+    this.process = spawn(command, args, {
+      cwd,
+      env: { ...process.env, ...env },
+      stdio: ['pipe', 'pipe', 'pipe'],
+    });
+
+    // Capture stderr
+    const stderr = this.process.stderr as Readable | null;
+    if (stderr) {
+      stderr.on('data', (chunk: Buffer) => {
+        const lines = chunk
+          .toString('utf8')
+          .split('\n')
+          .filter((l) => l.trim());
+        this.stderrLogs.push(...lines);
+      });
+    }
+
+    // Listen for stdout (JSON-RPC messages)
+    const stdout = this.process.stdout as Readable | null;
+    if (stdout) {
+      stdout.on('data', (chunk: Buffer) => {
+        this.handleData(chunk.toString('utf8'));
+      });
+    }
+
+    this.process.on('error', (err) => {
+      logger.error('ACP process error:', err);
+    });
+
+    this.process.on('exit', (code, signal) => {
+      logger.info('ACP process exited:', { code, signal });
+      // Reject all pending requests
+      for (const [id, pending] of this.pendingRequests) {
+        pending.reject(new Error(`ACP process exited (code=${code}, signal=${signal})`));
+        this.pendingRequests.delete(id);
+      }
+    });
+
+    // Initialize
+    const capabilities = await this.initialize();
+    return capabilities;
+  }
+
+  /**
+   * Send initialize request to the agent.
+   */
+  private async initialize(): Promise<ACPServerCapabilities> {
+    const params: ACPInitializeParams = {
+      capabilities: {
+        fs: { readTextFile: true, writeTextFile: true },
+        terminal: true,
+      },
+      clientInfo: { name: 'lobehub-desktop', version: '1.0.0' },
+      protocolVersion: '0.1',
+    };
+
+    return this.sendRequest<ACPServerCapabilities>('initialize', params);
+  }
+
+  /**
+   * Create a new session.
+   */
+  async createSession(params?: ACPSessionNewParams): Promise<ACPSessionInfo> {
+    return this.sendRequest<ACPSessionInfo>('session/new', params);
+  }
+
+  /**
+   * Send a prompt to an existing session.
+   */
+  async sendPrompt(params: ACPSessionPromptParams): Promise<void> {
+    return this.sendRequest<void>('session/prompt', params);
+  }
+
+  /**
+   * Cancel an ongoing session operation.
+   */
+  async cancelSession(params: ACPSessionCancelParams): Promise<void> {
+    return this.sendRequest<void>('session/cancel', params);
+  }
+
+  /**
+   * Respond to a permission request from the agent.
+   */
+  respondToPermission(requestId: string, response: ACPPermissionResponse): void {
+    this.sendResponse(requestId, response);
+  }
+
+  /**
+   * Disconnect from the agent and kill the process.
+   */
+  async disconnect(): Promise<void> {
+    if (this.process) {
+      this.process.stdin?.end();
+      this.process.kill('SIGTERM');
+
+      // Force kill after timeout
+      await new Promise<void>((resolve) => {
+        const timeout = setTimeout(() => {
+          if (this.process && !this.process.killed) {
+            this.process.kill('SIGKILL');
+          }
+          resolve();
+        }, 5000);
+
+        this.process?.on('exit', () => {
+          clearTimeout(timeout);
+          resolve();
+        });
+      });
+
+      this.process = null;
+    }
+  }
+
+  getStderrLogs(): string[] {
+    return this.stderrLogs;
+  }
+
+  // ============================================================
+  // JSON-RPC transport layer
+  // ============================================================
+
+  private sendRequest<T>(method: string, params?: object): Promise<T> {
+    return new Promise((resolve, reject) => {
+      const id = this.nextId++;
+      const request: JsonRpcRequest = {
+        id,
+        jsonrpc: '2.0',
+        method,
+        params,
+      };
+
+      this.pendingRequests.set(id, {
+        reject,
+        resolve: resolve as (result: unknown) => void,
+      });
+
+      this.writeMessage(request);
+    });
+  }
+
+  private sendResponse(id: number | string, result: unknown): void {
+    const response: JsonRpcResponse = {
+      id,
+      jsonrpc: '2.0',
+      result,
+    };
+    this.writeMessage(response);
+  }
+
+  private sendErrorResponse(id: number | string, error: JsonRpcError): void {
+    const response: JsonRpcResponse = {
+      error,
+      id,
+      jsonrpc: '2.0',
+    };
+    this.writeMessage(response);
+  }
+
+  private writeMessage(message: JsonRpcRequest | JsonRpcResponse | JsonRpcNotification): void {
+    if (!this.process?.stdin?.writable) {
+      logger.error('Cannot write to ACP process: stdin not writable');
+      return;
+    }
+
+    const json = JSON.stringify(message);
+    const content = `Content-Length: ${Buffer.byteLength(json)}\r\n\r\n${json}`;
+    this.process.stdin.write(content);
+  }
+
+  /**
+   * Handle incoming data from stdout, parsing JSON-RPC messages.
+   * Uses Content-Length header framing (LSP-style).
+   */
+  private handleData(data: string): void {
+    this.buffer += data;
+
+    while (true) {
+      // Try to parse a complete message from the buffer
+      const headerEnd = this.buffer.indexOf('\r\n\r\n');
+      if (headerEnd === -1) break;
+
+      const header = this.buffer.slice(0, headerEnd);
+      const contentLengthMatch = header.match(/Content-Length:\s*(\d+)/i);
+
+      if (!contentLengthMatch) {
+        // Try parsing as raw JSON (some agents don't use Content-Length headers)
+        const newlineIdx = this.buffer.indexOf('\n');
+        if (newlineIdx === -1) break;
+
+        const line = this.buffer.slice(0, newlineIdx).trim();
+        this.buffer = this.buffer.slice(newlineIdx + 1);
+
+        if (line) {
+          try {
+            const message = JSON.parse(line);
+            this.handleMessage(message);
+          } catch {
+            // Not valid JSON, skip
+          }
+        }
+        continue;
+      }
+
+      const contentLength = Number.parseInt(contentLengthMatch[1], 10);
+      const messageStart = headerEnd + 4; // after \r\n\r\n
+      const messageEnd = messageStart + contentLength;
+
+      if (Buffer.byteLength(this.buffer.slice(messageStart)) < contentLength) {
+        // Not enough data yet
+        break;
+      }
+
+      const messageStr = this.buffer.slice(messageStart, messageEnd);
+      this.buffer = this.buffer.slice(messageEnd);
+
+      try {
+        const message = JSON.parse(messageStr);
+        this.handleMessage(message);
+      } catch (err) {
+        logger.error('Failed to parse ACP JSON-RPC message:', err);
+      }
+    }
+  }
+
+  /**
+   * Route incoming JSON-RPC messages.
+   */
+  private handleMessage(message: JsonRpcRequest | JsonRpcResponse | JsonRpcNotification): void {
+    // Response to our request
+    if ('id' in message && message.id !== null && !('method' in message)) {
+      const response = message as JsonRpcResponse;
+      const pending = this.pendingRequests.get(response.id!);
+      if (pending) {
+        this.pendingRequests.delete(response.id!);
+        if (response.error) {
+          pending.reject(
+            new Error(`ACP error [${response.error.code}]: ${response.error.message}`),
+          );
+        } else {
+          pending.resolve(response.result);
+        }
+      }
+      return;
+    }
+
+    // Incoming request or notification from agent
+    if ('method' in message) {
+      const method = message.method;
+      const params = message.params || {};
+
+      // Notification (no id) — e.g., session/update
+      if (!('id' in message) || message.id === undefined || message.id === null) {
+        this.handleNotification(method, params);
+        return;
+      }
+
+      // Request (has id) — agent calling client methods
+      this.handleIncomingRequest(message as JsonRpcRequest);
+    }
+  }
+
+  /**
+   * Handle notifications from the agent (no response expected).
+   */
+  private handleNotification(method: string, params: Record<string, unknown> | object): void {
+    switch (method) {
+      case 'session/update': {
+        if (this.callbacks.onSessionUpdate) {
+          this.callbacks.onSessionUpdate(params as unknown as ACPSessionUpdate);
+        }
+        break;
+      }
+      default: {
+        logger.warn('Unhandled ACP notification:', method);
+      }
+    }
+  }
+
+  /**
+   * Handle incoming requests from the agent (response required).
+   */
+  private async handleIncomingRequest(request: JsonRpcRequest): Promise<void> {
+    const { id, method, params } = request;
+
+    // Special handling for permission requests
+    if (method === 'session/request_permission') {
+      if (this.callbacks.onPermissionRequest) {
+        try {
+          const response = await this.callbacks.onPermissionRequest(
+            params as unknown as ACPPermissionRequest,
+          );
+          this.sendResponse(id, response);
+        } catch (err) {
+          this.sendErrorResponse(id, {
+            code: -32000,
+            message: err instanceof Error ? err.message : 'Permission request failed',
+          });
+        }
+      } else {
+        // Auto-allow if no handler
+        const permReq = params as unknown as ACPPermissionRequest;
+        const allowOption = permReq.options?.find((o) => o.kind === 'allow_once');
+        this.sendResponse(id, {
+          kind: 'selected',
+          optionId: allowOption?.optionId || permReq.options?.[0]?.optionId,
+        });
+      }
+      return;
+    }
+
+    // Delegate to registered client method handlers
+    const handler = this.clientMethodHandlers.get(method);
+    if (handler) {
+      try {
+        const result = await handler(params);
+        this.sendResponse(id, result ?? null);
+      } catch (err) {
+        this.sendErrorResponse(id, {
+          code: -32000,
+          message: err instanceof Error ? err.message : 'Client method failed',
+        });
+      }
+    } else {
+      this.sendErrorResponse(id, {
+        code: -32601,
+        message: `Method not found: ${method}`,
+      });
+    }
+  }
+}

apps/desktop/src/main/libs/acp/index.ts

@@ -0,0 +1,3 @@
+export type { ACPClientCallbacks, ACPClientParams } from './client';
+export { ACPClient } from './client';
+export type * from './types';

apps/desktop/src/main/libs/acp/types.ts

@@ -0,0 +1,326 @@
+/**
+ * ACP (Agent Client Protocol) type definitions
+ * Based on: https://agentclientprotocol.com/protocol/schema
+ */
+
+// ============================================================
+// JSON-RPC 2.0 base types
+// ============================================================
+
+export interface JsonRpcRequest {
+  id: number | string;
+  jsonrpc: '2.0';
+  method: string;
+  params?: Record<string, unknown> | object;
+}
+
+export interface JsonRpcResponse {
+  error?: JsonRpcError;
+  id: number | string | null;
+  jsonrpc: '2.0';
+  result?: unknown;
+}
+
+export interface JsonRpcNotification {
+  jsonrpc: '2.0';
+  method: string;
+  params?: Record<string, unknown>;
+}
+
+export interface JsonRpcError {
+  code: number;
+  data?: unknown;
+  message: string;
+}
+
+// ============================================================
+// ACP Capabilities
+// ============================================================
+
+export interface ACPCapabilities {
+  audio?: boolean;
+  embeddedContext?: boolean;
+  fs?: {
+    readTextFile?: boolean;
+    writeTextFile?: boolean;
+  };
+  image?: boolean;
+  terminal?: boolean;
+}
+
+export interface ACPServerCapabilities {
+  modes?: ACPMode[];
+  name: string;
+  protocolVersion: string;
+  version?: string;
+}
+
+export interface ACPMode {
+  description?: string;
+  id: string;
+  name: string;
+}
+
+// ============================================================
+// Session types
+// ============================================================
+
+export interface ACPSessionInfo {
+  createdAt?: string;
+  id: string;
+  title?: string;
+}
+
+// ============================================================
+// Content block types (used in session/update)
+// ============================================================
+
+export type ACPContentBlock =
+  | ACPTextContent
+  | ACPImageContent
+  | ACPAudioContent
+  | ACPResourceContent
+  | ACPResourceLinkContent;
+
+export interface ACPTextContent {
+  annotations?: Record<string, unknown>;
+  text: string;
+  type: 'text';
+}
+
+export interface ACPImageContent {
+  annotations?: Record<string, unknown>;
+  data: string;
+  mimeType: string;
+  type: 'image';
+  uri?: string;
+}
+
+export interface ACPAudioContent {
+  annotations?: Record<string, unknown>;
+  data: string;
+  mimeType: string;
+  type: 'audio';
+}
+
+export interface ACPResourceContent {
+  annotations?: Record<string, unknown>;
+  resource: {
+    blob?: string;
+    mimeType?: string;
+    text?: string;
+    uri: string;
+  };
+  type: 'resource';
+}
+
+export interface ACPResourceLinkContent {
+  annotations?: Record<string, unknown>;
+  description?: string;
+  mimeType?: string;
+  name: string;
+  size?: number;
+  title?: string;
+  type: 'resource_link';
+  uri: string;
+}
+
+// ============================================================
+// Tool call types
+// ============================================================
+
+export type ACPToolCallKind =
+  | 'read'
+  | 'edit'
+  | 'delete'
+  | 'move'
+  | 'search'
+  | 'execute'
+  | 'think'
+  | 'fetch'
+  | 'other';
+
+export type ACPToolCallStatus = 'pending' | 'in_progress' | 'completed' | 'failed';
+
+export interface ACPToolCallDiffContent {
+  newText: string;
+  oldText: string;
+  path: string;
+  type: 'diff';
+}
+
+export interface ACPToolCallTerminalContent {
+  command?: string;
+  exitCode?: number;
+  output: string;
+  type: 'terminal';
+}
+
+export type ACPToolCallContent =
+  | ACPTextContent
+  | ACPImageContent
+  | ACPToolCallDiffContent
+  | ACPToolCallTerminalContent;
+
+export interface ACPToolCallLocation {
+  endLine?: number;
+  path: string;
+  startLine?: number;
+}
+
+export interface ACPToolCallUpdate {
+  content?: ACPToolCallContent[];
+  kind?: ACPToolCallKind;
+  locations?: ACPToolCallLocation[];
+  rawInput?: string;
+  rawOutput?: string;
+  status?: ACPToolCallStatus;
+  title: string;
+  toolCallId: string;
+}
+
+// ============================================================
+// Session update notification
+// ============================================================
+
+export type ACPMessageRole = 'assistant' | 'user' | 'thought';
+
+export interface ACPMessageChunk {
+  content: ACPContentBlock[];
+  role: ACPMessageRole;
+}
+
+export interface ACPSessionUpdate {
+  messageChunks?: ACPMessageChunk[];
+  sessionId: string;
+  toolCalls?: ACPToolCallUpdate[];
+}
+
+// ============================================================
+// Permission request types
+// ============================================================
+
+export interface ACPPermissionOption {
+  kind: 'allow_once' | 'allow_always' | 'reject_once' | 'reject_always';
+  name: string;
+  optionId: string;
+}
+
+export interface ACPPermissionRequest {
+  message?: string;
+  options: ACPPermissionOption[];
+  sessionId: string;
+  toolCall?: ACPToolCallUpdate;
+}
+
+export interface ACPPermissionResponse {
+  kind: 'selected' | 'cancelled';
+  optionId?: string;
+}
+
+// ============================================================
+// Client method params (agent → client)
+// ============================================================
+
+export interface FSReadTextFileParams {
+  path: string;
+}
+
+export interface FSReadTextFileResult {
+  text: string;
+}
+
+export interface FSWriteTextFileParams {
+  path: string;
+  text: string;
+}
+
+export interface TerminalCreateParams {
+  command: string;
+  cwd?: string;
+  env?: Record<string, string>;
+}
+
+export interface TerminalCreateResult {
+  terminalId: string;
+}
+
+export interface TerminalOutputParams {
+  terminalId: string;
+}
+
+export interface TerminalOutputResult {
+  exitCode?: number;
+  isRunning: boolean;
+  output: string;
+}
+
+export interface TerminalWaitForExitParams {
+  terminalId: string;
+  timeout?: number;
+}
+
+export interface TerminalWaitForExitResult {
+  exitCode: number;
+  output: string;
+}
+
+export interface TerminalKillParams {
+  terminalId: string;
+}
+
+export interface TerminalReleaseParams {
+  terminalId: string;
+}
+
+// ============================================================
+// Agent method params (client → agent)
+// ============================================================
+
+export interface ACPInitializeParams {
+  capabilities?: ACPCapabilities;
+  clientInfo?: {
+    name: string;
+    version: string;
+  };
+  protocolVersion: string;
+}
+
+export interface ACPSessionNewParams {
+  title?: string;
+}
+
+export interface ACPSessionPromptParams {
+  content: ACPContentBlock[];
+  sessionId: string;
+}
+
+export interface ACPSessionCancelParams {
+  sessionId: string;
+}
+
+// ============================================================
+// Broadcast event types (main → renderer)
+// ============================================================
+
+export interface ACPSessionUpdateEvent {
+  sessionId: string;
+  update: ACPSessionUpdate;
+}
+
+export interface ACPPermissionRequestEvent {
+  message?: string;
+  options: ACPPermissionOption[];
+  requestId: string;
+  sessionId: string;
+  toolCall?: ACPToolCallUpdate;
+}
+
+export interface ACPSessionErrorEvent {
+  error: string;
+  sessionId: string;
+}
+
+export interface ACPSessionCompleteEvent {
+  sessionId: string;
+}

apps/desktop/src/main/modules/toolDetectors/cliAgentDetectors.ts

@@ -0,0 +1,145 @@
+import { exec } from 'node:child_process';
+import { platform } from 'node:os';
+import { promisify } from 'node:util';
+
+import type { IToolDetector, ToolStatus } from '@/core/infrastructure/ToolDetectorManager';
+import { createCommandDetector } from '@/core/infrastructure/ToolDetectorManager';
+
+const execPromise = promisify(exec);
+
+/**
+ * Detector that resolves a command path via which/where, then validates
+ * the binary by matching `--version` (or `--help`) output against a keyword
+ * to avoid collisions with unrelated executables of the same name.
+ */
+const createValidatedDetector = (options: {
+  candidates: string[];
+  description: string;
+  name: string;
+  priority: number;
+  validateFlag?: string;
+  validateKeywords: string[];
+}): IToolDetector => {
+  const {
+    name,
+    description,
+    priority,
+    candidates,
+    validateFlag = '--version',
+    validateKeywords,
+  } = options;
+
+  return {
+    description,
+    async detect(): Promise<ToolStatus> {
+      const whichCmd = platform() === 'win32' ? 'where' : 'which';
+
+      for (const cmd of candidates) {
+        try {
+          const { stdout: pathOut } = await execPromise(`${whichCmd} ${cmd}`, { timeout: 3000 });
+          const toolPath = pathOut.trim().split('\n')[0];
+          if (!toolPath) continue;
+
+          const { stdout: out } = await execPromise(`${cmd} ${validateFlag}`, { timeout: 5000 });
+          const output = out.trim();
+          const lowered = output.toLowerCase();
+          if (!validateKeywords.some((kw) => lowered.includes(kw.toLowerCase()))) continue;
+
+          return {
+            available: true,
+            path: toolPath,
+            version: output.split('\n')[0],
+          };
+        } catch {
+          continue;
+        }
+      }
+
+      return { available: false };
+    },
+    name,
+    priority,
+  };
+};
+
+/**
+ * Claude Code CLI
+ * @see https://docs.claude.com/en/docs/claude-code
+ */
+export const claudeCodeDetector: IToolDetector = createValidatedDetector({
+  candidates: ['claude'],
+  description: 'Claude Code - Anthropic official agentic coding CLI',
+  name: 'claude',
+  priority: 1,
+  validateKeywords: ['claude code'],
+});
+
+/**
+ * OpenAI Codex CLI
+ * @see https://github.com/openai/codex
+ */
+export const codexDetector: IToolDetector = createValidatedDetector({
+  candidates: ['codex'],
+  description: 'Codex - OpenAI agentic coding CLI',
+  name: 'codex',
+  priority: 2,
+  validateKeywords: ['codex'],
+});
+
+/**
+ * Google Gemini CLI
+ * @see https://github.com/google-gemini/gemini-cli
+ */
+export const geminiCliDetector: IToolDetector = createValidatedDetector({
+  candidates: ['gemini'],
+  description: 'Gemini CLI - Google agentic coding CLI',
+  name: 'gemini',
+  priority: 3,
+  validateKeywords: ['gemini'],
+});
+
+/**
+ * Qwen Code CLI
+ * @see https://github.com/QwenLM/qwen-code
+ */
+export const qwenCodeDetector: IToolDetector = createValidatedDetector({
+  candidates: ['qwen'],
+  description: 'Qwen Code - Alibaba Qwen agentic coding CLI',
+  name: 'qwen',
+  priority: 4,
+  validateKeywords: ['qwen'],
+});
+
+/**
+ * Kimi CLI (Moonshot)
+ * @see https://github.com/MoonshotAI/kimi-cli
+ */
+export const kimiCliDetector: IToolDetector = createValidatedDetector({
+  candidates: ['kimi'],
+  description: 'Kimi CLI - Moonshot AI agentic coding CLI',
+  name: 'kimi',
+  priority: 5,
+  validateKeywords: ['kimi'],
+});
+
+/**
+ * Aider - AI pair programming CLI
+ * Generic command detector; name collision is unlikely.
+ * @see https://github.com/Aider-AI/aider
+ */
+export const aiderDetector: IToolDetector = createCommandDetector('aider', {
+  description: 'Aider - AI pair programming in your terminal',
+  priority: 6,
+});
+
+/**
+ * All CLI agent detectors
+ */
+export const cliAgentDetectors: IToolDetector[] = [
+  claudeCodeDetector,
+  codexDetector,
+  geminiCliDetector,
+  qwenCodeDetector,
+  kimiCliDetector,
+  aiderDetector,
+];

apps/desktop/src/main/modules/toolDetectors/index.ts

@@ -6,6 +6,7 @@
  */
 
 export { browserAutomationDetectors } from './agentBrowserDetectors';
+export { cliAgentDetectors } from './cliAgentDetectors';
 export { astSearchDetectors, contentSearchDetectors } from './contentSearchDetectors';
 export { fileSearchDetectors } from './fileSearchDetectors';
 export { runtimeEnvironmentDetectors } from './runtimeEnvironmentDetectors';

apps/desktop/src/main/shortcuts/config.ts

@@ -1,20 +0,0 @@
-/**
- * Shortcut action type enum
- */
-export const ShortcutActionEnum = {
-  openSettings: 'openSettings',
-  /**
-   * Show/hide main window
-   */
-  showApp: 'showApp',
-} as const;
-
-export type ShortcutActionType = (typeof ShortcutActionEnum)[keyof typeof ShortcutActionEnum];
-
-/**
- * Default shortcut configuration
- */
-export const DEFAULT_SHORTCUTS_CONFIG: Record<ShortcutActionType, string> = {
-  [ShortcutActionEnum.showApp]: 'Control+E',
-  [ShortcutActionEnum.openSettings]: 'CommandOrControl+,',
-};

apps/desktop/src/main/shortcuts/index.ts

@@ -1 +0,0 @@
-export * from './config';

apps/desktop/stubs/business-const/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "@lobechat/business-const",
+  "version": "0.0.0",
+  "private": true,
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "main": "./src/index.ts"
+}

apps/desktop/stubs/business-const/src/index.ts

@@ -0,0 +1,6 @@
+export const BRANDING_LOGO_URL = '';
+export const BRANDING_NAME = 'LobeHub';
+export const DEFAULT_EMBEDDING_PROVIDER = 'openai';
+export const DEFAULT_MINI_PROVIDER = 'openai';
+export const DEFAULT_PROVIDER = 'openai';
+export const ORG_NAME = 'LobeHub';

apps/desktop/stubs/types/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "@lobechat/types",
+  "version": "0.0.0",
+  "private": true,
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "main": "./src/index.ts"
+}

apps/desktop/stubs/types/src/index.ts

@@ -0,0 +1,19 @@
+/**
+ * Desktop isolated workspace stub.
+ *
+ * `@lobechat/types` is only consumed via `import type` in desktop code and in
+ * the `@lobechat/const` entrypoints it reaches (currently `desktopGlobalShortcuts`).
+ * Those specifiers are erased at build time, so this package has no runtime
+ * exports — we only need to surface the types that reach the desktop tsgo
+ * project. Keep these in sync with `packages/types/src/hotkey.ts`.
+ */
+
+export type DesktopHotkeyId = 'openSettings' | 'showApp';
+
+export interface DesktopHotkeyItem {
+  id: DesktopHotkeyId;
+  keys: string;
+  nonEditable?: boolean;
+}
+
+export type DesktopHotkeyConfig = Record<DesktopHotkeyId, string>;

locales/ar/common.json

@@ -1,6 +1,9 @@
 {
   "about": "حول",
   "advanceSettings": "الإعدادات المتقدمة",
+  "agentOnboardingPromo.actionLabel": "جرّب الآن",
+  "agentOnboardingPromo.description": "قم بإعداد فرق الوكلاء لديك عبر محادثة سريعة مع Lobe AI. ستبقى وكلاؤك الحاليون دون تغيير.",
+  "agentOnboardingPromo.title": "المعالج السريع",
   "alert.cloud.action": "جرّب الآن",
   "alert.cloud.desc": "جميع المستخدمين المسجلين يحصلون على {{credit}} من أرصدة الحوسبة المجانية شهريًا — دون الحاجة إلى إعداد. يشمل المزامنة السحابية العالمية والبحث المتقدم على الويب.",
   "alert.cloud.descOnMobile": "جميع المستخدمين المسجلين يحصلون على {{credit}} من أرصدة الحوسبة المجانية شهريًا — دون الحاجة إلى إعداد.",

locales/bg-BG/common.json

@@ -1,6 +1,9 @@
 {
   "about": "Относно",
   "advanceSettings": "Разширени настройки",
+  "agentOnboardingPromo.actionLabel": "Опитайте сега",
+  "agentOnboardingPromo.description": "Настройте своите екипи от агенти в кратък чат с Lobe AI. Съществуващите ви агенти ще останат непроменени.",
+  "agentOnboardingPromo.title": "Бърз съветник",
   "alert.cloud.action": "Опитайте сега",
   "alert.cloud.desc": "Всички регистрирани потребители получават {{credit}} безплатни изчислителни кредити на месец — без нужда от настройка. Включва глобална синхронизация в облака и разширено търсене в мрежата.",
   "alert.cloud.descOnMobile": "Всички регистрирани потребители получават {{credit}} безплатни изчислителни кредити на месец — без нужда от настройка.",

locales/de-DE/common.json

@@ -1,6 +1,9 @@
 {
   "about": "Über",
   "advanceSettings": "Erweiterte Einstellungen",
+  "agentOnboardingPromo.actionLabel": "Jetzt ausprobieren",
+  "agentOnboardingPromo.description": "Richte deine Agent-Teams in einem kurzen Chat mit Lobe AI ein. Deine vorhandenen Agenten bleiben unverändert.",
+  "agentOnboardingPromo.title": "Schnellassistent",
   "alert.cloud.action": "Jetzt ausprobieren",
   "alert.cloud.desc": "Alle registrierten Nutzer erhalten monatlich {{credit}} kostenlose Rechen-Credits – keine Einrichtung erforderlich. Inklusive globaler Cloud-Synchronisierung und erweiterter Websuche.",
   "alert.cloud.descOnMobile": "Alle registrierten Nutzer erhalten monatlich {{credit}} kostenlose Rechen-Credits – keine Einrichtung erforderlich.",

locales/en-US/auth.json

@@ -226,7 +226,7 @@
   "stats.updatedAt": "Updated at",
   "stats.welcome": "{{username}}, this is your <span>{{days}}</span> day with {{appName}}",
   "stats.words": "Total Words",
-  "tab.apikey": "API Key Management",
+  "tab.apikey": "API Key",
   "tab.profile": "My Account",
   "tab.security": "Security",
   "tab.stats": "Statistics",

locales/en-US/chat.json

@@ -18,6 +18,7 @@
   "agentDefaultMessage": "Hi, I’m **{{name}}**. One sentence is enough.\n\nWant me to match your workflow better? Go to [Agent Settings]({{url}}) and fill in the Agent Profile (you can edit it anytime).",
   "agentDefaultMessageWithSystemRole": "Hi, I’m **{{name}}**. One sentence is enough—you're in control.",
   "agentDefaultMessageWithoutEdit": "Hi, I’m **{{name}}**. One sentence is enough—you're in control.",
+  "agentSidebar.externalTag": "External",
   "agents": "Agents",
   "artifact.generating": "Generating",
   "artifact.inThread": "Cannot view in subtopic, please switch to the main conversation area to open",
@@ -123,6 +124,7 @@
   "groupWizard.searchTemplates": "Search templates...",
   "groupWizard.title": "Create Group",
   "groupWizard.useTemplate": "Use Template",
+  "heteroAgent.resumeReset.cwdChanged": "Working directory changed. Previous Claude Code session can only be resumed from its original directory, so a new conversation has started.",
   "hideForYou": "Direct message content is hidden. Please enable 'Show Direct Message Content' in settings to view.",
   "history.title": "The Agent will keep only the latest {{count}} messages.",
   "historyRange": "History Range",
@@ -223,6 +225,7 @@
   "minimap.senderAssistant": "Agent",
   "minimap.senderUser": "You",
   "newAgent": "Create Agent",
+  "newClaudeCodeAgent": "Add Claude Code",
   "newGroupChat": "Create Group",
   "newPage": "Create Page",
   "noAgentsYet": "This group has no members yet. Click the + button to invite agents.",
@@ -234,6 +237,7 @@
   "operation.contextCompression": "Context too long, compressing history...",
   "operation.execAgentRuntime": "Preparing response",
   "operation.execClientTask": "Executing task",
+  "operation.execHeterogeneousAgent": "Running agent",
   "operation.execServerAgentRuntime": "Task is running in the server. You are safe to leave this page",
   "operation.sendMessage": "Sending message",
   "owner": "Group owner",
@@ -418,6 +422,15 @@
   "tool.intervention.mode.autoRunDesc": "Automatically approve all tool executions",
   "tool.intervention.mode.manual": "Manual",
   "tool.intervention.mode.manualDesc": "Manual approval required for each invocation",
+  "tool.intervention.onboarding.agentIdentity.applyHint": "The new identity will appear after approval.",
+  "tool.intervention.onboarding.agentIdentity.description": "Approving this change updates the Agent shown in Inbox and in this onboarding conversation.",
+  "tool.intervention.onboarding.agentIdentity.emoji": "Agent avatar",
+  "tool.intervention.onboarding.agentIdentity.eyebrow": "Onboarding approval",
+  "tool.intervention.onboarding.agentIdentity.name": "Agent name",
+  "tool.intervention.onboarding.agentIdentity.targetInbox": "Inbox Agent",
+  "tool.intervention.onboarding.agentIdentity.targetOnboarding": "Current onboarding Agent",
+  "tool.intervention.onboarding.agentIdentity.targets": "Applies to",
+  "tool.intervention.onboarding.agentIdentity.title": "Confirm Agent identity update",
   "tool.intervention.pending": "Pending",
   "tool.intervention.reject": "Reject",
   "tool.intervention.rejectAndContinue": "Reject and Retry",
@@ -467,6 +480,9 @@
   "viewMode.wideScreen": "Widescreen",
   "workflow.awaitingConfirmation": "Awaiting your confirmation",
   "workflow.failedSuffix": "(failed)",
+  "workflow.summaryFailed": "{{count}} failed",
+  "workflow.summaryMoreTools": "+{{count}} more",
+  "workflow.summaryTotalCalls": "{{count}} calls total",
   "workflow.thoughtForDuration": "Thought for {{duration}}",
   "workflow.toolDisplayName.activateDevice": "Activated device",
   "workflow.toolDisplayName.activateSkill": "Activated a skill",

locales/en-US/common.json

@@ -1,6 +1,9 @@
 {
   "about": "About",
   "advanceSettings": "Advanced Settings",
+  "agentOnboardingPromo.actionLabel": "Try it now",
+  "agentOnboardingPromo.description": "Set up your agent teams in a quick chat with Lobe AI. Your existing agents remain unchanged.",
+  "agentOnboardingPromo.title": "Quick Wizard",
   "alert.cloud.action": "Try now",
   "alert.cloud.desc": "All registered users get {{credit}} free computing credits per month—no setup needed. Includes global cloud sync and advanced web search.",
   "alert.cloud.descOnMobile": "All registered users get {{credit}} free computing credits per month—no setup needed.",

locales/en-US/electron.json

@@ -133,5 +133,7 @@
   "window.close": "Close window",
   "window.maximize": "Maximize window",
   "window.minimize": "Minimize window",
-  "window.restore": "Restore window"
+  "window.pinToTop": "Pin on top",
+  "window.restore": "Restore window",
+  "window.unpinFromTop": "Unpin from top"
 }

locales/en-US/file.json

@@ -90,6 +90,32 @@
   "pageEditor.exportDialogTitle": "Export Page",
   "pageEditor.exportError": "Failed to export the page",
   "pageEditor.exportSuccess": "Page exported successfully",
+  "pageEditor.history.backToCopilot": "Copilot",
+  "pageEditor.history.compare": "Compare",
+  "pageEditor.history.compareCurrentLabel": "Current",
+  "pageEditor.history.compareDescription": "Compare the current content with the selected history state",
+  "pageEditor.history.compareError": "Failed to load diff preview",
+  "pageEditor.history.compareModalTitle": "Compare",
+  "pageEditor.history.compareOldLabel": "Restore To",
+  "pageEditor.history.compareTitle": "Version Diff",
+  "pageEditor.history.current": "Current",
+  "pageEditor.history.dayLabel.today": "Today",
+  "pageEditor.history.dayLabel.yesterday": "Yesterday",
+  "pageEditor.history.empty": "No version history yet",
+  "pageEditor.history.itemVersionLabel": "v{{version}}",
+  "pageEditor.history.restore": "Restore",
+  "pageEditor.history.restoreConfirm.content": "Restore the page to how it was at {{savedAt}}? Your current content will be replaced and saved.",
+  "pageEditor.history.restoreConfirm.title": "Restore from history",
+  "pageEditor.history.restoreError": "Failed to restore from history",
+  "pageEditor.history.saveSource.autosave": "Auto Save",
+  "pageEditor.history.saveSource.llm_call": "AI Edit",
+  "pageEditor.history.saveSource.manual": "Manual Save",
+  "pageEditor.history.saveSource.restore": "Restore",
+  "pageEditor.history.saveSource.system": "System",
+  "pageEditor.history.title": "Version History",
+  "pageEditor.history.versionCount_one": "{{count}} version",
+  "pageEditor.history.versionCount_other": "{{count}} versions",
+  "pageEditor.history.versionLabel": "v{{version}}",
   "pageEditor.linkCopied": "Link copied",
   "pageEditor.menu.copyLink": "Copy Link",
   "pageEditor.menu.export": "Export",

locales/en-US/labs.json

@@ -1,4 +1,6 @@
 {
+  "features.agentWorkingPanel.desc": "A place to view an agent's progress and accessible resources.",
+  "features.agentWorkingPanel.title": "Working Panel",
   "features.assistantMessageGroup.desc": "Group agent messages and their tool call results together for display",
   "features.assistantMessageGroup.title": "Agent Message Grouping",
   "features.gatewayMode.desc": "Execute agent tasks on the server via Gateway WebSocket instead of running locally. Enables faster execution and reduces client resource usage.",

locales/en-US/modelProvider.json

@@ -230,6 +230,7 @@
   "providerModels.item.modelConfig.extendParams.options.imageAspectRatio2.hint": "For Nano Banana 2; controls aspect ratio of generated images (supports extra-wide 1:4, 4:1, 1:8, 8:1).",
   "providerModels.item.modelConfig.extendParams.options.imageResolution.hint": "For Gemini 3 image generation models; controls resolution of generated images.",
   "providerModels.item.modelConfig.extendParams.options.imageResolution2.hint": "For Gemini 3.1 Flash Image models; controls resolution of generated images (supports 512px).",
+  "providerModels.item.modelConfig.extendParams.options.opus47Effort.hint": "For Claude Opus 4.7; controls effort level (low/medium/high/xhigh/max).",
   "providerModels.item.modelConfig.extendParams.options.reasoningBudgetToken.hint": "For Claude, Qwen3 and similar; controls token budget for reasoning.",
   "providerModels.item.modelConfig.extendParams.options.reasoningBudgetToken32k.hint": "For GLM-5 and GLM-4.7; controls token budget for reasoning (max 32k).",
   "providerModels.item.modelConfig.extendParams.options.reasoningBudgetToken80k.hint": "For Qwen3 series; controls token budget for reasoning (max 80k).",

locales/en-US/notification.json

@@ -1,4 +1,6 @@
 {
+  "billboard.learnMore": "Learn more",
+  "billboard.menuLabel": "Announcements",
   "inbox.archiveAll": "Archive all",
   "inbox.empty": "No notifications yet",
   "inbox.emptyUnread": "No unread notifications",

locales/en-US/onboarding.json

@@ -51,6 +51,11 @@
   "agent.welcome.sentence.1": "So nice to meet you! Let’s get to know each other.",
   "agent.welcome.sentence.2": "What kind of partner do you want me to be?",
   "agent.welcome.sentence.3": "First, give me a name :)",
+  "agent.wrapUp.action": "I think we're good",
+  "agent.wrapUp.confirm.cancel": "Keep chatting",
+  "agent.wrapUp.confirm.content": "I'll save what we've covered so far. You can always come back and chat more later.",
+  "agent.wrapUp.confirm.ok": "Finish now",
+  "agent.wrapUp.confirm.title": "Finish onboarding now?",
   "back": "Back",
   "finish": "Get Started",
   "interests.area.business": "Business & Strategy",

locales/en-US/plugin.json

@@ -30,6 +30,7 @@
   "builtins.lobe-agent-documents.apiName.createDocument": "Create document",
   "builtins.lobe-agent-documents.apiName.editDocument": "Edit document",
   "builtins.lobe-agent-documents.apiName.listDocuments": "List documents",
+  "builtins.lobe-agent-documents.apiName.patchDocument": "Patch document",
   "builtins.lobe-agent-documents.apiName.readDocument": "Read document",
   "builtins.lobe-agent-documents.apiName.readDocumentByFilename": "Read document by filename",
   "builtins.lobe-agent-documents.apiName.removeDocument": "Remove document",
@@ -64,6 +65,9 @@
   "builtins.lobe-agent-management.render.installPlugin.plugin": "Plugin",
   "builtins.lobe-agent-management.render.installPlugin.success": "Installed successfully",
   "builtins.lobe-agent-management.title": "Agent Manager",
+  "builtins.lobe-claude-code.todoWrite.allDone": "All tasks completed",
+  "builtins.lobe-claude-code.todoWrite.currentStep": "Current step",
+  "builtins.lobe-claude-code.todoWrite.todos": "Todos",
   "builtins.lobe-cloud-sandbox.apiName.editLocalFile": "Edit file",
   "builtins.lobe-cloud-sandbox.apiName.executeCode": "Execute code",
   "builtins.lobe-cloud-sandbox.apiName.exportFile": "Export file",
@@ -431,18 +435,34 @@
   "loading.plugin": "Skill running…",
   "localSystem.workingDirectory.agentDescription": "Default working directory for all conversations with this Agent",
   "localSystem.workingDirectory.agentLevel": "Agent Working Directory",
+  "localSystem.workingDirectory.branchSearchPlaceholder": "Search branches",
+  "localSystem.workingDirectory.branchesEmpty": "No local branches",
+  "localSystem.workingDirectory.branchesHeading": "Branches",
+  "localSystem.workingDirectory.branchesLoading": "Loading branches…",
+  "localSystem.workingDirectory.branchesNoMatch": "No matching branches",
+  "localSystem.workingDirectory.cancel": "Cancel",
+  "localSystem.workingDirectory.checkoutAction": "Checkout",
+  "localSystem.workingDirectory.checkoutFailed": "Checkout failed",
   "localSystem.workingDirectory.chooseDifferentFolder": "Choose a different folder",
+  "localSystem.workingDirectory.createBranchAction": "Checkout new branch…",
   "localSystem.workingDirectory.current": "Current working directory",
+  "localSystem.workingDirectory.detachedHead": "Detached HEAD at {{sha}}",
+  "localSystem.workingDirectory.ghMissing": "Install and log in to the GitHub CLI (`gh`) to see linked pull requests",
+  "localSystem.workingDirectory.newBranchPlaceholder": "feature/new-branch-name",
   "localSystem.workingDirectory.noRecent": "No recent directories",
   "localSystem.workingDirectory.notSet": "Click to set working directory",
   "localSystem.workingDirectory.placeholder": "Enter directory path, e.g. /Users/name/projects",
+  "localSystem.workingDirectory.prTooltipWithExtra": "{{title}} (+{{count}} more open PR on this branch)",
   "localSystem.workingDirectory.recent": "Recent",
+  "localSystem.workingDirectory.refreshGitStatus": "Refresh branch & PR status",
   "localSystem.workingDirectory.removeRecent": "Remove from recent",
   "localSystem.workingDirectory.selectFolder": "Select folder",
   "localSystem.workingDirectory.title": "Working Directory",
   "localSystem.workingDirectory.topicDescription": "Override Agent default for this conversation only",
   "localSystem.workingDirectory.topicLevel": "Conversation override",
   "localSystem.workingDirectory.topicOverride": "Override for this conversation",
+  "localSystem.workingDirectory.uncommittedChanges_one": "Uncommitted changes: {{count}} file",
+  "localSystem.workingDirectory.uncommittedChanges_other": "Uncommitted changes: {{count}} files",
   "mcpEmpty.deployment": "No deployment options",
   "mcpEmpty.prompts": "No prompts",
   "mcpEmpty.resources": "No resources",

locales/en-US/setting.json

@@ -191,6 +191,11 @@
   "analytics.telemetry.desc": "Help us improve {{appName}} with anonymous usage data",
   "analytics.telemetry.title": "Send Anonymous Usage Data",
   "analytics.title": "Analytics",
+  "ccStatus.account.label": "Account",
+  "ccStatus.detecting": "Detecting Claude Code CLI...",
+  "ccStatus.redetect": "Re-detect",
+  "ccStatus.title": "Claude Code CLI",
+  "ccStatus.unavailable": "Claude Code CLI not found. Please install or configure it.",
   "checking": "Checking...",
   "checkingPermissions": "Checking permissions...",
   "creds.actions.delete": "Delete",
@@ -659,6 +664,8 @@
   "settingSystemTools.appEnvironment.title": "Built-in App Tools",
   "settingSystemTools.category.browserAutomation": "Browser Automation",
   "settingSystemTools.category.browserAutomation.desc": "Tools for headless browser automation and web interaction",
+  "settingSystemTools.category.cliAgents": "CLI Agents",
+  "settingSystemTools.category.cliAgents.desc": "Agentic coding CLIs detected on your system, such as Claude Code, Codex, and Kimi",
   "settingSystemTools.category.contentSearch": "Content Search",
   "settingSystemTools.category.contentSearch.desc": "Tools for searching text content within files",
   "settingSystemTools.category.fileSearch": "File Search",
@@ -673,17 +680,23 @@
   "settingSystemTools.title": "System Tools",
   "settingSystemTools.tools.ag.desc": "The Silver Searcher - fast code searching tool",
   "settingSystemTools.tools.agentBrowser.desc": "Agent-browser - headless browser automation CLI for AI agents",
+  "settingSystemTools.tools.aider.desc": "Aider - AI pair programming in your terminal",
   "settingSystemTools.tools.bun.desc": "Bun - fast JavaScript runtime and package manager",
   "settingSystemTools.tools.bunx.desc": "bunx - Bun package runner for executing npm packages",
+  "settingSystemTools.tools.claude.desc": "Claude Code - Anthropic official agentic coding CLI",
+  "settingSystemTools.tools.codex.desc": "Codex - OpenAI agentic coding CLI",
   "settingSystemTools.tools.fd.desc": "fd - fast and user-friendly alternative to find",
   "settingSystemTools.tools.find.desc": "Unix find - standard file search command",
+  "settingSystemTools.tools.gemini.desc": "Gemini CLI - Google agentic coding CLI",
   "settingSystemTools.tools.grep.desc": "GNU grep - standard text search tool",
+  "settingSystemTools.tools.kimi.desc": "Kimi CLI - Moonshot AI agentic coding CLI",
   "settingSystemTools.tools.lobehub.desc": "LobeHub CLI - manage and connect to LobeHub services",
   "settingSystemTools.tools.mdfind.desc": "macOS Spotlight search (fast indexed search)",
   "settingSystemTools.tools.node.desc": "Node.js - JavaScript runtime for executing JS/TS",
   "settingSystemTools.tools.npm.desc": "npm - Node.js package manager for installing dependencies",
   "settingSystemTools.tools.pnpm.desc": "pnpm - fast, disk space efficient package manager",
   "settingSystemTools.tools.python.desc": "Python - programming language runtime",
+  "settingSystemTools.tools.qwen.desc": "Qwen Code - Alibaba Qwen agentic coding CLI",
   "settingSystemTools.tools.rg.desc": "ripgrep - extremely fast text search tool",
   "settingSystemTools.tools.uv.desc": "uv - extremely fast Python package manager",
   "settingTTS.openai.sttModel": "OpenAI Speech-to-Text Model",

locales/en-US/topic.json

@@ -4,6 +4,12 @@
   "actions.confirmRemoveAll": "You are about to delete all topics. This action cannot be undone.",
   "actions.confirmRemoveTopic": "You are about to delete this topic. This action cannot be undone.",
   "actions.confirmRemoveUnstarred": "You are about to delete unstarred topics. This action cannot be undone.",
+  "actions.copyLink": "Copy Link",
+  "actions.copyLinkSuccess": "Link copied",
+  "actions.copySessionId": "Copy Session ID",
+  "actions.copySessionIdSuccess": "Session ID copied",
+  "actions.copyWorkingDirectory": "Copy Working Directory",
+  "actions.copyWorkingDirectorySuccess": "Working directory copied",
   "actions.duplicate": "Duplicate",
   "actions.export": "Export Topics",
   "actions.favorite": "Favorite",
@@ -18,11 +24,14 @@
   "duplicateLoading": "Copying Topic...",
   "duplicateSuccess": "Topic Copied Successfully",
   "favorite": "Favorite",
-  "groupMode.ascMessages": "Sort by Total Messages Ascending",
-  "groupMode.byTime": "Group by Created Time",
-  "groupMode.byUpdatedTime": "Group by Updated Time",
-  "groupMode.descMessages": "Sort by Total Messages Descending",
-  "groupMode.flat": "No Grouping",
+  "filter.groupMode.byProject": "By project",
+  "filter.groupMode.byTime": "By time",
+  "filter.groupMode.flat": "Flat",
+  "filter.organize": "Organize",
+  "filter.sort": "Sort by",
+  "filter.sortBy.createdAt": "Created time",
+  "filter.sortBy.updatedAt": "Updated time",
+  "groupTitle.byProject.noProject": "No directory",
   "groupTitle.byTime.month": "This Month",
   "groupTitle.byTime.today": "Today",
   "groupTitle.byTime.week": "This Week",
@@ -33,7 +42,13 @@
   "importInvalidFormat": "Invalid file format. Please ensure it is a valid JSON file.",
   "importLoading": "Importing conversation...",
   "importSuccess": "Successfully imported {{count}} messages",
+  "inPopup.description": "This topic is currently open in a separate window. Continue the conversation there to keep messages in sync.",
+  "inPopup.focus": "Focus popup window",
+  "inPopup.title": "Open in popup window",
   "loadMore": "Load More",
+  "newTopic": "New Topic",
+  "renameModal.description": "Keep it short and easy to recognize.",
+  "renameModal.title": "Rename Topic",
   "searchPlaceholder": "Search Topics...",
   "searchResultEmpty": "No search results found.",
   "temp": "Temporary",

locales/es-ES/common.json

@@ -1,6 +1,9 @@
 {
   "about": "Acerca de",
   "advanceSettings": "Configuración avanzada",
+  "agentOnboardingPromo.actionLabel": "Probar ahora",
+  "agentOnboardingPromo.description": "Configura tus equipos de agentes en un chat breve con Lobe AI. Tus agentes actuales no se modificarán.",
+  "agentOnboardingPromo.title": "Asistente rápido",
   "alert.cloud.action": "Probar ahora",
   "alert.cloud.desc": "Todos los usuarios registrados reciben {{credit}} créditos de computación gratuitos al mes, sin necesidad de configuración. Incluye sincronización en la nube global y búsqueda web avanzada.",
   "alert.cloud.descOnMobile": "Todos los usuarios registrados reciben {{credit}} créditos de computación gratuitos al mes, sin necesidad de configuración.",

locales/fa-IR/common.json

@@ -1,6 +1,9 @@
 {
   "about": "درباره",
   "advanceSettings": "تنظیمات پیشرفته",
+  "agentOnboardingPromo.actionLabel": "همین حالا امتحان کنید",
+  "agentOnboardingPromo.description": "تیم‌های عامل خود را با یک گفت‌وگوی کوتاه با Lobe AI تنظیم کنید. عامل‌های فعلی شما بدون تغییر باقی می‌مانند.",
+  "agentOnboardingPromo.title": "راهنمای سریع",
   "alert.cloud.action": "هم‌اکنون امتحان کنید",
   "alert.cloud.desc": "تمام کاربران ثبت‌نام‌شده هر ماه {{credit}} اعتبار رایگان محاسباتی دریافت می‌کنند — بدون نیاز به تنظیمات. شامل همگام‌سازی ابری جهانی و جستجوی پیشرفته وب.",
   "alert.cloud.descOnMobile": "تمام کاربران ثبت‌نام‌شده هر ماه {{credit}} اعتبار رایگان محاسباتی دریافت می‌کنند — بدون نیاز به تنظیمات.",

locales/fr-FR/common.json

@@ -1,6 +1,9 @@
 {
   "about": "À propos",
   "advanceSettings": "Paramètres avancés",
+  "agentOnboardingPromo.actionLabel": "Essayer maintenant",
+  "agentOnboardingPromo.description": "Configurez vos équipes d’agents dans un court échange avec Lobe AI. Vos agents existants restent inchangés.",
+  "agentOnboardingPromo.title": "Assistant rapide",
   "alert.cloud.action": "Essayer maintenant",
   "alert.cloud.desc": "Tous les utilisateurs enregistrés reçoivent {{credit}} crédits de calcul gratuits par mois — aucune configuration requise. Inclut la synchronisation cloud mondiale et la recherche web avancée.",
   "alert.cloud.descOnMobile": "Tous les utilisateurs enregistrés reçoivent {{credit}} crédits de calcul gratuits par mois — aucune configuration requise.",

locales/it-IT/common.json

@@ -1,6 +1,9 @@
 {
   "about": "Informazioni",
   "advanceSettings": "Impostazioni avanzate",
+  "agentOnboardingPromo.actionLabel": "Prova ora",
+  "agentOnboardingPromo.description": "Configura i tuoi team di agenti in una breve chat con Lobe AI. I tuoi agenti esistenti resteranno invariati.",
+  "agentOnboardingPromo.title": "Procedura rapida",
   "alert.cloud.action": "Prova ora",
   "alert.cloud.desc": "Tutti gli utenti registrati ricevono {{credit}} crediti di calcolo gratuiti al mese—nessuna configurazione necessaria. Include sincronizzazione cloud globale e ricerca web avanzata.",
   "alert.cloud.descOnMobile": "Tutti gli utenti registrati ricevono {{credit}} crediti di calcolo gratuiti al mese—nessuna configurazione necessaria.",

locales/ja-JP/common.json

@@ -1,6 +1,9 @@
 {
   "about": "情報",
   "advanceSettings": "詳細設定",
+  "agentOnboardingPromo.actionLabel": "今すぐ試す",
+  "agentOnboardingPromo.description": "Lobe AI と短く会話するだけで、エージェントチームを設定できます。既存のエージェントは変更されません。",
+  "agentOnboardingPromo.title": "かんたん設定",
   "alert.cloud.action": "今すぐ試す",
   "alert.cloud.desc": "すべての登録ユーザーは毎月{{credit}}の無料コンピューティングクレジットを受け取れます—設定は不要です。グローバルクラウド同期と高度なウェブ検索が含まれます。",
   "alert.cloud.descOnMobile": "すべての登録ユーザーは毎月{{credit}}の無料コンピューティングクレジットを受け取れます—設定は不要です。",

locales/ko-KR/common.json

@@ -1,6 +1,9 @@
 {
   "about": "정보",
   "advanceSettings": "고급 설정",
+  "agentOnboardingPromo.actionLabel": "지금 사용해 보기",
+  "agentOnboardingPromo.description": "Lobe AI와 짧게 대화하며 에이전트 팀을 설정하세요. 기존 에이전트는 그대로 유지됩니다.",
+  "agentOnboardingPromo.title": "빠른 설정",
   "alert.cloud.action": "지금 체험하기",
   "alert.cloud.desc": "모든 등록된 사용자는 매월 {{credit}}의 무료 컴퓨팅 크레딧을 받을 수 있습니다—설정이 필요하지 않습니다. 전 세계 클라우드 동기화 및 고급 웹 검색 기능이 포함되어 있습니다.",
   "alert.cloud.descOnMobile": "모든 등록된 사용자는 매월 {{credit}}의 무료 컴퓨팅 크레딧을 받을 수 있습니다—설정이 필요하지 않습니다.",

locales/nl-NL/common.json

@@ -1,6 +1,9 @@
 {
   "about": "Over",
   "advanceSettings": "Geavanceerde instellingen",
+  "agentOnboardingPromo.actionLabel": "Nu proberen",
+  "agentOnboardingPromo.description": "Stel je agentteams in via een korte chat met Lobe AI. Je bestaande agenten blijven ongewijzigd.",
+  "agentOnboardingPromo.title": "Snelle wizard",
   "alert.cloud.action": "Probeer nu",
   "alert.cloud.desc": "Alle geregistreerde gebruikers ontvangen {{credit}} gratis computertegoed per maand—geen installatie nodig. Inclusief wereldwijde cloud-synchronisatie en geavanceerd webzoeken.",
   "alert.cloud.descOnMobile": "Alle geregistreerde gebruikers ontvangen {{credit}} gratis computertegoed per maand—geen installatie nodig.",

locales/pl-PL/common.json

@@ -1,6 +1,9 @@
 {
   "about": "O nas",
   "advanceSettings": "Ustawienia zaawansowane",
+  "agentOnboardingPromo.actionLabel": "Wypróbuj teraz",
+  "agentOnboardingPromo.description": "Skonfiguruj swoje zespoły agentów w krótkiej rozmowie z Lobe AI. Twoi obecni agenci pozostaną bez zmian.",
+  "agentOnboardingPromo.title": "Szybki kreator",
   "alert.cloud.action": "Wypróbuj teraz",
   "alert.cloud.desc": "Wszyscy zarejestrowani użytkownicy otrzymują {{credit}} darmowych kredytów obliczeniowych miesięcznie — bez potrzeby konfiguracji. Zawiera globalną synchronizację w chmurze i zaawansowane wyszukiwanie w sieci.",
   "alert.cloud.descOnMobile": "Wszyscy zarejestrowani użytkownicy otrzymują {{credit}} darmowych kredytów obliczeniowych miesięcznie — bez potrzeby konfiguracji.",

locales/pt-BR/common.json

@@ -1,6 +1,9 @@
 {
   "about": "Sobre",
   "advanceSettings": "Configurações Avançadas",
+  "agentOnboardingPromo.actionLabel": "Experimentar agora",
+  "agentOnboardingPromo.description": "Configure suas equipes de agentes em um chat rápido com a Lobe AI. Seus agentes atuais permanecem inalterados.",
+  "agentOnboardingPromo.title": "Assistente rápido",
   "alert.cloud.action": "Experimente agora",
   "alert.cloud.desc": "Todos os usuários registrados recebem {{credit}} créditos de computação gratuitos por mês — sem necessidade de configuração. Inclui sincronização em nuvem global e pesquisa avançada na web.",
   "alert.cloud.descOnMobile": "Todos os usuários registrados recebem {{credit}} créditos de computação gratuitos por mês — sem necessidade de configuração.",

locales/ru-RU/common.json

@@ -1,6 +1,9 @@
 {
   "about": "О проекте",
   "advanceSettings": "Расширенные настройки",
+  "agentOnboardingPromo.actionLabel": "Попробовать",
+  "agentOnboardingPromo.description": "Настройте свои команды агентов в коротком чате с Lobe AI. Ваши существующие агенты останутся без изменений.",
+  "agentOnboardingPromo.title": "Быстрый мастер",
   "alert.cloud.action": "Попробовать сейчас",
   "alert.cloud.desc": "Все зарегистрированные пользователи получают {{credit}} бесплатных вычислительных кредитов в месяц — без необходимости настройки. Включает глобальную синхронизацию и расширенный веб-поиск.",
   "alert.cloud.descOnMobile": "Все зарегистрированные пользователи получают {{credit}} бесплатных вычислительных кредитов в месяц — без необходимости настройки.",

locales/tr-TR/common.json

@@ -1,6 +1,9 @@
 {
   "about": "Hakkında",
   "advanceSettings": "Gelişmiş Ayarlar",
+  "agentOnboardingPromo.actionLabel": "Şimdi dene",
+  "agentOnboardingPromo.description": "Aracı ekiplerinizi Lobe AI ile kısa bir sohbet üzerinden kurun. Mevcut aracılarınız değişmeden kalır.",
+  "agentOnboardingPromo.title": "Hızlı sihirbaz",
   "alert.cloud.action": "Şimdi dene",
   "alert.cloud.desc": "Tüm kayıtlı kullanıcılar her ay {{credit}} ücretsiz işlem kredisi alır—kurulum gerekmez. Küresel bulut senkronizasyonu ve gelişmiş web araması dahildir.",
   "alert.cloud.descOnMobile": "Tüm kayıtlı kullanıcılar her ay {{credit}} ücretsiz işlem kredisi alır—kurulum gerekmez.",

locales/vi-VN/common.json

@@ -1,6 +1,9 @@
 {
   "about": "Giới thiệu",
   "advanceSettings": "Cài đặt nâng cao",
+  "agentOnboardingPromo.actionLabel": "Dùng thử ngay",
+  "agentOnboardingPromo.description": "Thiết lập các nhóm trợ lý của bạn qua một cuộc trò chuyện nhanh với Lobe AI. Các trợ lý hiện có của bạn sẽ không thay đổi.",
+  "agentOnboardingPromo.title": "Trình hướng dẫn nhanh",
   "alert.cloud.action": "Dùng thử ngay",
   "alert.cloud.desc": "Tất cả người dùng đã đăng ký nhận được {{credit}} tín dụng điện toán miễn phí mỗi tháng—không cần cài đặt. Bao gồm đồng bộ đám mây toàn cầu và tìm kiếm web nâng cao.",
   "alert.cloud.descOnMobile": "Tất cả người dùng đã đăng ký nhận được {{credit}} tín dụng điện toán miễn phí mỗi tháng—không cần cài đặt.",

locales/zh-CN/chat.json

@@ -18,6 +18,7 @@
   "agentDefaultMessage": "你好，我是 **{{name}}**。从一句话开始就行。\n\n想让我更贴近你的工作方式：去 [助理设置]({{url}}) 补充助理档案（随时可改）",
   "agentDefaultMessageWithSystemRole": "你好，我是 **{{name}}**。从一句话开始就行——决定权在你",
   "agentDefaultMessageWithoutEdit": "你好，我是 **{{name}}**。从一句话开始就行——决定权在你",
+  "agentSidebar.externalTag": "外部",
   "agents": "助理",
   "artifact.generating": "生成中",
   "artifact.inThread": "子话题中暂不支持查看。请回到主对话区打开",
@@ -123,6 +124,7 @@
   "groupWizard.searchTemplates": "搜索模板…",
   "groupWizard.title": "创建群组",
   "groupWizard.useTemplate": "使用模板",
+  "heteroAgent.resumeReset.cwdChanged": "工作目录已切换，之前的 Claude Code 会话只能在原目录下继续，已开始新对话。",
   "hideForYou": "私信内容已隐藏。可在设置中开启「显示私信内容」查看",
   "history.title": "助理将仅保留最近 {{count}} 条消息",
   "historyRange": "历史范围",
@@ -223,6 +225,7 @@
   "minimap.senderAssistant": "助理",
   "minimap.senderUser": "你",
   "newAgent": "创建助理",
+  "newClaudeCodeAgent": "添加 Claude Code",
   "newGroupChat": "创建群组",
   "newPage": "创建文稿",
   "noAgentsYet": "这个群组还没有成员。点击「+」邀请助理加入",
@@ -234,6 +237,7 @@
   "operation.contextCompression": "上下文过长，正在压缩历史记录……",
   "operation.execAgentRuntime": "准备响应中",
   "operation.execClientTask": "执行任务中",
+  "operation.execHeterogeneousAgent": "智能体运行中",
   "operation.execServerAgentRuntime": "任务正在服务器运行，您可以放心离开此页面",
   "operation.sendMessage": "消息发送中",
   "owner": "群主",
@@ -418,6 +422,15 @@
   "tool.intervention.mode.autoRunDesc": "自动批准所有技能调用",
   "tool.intervention.mode.manual": "手动批准",
   "tool.intervention.mode.manualDesc": "每次调用都需要你确认",
+  "tool.intervention.onboarding.agentIdentity.applyHint": "批准后生效。",
+  "tool.intervention.onboarding.agentIdentity.description": "批准后，会同步更新 Inbox 中显示的 Agent，以及当前 onboarding 对话里的 Agent。",
+  "tool.intervention.onboarding.agentIdentity.emoji": "Agent 头像",
+  "tool.intervention.onboarding.agentIdentity.eyebrow": "Onboarding 审批",
+  "tool.intervention.onboarding.agentIdentity.name": "Agent 名称",
+  "tool.intervention.onboarding.agentIdentity.targetInbox": "Inbox Agent",
+  "tool.intervention.onboarding.agentIdentity.targetOnboarding": "当前 onboarding Agent",
+  "tool.intervention.onboarding.agentIdentity.targets": "应用范围",
+  "tool.intervention.onboarding.agentIdentity.title": "确认 Agent 名称与头像",
   "tool.intervention.pending": "等待中",
   "tool.intervention.reject": "拒绝",
   "tool.intervention.rejectAndContinue": "拒绝后继续",
@@ -467,6 +480,9 @@
   "viewMode.wideScreen": "宽屏",
   "workflow.awaitingConfirmation": "需要你确认",
   "workflow.failedSuffix": "（失败）",
+  "workflow.summaryFailed": "{{count}} 次失败",
+  "workflow.summaryMoreTools": "等 {{count}} 种工具",
+  "workflow.summaryTotalCalls": "共 {{count}} 次调用",
   "workflow.thoughtForDuration": "思考了 {{duration}}",
   "workflow.toolDisplayName.activateDevice": "激活了设备",
   "workflow.toolDisplayName.activateSkill": "启用了技能",
@@ -540,33 +556,38 @@
   "workflow.toolDisplayName.upsertDocumentByFilename": "更新了文档",
   "workflow.toolDisplayName.writeLocalFile": "写入了文件",
   "workflow.working": "处理中...",
-  "workingPanel.agentDocuments": "助理文档",
+  "workingPanel.agentDocuments": "代理文档",
   "workingPanel.documents.close": "关闭",
-  "workingPanel.documents.discard": "放弃更改",
+  "workingPanel.documents.discard": "放弃",
   "workingPanel.documents.edit": "编辑",
   "workingPanel.documents.error": "文档加载失败",
-  "workingPanel.documents.loading": "文档加载中...",
+  "workingPanel.documents.loading": "文档加载中…",
   "workingPanel.documents.preview": "预览",
   "workingPanel.documents.save": "保存",
-  "workingPanel.documents.saved": "所有更改已保存",
+  "workingPanel.documents.saved": "已保存全部变更",
   "workingPanel.documents.title": "文档",
-  "workingPanel.documents.unsaved": "有未保存更改",
+  "workingPanel.documents.unsaved": "有未保存的变更",
   "workingPanel.progress": "进度",
-  "workingPanel.progress.allCompleted": "全部任务已完成",
+  "workingPanel.progress.allCompleted": "所有任务已完成",
   "workingPanel.resources": "资源",
-  "workingPanel.resources.deleteConfirm": "此操作无法撤销。",
-  "workingPanel.resources.deleteError": "删除文档失败",
+  "workingPanel.resources.deleteConfirm": "该操作无法撤销。",
+  "workingPanel.resources.deleteError": "删除失败",
   "workingPanel.resources.deleteSuccess": "文档已删除",
-  "workingPanel.resources.deleteTitle": "删除文档？",
-  "workingPanel.resources.empty": "暂无助理文档",
+  "workingPanel.resources.deleteTitle": "删除该文档？",
+  "workingPanel.resources.empty": "暂无文档，当前 agent 关联的文档将会显示在这里",
   "workingPanel.resources.error": "资源加载失败",
-  "workingPanel.resources.loading": "资源加载中...",
+  "workingPanel.resources.filter.all": "全部",
+  "workingPanel.resources.filter.documents": "文档",
+  "workingPanel.resources.filter.web": "网页",
+  "workingPanel.resources.loading": "资源加载中…",
   "workingPanel.resources.previewError": "预览加载失败",
-  "workingPanel.resources.previewLoading": "预览加载中...",
+  "workingPanel.resources.previewLoading": "预览加载中…",
   "workingPanel.resources.renameEmpty": "标题不能为空",
-  "workingPanel.resources.renameError": "重命名文档失败",
-  "workingPanel.resources.renameSuccess": "文档已重命名",
-  "workingPanel.title": "Working Panel",
+  "workingPanel.resources.renameError": "重命名失败",
+  "workingPanel.resources.renameSuccess": "重命名成功",
+  "workingPanel.resources.viewMode.list": "列表视图",
+  "workingPanel.resources.viewMode.tree": "目录视图",
+  "workingPanel.title": "工作面板",
   "you": "你",
   "zenMode": "专注模式"
 }

locales/zh-CN/common.json

@@ -1,6 +1,9 @@
 {
   "about": "关于",
   "advanceSettings": "高级设置",
+  "agentOnboardingPromo.actionLabel": "立即体验",
+  "agentOnboardingPromo.description": "与 Lobe AI 快速聊几句，即可设置你的助理团队。你现有的助理不会受到影响。",
+  "agentOnboardingPromo.title": "快速向导",
   "alert.cloud.action": "立即体验",
   "alert.cloud.desc": "所有注册用户每月可获得 {{credit}} 免费计算额度—无需设置。包括全球云同步和高级网页搜索功能。",
   "alert.cloud.descOnMobile": "所有注册用户每月可获得 {{credit}} 免费计算额度—无需设置。",

locales/zh-CN/electron.json

@@ -133,5 +133,7 @@
   "window.close": "关闭窗口",
   "window.maximize": "最大化窗口",
   "window.minimize": "最小化窗口",
-  "window.restore": "恢复窗口"
+  "window.pinToTop": "窗口置顶",
+  "window.restore": "恢复窗口",
+  "window.unpinFromTop": "取消置顶"
 }

locales/zh-CN/file.json

@@ -90,6 +90,31 @@
   "pageEditor.exportDialogTitle": "导出页面",
   "pageEditor.exportError": "页面导出失败",
   "pageEditor.exportSuccess": "页面导出成功",
+  "pageEditor.history.backToCopilot": "返回 Copilot",
+  "pageEditor.history.compare": "对比",
+  "pageEditor.history.compareCurrentLabel": "当前",
+  "pageEditor.history.compareDescription": "对比当前内容与所选历史状态",
+  "pageEditor.history.compareError": "加载差异预览失败",
+  "pageEditor.history.compareModalTitle": "对比",
+  "pageEditor.history.compareOldLabel": "回退到",
+  "pageEditor.history.compareTitle": "版本差异",
+  "pageEditor.history.current": "当前版本",
+  "pageEditor.history.dayLabel.today": "今天",
+  "pageEditor.history.dayLabel.yesterday": "昨天",
+  "pageEditor.history.empty": "还没有可用的历史版本",
+  "pageEditor.history.itemVersionLabel": "v{{version}}",
+  "pageEditor.history.restore": "恢复",
+  "pageEditor.history.restoreConfirm.content": "确定恢复到 {{savedAt}} 保存的内容吗？当前文稿将被替换并保存。",
+  "pageEditor.history.restoreConfirm.title": "从历史恢复",
+  "pageEditor.history.restoreError": "恢复失败",
+  "pageEditor.history.saveSource.autosave": "自动保存",
+  "pageEditor.history.saveSource.manual": "手动保存",
+  "pageEditor.history.saveSource.restore": "恢复",
+  "pageEditor.history.saveSource.system": "系统",
+  "pageEditor.history.title": "版本历史",
+  "pageEditor.history.versionCount_one": "共 {{count}} 个版本",
+  "pageEditor.history.versionCount_other": "共 {{count}} 个版本",
+  "pageEditor.history.versionLabel": "v{{version}}",
   "pageEditor.linkCopied": "链接已复制",
   "pageEditor.menu.copyLink": "复制链接",
   "pageEditor.menu.export": "导出",

locales/zh-CN/labs.json

@@ -1,4 +1,6 @@
 {
+  "features.agentWorkingPanel.desc": "在会话中查看当前助理可访问的资源和任务进度。",
+  "features.agentWorkingPanel.title": "工作面板",
   "features.assistantMessageGroup.desc": "将代理消息及其工具调用结果组合在一起显示",
   "features.assistantMessageGroup.title": "代理消息分组",
   "features.gatewayMode.desc": "通过 Gateway 在服务端执行 Agent 任务。可实现关闭浏览器后仍然执行 agent。",

locales/zh-CN/modelProvider.json

@@ -230,6 +230,7 @@
   "providerModels.item.modelConfig.extendParams.options.imageAspectRatio2.hint": "适用于 Nano Banana 2；控制生成图像的宽高比（支持超宽 1:4、4:1、1:8、8:1）。",
   "providerModels.item.modelConfig.extendParams.options.imageResolution.hint": "适用于 Gemini 3 图像生成模型；控制生成图像的分辨率。",
   "providerModels.item.modelConfig.extendParams.options.imageResolution2.hint": "适用于 Gemini 3.1 Flash Image 模型；控制生成图像的分辨率（支持 512px）。",
+  "providerModels.item.modelConfig.extendParams.options.opus47Effort.hint": "适用于 Claude Opus 4.7；控制努力程度（低/中/高/超高/最大）。",
   "providerModels.item.modelConfig.extendParams.options.reasoningBudgetToken.hint": "适用于 Claude、Qwen3 等模型；控制用于推理的 Token 预算。",
   "providerModels.item.modelConfig.extendParams.options.reasoningBudgetToken32k.hint": "适用于GLM-5和GLM-4.7；控制推理的令牌预算（最大32k）。",
   "providerModels.item.modelConfig.extendParams.options.reasoningBudgetToken80k.hint": "适用于Qwen3系列；控制推理的令牌预算（最大80k）。",

locales/zh-CN/notification.json

@@ -1,4 +1,6 @@
 {
+  "billboard.learnMore": "了解更多",
+  "billboard.menuLabel": "公告",
   "inbox.archiveAll": "全部归档",
   "inbox.empty": "暂无通知",
   "inbox.emptyUnread": "没有未读通知",

locales/zh-CN/onboarding.json

@@ -51,6 +51,11 @@
   "agent.welcome.sentence.1": "很高兴认识你！让我们互相了解一下吧。",
   "agent.welcome.sentence.2": "你希望我成为怎样的伙伴？",
   "agent.welcome.sentence.3": "先给我起个名字吧 :)",
+  "agent.wrapUp.action": "先这样吧",
+  "agent.wrapUp.confirm.cancel": "再聊聊",
+  "agent.wrapUp.confirm.content": "目前了解到的信息我都会保存，你随时都可以回来继续和我聊。",
+  "agent.wrapUp.confirm.ok": "结束引导",
+  "agent.wrapUp.confirm.title": "现在结束引导吗？",
   "back": "上一步",
   "finish": "开始使用",
   "interests.area.business": "商业与战略",

locales/zh-CN/plugin.json

@@ -30,6 +30,7 @@
   "builtins.lobe-agent-documents.apiName.createDocument": "创建文档",
   "builtins.lobe-agent-documents.apiName.editDocument": "编辑文档",
   "builtins.lobe-agent-documents.apiName.listDocuments": "列出文档",
+  "builtins.lobe-agent-documents.apiName.patchDocument": "修订文档",
   "builtins.lobe-agent-documents.apiName.readDocument": "读取文档",
   "builtins.lobe-agent-documents.apiName.readDocumentByFilename": "按文件名读取文档",
   "builtins.lobe-agent-documents.apiName.removeDocument": "删除文档",
@@ -64,6 +65,9 @@
   "builtins.lobe-agent-management.render.installPlugin.plugin": "插件",
   "builtins.lobe-agent-management.render.installPlugin.success": "安装成功",
   "builtins.lobe-agent-management.title": "代理管理器",
+  "builtins.lobe-claude-code.todoWrite.allDone": "全部任务已完成",
+  "builtins.lobe-claude-code.todoWrite.currentStep": "当前步骤",
+  "builtins.lobe-claude-code.todoWrite.todos": "待办",
   "builtins.lobe-cloud-sandbox.apiName.editLocalFile": "编辑文件",
   "builtins.lobe-cloud-sandbox.apiName.executeCode": "执行代码",
   "builtins.lobe-cloud-sandbox.apiName.exportFile": "导出文件",
@@ -431,18 +435,34 @@
   "loading.plugin": "技能运行中…",
   "localSystem.workingDirectory.agentDescription": "该助手下所有对话的默认工作目录",
   "localSystem.workingDirectory.agentLevel": "代理工作目录",
+  "localSystem.workingDirectory.branchSearchPlaceholder": "搜索分支",
+  "localSystem.workingDirectory.branchesEmpty": "暂无本地分支",
+  "localSystem.workingDirectory.branchesHeading": "分支",
+  "localSystem.workingDirectory.branchesLoading": "加载分支中…",
+  "localSystem.workingDirectory.branchesNoMatch": "没有匹配的分支",
+  "localSystem.workingDirectory.cancel": "取消",
+  "localSystem.workingDirectory.checkoutAction": "切换分支",
+  "localSystem.workingDirectory.checkoutFailed": "切换分支失败",
   "localSystem.workingDirectory.chooseDifferentFolder": "选择其他文件夹",
+  "localSystem.workingDirectory.createBranchAction": "检出新分支…",
   "localSystem.workingDirectory.current": "当前工作目录",
+  "localSystem.workingDirectory.detachedHead": "游离 HEAD，当前提交 {{sha}}",
+  "localSystem.workingDirectory.ghMissing": "安装并登录 GitHub CLI（gh）即可显示关联的 Pull Request",
+  "localSystem.workingDirectory.newBranchPlaceholder": "feature/新分支名称",
   "localSystem.workingDirectory.noRecent": "暂无最近目录",
   "localSystem.workingDirectory.notSet": "点击设置工作目录",
   "localSystem.workingDirectory.placeholder": "输入目录路径，如 /Users/name/projects",
+  "localSystem.workingDirectory.prTooltipWithExtra": "{{title}}（此分支还有 {{count}} 个开放 PR）",
   "localSystem.workingDirectory.recent": "最近使用",
+  "localSystem.workingDirectory.refreshGitStatus": "刷新分支与 PR 状态",
   "localSystem.workingDirectory.removeRecent": "从最近目录中移除",
   "localSystem.workingDirectory.selectFolder": "选择文件夹",
   "localSystem.workingDirectory.title": "工作目录",
   "localSystem.workingDirectory.topicDescription": "仅覆盖当前对话的工作目录",
   "localSystem.workingDirectory.topicLevel": "对话覆盖",
   "localSystem.workingDirectory.topicOverride": "为当前对话覆盖设置",
+  "localSystem.workingDirectory.uncommittedChanges_one": "未提交的更改：{{count}} 个文件",
+  "localSystem.workingDirectory.uncommittedChanges_other": "未提交的更改：{{count}} 个文件",
   "mcpEmpty.deployment": "暂无部署选项",
   "mcpEmpty.prompts": "该技能暂无提示词",
   "mcpEmpty.resources": "该技能暂无资源",

locales/zh-CN/setting.json

@@ -191,6 +191,11 @@
   "analytics.telemetry.desc": "通过匿名使用数据帮助我们改进 {{appName}}",
   "analytics.telemetry.title": "发送匿名使用数据",
   "analytics.title": "数据统计",
+  "ccStatus.account.label": "账号",
+  "ccStatus.detecting": "正在检测 Claude Code CLI…",
+  "ccStatus.redetect": "重新检测",
+  "ccStatus.title": "Claude Code CLI",
+  "ccStatus.unavailable": "未检测到 Claude Code CLI，请先安装或配置",
   "checking": "检查中…",
   "checkingPermissions": "检查权限中…",
   "creds.actions.delete": "删除",
@@ -659,6 +664,8 @@
   "settingSystemTools.appEnvironment.title": "内建应用工具",
   "settingSystemTools.category.browserAutomation": "浏览器自动化",
   "settingSystemTools.category.browserAutomation.desc": "用于无头浏览器自动化和网页交互的工具",
+  "settingSystemTools.category.cliAgents": "CLI 智能体",
+  "settingSystemTools.category.cliAgents.desc": "已检测到的命令行编码智能体，如 Claude Code、Codex、Kimi 等",
   "settingSystemTools.category.contentSearch": "内容搜索",
   "settingSystemTools.category.contentSearch.desc": "用于在文件内搜索文本内容的工具",
   "settingSystemTools.category.fileSearch": "文件搜索",
@@ -673,17 +680,23 @@
   "settingSystemTools.title": "系统工具",
   "settingSystemTools.tools.ag.desc": "The Silver Searcher - 快速代码搜索工具",
   "settingSystemTools.tools.agentBrowser.desc": "Agent-browser - 面向AI代理的无头浏览器自动化命令行工具",
+  "settingSystemTools.tools.aider.desc": "Aider - 终端内的 AI 结对编程工具",
   "settingSystemTools.tools.bun.desc": "Bun - 快速的 JavaScript 运行时和包管理器",
   "settingSystemTools.tools.bunx.desc": "bunx - Bun 包执行器，用于运行 npm 包",
+  "settingSystemTools.tools.claude.desc": "Claude Code - Anthropic 官方命令行编码智能体",
+  "settingSystemTools.tools.codex.desc": "Codex - OpenAI 命令行编码智能体",
   "settingSystemTools.tools.fd.desc": "fd - 快速且用户友好的 find 替代品",
   "settingSystemTools.tools.find.desc": "Unix find - 标准文件搜索命令",
+  "settingSystemTools.tools.gemini.desc": "Gemini CLI - Google 命令行编码智能体",
   "settingSystemTools.tools.grep.desc": "GNU grep - 标准文本搜索工具",
+  "settingSystemTools.tools.kimi.desc": "Kimi CLI - 月之暗面命令行编码智能体",
   "settingSystemTools.tools.lobehub.desc": "LobeHub CLI - 管理和连接 LobeHub 服务",
   "settingSystemTools.tools.mdfind.desc": "macOS 聚焦搜索（快速索引搜索）",
   "settingSystemTools.tools.node.desc": "Node.js - 执行 JavaScript/TypeScript 的运行时",
   "settingSystemTools.tools.npm.desc": "npm - Node.js 包管理器，用于安装依赖",
   "settingSystemTools.tools.pnpm.desc": "pnpm - 快速、节省磁盘空间的包管理器",
   "settingSystemTools.tools.python.desc": "Python - 编程语言运行时",
+  "settingSystemTools.tools.qwen.desc": "Qwen Code - 阿里通义千问命令行编码智能体",
   "settingSystemTools.tools.rg.desc": "ripgrep - 极快的文本搜索工具",
   "settingSystemTools.tools.uv.desc": "uv - 极快的 Python 包管理器",
   "settingTTS.openai.sttModel": "OpenAI 语音识别模型",

locales/zh-CN/topic.json

@@ -4,6 +4,12 @@
   "actions.confirmRemoveAll": "您即将删除所有话题，此操作无法撤销。",
   "actions.confirmRemoveTopic": "您即将删除此话题，此操作无法撤销。",
   "actions.confirmRemoveUnstarred": "您即将删除未加星标的话题，此操作无法撤销。",
+  "actions.copyLink": "复制链接",
+  "actions.copyLinkSuccess": "链接已复制",
+  "actions.copySessionId": "复制会话 ID",
+  "actions.copySessionIdSuccess": "会话 ID 已复制",
+  "actions.copyWorkingDirectory": "复制工作目录",
+  "actions.copyWorkingDirectorySuccess": "工作目录已复制",
   "actions.duplicate": "复制",
   "actions.export": "导出话题",
   "actions.favorite": "收藏",
@@ -18,11 +24,14 @@
   "duplicateLoading": "话题复制中…",
   "duplicateSuccess": "话题复制成功",
   "favorite": "收藏",
-  "groupMode.ascMessages": "按消息总数顺序",
-  "groupMode.byTime": "按创建时间分组",
-  "groupMode.byUpdatedTime": "按编辑时间分组",
-  "groupMode.descMessages": "按消息总数倒序",
-  "groupMode.flat": "不分组",
+  "filter.groupMode.byProject": "按项目",
+  "filter.groupMode.byTime": "按时间阶段",
+  "filter.groupMode.flat": "平铺",
+  "filter.organize": "整理",
+  "filter.sort": "排序",
+  "filter.sortBy.createdAt": "按创建时间",
+  "filter.sortBy.updatedAt": "按更新时间",
+  "groupTitle.byProject.noProject": "无目录",
   "groupTitle.byTime.month": "本月",
   "groupTitle.byTime.today": "今天",
   "groupTitle.byTime.week": "本周",
@@ -33,7 +42,13 @@
   "importInvalidFormat": "文件格式不正确。请确认这是有效的 JSON 文件",
   "importLoading": "正在导入对话…",
   "importSuccess": "已导入 {{count}} 条消息",
+  "inPopup.description": "此话题已在独立窗口中打开，请前往该窗口继续对话以保持消息一致。",
+  "inPopup.focus": "聚焦独立窗口",
+  "inPopup.title": "已在独立窗口中打开",
   "loadMore": "更多",
+  "newTopic": "新话题",
+  "renameModal.description": "保持简短且易于识别。",
+  "renameModal.title": "重命名话题",
   "searchPlaceholder": "搜索话题…",
   "searchResultEmpty": "暂无搜索结果",
   "temp": "临时",

locales/zh-TW/common.json

@@ -1,6 +1,9 @@
 {
   "about": "關於",
   "advanceSettings": "進階設定",
+  "agentOnboardingPromo.actionLabel": "立即試用",
+  "agentOnboardingPromo.description": "和 Lobe AI 快速聊幾句，即可設定你的助理團隊。你現有的助理不會受到影響。",
+  "agentOnboardingPromo.title": "快速嚮導",
   "alert.cloud.action": "免費體驗",
   "alert.cloud.desc": "所有註冊用戶每月可獲得 {{credit}} 免費運算點數—無需設定。包含全球雲端同步與進階網頁搜尋功能。",
   "alert.cloud.descOnMobile": "所有註冊用戶每月可獲得 {{credit}} 免費運算點數—無需設定。",

packages/builtin-agents/src/agents/web-onboarding/systemRole.ts

@@ -37,7 +37,7 @@ You just "woke up" with no name or personality. Discover who you are through con
 - Keep this phase friendly and low-pressure, especially for older or non-technical users.
 - Once the user settles on a name:
   1. Call saveUserQuestion with agentName and agentEmoji.
-  2. Call updateDocument to write SOUL.md with your name, creature/nature, vibe, and emoji.
+  2. Persist SOUL.md: if empty use writeDocument(type="soul") for the initial write; if already non-empty use updateDocument(type="soul") to amend only the changed lines.
 - Offer a short emoji choice list when helpful.
 - Transition naturally to learning about the user.
 
@@ -46,9 +46,13 @@ You just "woke up" with no name or personality. Discover who you are through con
 You know who you are. Now learn who the user is.
 
 - If the user already shared their name earlier in the conversation, acknowledge it — do not ask again. Otherwise, ask how they would like to be addressed.
-- Call saveUserQuestion with fullName when learned (whether from this phase or recalled from earlier).
+- **You MUST call saveUserQuestion with fullName before leaving this phase.** The phase will not advance until fullName is saved — if you skip this, the user gets stuck in user_identity indefinitely.
+- Call saveUserQuestion with fullName the turn you learn the name (whether from this phase or recalled from earlier). Do NOT wait until role is also known.
+- Prefer the name they naturally offer, including nicknames, handles, or any identifier they used to introduce themselves (e.g. when proposing your name). Save it as fullName immediately — do not wait for a "formal" name.
+- If the user's response about their name is ambiguous (e.g. "哈哈没有啦", "随便", "not really"), do NOT silently drop the question and move on. Ask exactly once more, directly: "那我该怎么称呼你？" / "What should I call you then?" — then save whatever they answer, even if it's a nickname or placeholder.
+- Only if the user explicitly refuses to give any name after one clarifying ask, save a sensible fallback (e.g. the handle they used earlier, or "朋友" / "friend") and proceed.
+- **Seed the persona document as soon as you have ANY useful fact** — just a name, just a role, or both. Call writeDocument(type="persona") with a short initial draft containing whatever you know so far (even a single line). A tiny seeded persona is better than an empty one. Do not defer seeding until discovery is over.
 - Begin the persona document with their role and basic context.
-- Prefer the name they naturally offer, including nicknames.
 - Transition by showing curiosity about their daily work.
 
 ### Phase 3: Discovery (phase: "discovery")
@@ -74,7 +78,7 @@ Guidelines:
 - Discover their interests and preferred response language naturally.
 - Do NOT call saveUserQuestion with interests until you have covered at least 3–4 different dimensions above. Saving interests too early will reduce conversation quality.
 - Call saveUserQuestion for interests and responseLanguage only after sufficient exploration.
-- Update the persona document as you learn more — start from the initial read, merge new information in memory, then write the full content.
+- **Persist each new fact on the turn you learn it.** Do NOT accumulate unwritten facts in memory waiting to do one big write at the end — that pattern is forbidden. If Persona is empty, call writeDocument(type="persona") this turn to seed it. On every subsequent turn where you learn something new (role, pain point, goal, preference, interest), call updateDocument(type="persona") with a targeted SEARCH/REPLACE hunk. Small incremental updates are the rule, not the exception.
 - This phase should feel like a good first conversation, not an interview.
 - Avoid broad topics like tech stack, team size, or toolchains unless the user actually works in that world.
 - Keep your replies short during discovery — 2-4 sentences plus one follow-up question. Do not monologue.
@@ -89,7 +93,22 @@ Wrap up with a natural summary and set up the user's workspace.
 - You (the main agent) keep the generalist role: daily chat, planning, motivation, general questions. The proposed assistants handle specialized recurring tasks.
 - Ask the user if they want you to create these assistants. After confirmation, create them using the workspace setup tools. When creating agents, always include an emoji avatar.
 - Keep the setup simple — usually 1–2 assistants is enough. Do not over-provision.
-- After creating assistants (or if the user declines), do NOT immediately call finishOnboarding. First, send a warm closing message — acknowledge what you learned about the user, express genuine interest in working together, and give a brief teaser of what they can do next (e.g., "you can find your new assistants in the sidebar" or "just come chat with me anytime"). Keep it natural and human, 2–3 sentences. Then call finishOnboarding.
+- After creating assistants (or if the user declines), do NOT immediately call finishOnboarding. First, send a warm closing message — acknowledge what you learned about the user, express genuine interest in working together, and give a brief teaser of what they can do next (e.g., "you can find your new assistants in the sidebar" or "just come chat with me anytime"). Keep it natural and human, 2–3 sentences. Then run the Pre-Finish Checklist and call finishOnboarding.
+
+## Pre-Finish Checklist
+
+Before EVERY finishOnboarding call (normal completion or early exit), you MUST verify the session has been persisted. Skipping this means the whole conversation was wasted — the user's info never lands in their workspace.
+
+Mandatory ordered sequence:
+
+1. Recall: mentally list every meaningful fact learned this session — agentName/emoji, fullName, role, pain points, goals, interests, personality, preferred language, and any assistants proposed or created.
+2. Inspect the auto-injected \`<current_soul_document>\` and \`<current_user_persona>\` tags in your context. Do NOT call readDocument — the current contents are already present.
+3. Diff: for each item from step 1, is it reflected in the appropriate document?
+4. If SOUL.md is missing agent identity / voice / personality → **updateDocument(type="soul")** with SEARCH/REPLACE hunks for only the changed lines. Use writeDocument(type="soul") ONLY if the current document is empty or a full structural rewrite is needed.
+5. If Persona is missing user facts → **updateDocument(type="persona")** with targeted hunks. Use writeDocument(type="persona") ONLY for an empty doc or full rewrite.
+6. Only after both documents reflect the session, call finishOnboarding.
+
+**Always prefer updateDocument (SEARCH/REPLACE hunks)** — it is cheaper, safer, and less error-prone than rewriting the entire document via writeDocument. Fall back to writeDocument only when the document is empty or when more than half the content must change.
 
 ## Early Exit
 
@@ -101,8 +120,7 @@ When you detect a completion signal:
 1. Stop asking questions immediately. Do NOT ask follow-up questions.
 2. If you haven't shown a summary yet, give a brief one now.
 3. Call saveUserQuestion with whatever fields you have collected (even if incomplete).
-4. Call updateDocument for both SOUL.md and User Persona with whatever you know.
-5. Call finishOnboarding. This is non-negotiable — the user must not be kept waiting.
+4. Run the Pre-Finish Checklist (read → diff → patch/update → finishOnboarding). This is non-negotiable — the user must not be kept waiting, but empty docs are worse than a short delay.
 
 - Keep the farewell short. They should feel welcome to come back, not held hostage.
 

packages/builtin-tool-activator/src/manifest.ts

@@ -25,28 +25,12 @@ export const LobeActivatorManifest: BuiltinToolManifest = {
         type: 'object',
       },
     },
-    {
-      description:
-        'Activate a skill by name to load its instructions. Skills are reusable instruction packages that extend your capabilities. Returns the skill content that you should follow to complete the task. If the skill is not found, returns a list of available skills.',
-      humanIntervention: 'required',
-      name: ActivatorApiName.activateSkill,
-      parameters: {
-        properties: {
-          name: {
-            description: 'The exact name of the skill to activate.',
-            type: 'string',
-          },
-        },
-        required: ['name'],
-        type: 'object',
-      },
-    },
   ],
   identifier: LobeActivatorIdentifier,
   meta: {
     avatar: '🔧',
-    description: 'Discover and activate tools and skills',
-    title: 'Tools & Skills Activator',
+    description: 'Discover and activate tools',
+    title: 'Tools Activator',
   },
   systemRole: systemPrompt,
   type: 'builtin',

packages/builtin-tool-activator/src/systemRole.ts

@@ -1,4 +1,4 @@
-export const systemPrompt = `You have access to a Tools & Skills Activator that allows you to dynamically activate tools and skills on demand. Not all tools are loaded by default — you must activate them before use. Skills are reusable instruction packages that extend your capabilities.
+export const systemPrompt = `You have access to a Tools Activator that allows you to dynamically activate tools on demand. Not all tools are loaded by default — you must activate them before use.
 
 <how_it_works>
 1. Available tools are listed in the \`<available_tools>\` section of your system prompt
@@ -6,7 +6,7 @@ export const systemPrompt = `You have access to a Tools & Skills Activator that
 3. To use a tool, first call \`activateTools\` with the tool identifiers you need
 4. After activation, the tool's full API schemas become available as native function calls in subsequent turns
 5. You can activate multiple tools at once by passing multiple identifiers
-6. To activate a skill, call \`activateSkill\` with the skill name — it returns instructions to follow
+6. To activate a skill, use the \`activateSkill\` tool from lobe-skills — it returns instructions to follow
 </how_it_works>
 
 <tool_selection_guidelines>
@@ -16,10 +16,7 @@ export const systemPrompt = `You have access to a Tools & Skills Activator that
   - After activation, the tools' APIs will be available for you to call directly
   - Tools that are already active will be noted in the response
   - If an identifier is not found, it will be reported in the response
-- **activateSkill**: Call this when the user's task matches one of the available skills
-  - Provide the exact skill name
-  - Returns the skill content (instructions, templates, guidelines) that you should follow
-  - If the skill is not found, you'll receive a list of available skills
+- **activateSkill** (provided by lobe-skills): Use this when the user's task matches one of the available skills
   - **IMPORTANT**: If a skill's content is already provided in \`<selected_skill_context>\` within the user message, do NOT call activateSkill for that skill — its instructions are already loaded and ready to use
 </tool_selection_guidelines>
 

packages/builtin-tool-agent-documents/package.json

@@ -9,7 +9,18 @@
     "./executionRuntime": "./src/ExecutionRuntime/index.ts"
   },
   "main": "./src/index.ts",
+  "dependencies": {
+    "@lobechat/markdown-patch": "workspace:*"
+  },
   "devDependencies": {
     "@lobechat/types": "workspace:*"
+  },
+  "peerDependencies": {
+    "@lobehub/ui": "^5",
+    "antd": "^6",
+    "antd-style": "*",
+    "lucide-react": "*",
+    "react": "*",
+    "react-i18next": "*"
   }
 }

packages/builtin-tool-agent-documents/src/ExecutionRuntime/index.ts

@@ -1,3 +1,4 @@
+import { applyMarkdownPatch, formatMarkdownPatchError } from '@lobechat/markdown-patch';
 import type { BuiltinServerRuntimeOutput } from '@lobechat/types';
 
 import type {
@@ -5,6 +6,7 @@ import type {
   CreateDocumentArgs,
   EditDocumentArgs,
   ListDocumentsArgs,
+  PatchDocumentArgs,
   ReadDocumentArgs,
   ReadDocumentByFilenameArgs,
   RemoveDocumentArgs,
@@ -15,7 +17,18 @@ import type {
 
 interface AgentDocumentRecord {
   content?: string;
+  /**
+   * The underlying `documents` table id. Used for portal rendering
+   * (opening the document in the shared EditorCanvas), which must resolve
+   * the row in `documents` — distinct from `id` which is the
+   * `agentDocuments` association row id.
+   */
+  documentId?: string;
   filename?: string;
+  /**
+   * The `agentDocuments` association row id. This is what the LLM receives
+   * and uses for subsequent operations (read/edit/remove/...).
+   */
   id: string;
   title?: string;
 }
@@ -172,7 +185,7 @@ export class AgentDocumentsExecutionRuntime {
 
     return {
       content: `Created document "${created.title || args.title}" (${created.id}).`,
-      state: { documentId: created.id },
+      state: { documentId: created.documentId },
       success: true,
     };
   }
@@ -221,6 +234,46 @@ export class AgentDocumentsExecutionRuntime {
     };
   }
 
+  async patchDocument(
+    args: PatchDocumentArgs,
+    context?: AgentDocumentOperationContext,
+  ): Promise<BuiltinServerRuntimeOutput> {
+    const agentId = this.resolveAgentId(context);
+    if (!agentId) {
+      return {
+        content: 'Cannot patch agent document without agentId context.',
+        success: false,
+      };
+    }
+
+    const doc = await this.service.readDocument({ agentId, id: args.id });
+    if (!doc) return { content: `Document not found: ${args.id}`, success: false };
+
+    const patched = applyMarkdownPatch(doc.content ?? '', args.hunks);
+    if (!patched.ok) {
+      const message = formatMarkdownPatchError(patched.error);
+      return {
+        content: message,
+        error: { body: patched.error, message, type: patched.error.code },
+        state: { error: patched.error, id: args.id },
+        success: false,
+      };
+    }
+
+    const updated = await this.service.editDocument({
+      agentId,
+      content: patched.content,
+      id: args.id,
+    });
+    if (!updated) return { content: `Failed to patch document ${args.id}.`, success: false };
+
+    return {
+      content: `Patched document ${args.id}. Applied ${patched.applied} hunk(s).`,
+      state: { applied: patched.applied, id: args.id, patched: true },
+      success: true,
+    };
+  }
+
   async removeDocument(
     args: RemoveDocumentArgs,
     context?: AgentDocumentOperationContext,

packages/builtin-tool-agent-documents/src/client/Inspector/AgentDocumentsInspector/index.tsx

@@ -1,118 +0,0 @@
-'use client';
-
-import type { BuiltinInspectorProps } from '@lobechat/types';
-import { cx } from 'antd-style';
-import { memo } from 'react';
-import { useTranslation } from 'react-i18next';
-
-import { highlightTextStyles, inspectorTextStyles, shinyTextStyles } from '@/styles';
-
-import {
-  AgentDocumentsApiName,
-  type CopyDocumentArgs,
-  type CreateDocumentArgs,
-  type EditDocumentArgs,
-  type ReadDocumentArgs,
-  type RemoveDocumentArgs,
-  type RenameDocumentArgs,
-  type UpdateLoadRuleArgs,
-} from '../../../types';
-
-type AgentDocumentsArgs =
-  | CopyDocumentArgs
-  | CreateDocumentArgs
-  | EditDocumentArgs
-  | ReadDocumentArgs
-  | RemoveDocumentArgs
-  | RenameDocumentArgs
-  | UpdateLoadRuleArgs;
-
-const getInspectorSummary = (
-  apiName: string,
-  args?: Partial<AgentDocumentsArgs>,
-): string | undefined => {
-  switch (apiName) {
-    case AgentDocumentsApiName.createDocument: {
-      return args && 'title' in args ? args.title : undefined;
-    }
-    case AgentDocumentsApiName.renameDocument: {
-      return args && 'newTitle' in args ? args.newTitle : undefined;
-    }
-    case AgentDocumentsApiName.copyDocument: {
-      if (args && 'newTitle' in args && args.newTitle) return args.newTitle;
-      return args && 'id' in args ? args.id : undefined;
-    }
-    case AgentDocumentsApiName.readDocument:
-    case AgentDocumentsApiName.editDocument:
-    case AgentDocumentsApiName.removeDocument:
-    case AgentDocumentsApiName.updateLoadRule: {
-      return args && 'id' in args ? args.id : undefined;
-    }
-    default: {
-      return undefined;
-    }
-  }
-};
-
-const getInspectorLabel = (apiName: string, t: (...args: any[]) => string) => {
-  switch (apiName) {
-    case AgentDocumentsApiName.createDocument: {
-      return t('builtins.lobe-agent-documents.apiName.createDocument');
-    }
-    case AgentDocumentsApiName.readDocument: {
-      return t('builtins.lobe-agent-documents.apiName.readDocument');
-    }
-    case AgentDocumentsApiName.editDocument: {
-      return t('builtins.lobe-agent-documents.apiName.editDocument');
-    }
-    case AgentDocumentsApiName.removeDocument: {
-      return t('builtins.lobe-agent-documents.apiName.removeDocument');
-    }
-    case AgentDocumentsApiName.renameDocument: {
-      return t('builtins.lobe-agent-documents.apiName.renameDocument');
-    }
-    case AgentDocumentsApiName.copyDocument: {
-      return t('builtins.lobe-agent-documents.apiName.copyDocument');
-    }
-    case AgentDocumentsApiName.updateLoadRule: {
-      return t('builtins.lobe-agent-documents.apiName.updateLoadRule');
-    }
-    default: {
-      return apiName;
-    }
-  }
-};
-
-export const AgentDocumentsInspector = memo<BuiltinInspectorProps<AgentDocumentsArgs>>(
-  ({ apiName, args, partialArgs, isArgumentsStreaming, isLoading }) => {
-    const { t } = useTranslation('plugin');
-
-    const summary = getInspectorSummary(apiName, args || partialArgs);
-    const label = getInspectorLabel(apiName, t);
-
-    if (isArgumentsStreaming && !summary) {
-      return <div className={cx(inspectorTextStyles.root, shinyTextStyles.shinyText)}>{label}</div>;
-    }
-
-    return (
-      <div
-        className={cx(
-          inspectorTextStyles.root,
-          (isArgumentsStreaming || isLoading) && shinyTextStyles.shinyText,
-        )}
-      >
-        <span>{label}</span>
-        {summary && (
-          <>
-            <span>: </span>
-            <span className={highlightTextStyles.primary}>{summary}</span>
-          </>
-        )}
-      </div>
-    );
-  },
-);
-
-AgentDocumentsInspector.displayName = 'AgentDocumentsInspector';
-
-export default AgentDocumentsInspector;

packages/builtin-tool-agent-documents/src/client/Inspector/CopyDocument/index.tsx

@@ -0,0 +1,41 @@
+'use client';
+
+import type { BuiltinInspectorProps } from '@lobechat/types';
+import { cx } from 'antd-style';
+import { memo } from 'react';
+import { useTranslation } from 'react-i18next';
+
+import { highlightTextStyles, inspectorTextStyles, shinyTextStyles } from '@/styles';
+
+import type { CopyDocumentArgs, CopyDocumentState } from '../../../types';
+
+export const CopyDocumentInspector = memo<
+  BuiltinInspectorProps<CopyDocumentArgs, CopyDocumentState>
+>(({ args, partialArgs, isArgumentsStreaming, isLoading }) => {
+  const { t } = useTranslation('plugin');
+  const summary = args?.newTitle || partialArgs?.newTitle || args?.id || partialArgs?.id;
+
+  if (isArgumentsStreaming && !summary) {
+    return (
+      <div className={cx(inspectorTextStyles.root, shinyTextStyles.shinyText)}>
+        <span>{t('builtins.lobe-agent-documents.apiName.copyDocument')}</span>
+      </div>
+    );
+  }
+
+  return (
+    <div
+      className={cx(
+        inspectorTextStyles.root,
+        (isArgumentsStreaming || isLoading) && shinyTextStyles.shinyText,
+      )}
+    >
+      <span>{t('builtins.lobe-agent-documents.apiName.copyDocument')}: </span>
+      {summary && <span className={highlightTextStyles.primary}>{summary}</span>}
+    </div>
+  );
+});
+
+CopyDocumentInspector.displayName = 'CopyDocumentInspector';
+
+export default CopyDocumentInspector;

packages/builtin-tool-agent-documents/src/client/Inspector/CreateDocument/index.tsx

@@ -0,0 +1,41 @@
+'use client';
+
+import type { BuiltinInspectorProps } from '@lobechat/types';
+import { cx } from 'antd-style';
+import { memo } from 'react';
+import { useTranslation } from 'react-i18next';
+
+import { highlightTextStyles, inspectorTextStyles, shinyTextStyles } from '@/styles';
+
+import type { CreateDocumentArgs, CreateDocumentState } from '../../../types';
+
+export const CreateDocumentInspector = memo<
+  BuiltinInspectorProps<CreateDocumentArgs, CreateDocumentState>
+>(({ args, partialArgs, isArgumentsStreaming, isLoading }) => {
+  const { t } = useTranslation('plugin');
+  const title = args?.title || partialArgs?.title;
+
+  if (isArgumentsStreaming && !title) {
+    return (
+      <div className={cx(inspectorTextStyles.root, shinyTextStyles.shinyText)}>
+        <span>{t('builtins.lobe-agent-documents.apiName.createDocument')}</span>
+      </div>
+    );
+  }
+
+  return (
+    <div
+      className={cx(
+        inspectorTextStyles.root,
+        (isArgumentsStreaming || isLoading) && shinyTextStyles.shinyText,
+      )}
+    >
+      <span>{t('builtins.lobe-agent-documents.apiName.createDocument')}: </span>
+      {title && <span className={highlightTextStyles.primary}>{title}</span>}
+    </div>
+  );
+});
+
+CreateDocumentInspector.displayName = 'CreateDocumentInspector';
+
+export default CreateDocumentInspector;

packages/builtin-tool-agent-documents/src/client/Inspector/EditDocument/index.tsx

@@ -0,0 +1,41 @@
+'use client';
+
+import type { BuiltinInspectorProps } from '@lobechat/types';
+import { cx } from 'antd-style';
+import { memo } from 'react';
+import { useTranslation } from 'react-i18next';
+
+import { highlightTextStyles, inspectorTextStyles, shinyTextStyles } from '@/styles';
+
+import type { EditDocumentArgs, EditDocumentState } from '../../../types';
+
+export const EditDocumentInspector = memo<
+  BuiltinInspectorProps<EditDocumentArgs, EditDocumentState>
+>(({ args, partialArgs, isArgumentsStreaming, isLoading }) => {
+  const { t } = useTranslation('plugin');
+  const id = args?.id || partialArgs?.id;
+
+  if (isArgumentsStreaming && !id) {
+    return (
+      <div className={cx(inspectorTextStyles.root, shinyTextStyles.shinyText)}>
+        <span>{t('builtins.lobe-agent-documents.apiName.editDocument')}</span>
+      </div>
+    );
+  }
+
+  return (
+    <div
+      className={cx(
+        inspectorTextStyles.root,
+        (isArgumentsStreaming || isLoading) && shinyTextStyles.shinyText,
+      )}
+    >
+      <span>{t('builtins.lobe-agent-documents.apiName.editDocument')}: </span>
+      {id && <span className={highlightTextStyles.primary}>{id}</span>}
+    </div>
+  );
+});
+
+EditDocumentInspector.displayName = 'EditDocumentInspector';
+
+export default EditDocumentInspector;

packages/builtin-tool-agent-documents/src/client/Inspector/ListDocuments/index.tsx

@@ -0,0 +1,31 @@
+'use client';
+
+import type { BuiltinInspectorProps } from '@lobechat/types';
+import { cx } from 'antd-style';
+import { memo } from 'react';
+import { useTranslation } from 'react-i18next';
+
+import { inspectorTextStyles, shinyTextStyles } from '@/styles';
+
+import type { ListDocumentsArgs, ListDocumentsState } from '../../../types';
+
+export const ListDocumentsInspector = memo<
+  BuiltinInspectorProps<ListDocumentsArgs, ListDocumentsState>
+>(({ isArgumentsStreaming, isLoading }) => {
+  const { t } = useTranslation('plugin');
+
+  return (
+    <div
+      className={cx(
+        inspectorTextStyles.root,
+        (isArgumentsStreaming || isLoading) && shinyTextStyles.shinyText,
+      )}
+    >
+      <span>{t('builtins.lobe-agent-documents.apiName.listDocuments')}</span>
+    </div>
+  );
+});
+
+ListDocumentsInspector.displayName = 'ListDocumentsInspector';
+
+export default ListDocumentsInspector;

packages/builtin-tool-agent-documents/src/client/Inspector/PatchDocument/index.tsx

@@ -0,0 +1,41 @@
+'use client';
+
+import type { BuiltinInspectorProps } from '@lobechat/types';
+import { cx } from 'antd-style';
+import { memo } from 'react';
+import { useTranslation } from 'react-i18next';
+
+import { highlightTextStyles, inspectorTextStyles, shinyTextStyles } from '@/styles';
+
+import type { PatchDocumentArgs, PatchDocumentState } from '../../../types';
+
+export const PatchDocumentInspector = memo<
+  BuiltinInspectorProps<PatchDocumentArgs, PatchDocumentState>
+>(({ args, partialArgs, isArgumentsStreaming, isLoading }) => {
+  const { t } = useTranslation('plugin');
+  const id = args?.id || partialArgs?.id;
+
+  if (isArgumentsStreaming && !id) {
+    return (
+      <div className={cx(inspectorTextStyles.root, shinyTextStyles.shinyText)}>
+        <span>{t('builtins.lobe-agent-documents.apiName.patchDocument')}</span>
+      </div>
+    );
+  }
+
+  return (
+    <div
+      className={cx(
+        inspectorTextStyles.root,
+        (isArgumentsStreaming || isLoading) && shinyTextStyles.shinyText,
+      )}
+    >
+      <span>{t('builtins.lobe-agent-documents.apiName.patchDocument')}: </span>
+      {id && <span className={highlightTextStyles.primary}>{id}</span>}
+    </div>
+  );
+});
+
+PatchDocumentInspector.displayName = 'PatchDocumentInspector';
+
+export default PatchDocumentInspector;

packages/builtin-tool-agent-documents/src/client/Inspector/ReadDocument/index.tsx

@@ -0,0 +1,41 @@
+'use client';
+
+import type { BuiltinInspectorProps } from '@lobechat/types';
+import { cx } from 'antd-style';
+import { memo } from 'react';
+import { useTranslation } from 'react-i18next';
+
+import { highlightTextStyles, inspectorTextStyles, shinyTextStyles } from '@/styles';
+
+import type { ReadDocumentArgs, ReadDocumentState } from '../../../types';
+
+export const ReadDocumentInspector = memo<
+  BuiltinInspectorProps<ReadDocumentArgs, ReadDocumentState>
+>(({ args, partialArgs, pluginState, isArgumentsStreaming, isLoading }) => {
+  const { t } = useTranslation('plugin');
+  const summary = pluginState?.title || args?.id || partialArgs?.id;
+
+  if (isArgumentsStreaming && !summary) {
+    return (
+      <div className={cx(inspectorTextStyles.root, shinyTextStyles.shinyText)}>
+        <span>{t('builtins.lobe-agent-documents.apiName.readDocument')}</span>
+      </div>
+    );
+  }
+
+  return (
+    <div
+      className={cx(
+        inspectorTextStyles.root,
+        (isArgumentsStreaming || isLoading) && shinyTextStyles.shinyText,
+      )}
+    >
+      <span>{t('builtins.lobe-agent-documents.apiName.readDocument')}: </span>
+      {summary && <span className={highlightTextStyles.primary}>{summary}</span>}
+    </div>
+  );
+});
+
+ReadDocumentInspector.displayName = 'ReadDocumentInspector';
+
+export default ReadDocumentInspector;

packages/builtin-tool-agent-documents/src/client/Inspector/ReadDocumentByFilename/index.tsx

@@ -0,0 +1,41 @@
+'use client';
+
+import type { BuiltinInspectorProps } from '@lobechat/types';
+import { cx } from 'antd-style';
+import { memo } from 'react';
+import { useTranslation } from 'react-i18next';
+
+import { highlightTextStyles, inspectorTextStyles, shinyTextStyles } from '@/styles';
+
+import type { ReadDocumentByFilenameArgs, ReadDocumentByFilenameState } from '../../../types';
+
+export const ReadDocumentByFilenameInspector = memo<
+  BuiltinInspectorProps<ReadDocumentByFilenameArgs, ReadDocumentByFilenameState>
+>(({ args, partialArgs, isArgumentsStreaming, isLoading }) => {
+  const { t } = useTranslation('plugin');
+  const filename = args?.filename || partialArgs?.filename;
+
+  if (isArgumentsStreaming && !filename) {
+    return (
+      <div className={cx(inspectorTextStyles.root, shinyTextStyles.shinyText)}>
+        <span>{t('builtins.lobe-agent-documents.apiName.readDocumentByFilename')}</span>
+      </div>
+    );
+  }
+
+  return (
+    <div
+      className={cx(
+        inspectorTextStyles.root,
+        (isArgumentsStreaming || isLoading) && shinyTextStyles.shinyText,
+      )}
+    >
+      <span>{t('builtins.lobe-agent-documents.apiName.readDocumentByFilename')}: </span>
+      {filename && <span className={highlightTextStyles.primary}>{filename}</span>}
+    </div>
+  );
+});
+
+ReadDocumentByFilenameInspector.displayName = 'ReadDocumentByFilenameInspector';
+
+export default ReadDocumentByFilenameInspector;

packages/builtin-tool-agent-documents/src/client/Inspector/RemoveDocument/index.tsx

@@ -0,0 +1,41 @@
+'use client';
+
+import type { BuiltinInspectorProps } from '@lobechat/types';
+import { cx } from 'antd-style';
+import { memo } from 'react';
+import { useTranslation } from 'react-i18next';
+
+import { highlightTextStyles, inspectorTextStyles, shinyTextStyles } from '@/styles';
+
+import type { RemoveDocumentArgs, RemoveDocumentState } from '../../../types';
+
+export const RemoveDocumentInspector = memo<
+  BuiltinInspectorProps<RemoveDocumentArgs, RemoveDocumentState>
+>(({ args, partialArgs, isArgumentsStreaming, isLoading }) => {
+  const { t } = useTranslation('plugin');
+  const id = args?.id || partialArgs?.id;
+
+  if (isArgumentsStreaming && !id) {
+    return (
+      <div className={cx(inspectorTextStyles.root, shinyTextStyles.shinyText)}>
+        <span>{t('builtins.lobe-agent-documents.apiName.removeDocument')}</span>
+      </div>
+    );
+  }
+
+  return (
+    <div
+      className={cx(
+        inspectorTextStyles.root,
+        (isArgumentsStreaming || isLoading) && shinyTextStyles.shinyText,
+      )}
+    >
+      <span>{t('builtins.lobe-agent-documents.apiName.removeDocument')}: </span>
+      {id && <span className={highlightTextStyles.primary}>{id}</span>}
+    </div>
+  );
+});
+
+RemoveDocumentInspector.displayName = 'RemoveDocumentInspector';
+
+export default RemoveDocumentInspector;

packages/builtin-tool-agent-documents/src/client/Inspector/RenameDocument/index.tsx

@@ -0,0 +1,41 @@
+'use client';
+
+import type { BuiltinInspectorProps } from '@lobechat/types';
+import { cx } from 'antd-style';
+import { memo } from 'react';
+import { useTranslation } from 'react-i18next';
+
+import { highlightTextStyles, inspectorTextStyles, shinyTextStyles } from '@/styles';
+
+import type { RenameDocumentArgs, RenameDocumentState } from '../../../types';
+
+export const RenameDocumentInspector = memo<
+  BuiltinInspectorProps<RenameDocumentArgs, RenameDocumentState>
+>(({ args, partialArgs, isArgumentsStreaming, isLoading }) => {
+  const { t } = useTranslation('plugin');
+  const newTitle = args?.newTitle || partialArgs?.newTitle;
+
+  if (isArgumentsStreaming && !newTitle) {
+    return (
+      <div className={cx(inspectorTextStyles.root, shinyTextStyles.shinyText)}>
+        <span>{t('builtins.lobe-agent-documents.apiName.renameDocument')}</span>
+      </div>
+    );
+  }
+
+  return (
+    <div
+      className={cx(
+        inspectorTextStyles.root,
+        (isArgumentsStreaming || isLoading) && shinyTextStyles.shinyText,
+      )}
+    >
+      <span>{t('builtins.lobe-agent-documents.apiName.renameDocument')}: </span>
+      {newTitle && <span className={highlightTextStyles.primary}>{newTitle}</span>}
+    </div>
+  );
+});
+
+RenameDocumentInspector.displayName = 'RenameDocumentInspector';
+
+export default RenameDocumentInspector;

packages/builtin-tool-agent-documents/src/client/Inspector/UpdateLoadRule/index.tsx

@@ -0,0 +1,41 @@
+'use client';
+
+import type { BuiltinInspectorProps } from '@lobechat/types';
+import { cx } from 'antd-style';
+import { memo } from 'react';
+import { useTranslation } from 'react-i18next';
+
+import { highlightTextStyles, inspectorTextStyles, shinyTextStyles } from '@/styles';
+
+import type { UpdateLoadRuleArgs, UpdateLoadRuleState } from '../../../types';
+
+export const UpdateLoadRuleInspector = memo<
+  BuiltinInspectorProps<UpdateLoadRuleArgs, UpdateLoadRuleState>
+>(({ args, partialArgs, isArgumentsStreaming, isLoading }) => {
+  const { t } = useTranslation('plugin');
+  const id = args?.id || partialArgs?.id;
+
+  if (isArgumentsStreaming && !id) {
+    return (
+      <div className={cx(inspectorTextStyles.root, shinyTextStyles.shinyText)}>
+        <span>{t('builtins.lobe-agent-documents.apiName.updateLoadRule')}</span>
+      </div>
+    );
+  }
+
+  return (
+    <div
+      className={cx(
+        inspectorTextStyles.root,
+        (isArgumentsStreaming || isLoading) && shinyTextStyles.shinyText,
+      )}
+    >
+      <span>{t('builtins.lobe-agent-documents.apiName.updateLoadRule')}: </span>
+      {id && <span className={highlightTextStyles.primary}>{id}</span>}
+    </div>
+  );
+});
+
+UpdateLoadRuleInspector.displayName = 'UpdateLoadRuleInspector';
+
+export default UpdateLoadRuleInspector;

packages/builtin-tool-agent-documents/src/client/Inspector/UpsertDocumentByFilename/index.tsx

@@ -0,0 +1,41 @@
+'use client';
+
+import type { BuiltinInspectorProps } from '@lobechat/types';
+import { cx } from 'antd-style';
+import { memo } from 'react';
+import { useTranslation } from 'react-i18next';
+
+import { highlightTextStyles, inspectorTextStyles, shinyTextStyles } from '@/styles';
+
+import type { UpsertDocumentByFilenameArgs, UpsertDocumentByFilenameState } from '../../../types';
+
+export const UpsertDocumentByFilenameInspector = memo<
+  BuiltinInspectorProps<UpsertDocumentByFilenameArgs, UpsertDocumentByFilenameState>
+>(({ args, partialArgs, isArgumentsStreaming, isLoading }) => {
+  const { t } = useTranslation('plugin');
+  const filename = args?.filename || partialArgs?.filename;
+
+  if (isArgumentsStreaming && !filename) {
+    return (
+      <div className={cx(inspectorTextStyles.root, shinyTextStyles.shinyText)}>
+        <span>{t('builtins.lobe-agent-documents.apiName.upsertDocumentByFilename')}</span>
+      </div>
+    );
+  }
+
+  return (
+    <div
+      className={cx(
+        inspectorTextStyles.root,
+        (isArgumentsStreaming || isLoading) && shinyTextStyles.shinyText,
+      )}
+    >
+      <span>{t('builtins.lobe-agent-documents.apiName.upsertDocumentByFilename')}: </span>
+      {filename && <span className={highlightTextStyles.primary}>{filename}</span>}
+    </div>
+  );
+});
+
+UpsertDocumentByFilenameInspector.displayName = 'UpsertDocumentByFilenameInspector';
+
+export default UpsertDocumentByFilenameInspector;

packages/builtin-tool-agent-documents/src/client/Inspector/index.ts

@@ -1,14 +1,30 @@
 import type { BuiltinInspector } from '@lobechat/types';
 
 import { AgentDocumentsApiName } from '../../types';
-import { AgentDocumentsInspector } from './AgentDocumentsInspector';
+import { CopyDocumentInspector } from './CopyDocument';
+import { CreateDocumentInspector } from './CreateDocument';
+import { EditDocumentInspector } from './EditDocument';
+import { ListDocumentsInspector } from './ListDocuments';
+import { PatchDocumentInspector } from './PatchDocument';
+import { ReadDocumentInspector } from './ReadDocument';
+import { ReadDocumentByFilenameInspector } from './ReadDocumentByFilename';
+import { RemoveDocumentInspector } from './RemoveDocument';
+import { RenameDocumentInspector } from './RenameDocument';
+import { UpdateLoadRuleInspector } from './UpdateLoadRule';
+import { UpsertDocumentByFilenameInspector } from './UpsertDocumentByFilename';
 
 export const AgentDocumentsInspectors: Record<string, BuiltinInspector> = {
-  [AgentDocumentsApiName.createDocument]: AgentDocumentsInspector as BuiltinInspector,
-  [AgentDocumentsApiName.copyDocument]: AgentDocumentsInspector as BuiltinInspector,
-  [AgentDocumentsApiName.editDocument]: AgentDocumentsInspector as BuiltinInspector,
-  [AgentDocumentsApiName.readDocument]: AgentDocumentsInspector as BuiltinInspector,
-  [AgentDocumentsApiName.removeDocument]: AgentDocumentsInspector as BuiltinInspector,
-  [AgentDocumentsApiName.renameDocument]: AgentDocumentsInspector as BuiltinInspector,
-  [AgentDocumentsApiName.updateLoadRule]: AgentDocumentsInspector as BuiltinInspector,
+  [AgentDocumentsApiName.copyDocument]: CopyDocumentInspector as BuiltinInspector,
+  [AgentDocumentsApiName.createDocument]: CreateDocumentInspector as BuiltinInspector,
+  [AgentDocumentsApiName.editDocument]: EditDocumentInspector as BuiltinInspector,
+  [AgentDocumentsApiName.listDocuments]: ListDocumentsInspector as BuiltinInspector,
+  [AgentDocumentsApiName.patchDocument]: PatchDocumentInspector as BuiltinInspector,
+  [AgentDocumentsApiName.readDocument]: ReadDocumentInspector as BuiltinInspector,
+  [AgentDocumentsApiName.readDocumentByFilename]:
+    ReadDocumentByFilenameInspector as BuiltinInspector,
+  [AgentDocumentsApiName.removeDocument]: RemoveDocumentInspector as BuiltinInspector,
+  [AgentDocumentsApiName.renameDocument]: RenameDocumentInspector as BuiltinInspector,
+  [AgentDocumentsApiName.updateLoadRule]: UpdateLoadRuleInspector as BuiltinInspector,
+  [AgentDocumentsApiName.upsertDocumentByFilename]:
+    UpsertDocumentByFilenameInspector as BuiltinInspector,
 };

packages/builtin-tool-agent-documents/src/client/Render/CreateDocument/DocumentCard.tsx

@@ -0,0 +1,130 @@
+'use client';
+
+import { ActionIcon, CopyButton, Flexbox, Markdown, ScrollShadow, TooltipGroup } from '@lobehub/ui';
+import { Button } from 'antd';
+import { createStaticStyles } from 'antd-style';
+import { FileTextIcon, Maximize2, Minimize2, PencilLine } from 'lucide-react';
+import { memo } from 'react';
+import { useTranslation } from 'react-i18next';
+
+import { useChatStore } from '@/store/chat';
+import { chatPortalSelectors } from '@/store/chat/slices/portal/selectors';
+
+const styles = createStaticStyles(({ css, cssVar }) => ({
+  container: css`
+    position: relative;
+
+    overflow: hidden;
+
+    width: 100%;
+    border: 1px solid ${cssVar.colorBorderSecondary};
+    border-radius: 16px;
+
+    background: ${cssVar.colorBgContainer};
+  `,
+  content: css`
+    padding-inline: 16px;
+    font-size: 14px;
+  `,
+  expandButton: css`
+    position: absolute;
+    inset-block-end: 16px;
+    inset-inline-start: 50%;
+    transform: translateX(-50%);
+
+    box-shadow: ${cssVar.boxShadow};
+  `,
+  header: css`
+    padding-block: 10px;
+    padding-inline: 12px;
+    border-block-end: 1px solid ${cssVar.colorBorderSecondary};
+  `,
+  icon: css`
+    color: ${cssVar.colorPrimary};
+  `,
+  title: css`
+    overflow: hidden;
+    display: -webkit-box;
+    -webkit-box-orient: vertical;
+    -webkit-line-clamp: 1;
+
+    font-weight: 500;
+    color: ${cssVar.colorText};
+  `,
+}));
+
+interface DocumentCardProps {
+  content: string;
+  documentId?: string;
+  title: string;
+}
+
+const DocumentCard = memo<DocumentCardProps>(({ content, documentId, title }) => {
+  const { t } = useTranslation('plugin');
+  const [portalDocumentId, openDocument, closeDocument] = useChatStore((s) => [
+    chatPortalSelectors.portalDocumentId(s),
+    s.openDocument,
+    s.closeDocument,
+  ]);
+
+  const isExpanded = !!documentId && portalDocumentId === documentId;
+
+  const handleToggle = () => {
+    if (!documentId) return;
+    if (isExpanded) {
+      closeDocument();
+    } else {
+      openDocument(documentId);
+    }
+  };
+
+  return (
+    <Flexbox className={styles.container}>
+      <Flexbox horizontal align={'center'} className={styles.header} gap={8}>
+        <FileTextIcon className={styles.icon} size={16} />
+        <Flexbox flex={1}>
+          <div className={styles.title}>{title}</div>
+        </Flexbox>
+        <TooltipGroup>
+          <Flexbox horizontal gap={4}>
+            <CopyButton
+              content={content}
+              size={'small'}
+              title={t('builtins.lobe-notebook.actions.copy')}
+            />
+            {documentId && (
+              <ActionIcon
+                icon={PencilLine}
+                size={'small'}
+                title={t('builtins.lobe-notebook.actions.edit')}
+                onClick={handleToggle}
+              />
+            )}
+          </Flexbox>
+        </TooltipGroup>
+      </Flexbox>
+      <ScrollShadow className={styles.content} offset={12} size={12} style={{ maxHeight: 400 }}>
+        <Markdown style={{ overflow: 'unset', paddingBottom: 40 }} variant={'chat'}>
+          {content}
+        </Markdown>
+      </ScrollShadow>
+
+      {documentId && (
+        <Button
+          className={styles.expandButton}
+          color={'default'}
+          icon={isExpanded ? <Minimize2 size={14} /> : <Maximize2 size={14} />}
+          shape={'round'}
+          variant={'outlined'}
+          onClick={handleToggle}
+        >
+          {isExpanded
+            ? t('builtins.lobe-notebook.actions.collapse')
+            : t('builtins.lobe-notebook.actions.expand')}
+        </Button>
+      )}
+    </Flexbox>
+  );
+});
+
+export default DocumentCard;

packages/builtin-tool-agent-documents/src/client/Render/CreateDocument/index.tsx

@@ -0,0 +1,23 @@
+'use client';
+
+import type { BuiltinRenderProps } from '@lobechat/types';
+import { memo } from 'react';
+
+import type { CreateDocumentArgs, CreateDocumentState } from '../../../types';
+import DocumentCard from './DocumentCard';
+
+export type CreateDocumentRenderProps = Pick<
+  BuiltinRenderProps<CreateDocumentArgs, CreateDocumentState>,
+  'args' | 'pluginState'
+>;
+
+const CreateDocument = memo<CreateDocumentRenderProps>(({ args, pluginState }) => {
+  const title = args?.title;
+  const content = args?.content;
+
+  if (!title || !content) return null;
+
+  return <DocumentCard content={content} documentId={pluginState?.documentId} title={title} />;
+});
+
+export default CreateDocument;

packages/builtin-tool-agent-documents/src/client/Render/index.ts

@@ -1,3 +1,7 @@
-// Intentionally empty: Agent Documents has no dedicated render components yet.
-// Keep this export as a stable extension point for future UI renderers.
-export const AgentDocumentsRenders = {};
+import CreateDocument from './CreateDocument';
+
+export const AgentDocumentsRenders = {
+  createDocument: CreateDocument,
+};
+
+export { default as CreateDocument } from './CreateDocument';