dsh-paoding 0.3.3 → 0.3.5

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

@@ -12,6 +12,14 @@ import { mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from 'n
 import { readFile } from 'node:fs/promises'
 import { assignSlugs, collectState, generateAndInstall, presetIdOf } from '../../tools/install.mjs'
 import { autoAssignments } from '../../tools/lib/alloc.mjs'
+import {
+  backfillHomePatchRows,
+  detectPresetSystem,
+  formatGeneratorMarker,
+  listOrchestratorPresetIds,
+  parseGeneratorMarker,
+  readHomePatchRows,
+} from '../../tools/lib/preset-system.mjs'
 
 export function resolveDshHome() {
   return process.env.DSH_HOME || path.join(os.homedir(), '.dsh')
@@ -118,6 +126,9 @@ export function serializeState(s) {
     suggested: s.suggested,
     installedPresets,
     workspaceMeta,
+    // 预设安装轨道（declarative = 0.1.7+ 声明行 / directory = ≤0.1.6 目录扫描），
+    // 面板可据此展示；旧版 collectState 产出的 state 无此字段时按目录轨兜底
+    presetSystem: s.presetSystem ?? 'directory',
     // 主 persona 尾部追加的默认常量（供 UI「人设追加」默认展示 / 恢复默认）
     mainPersonaExtraDefault: s.mainPersonaExtraDefault ?? null,
     // 运行时识别结果透传（字段缺失视为未启用运行时检测，与旧版 UI 行为一致）
@@ -139,10 +150,11 @@ export function installAssignments(state, assignments, { dryRun = false, saveCon
 // ── 首装 / 升级后 preset 自动重生成 ─────────────────────────────────────────
 //
 // 唯一官方安装通道是插件通道（dsh plugin add dsh-paoding），包不再携带 CLI：
-// preset 的落盘改由插件启动时自愈——目录缺失（首装）或由旧版生成器产出（升级
-// 换包）时，按 install --auto 语义重生成一次。对账基准是 preset 目录里的
-// .generator-version 标记文件（内容 = 生成器版本）：插件包版本变 → 标记不符 →
-// 下次启动自动重生成，一举解决「升级后 preset 还是旧版产物」的漂移问题。
+// preset 的落盘改由插件启动时自愈。对账基准是 preset 目录里的 .generator-version
+// 标记文件（v2 起内容 = 生成器版本 + 预设安装轨道两行）：插件包版本变、或宿主
+// 轨道翻转（只升 dsh 不动插件——升级最常见路径，旧标记只记版本时同样解析为
+// 轨道不符）→ 下次启动自动自愈，一举解决「升级后 preset 还是旧版产物」与
+// 「升 dsh 后 preset 静默消失」两类漂移。
 
 // 生成器版本（标记对账基准）：插件包根 package.json 读一次即缓存。读失败兜底
 // '0.0.0'——最坏后果只是每次启动多重生成一次 preset，不会装坏任何东西。
@@ -162,21 +174,30 @@ export function pluginVersion() {
 const PRESET_ENSURE_ABORTED = '插件已卸载（dispose），本次 preset 生成中止'
 
 /**
- * 首装 / 升级后自动重生成 orchestrator preset（等价 install --auto 语义）。
+ * 首装 / 升级后自动安装 orchestrator preset（等价 install --auto 语义）。
  *
- * 判定：preset 目录缺失，或 .generator-version 标记缺失 / 版本与 generatorVersion
- * 不符 → 执行一次自动安装：局部 collectState()（不带运行时事实的纯文件扫描，
- * 首装触发点在插件启动、宿主服务未必就绪，且与 CLI --auto 语义对齐；不走
- * refreshState()——那会拿无事实的扫描覆盖路由层的共享缓存）后按既有配置合成
- * assignments（无配置写基础模板），经 generateAndInstall 落盘，最后写标记文件。
+ * 判定（满足其一即动盘）：
+ *   - preset 目录 / 标记缺失，或标记版本与 generatorVersion 不符 → 整盘重生成；
+ *   - 版本一致但标记轨道与当前宿主轨道不符（只升 dsh 不动插件 / 旧格式标记）→
+ *     轻量迁移：声明轨上按磁盘产物补写缺失声明行（内容字节不动，不重生成），
+ *     directory 轨上落回整盘重生成（残留声明行会让 0.1.6 profile 启动失败，
+ *     撤块自愈由其 directory 分支完成）；
+ *   - 版本轨道都一致 → 对账声明行（缺行补行、孤儿行撤行），齐则跳过。
+ * 局部 collectState() 不带运行时事实（首装触发点在插件启动、宿主服务未必就绪，
+ * 且与 CLI --auto 语义对齐；预设安装轨道由 collectState 内部按 argv 宿主版本 /
+ * dsh --version / 文件探测兜底，state.presetSystem 随 state 一并进
+ * generateAndInstall 双轨收尾；不走 refreshState()——那会拿无事实的扫描覆盖
+ * 路由层的共享缓存）后按既有配置合成 assignments（无配置写基础模板），经
+ * generateAndInstall 落盘，最后写标记文件（版本 + 轨道）。
  * shouldAbort 在各 await 点后检查：插件 dispose 后在途的生成不再继续写盘。
  * 可脱离 ctx 独立调用（单测友好），任何异常自捕、绝不抛出。
  *
  * @param {{dshHome?: string, generatorVersion?: string, shouldAbort?: () => boolean}} opts
  *   缺省取 resolveDshHome() 与 pluginVersion()；shouldAbort 返回 true 时中止
  *   （按 reason 返回，不算 error）。
- * @returns {Promise<{installed: boolean, reason?: string, error?: string}>}
- *   installed=true 表示本次实际重生成；false 时带 reason（无需重生成 / 已中止）
+ * @returns {Promise<{installed: boolean, backfilled?: string[], reason?: string, error?: string}>}
+ *   installed=true 表示本次实际重生成；backfilled 非空表示本次补写了哪些
+ *   preset 的声明行（内容未重生成）；两者皆否时带 reason（无需动盘 / 已中止）
  *   或 error（生成失败，调用方只记日志）。
  */
 export async function ensurePresetInstalled({ dshHome = resolveDshHome(), generatorVersion = pluginVersion(), shouldAbort = null } = {}) {
@@ -185,10 +206,35 @@ export async function ensurePresetInstalled({ dshHome = resolveDshHome(), genera
     const markerFile = path.join(presetDir, '.generator-version')
     let marker = null
     try {
-      marker = (await readFile(markerFile, 'utf8')).trim()
+      marker = parseGeneratorMarker(await readFile(markerFile, 'utf8'))
     } catch { /* 目录或标记缺失：按未生成处理 */ }
-    if (marker === generatorVersion) {
-      return { installed: false, reason: 'preset 已由当前版本生成器产出，无需重生成' }
+
+    if (marker !== null && marker.version === generatorVersion) {
+      // 版本一致：内容无需重生成，但宿主轨道可能已随 dsh 升降级翻转（只升 dsh
+      // 不动插件是升级常态），声明行也可能被外部动过——这里做轻量对账。
+      const system = await detectPresetSystem({ dshHome })
+      if (shouldAbort?.()) return { installed: false, reason: PRESET_ENSURE_ABORTED }
+      const presetIds = listOrchestratorPresetIds(dshHome)
+      if (system === 'declarative') {
+        const backfilled = backfillHomePatchRows(dshHome, presetIds)
+        if (marker.track === 'declarative' && backfilled.length === 0) {
+          return { installed: false, reason: 'preset 已由当前版本生成器产出，无需重生成' }
+        }
+        writeFileSync(markerFile, formatGeneratorMarker(generatorVersion, 'declarative'), 'utf8')
+        return backfilled.length > 0
+          ? { installed: false, backfilled, reason: `宿主已切换声明行轨，补写 ${backfilled.length} 条预设声明行（preset 内容未重生成）` }
+          : { installed: false, reason: '预设安装轨道标记已更新为声明行轨（内容无需重生成）' }
+      }
+      // directory 轨：声明行残留会让 0.1.6 profile 启动失败——有残留走整盘
+      // 重生成（directory 分支撤块自愈）；行清白时只升级标记格式，不动内容。
+      if (readHomePatchRows(dshHome).length === 0) {
+        if (marker.track === 'directory') {
+          return { installed: false, reason: 'preset 已由当前版本生成器产出，无需重生成' }
+        }
+        writeFileSync(markerFile, formatGeneratorMarker(generatorVersion, 'directory'), 'utf8')
+        return { installed: false, reason: '预设安装轨道标记已升级为带轨道格式（内容无需重生成）' }
+      }
+      // 声明行残留 + directory 宿主：落到下方整盘重生成
     }
 
     if (shouldAbort?.()) return { installed: false, reason: PRESET_ENSURE_ABORTED }
@@ -215,9 +261,14 @@ export async function ensurePresetInstalled({ dshHome = resolveDshHome(), genera
     // 标记最后写：generateAndInstall 会整目录重建（rmSync），先写必被删。
     if (shouldAbort?.()) return { installed: false, reason: PRESET_ENSURE_ABORTED }
     mkdirSync(presetDir, { recursive: true })
-    writeFileSync(markerFile, `${generatorVersion}\n`, 'utf8')
+    const track = result.presetSystem === 'declarative' ? 'declarative' : 'directory'
+    writeFileSync(markerFile, formatGeneratorMarker(generatorVersion, track), 'utf8')
+    // 声明轨上整盘重生成只重建本 preset 的行：其余工作区 preset 目录若在而
+    // 声明行缺（轨道翻转后首次触发本路径），一并补齐。
+    const backfilled = track === 'declarative' ? backfillHomePatchRows(dshHome, listOrchestratorPresetIds(dshHome)) : []
     return {
       installed: true,
+      ...(backfilled.length > 0 ? { backfilled } : {}),
       reason: state.existing
         ? 'preset 缺失或由旧版生成器产出，已按现有配置重新生成'
         : 'preset 缺失或由旧版生成器产出，已写入基础模板',

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

@@ -175,12 +175,16 @@ function triggerPresetEnsure(ctx, isDisposed) {
         ctx.logger?.info?.(
           `paoding-config-ui: orchestrator preset 已重生成（generator v${generatorVersion}，${r.reason}）`,
         )
+      } else if (Array.isArray(r.backfilled) && r.backfilled.length > 0) {
+        // 轨道迁移 / 声明行对账补写（preset 内容未重生成）：值得留一行轨迹，
+        // 方便「升级 dsh 后主子代理消失」这类问题定位。
+        ctx.logger?.info?.(`paoding-config-ui: ${r.reason ?? '预设声明行已补写'}（${r.backfilled.join('、')}）`)
       } else if (r.error) {
         // 失败复位防抖闩：下次 activate（热重载 / 重注册）可重试
         presetEnsureStarted = false
         ctx.logger?.warn?.(`paoding-config-ui: preset 自动生成失败（可在侧栏底部「庖丁配置」入口手动应用）: ${r.error}`)
       }
-      // 版本一致的常规跳过不打日志：每次启动都刷一行纯噪音。
+      // 版本轨道一致的常规跳过 / 纯标记格式升级不打日志：每次启动都刷一行纯噪音。
     })
     .catch((err) => {
       presetEnsureStarted = false

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

@@ -44,7 +44,7 @@
   flex: none;
   padding: 1px 8px;
   border-radius: 999px;
-  background: var(--dsw-alias-accent-soft, var(--dsw-alias-bg-layer-2));
+  background: var(--dsw-alias-interactive-bg-hover-accent, var(--dsw-alias-bg-layer-2));
   font-size: 11px;
   line-height: 16px;
   font-weight: 500;

package/plugins/paoding-config-ui/lib/client.js

@@ -24,6 +24,8 @@
  *  - factory 内 require() 只解析平台 seed 模块（react / cordis /
  *    ui-slots / ui-primitives 与已物化模块）；本 bundle 依赖 react 与
  *    @deepseek-ai/dsh-client-ui-primitives。
+ *  - 图标跨版本兜底：DSH ≤0.1.6 图标导出名带尺寸后缀（IconCheckOutline16），
+ *    0.1.7-rc.1 起改粗细命名 + size prop，factory 内把旧名别名到 Regular 版。
  *  - 挂载点：左侧栏底部动作位入口（sidebar.footer.action 键控槽，与插件
  *    广场 cordis 徽章同槽，设置行上方）+ 会话中栏全页 overlay
  *    （data-dsh-paoding-view / html[data-dsh-paoding-active]）；
@@ -51,6 +53,36 @@ window.__ModuleLoader__.load({
     var useState = React.useState, useEffect = React.useEffect, useCallback = React.useCallback, useRef = React.useRef;
     var P = require("@deepseek-ai/dsh-client-ui-primitives");
 
+    // 图标跨版本兜底：DSH ≤0.1.6 的 ui-primitives 图标导出名带尺寸后缀
+    // （IconCheckOutline16 / IconChevronDownOutline14，IconProps { size,
+    // className }）；0.1.7-rc.1 起改粗细命名（…OutlineRegular / …Medium，
+    // size 变 prop、默认 16），12 个旧名全部消失。同一份 bundle 要在两代
+    // 宿主上都能跑：旧名缺、新名在，才把旧名别名到对应 Regular 版——新
+    // 组件接受 size prop，ic() 的 size 传参照常生效，旧 14px 名 → Regular
+    // + size 14 视觉等价（同为 1px 描边）。旧宿主上有原生实现就用原生，
+    // Button / Pill 等两代都有的导出一律不动。
+    P = Object.assign({}, P); // 复制一份导出面再补别名：不往共享模块对象上写属性（避免污染宿主里其他 ui-primitives 消费者）；P 是 factory 作用域的 var，重赋值后所有后续片段看到的就是这份副本
+    (function () {
+      var ICON_ALIAS = {
+        IconCheckOutline16: "IconCheckOutlineRegular",
+        IconChevronDownOutline14: "IconChevronDownOutlineRegular",
+        IconCordisPluginOutline14: "IconCordisPluginOutlineRegular",
+        IconDataOutline16: "IconDataOutlineRegular",
+        IconEditOutline16: "IconEditOutlineRegular",
+        IconLoadingOutline16: "IconLoadingOutlineRegular",
+        IconPlusOutline16: "IconPlusOutlineRegular",
+        IconRefreshOutline16: "IconRefreshOutlineRegular",
+        IconSkillOutline16: "IconSkillOutlineRegular",
+        IconTrashOutline16: "IconTrashOutlineRegular",
+        IconUserOutline16: "IconUserOutlineRegular",
+        IconWarningOutline16: "IconWarningOutlineRegular",
+      };
+      Object.keys(ICON_ALIAS).forEach(function (oldName) {
+        var newName = ICON_ALIAS[oldName];
+        if (P[oldName] === undefined && P[newName] !== undefined) P[oldName] = P[newName];
+      });
+    })();
+
     // ── 样式注入（幂等）─────────────────────────────────────────────────
     //
     // 样式正文在 lib/base.css，由 Node 半经 GET /api/paoding/client.css 下发

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

@@ -1,6 +1,6 @@
 {
   "name": "paoding-config-ui",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "private": true,
   "type": "module",
   "main": "index.mjs",
@@ -9,7 +9,6 @@
     "client": {
       "platform": "web",
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-ui-settings",
         "@deepseek-ai/dsh-client-connection"
       ]

package/plugins/paoding-config-ui/runtime-inventory.mjs

@@ -18,6 +18,9 @@
  *     MCP 工具由 dsh-mcp-client 以 `mcp__<server>__<tool>` 公开名注册，
  *     故 schemas()/entries() 等能枚举出形如 mcp__tavily__tavily_search 的
  *     全名，与 tools/install.mjs 的 inventory 命名约定一致。
+ *   - 预设安装轨道（presetSystem）：agentPresets 服务有无 register 方法——
+ *     0.1.7+ 的 agent-preset-registry（声明行轨）有，≤0.1.6 的目录扫描服务
+ *     没有；collectState 拿它免掉 dsh --version 子进程探测。
  *
  * 约定：本模块只负责“取数”，任何一步失败都不抛出——错误记入 error 字符串
  * （多条用 '; ' 连接、整体截断），返回可用的部分结果；列表带截断上限防爆。
@@ -187,6 +190,22 @@ function readRegisteredToolNames(ctx, errors) {
   return { names: out, ok: acquired }
 }
 
+/**
+ * 预设安装轨道探测：0.1.7+ 宿主的 agentPresets 服务是 agent-preset-registry
+ * （带 register 方法，声明行轨）；≤0.1.6 的同名服务只做 .agent-presets 目录
+ * 扫描、没有 register。ctx.reflect.get(name, false) 读不到服务返回 undefined、
+ * 不触发 inject 护栏，整个探测自捕——任何异常都按 directory（安全侧）处理，
+ * 永不抛出。
+ */
+function detectPresetSystemOf(ctx) {
+  try {
+    const svc = ctx?.reflect?.get?.('agentPresets', false)
+    return svc != null && typeof svc.register === 'function' ? 'declarative' : 'directory'
+  } catch {
+    return 'directory'
+  }
+}
+
 /**
  * 采集运行时事实（供 collectState 合并 / UI 展示）。
  * 永不抛出：任何异常都会落到 error 里，返回部分结果。
@@ -209,5 +228,6 @@ export function collectRuntimeFacts(ctx) {
     ...(error !== '' ? { error } : {}),
     pluginEntries: plugin.entries,
     toolNames: tools.names,
+    presetSystem: detectPresetSystemOf(ctx),
   }
 }

package/presets/orchestrator/agent.cordis.yml

@@ -147,6 +147,9 @@
       name: '@deepseek-ai/dsh-compaction-basic'
       config:
         thresholdRatio: 0.45
+        # 钉住摘要预算：0.1.7 起该键默认从 8192 升到 65536，显式 8192 保持
+        # 0.1.5/0.1.6 的实际行为不变（摘要单次预算不随宿主版本漂移）。
+        maxTokens: 8192
 
     - id: command-compact
       name: '@deepseek-ai/dsh-command-compact'