dsh-paoding 0.4.4 → 0.4.6

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

@@ -8,14 +8,15 @@
  */
 import os from 'node:os'
 import path from 'node:path'
-import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs'
+import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, 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 { computeRestrictAllow } from '../../tools/lib/compose.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 { ROLES, warn } from '../../tools/lib/util.mjs'
 import {
   backfillHomePatchRows,
   detectAgentRolesFlavor,
@@ -288,10 +289,178 @@ export async function importConfigContent(content) {
     error.statusCode = 422
     throw error
   }
+  // 写盘前自动轮换备份（当前配置推入 bak-1，旧 bak 依次后移；首次保存无
+  // 「当前」则不备份）——apply / 工作区预设写盘 / 回滚同一口径，见下方备份节。
+  rotateConfigBackups()
   saveConfig(resolveConfigFile(), normalizeConfig(data))
   return { ok: true }
 }
 
+// ── 配置自动备份与回滚（配置文件写路径的护栏，页头「更多」菜单服务端核心）──────
+//
+// 语义：凡面板写配置（apply / import / 工作区预设写盘 / 回滚本身）在落盘前先把
+// 当前配置推入备份链：当前 → bak-1（最新），旧 bak 依次后移（bak-1→bak-2、
+// bak-2→bak-3），bak-3（最老）淘汰。首次保存（配置文件尚不存在）没有「当前」
+// 可备份，不产生任何 bak 文件。备份名 = 配置文件名 + .bak-N（默认配置即
+// dsh-paoding.config.yml.bak-1/2/3），自定义配置名（DSH_PAODING_CONFIG）随之
+// 派生，清单与还原按同一派生口径校验。
+
+/** 备份名校验用正则：配置文件名转义后拼 .bak-N 后缀（N = 1..3 层）。 */
+function configBackupRe() {
+  const stem = path.basename(resolveConfigFile()).replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+  return new RegExp(`^${stem}\\.bak-([123])$`)
+}
+
+/** 第 n 层备份的绝对路径（与配置文件同目录，文件名恒为单层 basename）。 */
+function configBackupPath(n) {
+  return `${resolveConfigFile()}.bak-${n}`
+}
+
+/**
+ * 备份轮换：把当前配置推入 bak-1，旧 bak 依次后移，bak-3 淘汰。当前配置不
+ * 存在（首次保存）时不写任何文件、返回 false；轮换完成返回 true。当前文件
+ * 用拷贝而非改名进 bak-1——原地保留，读侧（生成管线 / 回滚校验）随时可读；
+ * 后移用改名，同一目录内 rename 是原子操作，中断也不产生半个备份。
+ */
+export function rotateConfigBackups() {
+  const config = resolveConfigFile()
+  if (!existsSync(config)) return false
+  rmSync(configBackupPath(3), { force: true }) // 最老一层直接淘汰（不存在也无妨）
+  for (const [from, to] of [[2, 3], [1, 2]]) {
+    try {
+      renameSync(configBackupPath(from), configBackupPath(to))
+    } catch (err) {
+      if (err.code !== 'ENOENT') throw err // 该层尚无备份：正常，跳过
+    }
+  }
+  copyFileSync(config, configBackupPath(1))
+  return true
+}
+
+/**
+ * 备份清单（GET config/backups）：{ file, mtimeMs, size }[]，按新→旧排序
+ *（mtime 降序，同刻并列时层号小者在前）。只读不写；配置目录读不了 / 无备份
+ * 一律返回空数组，绝不让清单页 5xx。file 恒为 basename（还原路由只认配置
+ * 目录内的备份名，回传它即可防路径穿越）。
+ */
+export function listConfigBackups() {
+  let names = []
+  try {
+    names = readdirSync(path.dirname(resolveConfigFile()))
+  } catch {
+    return [] // 目录不存在 / 不可读 = 无备份可言
+  }
+  const backupRe = configBackupRe()
+  return names
+    .map((name) => {
+      const m = backupRe.exec(name)
+      if (!m) return null
+      try {
+        const st = statSync(path.join(path.dirname(resolveConfigFile()), name))
+        return { file: name, mtimeMs: st.mtimeMs, size: st.size, layer: Number(m[1]) }
+      } catch {
+        return null // 列举途中被删 / stat 失败：跳过该条
+      }
+    })
+    .filter(Boolean)
+    .sort((a, b) => b.mtimeMs - a.mtimeMs || a.layer - b.layer)
+    .map(({ file, mtimeMs, size }) => ({ file, mtimeMs, size }))
+}
+
+/**
+ * 回滚配置（POST config/restore）：file 须精确匹配「配置文件名.bak-1/2/3」，
+ * 显式拒任何含分隔符 / 上跳段的名字（防路径穿越）；通过后先按 loadConfig 同一
+ * 口径验证备份可解析（坏备份拒绝覆盖，422；备份不存在 404——statusCode 由
+ * 路由层外层 catch 按其回状态码 + { error } 信封），再把「当前配置」按同款
+ * 轮换推入备份链（滚错了还能再滚回来），最后拷贝备份为当前。落盘即改 mtime，
+ * state 缓存靠既有对账自动失效，无需手动清理。
+ */
+export async function restoreConfigBackup(file) {
+  const name = typeof file === 'string' ? file : ''
+  if (name === '' || name.includes('/') || name.includes('..') || !configBackupRe().test(name)) {
+    const error = new Error(`备份文件名不合法（须为 ${path.basename(resolveConfigFile())}.bak-1/2/3）：${name === '' ? '（空）' : name}`)
+    error.statusCode = 422
+    throw error
+  }
+  const backupPath = path.join(path.dirname(resolveConfigFile()), name)
+  // 宿主 yaml 模块从 state 顺路取（collectState 已探测好）；state 通道异常时
+  // 退化为仅内置解析器校验，与 importConfigContent 同款降级——宁严勿漏。
+  let yamlMod = null
+  try {
+    yamlMod = (await getState())?.yamlMod ?? null
+  } catch { /* 校验口径降级，见上 */ }
+  let parsed = null
+  try {
+    parsed = loadConfig(backupPath, yamlMod)
+  } catch (err) {
+    const error = new Error(`备份无法解析为合法配置，已拒绝回滚：${err.message}`)
+    error.statusCode = 422
+    throw error
+  }
+  if (parsed === null) {
+    const error = new Error(`备份不存在：${name}`)
+    error.statusCode = 404
+    throw error
+  }
+  // 先把选定备份的内容读进内存再轮换：轮换会把整条备份链后移一层，固定层号
+  // （bak-N）路径下的内容随之改变——后读的话落到「当前」的就不是用户选的
+  // 那份快照了。配置文件很小，整读零成本，顺序必须遵守。
+  const content = readFileSync(backupPath)
+  // 回滚本身也是一次写配置：先把「当前」按同款轮换推入备份链（滚错了还能
+  // 再滚回来），再落选定快照。mtime 变化令 state 缓存按既有对账自动失效，
+  // 无需手动清理。
+  rotateConfigBackups()
+  writeFileSync(resolveConfigFile(), content, { mode: 0o600 }) // 权限口径与 saveConfig 一致
+  return { ok: true }
+}
+
+// ── 工具面瘦身统计（slim：state / preview / apply 响应的派生字段）─────────────
+
+/**
+ * 主 agent 工具面瘦身统计，口径与生成管线严格同源（composeGenerated）：
+ *   - total = 可用工具全集 = presetUniverse ∪ inventory 的名字数。presetUniverse
+ *     = restrict.mjs 主 agent 白名单（restrictBase）∪ 源 preset 各角色 allow
+ *     自带面；inventory = 检测到的可用 MCP / 插件工具名。这正是单 agent 模式下
+ *     主 agent 名下可能挂着的一切工具（computeRestrictAllow / usableWith 判定
+ *     用的同一候选全集），即「不拆角色时的完整工具面」；
+ *   - main = 当前 assignments 下主 agent 的有效 allow 计数：computeRestrictAllow
+ *    （base ∪ extra ∪ 自定义角色名 − main_agent_remove − roles_remove，过可用
+ *     性过滤）的结果长度；结果与 base 全同时该函数返回 null，按 base 计数。
+ * state 收原始通道（blocks 为 Map、inventory 为 Set）与序列化视图（blocks 为
+ * 普通对象、inventory 为数组）两态，一律只读。assignments 先剥 profile /
+ * workspaces、过 normalizeTargetFields 再算——手写未规范化的提交也得到与
+ * 落盘一致的口径。
+ */
+export function slimStatsOf(state, assignments) {
+  const restrictBase = Array.isArray(state?.restrictBase) ? state.restrictBase : []
+  // blocks 两种形态：原始 state 的 Map 值带 names 数组；序列化视图的值即名字数组
+  const blockValues = state?.blocks instanceof Map
+    ? [...state.blocks.values()]
+    : (state?.blocks && typeof state.blocks === 'object' ? Object.values(state.blocks) : [])
+  const presetUniverse = new Set(restrictBase)
+  for (const block of blockValues) {
+    for (const name of Array.isArray(block?.names) ? block.names : Array.isArray(block) ? block : []) {
+      presetUniverse.add(name)
+    }
+  }
+  const inventory = state?.inventory instanceof Set
+    ? state.inventory
+    : new Set(Array.isArray(state?.inventory) ? state.inventory : [])
+  const total = new Set([...presetUniverse, ...inventory]).size
+  const target = normalizeTargetFields(stripNonTargetKeys(assignments ?? {}))
+  const customToolNames = Object.keys(target.roles).filter((n) => !ROLES.includes(n))
+  const allow = computeRestrictAllow(
+    restrictBase,
+    presetUniverse,
+    inventory,
+    target.main_agent_extra,
+    target.main_agent_remove,
+    customToolNames,
+    target.roles_remove,
+  ) ?? restrictBase
+  return { total, main: allow.length }
+}
+
 // ── 预设 CRUD（presets 路由族的服务端核心）──────────────────────────────────
 //
 // 面板 apply 只覆盖「全局 / 单个工作区视角的生成」，这里补齐预设对象本身的

