@jetcrab/pi-desk 1.1.16 → 1.1.20-dev

package/docs/plugins.md

@@ -99,6 +99,8 @@ react-dom/client
 @jetcrab/pi-desk-sdk/react/markdown
 ```
 
+`PluginMarkdown` 会高亮带语言标记的代码块（例如 `sql`），语言和主题资源按需加载；插件不需要另装高亮库。它只负责展示，不格式化代码；SQL 等业务格式化依赖由对应插件维护。
+
 复用宿主 React 与 UI，不复制或打包第二套公共运行时。`/browser` 不在白名单中：普通函数无需包装；`copyBrowserText` 等 SDK Browser 运行函数需要构建时打入插件模块，不能原样留下裸 import。其他业务依赖也需构建为相对模块。无构建示例用 JS `createElement`；TSX、TypeScript 浏览器文件需要先编译为 JS。
 
 Application 使用 `chrome: 'host'` 让宿主负责 Dialog、标题、关闭、焦点、Escape、Loading/Error 和视口约束；内容自然决定尺寸，不替换工作台。React mount 使用 `createRoot`、`PluginHostProvider`、`PluginErrorBoundary` 和公共控件；disposer 调用 `root.unmount()`，释放自建 Listener、Timer、Observer、Object URL。宿主先 abort `signal`，迟到结果必须忽略。
@@ -209,7 +211,7 @@ export default {
 - 首屏和实时必需内容放 `summary`；大内容或用户展开后才用的数据放 `detail`。需要详情时，仅在消息已有 `entryId` 且 `fixed.hasDetail` 为真后调用 `target.message.loadDetail()`；异步结果须检查挂载的 `signal`，不能写回失效视图。
 - 视图从 `getSnapshot()` 读取完整当前状态，并通过 `subscribe()` 跟随更新；同 `viewKey` 的消息更新不重新挂载，Temporary 转 Durable 保持同一 Handle，`viewKey` 改变时会重挂。释放时解除订阅并清理自有资源。
 - Declaration 和 View 分别按 `priority` 选择，数值越大越优先；同最高优先级冲突会报错。声明、加载或展示失败不自动尝试低优先级实现；异步展示错误通过 `target.reportError(error)` 交给宿主处理。
-- 刷新后仍需展示的数据必须存在于最终 Pi Entry，仅通过 Tool `onUpdate()` 提供的数据不会自动持久化。更新插件时兼容已有消息结构，不靠自动重载旧会话解决兼容问题。
+- 刷新后仍需展示的数据必须存在于最终 Pi Entry，仅通过 Tool `onUpdate()` 提供的数据不会自动持久化。插件初始化、更新和热加载不自动重投影或重传旧聊天，新消息使用当前声明；Browser View 需兼容已有消息结构，不靠自动重载旧会话解决兼容问题。
 
 ## 任务
 

package/next.config.ts

@@ -42,6 +42,7 @@ const nextConfig: NextConfig = {
         ? 'temp/next-dev'
         : 'temp/build/pi-desk/release/.next',
   serverExternalPackages: [
+    '@vscode/ripgrep',
     '@earendil-works/pi-coding-agent',
     '@earendil-works/pi-agent-core',
     '@earendil-works/pi-ai',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jetcrab/pi-desk",
-  "version": "1.1.16",
+  "version": "1.1.20-dev",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -37,6 +37,7 @@
     "@streamdown/code": "^1.1.1",
     "@streamdown/math": "^1.0.2",
     "@streamdown/mermaid": "^1.0.2",
+    "@vscode/ripgrep": "1.18.0",
     "@xterm/addon-fit": "0.11.0",
     "@xterm/addon-serialize": "0.14.0",
     "@xterm/headless": "6.0.0",
@@ -69,7 +70,7 @@
     "viewerjs": "^1.11.8",
     "ws": "^8.21.3",
     "zod": "^4.4.3",
-    "@jetcrab/pi-desk-sdk": "^1.1.6"
+    "@jetcrab/pi-desk-sdk": "^1.1.7-dev"
   },
   "devDependencies": {
     "@earendil-works/pi-agent-core": "1.2.0",
@@ -111,7 +112,7 @@
     "build:plugin-host-runtime": "pnpm --filter @jetcrab/pi-desk-sdk build",
     "start": "node bin/pi-desk.js --no-open",
     "test:package": "node --test tests/l4-pi-desk-package.test.mjs",
-    "test:pidesk": "node --import tsx --test tests/l4-pidesk-command.test.ts tests/l2-plugin-commands.test.ts tests/l4-pidesk-session-reload.test.ts tests/l4-pidesk-runtime.test.ts tests/l4-pidesk-runtime-bundle.test.mjs tests/l4-pidesk-docs.test.mjs tests/l4-pidesk-installed-runners.test.mjs tests/l4-pidesk-package-maintenance.test.ts tests/l4-pidesk-release-gate.test.mjs tests/l4-pi-global-runtime.test.mjs tests/l4-pi-desk-supervisor-cli.test.mjs",
+    "test:pidesk": "node --import tsx --test tests/l4-pidesk-command.test.ts tests/l2-plugin-commands.test.ts tests/l4-pidesk-session-reload.test.ts tests/l4-pidesk-runtime.test.ts tests/l4-pidesk-runtime-bundle.test.mjs tests/l4-pidesk-docs.test.mjs tests/l4-pidesk-installed-runners.test.mjs tests/l4-pidesk-package-maintenance.test.ts tests/l4-pidesk-release-gate.test.mjs tests/l4-pi-desk-process-tree.test.mjs tests/l4-pi-runner-process.test.ts tests/l4-pi-global-runtime.test.mjs tests/l4-pi-desk-supervisor-cli.test.mjs",
     "test:app-websocket": "pnpm build && node --import tsx --test tests/l2-chat-state.test.ts tests/l2-workbench-chat-repository.test.ts tests/l2-workbench-chat.test.ts tests/l2-workbench-layout.test.ts tests/l2-work-session-column-layout.test.ts tests/l2-work-session-update.test.ts tests/l1-app-websocket.test.mjs",
     "lint": "eslint .",
     "lint:production": "eslint . --ignore-pattern \"apps/desktop/**\" --ignore-pattern \"**/tests/**\" --ignore-pattern \"**/__tests__/**\" --ignore-pattern \"**/*.test.*\" --ignore-pattern \"**/*.spec.*\"",

package/src/client/l2_biz/workbench/file-workspace/l2-file-workspace-runtime.ts

@@ -346,7 +346,7 @@ export class L2FileWorkspaceRuntime {
       cwd,
       {
         list: (path, signal) => this.biz.list({ ...context, path }, signal),
-        search: (query, signal) => this.biz.search({ ...context, query }, signal),
+        search: (input, signal) => this.biz.search({ ...context, ...input }, signal),
         get: (path, imagePreviewMode, signal) =>
           this.biz.get({ ...context, path, imagePreviewMode }, signal),
         diff: (repositoryRoot, path, signal) =>

package/src/client/l2_biz/workbench/hooks/l2-workbench-chat-reload.ts

@@ -0,0 +1,42 @@
+'use client'
+
+import { useCallback, useMemo, useSyncExternalStore } from 'react'
+import { useTranslation } from 'react-i18next'
+import type { L2WorkSessionListItem } from '@common/l2_biz/work-session/l2-work-session-contract'
+import { useL4AppToast } from '@client/l4_foundation/ui/l4-app-toast'
+import type { L2WorkbenchChatRuntime } from '../l2-workbench-chat'
+
+export function useL2WorkbenchChatReload(
+  runtime: L2WorkbenchChatRuntime,
+  workSessions: readonly L2WorkSessionListItem[]
+): {
+  syncingWorkIds: readonly string[]
+  reload: (workSession: L2WorkSessionListItem) => void
+} {
+  const { t } = useTranslation('workbench')
+  const toast = useL4AppToast()
+  const getSyncing = useCallback(
+    (): string =>
+      JSON.stringify(
+        workSessions
+          .filter(
+            ({ workId, sessionId, branchId }) =>
+              runtime.getSourceState({ workId, sessionId, branchId }).syncStatus === 'syncing'
+          )
+          .map((session) => session.workId)
+      ),
+    [runtime, workSessions]
+  )
+  const syncing = useSyncExternalStore(runtime.subscribe, getSyncing, getSyncing)
+  const syncingWorkIds = useMemo((): string[] => JSON.parse(syncing), [syncing])
+  const reload = useCallback(
+    (session: L2WorkSessionListItem): void => {
+      const { workId, sessionId, branchId } = session
+      void runtime.reloadMessages({ workId, sessionId, branchId }).catch((cause: unknown) => {
+        toast.error(cause instanceof Error ? cause.message : t('reloadChatDataFailed'))
+      })
+    },
+    [runtime, t, toast]
+  )
+  return { syncingWorkIds, reload }
+}

package/src/client/l2_biz/workbench/l2-work-session-sidebar.tsx

@@ -140,6 +140,8 @@ interface L2WorkSessionSidebarProps {
   onTogglePin: (workId: string) => void
   onDelete: (workId: string) => void
   onRename: (workSession: L2WorkSessionListItem) => void
+  syncingWorkIds: readonly string[]
+  onReloadChat: (workSession: L2WorkSessionListItem) => void
   onArrangementChange: (arrangement: L2WorkSessionArrangement, movedWorkId: string) => void
 }
 
@@ -343,7 +345,9 @@ const SortableWorkSessionRow = memo(function SortableWorkSessionRow({
   onSelect,
   onTogglePin,
   onDelete,
-  onRename
+  onRename,
+  syncing,
+  onReloadChat
 }: {
   workSession: L2WorkSessionListItem
   mobile: boolean
@@ -357,6 +361,8 @@ const SortableWorkSessionRow = memo(function SortableWorkSessionRow({
   onTogglePin: (workId: string) => void
   onDelete: (workId: string) => void
   onRename: (workSession: L2WorkSessionListItem) => void
+  syncing: boolean
+  onReloadChat: (workSession: L2WorkSessionListItem) => void
 }): React.JSX.Element {
   const suppressTouchClick = useRef(false)
   const lastPointer = useRef('')
@@ -606,6 +612,14 @@ const SortableWorkSessionRow = memo(function SortableWorkSessionRow({
           <PencilIcon />
           {t('renameSessionTitle')}
         </ContextMenuItem>
+        <ContextMenuItem
+          data-testid={`work-session-reload-chat-${workSession.workId}`}
+          disabled={actionsDisabled || deleting || syncing}
+          onClick={() => onReloadChat(workSession)}
+        >
+          {syncing ? <LoaderCircleIcon className="animate-spin" /> : <RefreshCwIcon />}
+          {t('reloadChatData')}
+        </ContextMenuItem>
         <ContextMenuItem
           data-testid={`work-session-copy-project-path-${workSession.workId}`}
           onClick={copyProjectPath}
@@ -675,6 +689,8 @@ function L2WorkSessionSidebarComponent({
   onTogglePin,
   onDelete,
   onRename,
+  syncingWorkIds,
+  onReloadChat,
   onArrangementChange
 }: L2WorkSessionSidebarProps): React.JSX.Element {
   const { t } = useTranslation('workbench')
@@ -888,6 +904,8 @@ function L2WorkSessionSidebarComponent({
         onTogglePin={onTogglePin}
         onDelete={onDelete}
         onRename={onRename}
+        syncing={syncingWorkIds.includes(workSession.workId)}
+        onReloadChat={onReloadChat}
       />
     )
   })

package/src/client/l2_biz/workbench/l2-workbench-chat.ts

@@ -73,6 +73,7 @@ export interface L2WorkbenchChatRuntime {
   ) => Promise<L2ChatMessageDetail>
   compact: (source: L2ChatSource) => Promise<void>
   reload: (source: L2ChatSource, mode?: L2ChatMode) => Promise<void>
+  reloadMessages: (source: L2ChatSource) => Promise<void>
   setPresentation: (source: L2ChatSource, mode: L2ChatMode) => Promise<void>
   disconnected: () => void
   dispose: () => void
@@ -611,6 +612,50 @@ export function createL2WorkbenchChatRuntime(
       )
     },
 
+    async reloadMessages(sourceInput): Promise<void> {
+      const source = L2ChatSourceSchema.parse(sourceInput)
+      const key = sourceKey(source)
+      const workSession = currentWorkSessions.get(source.workId)
+      if (!workSession || !sameSource(sourceFor(workSession), source)) {
+        throw new Error(l2WorkbenchText('reloadChatSourceChanged'))
+      }
+      const previous = statesBySource.get(key)
+      if (
+        !workSessionsReady ||
+        disposed ||
+        pendingSyncs.has(key) ||
+        previous?.syncStatus === 'syncing'
+      ) {
+        throw new Error(l2WorkbenchText('sourceSyncing'))
+      }
+      const epoch = connectionEpoch
+      const queue = eventQueues.get(key)
+      const previousSyncEpoch = queue?.syncEpoch ?? null
+      if (queue) queue.syncEpoch = null
+      subscriptionPool.set(source.workId, source)
+      setSourceState(source, { ...(previous ?? EMPTY_CHAT_SOURCE_STATE), syncStatus: 'syncing' })
+      try {
+        // 重拉期间继续接收旧基线上的实时消息，失败时无需丢弃缓存或补偿重放。
+        await appSocket.request(L2ChatSocketContracts.subscribe, {
+          subscriptions: [{ source, cursor: null }]
+        })
+      } catch (error) {
+        if (!disposed && epoch === connectionEpoch && isCurrentAndSubscribed(source)) {
+          if (queue && eventQueues.get(key) === queue) queue.syncEpoch = previousSyncEpoch
+          const current = statesBySource.get(key)
+          if (current)
+            setSourceState(source, { ...current, syncStatus: previous?.syncStatus ?? 'loading' })
+        }
+        console.error('[Pi Desk][WorkbenchChat] 重新加载聊天数据失败，保留已有缓存', {
+          workId: source.workId,
+          sessionId: source.sessionId,
+          branchId: source.branchId,
+          message: error instanceof Error ? error.message : String(error)
+        })
+        throw error
+      }
+    },
+
     async setPresentation(sourceInput, mode): Promise<void> {
       const source = L2ChatSourceSchema.parse(sourceInput)
       const key = sourceKey(source)

package/src/client/l2_biz/workbench/l2-workbench.tsx

@@ -112,6 +112,7 @@ import {
 } from './l2-work-session-sidebar-order'
 import { useL2WorkbenchBranchPicker } from './hooks/l2-workbench-branch-picker'
 import { useL2WorkSessionRename } from './hooks/l2-work-session-rename'
+import { useL2WorkbenchChatReload } from './hooks/l2-workbench-chat-reload'
 import { L2WorkSessionRenameDialog } from './views/l2-work-session-rename-dialog'
 import { useL2WorkbenchPluginHealth } from './hooks/l2-workbench-plugin-health'
 import { useL2WorkbenchSessionHistory } from './hooks/l2-workbench-session-history'
@@ -370,6 +371,7 @@ export function L2Workbench({
       createL2WorkbenchChatRuntime(appSocket, (input) => workbenchBiz.getChatMessageDetail(input)),
     [appSocket, workbenchBiz]
   )
+  const chatReload = useL2WorkbenchChatReload(chatRuntime, workSessions)
   const chatInputRuntime = useMemo(
     () => createL2WorkbenchChatInputRuntime(workbenchBiz, chatRuntime),
     [chatRuntime, workbenchBiz]
@@ -1928,6 +1930,8 @@ export function L2Workbench({
       onTogglePin={togglePinnedWorkSession}
       onDelete={requestDeleteWorkSession}
       onRename={renameSession.show}
+      syncingWorkIds={chatReload.syncingWorkIds}
+      onReloadChat={chatReload.reload}
       onArrangementChange={requestArrangementUpdate}
     />
   )

package/src/client/l3_modules/conversation/l3-conversation-markdown.module.css

@@ -1,6 +1,7 @@
 .markdown {
   font-size: var(--chat-body-font-size, 0.875rem);
   line-height: 1.7;
+  overflow-wrap: anywhere;
 }
 
 .markdown > * {

package/src/client/l3_modules/conversation/l3-conversation-markdown.tsx

@@ -10,6 +10,12 @@ import { MessageResponse } from '@client/l4_foundation/ui/ai-elements/message'
 import { copyL4BrowserText } from '@client/l4_foundation/lib/l4-browser-clipboard'
 import { cn } from '@client/l4_foundation/lib/l4-utils'
 import { L4ImageViewer } from '@client/l4_foundation/ui/l4-image-viewer'
+import {
+  L4_MARKDOWN_ALLOWED_TAGS,
+  L4_MARKDOWN_CLASS_NAME,
+  L4_MARKDOWN_COMPONENTS,
+  L4_MARKDOWN_REMARK_PLUGINS
+} from '@client/l4_foundation/ui/markdown/l4-markdown'
 import { useL4AppToast } from '@client/l4_foundation/ui/l4-app-toast'
 import styles from './l3-conversation-markdown.module.css'
 
@@ -140,11 +146,14 @@ export function L3ConversationMarkdown({
   return (
     <div className="contents" onClickCapture={handleCodeCopyFallback}>
       <MessageResponse
-        className={cn('space-y-0', styles.markdown, className)}
+        className={cn('space-y-0', styles.markdown, L4_MARKDOWN_CLASS_NAME, className)}
         controls={COMPACT_CODE_CONTROLS}
         isAnimating={isAnimating}
         lineNumbers={false}
+        allowedTags={L4_MARKDOWN_ALLOWED_TAGS}
+        remarkPlugins={L4_MARKDOWN_REMARK_PLUGINS}
         components={{
+          ...L4_MARKDOWN_COMPONENTS,
           ...components,
           a: L3ConversationMarkdownLink,
           img: L3ConversationMarkdownImage

package/src/client/l3_modules/project-files/l3-markdown-preview.tsx

@@ -4,6 +4,12 @@ import { cjk } from '@streamdown/cjk'
 import { code } from '@streamdown/code'
 import { memo, useLayoutEffect, useRef } from 'react'
 import { Streamdown } from 'streamdown'
+import {
+  L4_MARKDOWN_ALLOWED_TAGS,
+  L4_MARKDOWN_CLASS_NAME,
+  L4_MARKDOWN_COMPONENTS,
+  L4_MARKDOWN_REMARK_PLUGINS
+} from '@client/l4_foundation/ui/markdown/l4-markdown'
 import styles from './l3-markdown-preview.module.css'
 
 const plugins = { cjk, code }
@@ -37,7 +43,10 @@ export const L3MarkdownPreview = memo(function L3MarkdownPreview({
       onScroll={(event) => onScroll(event.currentTarget.scrollTop)}
     >
       <Streamdown
-        className={styles.document}
+        className={`${styles.document} ${L4_MARKDOWN_CLASS_NAME}`}
+        allowedTags={L4_MARKDOWN_ALLOWED_TAGS}
+        components={L4_MARKDOWN_COMPONENTS}
+        remarkPlugins={L4_MARKDOWN_REMARK_PLUGINS}
         mode="static"
         parseIncompleteMarkdown={false}
         isAnimating={false}

package/src/client/l3_modules/project-files/l3-project-document-view.tsx

@@ -418,6 +418,8 @@ export function L3ProjectDocumentView({
             }}
             onOpenDiff={openDiff}
             savedState={document.editorState}
+            navigation={runtime.pendingNavigation}
+            onNavigation={(target, exists) => runtime.consumeNavigation(target, exists)}
             onSaveState={(path, state) => runtime.saveEditorState(path, state)}
             onEscape={escape}
           />