@gehennawu/dsh-service 0.26.0 → 0.27.0

package/README.en.md

@@ -8,9 +8,9 @@ A service-control and operations plugin for self-hosted DSH Web. Provides safe r
 
 ## Features
 
-The Settings panel "Service Control" page has eight top-level tabs: **Overview, Notifications, Health, Model stats, Quota lookup, Backups, Skills, Restart**; the Restart, Quota lookup, and Skills tabs can each enable a quick entry at the bottom of the settings left navigation (off by default).
+The Settings panel "Service Control" page has nine top-level tabs: **Overview, Notifications, Health, Model stats, Quota lookup, Backups, Skills, Subagents, Restart**; the Restart, Quota lookup, Skills, and Subagents tabs can each enable a quick entry at the bottom of the settings left navigation (off by default).
 
-The plugin also appears under **Plugins → Plugin configuration**, with six host-level switches enabled by default: **Model statistics, Quota lookup, Backup maintenance, Task notifications, Skill manager, and the `/healthz` liveness endpoint**. Disabling one hides its UI, stops the associated polling/subscriptions, and makes the Host reject that capability; Overview, Health diagnostics, and Restart remain available. All six switches are live settings: disabling or re-enabling them requires neither a page reload nor a DSH Web restart. Statistics refreshes, quota requests, or backup operations already in flight are allowed to finish; quota re-enablement preserves existing cache, TTL, and backoff state, so its UI and calls return immediately but a new upstream request is not guaranteed at once.
+The plugin also appears under **Plugins → Plugin configuration**, with seven host-level switches enabled by default: **Model statistics, Quota lookup, Backup maintenance, Task notifications, Skill manager, Subagent model, and the `/healthz` liveness endpoint**. Disabling one hides its UI, stops the associated polling/subscriptions, and makes the Host reject that capability; Overview, Health diagnostics, and Restart remain available. All seven switches are live settings: disabling or re-enabling them requires neither a page reload nor a DSH Web restart. Statistics refreshes, quota requests, or backup operations already in flight are allowed to finish; quota re-enablement preserves existing cache, TTL, and backoff state, so its UI and calls return immediately but a new upstream request is not guaranteed at once.
 
 ### Version and updates
 
@@ -36,6 +36,8 @@ The plugin also appears under **Plugins → Plugin configuration**, with six hos
 
 ### Model statistics
 
+![Model statistics](./screenshots/model-usage_en.png)
+
 - 7-day stacked bar chart of input/output/cache tokens with blue/orange/teal legend
 - Filter by project; hover for exact values
 - Model breakdown as horizontal stacked bars (same legend colors) with a "Today / Last 7 days / All time" toggle on the right of the list header (default: last 7 days): Today aggregates only the current day, Last 7 days ranks within the chart's window, and All time covers every date in the index (bounded by session retention); each row keeps `x times · Cache hit x% · Input xM token · Output xM token`
@@ -44,6 +46,8 @@ The plugin also appears under **Plugins → Plugin configuration**, with six hos
 
 ### Quota lookup
 
+![Quota lookup](./screenshots/quota-lookup_en.png)
+
 - A dedicated "Quota lookup" tab shows adapted providers as separate cards, each window rendered as a percentage with its own bar and a reset countdown on its own line, plus a refresh icon beside the updated time that force-refreshes that provider on click (bypassing the poll interval); adapted card titles link to the provider's official usage page (DeepSeek Platform, Zhipu GLM Coding Plan, OpenCode Go) in a new tab; a "Reorder" toggle at the top-right of the card list (shown with two or more cards) reveals ↑/↓ buttons on each card header (auto-disabled at the ends), and clicking it again hides them; the order is remembered in this browser and newly seen providers append at the end; unadapted providers take no space — a "Manual adapt" row at the bottom enables one by picking its type, and each card's footer can switch type, fall back to auto-detect, or disable lookup at any time
 - A quota ring inside the conversation composer follows the provider selected by the current session and shows the tightest budget window as a percentage (green below 80%, amber at or above); clicking opens a panel headed by the provider name, with a bar and used percentage for each window and reset times on their own lines; on narrow viewports (phones) the panel switches to a viewport-centered floating layer — fully visible, scrolling internally when too tall — and rotates or resizing wider flips it back to the anchored placement above the ring
 - A "Show a remote quota entry in the settings left navigation" switch lives in the Quota lookup tab (off by default), mirroring the Restart entry
@@ -64,6 +68,8 @@ The plugin also appears under **Plugins → Plugin configuration**, with six hos
 
 ### Skills management
 
+![Skills management](./screenshots/skill-manager_en.png)
+
 - The "Skills" tab lists every local skill under three sections — **auto-loaded / manual-only / fully disabled** — scanning project `.dsh`, project `.agents`, user `~/.dsh/skills`, `$DSH_AGENTS_HOME`, and `$DSH_BUNDLED_SKILL_DIR` roots one level deep, with a name filter and source badges; same-name shadowing (lower rank wins) marks both winner and loser copies, bundled directories are shown read-only, and a physical directory hit by multiple root rules is counted once
 - Two per-entry switches edit the SKILL.md frontmatter directly: `disable-model-invocation` for "visible to model", `user-invocable` for "invocable via /"; switches use a two-click confirmation, changes go live within ~200 ms, active sessions receive a catalog-update notice on their next step, and toggling back and forth leaves no residue in the file
 - Entries carrying legacy camelCase invocation keys (e.g. `disableModelInvocation`) are dropped entirely by the official parser: the panel shows a ⚠ warning and a two-click confirmed fix that converts them to canonical keys semantically
@@ -71,8 +77,18 @@ The plugin also appears under **Plugins → Plugin configuration**, with six hos
 - One-click batch fill: automatically collects unannotated skills or ones whose body changed (read-only roots included; invalid entries and shadowed copies are skipped), shows candidate count / estimated payload and an expandable per-entry skip list first, then runs sequentially with live progress; individual failures never block the batch, and cancelling immediately interrupts the in-flight model call. Zero file modifications throughout, and the plugin never issues model calls autonomously
 - Batch runs in the Host background: switching tabs, closing the settings panel, or even refreshing the page never interrupts it; returning to the Skills tab restores progress and the cancel button, the Skills tab title shows a live `⟳done/total` badge while running, and planning a second batch mid-run is explicitly rejected
 
+### Subagent model
+
+![Subagent model](./screenshots/subagent-model_en.png)
+
+- The "Subagents" tab controls routing for delegations that **did not explicitly specify a model**, with three modes: **Default (no override)** injects nothing and preserves DSH's native inheritance; **Follow main model** reads the provider/model actually used by the main conversation's latest request at delegation time; **Custom** pins every unspecified subagent to the selected provider and model
+- A provider or model explicitly carried by the delegation always wins, so the plugin never overrides a pinned preset, call arguments, or a route already injected by another plugin. Custom choices come exclusively from the Host's live model catalog; if that provider is later removed, delegation safely falls back to native inheritance instead of failing
+- Configuration is stored in `$DSH_HOME/dsh-service-subagent-route.json` (atomic writes, file mode `0600`); "Reset to default" clears the custom route and restores zero intervention. An optional "Subagents" quick entry can be enabled for the settings left navigation (off by default)
+
 ### Task notifications
 
