@jetcrab/pi-desk 1.1.34-dev → 1.1.38-dev

package/src/common/l3_modules/conversation/l3-conversation-locale-messages.ts

@@ -7,7 +7,7 @@ export const L3_CONVERSATION_LOCALE_MESSAGES = {
       unknownModel: 'Unknown model',
       input: 'Input',
       output: 'Output',
-      cached: 'Cache',
+      cached: 'Cached input',
       cost: 'Cost',
       error: 'Failed',
       aborted: 'Aborted',
@@ -17,7 +17,8 @@ export const L3_CONVERSATION_LOCALE_MESSAGES = {
     nestedCallsIncomplete: 'Nested calls · Incomplete record',
     nestedStatus: { ok: 'Completed', error: 'Failed', unfinished: 'Unfinished' },
     nestedArguments: 'Arguments',
-    nestedArgumentsBytes: 'Arguments: {{count}} bytes',
+    nestedArgumentsBytes_one: 'Arguments: {{count}} byte',
+    nestedArgumentsBytes_other: 'Arguments: {{count}} bytes',
     image: 'Markdown image',
     imageUnavailable: 'Image unavailable',
     previewImage: 'Preview image: {{name}}',
@@ -36,11 +37,12 @@ export const L3_CONVERSATION_LOCALE_MESSAGES = {
     expand: 'Show full message',
     collapse: 'Collapse',
     thinking: 'Thinking…',
-    thinkingLoading: 'Loading thoughts…',
-    thinkingUnavailable: 'Thoughts unavailable',
-    thinkingProcess: 'Reasoning',
-    thinkingTruncated: 'Showing the last {{count}} characters',
-    copyThinking: 'Copy full reasoning',
+    thinkingLoading: 'Loading thinking content…',
+    thinkingUnavailable: 'Thinking content unavailable',
+    thinkingProcess: 'Thinking',
+    thinkingTruncated_one: 'Showing the last {{count}} character',
+    thinkingTruncated_other: 'Showing the last {{count}} characters',
+    copyThinking: 'Copy thinking content',
     streamInterrupted: 'The response stream ended before the model completed its answer.',
     requestTimedOut: 'The model did not complete its response in time.',
     modelFailed: 'The model request failed without a detailed error.',
@@ -60,7 +62,7 @@ export const L3_CONVERSATION_LOCALE_MESSAGES = {
     pideskListPlugins: 'View plugins',
     pideskShowPlugin: 'View plugin',
     pideskInstallPlugin: 'Install plugin',
-    pideskRemovePlugin: 'Remove plugin',
+    pideskRemovePlugin: 'Uninstall plugin',
     pidesk: {
       command: 'Command',
       output: 'Output',
@@ -69,8 +71,8 @@ export const L3_CONVERSATION_LOCALE_MESSAGES = {
       empty: 'No output',
       noPlugins: 'No plugins',
       unknownVersion: 'Version unknown',
-      updateChannel: 'Following {{tag}}',
-      targetVersion: 'Available version {{version}}',
+      updateChannel: 'Update channel: {{tag}}',
+      targetVersion: 'Target version: {{version}}',
       restartRequired: 'Pi Desk needs to be restarted',
       pluginDetail: 'Plugin details',
       info: {
@@ -90,7 +92,7 @@ export const L3_CONVERSATION_LOCALE_MESSAGES = {
         disabled: 'Disabled',
         failed: 'Load failed'
       },
-      action: { add: 'Install', update: 'Update', del: 'Remove', apply: 'Load changes' },
+      action: { add: 'Install', update: 'Update', del: 'Uninstall', apply: 'Load changes' },
       phase: {
         queued: 'Queued',
         checking: 'Checking',
@@ -100,7 +102,7 @@ export const L3_CONVERSATION_LOCALE_MESSAGES = {
       },
       errorPhase: {
         package: 'Package',
-        entry: 'Entry',
+        entry: 'Entry point',
         setup: 'Initialization',
         resources: 'Resources',
         resolve: 'Resolution',
@@ -121,12 +123,12 @@ export const L3_CONVERSATION_LOCALE_MESSAGES = {
     writeContent: 'Written file content',
     writeResult: 'Write tool result',
     emptyMessage: 'Empty message',
-    compactionSummary: 'Context summary',
-    compactionSummaryContent: 'Context summary content',
-    compactionRunning: 'Summarizing context…',
-    compactionComplete: 'Context summary complete',
-    compactionLoading: 'Loading context summary…',
-    compactionUnavailable: 'Context summary unavailable',
+    compactionSummary: 'Compaction summary',
+    compactionSummaryContent: 'Compaction summary content',
+    compactionRunning: 'Compacting context…',
+    compactionComplete: 'Context compacted',
+    compactionLoading: 'Loading compaction summary…',
+    compactionUnavailable: 'Compaction summary unavailable',
     processGroup: 'Activity',
     toolCalls_one: '{{count}} tool call',
     toolCalls_other: '{{count}} tool calls',
@@ -165,7 +167,8 @@ export const L3_CONVERSATION_LOCALE_MESSAGES = {
     nestedCallsIncomplete: '嵌套调用 · 记录未完整',
     nestedStatus: { ok: '完成', error: '失败', unfinished: '未完成' },
     nestedArguments: '调用参数',
-    nestedArgumentsBytes: '参数 {{count}} 字节',
+    nestedArgumentsBytes_one: '参数 {{count}} 字节',
+    nestedArgumentsBytes_other: '参数 {{count}} 字节',
     image: 'Markdown 图片',
     imageUnavailable: '图片暂不可用',
     previewImage: '预览图片：{{name}}',
@@ -187,7 +190,8 @@ export const L3_CONVERSATION_LOCALE_MESSAGES = {
     thinkingLoading: '正在加载思考内容…',
     thinkingUnavailable: '思考内容不可用',
     thinkingProcess: '思考过程',
-    thinkingTruncated: '仅显示最近 {{count}} 个字符',
+    thinkingTruncated_one: '仅显示最近 {{count}} 个字符',
+    thinkingTruncated_other: '仅显示最近 {{count}} 个字符',
     copyThinking: '复制完整思考',
     streamInterrupted: '模型响应流意外中断：连接在回答完成前被关闭。',
     requestTimedOut: '模型请求超时：在限定时间内未收到完整响应。',

package/src/common/l3_modules/project-files/l3-project-files-locale-messages.ts

@@ -33,18 +33,19 @@ export const L3_PROJECT_FILES_LOCALE_MESSAGES = {
     searchStart: 'Search this project',
     searchTryOptions: 'Try another query or adjust the search options.',
     searchFailed: 'Could not search the project. Please try again.',
-    searchCounts: '{{files}} files · {{lines}} matching lines',
+    searchCounts: 'Files: {{files}} · Matching lines: {{lines}}',
     searchShownCounts: 'Shown: {{counts}}',
     searchFileHeading: 'Filenames',
     searchContentHeading: 'Content',
-    searchContentCounts: '{{lines}} matching lines · {{files}} files',
+    searchContentCounts: 'Matching lines: {{lines}} · Files: {{files}}',
     searchProjectRoot: 'Project root',
-    searchExpandFiles: 'Show {{count}} more files',
+    searchExpandFiles_one: 'Show {{count}} more file',
+    searchExpandFiles_other: 'Show {{count}} more files',
     searchOpenLine: 'Open {{path}}, line {{line}}',
     searchLineUnavailable: 'The file content has changed and the matching line no longer exists.',
     searchTextLimit: 'Content search: previewable UTF-8 text up to 5 MiB.',
     closeSearch: 'Exit search',
-    layout: 'File organization',
+    layout: 'Group files by',
     directory: 'Folders',
     repository: 'Repositories',
     changesOnly: 'Changes only',
@@ -72,14 +73,19 @@ export const L3_PROJECT_FILES_LOCALE_MESSAGES = {
     copyContentFailed: 'Could not copy the file. Please copy it manually.',
     fileActions: 'File actions',
     headToWorking: 'HEAD ↔ working tree',
-    gitChangesCount: 'Against HEAD · {{count}} changes',
-    gitChangesCompact: '{{count}} changes',
+    gitChangesCount_one: 'Against HEAD · {{count}} change',
+    gitChangesCount_other: 'Against HEAD · {{count}} changes',
+    gitChangesCompact_one: '{{count}} change',
+    gitChangesCompact_other: '{{count}} changes',
     gitMarkersLoading: 'Comparing with HEAD…',
     gitMarkersFailed: 'Could not read changes · Reload to retry',
     gitMarkersUnavailable: 'Line change markers unavailable',
-    gitAddedLines: '{{count}} lines added',
-    gitModifiedLines: '{{count}} lines modified',
-    gitDeletedLines: '{{count}} lines deleted',
+    gitAddedLines_one: '{{count}} line added',
+    gitAddedLines_other: '{{count}} lines added',
+    gitModifiedLines_one: '{{count}} line modified',
+    gitModifiedLines_other: '{{count}} lines modified',
+    gitDeletedLines_one: '{{count}} line deleted',
+    gitDeletedLines_other: '{{count}} lines deleted',
     noDiffChanges: ' · No content differences',
     previousChange: 'Previous change',
     nextChange: 'Next change',
@@ -99,8 +105,8 @@ export const L3_PROJECT_FILES_LOCALE_MESSAGES = {
     goToLine: 'Go to line',
     copySelectionOrAll: 'Copy selected or all content',
     reloadCurrentFile: 'Reload this file',
-    binaryDiffUnavailable: 'Binary files cannot be diffed online.',
-    largeDiffUnavailable: 'Files over 5 MB cannot be diffed online.',
+    binaryDiffUnavailable: 'Diff previews are not available for binary files.',
+    largeDiffUnavailable: 'Diff previews are not available for files over 5 MB.',
     readAgain: 'Reload',
     noOpenFile: 'No file open',
     imageViewer: '{{name}} image viewer',
@@ -162,7 +168,8 @@ export const L3_PROJECT_FILES_LOCALE_MESSAGES = {
     searchContentHeading: '内容',
     searchContentCounts: '{{lines}} 个命中行 · {{files}} 个文件',
     searchProjectRoot: '项目根目录',
-    searchExpandFiles: '展开其余 {{count}} 个文件',
+    searchExpandFiles_one: '展开其余 {{count}} 个文件',
+    searchExpandFiles_other: '展开其余 {{count}} 个文件',
     searchOpenLine: '打开 {{path}} 第 {{line}} 行',
     searchLineUnavailable: '文件内容已变化，搜索命中行已不存在',
     searchTextLimit: '正文搜索：可预览的 UTF-8 文本，不超过 5 MiB。',
@@ -195,14 +202,19 @@ export const L3_PROJECT_FILES_LOCALE_MESSAGES = {
     copyContentFailed: '复制文件内容失败，请手动复制。',
     fileActions: '文件操作',
     headToWorking: 'HEAD ↔ 工作区',
-    gitChangesCount: '相对 HEAD · {{count}} 处变更',
-    gitChangesCompact: '{{count}} 处变更',
+    gitChangesCount_one: '相对 HEAD · {{count}} 处变更',
+    gitChangesCount_other: '相对 HEAD · {{count}} 处变更',
+    gitChangesCompact_one: '{{count}} 处变更',
+    gitChangesCompact_other: '{{count}} 处变更',
     gitMarkersLoading: '正在与 HEAD 比较…',
     gitMarkersFailed: '变更读取失败 · 刷新重试',
     gitMarkersUnavailable: '此文件无法显示行变更',
-    gitAddedLines: '新增 {{count}} 行',
-    gitModifiedLines: '修改 {{count}} 行',
-    gitDeletedLines: '删除 {{count}} 行',
+    gitAddedLines_one: '新增 {{count}} 行',
+    gitAddedLines_other: '新增 {{count}} 行',
+    gitModifiedLines_one: '修改 {{count}} 行',
+    gitModifiedLines_other: '修改 {{count}} 行',
+    gitDeletedLines_one: '删除 {{count}} 行',
+    gitDeletedLines_other: '删除 {{count}} 行',
     noDiffChanges: ' · 当前比较无内容差异',
     previousChange: '上一个变更',
     nextChange: '下一个变更',

package/src/common/l4_foundation/locale/l4-host-error-messages.ts

@@ -69,9 +69,9 @@ export const L4_HOST_ERROR_MESSAGES = {
     modelSettingsGetInvalid: 'Invalid model settings request',
     modelSettingsGetFailed: 'Could not read model settings',
     projectDefaultInputInvalid: 'Invalid project directory',
-    projectDefaultGetFailed: 'Could not read project model default',
-    projectDefaultSaveInvalid: 'Invalid project model default',
-    projectDefaultSaveFailed: 'Could not save project model default',
+    projectDefaultGetFailed: 'Could not read the project default model',
+    projectDefaultSaveInvalid: 'Invalid project default model',
+    projectDefaultSaveFailed: 'Could not save the project default model',
     modelsListFailed: 'Could not list models',
     directoryBrowseInvalid: 'Invalid directory browser request',
     directoryMissing: 'Directory not found or is not a folder',
@@ -101,7 +101,7 @@ export const L4_HOST_ERROR_MESSAGES = {
     sessionTreeEntryFailed: 'Could not read session tree entry',
     branchInputInvalid: 'Invalid branch operation request',
     branchEntryMissing: 'Branch entry not found or no longer available',
-    branchForkUserOnly: 'Only user messages can start a new session',
+    branchForkUserOnly: 'Sessions can only be forked from user messages',
     branchResendUserOnly: 'Only user messages can be resent',
     branchCloneEmpty: 'There are no messages to clone yet',
     branchFailed: 'Could not perform branch operation',
@@ -137,7 +137,7 @@ export const L4_HOST_ERROR_MESSAGES = {
     pluginResourceReadFailed: 'Could not read plugin browser resource',
     hostResourceMissing: 'Host plugin resource not found',
     hostRuntimeUnavailable: 'Host plugin runtime is not built',
-    hostResourceReadFailed: 'Could not read Host plugin resource',
+    hostResourceReadFailed: 'Could not read host plugin resource',
     gitAddJsonInvalid: 'Invalid JSON for new Git branch',
     gitAddInputInvalid: 'Invalid new Git branch request',
     gitAddFailed: 'Could not create Git branch',

package/src/server/l2_biz/plugin-management/l2-plugin-commands.ts

@@ -2,6 +2,7 @@ import 'server-only'
 
 import { getAgentDir } from '@earendil-works/pi-coding-agent'
 import { selectL4LocalizedText } from '@common/l4_foundation/locale/l4-localized-text'
+import { l4PluginSourceIdentity } from '@common/l4_foundation/plugin/l4-plugin-package'
 import type {
   L2PluginManagementItem,
   L2PluginManagementSnapshot
@@ -73,9 +74,6 @@ async function resolveTargets(
     }
     if (command.action === 'remove') {
       if (!existing) throw new Error(`插件不存在：${name}`)
-      if (existing.kind !== 'package') {
-        throw new Error(`当前插件管理只支持卸载包来源，不支持卸载裸扩展：${name}`)
-      }
       targets.set(existing.source, { name, source: existing.source, local: false })
       continue
     }
@@ -173,15 +171,18 @@ function completedResult(
   snapshot: L2PluginManagementSnapshot,
   agentDir: string
 ): string {
+  if (command.action === 'remove') {
+    const identity = l4PluginSourceIdentity(target.source)
+    if (snapshot.plugins.some((item) => l4PluginSourceIdentity(item.source) === identity)) {
+      throw new Error('卸载后仍发现该来源，无法确认卸载完成')
+    }
+    return '成功：已卸载并完成宿主插件应用'
+  }
   const item = findL2PluginCommandTarget(
     snapshot.plugins,
     readL2PluginNpmName(target.source) ?? target.name,
     agentDir
   )
-  if (command.action === 'remove') {
-    if (item) throw new Error('卸载后仍发现该包来源，无法确认卸载完成')
-    return '成功：已卸载并完成宿主插件应用'
-  }
   if (!item) throw new Error('未发现安装后的插件，无法确认生效')
   if (item.error) throw new Error(selectL4LocalizedText(item.error.message, 'zh-CN'))
   if (item.status === 'disabled') throw new Error('该插件仍被现有配置禁用，尚未生效')

package/src/server/l2_biz/plugin-management/l2-plugin-management.ts

@@ -40,9 +40,11 @@ import { readL4PluginReadme } from '@server/l4_foundation/pi/l4-pi-plugin-regist
 import {
   readL4PiPluginPreferences,
   readL4PiPluginUpdateTag,
+  removeL4PiPluginPreference,
   setL4PiPluginUpdateTag,
   setL4PiPluginEnabled
 } from '@server/l4_foundation/pi/l4-pi-plugin-preferences'
+import { removeL4PiLocalExtension } from '@server/l4_foundation/pi/l4-pi-local-extension-maintenance'
 import { getL4PiGlobalPluginRuntime } from '@server/l4_foundation/pi/l4-pi-global-plugin-runtime'
 import {
   L4PiPackageMaintenanceError,
@@ -109,6 +111,7 @@ interface L2PluginPreparedMutation {
   request: L4PiDeskPackageMaintenanceRequest | null
   updateTag: string | null
   pluginName: string | null
+  localExtension?: boolean
 }
 
 export interface L2PluginManagementWorkSessions {
@@ -739,7 +742,12 @@ export class L2PluginManagement {
     )
     if (mutation !== 'add') {
       if (!existing) throw new L2PluginManagementNotFoundError(source)
-      if (existing.kind !== 'package' && mutation !== 'enable' && mutation !== 'disable') {
+      if (
+        existing.kind !== 'package' &&
+        mutation !== 'del' &&
+        mutation !== 'enable' &&
+        mutation !== 'disable'
+      ) {
         throw new L2PluginManagementInvalidPackageError(
           '裸扩展不是已安装包，请编辑源码后加载变更；此操作不会删除源码'
         )
@@ -834,6 +842,18 @@ export class L2PluginManagement {
       .listConfiguredPackages()
       .filter((item) => item.scope === 'user')
     const target = configured.find((item) => item.source === operationSource)
+    if (mutation === 'del' && !target) {
+      const existing = (await this.readSources()).sources.find(
+        (item) => item.source === operationSource
+      )
+      if (!existing) throw new L2PluginManagementNotFoundError(source)
+      return {
+        request: null,
+        updateTag: null,
+        pluginName: null,
+        ...(existing.kind === 'extension' ? { localExtension: true } : {})
+      }
+    }
     let request: L4PiDeskPackageMaintenanceRequest | null = null
     let updateTag: string | null = null
     let pluginName: string | null = null
@@ -876,7 +896,7 @@ export class L2PluginManagement {
     prepared: L2PluginPreparedMutation
   ): Promise<void> {
     const { mutation, source, operationSource } = input
-    const { request, updateTag, pluginName } = prepared
+    const { request, updateTag, pluginName, localExtension } = prepared
     const runtime = getL4PiGlobalPluginRuntime()
     const waiting = (reason: string): void => this.setOperation(operationSource, 'waiting', reason)
     if (request) {
@@ -919,6 +939,26 @@ export class L2PluginManagement {
             this.sourceCache = null
             throw error
           }
+        } else if (mutation === 'del' && !request) {
+          await runtime.replaceSource(operationSource, null)
+          if (localExtension) {
+            await removeL4PiLocalExtension({
+              source: operationSource,
+              agentDir: this.agentDir,
+              cwd: this.packageManagerCwd
+            })
+          } else {
+            removeL4PiPluginPreference(operationSource, this.agentDir)
+          }
+          for (const change of await runtime.scanSourceChanges([operationSource])) {
+            if (change.current) {
+              throw new L2PluginManagementInvalidPackageError(
+                '该来源仍被全局资源规则引用，请先移除对应规则后重试卸载'
+              )
+            }
+            await runtime.applySourceChange(change)
+            if (change.previous?.path) clearL4PiPluginNativeDiagnostics(change.previous.path)
+          }
         } else if (request) {
           try {
             await runtime.replaceSource(operationSource, null)
@@ -1065,6 +1105,15 @@ export class L2PluginManagement {
       DefaultPackageManager,
       SettingsManager
     })
+    const current = new Set(snapshot.sources.map((item) => l2PluginSourceIdentity(item.source)))
+    for (const previous of getL4PiGlobalPluginRuntime().readAppliedSources()) {
+      if (!current.has(l2PluginSourceIdentity(previous.source))) {
+        snapshot.sources.push({
+          ...previous,
+          error: '插件来源已移除，运行资源尚未卸载'
+        })
+      }
+    }
     if (!writing() || !this.sourceCache) this.sourceCache = snapshot
     return writing() && this.sourceCache ? this.sourceCache : snapshot
   }

package/src/server/l4_foundation/pi/l4-pi-global-plugin-runtime.ts

@@ -9,7 +9,11 @@ import {
 } from '@earendil-works/pi-coding-agent'
 import { L4PiPluginOwnerRuntime, type L4PiPluginPackageSource } from './l4-pi-plugin-owner-runtime'
 import { isL4PiDeskSafeMode } from './l4-pi-desk-mode'
-import { discoverL4PiPluginSources, type L4PiPluginSourceSnapshot } from './l4-pi-plugin-sources'
+import {
+  discoverL4PiPluginSources,
+  type L4PiPluginSource,
+  type L4PiPluginSourceSnapshot
+} from './l4-pi-plugin-sources'
 import { L4PiPluginSourceChanges, type L4PiPluginSourceChange } from './l4-pi-plugin-source-changes'
 import { clearL4PiPluginCodeCache } from './l4-pi-plugin-module-loader'
 
@@ -44,6 +48,10 @@ export class L4PiGlobalPluginRuntime extends L4PiPluginOwnerRuntime {
     this.discover = discover
   }
 
+  readAppliedSources(): L4PiPluginSource[] {
+    return this.sourceChanges.readAppliedSources()
+  }
+
   async scanSourceChanges(sources?: readonly string[]): Promise<L4PiPluginSourceChange[]> {
     await this.initialize()
     return this.sourceChanges.scan(await this.discover(), sources)

package/src/server/l4_foundation/pi/l4-pi-local-extension-maintenance.ts

@@ -0,0 +1,118 @@
+import 'server-only'
+
+import { readdir, realpath, rm, stat } from 'node:fs/promises'
+import { homedir } from 'node:os'
+import { join, resolve } from 'node:path'
+import { SettingsManager } from '@earendil-works/pi-coding-agent'
+import { l4PluginSourceIdentity } from '@common/l4_foundation/plugin/l4-plugin-package'
+import { getL4FileSystemKey, isL4PathInsideRoot } from '@server/l4_foundation/file/l4-file-path'
+import { readL4PiPluginPreferences, removeL4PiPluginPreference } from './l4-pi-plugin-preferences'
+
+function isMissing(error: unknown): boolean {
+  return (
+    error !== null &&
+    typeof error === 'object' &&
+    'code' in error &&
+    (error.code === 'ENOENT' || error.code === 'ENOTDIR')
+  )
+}
+
+async function canonical(path: string): Promise<string> {
+  try {
+    return getL4FileSystemKey(await realpath(path))
+  } catch (error) {
+    if (!isMissing(error)) throw error
+    return getL4FileSystemKey(resolve(path))
+  }
+}
+
+export async function removeL4PiLocalExtension(input: {
+  source: string
+  agentDir: string
+  cwd: string
+}): Promise<void> {
+  const { source, agentDir, cwd } = input
+  try {
+    const settings = SettingsManager.create(cwd, agentDir, { projectTrusted: false })
+    const initialErrors = settings.drainErrors()
+    if (initialErrors.length) {
+      throw new Error(
+        `读取扩展配置失败：${initialErrors.map(({ error }) => error.message).join('；')}`
+      )
+    }
+
+    const target = await canonical(source)
+    const metadata = await stat(source).catch((error: unknown) => {
+      if (!isMissing(error)) throw error
+      return null
+    })
+    const configured = settings.getGlobalSettings().extensions ?? []
+    const retained: string[] = []
+    for (const reference of configured) {
+      // 规则可能同时加载其他来源，留给卸载后的真实发现校验处理。
+      if (/^[!+-]|[*?{}[\]()]/.test(reference)) {
+        retained.push(reference)
+        continue
+      }
+      const path = await canonical(
+        reference.startsWith('~/')
+          ? join(homedir(), reference.slice(2))
+          : resolve(agentDir, reference)
+      )
+      if (
+        path !== target &&
+        !((metadata === null || metadata.isDirectory()) && isL4PathInsideRoot(target, path))
+      ) {
+        retained.push(reference)
+      }
+    }
+
+    const extensionDir = join(agentDir, 'extensions')
+    const entries = await readdir(extensionDir, { withFileTypes: true }).catch((error: unknown) => {
+      if (!isMissing(error)) throw error
+      return []
+    })
+    const removals: Array<{ path: string; recursive: boolean }> = []
+    for (const entry of entries) {
+      if (entry.name.startsWith('.') || entry.name === 'node_modules') continue
+      const path = join(extensionDir, entry.name)
+      if ((await canonical(path)) === target) {
+        removals.push({ path, recursive: !entry.isSymbolicLink() && entry.isDirectory() })
+      }
+    }
+    for (const entry of removals) {
+      // 使用原始入口路径；链接只删入口，不能用规范目标执行递归删除。
+      await rm(entry.path, { recursive: entry.recursive, force: true })
+    }
+
+    const removedReferences = configured.length - retained.length
+    if (removedReferences) {
+      settings.setExtensionPaths(retained)
+      await settings.flush()
+      const errors = settings.drainErrors()
+      if (errors.length) {
+        throw new Error(`保存扩展配置失败：${errors.map(({ error }) => error.message).join('；')}`)
+      }
+    }
+
+    const preferences = readL4PiPluginPreferences(agentDir)
+    const identity = l4PluginSourceIdentity(source)
+    const hasPreference =
+      preferences.disabled.includes(identity) ||
+      identity in preferences.registries ||
+      identity in preferences.updateTags
+    if (hasPreference) removeL4PiPluginPreference(source, agentDir)
+
+    if (removals.length || removedReferences || hasPreference) {
+      console.info('[Pi Desk][LocalExtension] 已移除本地扩展入口与加载声明', {
+        source,
+        entries: removals.length,
+        references: removedReferences
+      })
+    }
+  } catch (error) {
+    throw new Error(`移除本地扩展失败：${error instanceof Error ? error.message : String(error)}`, {
+      cause: error
+    })
+  }
+}

package/src/server/l4_foundation/pi/l4-pi-plugin-owner-runtime.ts

@@ -437,7 +437,10 @@ export class L4PiPluginOwnerRuntime {
 
     this.changingSources.add(source)
     try {
-      if (owner) void this.releaseOwner(owner)
+      if (owner) {
+        const released = this.releaseOwner(owner)
+        if (installedPath === null) await released
+      }
       if (this.disposed) throw new Error('Global plugin runtime has been disposed')
       clearL4PiPluginCodeCache()
       this.packageDiagnostics.delete(source)

package/src/server/l4_foundation/pi/l4-pi-plugin-source-changes.ts

@@ -109,6 +109,10 @@ export class L4PiPluginSourceChanges {
     for (const source of snapshot.sources) this.applied.set(source.source, await describe(source))
   }
 
+  readAppliedSources(): L4PiPluginSource[] {
+    return structuredClone([...this.applied.values()].map((item) => item.source))
+  }
+
   async scan(
     snapshot: L4PiPluginSourceSnapshot,
     requested?: readonly string[]

package/src/server/l4_foundation/pidesk/l4-pidesk-command.ts

@@ -63,7 +63,7 @@ const definitions: readonly CommandDefinition[] = [
   },
   {
     path: ['plugins', 'remove'],
-    description: '卸载一个或多个包来源；完成后向本会话汇总结果',
+    description: '卸载包、本地扩展或残留来源并释放实例；完成后向本会话汇总结果',
     name: 'multiple',
     scope: 'required'
   }

package/temp/build/pi-desk/release/.next/BUILD_ID

@@ -1 +1 @@
-SEeF4XXo-IRzX6G2WyyuJ
+ljXlpZIQpD6BvWyD8Fmc3

package/temp/build/pi-desk/release/.next/build-manifest.json

@@ -4,8 +4,8 @@
   ],
   "devFiles": [],
   "lowPriorityFiles": [
-    "static/SEeF4XXo-IRzX6G2WyyuJ/_buildManifest.js",
-    "static/SEeF4XXo-IRzX6G2WyyuJ/_ssgManifest.js"
+    "static/ljXlpZIQpD6BvWyD8Fmc3/_buildManifest.js",
+    "static/ljXlpZIQpD6BvWyD8Fmc3/_ssgManifest.js"
   ],
   "rootMainFiles": [
     "static/chunks/webpack-a84310d111797bef.js",

package/temp/build/pi-desk/release/.next/required-server-files.js

@@ -2,8 +2,8 @@ self.__SERVER_FILES_MANIFEST={
   "version": 1,
   "config": {
     "env": {
-      "PI_DESK_APP_VERSION": "1.1.34-dev",
-      "PI_DESK_VERSION_UPDATED_AT": "2026-11-01T23:00:44-08:00"
+      "PI_DESK_APP_VERSION": "1.1.38-dev",
+      "PI_DESK_VERSION_UPDATED_AT": "2026-11-03T13:31:38+08:00"
     },
     "webpack": null,
     "typescript": {

package/temp/build/pi-desk/release/.next/required-server-files.json

@@ -2,8 +2,8 @@
   "version": 1,
   "config": {
     "env": {
-      "PI_DESK_APP_VERSION": "1.1.34-dev",
-      "PI_DESK_VERSION_UPDATED_AT": "2026-11-01T23:00:44-08:00"
+      "PI_DESK_APP_VERSION": "1.1.38-dev",
+      "PI_DESK_VERSION_UPDATED_AT": "2026-11-03T13:31:38+08:00"
     },
     "webpack": null,
     "typescript": {