@jetcrab/pi-desk 1.1.1 → 1.1.5-dev

package/src/common/l3_modules/conversation/l3-conversation-pidesk.ts

@@ -179,7 +179,7 @@ const infoSchema = z
     mode: z.enum(['basic', 'normal']),
     cwd: z.string(),
     agentDir: z.string(),
-    skillDirectory: z.string()
+    docsDirectory: z.string()
   })
   .strict()
 

package/src/common/l4_foundation/plugin/l4-plugin-package.ts

@@ -25,6 +25,7 @@ export const L4PluginRegistrySchema = z
   }, '插件源必须是 HTTP 或 HTTPS 仓库地址')
 export const L4PluginDownloadSourceSchema = z.discriminatedUnion('mode', [
   z.object({ mode: z.literal('auto') }).strict(),
+  z.object({ mode: z.literal('local') }).strict(),
   z.object({ mode: z.literal('official') }).strict(),
   z.object({ mode: z.literal('domestic') }).strict(),
   z.object({ mode: z.literal('custom'), registry: L4PluginRegistrySchema }).strict()

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

@@ -17,6 +17,7 @@ import {
   L4_PLUGIN_OFFICIAL_NAMES,
   L4PluginRegistryError,
   searchL4PluginCatalog,
+  readL4PluginInstallRegistry,
   resolveL4PluginInstall,
   type L4RegistryPackage
 } from '@server/l4_foundation/pi/l4-pi-plugin-registry'
@@ -181,15 +182,21 @@ export class L2PluginCatalog {
   }
 
   async get(request: L2PluginCatalogGetRequest): Promise<L2PluginCatalogDetail> {
-    const resolved = request.registry
+    const downloadSource = readL4PiPluginPreferences().downloadSource
+    const registry =
+      downloadSource.mode === 'local'
+        ? (await readL4PluginInstallRegistry(request.name, { downloadSource })).registry
+        : request.registry
+    const resolved = registry
       ? null
       : await resolveL4PluginInstall(
-          `npm:${request.name}${request.version ? `@${request.version}` : ''}`
+          `npm:${request.name}${request.version ? `@${request.version}` : ''}`,
+          { downloadSource }
         )
     const detail = await getL4PluginCatalogDetail(
       request.name,
       resolved ? resolved.source.slice(resolved.source.lastIndexOf('@') + 1) : request.version,
-      request.registry ?? resolved?.registry
+      registry ?? resolved?.registry
     )
     const manifest = detail.manifest
     return {
@@ -211,9 +218,13 @@ export class L2PluginCatalog {
   }
 
   async getSettings(): Promise<L2PluginCatalogSettings> {
+    const downloadSource = readL4PiPluginPreferences().downloadSource
     return {
-      downloadSource: readL4PiPluginPreferences().downloadSource,
-      recommendedRegistry: await getL4PluginRecommendedRegistry()
+      downloadSource,
+      recommendedRegistry:
+        downloadSource.mode === 'local'
+          ? L4_PLUGIN_OFFICIAL_REGISTRY
+          : await getL4PluginRecommendedRegistry()
     }
   }
 

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

@@ -65,6 +65,12 @@ async function resolveTargets(
   const targets = new Map<string, CommandTarget>()
   for (const name of names) {
     const existing = findL2PluginCommandTarget(snapshot.plugins, name, agentDir)
+    if (command.action === 'reload') {
+      if (!existing) throw new Error(`插件不存在：${name}`)
+      if (existing.status === 'disabled') throw new Error(`插件已禁用，请先启用：${name}`)
+      targets.set(existing.source, { name, source: existing.source, local: false })
+      continue
+    }
     if (command.action === 'remove') {
       if (!existing) throw new Error(`插件不存在：${name}`)
       if (existing.kind !== 'package') {
@@ -102,6 +108,18 @@ async function acceptTargets(
   targets: CommandTarget[],
   management: CommandManagement
 ): Promise<CommandAcceptance[]> {
+  if (command.action === 'reload') {
+    const acceptances: CommandAcceptance[] = []
+    for (const target of targets) {
+      try {
+        await management.apply([target.source])
+        acceptances.push({ target, error: null })
+      } catch (error) {
+        acceptances.push({ target, error: failureMessage(error) })
+      }
+    }
+    return acceptances
+  }
   const results = new Map<string, string | null>()
   const packages = targets.filter((target) => !target.local)
   const locals = targets.filter((target) => target.local)
@@ -170,6 +188,7 @@ function completedResult(
   if (command.version && item.version !== command.version) {
     throw new Error(`实际版本 ${item.version ?? '未知'} 与目标版本 ${command.version} 不一致`)
   }
+  if (command.action === 'reload') return '成功：已重新加载本机代码，已有 Pi 会话保持不变'
   return target.local
     ? '成功：已加载当前代码，服务与界面已更新'
     : `成功：已安装${item.version ? ` ${item.version}` : ''}并完成宿主加载`
@@ -303,7 +322,8 @@ export async function executeL2PluginCommand(
   if (acceptedCount === 0) {
     throw new Error(acceptances.map(({ target, error }) => `${target.name}：${error}`).join('\n'))
   }
-  const action = command.action === 'remove' ? '卸载' : '安装'
+  const action =
+    command.action === 'remove' ? '卸载' : command.action === 'reload' ? '重载' : '安装'
   const description = `${action} ${targets.map((target) => target.name).join('、')}${command.version ? `@${command.version}` : command.tag ? `（渠道 ${command.tag}）` : ''}`
   console.info('[Pi Desk][Commands] 插件命令已接纳', {
     operation: description,

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

@@ -9,8 +9,8 @@ import {
 } from '@common/l4_foundation/locale/l4-localized-text'
 
 import { createHash, randomUUID } from 'node:crypto'
-import { mkdir, open, readFile, realpath, rm, stat, writeFile } from 'node:fs/promises'
-import { isAbsolute, join, relative, resolve } from 'node:path'
+import { copyFile, mkdir, open, readFile, realpath, rm, stat, writeFile } from 'node:fs/promises'
+import { dirname, isAbsolute, join, relative, resolve } from 'node:path'
 import {
   DefaultPackageManager,
   getAgentDir,
@@ -1009,6 +1009,25 @@ export class L2PluginManagement {
 
     console.info('[Pi Desk][PluginManagement] 开始在隔离 AgentDir 预检候选插件', { source })
     try {
+      // npm 解析结果没有 registry 表示本机模式，预检需保留完整项目配置而非单个源地址。
+      if (!registry && l2PluginNpmName(source)) {
+        for (const configPath of ['.npmrc', join('etc', 'npmrc')]) {
+          const target = join(stagingAgentDir, 'npm', configPath)
+          await mkdir(dirname(target), { recursive: true })
+          try {
+            await copyFile(join(this.agentDir, 'npm', configPath), target)
+            console.info('[Pi Desk][PluginManagement] 已为隔离预检继承本机 npm 配置', {
+              source,
+              configPath
+            })
+          } catch (error) {
+            if ((error as NodeJS.ErrnoException).code !== 'ENOENT')
+              throw new L2PluginManagementInvalidPackageError(
+                `无法继承本机 npm 配置（${configPath}）：${errorMessage(error)}`
+              )
+          }
+        }
+      }
       await runL4PiPackageMaintenance({
         maintenance: { action: 'install', source, ...(registry ? { registry } : {}) },
         agentDir: stagingAgentDir,

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

@@ -11,7 +11,10 @@ import {
   l4PluginNpmName,
   l4PluginSourceIdentity
 } from '@common/l4_foundation/plugin/l4-plugin-package'
-import { readL4PiPluginUpdateTag } from '@server/l4_foundation/pi/l4-pi-plugin-preferences'
+import {
+  readL4PiPluginPreferences,
+  readL4PiPluginUpdateTag
+} from '@server/l4_foundation/pi/l4-pi-plugin-preferences'
 import {
   readL4PluginInstallRegistry,
   resolveL4PluginInstall
@@ -109,12 +112,23 @@ export class L2PluginUpdates {
           continue
         let key: string | null = null
         try {
-          const policy = await readL4PluginInstallRegistry(name, { agentDir: this.agentDir })
-          key = JSON.stringify([identity, tag, policy.registry, policy.fallback])
+          const downloadSource = readL4PiPluginPreferences(this.agentDir).downloadSource
+          const policy = await readL4PluginInstallRegistry(name, {
+            agentDir: this.agentDir,
+            downloadSource
+          })
+          key = JSON.stringify([
+            identity,
+            tag,
+            downloadSource.mode,
+            policy.registry,
+            policy.fallback
+          ])
           let value = this.cache.get(key)?.value
           if (check) {
             if (!source.path || !source.version) throw new Error('无法读取插件已安装版本')
             const resolved = await resolveL4PluginInstall(`npm:${name}@${tag}`, {
+              downloadSource,
               agentDir: this.agentDir,
               signal: this.signal,
               cache: false

package/src/server/l4_foundation/pi/l4-pi-basic-session-services.ts

@@ -2,7 +2,7 @@ import 'server-only'
 
 import { existsSync, readFileSync } from 'node:fs'
 import { join } from 'node:path'
-import { readL4PiDeskSkills } from '@server/l4_foundation/pidesk/l4-pidesk-runtime'
+import { appendL4PiDeskSystemPrompt } from '@server/l4_foundation/pidesk/l4-pidesk-runtime'
 import {
   CONFIG_DIR_NAME,
   createExtensionRuntime,
@@ -38,7 +38,7 @@ class BasicResourceLoader implements ResourceLoader {
   }
 
   getSkills(): ReturnType<ResourceLoader['getSkills']> {
-    return { skills: readL4PiDeskSkills(), diagnostics: [] }
+    return { skills: [], diagnostics: [] }
   }
 
   getPrompts(): ReturnType<ResourceLoader['getPrompts']> {
@@ -62,7 +62,7 @@ class BasicResourceLoader implements ResourceLoader {
   }
 
   getAppendSystemPrompt(): string[] {
-    return this.appendPrompt ? [this.appendPrompt.content] : []
+    return appendL4PiDeskSystemPrompt(this.appendPrompt ? [this.appendPrompt.content] : [])
   }
 
   getAppendSystemPromptSources(): Array<{ path: string }> {

package/src/server/l4_foundation/pi/l4-pi-package-maintenance-runner.mts

@@ -64,23 +64,16 @@ async function main(): Promise<void> {
   if (!source || source.length > 2048) throw new Error('插件维护来源无效')
   const registry = process.argv[4] ? L4PluginRegistrySchema.parse(process.argv[4]) : undefined
   const scope = /^npm:(@[^/]+)\//.exec(source)?.[1]
+  // scoped 源只覆盖对应 scope，公共依赖继续使用原有默认源。
+  const registryKey = scope ? `npm_config_${scope}:registry` : 'npm_config_registry'
   const inheritedEnvironment = { ...process.env }
   if (registry) {
     // Windows 子进程的环境名不区分大小写，不能同时保留两种拼写。
-    const replaced = new Set([
-      'npm_config_registry',
-      ...(scope ? [`npm_config_${scope}:registry`.toLowerCase()] : [])
-    ])
     for (const key of Object.keys(inheritedEnvironment)) {
-      if (replaced.has(key.toLowerCase())) delete inheritedEnvironment[key]
+      if (key.toLowerCase() === registryKey.toLowerCase()) delete inheritedEnvironment[key]
     }
   }
-  const registryEnvironment: Record<string, string> = registry
-    ? {
-        npm_config_registry: registry,
-        ...(scope ? { [`npm_config_${scope}:registry`]: registry } : {})
-      }
-    : {}
+  const registryEnvironment: Record<string, string> = registry ? { [registryKey]: registry } : {}
 
   const configuredAgentDir = process.env.PI_CODING_AGENT_DIR
   const agentDir =

package/src/server/l4_foundation/pi/l4-pi-plugin-registry-config.ts

@@ -2,14 +2,15 @@ import 'server-only'
 
 import { execFile } from 'node:child_process'
 import { existsSync } from 'node:fs'
-import { readFile } from 'node:fs/promises'
+import { mkdir, readFile } from 'node:fs/promises'
 import { dirname, join, resolve } from 'node:path'
 import { homedir } from 'node:os'
 import { promisify } from 'node:util'
+import { getAgentDir } from '@earendil-works/pi-coding-agent'
 
 const execute = promisify(execFile)
 type NpmConfig = Record<string, string>
-let cached: { cwd: string; expires: number; value: Promise<NpmConfig> } | undefined
+let cached: { cwd: string; prefix: string; expires: number; value: Promise<NpmConfig> } | undefined
 
 function npmCli(): string | undefined {
   const directories = [
@@ -49,17 +50,33 @@ async function readNpmrc(path: string, config: NpmConfig): Promise<void> {
   }
 }
 
-async function loadConfig(): Promise<NpmConfig> {
+function npmConfigPath(path: string, cwd: string): string {
+  const homePattern = process.platform === 'win32' ? /^~[\\/]/ : /^~\//
+  return homePattern.test(path) ? resolve(homedir(), path.slice(2)) : resolve(cwd, path)
+}
+
+async function loadConfig(cwd: string, installRoot: string): Promise<NpmConfig> {
+  const environment: NpmConfig = {}
+  // 与 npm loadEnv 一致：大小写统一后按环境枚举顺序覆盖，空值不参与配置。
+  for (const [key, value] of Object.entries(process.env)) {
+    if (value !== undefined && value !== '' && /^npm_config_/i.test(key)) {
+      const original = key.slice(11)
+      const name = original.startsWith('//')
+        ? original
+        : original.replace(/(?!^)_/g, '-').toLowerCase()
+      environment[name] = expand(value)
+    }
+  }
   const cli = npmCli()
   let effective: Record<string, unknown> = {}
   if (cli) {
     try {
-      const result = await execute(process.execPath, [cli, 'config', 'list', '--json'], {
-        cwd: process.cwd(),
-        timeout: 4000,
-        maxBuffer: 512 * 1024,
-        windowsHide: true
-      })
+      await mkdir(cwd, { recursive: true })
+      const result = await execute(
+        process.execPath,
+        [cli, 'config', 'list', '--json', '--prefix', installRoot],
+        { cwd, timeout: 4000, maxBuffer: 512 * 1024, windowsHide: true }
+      )
       effective = JSON.parse(result.stdout) as Record<string, unknown>
     } catch {
       // 不输出 npm 的 stderr：其中可能包含注册表鉴权信息。
@@ -68,18 +85,25 @@ async function loadConfig(): Promise<NpmConfig> {
   }
   const config: NpmConfig = {}
   if (cli) await readNpmrc(resolve(dirname(cli), '../npmrc'), config)
-  const prefix = typeof effective.prefix === 'string' ? effective.prefix : dirname(process.execPath)
+  // npm 默认 globalconfig 同样受 CLI --prefix 影响，不能回退到 Node 安装目录。
   const globalPath =
-    typeof effective.globalconfig === 'string' ? effective.globalconfig : join(prefix, 'etc/npmrc')
+    typeof effective.globalconfig === 'string'
+      ? effective.globalconfig
+      : (environment.globalconfig ?? join(installRoot, 'etc/npmrc'))
   const userPath =
-    process.env.NPM_CONFIG_USERCONFIG ??
-    process.env.npm_config_userconfig ??
-    (typeof effective.userconfig === 'string' ? effective.userconfig : join(homedir(), '.npmrc'))
-  await readNpmrc(globalPath, config)
-  await readNpmrc(userPath, config)
-  const project =
-    typeof effective['local-prefix'] === 'string' ? effective['local-prefix'] : process.cwd()
-  await readNpmrc(join(project, '.npmrc'), config)
+    typeof effective.userconfig === 'string'
+      ? effective.userconfig
+      : (environment.userconfig ?? join(homedir(), '.npmrc'))
+  await readNpmrc(npmConfigPath(globalPath, cwd), config)
+  await readNpmrc(npmConfigPath(userPath, cwd), config)
+  // Pi user-scope 安装传入 --prefix，项目 npmrc 属于安装根，不属于应用或维护 cwd。
+  if (
+    effective.global !== true &&
+    environment.global !== 'true' &&
+    effective.location !== 'global' &&
+    environment.location !== 'global'
+  )
+    await readNpmrc(join(installRoot, '.npmrc'), config)
   for (const [key, value] of Object.entries(effective)) {
     if (
       typeof value === 'string' &&
@@ -88,23 +112,17 @@ async function loadConfig(): Promise<NpmConfig> {
     )
       config[key] = value
   }
-  for (const [key, value] of Object.entries(process.env)) {
-    if (value !== undefined && /^npm_config_/i.test(key)) {
-      const original = key.slice(11)
-      const name = original.startsWith('//')
-        ? original
-        : original.replace(/(?!^)_/g, '-').toLowerCase()
-      config[name] = expand(value)
-    }
-  }
-  return config
+  return { ...config, ...environment }
 }
 
-export function readRegistryNpmConfig(): Promise<NpmConfig> {
-  const cwd = process.cwd()
-  if (!cached || cached.cwd !== cwd || cached.expires <= Date.now()) {
-    const value = loadConfig()
-    cached = { cwd, expires: Date.now() + 30_000, value }
+export function readRegistryNpmConfig(agentDir = getAgentDir()): Promise<NpmConfig> {
+  const cwd =
+    process.env.PI_DESK_PACKAGE_MAINTENANCE_CWD ??
+    join(agentDir, 'pi-desk', 'plugin-package-manager')
+  const prefix = join(agentDir, 'npm')
+  if (!cached || cached.cwd !== cwd || cached.prefix !== prefix || cached.expires <= Date.now()) {
+    const value = loadConfig(cwd, prefix)
+    cached = { cwd, prefix, expires: Date.now() + 30_000, value }
     void value.catch(() => {
       if (cached?.value === value) cached = undefined
     })

package/src/server/l4_foundation/pi/l4-pi-plugin-registry-network.ts

@@ -26,10 +26,11 @@ export async function fetchRegistryBytes(
     timeout?: number
     cache?: boolean
     auth?: boolean
+    agentDir?: string
   }
 ): Promise<Buffer> {
   options.signal?.throwIfAborted()
-  const config = options.auth === false ? {} : await readRegistryNpmConfig()
+  const config = options.auth === false ? {} : await readRegistryNpmConfig(options.agentDir)
   const authorization = registryAuth(url, config)
   const key = `${url.href}:${options.limit}:${createHash('sha256')
     .update(authorization ?? '')
@@ -133,9 +134,10 @@ export async function fetchRegistryBytes(
 
 export async function fetchRegistryJson(
   url: URL,
-  signal?: AbortSignal
+  signal?: AbortSignal,
+  agentDir?: string
 ): Promise<Record<string, unknown>> {
-  const body = await fetchRegistryBytes(url, { limit: 8 * 1024 * 1024, signal })
+  const body = await fetchRegistryBytes(url, { limit: 8 * 1024 * 1024, signal, agentDir })
   try {
     const parsed: unknown = JSON.parse(body.toString('utf8'))
     if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) throw new Error('invalid')

package/src/server/l4_foundation/pi/l4-pi-plugin-registry.ts

@@ -102,16 +102,25 @@ export async function readL4PluginInstallRegistry(
   name: string,
   options: { downloadSource?: L4PluginDownloadSource; registry?: string; agentDir?: string }
 ): Promise<{ registry: string; fallback: boolean }> {
+  const preferences = readL4PiPluginPreferences(options.agentDir)
+  const source = options.downloadSource ?? preferences.downloadSource
+  if (source.mode === 'local') {
+    const config = await readRegistryNpmConfig(options.agentDir)
+    const scoped = name.startsWith('@') ? config[`${name.split('/')[0]}:registry`] : undefined
+    return {
+      registry: normalizeRegistry(scoped || config.registry || L4_PLUGIN_OFFICIAL_REGISTRY),
+      fallback: false
+    }
+  }
   if (options.registry) {
     const registry = normalizeRegistry(options.registry)
     if (![L4_PLUGIN_OFFICIAL_REGISTRY, L4_PLUGIN_DOMESTIC_REGISTRY].includes(registry))
       return { registry, fallback: false }
   }
-  const preferences = readL4PiPluginPreferences(options.agentDir)
   const saved = preferences.registries[`npm:${name}`]
   if (saved) return { registry: normalizeRegistry(saved), fallback: false }
   if (name.startsWith('@')) {
-    const config = await readRegistryNpmConfig()
+    const config = await readRegistryNpmConfig(options.agentDir)
     const scoped = config[`${name.split('/')[0]}:registry`]
     if (scoped) {
       const registry = normalizeRegistry(scoped)
@@ -119,7 +128,6 @@ export async function readL4PluginInstallRegistry(
         return { registry, fallback: false }
     }
   }
-  const source = options.downloadSource ?? preferences.downloadSource
   if (source.mode === 'custom')
     return { registry: normalizeRegistry(source.registry), fallback: false }
   if (source.mode === 'official') return { registry: L4_PLUGIN_OFFICIAL_REGISTRY, fallback: false }
@@ -145,7 +153,9 @@ export async function resolveL4PluginInstall(
   const selector = match[2] ?? 'latest'
   if (selector.length > 128 || !/^[a-zA-Z0-9._+-]+$/.test(selector))
     throw new L4PluginRegistryError('npm 插件版本或标签无效', 400)
-  const selected = await readL4PluginInstallRegistry(name, options)
+  const downloadSource =
+    options.downloadSource ?? readL4PiPluginPreferences(options.agentDir).downloadSource
+  const selected = await readL4PluginInstallRegistry(name, { ...options, downloadSource })
   let registry = selected.registry
   let target = selector
   let version: string
@@ -172,18 +182,23 @@ export async function resolveL4PluginInstall(
     version = chooseVersion(metadata, target)
     validManifest(registryObject(metadata.versions)[version], name, version)
   }
-  return { source: `npm:${name}@${version}`, registry }
+  // 本机源仅供版本查询，安装必须继续沿用 npm 配置，也不能保存为逐包仓库归属。
+  return {
+    source: `npm:${name}@${version}`,
+    ...(downloadSource.mode === 'local' ? {} : { registry })
+  }
 }
 
 async function readInstallMetadata(
   url: URL,
-  options: { signal?: AbortSignal; cache?: boolean }
+  options: { signal?: AbortSignal; cache?: boolean; agentDir?: string }
 ): Promise<Record<string, unknown>> {
-  if (options.cache !== false) return fetchRegistryJson(url, options.signal)
+  if (options.cache !== false) return fetchRegistryJson(url, options.signal, options.agentDir)
   const body = await fetchRegistryBytes(url, {
     limit: 8 * 1024 * 1024,
     signal: options.signal,
-    cache: false
+    cache: false,
+    agentDir: options.agentDir
   })
   try {
     const parsed: unknown = JSON.parse(body.toString('utf8'))

package/src/server/l4_foundation/pi/l4-pi-session-initialization.ts

@@ -15,7 +15,7 @@ import {
 import type { CapabilityMode } from '@jetcrab/pi-desk-sdk/capabilities'
 import {
   createL4PiDeskTool,
-  readL4PiDeskSkills,
+  appendL4PiDeskSystemPrompt,
   type L4PiDeskCommandResult
 } from '@server/l4_foundation/pidesk/l4-pidesk-runtime'
 import { L4PiCapabilityRuntime } from './l4-pi-capability-runtime'
@@ -313,10 +313,7 @@ export class L4PiSessionInitialization {
         : await this.options.resources.createServices(
             this.options.cwd,
             {
-              skillsOverride: (loaded) => ({
-                ...loaded,
-                skills: readL4PiDeskSkills(loaded.skills)
-              }),
+              appendSystemPromptOverride: appendL4PiDeskSystemPrompt,
               eventBus: this.capabilities.eventBus(this.plugins.eventBus),
               extensionsOverride: (loaded) => {
                 if (!this.active) {

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

@@ -1,6 +1,6 @@
 import 'server-only'
 
-export type L4PiDeskPluginAction = 'list' | 'show' | 'install' | 'remove'
+export type L4PiDeskPluginAction = 'list' | 'show' | 'install' | 'reload' | 'remove'
 
 export type L4PiDeskCommand =
   | { kind: 'help'; message: string }
@@ -54,6 +54,13 @@ const definitions: readonly CommandDefinition[] = [
     version: true,
     tag: true
   },
+  {
+    path: ['plugins', 'reload'],
+    description:
+      '重新加载一个或多个已安装插件；不下载、不重启宿主，不重载已有 Pi 会话；完成后向本会话汇总结果',
+    name: 'multiple',
+    scope: 'required'
+  },
   {
     path: ['plugins', 'remove'],
     description: '卸载一个或多个包来源；完成后向本会话汇总结果',

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

@@ -1,21 +1,14 @@
 import 'server-only'
 
-import { mkdir, readFile, writeFile } from 'node:fs/promises'
+import { access, readFile, rm } from 'node:fs/promises'
 import { dirname, join } from 'node:path'
-import {
-  defineTool,
-  getAgentDir,
-  getDocsPath,
-  loadSkillsFromDir,
-  truncateHead,
-  type Skill
-} from '@earendil-works/pi-coding-agent'
+import { defineTool, getAgentDir, truncateHead } from '@earendil-works/pi-coding-agent'
 import { Type } from 'typebox'
 import type { AgentToolResult } from '@earendil-works/pi-agent-core'
 import { getL4PiDeskDataDir } from '@server/l4_foundation/pi/l4-pi-desk-data-dir'
 import { isL4PiDeskSafeMode } from '@server/l4_foundation/pi/l4-pi-desk-mode'
 import { parseL4PiDeskCommand, type L4PiDeskCommand } from './l4-pidesk-command'
-import { renderL4PiDeskPluginGuide, renderL4PiDeskSkill } from './l4-pidesk-skill-template'
+import { renderL4PiDeskSystemPrompt } from './l4-pidesk-system-prompt'
 
 export interface L4PiDeskCommandResult {
   mode: 'sync' | 'async'
@@ -36,7 +29,8 @@ export type L4PiDeskPluginCommandHandler = (
 
 interface CommandRuntime {
   handler: L4PiDeskPluginCommandHandler
-  skill: Skill
+  systemPrompt: string
+  docsDirectory: string
   version: string
   development: boolean
   agentDir: string
@@ -66,45 +60,37 @@ export async function initializeL4PiDeskCommands(
   const sdkRoot = dirname(
     dirname(createRequire(join(hostRoot, 'package.json')).resolve('@jetcrab/pi-desk-sdk'))
   )
-  const skillRoot = join(getL4PiDeskDataDir(), development ? 'dev-skills' : 'skills', 'pi-desk')
-  await mkdir(join(skillRoot, 'references'), { recursive: true })
-  await Promise.all([
-    writeFile(
-      join(skillRoot, 'SKILL.md'),
-      renderL4PiDeskSkill({
-        agentDir: portable(agentDir),
-        sdkRoot: portable(sdkRoot),
-        piDocs: portable(getDocsPath())
-      }),
-      'utf8'
-    ),
-    writeFile(
-      join(skillRoot, 'references', 'plugins.md'),
-      renderL4PiDeskPluginGuide(portable(agentDir)),
-      'utf8'
-    )
-  ])
-  const loaded = loadSkillsFromDir({ dir: skillRoot, source: 'pidesk' })
-  const skill = loaded.skills.find((item) => item.name === 'pi-desk')
-  if (!skill) throw new Error('Pi Desk Skill 生成后无法加载')
+  const docsDirectory = join(hostRoot, 'docs', 'pi-desk')
+  await Promise.all(
+    ['README.md', 'commands.md', 'plugins.md'].map((file) => access(join(docsDirectory, file)))
+  )
+  // 只清理当前环境曾生成的宿主 Skill，用户 Skills 和其他宿主环境保持不变。
+  await rm(join(getL4PiDeskDataDir(), development ? 'dev-skills' : 'skills', 'pi-desk'), {
+    recursive: true,
+    force: true
+  })
   const runtime: CommandRuntime = {
     handler,
-    skill,
+    docsDirectory,
+    systemPrompt: renderL4PiDeskSystemPrompt({
+      docsDirectory: portable(docsDirectory),
+      sdkRoot: portable(sdkRoot)
+    }),
     version: manifest.version,
     development,
     agentDir
   }
   globalThis.__piDeskCommandRuntime = runtime
-  console.info('[Pi Desk][Commands] 命令入口与 Skill 已准备完成', { skillPath: skill.filePath })
+  console.info('[Pi Desk][Commands] 命令入口与系统资料导航已准备完成', { docsDirectory })
 }
 
 export function disposeL4PiDeskCommands(): void {
   globalThis.__piDeskCommandRuntime = undefined
 }
 
-export function readL4PiDeskSkills(skills: readonly Skill[] = []): Skill[] {
-  const skill = globalThis.__piDeskCommandRuntime?.skill
-  return skill ? [...skills.filter((item) => item.name !== skill.name), skill] : [...skills]
+export function appendL4PiDeskSystemPrompt(prompts: readonly string[] = []): string[] {
+  const prompt = globalThis.__piDeskCommandRuntime?.systemPrompt
+  return prompt ? [...prompts, prompt] : [...prompts]
 }
 
 export async function executeL4PiDeskCommand(
@@ -126,7 +112,7 @@ export async function executeL4PiDeskCommand(
         mode: isL4PiDeskSafeMode() ? 'basic' : 'normal',
         cwd: context.cwd,
         agentDir: runtime.agentDir,
-        skillDirectory: runtime.skill.baseDir
+        docsDirectory: runtime.docsDirectory
       })
     }
   }

package/src/server/l4_foundation/pidesk/l4-pidesk-system-prompt.ts

@@ -0,0 +1,11 @@
+import 'server-only'
+
+export function renderL4PiDeskSystemPrompt(paths: {
+  docsDirectory: string
+  sdkRoot: string
+}): string {
+  return `Pi Desk 资料（仅在使用、管理 Pi Desk 或开发其插件时读取）：
+- 文档入口：${paths.docsDirectory}/README.md
+- SDK 公开类型声明：${paths.sdkRoot}/dist/
+从入口选择并完整阅读对应文档及引用示例；原生 Pi 能力按入口引用查阅官方资料。相对路径从文档所在目录解析。`
+}

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

@@ -1 +1 @@
-STVrBHA3z9KPtvBE4WcE2
+IgHJ40fniC07-ioYUKobL