+![Task notifications](./screenshots/task-notifications_en.png)
+
 - Notification settings live in the top-level Notifications tab: browser notification when a session finishes its turn, or when your approval, plan review, or answer is needed
 - Clicking a notification focuses the DSH page and closes the popup
 - Three toggle switches: master switch, task completion, and approvals & questions, each controlled independently

package/README.md

@@ -8,9 +8,9 @@
 
 ## 功能
 
-设置页「服务控制」面板包含八个顶部标签：**概览、通知、健康诊断、模型统计、额度查询、备份维护、技能、重启**；重启、额度查询与技能标签还可在设置页左侧标签列底部开启快捷入口（默认关闭）。
+设置页「服务控制」面板包含九个顶部标签：**概览、通知、健康诊断、模型统计、额度查询、备份维护、技能、子代理、重启**；重启、额度查询、技能与子代理标签还可在设置页左侧标签列底部开启快捷入口（默认关闭）。
 
-插件同时出现在「插件 → 插件配置」，提供六个默认开启的宿主级开关：**模型统计、额度查询、备份维护、任务通知、技能管理、`/healthz` 探活端点**。关闭后不仅隐藏对应界面，也会停止相关轮询/订阅并由宿主拒绝对应能力；概览、健康诊断与重启固定保留。设置写入 DSH settings，六项均为热生效：关闭或重新开启都无需刷新页面或重启 DSH Web。已在途的统计刷新、额度请求或备份操作允许完成；额度重新开启时保留既有缓存、TTL 与退避状态，因此可立即恢复界面和调用，但不保证立刻重新请求上游。
+插件同时出现在「插件 → 插件配置」，提供七个默认开启的宿主级开关：**模型统计、额度查询、备份维护、任务通知、技能管理、子代理模型、`/healthz` 探活端点**。关闭后不仅隐藏对应界面，也会停止相关轮询/订阅并由宿主拒绝对应能力；概览、健康诊断与重启固定保留。设置写入 DSH settings，七项均为热生效：关闭或重新开启都无需刷新页面或重启 DSH Web。已在途的统计刷新、额度请求或备份操作允许完成；额度重新开启时保留既有缓存、TTL 与退避状态，因此可立即恢复界面和调用，但不保证立刻重新请求上游。
 
 ### 版本与更新
 
@@ -36,6 +36,8 @@
 
 ### 模型统计
 
+![模型统计](./screenshots/model-usage.png)
+
 - 近 7 天输入/输出/缓存 token 堆叠柱图，蓝/橙/青图例
 - 按项目筛选，鼠标悬停显示精确数值
 - 模型明细为横向堆叠柱形图（沿用主图图例配色），列表头部右侧提供「今日 / 近 7 天 / 累计」切换标签（默认近 7 天）：今日只聚合当天，近 7 天按主图同窗口排序，累计覆盖索引内全部日期（受会话持久化留存范围限制）；每行附「x次 · 缓存命中 x% · 输入 xM token · 输出 xM token」明细
@@ -44,6 +46,8 @@
 
 ### 额度查询
 
+![额度查询](./screenshots/quota-lookup.png)
+
 - 独立的「额度查询」标签：以卡片分区展示已适配的供应商，每个窗口显示百分比、独立进度条，重置时间单独一行；卡片头部更新时间旁有刷新图标，点击即强制重拉该供应商（不受轮询间隔限制）；已适配卡片的标题链接到对应官网用量页（DeepSeek 平台、智谱 GLM Coding Plan、OpenCode Go），点击新标签页打开；卡片列表右上角有「调整排序」开关（至少两张卡时显示），点击后各卡头部出现 ↑/↓ 按钮（首末卡对应方向自动禁用），再点一次收起；顺序记忆在本浏览器，新出现的供应商排在末尾；未适配的不占位置，统一收进底部「手动适配」行选择类型启用，卡片脚部可随时切换适配类型、回退自动识别或停用查询
 - 对话输入框内一枚额度圆环，跟随当前会话所选模型的供应商，显示最紧预算窗口的已用百分比（<80% 绿色、≥80% 黄色）；点击弹出面板——头部标明供应商，各窗口带独立进度条与已用百分比、重置时间单独一行；手机等窄屏上面板自动切换为视口居中的浮层（完整可见、超高时内部滚动），旋转或拖宽窗口即时切回圆环上方锚定
 - 可在「额度查询」标签开启「设置页左列显示入口」开关（默认关闭），开启后在设置页左侧标签列底部显示「额度查询」快捷入口（与「重启」入口同模式）
@@ -64,6 +68,8 @@
 
 ### 技能管理
 
+![技能管理](./screenshots/skill-manager.png)
+
 - 「技能」标签按**自动加载 / 仅手动调用 / 完全停用**三区展示全部本地技能（项目 `.dsh`、项目 `.agents`、用户 `~/.dsh/skills`、`$DSH_AGENTS_HOME` 与 `$DSH_BUNDLED_SKILL_DIR` 根，一层深度），支持名称过滤与来源徽标；同名遮蔽（低 rank 优先）与被遮蔽副本均有标注，内置目录只读展示；同一物理目录被多条规则命中时只计一次
 - 每条目双开关直接改写 SKILL.md frontmatter：`disable-model-invocation` 控制「对模型可见」，`user-invocable` 控制「可被 / 调用」；开关采用两段式点击确认，改动约 200ms 内热生效，活跃会话下一步自动收到目录更新提示；往返切换不会在文件中累积残留
 - 带 camelCase 旧版调用键（如 `disableModelInvocation`）的条目会被官方解析器整条剔除：面板给出 ⚠ 提示，两段式确认后按语义换算修复为规范键
@@ -71,8 +77,18 @@
 - 一键批量补全：自动圈出未注释或正文有变的技能（含只读目录，跳过无效与被遮蔽副本），先展示候选数/预计发送量与可展开的逐条跳过清单，确认后顺序执行并显示进度，单条失败不影响批次，可随时取消（取消会立即中断在途模型调用）；全程零文件改动，也绝不自动发起任何模型调用
 - 批量任务在宿主后台持续运行：切换标签、关闭设置面板甚至刷新页面都不会中断；回到技能页自动恢复进度与取消按钮，批量进行中「技能」标签标题实时显示 `⟳已完成/总数` 角标，运行中重复生成计划会被明确拒绝
 
