dsh-paoding 0.4.2 → 0.4.4

package/plugins/paoding-config-ui/api-core.mjs

@@ -8,22 +8,28 @@
  */
 import os from 'node:os'
 import path from 'node:path'
-import { mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from 'node:fs'
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 import { assignSlugs, collectState, generateAndInstall, presetIdOf } from '../../tools/install.mjs'
 import { autoAssignments, baseAssignments } from '../../tools/lib/alloc.mjs'
-import { normalizeConfig, normalizeTargetFields, saveConfig, serializeConfig } from '../../tools/lib/config.mjs'
+import { loadConfig, normalizeConfig, normalizeTargetFields, saveConfig, serializeConfig, stripNonTargetKeys } from '../../tools/lib/config.mjs'
 import { parseYamlSubset, preprocessPatchText } from '../../tools/lib/yaml.mjs'
 import { captureWarnings, healthCheck } from '../../tools/lib/health.mjs'
+import { warn } from '../../tools/lib/util.mjs'
 import {
   backfillHomePatchRows,
-  detectHostVersionTriple,
+  detectAgentRolesFlavor,
+  detectHostVersionInfo,
   detectPresetSystem,
   formatGeneratorMarker,
   isPtcWorkerHost,
   listOrchestratorPresetIds,
   parseGeneratorMarker,
+  presetRolesFlavorOf,
+  presetRowId,
   readHomePatchRows,
+  stripHomePatchRows,
+  ROLES_AGENT_PRESET,
   WORKER_PTC,
   WORKER_WORKER_THREAD,
 } from '../../tools/lib/preset-system.mjs'
@@ -33,6 +39,12 @@ function workerFlavorOf(hostVersionTriple) {
   return isPtcWorkerHost(hostVersionTriple) ? WORKER_PTC : WORKER_WORKER_THREAD
 }
 
+/** 宿主版本信息 → 角色委派行标记行（生成产物行的形态，与 compose 对齐；
+ * prerelease 透传——0.2.1 守卫 0.2.1-rc.2 落地，rc.0/rc.1 按内联形态对账）。 */
+function rolesFlavorOf(hostVersionTriple, prerelease) {
+  return presetRolesFlavorOf(hostVersionTriple, prerelease)
+}
+
 /**
  * 标记 worker 行与当前宿主形态是否兼容：只有「产物形态」与「宿主所需形态」在
  * ptc/worker-thread 上分叉（其中一边是 ptc）才算换代——null（v2/v1 旧标记）与
@@ -44,6 +56,16 @@ function workerFlavorCompatible(markerWorker, currentWorker) {
   return (markerWorker === WORKER_PTC) === (currentWorker === WORKER_PTC)
 }
 
+/**
+ * 标记角色行与当前宿主形态是否兼容（workerFlavorCompatible 同款语义）：分叉 =
+ * 其中一边是 agent-preset；null（v3/v2 旧标记）与 inline 同侧——0.2.1 宿主上
+ * 旧插件版本的 inline 产物重生成也产不出新形状，重生成无意义；插件升级后版本
+ * 不符走整盘重生成，新形状经那条路径落地。
+ */
+function rolesFlavorCompatible(markerRoles, currentRoles) {
+  return (markerRoles === ROLES_AGENT_PRESET) === (currentRoles === ROLES_AGENT_PRESET)
+}
+
 export function resolveDshHome() {
   return process.env.DSH_HOME || path.join(os.homedir(), '.dsh')
 }
@@ -270,15 +292,143 @@ export async function importConfigContent(content) {
   return { ok: true }
 }
 
+// ── 预设 CRUD（presets 路由族的服务端核心）──────────────────────────────────
+//
+// 面板 apply 只覆盖「全局 / 单个工作区视角的生成」，这里补齐预设对象本身的
+// 生命周期：列举（GET）、新增 / 更新（POST/PUT，复用 installAssignments）、
+// 删除（DELETE，配置条目 + preset 目录 + 声明行三位一体清理）。全局
+// orchestrator 不在删除之列——插件启动自愈（ensurePresetInstalled）会在下次
+// 启动把它装回来，删除语义不成立，路由层直接 403。
+
+/**
+ * 预设清单组装（GET presets）：输入 serializeState 后的只读视图，输出响应的
+ * presets 数组。全局 orchestrator 恒在首位（assignments = existing 顶层剥掉
+ * profile / workspaces 两个容器键后的目标字段；existing 缺失 = 尚无配置文件，
+ * assignments 也为 null），其后按配置 workspaces 段的键序逐个工作区补项。
+ */
+export function listPresets(view) {
+  const existing = view?.existing ?? null
+  const installedPresets = Array.isArray(view?.installedPresets) ? view.installedPresets : []
+  const presets = [{
+    presetId: 'orchestrator',
+    scope: 'global',
+    workspacePath: null,
+    installed: installedPresets.includes('orchestrator'),
+    assignments: existing ? stripNonTargetKeys(existing) : null,
+  }]
+  const workspaces = existing?.workspaces && typeof existing.workspaces === 'object' && !Array.isArray(existing.workspaces)
+    ? existing.workspaces
+    : {}
+  const metaOf = view?.workspaceMeta ?? {}
+  // workspaceMeta 缺项兜底（理论不会走到——workspaceMeta 由同一份 existing 派生，
+  // 只防老版本状态/外部构造视图漏了键）：整组键现算一次 assignSlugs，口径与
+  // serializeState / 生成层一致，避免逐项单算丢掉同 basename 的 hash 后缀。
+  let fallbackSlugs = null
+  for (const [wsPath, assignments] of Object.entries(workspaces)) {
+    let meta = metaOf[wsPath] ?? null
+    if (!meta) {
+      fallbackSlugs ??= assignSlugs(Object.keys(workspaces))
+      const slug = fallbackSlugs.get(wsPath)
+      const presetId = presetIdOf(slug)
+      meta = { slug, presetId, installed: installedPresets.includes(presetId) }
+    }
+    presets.push({
+      presetId: meta.presetId,
+      scope: 'workspace',
+      workspacePath: wsPath,
+      installed: !!meta.installed,
+      assignments,
+    })
+  }
+  return presets
+}
+
+/**
+ * presetId（orchestrator-<slug>）→ 工作区绝对路径反查（PUT/DELETE presets/<id>）：
+ * 对 existing.workspaces 的键集整组 assignSlugs（与生成层 / serializeState 同源，
+ * 同 basename 冲突的 hash 后缀才能对得上），再按 presetIdOf 逐一比对。找不到
+ * （id 未注册、键集为空、全局 orchestrator 之外未知形态）返回 null，由路由层
+ * 回 404。
+ */
+export function resolveWorkspacePathByPresetId(existing, presetId) {
+  const slugs = assignSlugs(Object.keys((existing && existing.workspaces) || {}))
+  for (const [wsPath, slug] of slugs) {
+    if (presetIdOf(slug) === presetId) return wsPath
+  }
+  return null
+}
+
+/**
+ * 删除工作区预设（DELETE presets/<id>）：配置条目、preset 目录、声明行三位
+ * 一体清理。state 传原始 collectState state（拿 yamlMod / dshHome / configFile，
+ * 绝不能喂 serializeState 的 JSON 视图——loadConfig 需要宿主 yaml 口径）。
+ *
+ * 步骤与护栏：
+ *   1. 现配置读取（破坏性落盘护栏）：读失败硬中止——「去条目 + 整文件覆写」
+ *      不允许对着不可信状态动刀，文案与 generateAndInstall 同款；
+ *   2. workspaces 段去掉该键后经 saveConfig 整体落盘（键已被外部移除也继续
+ *      后续清理，幂等）；配置文件缺失（loadConfig 回 null）时没有条目可去，
+ *      跳过落盘——不为一次删除凭空物化配置文件；
+ *   3. slug 按「删除前键集 ∪ 本路径」分配：键在时恰为删除前键集，与
+ *      generateAndInstall 落盘时的键集（磁盘 ∪ 本路径）同口径，保证算出的
+ *      presetId 与当初产物目录名一致；键不在时同口径现算，纯兜底清理；
+ *   4. preset 目录存在才 rmSync；声明行经 stripHomePatchRows 撤除——该函数对
+ *      文件缺失 / 无托管块是安全 no-op（directory 轨宿主常态），无须预判轨道。
+ *
+ * 不动宿主 workspaceRegistry：注册表层与配置层解耦，DELETE 只清配置与预设产物
+ * （注册工作区是 POST /workspaces 的职责）。返回
+ * { presetId, removedConfigEntry, removedPresetDir }；读配置失败仍按既有约定
+ * 抛错（无 statusCode，由路由层外层 catch 回 500）。
+ */
+export function deleteWorkspacePreset(state, workspacePath) {
+  const { yamlMod, dshHome, configFile } = state
+  const wsPath = path.normalize(path.resolve(workspacePath))
+  let prev = null
+  try {
+    prev = loadConfig(configFile, yamlMod)
+  } catch (err) {
+    throw new Error(`现有配置 ${configFile} 读取失败，已中止（未做任何落盘）: ${err.message}`)
+  }
+
+  const wsEntries = Object.keys(prev?.workspaces ?? {})
+  if (!wsEntries.includes(wsPath)) wsEntries.push(wsPath)
+  const presetId = presetIdOf(assignSlugs(wsEntries).get(wsPath))
+
+  let removedConfigEntry = false
+  if (prev !== null) {
+    const workspaces = { ...prev.workspaces }
+    removedConfigEntry = Object.prototype.hasOwnProperty.call(workspaces, wsPath)
+    delete workspaces[wsPath]
+    // 顶层字段随工作区保存的同一写盘口径重规范化（normalizeTargetFields），
+    // profile 维持磁盘现状（缺省 null 时由序列化器兜底，不引入运行时 profile）。
+    saveConfig(configFile, {
+      profile: prev.profile ?? null,
+      ...normalizeTargetFields(prev),
+      workspaces,
+    })
+  }
+
+  const presetDir = path.join(dshHome, '.agent-presets', presetId)
+  let removedPresetDir = false
+  if (existsSync(presetDir)) {
+    rmSync(presetDir, { recursive: true, force: true })
+    removedPresetDir = true
+  }
+  stripHomePatchRows(dshHome, [presetRowId(presetId)])
+
+  return { presetId, removedConfigEntry, removedPresetDir }
+}
+
 // ── 首装 / 升级后 preset 自动重生成 ─────────────────────────────────────────
 //
 // 唯一官方安装通道是插件通道（dsh plugin add dsh-paoding），包不再携带 CLI：
 // preset 的落盘改由插件启动时自愈。对账基准是 preset 目录里的 .generator-version
-// 标记文件（v3 起内容 = 生成器版本 + 预设安装轨道 + workflow worker 形态三行）：
-// 插件包版本变、或宿主轨道翻转 / worker 形态换代（只升 dsh 不动插件——升级最
-// 常见路径，旧标记缺行时同样解析为不符）→ 下次启动自动自愈，一举解决「升级后
-// preset 还是旧版产物」「升 dsh 后 preset 静默消失」与「升 dsh 后 worker 行
-// 失配 never started」三类漂移。
+// 标记文件（v4 起内容 = 生成器版本 + 预设安装轨道 + workflow worker 形态 +
+// 角色委派行形态四行）：插件包版本变、或宿主轨道翻转 / worker 形态换代 / 角色
+// 行换代（只升 dsh 不动插件——升级最常见路径，旧标记缺行时同样解析为不符）→
+// 下次启动自动自愈，一举解决「升级后 preset 还是旧版产物」「升 dsh 后 preset
+// 静默消失」「升 dsh 后 worker 行失配 never started」与「升 dsh 0.2.1 后内联
+// persona/toolFilter 被 apply 拒绝、新建会话即抛错」四类漂移。
 
 // 生成器版本（标记对账基准）：插件包根 package.json 读一次即缓存。读失败兜底
 // '0.0.0'——最坏后果只是每次启动多重生成一次 preset，不会装坏任何东西。
@@ -294,6 +444,45 @@ export function pluginVersion() {
   return cachedGeneratorVersion ?? '0.0.0'
 }
 
+/**
+ * 工作区预设（orchestrator-<slug>）角色行形态迁移：基础 preset 整盘重生成后，
+ * 磁盘上各工作区产物的角色行形态若与宿主所需不符（典型：宿主刚升 0.2.1，工作区
+ * 产物还是旧内联形状——声明行又在场，挂该预设的新建会话照样被 tool-subagent
+ * 守卫拒绝），按该工作区在配置 workspaces 段里最后一次应用的条目就地重生成
+ *（顶层配置兜底合入，落盘不回写配置）。产物缺失（从未生成过）与形态判不出的
+ *（角色被清空）一律跳过——不自作主张替用户代生成；单个工作区失败只 warn，
+ * 绝不拖垮整体自愈。返回完成换代的工作区 presetId 列表。
+ */
+function migrateWorkspacePresetRoles({ dshHome, state }) {
+  const wanted = presetRolesFlavorOf(state.hostVersionTriple, state.hostPrerelease)
+  const wsEntries = state.existing?.workspaces ?? {}
+  const wsPaths = Object.keys(wsEntries)
+  if (wsPaths.length === 0) return []
+  const slugs = assignSlugs(wsPaths)
+  const migrated = []
+  for (const wsPath of wsPaths) {
+    const presetId = presetIdOf(slugs.get(wsPath))
+    let flavor = null
+    try {
+      flavor = detectAgentRolesFlavor(readFileSync(path.join(dshHome, '.agent-presets', presetId, 'agent.cordis.yml'), 'utf8'))
+    } catch {
+      continue // 目录 / 产物缺失：该工作区从未生成过，保持沉默（生成是显式动作）
+    }
+    if (flavor === null || flavor === wanted) continue
+    try {
+      // 该工作区最后一次应用的条目优先，顶层字段兜底（条目缺键时回落全局值）；
+      // saveConfigOnWrite=false——配置 workspaces 段原样保留，只换代产物。
+      const merged = { ...normalizeTargetFields(state.existing), ...normalizeTargetFields(wsEntries[wsPath]) }
+      const assignments = autoAssignments({ existing: merged, suggested: state.suggested, staticBase: state.staticBase })
+      generateAndInstall(state, assignments, { dryRun: false, saveConfigOnWrite: false, workspacePath: wsPath })
+      migrated.push(presetId)
+    } catch (err) {
+      warn(`工作区预设角色行换代失败（${presetId}，可对该工作区重新「保存并应用」修复）: ${err?.message ?? err}`)
+    }
+  }
+  return migrated
+}
+
 // dispose 中止时的返回理由（记 reason 而非 error：不算失败，调用方不打日志）。
 const PRESET_ENSURE_ABORTED = '插件已卸载（dispose），本次 preset 生成中止'
 
@@ -302,9 +491,10 @@ const PRESET_ENSURE_ABORTED = '插件已卸载（dispose），本次 preset 生
  *
  * 判定（满足其一即动盘）：
  *   - preset 目录 / 标记缺失，或标记版本与 generatorVersion 不符 → 整盘重生成；
- *   - 版本一致但标记 worker 形态与当前宿主所需分叉（宿主跨过 0.1.5/0.1.6
- *     worker 边界；v2/v1 旧标记在真实 ptc 宿主上同样分叉）→ 整盘重生成（该行
- *     长在产物正文里，轻量路径覆盖不到）；
+ *   - 版本一致但标记 worker 形态或角色行形态与当前宿主所需分叉（宿主跨过
+ *     0.1.5/0.1.6 worker 边界或 0.2.0/0.2.1 角色行边界；旧格式标记在真实
+ *     ptc/agent-preset 宿主上同样分叉）→ 整盘重生成（这些行长在产物正文里，
+ *     轻量路径覆盖不到）；
  *   - 版本 worker 都一致但标记轨道与当前宿主轨道不符（只升 dsh 不动插件 /
  *     旧格式标记）→ 轻量迁移：声明轨上按磁盘产物补写缺失声明行（内容字节
  *     不动，不重生成），directory 轨上落回整盘重生成（残留声明行会让 0.1.6
@@ -338,12 +528,14 @@ export async function ensurePresetInstalled({ dshHome = resolveDshHome(), genera
 
     if (marker !== null && marker.version === generatorVersion) {
       // 版本一致：内容原则上无需重生成，但宿主可能已随 dsh 升降级翻转轨道或
-      // 跨过 workflow worker 形态边界（只升 dsh 不动插件是升级常态），声明行也
-      // 可能被外部动过——这里做轻量对账。worker 形态不符（v2/v1 旧标记没有第
-      // 三行，一律视为不符）不能走轻量路径：该行长在产物正文里，补行/撤行覆盖
-      // 不到，必须整盘重生成——落到下方重生成分支。
-      const currentWorker = workerFlavorOf(detectHostVersionTriple())
-      if (workerFlavorCompatible(marker.worker, currentWorker)) {
+      // 跨过 workflow worker 形态 / 角色委派行形态边界（只升 dsh 不动插件是升级
+      // 常态），声明行也可能被外部动过——这里做轻量对账。worker 形态或角色行
+      // 形态不符（v3/v2/v1 旧标记缺行，一律视为不符）不能走轻量路径：这些行
+      // 长在产物正文里，补行/撤行覆盖不到，必须整盘重生成——落到下方重生成分支。
+      const hostInfo = detectHostVersionInfo()
+      const currentWorker = workerFlavorOf(hostInfo?.triple ?? null)
+      const currentRoles = rolesFlavorOf(hostInfo?.triple ?? null, hostInfo?.prerelease ?? null)
+      if (workerFlavorCompatible(marker.worker, currentWorker) && rolesFlavorCompatible(marker.roles, currentRoles)) {
         const system = await detectPresetSystem({ dshHome })
         if (shouldAbort?.()) return { installed: false, reason: PRESET_ENSURE_ABORTED }
         const presetIds = listOrchestratorPresetIds(dshHome)
@@ -352,7 +544,7 @@ export async function ensurePresetInstalled({ dshHome = resolveDshHome(), genera
           if (marker.track === 'declarative' && backfilled.length === 0) {
             return { installed: false, reason: 'preset 已由当前版本生成器产出，无需重生成' }
           }
-          writeFileSync(markerFile, formatGeneratorMarker(generatorVersion, 'declarative', currentWorker), 'utf8')
+          writeFileSync(markerFile, formatGeneratorMarker(generatorVersion, 'declarative', currentWorker, currentRoles), 'utf8')
           return backfilled.length > 0
             ? { installed: false, backfilled, reason: `宿主已切换声明行轨，补写 ${backfilled.length} 条预设声明行（preset 内容未重生成）` }
             : { installed: false, reason: '预设安装轨道标记已更新为声明行轨（内容无需重生成）' }
@@ -363,12 +555,12 @@ export async function ensurePresetInstalled({ dshHome = resolveDshHome(), genera
           if (marker.track === 'directory') {
             return { installed: false, reason: 'preset 已由当前版本生成器产出，无需重生成' }
           }
-          writeFileSync(markerFile, formatGeneratorMarker(generatorVersion, 'directory', currentWorker), 'utf8')
+          writeFileSync(markerFile, formatGeneratorMarker(generatorVersion, 'directory', currentWorker, currentRoles), 'utf8')
           return { installed: false, reason: '预设安装轨道标记已升级为带轨道格式（内容无需重生成）' }
         }
         // 声明行残留 + directory 宿主：落到下方整盘重生成
       }
-      // worker 形态不符（含旧格式标记升级到 v3）：落到下方整盘重生成
+      // worker 形态或角色行形态不符（含旧格式标记升级到 v4）：落到下方整盘重生成
     }
 
     if (shouldAbort?.()) return { installed: false, reason: PRESET_ENSURE_ABORTED }
@@ -396,16 +588,20 @@ export async function ensurePresetInstalled({ dshHome = resolveDshHome(), genera
     if (shouldAbort?.()) return { installed: false, reason: PRESET_ENSURE_ABORTED }
     mkdirSync(presetDir, { recursive: true })
     const track = result.presetSystem === 'declarative' ? 'declarative' : 'directory'
-    writeFileSync(markerFile, formatGeneratorMarker(generatorVersion, track, workerFlavorOf(state.hostVersionTriple)), 'utf8')
+    writeFileSync(markerFile, formatGeneratorMarker(generatorVersion, track, workerFlavorOf(state.hostVersionTriple), rolesFlavorOf(state.hostVersionTriple, state.hostPrerelease)), 'utf8')
     // 声明轨上整盘重生成只重建本 preset 的行：其余工作区 preset 目录若在而
     // 声明行缺（轨道翻转后首次触发本路径），一并补齐。
     const backfilled = track === 'declarative' ? backfillHomePatchRows(dshHome, listOrchestratorPresetIds(dshHome)) : []
+    // 工作区预设角色行形态换代（宿主跨 0.2.1 边界后的存量 orchestrator-<slug>
+    // 产物）：基础重生成只换了全局预设，工作区产物不跟手就会继续被守卫拒绝。
+    const migratedPresets = migrateWorkspacePresetRoles({ dshHome, state })
     return {
       installed: true,
       ...(backfilled.length > 0 ? { backfilled } : {}),
-      reason: state.existing
-        ? 'preset 缺失或由旧版生成器产出，已按现有配置重新生成'
-        : 'preset 缺失或由旧版生成器产出，已写入基础模板',
+      ...(migratedPresets.length > 0 ? { migratedPresets } : {}),
+      reason:
+        (state.existing ? 'preset 缺失或由旧版生成器产出，已按现有配置重新生成' : 'preset 缺失或由旧版生成器产出，已写入基础模板') +
+        (migratedPresets.length > 0 ? `；工作区预设角色行已换代：${migratedPresets.join('、')}` : ''),
     }
   } catch (err) {
     // 绝不抛：首装自愈是锦上添花，失败只带回 error 交调用方记日志，不拖垮插件启动。

package/plugins/paoding-config-ui/index.mjs

@@ -2,11 +2,13 @@
  * paoding-config-ui — DSH Web 插件 (cordis)
  *
  * 把 dsh-paoding 可视化配置器整合进 DSH Web GUI（左侧栏全页配置，无独立服务端）：
- *   - Node 侧：注册 /api/paoding/* 前缀路由（state/models/workspaces/version/
- *     upgrade/preview/apply/rescan/config/export/config/import + client.css
- *     静态样式），经
+ *   - Node 侧：注册 /api/paoding/* 前缀路由（state/models/workspaces/presets/
+ *     version/upgrade/preview/apply/rescan/config/export/config/import +
+ *     client.css 静态样式），经
  *     ./api-core.mjs 复用 tools/install.mjs 的检测与生成管线；workspaces 直连
- *     宿主 workspaceRegistry 服务（list / create，幂等）；version
+ *     宿主 workspaceRegistry 服务（list / create，幂等）；presets 提供预设
+ *     对象的 CRUD（列举 / 新增更新 / 删除工作区预设，全局 orchestrator 由启动
+ *     自愈保障、拒绝删除）；version
  *     复用 tools/lib/version.mjs 的版本检测（npm registry 优先，npmmirror
  *     镜像、GitHub release 依次兜底）；upgrade 经 tools/lib/upgrade.mjs 完成
  *     一键升级（常规 profile spawn dsh 插件转发器；desktop profile 被 dsh CLI
@@ -37,7 +39,7 @@ import { readFile } from 'node:fs/promises'
 import os from 'node:os'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
-import { getState, refreshState, isStateCacheStale, serializeState, installAssignments, resolveDshHome, discoverWorkspaceCandidates, ensurePresetInstalled, pluginVersion, exportConfigPayload, importConfigContent } from './api-core.mjs'
+import { getState, refreshState, isStateCacheStale, serializeState, installAssignments, resolveDshHome, discoverWorkspaceCandidates, ensurePresetInstalled, pluginVersion, exportConfigPayload, importConfigContent, listPresets, resolveWorkspacePathByPresetId, deleteWorkspacePreset } from './api-core.mjs'
 import { collectModelRefs } from '../../tools/lib/health.mjs'
 import { detectSkills } from '../../tools/lib/skills.mjs'
 import { collectRuntimeFacts } from './runtime-inventory.mjs'
@@ -289,6 +291,73 @@ async function modelDirectoryOf(ctx) {
   return { groups: results.filter(Boolean), failures }
 }
 
+/**
+ * 工作区预设写侧公共流程（POST presets / PUT presets/<id> 共用，模块级以便
+ * 复用同一把闸）：与 apply 路由完全同款 —— in-flight 闸防并发写盘、原始 state
+ * 喂生成管线（serializeState 视图会炸 TypeError，契约见 tests/api-apply.test.mjs）、
+ * 按需取模型目录做体检、落盘后强制重刷缓存（best-effort，失败只 warn）。
+ * withCreated：POST 需要回 created（以进 installAssignments 前的
+ * state.existing?.workspaces 判断该工作区键是否已存在）；PUT 一律视作更新，
+ * 不回该键。生成失败按 apply 同款 422（err.warnings 透传体检结果）。
+ */
+async function writeWorkspacePreset(ctx, res, { workspacePath, assignments, withCreated }) {
+  if (applyInFlight) {
+    json(res, 409, { error: '已有一次应用（apply）正在进行，请稍后重试' })
+    return
+  }
+  applyInFlight = true
+  try {
+    const s = await rawStateWithRuntimeFacts(ctx)
+    const created = withCreated
+      ? !(s.existing?.workspaces && Object.prototype.hasOwnProperty.call(s.existing.workspaces, workspacePath))
+      : undefined
+    // 模型目录按需取（unknown_model 体检的比对名单），口径与 apply 一致：
+    // assignments 里没有任何角色专用模型时不做目录发现，拿不到传 null。
+    let models = null
+    if (collectModelRefs(assignments).length > 0) {
+      try {
+        models = (await modelDirectoryOf(ctx)).groups
+      } catch {
+        models = null
+      }
+    }
+    try {
+      const result = installAssignments(s, assignments, {
+        dryRun: false,
+        saveConfigOnWrite: true,
+        workspacePath,
+        models,
+      })
+      // 落盘后强制重刷状态缓存（同 apply：否则浏览器刷新读到应用前的快照）；
+      // best-effort，刷新失败不影响已成功的落盘结果。
+      try {
+        await rawStateWithRuntimeFacts(ctx, { force: true })
+      } catch (err) {
+        ctx.logger?.warn?.('paoding-config-ui: post-apply state refresh failed: ' + String(err?.message ?? err))
+      }
+      json(res, 200, {
+        wrote: result.wrote,
+        staleNote: result.staleNote,
+        roleResults: result.roleResults,
+        text: result.text,
+        // 本次落点随 workspacePath：orchestrator（全局更新）或 orchestrator-<slug>。
+        presetId: result.presetId,
+        configFile: s.configFile,
+        warnings: result.warnings,
+        ...(withCreated ? { created } : {}),
+        workspace: workspacePath,
+      })
+    } catch (err) {
+      json(res, 422, {
+        error: err.message,
+        ...(Array.isArray(err?.warnings) ? { warnings: err.warnings } : {}),
+      })
+    }
+  } finally {
+    applyInFlight = false
+  }
+}
+
 // —— 宿主热切换竞态兜底 ————————————————————————————————————————————
 // dsh 0.1.7-rc.2 / 0.2.0-rc.x 插件列表「禁用→启用」会重建条目纤维：新 apply()
 // 先执行，旧 incarnation 的路由注销走异步结算，注册瞬间旧路由常仍在表里，
@@ -658,6 +727,129 @@ export async function apply(ctx) {
           return
         }
 
+        // ── 预设 CRUD（presets 路由族）──────────────────────────────────────
+        // 把「预设对象」的生命周期开放给 API（服务端核心在 api-core.mjs）：
+        //   GET    presets        列举：全局 orchestrator 恒在首位 + 配置
+        //                         workspaces 段的各工作区预设（只读）。
+        //   POST   presets        新增（或幂等更新）工作区预设 = apply 带
+        //                         workspace 的幂等包装：同一生成管线落
+        //                         orchestrator-<slug> 并把条目并进配置
+        //                         workspaces 段，响应多带 created / workspace。
+        //   PUT    presets/<id>   更新既有预设（orchestrator = 全局，等价
+        //                         apply 不带 workspace；orchestrator-<slug>
+        //                         = 反查到的工作区）。
+        //   DELETE presets/<id>   删工作区预设 = 配置条目 + preset 目录产物 +
+        //                         声明行三位一体清理；全局 orchestrator 由
+        //                         插件启动自愈保障，删除一律 403 拒绝。
+        // 写侧三条（POST/PUT/DELETE）与 apply 共用同一把 in-flight 闸：任一
+        // 落盘路径进行中，其余写请求一律 409，防并发交错写配置。方法不符的
+        // 路径不命中以下分支，落到底部 404 兜底（与既有路由一致）。
+        if (route === 'presets' && req.method === 'GET') {
+          // 列举只读：serializeState 后的浏览器视图即可（existing /
+          // installedPresets / workspaceMeta 齐全，见 listPresets）。
+          json(res, 200, { ok: true, presets: listPresets(await stateWithRuntimeFacts(ctx)) })
+          return
+        }
+
+        if (route === 'presets' && req.method === 'POST') {
+          // 新增 / 幂等更新工作区预设。校验先行（不占闸）：assignments 非空
+          // 对象、workspace 归一为绝对路径且 statSync 预检是目录（文案与
+          // POST /workspaces / apply 的工作区预检同款）。
+          const body = await readBody(req)
+          const assignments = body.assignments
+          if (!assignments || typeof assignments !== 'object' || Array.isArray(assignments) || Object.keys(assignments).length === 0) {
+            json(res, 422, { error: '缺少预设配置（body.assignments）' })
+            return
+          }
+          const rawWorkspace = typeof body.workspace === 'string' ? body.workspace.trim() : ''
+          if (rawWorkspace === '') {
+            json(res, 422, { error: '缺少工作区目录绝对路径（body.workspace）' })
+            return
+          }
+          let wsStat = null
+          try { wsStat = statSync(rawWorkspace) } catch { /* 不存在：stat 抛错，落到下方 422 */ }
+          if (!wsStat || !wsStat.isDirectory()) {
+            json(res, 422, { error: `目录不存在或不是目录：${rawWorkspace}` })
+            return
+          }
+          await writeWorkspacePreset(ctx, res, {
+            workspacePath: path.normalize(path.resolve(rawWorkspace)),
+            assignments,
+            withCreated: true,
+          })
+          return
+        }
+
+        if (route.startsWith('presets/') && (req.method === 'PUT' || req.method === 'DELETE')) {
+          const presetId = route.slice('presets/'.length)
+          // 只认单层 id（presets/<id>）；空 id / 多层路径落底部 404 兜底。
+          if (presetId !== '' && !presetId.includes('/')) {
+            // 全局预设两态先行分流：更新 = 等价 apply 不带 workspace；删除
+            // 语义不成立（启动自愈会装回来），403 直接拒绝。
+            if (req.method === 'DELETE' && presetId === 'orchestrator') {
+              json(res, 403, { error: '全局 orchestrator 预设不支持删除：插件启动自愈会自动重装；卸载请移除 dsh-paoding 插件' })
+              return
+            }
+            // PUT 的 body 与校验先行（不占闸，与 POST 同款文案），校验过了再
+            // 分流全局 / 工作区；DELETE 无 body。
+            let assignments = null
+            if (req.method === 'PUT') {
+              const body = await readBody(req)
+              assignments = body.assignments
+              if (!assignments || typeof assignments !== 'object' || Array.isArray(assignments) || Object.keys(assignments).length === 0) {
+                json(res, 422, { error: '缺少预设配置（body.assignments）' })
+                return
+              }
+            }
+            if (presetId === 'orchestrator') {
+              // 全局更新：workspacePath = null、无 created，其余与 POST 一致。
+              await writeWorkspacePreset(ctx, res, { workspacePath: null, assignments, withCreated: false })
+              return
+            }
+            // 工作区预设按 id 反查路径（原始 state 的 existing.workspaces 键集
+            // 整组 assignSlugs，同 basename 的 hash 后缀才对得上）；此处读取
+            // 在闸外（缓存命中近乎零成本），未知的 id 趁早 404，不必等闸。
+            const s0 = await rawStateWithRuntimeFacts(ctx)
+            const workspacePath = resolveWorkspacePathByPresetId(s0.existing, presetId)
+            if (workspacePath === null) {
+              json(res, 404, { error: `未找到预设: ${presetId}` })
+              return
+            }
+            // 目录预检（配置里的路径可能已被外部删除），文案与 POST 同款。
+            let wsStat = null
+            try { wsStat = statSync(workspacePath) } catch { /* 不存在：落到下方 422 */ }
+            if (!wsStat || !wsStat.isDirectory()) {
+              json(res, 422, { error: `目录不存在或不是目录：${workspacePath}` })
+              return
+            }
+            if (req.method === 'PUT') {
+              await writeWorkspacePreset(ctx, res, { workspacePath, assignments, withCreated: false })
+              return
+            }
+            // DELETE：核心清理在 deleteWorkspacePreset（配置重读护栏在函数
+            // 内部），传原始 state 拿 yamlMod / dshHome / configFile。与写侧
+            // 共用同一把闸；成功后显式重刷缓存（saveConfig 已改 mtime，理论
+            // 上缓存自失效，重刷与 POST/PUT 对齐；best-effort）。
+            if (applyInFlight) {
+              json(res, 409, { error: '已有一次应用（apply）正在进行，请稍后重试' })
+              return
+            }
+            applyInFlight = true
+            try {
+              const removed = deleteWorkspacePreset(s0, workspacePath)
+              try {
+                await rawStateWithRuntimeFacts(ctx, { force: true })
+              } catch (err) {
+                ctx.logger?.warn?.('paoding-config-ui: post-apply state refresh failed: ' + String(err?.message ?? err))
+              }
+              json(res, 200, { ok: true, ...removed })
+            } finally {
+              applyInFlight = false
+            }
+            return
+          }
+        }
+
         json(res, 404, { error: `no such route: ${req.method} /api/paoding/${route}` })
       } catch (err) {
         // 错误原文（可能带本机绝对路径）留日志；对外 message 先脱敏（home /

package/plugins/paoding-config-ui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paoding-config-ui",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "private": true,
   "type": "module",
   "main": "index.mjs",

package/presets/orchestrator/agent.cordis.yml

@@ -18,12 +18,15 @@
 
 # ── identity ────────────────────────────────────────────────────────────────
 
-# 编排人设：{{model}}/{{cwd}} 由 agent 的 route/workspace 解析（同 standard）。
+# 编排人设：{{model}} 由 agent 的 route 解析；{{cwd}} 禁用（见下）。
+# 注意：作为 agent-preset-registry 选中 preset 挂部署主代理时，0.2.1 的
+# deployment:persona-prefix 段只注册 provider/model——禁用 {{cwd}}（纯装饰，
+# 工作目录已由宿主 env 上下文提供）。
 - id: persona
   name: '@deepseek-ai/dsh-persona'
   config:
     prefix: |-
-      You are the orchestrator agent powered by the {{model}} model. Your working directory is {{cwd}}.
+      You are the orchestrator agent powered by the {{model}} model.
 
       Decompose the task, delegate to role agents, integrate results.
       - Internal file questions (finding code, references, reading files): solve yourself with glob/grep/read (and codegraph if enabled) — never delegate them.