dsh-paoding 0.2.2 → 0.3.0

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

@@ -1,10 +1,10 @@
 {
   "name": "paoding-config-ui",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "private": true,
   "type": "module",
   "main": "index.mjs",
-  "description": "庖丁 (dsh-paoding) 可视化配置器 — DSH Web 设置页集成插件（settings.section 分区 + /api/paoding 路由）",
+  "description": "庖丁 (dsh-paoding) 可视化配置器 — DSH Web 左侧栏全页配置插件（侧栏入口 + /api/paoding 路由）",
   "dsh": {
     "client": {
       "platform": "web",

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

@@ -62,8 +62,9 @@ function collectToolNames(value, out, seen) {
     } else if (item && typeof item === 'object') {
       if (typeof item.name === 'string') {
         pushName(item.name, out, seen)
-      } else {
-        // 兜底：{ [key]: def } 形态的对象，按 key/def.name 处理
+      } else if (Object.keys(item).length === 1) {
+        // 兜底：{ [key]: def } 形态的对象，按 key/def.name 处理——仅接受单键
+        // 对象（多键对象没有唯一「工具名」语义，跳过）
         for (const [k, v] of Object.entries(item)) pushPair(k, v, out, seen)
       }
     }
@@ -93,25 +94,15 @@ function getService(ctx, key) {
   return undefined
 }
 
-/** 收集一个对象的可调用方法名（沿原型链，去重，限量）。 */
-function collectMethodNames(svc) {
-  const methods = []
-  for (let proto = Object.getPrototypeOf(svc); proto && proto !== Object.prototype; proto = Object.getPrototypeOf(proto)) {
-    for (const m of Object.getOwnPropertyNames(proto)) {
-      if (m !== 'constructor' && typeof svc[m] === 'function' && !methods.includes(m)) methods.push(m)
-    }
-  }
-  return methods
-}
-
 /**
  * 读取运行时插件清单。返回 { entries, ok }：ok 表示成功拿到 list() 结果
  * （空清单也算成功，区别于服务不可用）。
  */
 function collectPluginEntries(ctx, errors) {
   const pi = getService(ctx, 'pluginInventory')
-  if (pi == null || typeof pi.list !== 'function') return { entries: [], ok: false }
   try {
+    // 服务属性访问也纳入 try（cordis 代理 getter 理论上可能抛）：兑现「永不抛」契约
+    if (pi == null || typeof pi.list !== 'function') return { entries: [], ok: false }
     const result = pi.list()
     // list() 官方返回 { entries: [...] }；兼容直接返回数组的形态
     const raw = Array.isArray(result) ? result : Array.isArray(result?.entries) ? result.entries : null
@@ -135,7 +126,7 @@ function collectPluginEntries(ctx, errors) {
     }
     return { entries, ok: true }
   } catch (err) {
-    errors.push(`pluginInventory.list() threw: ${String(err?.message ?? err)}`)
+    errors.push(`pluginInventory.list() failed: ${String(err?.message ?? err)}`)
     return { entries: [], ok: false }
   }
 }
@@ -145,20 +136,26 @@ function collectPluginEntries(ctx, errors) {
  *   1) t.entries() 若可调用（Map / 迭代器 / 数组 归一化）；
  *   2) t.schemas() 若可调用（返回 [{ name, description, ... }]，全局视图 =
  *      全部已注册工具，含 mcp__<server>__<tool>）；
- *   3) 在方法名里找含 entries/list/schemas/keys 的可调用方法逐个 try 调用
- *      （不硬猜 presentAs/visible 这类语义方法）；
- *   4) 全部失败返回空数组。返回 { names, ok }。
+ *   3) 兜底：只试白名单里的只读枚举方法名（entries/schemas/list/keys/
+ *      listKeys），不做正则泛配（避免误调写方法）；
+ *   4) 全部失败返回空数组（原因记入 errors）。返回 { names, ok }。
  */
 function readRegisteredToolNames(ctx, errors) {
   const out = []
   const seen = new Set()
   const t = getService(ctx, 'tools')
-  if (t == null) return { names: [], ok: false }
+  if (t == null) {
+    // 单侧失败也留痕：UI 可区分「无工具」与「tools 服务不可用」
+    errors.push('tools service unavailable')
+    return { names: [], ok: false }
+  }
   const tried = new Set()
   const attempt = (method, source) => {
-    if (typeof t[method] !== 'function' || tried.has(method)) return false
+    if (tried.has(method)) return false
     tried.add(method)
     try {
+      // 方法属性读取也纳入 try（cordis 代理 getter 可能抛）
+      if (typeof t[method] !== 'function') return false
       const result = t[method]()
       // 拿到可迭代结果即视为“服务可用”（即使为空清单）；无结果 / 抛错都跳过
       if (result != null && typeof result[Symbol.iterator] === 'function') {
@@ -176,14 +173,17 @@ function readRegisteredToolNames(ctx, errors) {
   let acquired = attempt('entries', 'tools.entries()')
   if (!acquired) acquired = attempt('schemas', 'tools.schemas()')
 
-  // 3) 兜底：在方法列表里找名字含 entries/list/schemas/keys 的函数逐个尝试
+  // 3) 兜底：只试白名单里的只读枚举方法名（不做正则泛配）；已在 1)/2) 试过
+  //    的 entries/schemas 由 tried 去重，不会重复调用
   if (!acquired) {
-    const hint = /entries|list|schemas|keys/
-    for (const m of collectMethodNames(t)) {
-      if (!hint.test(m)) continue
+    for (const m of ['entries', 'schemas', 'list', 'keys', 'listKeys']) {
       if (attempt(m, `tools.${m}()`)) { acquired = true; break }
     }
   }
+  // 有服务但枚举口全不可读：同样留痕（区别于「服务可用但工具清单为空」）
+  if (!acquired) {
+    errors.push('tools service present but no readable enumeration (entries/schemas/list/keys/listKeys)')
+  }
   return { names: out, ok: acquired }
 }
 
@@ -197,9 +197,10 @@ export function collectRuntimeFacts(ctx) {
   const tools = readRegisteredToolNames(ctx, errors)
 
   // ok 语义：pluginInventory 与 tools 至少一个服务真正可用即为成功；
-  // 两个都拿不到才整体失败（UI 据此提示“已回退文件扫描”）。
+  // 两个都拿不到才整体失败（UI 据此提示“已回退文件扫描”）。单侧失败的原因
+  // 也已各自记入 errors（上方），UI 可区分「无工具」与「tools 服务不可用」。
   const ok = plugin.ok || tools.ok
-  if (!ok) errors.unshift('tools service unavailable (pluginInventory/tools both missing)')
+  if (!ok) errors.unshift('pluginInventory/tools both unavailable: fell back to file scan')
 
   let error = errors.join('; ')
   if (error.length > MAX_ERROR_LEN) error = error.slice(0, MAX_ERROR_LEN) + '…'

package/presets/orchestrator/agent.cordis.yml

@@ -7,11 +7,11 @@
 #   · orchestrator-restrict → restrict.mjs 在 system-prompt/assemble 瀑布上把
 #     主 agent 的工具面裁剪为「编排 + 内部搜索」白名单；子 agent（origin:
 #     'subagent'）放行，由各自 toolFilter 决定工具面
-#   · delegation-*       → 3 个角色委派工具（dsh-tool-subagent），子 agent 创建时
+#   · delegation-*       → 4 个角色委派工具（dsh-tool-subagent，search_internal_deep 为静态委派），子 agent 创建时
 #     以 per-child tools.restrict() 只保留各自 allow 的工具
 #
-# 工具税（每请求估算）：主 agent 全量 ~16.2k → 白名单后 ~5.5k（含 3 个委派工具）；
-# search_external ~3.0k / design ~3.2k / implement ~3.7k，仅实际委派时发生。
+# 工具税（每请求估算）：主 agent 全量 ~16.2k → 白名单后 ~5.5k（含 4 个委派工具）；
+# search_external ~3.0k / design ~3.3k / implement ~3.8k，仅实际委派时发生。
 
 # ── identity ────────────────────────────────────────────────────────────────
 
@@ -19,11 +19,11 @@
 - id: persona
   name: '@deepseek-ai/dsh-persona'
   config:
-    text: |-
+    prefix: |-
       You are the orchestrator agent powered by the {{model}} model. Your working directory is {{cwd}}.
 
       Decompose the task, delegate to role agents, integrate results.
-      - Internal file questions (finding code, references, reading files): solve yourself with glob/grep/read/codegraph — never delegate them.
+      - Internal file questions (finding code, references, reading files): solve yourself with glob/grep/read (and codegraph if enabled) — never delegate them.
       - External research: delegate to search_external.
       - UI/design work: delegate to design.
       - Code implementation: delegate to implement.
@@ -43,6 +43,11 @@
         · aborted → only re-delegate when the cancellation was accidental.
         · completed but poor output → re-delegate with concrete missing points, or send_message
           to ask a continuable child to finish the gaps.
+      - Continuable roles (background_mode: continuable): when a delegated run fails or
+        the output falls short, first send_message in the SAME child session to continue
+        and fix in place — resuming keeps the child's accumulated context, while
+        re-delegating starts a cold task and repeats finished work. Only re-delegate
+        when the child session is gone or the task needs a different role.
       - If the same task fails twice, stop retrying: report to the user what failed, why,
         and what you already tried. Never loop a failing delegation.
       - When re-delegating (fresh task or continuation), always include your integration
@@ -167,6 +172,7 @@
     - id: tool-subagent-list-agents
       name: '@deepseek-ai/dsh-tool-subagent-control/list-agents'
 
+    # subagent / subagent_fork / workflow-worker-thread / workflow / ralph 仅当用户经 main_agent_extra 显式开启时对主 agent 可达；保留以对齐 standard 全量组合。
     - id: tool-subagent
       name: '@deepseek-ai/dsh-tool-subagent'
       config:
@@ -207,6 +213,7 @@
       config:
         provider: spawn
         toolName: search_external
+        backgroundMode: one-shot
         persona: |-
           You are the external-research agent. Your job is web research only — use web_search and the tavily tools; you never modify files. Search the web, extract key facts, and return a concise structured research summary (findings, sources, open questions).
           On tool failure, do not retry a denied operation: report the failure compactly — what you completed, the exact error, which tool/permission you lack, and your suggested next step — so the orchestrator can re-delegate or adjust.
@@ -223,12 +230,13 @@
             - read
             - ask_user_question
 
-    # design：设计（读参考 + 设计技能 + 出 spec，不写最终代码）~3.2k
+    # design：设计（读参考 + 设计技能 + 出 spec，不写最终代码）~3.3k
     - id: delegation-design
       name: '@deepseek-ai/dsh-tool-subagent'
       config:
         provider: spawn
         toolName: design
+        backgroundMode: one-shot
         persona: |-
           You are the design agent. You produce UI/UX designs, wireframes, and frontend specs — and may load design skills (frontend-design, html-ppt) via the skill tool. Read reference material first, then deliver a concrete design spec. You do not implement final code.
           On tool failure, do not retry a denied operation: report the failure compactly — what you completed, the exact error, which tool/permission you lack, and your suggested next step — so the orchestrator can re-delegate or adjust.
@@ -240,26 +248,27 @@
             - grep
             - bash
             - skill
-            - write
-            - edit
+            - web_search
             - ask_user_question
             - todo_write
             - job_output
             - job_list
             - job_kill
 
-    # implement：实现（读上下文 → 外科手术式修改 → 验证）~3.7k
+    # implement：实现（读上下文 → 外科手术式修改 → 验证）~3.8k
     - id: delegation-implement
       name: '@deepseek-ai/dsh-tool-subagent'
       config:
         provider: spawn
         toolName: implement
+        backgroundMode: one-shot
         persona: |-
           You are the implementation agent. You write and edit code: read surrounding context first, make surgical changes, then verify (build/test/grep). Report what you changed and how you verified. You do not redesign architecture.
           On tool failure, do not retry a denied operation: report the failure compactly — what you completed, the exact error, which tool/permission you lack, and your suggested next step — so the orchestrator can re-delegate or adjust.
         toolFilter:
           allow:
             - read
+            - read_image
             - write
             - edit
             - glob
@@ -287,6 +296,7 @@
       config:
         provider: spawn
         toolName: search_internal_deep
+        backgroundMode: one-shot
         persona: |-
           You are the internal deep-search agent. Your job is repository exploration only — you never modify files and you never use the network. Handle exactly the tasks the orchestrator can't afford in its own context: whole-repo grep dumps, full-file reads beyond a page, cross-directory symbol/definition tracking. Search thoroughly, then return a CONCISE structured summary: what you searched, key files with line numbers, definitions/symbols found, and the takeaway the orchestrator needs to decide next. Never echo large dumps back — condense aggressively; the orchestrator re-delegates or reads specific ranges itself if it needs details.
           On tool failure, do not retry a denied operation: report the failure compactly — what you completed, the exact error, which tool/permission you lack, and your suggested next step — so the orchestrator can re-delegate or adjust.

package/presets/orchestrator/preset.yml

@@ -1,6 +1,7 @@
 name: 编排模式 (Orchestrator)
 description: 按角色分工的编排架构——主 agent 只做编排与内部搜索（glob/grep/read/codegraph），
-  通过 search_external / design / implement 三个委派工具把联网调研、设计、实现分别交给
-  各自只加载必要工具的子 agent；主 agent 不加载任何外部搜索、写文件或技能工具，
+  通过 search_external / design / implement / search_internal_deep 四个委派工具（search_internal_deep
+  为静态委派）把联网调研、设计、实现、内部深搜分别交给各自只加载必要工具的子 agent；
+  主 agent 不加载任何外部搜索、写文件或技能工具，
   每请求工具税从 ~16.2k tokens 降到 ~5.5k。主 agent 技能目录注入亦归零（实测 ≈1.3k tokens/轮）。
 order: 5

package/presets/orchestrator/restrict.mjs

@@ -10,7 +10,8 @@
  * would intersect with — and wrongly shrink — those role surfaces.
  *
  * What the main agent keeps:
- *   - orchestration: search_external / design / implement (role delegation),
+ *   - orchestration: 4 role-delegation tools — search_external / design /
+ *     implement / search_internal_deep (the last one a static delegation),
  *     send_message / list_agents / interrupt_agent (child management)
  *   - internal search (hot path, zero delegation round-trip): glob / grep /
  *     read / read_image / bash

package/tools/install.mjs

@@ -3,18 +3,23 @@
  * dsh-paoding installer — CLI 入口 + 公共 API 聚合薄层。
  *
  * 原单文件（2767 行）的功能实现已按模块拆分到 tools/lib/*.mjs（util / yaml /
- * config / host / skills / spans / compose / alloc / wizard / state / cli 模块
- * 树）；本文件仅保留：
+ * config / host / skills / spans / compose / alloc / state / cli / workspaces /
+ * version / upgrade 模块树）；本文件仅保留：
  *   - 公共导出面（与旧单文件完全一致，供 plugins/paoding-config-ui 消费）：
- *     DEFAULT_MAIN_AGENT_PERSONA_EXTRA / collectState / generateAndInstall；
+ *     DEFAULT_MAIN_AGENT_PERSONA_EXTRA / collectState / generateAndInstall
+ *     （外加工作区 slug / preset id 助手 assignSlugs / presetIdOf /
+ *     sanitizeSlugBase / stableHash）；
  *   - 直接运行守卫（CLI entry：import 本模块不触发安装，仅直接执行时经
- *     lib/cli.mjs 的 main() 运行）。
+ *     lib/cli.mjs 的 main() 运行；官方安装通道是 dsh plugin add dsh-paoding，
+ *     本 CLI 仅作仓库内开发兜底）。
  */
 import { pathToFileURL } from 'node:url'
 import { main } from './lib/cli.mjs'
 
 export { DEFAULT_MAIN_AGENT_PERSONA_EXTRA } from './lib/util.mjs'
 export { collectState, generateAndInstall } from './lib/state.mjs'
+// 工作区 slug / preset id（api-core 的 workspaceMeta 等插件侧消费）。
+export { assignSlugs, presetIdOf, sanitizeSlugBase, stableHash } from './lib/workspaces.mjs'
 
 // CLI entry: only run main() when invoked directly (importing this module for
 // the visual config UI must not trigger an install).

package/tools/lib/alloc.mjs

@@ -2,8 +2,10 @@
  * 分配策略：smartDefaults 按工具名关键词（keywords）给出默认角色分配、在无既有
  * 配置时作 --auto 的兜底 assignments；baseAssignments 给出「基础模板」（仅 dsh
  * 内置工具，fresh 非交互安装的默认起点）；resolveAssignments 把既有配置 / 建议 /
- * 静态基础合成最终 assignments。纯参数计算，仅依赖 util 的 ROLES 常量；
- * 被 state（smartDefaults）/ cli（resolveAssignments / baseAssignments）引用。
+ * 静态基础合成最终 assignments；autoAssignments 是 --auto 语义的一站式入口
+ * （CLI --auto 分支与插件首装 ensurePresetInstalled 共享，勿两边复制粘贴）。
+ * 纯参数计算，仅依赖 util 的 ROLES 常量；被 state（smartDefaults）/ cli /
+ * plugins/paoding-config-ui（autoAssignments）引用。
  */
 import { ROLES } from './util.mjs'
 
@@ -12,11 +14,15 @@ import { ROLES } from './util.mjs'
 
 /**
  * Default host-tool → role assignment used by --auto without a config file
- * and as the wizard's suggested values.  codegraph and memory_search stay on
+ * and as the suggested values shown in the visual config UI.  codegraph and
+ * memory_search stay on
  * the main agent (matching the static preset); other MCP tools are suggested
- * by tool-name keywords.  角色条目形状 { model, provider, persona, tools }：
+ * by tool-name keywords.  角色条目形状 { model, provider, background_mode, persona, tools }：
  * model / provider（角色专用模型）在此恒为 null（= 不注入 agentOptions，子 agent
- * 继承主 agent 当前模型），仅配置文件 / 向导 4d 显式设置。
+ * 继承主 agent 当前模型），仅配置文件 / 配置面板 4d 显式设置；background_mode
+ * （roles.<toolName>.background_mode，可续模式）在此恒为 'one-shot'（= 不注入
+ * backgroundMode 行，dsh-tool-subagent 缺省即 one-shot），仅配置文件 / 配置面板
+ * 显式设置为 'continuable'。
  */
 export function smartDefaults(mcpReports, inventory, staticBase) {
   const roles = {}
@@ -27,7 +33,9 @@ export function smartDefaults(mcpReports, inventory, staticBase) {
     const tools = [...inventory].filter((name) => name.startsWith(`mcp__${server}__`))
     byServer.set(server, tools)
     const assign = (role) => {
-      roles[role] ??= { model: null, provider: null, persona: null, tools: [...staticBase[role]] }
+      // 与 baseAssignments / resolveAssignments 同形状（name 恒 null = 不改名）：
+      // 缺 name 键会让下游形状断言/序列化层按缺省处理，和 baseAssignments 不一致。
+      roles[role] ??= { name: null, model: null, provider: null, background_mode: 'one-shot', persona: null, tools: [...staticBase[role]] }
       for (const t of tools) if (!roles[role].tools.includes(t)) roles[role].tools.push(t)
     }
     if (server === 'codegraph') {
@@ -44,7 +52,8 @@ export function smartDefaults(mcpReports, inventory, staticBase) {
   }
   if (inventory.has('memory_search')) extra.push('memory_search')
   // main_agent_persona_extra 不在此赋值（null 即可）：compose 时 null 回落默认常量。
-  // roles_remove / main_agent_name 不在此赋值（[] / null 即可）：删除与改名是显式配置。
+  // roles_remove / main_agent_display_name 不在此赋值（[] / null 即可）：删除是
+  // 显式配置（显示名同理，null = 默认「编排模式 (Orchestrator)」）。
   return {
     roles,
     roles_remove: [],
@@ -53,7 +62,7 @@ export function smartDefaults(mcpReports, inventory, staticBase) {
     main_agent_skills: [],
     main_agent_skills_inline: [],
     main_agent_persona_extra: null,
-    main_agent_name: null,
+    main_agent_display_name: null,
     skills: {},
   }
 }
@@ -64,19 +73,21 @@ export function keywords(names, pattern) {
 
 /**
  * 基础模板 assignments（fresh 非交互安装的默认起点）：每个内置角色保留静态
- * preset 的 dsh 基础工具，host/MCP 工具一概不纳入 —— npx 场景先装完可用基础
- * 版，host 工具留给用户在 设置 → 庖丁配置（或向导）里显式开启，避免智能默认
- * 把检测到的 host 工具静默塞进委派链。形状与 smartDefaults 返回值完全一致，
- * 生成层 / 序列化层无需区分来源；staticBase 复制而非别名，防调用方原地改写。
+ * preset 的 dsh 基础工具，host/MCP 工具一概不纳入 —— 首装（插件通道启动自愈
+ * 或 --auto）先装完可用基础版，host 工具留给用户在 设置 → 庖丁配置 里显式
+ * 开启，避免智能默认把检测到的 host 工具静默塞进委派链。形状与 smartDefaults
+ * 返回值完全一致，生成层 / 序列化层无需区分来源；staticBase 复制而非别名，
+ * 防调用方原地改写。每个内置角色条目显式带 background_mode: 'one-shot'，随
+ * serializeConfig 恒写出 —— fresh 落盘的配置文件里旋钮可见。
  */
 export function baseAssignments(staticBase) {
   const roles = {}
   for (const role of ROLES) {
     // static preset 的角色 allow 自带静态 host 工具名（如 mcp__tavily__*）；模板
     // 一律剔除 mcp__ 前缀名（KNOWN_HOST_PLUGINS 工具不在 staticBase 里，无需再滤），
-    // 保证落盘的配置文件只含 dsh 基础工具 —— host 工具全部经 UI/向导显式开启。
+    // 保证落盘的配置文件只含 dsh 基础工具 —— host 工具全部经 UI 显式开启。
     const baseTools = (staticBase[role] ?? []).filter((name) => !name.startsWith('mcp__'))
-    roles[role] = { name: null, model: null, provider: null, persona: null, tools: [...baseTools] }
+    roles[role] = { name: null, model: null, provider: null, background_mode: 'one-shot', persona: null, tools: [...baseTools] }
   }
   return {
     roles,
@@ -86,18 +97,20 @@ export function baseAssignments(staticBase) {
     main_agent_skills: [],
     main_agent_skills_inline: [],
     main_agent_persona_extra: null,
-    main_agent_name: null,
+    main_agent_display_name: null,
     skills: {},
   }
 }
 
 /**
  * Resolve the final assignments from the existing config, smart defaults, or
- * the interactive wizard.  Returns { roles, roles_remove, main_agent_extra,
+ * the visual config UI.  Returns { roles, roles_remove, main_agent_extra,
  * main_agent_remove, main_agent_skills, main_agent_skills_inline,
- * main_agent_persona_extra, main_agent_name, skills }；roles 条目形状
- * { name, model, provider, persona, tools }（model / provider = 角色专用模型，
- * 缺省 null = 不注入 agentOptions）。
+ * main_agent_persona_extra, main_agent_display_name, skills }；
+ * roles 条目形状
+ * { name, model, provider, background_mode, persona, tools }（model / provider =
+ * 角色专用模型，缺省 null = 不注入 agentOptions；background_mode = 角色可续模式，
+ * 缺省 'one-shot' = 不注入 backgroundMode 行）。
  */
 export function resolveAssignments(existing, suggested, staticBase) {
   if (existing) {
@@ -111,28 +124,46 @@ export function resolveAssignments(existing, suggested, staticBase) {
         name: role.name ?? null,
         model: role.model ?? null,
         provider: role.provider ?? null,
+        // 缺键（老配置 / UI 手工构造的半成品对象）回落 'one-shot'；非法值由
+        // 生成层按「非 'continuable' 即 one-shot」口径兜底。
+        background_mode: role.background_mode ?? 'one-shot',
         persona: role.persona ?? null,
-        tools: role.tools ?? (suggested.roles[toolName]?.tools ?? staticBase[toolName] ?? []),
+        // 回落的 suggested/staticBase 数组包一层复制，防与来源别名后一处
+        // 原地 push 污染另一处（如 smartDefaults 的 assign 复用 suggested）。
+        tools: role.tools ?? [...(suggested.roles[toolName]?.tools ?? staticBase[toolName] ?? [])],
       }
     }
     return {
       roles,
       roles_remove: existing.roles_remove ?? [],
-      // main_agent_extra 回填语义：配置文件里「显式写了键」（含显式空列表，见
-      // normalizeConfig.has_main_agent_extra）一律尊重 —— 显式 [] = 用户明确不
-      // 要任何 host 工具，不得被智能默认悄悄回填；只有键完全缺失（老配置，无
-      // 该标记）才按旧行为用 suggested.main_agent_extra 兜底。
-      main_agent_extra:
-        existing.has_main_agent_extra || existing.main_agent_extra.length > 0
-          ? existing.main_agent_extra
-          : suggested.main_agent_extra,
+      // main_agent_extra 回填语义：配置文件里「显式写了键」（has_main_agent_extra
+      // 标记，含显式空列表）一律尊重 —— 显式 [] = 用户明确不要任何 host 工具，
+      // 不得被智能默认悄悄回填；键缺失（老配置 / UI 手工构造的半成品对象）才用
+      // suggested.main_agent_extra 兜底。直接按 has 标记判定：原 `has || extra.length > 0`
+      // 的后半支在 has=true 时恒为假（短路先命中），且对手造输入（缺
+      // main_agent_extra 键）会抛 TypeError，一并去掉。
+      main_agent_extra: existing.has_main_agent_extra
+        ? existing.main_agent_extra ?? []
+        : suggested.main_agent_extra,
       main_agent_remove: existing.main_agent_remove ?? [],
       main_agent_skills: existing.main_agent_skills ?? [],
       main_agent_skills_inline: existing.main_agent_skills_inline ?? [],
       main_agent_persona_extra: existing.main_agent_persona_extra ?? null,
-      main_agent_name: existing.main_agent_name ?? null,
+      main_agent_display_name: existing.main_agent_display_name ?? null,
       skills: existing.skills,
     }
   }
   return suggested
 }
+
+/**
+ * --auto 语义的 assignments 一站式构造（CLI main 的 --auto 分支与插件首装
+ * ensurePresetInstalled 共用，抽在此处防两边逻辑漂移）：既有配置按配置合成
+ * （不变）；fresh（无配置）缺省基础模板（仅 dsh 基础工具，host/MCP 工具留给
+ * Web 配置器显式开启），suggest=true 时改用智能默认自动纳入检测到的 host 工具。
+ * 返回值形状与 resolveAssignments 一致，可直接传 generateAndInstall。
+ */
+export function autoAssignments({ existing = null, suggested, staticBase, suggest = false } = {}) {
+  if (existing) return resolveAssignments(existing, suggested, staticBase)
+  return suggest ? suggested : baseAssignments(staticBase)
+}