dsh-paoding 0.4.5 → 0.4.6

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, 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,6 +733,35 @@ 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——检测失败也回

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;