+### 子代理模型
+
+![子代理模型](./screenshots/subagent-model.png)
+
+- 「子代理」标签控制**未显式指定模型**的子代理委派路由，支持三种模式：**初始（不干预）**不注入任何配置并完整保留 DSH 原生继承；**跟随主模型**在每次派生时读取主对话最近一次请求实际使用的 provider/model；**自定义**把所有未指定路由的子代理固定到所选供应商与模型
+- 派生请求自身显式指定 provider 或 model 时始终优先，插件不会覆盖预设钉死、调用参数或其他插件已经注入的路由。自定义模型只能从宿主实时模型清单中选择；已配置供应商后来被卸载时安全回落原生继承，不会让子代理创建失败
+- 配置保存在 `$DSH_HOME/dsh-service-subagent-route.json`（原子写入、文件权限 `0600`）；「重置回初始配置」会清除自定义路由并恢复零干预。可在该标签开启设置页左列「子代理」快捷入口（默认关闭）
+
 ### 任务通知
 
+![任务通知](./screenshots/task-notifications.png)
+
 - 通知设置位于服务控制顶部的「通知」标签：会话完成一轮任务、或需要你授权/审阅计划/选择答案时发送浏览器通知
 - 点击系统通知弹窗会聚焦到 DSH 页面并关闭该通知
 - 三档开关条：总开关、任务结束通知、授权与提问通知，各自独立控制

package/client.js

