@allbluecn/web-app 0.23.7 → 0.24.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allbluecn/web-app",
-  "version": "0.23.7",
+  "version": "0.24.1",
   "license": "AGPL-3.0-or-later",
   "type": "module",
   "files": [
@@ -60,7 +60,7 @@
   "dependencies": {
     "@ag-ui/core": "1.0.0",
     "@allbluecn/collab-core": "0.2.0",
-    "@allbluecn/database": "0.12.3",
+    "@allbluecn/database": "0.13.0",
     "@allbluecn/kernel": "0.12.0",
     "@allbluecn/sync-core": "0.7.0",
     "@ariakit/react": "^0.4.28",

package/src/components/ai/global-harness-sidebar/__tests__/global-ai-prompts.test.ts

@@ -92,8 +92,6 @@ function coveredByBoardRule(rel: string): boolean {
  * 新增业务页面时二者必居其一：在此登记，或在 BOARD_RULES 增加板块规则。
  */
 const PAGES_WITHOUT_BOARDS = [
-  // 本地文件助手（桌面本地优先 P3-B5）：页面自带对话区，非业务板块，无全局 AI 板块上下文
-  "agent",
   "bugs",
   "chat",
   "changelog",

package/src/components/harness/ai-chat-history/components/conversation-item.tsx

@@ -27,6 +27,7 @@ import {
 import { useCallback, useEffect, useRef, useState } from "react";
 import { cn } from "@/lib/utils";
 import { formatChatDate } from "@/lib/datetime";
+import { Badge } from "@/components/ui/badge";
 import { ConfirmDialog } from "@/components/confirm-dialog";
 import { Button } from "@/components/ui/button";
 import { toast } from "@/components/ui/toast";
@@ -161,6 +162,11 @@ export function ConversationItem({
                   <h4 className="wrap-break-word min-w-0 font-medium text-sm">
                     {conversation.title ?? m.chat_newConversation()}
                   </h4>
+                  {conversation.engine === "local" && (
+                    <Badge variant="outline" className="shrink-0 px-1.5 py-0 text-[10px] font-normal">
+                      {m.harness_engine_localBadge()}
+                    </Badge>
+                  )}
                   {conversation.pendingInteraction && (
                     <Tooltip>
                       <TooltipTrigger

package/src/components/harness/ai-chat-history/types.ts

@@ -24,6 +24,10 @@ export interface Conversation {
   isArchived?: boolean;
   isActive?: boolean;
   pendingInteraction?: boolean;
+  /** 执行引擎：cloud（服务端模型）/ local（桌面 pi 本地 Agent） */
+  engine?: "cloud" | "local";
+  /** 本地 Agent 的授权工作目录（engine=local 时有值） */
+  localCwd?: string | null;
 }
 
 export interface AIChatHistoryProps {

package/src/components/harness/chat-ui.tsx

@@ -20,6 +20,7 @@ import { fetchServerSentEvents } from "@tanstack/ai-react";
 import {
   createChatHook,
   type PartProps,
+  type ToolProps,
 } from "@tanstack/ai-react/ui";
 import {
   automaticPartsForMessage,
@@ -45,6 +46,7 @@ import {
 } from "@/components/ai/tool-cards";
 import { PlanApprovalCard } from "./plan-approval-card";
 import { PluginDefineApproval } from "./plugin-define-approval";
+import { AgentToolCard } from "./local-agent/agent-tool-card";
 import { buildPluginClientTools } from "@/lib/plugin-runtime/plugin-client-tools";
 
 /**
@@ -159,6 +161,11 @@ function HarnessSelectedPart({ part }: { part: ChatUISelectedPart }) {
         return (
           <KnowledgeSearchCard part={part.part as never} result={part.result as never} />
         );
+      case "read":
+      case "grep":
+      case "find":
+      case "ls":
+        return <AgentToolCard part={part.part as never} result={part.result as never} />;
       default:
         return <FallbackToolCard part={part.part as never} result={part.result as never} />;
     }
@@ -171,6 +178,15 @@ function HarnessSelectedPart({ part }: { part: ChatUISelectedPart }) {
   return null;
 }
 
+/**
+ * 桌面本地 Agent（pi）的只读四件套工具卡：createChatHook 的 toolsComponents
+ * 以 ToolProps 形状调用，而 AgentToolCard 用的是 UIMessage 的 tool-call/
+ * tool-result part 类型；两者运行时同形，这里做一次承载性 as 收窄。
+ */
+function LocalAgentToolCard(props: ToolProps<unknown, string>) {
+  return <AgentToolCard part={props.part as never} result={props.result as never} />;
+}
+
 export const {
   useAppChat: useHarnessChat,
   useChatContext: useHarnessChatContext,
@@ -201,6 +217,10 @@ export const {
     plugin_stop: FallbackToolCard,
     plugin_undefine: FallbackToolCard,
     plugin_inspect_list: FallbackToolCard,
+    read: LocalAgentToolCard,
+    grep: LocalAgentToolCard,
+    find: LocalAgentToolCard,
+    ls: LocalAgentToolCard,
   },
   interruptsComponents: {
     generic: {

package/src/components/harness/composer/harness-composer.tsx

@@ -23,6 +23,7 @@ import { decideSubmit, type BusyAction } from "./submit-machine"
 import { useAttachments } from "./attachments/use-attachments"
 import { AttachmentTray } from "./attachments/attachment-tray"
 import { ModelSelect } from "./model-select"
+import { HarnessEngineControl, type HarnessEngine } from "./harness-engine-control"
 import { ContextMeter } from "./context-meter"
 import { InterruptApproval } from "@/components/harness/interrupt-approval"
 import { ComposerEditor } from "./composer-editor"
@@ -157,6 +158,14 @@ export interface HarnessComposerProps {
   handoffContext?: { board: string; entityId: string } | null
   /** 纯文本 handoff 预填值（dashboard 等 board：跳过 chip 插入，直接写入编辑器文本） */
   handoffPrefillText?: string | null
+  /** 执行引擎（桌面端）：cloud=服务端模型；local=pi 本地工作区 */
+  engine?: HarnessEngine
+  onEngineChange?: (engine: HarnessEngine) => void
+  /** 本地 Agent 的授权工作目录 */
+  localCwd?: string | null
+  onLocalCwdChange?: (path: string) => void
+  /** 运行中 / 已有消息：锁定引擎与目录 */
+  engineLocked?: boolean
 }
 
 export function HarnessComposer({
@@ -182,7 +191,16 @@ export function HarnessComposer({
    scrollContainerRef,
    handoffContext,
    handoffPrefillText,
+   engine,
+   onEngineChange,
+   localCwd,
+   onLocalCwdChange,
+   engineLocked,
 }: HarnessComposerProps) {
+  // 本地工作区引擎由桌面 pi 按「设置 → AI 服务商」里已启用的服务商自行解析，
+  // 不依赖 session.hasAiKey（guest 会话该字段恒 false）；云端仍要求 hasAiKey。
+  const localEngine = engine === "local"
+  const aiReady = hasAiKey || localEngine
   const [input, setInput] = useState("")
   const [pendingPrefillEntity, setPendingPrefillEntity] = useState<PrefillMentionEntity | null>(null)
   const [pendingPrefillText, setPendingPrefillText] = useState<string | null>(null)
@@ -190,7 +208,7 @@ export function HarnessComposer({
   const receiveEditor = useCallback((editor: Editor | null) => {
     editorRef.current = editor ?? null
     setInput(editor?.getText() ?? "")
-    if (editor && hasAiKey) {
+    if (editor && aiReady) {
       if (pendingPrefillEntity) {
         insertMentionChip(editor, pendingPrefillEntity)
         setPendingPrefillEntity(null)
@@ -199,7 +217,7 @@ export function HarnessComposer({
         setPendingPrefillText(null)
       }
     }
-  }, [pendingPrefillEntity, pendingPrefillText, hasAiKey])
+  }, [pendingPrefillEntity, pendingPrefillText, aiReady])
   const { attachments, addFiles, removeAttachment, clearAttachments, hasUploading } = useAttachments()
   // @mention chip 中携带的 kbId（由 ComposerEditor 通过 onMentionKbIds 回调上报）
   const [editorMentionKbIds, setEditorMentionKbIds] = useState<string[]>([])
@@ -228,24 +246,24 @@ export function HarnessComposer({
     }
     const entity: PrefillMentionEntity = prefill.entity
     setPendingPrefillEntity(entity)
-    if (editorRef.current && hasAiKey) {
+    if (editorRef.current && aiReady) {
       insertMentionChip(editorRef.current, entity)
       setPendingPrefillEntity(null)
     }
-  }, [handoffContext, handoffPrefillText, hasAiKey])
+  }, [handoffContext, handoffPrefillText, aiReady])
 
   // placeholder 五态
   const placeholder = computePlaceholder({
-    hasAiKey,
+    hasAiKey: aiReady,
     isRunning,
     busyPreference,
   })
 
   const handleSend = useCallback(
     (text: string, whenBusy: "queue" | "interrupt" = "queue") => {
-      if (!text.trim() || !hasAiKey) return
+      if (!text.trim() || !aiReady) return
 
-      if (mediaRoute === "spec") {
+      if (!localEngine && mediaRoute === "spec") {
         if (!threadId) {
           toast.info(m.harness_spec_needThread())
           editorRef.current?.commands.clearContent()
@@ -295,7 +313,7 @@ export function HarnessComposer({
         clearAttachments()
       }
     },
-    [hasAiKey, onSend, knowledgeBaseIds, editorMentionKbIds, handoffContext, clearAttachments, removeAttachment, attachments, mediaRoute, threadId]
+    [aiReady, localEngine, onSend, knowledgeBaseIds, editorMentionKbIds, handoffContext, clearAttachments, removeAttachment, attachments, mediaRoute, threadId]
   )
 
   const handleStop = useCallback(() => {
@@ -364,9 +382,9 @@ export function HarnessComposer({
           }}
         >
           <ComposerEditor
-            key={String(hasAiKey)}
+            key={String(aiReady)}
             threadId={threadId ?? "default"}
-            editable={hasAiKey}
+            editable={aiReady}
             editorRef={receiveEditor}
             onTextChange={() => setInput(editorRef.current?.getText() ?? "")}
             onMentionKbIds={setEditorMentionKbIds}
@@ -384,20 +402,39 @@ export function HarnessComposer({
         )}
         <div className="flex items-center justify-between gap-2 p-2">
           <div className="flex min-w-0 flex-wrap items-center gap-1.5">
-            <ModelSelect models={models} onModelChange={onModelChange} />
+            {engine && onEngineChange && (
+              <HarnessEngineControl
+                engine={engine}
+                onEngineChange={onEngineChange}
+                localCwd={localCwd ?? null}
+                onLocalCwdChange={(path) => onLocalCwdChange?.(path)}
+                disabled={engineLocked || isRunning}
+              />
+            )}
+            {engine !== "local" && (
+              <ModelSelect models={models} onModelChange={onModelChange} />
+            )}
             <ContextMeter messages={messages} />
-            <SandboxPolicyControl
-              sandboxPolicy={sandboxPolicy}
-              onSandboxPolicyChange={onSandboxPolicyChange}
-            />
-            <MediaRouteControl
-              mediaRoute={mediaRoute}
-              onMediaRouteChange={onMediaRouteChange}
-            />
+            {engine !== "local" ? (
+              <>
+                <SandboxPolicyControl
+                  sandboxPolicy={sandboxPolicy}
+                  onSandboxPolicyChange={onSandboxPolicyChange}
+                />
+                <MediaRouteControl
+                  mediaRoute={mediaRoute}
+                  onMediaRouteChange={onMediaRouteChange}
+                />
+              </>
+            ) : (
+              <span className="truncate text-xs text-muted-foreground">
+                {m.harness_engine_localHint()}
+              </span>
+            )}
           </div>
           <Button
             size="sm"
-            disabled={!hasAiKey || sendBlocked}
+            disabled={!aiReady || sendBlocked || (localEngine && !localCwd)}
             onClick={() => handleSend(editorRef.current?.getText() ?? "")}
           >
             {m.harness_composer_send()}

package/src/components/harness/composer/harness-engine-control.tsx

@@ -0,0 +1,129 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+/**
+ * Harness 引擎切换（桌面端）：云端模型 ↔ 本地工作区（pi）。
+ *
+ * 本地文件助手已收编进 Harness：这里不再有独立模块入口，用户在同一会话工作台
+ * 里选择执行引擎。本地引擎的授权目录仍走桌面壳的 workspaces.json（唯一添加入口
+ * 是原生目录对话框），复用 AgentWorkspaceCard 的增删/选择交互。
+ *
+ * 门控与旧入口同源：useDesktopAgentPresence 在挂载后探测 appInfo.agentPort，
+ * SSR/hydration 首帧不渲染（云 Web / OSS 恒不可见）。线程已有消息时锁定切换，
+ * 避免把云会话历史与 pi 会话错位；首次消息前可自由切换。
+ */
+import { useState } from 'react'
+import { FolderOpen } from 'lucide-react'
+import { Button } from '@/components/ui/button'
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogHeader,
+  DialogTitle,
+} from '@/components/ui/dialog'
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from '@/components/ui/select'
+import { AgentWorkspaceCard } from '@/components/harness/local-agent/agent-workspace-card'
+import { useDesktopAgentPresence } from '@/lib/desktop-agent/use-desktop-agent-presence'
+import { m } from '@/paraglide/messages.js'
+
+export type HarnessEngine = 'cloud' | 'local'
+
+function folderNameOf(path: string): string {
+  return path.split(/[\\/]/).filter(Boolean).at(-1) ?? path
+}
+
+export interface HarnessEngineControlProps {
+  engine: HarnessEngine
+  onEngineChange: (engine: HarnessEngine) => void
+  localCwd: string | null
+  onLocalCwdChange: (path: string) => void
+  /** 运行中 / 已有消息：锁定引擎与目录，避免线程语义漂移 */
+  disabled?: boolean
+}
+
+export function HarnessEngineControl({
+  engine,
+  onEngineChange,
+  localCwd,
+  onLocalCwdChange,
+  disabled = false,
+}: HarnessEngineControlProps) {
+  const presence = useDesktopAgentPresence()
+  const [dialogOpen, setDialogOpen] = useState(false)
+
+  // pending（探测中）与 absent（云 Web / OSS / 旧壳）都不渲染：与服务端
+  // engine=local 的门控一致，避免用户选中一个永远不可用的引擎。
+  if (presence !== 'present') return null
+
+  return (
+    <>
+      <Select
+        value={engine}
+        onValueChange={(value) => {
+          if (value === 'cloud' || value === 'local') onEngineChange(value)
+        }}
+        disabled={disabled}
+      >
+        <SelectTrigger className="h-7 w-auto text-xs" aria-label={m.harness_engine_label()}>
+          <SelectValue />
+        </SelectTrigger>
+        <SelectContent>
+          <SelectItem value="cloud">{m.harness_engine_cloud()}</SelectItem>
+          <SelectItem value="local">{m.harness_engine_local()}</SelectItem>
+        </SelectContent>
+      </Select>
+      {engine === 'local' && (
+        <Button
+          variant="outline"
+          size="sm"
+          className="h-7 max-w-44 text-xs"
+          disabled={disabled}
+          onClick={() => setDialogOpen(true)}
+          aria-label={m.harness_localWorkspace_manage()}
+        >
+          <FolderOpen className="size-3 shrink-0" />
+          <span className="truncate">
+            {localCwd ? folderNameOf(localCwd) : m.harness_localWorkspace_choose()}
+          </span>
+        </Button>
+      )}
+      <Dialog open={dialogOpen} onOpenChange={setDialogOpen}>
+        <DialogContent className="max-h-[80vh] overflow-y-auto sm:max-w-lg">
+          <DialogHeader>
+            <DialogTitle>{m.harness_localWorkspace_dialogTitle()}</DialogTitle>
+            <DialogDescription>{m.harness_localWorkspace_dialogDescription()}</DialogDescription>
+          </DialogHeader>
+          <AgentWorkspaceCard
+            selected={localCwd}
+            onSelect={(path) => {
+              onLocalCwdChange(path)
+              setDialogOpen(false)
+            }}
+            disabled={disabled}
+          />
+        </DialogContent>
+      </Dialog>
+    </>
+  )
+}

package/src/components/harness/harness-workbench-page.tsx

@@ -18,7 +18,7 @@
 import { Link as RouterLink, useNavigate } from '@tanstack/react-router'
 import { useState, useCallback, useEffect, useMemo, useRef } from 'react'
 import { useQuery } from '@tanstack/react-query'
-import { AlertCircle, ListTodo } from 'lucide-react'
+import { AlertCircle, ListTodo, FolderOpen } from 'lucide-react'
 import AIChatHistory from '@/components/harness/ai-chat-history'
 import type { Conversation } from '@/components/harness/ai-chat-history'
 import { useHarnessChat } from '@/components/harness/chat-ui'
@@ -61,9 +61,19 @@ import { ConnectionIndicator } from '@/components/harness/connection-indicator'
 import { RetryCountdownBar } from '@/components/harness/retry-countdown-bar'
 import { GhostMessageRow } from '@/components/harness/ghost-message-row'
 
+export interface HarnessInitialConversation {
+  id: string
+  title: string | null
+  agentId: string | null
+  engine: "cloud" | "local"
+  localCwd: string | null
+  isArchived: boolean
+}
+
 export interface HarnessWorkbenchPageProps {
   initialThreadId?: string
   initialMessages?: UIMessage[]
+  initialConversation?: HarnessInitialConversation | null
 }
 
 type HarnessChatInstance = ReturnType<typeof useHarnessChat>
@@ -78,12 +88,16 @@ interface PendingThreadSend {
   sendOptions?: Parameters<HarnessChatInstance["sendMessage"]>[1]
 }
 
-export default function HarnessWorkbenchPage({ initialThreadId, initialMessages }: HarnessWorkbenchPageProps) {
+export default function HarnessWorkbenchPage({ initialThreadId, initialMessages, initialConversation }: HarnessWorkbenchPageProps) {
   const { data: session } = useSession()
   const hasAiKey = session?.user?.hasAiKey
   const navigate = useNavigate()
   const [conversations, setConversations] = useState<Conversation[]>([])
   const [activeConversationId, setActiveConversationId] = useState<string | null>(initialThreadId ?? null)
+  // 线程级执行引擎（桌面端才有本地工作区选项）：从 loader 元数据还原；
+  // 新建会话沿用当前选择。已有消息的线程锁定，避免云历史与 pi 会话错位。
+  const [engine, setEngine] = useState<"cloud" | "local">(initialConversation?.engine ?? "cloud")
+  const [localCwd, setLocalCwd] = useState<string | null>(initialConversation?.localCwd ?? null)
   const [selectedModel, setSelectedModel] = useSelectedModel()
   const [webSearchEnabled, setWebSearchEnabled] = useState(false)
   const [codeModeEnabled, setCodeModeEnabled] = useState(false)
@@ -151,13 +165,16 @@ export default function HarnessWorkbenchPage({ initialThreadId, initialMessages
     threadId: activeConversationId ?? initialThreadId ?? fallbackThreadIdRef.current,
     initialMessages,
     forwardedProps: {
-      webSearchEnabled,
-      codeModeEnabled,
+      webSearchEnabled: engine === "local" ? false : webSearchEnabled,
+      codeModeEnabled: engine === "local" ? false : codeModeEnabled,
       model: effectiveModel,
       provider: adapterKind,
-      agentId: selectedAgentId,
+      agentId: engine === "local" ? undefined : selectedAgentId,
       promptKey: 'chat.default',
-      sandbox: sandboxPolicy !== "readonly",
+      sandbox: engine === "local" ? false : sandboxPolicy !== "readonly",
+      engine,
+      // 只读 pi 只接受目录；云端线程不发送 cwd（schema 会忽略）
+      cwd: engine === "local" ? (localCwd ?? undefined) : undefined,
       workspaceId: workspace?.type === "cloud" ? workspace.id : undefined,
       workspaceContext: workspace?.type === "github"
         ? { type: "github", owner: workspace.owner, repo: workspace.repo, defaultBranch: workspace.branch }
@@ -302,18 +319,30 @@ export default function HarnessWorkbenchPage({ initialThreadId, initialMessages
   }, [])
 
   const handleNewConversation = useCallback(() => {
+    if (engine === "local" && !localCwd) {
+      toastError(new Error(m.harness_localWorkspace_required()), m.common_operationFailed())
+      return
+    }
     clearHarnessCitations()
     setLatestCitations(undefined)
     setActiveConversationId(null)
     activeIdRef.current = null
     chat.clear()
-    createConversationFn({ data: { agentId: selectedAgentId } }).then((conv) => {
+    createConversationFn({
+      data: {
+        agentId: engine === "local" ? undefined : selectedAgentId,
+        engine,
+        localCwd: engine === "local" ? (localCwd ?? undefined) : undefined,
+      },
+    }).then((conv) => {
       setConversations((prev) => [conv, ...prev])
+      // 新线程 id 变化会重建 hook，但本页 activeId 先置空再导航；loader 会把
+      // engine/localCwd 从 DB 读回，保持引擎选择不丢
       navigate({ to: '/harness/$threadId', params: { threadId: conv.id } })
     }).catch((e) => {
       toastError(e, m.common_operationFailed())
     })
-  }, [chat, navigate, selectedAgentId])
+  }, [chat, navigate, selectedAgentId, engine, localCwd])
 
   const handleAgentChange = useCallback((newAgentId: string | undefined) => {
     if (newAgentId === selectedAgentId) return
@@ -333,6 +362,58 @@ export default function HarnessWorkbenchPage({ initialThreadId, initialMessages
     setConfirmSwitchOpen(false)
   }, [chat])
 
+  /** 空线程切换引擎/目录时同步持久化；有消息后由 UI 锁定（服务端亦拒绝） */
+  const persistThreadEngine = useCallback(
+    async (nextEngine: "cloud" | "local", nextCwd: string | null) => {
+      if (!activeIdRef.current || chat.messages.length > 0) return
+      try {
+        await updateConversationFn({
+          data: {
+            id: activeIdRef.current,
+            engine: nextEngine,
+            localCwd: nextEngine === "local" ? nextCwd : null,
+          },
+        })
+        setConversations((prev) =>
+          prev.map((conversation) =>
+            conversation.id === activeIdRef.current
+              ? { ...conversation, engine: nextEngine, localCwd: nextEngine === "local" ? nextCwd : null }
+              : conversation,
+          ),
+        )
+      } catch (error) {
+        toastError(error, m.common_operationFailed())
+      }
+    },
+    [chat.messages.length],
+  )
+
+  const handleEngineChange = useCallback(
+    (nextEngine: "cloud" | "local") => {
+      if (nextEngine === engine) return
+      if (chat.messages.length > 0) {
+        toastError(new Error(m.harness_engine_switchLocked()), m.common_operationFailed())
+        return
+      }
+      setEngine(nextEngine)
+      if (nextEngine === "cloud") {
+        setLocalCwd(null)
+        setSelectedAgentId(undefined)
+      }
+      void persistThreadEngine(nextEngine, nextEngine === "local" ? localCwd : null)
+    },
+    [engine, chat.messages.length, localCwd, persistThreadEngine],
+  )
+
+  const handleLocalCwdChange = useCallback(
+    (path: string) => {
+      if (chat.messages.length > 0) return
+      setLocalCwd(path)
+      void persistThreadEngine("local", path)
+    },
+    [chat.messages.length, persistThreadEngine],
+  )
+
   const handleSelect = useCallback((id: string) => {
     clearHarnessCitations()
     setLatestCitations(undefined)
@@ -403,6 +484,14 @@ export default function HarnessWorkbenchPage({ initialThreadId, initialMessages
   }, [navigate])
 
   const handleSend = useCallback(async (val: string, opts?: { whenBusy?: "queue" | "interrupt"; knowledgeBaseIds?: string[]; attachments?: Array<{ type: "image"; source: { type: "data"; value: string; mimeType: string } }> }, flags?: { isRetry?: boolean }) => {
+    if (engine === "local" && !localCwd) {
+      toastError(new Error(m.harness_localWorkspace_required()), m.common_operationFailed())
+      return
+    }
+    if (engine === "local" && opts?.attachments && opts.attachments.length > 0) {
+      toastError(new Error(m.harness_engine_localNoAttachments()), m.common_operationFailed())
+      return
+    }
     setLatestCitations(undefined)
     setRetryCount(0)
     if (val.trim() && !flags?.isRetry) {
@@ -415,10 +504,15 @@ export default function HarnessWorkbenchPage({ initialThreadId, initialMessages
         },
       })
     }
-    // knowledgeBaseIds 通过 body 传递到 forwardedProps
+    // knowledgeBaseIds 通过 body 传递到 forwardedProps；本地 Agent 不消费知识库
     const sendOptions = opts ? {
       whenBusy: opts.whenBusy,
-      body: opts.knowledgeBaseIds ? { knowledgeBaseIds: opts.knowledgeBaseIds } : undefined,
+      body:
+        engine === "local"
+          ? undefined
+          : opts.knowledgeBaseIds
+            ? { knowledgeBaseIds: opts.knowledgeBaseIds }
+            : undefined,
     } : undefined
     const content: Parameters<HarnessChatInstance["sendMessage"]>[0]
       = opts?.attachments && opts.attachments.length > 0
@@ -432,7 +526,13 @@ export default function HarnessWorkbenchPage({ initialThreadId, initialMessages
       if (creatingConversationRef.current) return
       creatingConversationRef.current = true
       try {
-        const conv = await createConversationFn({ data: { agentId: selectedAgentId } })
+        const conv = await createConversationFn({
+          data: {
+            agentId: engine === "local" ? undefined : selectedAgentId,
+            engine,
+            localCwd: engine === "local" ? (localCwd ?? undefined) : undefined,
+          },
+        })
         setConversations(prev => [conv, ...prev])
         setActiveConversationId(conv.id)
         activeIdRef.current = conv.id
@@ -447,7 +547,7 @@ export default function HarnessWorkbenchPage({ initialThreadId, initialMessages
       return
     }
     void chat.sendMessage(content, sendOptions)
-  }, [chat, selectedAgentId])
+  }, [chat, selectedAgentId, engine, localCwd])
 
   const handleStop = useCallback(() => {
     chat.stop()
@@ -461,11 +561,18 @@ export default function HarnessWorkbenchPage({ initialThreadId, initialMessages
   const centerContent = (
     <div className="flex h-full flex-col">
       <div className="flex shrink-0 items-center gap-2 border-b px-4 py-3">
-        <AgentPresetPicker
-          value={selectedAgentId}
-          onValueChange={handleAgentChange}
-          agents={agents ?? []}
-        />
+        {engine === "local" ? (
+          <span className="inline-flex items-center gap-1.5 rounded-md border border-border bg-muted/40 px-2 py-1 text-xs text-muted-foreground">
+            <FolderOpen className="size-3.5" />
+            {m.harness_engine_localBadge()}
+          </span>
+        ) : (
+          <AgentPresetPicker
+            value={selectedAgentId}
+            onValueChange={handleAgentChange}
+            agents={agents ?? []}
+          />
+        )}
         <h2 className="truncate font-semibold">{activeConversation?.title ?? m.chat_newConversation()}</h2>
         <div className="ml-auto flex items-center gap-1">
           <Button
@@ -483,7 +590,7 @@ export default function HarnessWorkbenchPage({ initialThreadId, initialMessages
         </div>
       </div>
 
-      {!hasAiKey && (
+      {!hasAiKey && engine !== "local" && (
         <div className="mx-6 mt-3 flex items-center gap-2 rounded-lg border border-amber-200 bg-amber-50 p-3 dark:border-amber-900 dark:bg-amber-950">
           <AlertCircle className="size-4 shrink-0 text-amber-600 dark:text-amber-400" />
           <p className="flex-1 text-xs text-amber-700 dark:text-amber-300">
@@ -493,6 +600,16 @@ export default function HarnessWorkbenchPage({ initialThreadId, initialMessages
         </div>
       )}
 
+      {!hasAiKey && engine === "local" && (
+        <div className="mx-6 mt-3 flex items-center gap-2 rounded-lg border border-border bg-muted/40 p-3">
+          <AlertCircle className="size-4 shrink-0 text-muted-foreground" />
+          <p className="flex-1 text-xs text-muted-foreground">
+            {m.harness_engine_localNeedsProvider()}
+          </p>
+          <Button render={<RouterLink to="/settings/ai" />} size="sm" variant="outline" className="shrink-0 h-7 text-xs" nativeButton={false}>{m.chat_goToSettings()}</Button>
+        </div>
+      )}
+
       {chat.error && !retryDismissed && (
         <RetryCountdownBar
           error={{ message: chat.error.message, retryable: (chat.error as unknown as { retryable?: boolean }).retryable ?? true }}
@@ -549,6 +666,11 @@ export default function HarnessWorkbenchPage({ initialThreadId, initialMessages
             sandboxPolicy={sandboxPolicy}
             onSandboxPolicyChange={setSandboxPolicy}
             handoffContext={handoffContext}
+            engine={engine}
+            onEngineChange={handleEngineChange}
+            localCwd={localCwd}
+            onLocalCwdChange={handleLocalCwdChange}
+            engineLocked={chat.messages.length > 0}
           />
           <ConnectionIndicator
             status={chat.connectionStatus === "error" || chat.error ? "disconnected" : chat.connectionStatus === "connecting" ? "reconnecting" : "hidden"}