package/plugins/paoding-config-ui/icon.svg

@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <rect width="64" height="64" rx="14" fill="#4D6BFE"/>
+  <g transform="rotate(-45 32 32)">
+    <rect x="14" y="11" width="32" height="22" rx="3" fill="#FFFFFF"/>
+    <circle cx="41" cy="16.5" r="2" fill="#4D6BFE"/>
+    <rect x="44" y="17" width="13" height="10" rx="4" fill="#FFFFFF" opacity="0.85"/>
+  </g>
+</svg>

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

@@ -3,7 +3,8 @@
  *
  * 把 dsh-paoding 可视化配置器整合进 DSH Web GUI（左侧栏全页配置，无独立服务端）：
  *   - Node 侧：注册 /api/paoding/* 前缀路由（state/models/workspaces/presets/
- *     version/upgrade/preview/apply/rescan/config/export/config/import +
+ *     version/upgrade/preview/apply/rescan/config/export/config/import/
+ *     config/backups/config/restore +
  *     client.css 静态样式），经
  *     ./api-core.mjs 复用 tools/install.mjs 的检测与生成管线；workspaces 直连
  *     宿主 workspaceRegistry 服务（list / create，幂等）；presets 提供预设
@@ -39,10 +40,12 @@ 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, listPresets, resolveWorkspacePathByPresetId, deleteWorkspacePreset } from './api-core.mjs'
+import { getState, refreshState, isStateCacheStale, serializeState, installAssignments, resolveDshHome, discoverWorkspaceCandidates, ensurePresetInstalled, pluginVersion, exportConfigPayload, importConfigContent, listConfigBackups, restoreConfigBackup, rotateConfigBackups, slimStatsOf, listPresets, resolveWorkspacePathByPresetId, deleteWorkspacePreset } from './api-core.mjs'
 import { collectModelRefs } from '../../tools/lib/health.mjs'
+import { diffAssignments, loadConfig } from '../../tools/lib/config.mjs'
 import { detectSkills } from '../../tools/lib/skills.mjs'
-import { collectRuntimeFacts } from './runtime-inventory.mjs'
+import { collectRuntimeFacts, detectHmrOf } from './runtime-inventory.mjs'
+import { collectDelegationStats } from './stats-core.mjs'
 import { getVersionInfo } from '../../tools/lib/version.mjs'
 import { runUpgrade } from '../../tools/lib/upgrade.mjs'
 
@@ -216,9 +219,17 @@ function persistenceAvailableOf(ctx) {
   }
 }
 
-/** 面板 state 响应统一挂 persistenceAvailable（state / rescan 同一形状）。 */
+/** 面板 state 响应统一挂 persistenceAvailable（state / rescan 同一形状）。
+ *  slim：工具面瘦身统计（total = 可用工具全集名数、main = 已保存配置下主 agent
+ *  有效 allow 计数），按磁盘已保存配置算——state 是序列化视图（blocks 普通对象 /
+ *  inventory 数组），slimStatsOf 两态通吃；无配置文件时 existing 为 null，按空
+ *  目标字段算（main = restrict.mjs 基准白名单长度）。 */
 function stateResponse(ctx, state) {
-  return { ...state, persistenceAvailable: persistenceAvailableOf(ctx) }
+  return {
+    ...state,
+    persistenceAvailable: persistenceAvailableOf(ctx),
+    slim: slimStatsOf(state, state.existing ?? {}),
+  }
 }
 
 // ── state 读取共享 helper（「采集运行时事实 → 重刷 → 读缓存 →〔按需〕序列化」）──
