@local/dsh-subagent-gate —— 原生子代理总开关

设置 → 通用设置 里的一行开关（settings.general.item，order 95，在"上传 Session Log"下面）。

行为

开关	效果
关	① 不注入任何子代理提示词；② 往 profile 补丁写一条自维护的禁用块（见下），把 ui-settings-subagent、ui-subagent 两行停掉 → 插件页里的「子智能体」卡片消失，会话里的子代理卡片 UI 也不再加载
开	① 上面那条禁用块被自动撤掉，卡片回来；② 只有该会话确实有子代理记录时才注入提示词；③ 无记录的会话一个字的提示词都不给

注入的提示词（开关打开 + 会话有记录时）：

[原生子代理] 本会话有 N 条子代理记录（本机原生子代理已关闭）：
- 写作子代理 [done]
- 校对子代理 [running]
说明：subagent / subagent_fork / list_agents 等原生工具在本机不存在，不要调用它们，也不要假装派过子代理。
需要派子代理时用免费桥接：freesub_run(task="…")（Qoder CN 的免费模型）。
用户问起这些历史记录时，照实说明原生子代理已被总开关关闭。

措辞就是上面这段；不满意的直接改 index.js 里 systemPrompt.context(...) 的 text() 返回值。

它写进 profile 补丁的东西（自维护块）

# === subagent-gate: begin（由「原生子代理总开关」自动维护，勿手改）===
- id: ui-settings-subagent
  disabled: true
- id: ui-subagent
  disabled: true
# === subagent-gate: end ===

关 → 写入；开 → 撤掉。补丁文件是活的，写完立即重载，不需要重启。

验收记录（2026-10-16）

场景	实测
关：插件行被停掉	网页启动载荷里 dsh-client-ui-settings-subagent / dsh-client-ui-subagent 出现次数 0
开：复原	两者回到 5，禁用块被自动删除，补丁回到基线 67 行
开 + 会话有子代理记录	注入上方那段提示词
开 + 会话无记录	注入内容 = ""
关	注入内容 = ""

边界（重要）

本开关只管提示词与插件页可见性，不会把原生"派子代理"的能力重新打开： 真正派子代理还需要 subagent 行的 maxDepth > 0，以及 tool-subagent 等工具行启用。 如果哪天想要"打开=真的能派"，那是第二条档位，需要显式再加（目前故意不做，因为原生子代理很贵）。

机制订正 + 踩坑（2026-10-16 二次修订）

设置页那行能不能出现，取决于宿主 Config 的字段有没有标 .volatile() —— dsh-settings 的原文是："表单只展示活动且可唯一定位的 profile 条目中的 volatile 字段"。 没标 = 不会被服务 = 浏览器侧 configForms.whileServed([namespace]) 永远不成立 = 那行永远不出现。 本插件三个字段现在都是 .default(...).description(...).volatile()。

踩坑留痕：第一版照着另一个插件抄了 settings.installSection(ctx, name, Config, config, {...})，这个方法在 DSH 里根本不存在 （整个 runtime 零匹配），所以表单一直没被服务。已改成真接口 （settings.configure({ auto: false }, ctx.fiber)，且做了 typeof 守卫）。

源码改动不热重载（宿主按路径缓存已加载模块）：本文件的改动需要重启该实例才生效。 而 .volatile() 字段的值改动是热的，改完立刻生效。

v0.1.2（方案 A：把真相告诉模型）2026-10-16

关掉总开关时注入（每个会话、每次组装提示词）：

[原生子代理] 本机原生子代理已关闭（总开关处于"关"）。
不要调用 subagent / subagent_fork / list_agents / send_message / interrupt_agent —— 它们必然失败（maxDepth 0）。
需要派子代理时用免费桥接：freesub_run(task="…")。

开启时：会话有子代理记录 → 注入历史记录说明；无记录 → 一个字都不注入。

为什么不是"把工具删掉"（查证结论，别再试了）

dsh-tools 的实现写死了两条约束：

if (scope === undefined) throw new Error("tools.restrict() requires a scoped context (agent.ctx) …")
if (unknown.length > 0) throw new Error("tools.restrict() names unknown global tool(s) …")

即：必须在 agent 作用域调用，且只能点名全局工具。而 subagent / subagent_fork 是由 agent preset 平面（preset-standard 的 plugins 列表）注册的 scope-local 工具， 既不在全局工具表里、也不在任何外部插件够得着的作用域里 —— 外部插件无法摘掉它们。 （agent/request 也没戏：LlmCallConfig 里没有 tools 字段，文档明确"不能改模型可见内容"。）

所以本插件的边界是：管得住"我注入的提示词"和"插件页可见性"，管不住 preset 给的工具。 唯一的真删法是覆写 preset 的 plugins 列表，代价是会与「子智能体」设置页抢同一份配置 —— 已明确不做。

诊断

subagent-gate\gate.log：每次 apply / 开关变化 / 写补丁结果都留痕（这个组合里 ctx.logger 不存在，所以写文件）。

源码改动仍需重启

hmr 的 root 已指向本目录，但实测没有触发热重载（gate.log 无新 apply 行）。 所以改 index.js 后请用桌面「重启 DSH 3080」快捷方式重启一次；开关值的改动是热的，不需要重启。