@@ -23,6 +23,33 @@ window.__ModuleLoader__.load({
       'features.skillManager': '技能管理',
       'features.readOnly': '当前设置不可写。',
       'tabs.skills': '技能',
+      'tabs.subagent': '子代理',
+      'features.subagentRoute': '子代理模型',
+      'subagent.title': '子代理模型',
+      'subagent.hint': '控制「未显式指定模型」的子代理委派使用哪个模型；显式指定了模型的派生（预设钉死、其他插件注入、调用参数携带）不受影响。',
+      'subagent.mode.label': '模式',
+      'subagent.mode.inherit': '初始（不干预）',
+      'subagent.mode.inherit.desc': '不注入任何路由，保持宿主原生继承行为：子代理使用会话创建时烘焙的默认模型。',
+      'subagent.mode.follow': '跟随主模型',
+      'subagent.mode.follow.desc': '每次派生时读取主对话当前实际使用的模型（最近一次请求的渠道）并注入。',
+      'subagent.mode.custom': '自定义',
+      'subagent.mode.custom.desc': '所有未显式指定模型的子代理固定使用下方选择的模型。',
+      'subagent.provider': '供应商',
+      'subagent.model': '模型',
+      'subagent.modelsEmpty': '模型清单为空：无法解析宿主 LLM 渠道。',
+      'subagent.save': '保存',
+      'subagent.saved': '已保存',
+      'subagent.reset': '重置回初始配置',
+      'subagent.saving': '保存中…',
+      'subagent.unavailable': '宿主未提供子代理注册表（subagents 服务缺席），配置不会生效。',
+      'subagent.navToggle': '设置页左列显示「子代理」入口',
+      'subagent.navToggleHint': '默认关闭；开启后在设置页左侧标签列底部显示子代理模型快捷入口',
+      'subagent.error': '操作失败：{error}',
+      'subagent.error.feature-disabled': '子代理模型功能已在设置中关闭',
+      'subagent.error.llm-unavailable': '宿主 LLM 服务不可用',
+      'subagent.error.unknown-mode': '未知模式',
+      'subagent.error.invalid-model-route': '供应商或模型不在宿主清单内',
+      'subagent.error.network': '网络错误：无法连接宿主',
       'skills.error': '操作失败：{error}',
       'skills.error.feature-disabled': '技能管理功能已在设置中关闭',
       'skills.error.network': '网络错误，请稍后重试',
@@ -479,6 +506,33 @@ window.__ModuleLoader__.load({
       'features.skillManager': 'Skill manager',
       'features.readOnly': 'These settings are read-only.',
       'tabs.skills': 'Skills',
+      'tabs.subagent': 'Subagents',
+      'features.subagentRoute': 'Subagent model',
+      'subagent.title': 'Subagent model',
+      'subagent.hint': 'Controls which model a subagent delegation uses when no model was explicitly specified; delegations with an explicit route (pinned preset, another plugin, call arguments) are unaffected.',
+      'subagent.mode.label': 'Mode',
+      'subagent.mode.inherit': 'Default (no override)',
+      'subagent.mode.inherit.desc': 'Injects nothing and keeps the native inheritance: subagents use the model baked in when the session was created.',
+      'subagent.mode.follow': 'Follow main model',
+      'subagent.mode.follow.desc': 'Each delegation reads the model the main conversation actually uses right now (route of its latest request) and injects it.',
+      'subagent.mode.custom': 'Custom',
+      'subagent.mode.custom.desc': 'Every delegation without an explicit model uses the model selected below.',
+      'subagent.provider': 'Provider',
+      'subagent.model': 'Model',
+      'subagent.modelsEmpty': 'Model list is empty: host LLM channels cannot be resolved.',
+      'subagent.save': 'Save',
+      'subagent.saved': 'Saved',
+      'subagent.reset': 'Reset to default',
+      'subagent.saving': 'Saving…',
+      'subagent.unavailable': 'The host exposes no subagents registry (service missing); this configuration has no effect.',
+      'subagent.navToggle': 'Show "Subagents" entry in settings left nav',
+      'subagent.navToggleHint': 'Off by default; when enabled, a subagent-model entry appears at the bottom of the settings left navigation',
+      'subagent.error': 'Operation failed: {error}',
+      'subagent.error.feature-disabled': 'Subagent model is switched off in settings',
+      'subagent.error.llm-unavailable': 'Host LLM service is unavailable',
+      'subagent.error.unknown-mode': 'Unknown mode',
+      'subagent.error.invalid-model-route': 'Provider or model is not in the host catalog',
+      'subagent.error.network': 'Network error: cannot reach the host',
       'skills.error': 'Operation failed: {error}',
       'skills.error.feature-disabled': 'Skill manager is switched off in settings',
       'skills.error.network': 'Network error, try again later',
@@ -936,6 +990,8 @@ window.__ModuleLoader__.load({
     const NAV_ICON_BODY_RESTART = '%3Cpath d=%27M12 2v10%27/%3E%3Cpath d=%27M18.4 6.6a9 9 0 1 1-12.77.04%27/%3E'
     // 技能 = 书本轮廓（lucide book 风格，16px 下可读）
     const NAV_ICON_BODY_SKILLS = '%3Cpath d=%27M4 19.5A2.5 2.5 0 0 1 6.5 17H20%27/%3E%3Cpath d=%27M6.5 2H20v20H6.5A2.5 2.5 0 0 1 4 19.5v-15A2.5 2.5 0 0 1 6.5 2z%27/%3E'
+    // 子代理 = 机器人头（lucide bot 风格，16px 下可读）
+    const NAV_ICON_BODY_SUBAGENT = '%3Cpath d=%27M12 8V4H8%27/%3E%3Crect width=%2716%27 height=%2712%27 x=%274%27 y=%278%27 rx=%272%27/%3E%3Cpath d=%27M2 14h2%27/%3E%3Cpath d=%27M20 14h2%27/%3E%3Cpath d=%27M15 13v2%27/%3E%3Cpath d=%27M9 13v2%27/%3E'
 
     function markSettingsNavRows(rows) {
       if (typeof document === 'undefined' || !document.body) return () => {}
@@ -994,11 +1050,12 @@ window.__ModuleLoader__.load({
           // 设置页导航行图标：外壳按 id 硬编码（第三方一律兜底齿轮）且协议无 icon 字段，
           // 由 markSettingsNavRows 打的 data 标记接住——藏齿轮 SVG、mask SVG 画各自图标，
           // currentColor 跟随主题文字色（hover/active 高亮自动继承）。
-          '[data-dsh-service-nav]>svg:first-child,[data-dsh-service-quota-nav]>svg:first-child,[data-dsh-service-restart-nav]>svg:first-child,[data-dsh-service-skills-nav]>svg:first-child{display:none}',
-          '[data-dsh-service-nav]::before,[data-dsh-service-quota-nav]::before,[data-dsh-service-restart-nav]::before,[data-dsh-service-skills-nav]::before{content:\'\';flex:none;width:16px;height:16px;background:currentColor}',
+          '[data-dsh-service-nav]>svg:first-child,[data-dsh-service-quota-nav]>svg:first-child,[data-dsh-service-restart-nav]>svg:first-child,[data-dsh-service-skills-nav]>svg:first-child,[data-dsh-service-subagent-nav]>svg:first-child{display:none}',
+          '[data-dsh-service-nav]::before,[data-dsh-service-quota-nav]::before,[data-dsh-service-restart-nav]::before,[data-dsh-service-skills-nav]::before,[data-dsh-service-subagent-nav]::before{content:\'\';flex:none;width:16px;height:16px;background:currentColor}',
           '[data-dsh-service-nav]::before{' + navIconMask(NAV_ICON_BODY_SERVICE) + '}',
           '[data-dsh-service-quota-nav]::before{' + navIconMask(NAV_ICON_BODY_QUOTA) + '}',
           '[data-dsh-service-skills-nav]::before{' + navIconMask(NAV_ICON_BODY_SKILLS) + '}',
+          '[data-dsh-service-subagent-nav]::before{' + navIconMask(NAV_ICON_BODY_SUBAGENT) + '}',
           '[data-dsh-service-restart-nav]::before{' + navIconMask(NAV_ICON_BODY_RESTART) + '}',
         ].join('')
         document.head.appendChild(svcStyle)
@@ -1006,7 +1063,7 @@ window.__ModuleLoader__.load({
       ctx.effect(() => () => { if (svcStyle) svcStyle.remove() }, 'dsh-service theme styles')
       ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'dsh-service dictionaries')
       const t = ctx.locale.bind(NS)
-      const DEFAULT_FEATURES = { modelUsage: true, quotaLookup: true, backupMaintenance: true, taskNotifications: true, healthz: true, skillManager: true }
+      const DEFAULT_FEATURES = { modelUsage: true, quotaLookup: true, backupMaintenance: true, taskNotifications: true, healthz: true, skillManager: true, subagentRoute: true }
       const featureScope = ctx.settingsScope.bind({ namespace: NS })
       const featureSnapshot = () => featureScope.getSnapshot()
       const featureValue = () => Object.assign({}, DEFAULT_FEATURES, featureSnapshot().value || {})
@@ -1023,6 +1080,7 @@ window.__ModuleLoader__.load({
           { attr: 'data-dsh-service-quota-nav', label: () => t('tabs.quota') },
           { attr: 'data-dsh-service-restart-nav', label: () => t('nav.restart') },
           { attr: 'data-dsh-service-skills-nav', label: () => t('tabs.skills') },
+          { attr: 'data-dsh-service-subagent-nav', label: () => t('tabs.subagent') },
         ]),
         'dsh-service settings nav icons',
       )
@@ -1096,6 +1154,7 @@ window.__ModuleLoader__.load({
       const restartNavToggle = createNavEntryToggle({ storageKey: 'dsh-service-restart-nav', sectionId: 'dsh-service-restart', order: 499, labelKey: 'nav.restart', renderContent: () => React.createElement(RestartSection, null) })
       const quotaNavToggle = createNavEntryToggle({ storageKey: 'dsh-service-quota-nav', sectionId: 'dsh-service-quota', order: 498, labelKey: 'tabs.quota', feature: 'quotaLookup', renderContent: () => React.createElement(QuotaSection, null) })
       const skillsNavToggle = createNavEntryToggle({ storageKey: 'dsh-service-skills-nav', sectionId: 'dsh-service-skills', order: 497, labelKey: 'tabs.skills', feature: 'skillManager', renderContent: () => React.createElement(SkillsSection, null) })
+      const subagentNavToggle = createNavEntryToggle({ storageKey: 'dsh-service-subagent-nav', sectionId: 'dsh-service-subagent', order: 496, labelKey: 'tabs.subagent', feature: 'subagentRoute', renderContent: () => React.createElement(SubagentSection, null) })
       // ── 批量补全共享状态：跨标签/设置面板开关存活（宿主任务本身不随 UI 停止）──
       let skillsBatchState = null       // 宿主状态快照
       let skillsBatchPlan = null        // 本端计划（含所选模型）
@@ -2374,12 +2433,153 @@ window.__ModuleLoader__.load({
         }, React.createElement('path', { d: 'M3 5.25 7 9l4-3.75', fill: 'none', stroke: 'currentColor', strokeWidth: 1.4, strokeLinecap: 'round', strokeLinejoin: 'round' }))),
         open ? React.createElement('div', { style: { margin: '0 16px', padding: '12px 0 8px', borderTop: '1px solid var(--dsw-alias-border-l2)' } },
           React.createElement('div', { style: { fontSize: '12px', fontWeight: 700 } }, translate('features.optional')),
-          ['modelUsage', 'quotaLookup', 'backupMaintenance', 'taskNotifications', 'skillManager'].map(row),
+          ['modelUsage', 'quotaLookup', 'backupMaintenance', 'taskNotifications', 'skillManager', 'subagentRoute'].map(row),
           React.createElement('div', { style: { fontSize: '12px', fontWeight: 700, marginTop: '8px', paddingTop: '10px', borderTop: '1px solid var(--dsw-alias-border-l1)' } }, translate('features.external')),
           row('healthz'),
           !writable ? React.createElement('p', { style: { margin: '6px 0 0', fontSize: '11px', color: 'var(--dsw-alias-label-tertiary)' } }, translate('features.readOnly')) : null) : null)
       }
 
+      // ─── 子代理模型（v0.27）：三态路由配置 ────────────────────────────────
+      function mapSubagentError(translate, code) {
+        if (code === 'feature-disabled') return translate('subagent.error.feature-disabled')
+        if (code === 'llm-unavailable') return translate('subagent.error.llm-unavailable')
+        if (code === 'unknown-mode') return translate('subagent.error.unknown-mode')
+        if (code === 'invalid-model-route') return translate('subagent.error.invalid-model-route')
+        if (code === 'network') return translate('subagent.error.network')
+        return code
+      }
+
+      const SUBAGENT_MODES = ['inherit', 'follow', 'custom']
+      function SubagentSection() {
+        const translate = useTranslation()
+        const { useState, useEffect } = React
+        const [navEnabled, setNavEnabled] = subagentNavToggle.useEnabled()
+        const [snapshot, setSnapshot] = useState(null)
+        const [mode, setMode] = useState('inherit')
+        const [provider, setProvider] = useState('')
+        const [model, setModel] = useState('')
+        const [loading, setLoading] = useState(true)
+        const [saving, setSaving] = useState(false)
+        const [savedTick, setSavedTick] = useState(0)
+        const [error, setError] = useState('')
+        const hintStyle = { color: 'var(--dsw-alias-label-secondary)', fontSize: '12px', marginTop: '8px', lineHeight: 1.5 }
+        const selectStyle = { fontSize: '12px', padding: '4px 8px', borderRadius: '6px', border: '1px solid var(--dsw-alias-border-l2)', background: 'var(--dsw-alias-bg-layer-2)', color: 'var(--dsw-alias-label-primary)', maxWidth: '100%' }
+
+        const load = async () => {
+          setLoading(true)
+          try {
+            const res = await ctx.connection.rpc.call('/dsh-service', 'subagent-route', {})
+            if (res.ok) {
+              setSnapshot(res.value)
+              setMode(res.value.mode)
+              if (res.value.mode === 'custom') {
+                setProvider(typeof res.value.provider === 'string' ? res.value.provider : '')
+                setModel(typeof res.value.model === 'string' ? res.value.model : '')
+              }
+              setError('')
+            } else {
+              setError(res.error || 'unknown')
+            }
+          } catch (_) {
+            setError('network')
+          } finally {
+            setLoading(false)
+          }
+        }
+        useEffect(() => { void load() }, [])
+
+        const models = snapshot !== null && Array.isArray(snapshot.models) ? snapshot.models : []
+        // 供应商分组：清单顺序去重；模型下拉随供应商切换。
+        const providers = []
+        const providerName = {}
+        for (const item of models) {
+          if (providerName[item.provider] === undefined) {
+            providerName[item.provider] = item.providerName
+            providers.push(item.provider)
+          }
+        }
+        const providerModels = models.filter((item) => item.provider === provider)
+        // 换供应商时若当前模型不属于它，回落到该供应商首个模型。
+        useEffect(() => {
+          if (provider !== '' && !providerModels.some((item) => item.id === model)) {
+            setModel(providerModels[0]?.id ?? '')
+          }
+        }, [provider])
+        const effectiveProvider = providers.includes(provider) ? provider : providers[0] ?? ''
+        useEffect(() => { if (provider !== effectiveProvider) setProvider(effectiveProvider) }, [effectiveProvider, provider])
+
+        const save = async (nextMode) => {
+          setSaving(true)
+          setError('')
+          try {
+            const payload = nextMode === 'custom'
+              ? { mode: 'custom', provider: effectiveProvider, model }
+              : { mode: nextMode }
+            const res = await ctx.connection.rpc.call('/dsh-service', 'subagent-route-save', payload)
+            if (res.ok) {
+              setSavedTick((tick) => tick + 1)
+              await load()
+            } else {
+              setError(res.error || 'unknown')
+            }
+          } catch (_) {
+            setError('network')
+          } finally {
+            setSaving(false)
+          }
+        }
+
+        const cardStyle = { padding: '4px 0 14px', marginBottom: '12px', color: 'var(--dsw-alias-label-primary)' }
+        const modeButton = (candidate) => React.createElement('button', {
+          type: 'button',
+          key: candidate,
+          'data-testid': 'subagent-mode-' + candidate,
+          'aria-pressed': String(mode === candidate),
+          disabled: loading,
+          onClick: () => setMode(candidate),
+          style: {
+            fontSize: '12.5px', padding: '5px 12px', borderRadius: '7px', cursor: loading ? 'default' : 'pointer',
+            border: mode === candidate ? '1px solid var(--dsw-alias-state-brand-primary)' : '1px solid var(--dsw-alias-border-l2)',
+            background: mode === candidate ? 'var(--dsh-svc-surface-bg)' : 'var(--dsw-alias-bg-layer-3)',
+            color: 'var(--dsw-alias-label-primary)',
+            opacity: loading ? 0.55 : 1,
+          },
+        }, translate('subagent.mode.' + candidate))
+
+        return React.createElement('div', { 'data-testid': 'subagent-section', style: cardStyle },
+          React.createElement('div', { style: { fontSize: '14px', fontWeight: 700 } }, translate('subagent.title')),
+          React.createElement('p', { style: hintStyle }, translate('subagent.hint')),
+          snapshot !== null && snapshot.available === false ? React.createElement('p', { 'data-testid': 'subagent-unavailable', style: { ...hintStyle, color: 'var(--dsw-alias-state-warn-primary)' } }, translate('subagent.unavailable')) : null,
+          React.createElement('div', { 'data-testid': 'subagent-modes', style: { display: 'flex', gap: '8px', marginTop: '12px', flexWrap: 'wrap' } },
+            SUBAGENT_MODES.map(modeButton)),
+          React.createElement('p', { 'data-testid': 'subagent-mode-desc', style: { ...hintStyle, marginTop: '8px' } }, translate('subagent.mode.' + mode + '.desc')),
+          mode === 'custom' ? React.createElement('div', { 'data-testid': 'subagent-custom', style: { marginTop: '10px', display: 'flex', alignItems: 'center', gap: '10px', flexWrap: 'wrap' } },
+            React.createElement('span', { style: { fontSize: '12px', color: 'var(--dsw-alias-label-secondary)' } }, translate('subagent.provider')),
+            React.createElement('select', { 'data-testid': 'subagent-provider', value: effectiveProvider, disabled: providers.length === 0 || saving, onChange: (event) => setProvider(event.target.value), style: selectStyle },
+              providers.map((id) => React.createElement('option', { key: id, value: id }, providerName[id] ?? id))),
+            React.createElement('span', { style: { fontSize: '12px', color: 'var(--dsw-alias-label-secondary)' } }, translate('subagent.model')),
+            React.createElement('select', { 'data-testid': 'subagent-model', value: model, disabled: providerModels.length === 0 || saving, onChange: (event) => setModel(event.target.value), style: selectStyle },
+              providerModels.map((item) => React.createElement('option', { key: item.id, value: item.id }, item.name ?? item.id)))) : null,
+          mode === 'custom' && models.length === 0 && !loading ? React.createElement('p', { 'data-testid': 'subagent-models-empty', style: { ...hintStyle, color: 'var(--dsw-alias-state-warn-primary)' } }, translate('subagent.modelsEmpty')) : null,
+          error !== '' ? React.createElement('p', { 'data-testid': 'subagent-error', style: { ...hintStyle, color: 'var(--dsw-alias-state-error-primary)' } }, mapSubagentError(translate, error)) : null,
+          savedTick > 0 && error === '' ? React.createElement('p', { 'data-testid': 'subagent-saved', style: { ...hintStyle, color: 'var(--dsw-alias-state-success-primary)' } }, '✓ ' + translate('subagent.saved')) : null,
+          React.createElement('div', { style: { display: 'flex', gap: '10px', marginTop: '12px', flexWrap: 'wrap' } },
+            React.createElement('button', { type: 'button', 'data-testid': 'subagent-save', disabled: saving || loading || (mode === 'custom' && (effectiveProvider === '' || model === '')), onClick: () => void save(mode), style: { fontSize: '12.5px', padding: '6px 16px', borderRadius: '7px', border: '1px solid transparent', background: 'var(--dsw-alias-state-success-primary)', color: '#fff', cursor: saving ? 'default' : 'pointer', opacity: saving || loading || (mode === 'custom' && (effectiveProvider === '' || model === '')) ? 0.55 : 1 } }, saving ? translate('subagent.saving') : translate('subagent.save')),
+            mode !== 'inherit' ? React.createElement('button', { type: 'button', 'data-testid': 'subagent-reset', disabled: saving || loading, onClick: () => { setMode('inherit'); void save('inherit') }, style: { fontSize: '12.5px', padding: '6px 14px', borderRadius: '7px', border: '1px solid var(--dsw-alias-state-error-primary)', background: 'transparent', color: 'var(--dsw-alias-state-error-primary)', cursor: saving ? 'default' : 'pointer', opacity: saving || loading ? 0.55 : 1 } }, translate('subagent.reset')) : null),
+          React.createElement('div', { style: { marginTop: '12px', paddingTop: '10px', borderTop: '1px solid var(--dsw-alias-border-l1)', display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: '12px' } },
+            React.createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: '2px' } },
+              React.createElement('span', { style: { fontSize: '13px', color: 'var(--dsw-alias-label-primary)' } }, translate('subagent.navToggle')),
+              React.createElement('span', { style: hintStyle }, translate('subagent.navToggleHint'))),
+            React.createElement('button', {
+              type: 'button',
+              role: 'switch',
+              'data-testid': 'subagent-nav-switch',
+              'aria-checked': String(navEnabled),
+              onClick: () => setNavEnabled(!navEnabled),
+              style: { width: '34px', height: '20px', borderRadius: '10px', padding: 0, flexShrink: 0, position: 'relative', border: `1px solid ${navEnabled ? 'var(--dsw-alias-state-success-primary)' : 'var(--dsw-alias-border-l2)'}`, background: navEnabled ? 'var(--dsw-alias-state-success-primary)' : 'var(--dsw-alias-bg-layer-2)', cursor: 'pointer', lineHeight: 0 },
+            }, React.createElement('span', { style: { position: 'absolute', top: '1px', left: navEnabled ? '15px' : '1px', width: '16px', height: '16px', borderRadius: '50%', background: navEnabled ? '#fff' : 'var(--dsw-alias-label-tertiary)' } }))))
+      }
+
       // ─── 技能管理（v0.22）：三区列表 / 启停 / AI 补全 / 批量 ────────────────
       const SKILLS_MODEL_STORAGE_KEY = 'dsh-service-skills-model'
       const SKILL_RPC = (endpoint, payload) => ctx.connection.rpc.call('/dsh-service', endpoint, payload)
@@ -4099,6 +4299,7 @@ window.__ModuleLoader__.load({
           ...(features.quotaLookup !== false ? [['quota', 'tabs.quota']] : []),
           ...(features.backupMaintenance !== false ? [['backup', 'tabs.backup']] : []),
           ...(features.skillManager !== false ? [['skills', 'tabs.skills']] : []),
+          ...(features.subagentRoute !== false ? [['subagent', 'tabs.subagent']] : []),
           ['restart', 'tabs.restart'],
         ]
         const warningTabs = tabs.filter(([id]) => tabWarnings[id]).map(([, label]) => translate(label))
@@ -4117,6 +4318,8 @@ window.__ModuleLoader__.load({
                   ? maintenanceBlock
                 : visibleActiveTab === 'skills'
                   ? React.createElement(SkillsSection, null)
+                : visibleActiveTab === 'subagent'
+                  ? React.createElement(SubagentSection, null)
                   : restartBlock
         return React.createElement('div', null,
           warningTabs.length > 0 ? React.createElement('div', { style: { marginBottom: '12px', padding: '11px 13px', borderRadius: '8px', background: 'rgba(198,128,0,0.16)', border: '1px solid rgba(198,128,0,0.48)', boxShadow: '0 2px 8px rgba(0,0,0,0.08)' } },
@@ -4179,19 +4382,23 @@ window.__ModuleLoader__.load({
           { name: 'settings.section', id: 'dsh-service', order: 99, label: () => t('nav.label') },
           () => React.createElement(ServicePanel, null),
         )
-        // 左列「重启」「额度查询」「技能」入口由各自标签内的开关控制，默认不注册
+        // 左列「重启」「额度查询」「技能」「子代理」入口由各自标签内的开关控制，默认不注册
         restartNavToggle.sync()
         quotaNavToggle.sync()
         skillsNavToggle.sync()
+        subagentNavToggle.sync()
         const unsubscribeFeatures = featureScope.subscribe(quotaNavToggle.sync)
         const unsubscribeFeaturesSkills = featureScope.subscribe(skillsNavToggle.sync)
+        const unsubscribeFeaturesSubagent = featureScope.subscribe(subagentNavToggle.sync)
         return () => {
           unsubscribeFeatures()
           unsubscribeFeaturesSkills()
+          unsubscribeFeaturesSubagent()
           disposePanel()
           restartNavToggle.disposeEntry()
           quotaNavToggle.disposeEntry()
           skillsNavToggle.disposeEntry()
+          subagentNavToggle.disposeEntry()
         }
       })
       ctx.slots.inject('shell.overlay', () => ctx.slots.register(

package/index.js

@@ -24,6 +24,7 @@ const DEFAULT_FEATURE_SETTINGS = Object.freeze({
   taskNotifications: true,
   healthz: true,
   skillManager: true,
+  subagentRoute: true,
 })
 const FeatureSettingsSchema = z.object({
   modelUsage: z.boolean().default(true),
@@ -32,6 +33,7 @@ const FeatureSettingsSchema = z.object({
   taskNotifications: z.boolean().default(true),
   healthz: z.boolean().default(true),
   skillManager: z.boolean().default(true),
+  subagentRoute: z.boolean().default(true),
 })
 const NPM_REGISTRY = 'https://registry.npmjs.org/'
 const MAX_NPM_RESPONSE_BYTES = 256 * 1024
@@ -157,6 +159,15 @@ const MAX_QUOTA_CPA_CALLS = 12
 const QUOTA_CPA_CONCURRENCY = 3
 const MAX_QUOTA_CPA_WINDOWS = 32
 
+// 子代理路由（v0.27）：三态配置的常量。inherit=不干预（原生继承），
+// follow=派生时读父会话最近一次请求路由注入，custom=固定 provider/model。
+// 数值只在此处与 TODO.md 里程碑两处出现。
+const SUBAGENT_ROUTE_VERSION = 1
+const SUBAGENT_ROUTE_FILE = 'dsh-service-subagent-route.json'
+const SUBAGENT_ROUTE_MODES = ['inherit', 'follow', 'custom']
+const MAX_SUBAGENT_ROUTE_BYTES = 64 * 1024
+const MAX_SUBAGENT_ROUTE_FIELD = 256
+
 // 升级目标白名单：命令与包名全部来自宿主常量，浏览器不传任何输入。
 // TARGET_RE 与 dsh-market 同源：只放行「包名@版本」这一种形状的字符集。
 const TARGET_RE = /^[A-Za-z0-9@:./_#+~^=-]+$/
@@ -2879,6 +2890,88 @@ async function listSkillModels(llm, agentDefaultModel) {
   return { models, ...(current !== undefined ? { current } : {}) }
 }
 
+/** 子代理路由配置的空档（inherit）：与未安装本功能的原生行为完全一致。 */
+function createEmptySubagentRoute() {
+  return { version: SUBAGENT_ROUTE_VERSION, mode: 'inherit' }
+}
+
+/** 解析磁盘上的子代理路由配置：损坏/版本不符/未知模式回退 inherit（零侵入，不因坏配置破坏派生）。 */
+function parseSubagentRouteText(text) {
+  const fallback = createEmptySubagentRoute()
+  let parsed
+  try {
+    parsed = JSON.parse(text)
+  } catch (_) {
+    return fallback
+  }
+  if (parsed?.version !== SUBAGENT_ROUTE_VERSION || !SUBAGENT_ROUTE_MODES.includes(parsed.mode)) return fallback
+  if (parsed.mode !== 'custom') return { version: SUBAGENT_ROUTE_VERSION, mode: parsed.mode }
+  const provider = typeof parsed.provider === 'string' ? parsed.provider.trim().slice(0, MAX_SUBAGENT_ROUTE_FIELD) : ''
+  const model = typeof parsed.model === 'string' ? parsed.model.trim().slice(0, MAX_SUBAGENT_ROUTE_FIELD) : ''
+  if (provider === '' || model === '') return fallback
+  return { version: SUBAGENT_ROUTE_VERSION, mode: 'custom', provider, model }
+}
+
+async function loadSubagentRoute(dshHome) {
+  try {
+    const target = join(dshHome, SUBAGENT_ROUTE_FILE)
+    const info = await stat(target)
+    if (info.size > MAX_SUBAGENT_ROUTE_BYTES) return createEmptySubagentRoute()
+    return parseSubagentRouteText(await readFile(target, 'utf8'))
+  } catch (_) {
+    return createEmptySubagentRoute()
+  }
+}
+
+async function saveSubagentRoute(dshHome, config) {
+  await mkdir(dshHome, { recursive: true })
+  const target = join(dshHome, SUBAGENT_ROUTE_FILE)
+  const temporary = `${target}.${randomUUID()}.tmp`
+  try {
+    await writeFile(temporary, JSON.stringify(config), { mode: 0o600 })
+    await rename(temporary, target)
+  } finally {
+    await rm(temporary, { force: true })
+  }
+}
+
+/**
+ * 计算一次子代理派生应注入的 agentOptions（seam 核心，纯函数便于测试）：
+ * - 派生请求已显式携带 provider 或 model → 不干预（显式永远赢，含预设钉死与其他插件注入）；
+ * - follow → 读父会话最近一次 request header 的路由（= 主对话当前实际在用的渠道；空白
+ *   会话无 header 时回落继承，不注入）；
+ * - custom → 配置的 provider/model，且 llm 注册表当前可路由才注入（渠道被卸载后回落继承
+ *   而不是让派生失败）；
+ * - inherit / 其余一切 → undefined（原生继承父代理创建 options）。
+ * @param {object|null} request SubagentStartRequest（读 parent / agentOptions）。
+ * @param {object|null} config 当前生效的路由配置。
+ * @param {object} options isRoutable(provider) 与 readParentHeader(parent) 注入点（测试替身用）。
+ */
+function resolveSubagentInjection(request, config, options = {}) {
+  const agentOptions = request?.agentOptions
+  const explicitProvider = typeof agentOptions?.provider === 'string' && agentOptions.provider !== ''
+  const explicitModel = typeof agentOptions?.model === 'string' && agentOptions.model !== ''
+  if (explicitProvider || explicitModel) return undefined
+  if (config?.mode === 'follow') {
+    let header
+    try {
+      header = options.readParentHeader?.(request?.parent)
+    } catch (_) {
+      header = undefined
+    }
+    if (typeof header?.provider === 'string' && header.provider !== '' && typeof header?.model === 'string' && header.model !== '') {
+      return { provider: header.provider, model: header.model }
+    }
+    return undefined
+  }
+  if (config?.mode === 'custom' && typeof config.provider === 'string' && config.provider !== '' && typeof config.model === 'string' && config.model !== '') {
+    if (options.isRoutable !== undefined && !options.isRoutable(config.provider)) return undefined
+    return { provider: config.provider, model: config.model }
+  }
+  return undefined
+}
+
+
 function apply(ctx) {
   const dshHome = resolveDshHome()
   let featureSettings = DEFAULT_FEATURE_SETTINGS
@@ -2954,6 +3047,64 @@ function apply(ctx) {
     }
     skillsActiveControllers.clear()
   }, 'dsh-service skills batch teardown')
+  // ── 子代理路由（v0.27）：三态配置 + subagents seam ─────────────────────
+  // 内存态即 seam 读取的事实源：保存端点落盘成功后原地替换，派生路径零读盘。
+  let subagentRouteConfig = createEmptySubagentRoute()
+  const subagentRouteLoadPromise = Promise.resolve().then(async () => {
+    subagentRouteConfig = await loadSubagentRoute(dshHome)
+  })
+  // 配置写串行化（quota-config 同款）：所有写先等首次加载完成再从同一内存快照复制，
+  // 避免与启动加载竞态把磁盘回退成 inherit。
+  let subagentRouteWrites = Promise.resolve()
+  const serializeSubagentRouteWrite = (work) => {
+    const result = subagentRouteWrites.then(async () => {
+      await subagentRouteLoadPromise
+      const current = { ...subagentRouteConfig }
+      const outcome = await work(current)
+      if (outcome?.save === false) return outcome.value
+      await saveSubagentRoute(dshHome, current)
+      subagentRouteConfig = current
+      return outcome.value
+    })
+    subagentRouteWrites = result.then(() => undefined, () => undefined)
+    return result
+  }
+  // seam 是否已挂上（宿主 subagents 服务存在时由下面的 inject 置真）：快照端点据此告知客户端。
+  let subagentSeamInstalled = false
+  // 只包装宿主 subagents 注册表的两个入口（start / startContinuable，spawn/fork/acp 全走这
+  // 两个口）：未显式指定模型的派生按配置注入 agentOptions，其余原样透传。Fiber 销毁还原
+  // 原方法——包装挂在服务实例上，disposer 期间新派生恢复原生行为。
+  ctx.inject(['subagents'], (scope) => {
+    const subagents = scope.subagents
+    if (subagents === undefined || typeof subagents.start !== 'function' || typeof subagents.startContinuable !== 'function') return
+    const isRoutable = (provider) => {
+      const llm = ctx.get('llm')
+      if (llm === undefined || typeof llm.listProviders !== 'function') return false
+      try {
+        return llm.listProviders().some((entry) => entry?.id === provider)
+      } catch (_) {
+        return false
+      }
+    }
+    const readParentHeader = (parent) => parent?.session?.requestHeader?.()?.config
+    const decorate = (request) => {
+      if (!featureEnabled('subagentRoute')) return request
+      const injected = resolveSubagentInjection(request, subagentRouteConfig, { isRoutable, readParentHeader })
+      if (injected === undefined) return request
+      ctx.logger?.info?.(`dsh-service: subagent route seam applied ${injected.provider}/${injected.model} to a subagent without an explicit route`)
+      return { ...request, agentOptions: { ...(request?.agentOptions ?? {}), ...injected } }
+    }
+    const originalStart = subagents.start
+    const originalStartContinuable = subagents.startContinuable
+    subagents.start = (name, request) => originalStart.call(subagents, name, decorate(request))
+    subagents.startContinuable = (spec) => originalStartContinuable.call(subagents, { ...spec, request: decorate(spec.request) })
+    subagentSeamInstalled = true
+    scope.effect(() => () => {
+      subagents.start = originalStart
+      subagents.startContinuable = originalStartContinuable
+      subagentSeamInstalled = false
+    }, 'dsh-service subagent route seam teardown')
+  })
   let quotaConfig = createEmptyQuotaConfig()
   let quotaConfigLoaded = false
   let quotaConfigLoadPromise
@@ -3841,6 +3992,70 @@ function apply(ctx) {
       }
     }
 
+    // ── 子代理路由（v0.27）：快照 + 三态保存 ─────────────────────────────
+    if (endpoint === 'subagent-route') {
+      if (!featureEnabled('subagentRoute')) return { ok: false, error: 'feature-disabled' }
+      try {
+        await subagentRouteLoadPromise
+        const llm = ctx.get('llm')
+        // 模型清单沿用 skills-models 的白名单口径（llm.listProviders × listModels，单渠道失败跳过）；
+        // llm 服务缺席时清单为空——自定义模式在保存端也会被拒（llm-unavailable），快照仍可下发。
+        let models = []
+        let current
+        if (llm !== undefined && typeof llm.listProviders === 'function') {
+          const catalog = await listSkillModels(llm, ctx.get('agentDefaultModel'))
+          models = catalog.models
+          current = catalog.current
+        }
+        const config = subagentRouteConfig
+        return {
+          ok: true,
+          value: {
+            available: subagentSeamInstalled,
+            mode: config.mode,
+            ...(config.mode === 'custom' ? { provider: config.provider, model: config.model } : {}),
+            models,
+            ...(current !== undefined ? { current } : {}),
+          },
+        }
+      } catch (error) {
+        return { ok: false, error: error?.message || String(error) }
+      }
+    }
+
+    if (endpoint === 'subagent-route-save') {
+      if (!featureEnabled('subagentRoute')) return { ok: false, error: 'feature-disabled' }
+      const mode = payload?.mode
+      if (!SUBAGENT_ROUTE_MODES.includes(mode)) return { ok: false, error: 'unknown-mode' }
+      try {
+        if (mode === 'custom') {
+          const provider = typeof payload?.provider === 'string' ? payload.provider.trim() : ''
+          const model = typeof payload?.model === 'string' ? payload.model.trim() : ''
+          if (provider === '' || model === '') return { ok: false, error: 'invalid-model-route' }
+          const llm = ctx.get('llm')
+          if (llm === undefined || typeof llm.stream !== 'function') return { ok: false, error: 'llm-unavailable' }
+          // 与 skills-describe 同一道闸：provider/model 必须命中运行时清单白名单。
+          const whitelist = await listSkillModels(llm, ctx.get('agentDefaultModel'))
+          if (!whitelist.models.some((item) => item.provider === provider && item.id === model)) return { ok: false, error: 'invalid-model-route' }
+        }
+        return await serializeSubagentRouteWrite(async (config) => {
+          if (mode === 'custom') {
+            config.mode = 'custom'
+            config.provider = typeof payload?.provider === 'string' ? payload.provider.trim().slice(0, MAX_SUBAGENT_ROUTE_FIELD) : ''
+            config.model = typeof payload?.model === 'string' ? payload.model.trim().slice(0, MAX_SUBAGENT_ROUTE_FIELD) : ''
+          } else {
+            // inherit / follow：不保留 custom 字段，重置回干净形状。
+            config.mode = mode
+            delete config.provider
+            delete config.model
+          }
+          return { value: { ok: true, mode: config.mode, ...(config.mode === 'custom' ? { provider: config.provider, model: config.model } : {}) } }
+        })
+      } catch (error) {
+        return { ok: false, error: error?.message || String(error) }
+      }
+    }
+
     return { ok: false, error: 'unknown endpoint: ' + String(endpoint) }
   }, { authority: 'loopback' })
 }
@@ -3874,11 +4089,13 @@ export {
   normalizeZaiCodingUsage,
   parseQuotaConfigText,
   parseSkillFrontmatterData,
+  parseSubagentRouteText,
   quotaCredentialHintNames,
   quotaEndpointFor,
   quotaErrorCode,
   readLlmProviders,
   resolveSkillInvocationState,
+  resolveSubagentInjection,
   runtimeEnvCheck,
   safeCliproxyOrigin,
   sanitizeSkillDraftText,
@@ -3916,11 +4133,13 @@ export default {
   normalizeZaiCodingUsage,
   parseQuotaConfigText,
   parseSkillFrontmatterData,
+  parseSubagentRouteText,
   quotaCredentialHintNames,
   quotaEndpointFor,
   quotaErrorCode,
   readLlmProviders,
   resolveSkillInvocationState,
+  resolveSubagentInjection,
   runtimeEnvCheck,
   safeCliproxyOrigin,
   sanitizeSkillDraftText,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gehennawu/dsh-service",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "DSH Web 自托管运维面板：安全重启、健康监控、备份和 Linux 权限维护。",
   "type": "module",
   "scripts": {