@@ -322,6 +333,9 @@ async function writeWorkspacePreset(ctx, res, { workspacePath, assignments, with
       }
     }
     try {
+      // 写盘前自动轮换备份（当前配置推入 bak-1；首次保存无「当前」则不备份），
+      // 与 apply / import / 回滚同一口径——工作区预设写盘同样是配置写路径。
+      rotateConfigBackups()
       const result = installAssignments(s, assignments, {
         dryRun: false,
         saveConfigOnWrite: true,
@@ -436,6 +450,23 @@ export async function apply(ctx) {
           return
         }
 
+        if (route === 'stats' && req.method === 'GET') {
+          // 委派效果统计（GET stats?days=30&project=<slug>）：宿主
+          // sessionPersistence 服务逐会话冷读抽摘要聚合（A 路，见
+          // stats-core.mjs 文件头——服务面、slug 口径与失败判据的实测证据都在
+          // 那里）。服务经 ctx.reflect 软探测（绝不进 inject 数组：硬注入会让
+          // 缺服务的老宿主在挂载时就炸），拿不到回 { ok:false,
+          // reason:'persistence-unavailable' }，客户端整卡不渲染。project
+          // 缺省 = 当前面板项目（cwd → projectKey 换算），days 缺省 30 上限
+          // 365；project 非法在核心层抛 422（外层 catch 统一回 { error }）。
+          // 路由注册在既有 /api/paoding 前缀下，上方信任围栏自动覆盖本路由。
+          json(res, 200, await collectDelegationStats(ctx, {
+            project: url.searchParams.get('project') ?? undefined,
+            days: url.searchParams.get('days') ?? undefined,
+          }))
+          return
+        }
+
         if (route === 'models' && req.method === 'GET') {
           // 模型目录：DSH 设置页模型选择器同款目录（deepseek-official 三模型、
           // pi-ai 各路由等），JSON-safe 纯对象。与 state 缓存无关，每次实调——
@@ -608,6 +639,14 @@ export async function apply(ctx) {
               }
             }
             try {
+              // diff 旧值先读：apply 的落盘会覆盖磁盘配置，改前这一读才拿得到
+              // 磁盘真实内容（preview 不落盘，先后等价，统一走改前口径）。生成
+              // 管线随后对同一文件做同样的 loadConfig 护栏，解析失败同样 422。
+              const diskAssignments = loadConfig(s.configFile, s.yamlMod)
+              // 写盘前自动轮换备份（当前配置推入 bak-1；首次保存无「当前」则不
+              // 备份），与 import / 工作区预设写盘 / 回滚同一口径。预览不落盘，
+              // 不轮换。
+              if (!dryRun) rotateConfigBackups()
               const result = installAssignments(s, body.assignments, {
                 dryRun,
                 saveConfigOnWrite: !dryRun,
@@ -639,6 +678,12 @@ export async function apply(ctx) {
                 // 结构化体检结果（tools/lib/health.mjs）：未挂载工具 / 零工具角色 /
                 // 未知模型 / 预设漂移 / 生成期告警。纯增量字段，客户端批次负责渲染。
                 warnings: result.warnings,
+                // 本次提交相对磁盘现配置的差分（tools/lib/config.mjs 的纯结构化
+                // 结果，零文案，客户端 i18n 渲染）与工具面瘦身统计（total = 可用
+                // 工具全集，main = 本次提交下主 agent 有效 allow 计数）。均为纯
+                // 增量字段。
+                diff: diffAssignments(diskAssignments, body.assignments),
+                slim: slimStatsOf(s, body.assignments),
               })
             } catch (err) {
               // 422 保持既有 { error } 形状；体检结果（如零工具角色的可读说明）
@@ -688,13 +733,50 @@ export async function apply(ctx) {
           return
         }
 
+        if (route === 'config/backups' && req.method === 'GET') {
+          // 备份清单（新→旧）：{ file, mtimeMs, size }[]，无备份返回空数组。
+          // 纯读不写；file 恒为 basename，客户端回传它即够（还原路由只认配置
+          // 目录内的备份名）。
+          json(res, 200, { ok: true, backups: listConfigBackups() })
+          return
+        }
+
+        if (route === 'config/restore' && req.method === 'POST') {
+          // 回滚配置：{ file } 须精确匹配「配置文件名.bak-1/2/3」。与 apply /
+          // import 共用同一把 in-flight 闸（写盘路径防并发交错）。核心函数先
+          // loadConfig 验证备份可解析（坏备份 422 / 备份不存在 404，statusCode
+          // 由外层 catch 回 { error } 信封，不写盘），再把「当前配置」按同款
+          // 轮换推入备份链后拷贝备份为当前；mtime 变化令 state 缓存按既有对账
+          // 自动失效，无需手动清理。
+          const body = await readBody(req)
+          if (applyInFlight) {
+            json(res, 409, { error: '已有一次应用（apply）正在进行，请稍后重试' })
+            return
+          }
+          applyInFlight = true
+          try {
+            json(res, 200, await restoreConfigBackup(typeof body.file === 'string' ? body.file : ''))
+          } finally {
+            applyInFlight = false
+          }
+          return
+        }
+
         if (route === 'version' && req.method === 'GET') {
           // 版本提示：npm registry 优先，npmmirror / GitHub 依次兜底（version.mjs，
           // 带 1 小时内存缓存，命中不发外网请求）。绝不 5xx——检测失败也回
           // 200 + error 字段，面板据此静默降级（不打扰使用）。timeoutMs 3000：
           // 检测只是锦上添花，不值得让面板等更久。layout 告知客户端挂载形态
           //（升级确认框按此分流警示文案），见 MOUNT_LAYOUT 注释。
-          json(res, 200, { ...(await getVersionInfo({ timeoutMs: 3000 })), layout: MOUNT_LAYOUT })
+          // hotReloadable：宿主插件清单里有启用的 dsh-hmr 插件行（0.2.1+ web/
+          // desktop 默认）→ 升级后刷新页面即生效，确认框 / 成功 note 换
+          // 「刷新即生效」文案；探测失败 / 非 web 部署拿不到运行时 → false，
+          // 回落「需重启 DSH」文案。永不抛出（detectHmrOf 自捕）。
+          json(res, 200, {
+            ...(await getVersionInfo({ timeoutMs: 3000 })),
+            layout: MOUNT_LAYOUT,
+            hotReloadable: detectHmrOf(ctx),
+          })
           return
         }
 

package/plugins/paoding-config-ui/lib/base.css

@@ -364,6 +364,37 @@
   padding: 2px 0;
 }
 
+/* 工具分组筛选框：分组超过 8 项时，网格上方一行小输入框。oninput 直改
+   网格单项显隐（纯 DOM，不走重渲染——重渲染会吃掉输入框焦点），观感取
+   omd-nameInput 同族（边框 / 圆角 / 字号 token 一致），尺寸更紧凑。 */
+.omd-toolFilterWrap {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  padding: 2px 0;
+}
+
+.omd-toolFilter {
+  width: 100%;
+  box-sizing: border-box;
+  padding: 5px 8px;
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 8px;
+  background: var(--dsw-alias-bg-layer-2);
+  color: var(--dsw-alias-label-primary);
+  font: inherit;
+  font-size: 12px;
+  line-height: 18px;
+  transition: border-color 0.16s ease;
+}
+
+.omd-toolFilter:focus-visible {
+  outline: 2px solid var(--dsw-alias-state-business-primary);
+  outline-offset: 1px;
+}
+
+.omd-toolFilter::placeholder { color: var(--dsw-alias-label-tertiary); }
+
 .omd-toolItem {
   display: flex;
   align-items: center;
@@ -603,6 +634,64 @@
   overflow-wrap: anywhere;
 }
 
+/* 预览「本次变更」区块：preview.diff 的结构化差分行（净新增绿 / 净移除红 /
+   变更明细中性），卡片观感同 omd-pre（描边浅底圆角），行多随预览区滚动。 */
+.omd-diffBlock {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  margin: 6px 0 0;
+  padding: 8px 12px;
+  box-sizing: border-box;
+  border: 1px solid var(--dsw-alias-border-l1);
+  border-radius: 12px;
+  background: var(--dsw-alias-bg-layer-2);
+}
+
+.omd-diffHeading {
+  font-size: 11px;
+  line-height: 16px;
+  font-weight: 600;
+  letter-spacing: 0.05em;
+  text-transform: uppercase;
+  color: var(--dsw-alias-label-secondary);
+}
+
+.omd-diffLines {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+}
+
+.omd-diffLine {
+  font-size: 12px;
+  line-height: 18px;
+  color: var(--dsw-alias-label-secondary);
+  overflow-wrap: anywhere;
+}
+
+.omd-diffLineAdd { color: var(--dsw-alias-state-success-primary); }
+
+.omd-diffLineDel { color: var(--dsw-alias-state-error-primary); }
+
+.omd-diffNone {
+  font-size: 12px;
+  line-height: 18px;
+  color: var(--dsw-alias-label-tertiary);
+}
+
+/* 预览里的瘦身统计一行（按本次提交配置算）：与页头 pd-slimLine 同语义，
+   尾随「按当前未保存配置」小注再弱一档。 */
+.omd-slimLine {
+  margin: 6px 0 0;
+  font-size: 11px;
+  line-height: 16px;
+  color: var(--dsw-alias-label-secondary);
+  font-variant-numeric: tabular-nums;
+}
+
+.omd-slimNote { color: var(--dsw-alias-label-tertiary); }
+
 .omd-pre {
   box-sizing: border-box;
   margin: 0;
@@ -1286,6 +1375,85 @@ html[data-dsh-paoding-active]:not([data-dsh-mnemon-active]):not([data-dsh-taskbo
   color: var(--dsw-alias-label-tertiary);
 }
 
+/* 工具面瘦身统计一行：副标题之下（版本号 / 更新卡同区），按已保存配置算
+   的一行弱化小字；数字用等宽数位避免加载 / 应用后跳动。 */
+.pd-slimLine {
+  margin: 2px 0 0;
+  font-size: 11px;
+  line-height: 16px;
+  color: var(--dsw-alias-label-tertiary);
+  font-variant-numeric: tabular-nums;
+}
+
+/* 委派效果卡：页头瘦身统计行之下的只读紧凑表（GET stats 懒加载，服务缺失 /
+   拉取失败整卡不渲染）。行内五列网格——角色名占余宽可截断，数字列定宽右对
+   齐，最近使用列偏右；数字等宽数位防跳动，失败 >0 标红提醒。 */
+.pd-delegCard {
+  margin: 10px 0 0;
+  padding: 10px 12px 8px;
+  border: 1px solid var(--dsw-alias-border-l1);
+  border-radius: 12px;
+}
+
+.pd-delegTitle {
+  font-size: 12px;
+  line-height: 18px;
+  font-weight: 600;
+  color: var(--dsw-alias-label-primary);
+}
+
+.pd-delegTable {
+  margin-top: 6px;
+  font-size: 11px;
+  line-height: 20px;
+  color: var(--dsw-alias-label-secondary);
+  font-variant-numeric: tabular-nums;
+}
+
+.pd-delegRow {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) 44px 56px 44px 88px;
+  gap: 0 10px;
+  align-items: baseline;
+}
+
+.pd-delegHeaderRow {
+  color: var(--dsw-alias-label-tertiary);
+}
+
+.pd-delegRole {
+  overflow: hidden;
+  white-space: nowrap;
+  text-overflow: ellipsis;
+}
+
+.pd-delegNum {
+  text-align: right;
+}
+
+.pd-delegFail {
+  color: var(--dsw-alias-state-error-primary);
+}
+
+.pd-delegWhen {
+  text-align: right;
+  color: var(--dsw-alias-label-tertiary);
+}
+
+.pd-delegMore {
+  margin-top: 2px;
+  font-size: 11px;
+  line-height: 16px;
+  color: var(--dsw-alias-label-tertiary);
+}
+
+.pd-delegEmpty {
+  margin-top: 4px;
+  font-size: 11px;
+  line-height: 16px;
+  color: var(--dsw-alias-label-tertiary);
+}
+
 .pd-closeBtn {
   flex: none;
   display: inline-flex;
@@ -1457,6 +1625,82 @@ html[data-dsh-paoding-active]:not([data-dsh-mnemon-active]):not([data-dsh-taskbo
   cursor: not-allowed;
 }
 
+/* ── 恢复备份弹层：备份清单行（bak 徽标 + 本地时间 + 大小，整行可点）──── */
+/* 列表高度封顶出滚：备份链随每次 apply / restore 前滚一格，再长不顶破视口。 */
+.pd-backupList {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  max-height: 320px;
+  overflow-y: auto;
+  padding: 2px;
+}
+
+.pd-backupItem {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  width: 100%;
+  padding: 8px 10px;
+  box-sizing: border-box;
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 10px;
+  background: var(--dsw-alias-bg-layer-2);
+  color: var(--dsw-alias-label-primary);
+  font: inherit;
+  font-size: 12px;
+  line-height: 18px;
+  text-align: left;
+  cursor: pointer;
+  transition: border-color 0.12s ease, background 0.12s ease;
+}
+
+.pd-backupItem:hover:not(:disabled) {
+  border-color: var(--dsw-alias-state-business-primary);
+  background: color-mix(in srgb, var(--dsw-alias-state-business-primary) 6%, transparent);
+}
+
+.pd-backupItem:focus-visible {
+  outline: 2px solid var(--dsw-alias-state-business-primary);
+  outline-offset: 1px;
+}
+
+.pd-backupItem:disabled { opacity: 0.55; cursor: default; }
+
+.pd-backupTag {
+  flex: none;
+  padding: 1px 8px;
+  border-radius: 999px;
+  background: color-mix(in srgb, var(--dsw-alias-state-business-primary) 10%, transparent);
+  color: var(--dsw-alias-state-business-primary);
+  font-size: 11px;
+  line-height: 16px;
+  font-weight: 500;
+  font-variant-numeric: tabular-nums;
+}
+
+.pd-backupTime {
+  flex: 1;
+  min-width: 0;
+  overflow-wrap: anywhere;
+  text-align: left;
+}
+
+.pd-backupSize {
+  flex: none;
+  color: var(--dsw-alias-label-tertiary);
+  font-variant-numeric: tabular-nums;
+}
+
+/* 加载中 / 暂无备份：一行居中弱化文案（omd-empty 的弹窗版）。 */
+.pd-backupEmpty {
+  padding: 12px 0 8px;
+  font-size: 12px;
+  line-height: 18px;
+  color: var(--dsw-alias-label-tertiary);
+  text-align: center;
+}
+
 /* ── Toast 反馈（fixed 悬浮于操作坞上方）──────────────────────────────── */
 .pd-toastHost {
   position: fixed;