dsh-router-core 0.4.1 → 0.4.3

package/src/client/index.tsx

@@ -48,15 +48,11 @@ interface Ctx {
  * （kind: list, scope: session —— 即宿主 composer 卡片底部操作行
  * `.uV2eYG_dock` 里、原生上下文环旁边的位置）。
  * scope 为 session 时宿主给组件注入 `sessionId`，据此按**当前会话**取命中。
- *
- * **仅宿主 >= 0.1.7 才挂**：composer.dock 这个座位在 0.1.5 也在，但渲染在
- * InputBar 之后的独立块（位置不对），只有 0.1.7 才放进底部操作行。座位名相同
- * 没法靠契约区分，故先问核心 `/router/api/health` 的 `lastHitDock` 支持位。
- * @returns 清理函数；不支持或宿主无 slots 时为空操作
+ * @returns 清理函数；宿主没给 slots 时为空操作
  */
-function mountLastHitDock(ctx: Ctx, supported: boolean): () => void {
+function mountLastHitDock(ctx: Ctx): () => void {
   const slots = ctx.slots
-  if (slots === undefined || !supported) return () => {}
+  if (slots === undefined) return () => {}
   return slots.inject('conversation.composer.dock', () => slots.register({
     name: 'conversation.composer.dock',
     id: 'dsh-router-last-hit',
@@ -64,21 +60,6 @@ function mountLastHitDock(ctx: Ctx, supported: boolean): () => void {
   }, LastHitDock))
 }
 
-/**
- * 问核心是否支持「最近命中」徽章（宿主 >= 0.1.7）。
- * 网络/解析失败一律当**不支持**——宁可不显示，也不在 0.1.5 上摆错位置。
- */
-async function fetchLastHitDockSupport(): Promise<boolean> {
-  try {
-    const res = await fetch(`${ROUTER_API_BASE}/health`)
-    if (!res.ok) return false
-    const body = (await res.json()) as { lastHitDock?: unknown }
-    return body.lastHitDock === true
-  } catch {
-    return false
-  }
-}
-
 /** 挂载「设置 → 路由」页；拿不到 slots 时返回 undefined 表示跳过。 */
 function mountSettingsSection(ctx: Ctx): (() => void) | undefined {
   const slots = ctx.slots
@@ -131,12 +112,10 @@ function registerExtTestPanel(ctx: Ctx): void {
 
 export function apply(ctx: Ctx): void {
   // 「最近命中」徽章：走官方 conversation.composer.dock（scope: session → 组件
-  // props 注入 sessionId，按当前会话取命中）。**仅宿主 >= 0.1.7 才挂**——
-  // composer.dock 在 0.1.5 渲染位置不对，先问核心拿支持位，避免摆错位置。
-  // 查询是异步的，拿到结果（无论成败）再决定注册与否。
-  void fetchLastHitDockSupport().then((supported) => {
-    ctx.effect(() => mountLastHitDock(ctx, supported), 'dsh-router: last-hit dock')
-  })
+  // props 注入 sessionId，按当前会话取命中）。0.2.0 起这个座位无条件可用 ——
+  // 0.1.5 那个「渲染位置不对」的老宿主已不支持，所以不再问核心拿支持位，
+  // 启动期也就不用多一次 /health 往返。
+  ctx.effect(() => mountLastHitDock(ctx), 'dsh-router: last-hit dock')
   const disposeSettings = mountSettingsSection(ctx)
   if (disposeSettings === undefined) {
     // 老宿主（无 slots）：回退到侧边栏入口 + 中心栏面板

package/src/client/router.css

@@ -982,44 +982,6 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
 }
 
 /* 开关 */
-.dshr-toggle {
-    position: relative;
-    flex: none;
-    width: 30px;
-    height: 16px;
-    border: none;
-    border-radius: 8px;
-    background: var(--rs-line);
-    cursor: pointer;
-    padding: 0;
-    transition: background 0.15s ease;
-}
-
-.dshr-toggle-on {
-    background: var(--rs-ok);
-}
-
-.dshr-toggleKnob {
-    position: absolute;
-    top: 2px;
-    left: 2px;
-    width: 12px;
-    height: 12px;
-    border-radius: 50%;
-    background: #fff;
-    transition: transform 0.15s ease;
-}
-
-.dshr-toggle-on .dshr-toggleKnob {
-    transform: translateX(14px);
-}
-
-/* 开关禁用态：不可用(未就绪)且未开启时,灰显 + 不可点 */
-.dshr-toggle:disabled {
-    cursor: default;
-    opacity: 0.45;
-}
-
 /* 扩展页：未就绪问题描述(红字) */
 .dshr-ext-error {
     color: var(--rs-danger);
@@ -1340,16 +1302,6 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     box-shadow: 0 0 0 3px color-mix(in srgb, var(--rs-accent) 18%, transparent);
 }
 
-/* 开关微过渡 */
-.dshr-toggle {
-    transition:
-        background 0.15s ease,
-        box-shadow 0.15s ease;
-}
-.dshr-toggle:hover {
-    box-shadow: 0 0 0 3px color-mix(in srgb, var(--rs-accent) 18%, transparent);
-}
-
 /* 内容区细滚动条 */
 .dshr-content::-webkit-scrollbar,
 .dshr-tableWrap::-webkit-scrollbar,
@@ -2346,8 +2298,8 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     justify-content: center;
     font-size: 10px;
     font-weight: 600;
-    color: var(--rs-primary);
-    background: color-mix(in srgb, var(--rs-primary) 12%, transparent);
+    color: var(--rs-accent);
+    background: color-mix(in srgb, var(--rs-accent) 12%, transparent);
 }
 
 .dshr-comboChipSupplier {
@@ -2395,7 +2347,9 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     display: flex;
     flex-direction: column;
     gap: 6px;
-    max-height: 380px;
+    /* 原 max-height: 380px —— 写死的值，与容器无关。改由 flex 链给。 */
+    flex: 1;
+    min-height: 0;
     overflow-y: auto;
 }
 
@@ -2442,8 +2396,8 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     justify-content: center;
     font-size: 11px;
     font-weight: 600;
-    color: var(--rs-primary);
-    background: color-mix(in srgb, var(--rs-primary) 12%, transparent);
+    color: var(--rs-accent);
+    background: color-mix(in srgb, var(--rs-accent) 12%, transparent);
 }
 
 .dshr-comboStepSelect {
@@ -2463,7 +2417,7 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     border: 1px dashed color-mix(in srgb, var(--rs-text) 20%, transparent);
     border-radius: 9px;
     background: transparent;
-    color: var(--rs-primary);
+    color: var(--rs-accent);
     font-size: 12px;
     font-weight: 500;
     cursor: pointer;
@@ -2477,8 +2431,8 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
 }
 
 .dshr-comboAddStep:hover {
-    border-color: color-mix(in srgb, var(--rs-primary) 50%, transparent);
-    background: color-mix(in srgb, var(--rs-primary) 5%, transparent);
+    border-color: color-mix(in srgb, var(--rs-accent) 50%, transparent);
+    background: color-mix(in srgb, var(--rs-accent) 5%, transparent);
 }
 
 /* 组合：已选模型行 + 添加模型挑选列表 */
@@ -2505,7 +2459,7 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     display: flex;
     flex-direction: column;
     gap: 2px;
-    max-height: 300px;
+    /* 原 max-height: 300px —— 写死的值，与容器无关。改由 flex 链给。 */
     overflow-y: auto;
 }
 
@@ -2563,7 +2517,14 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     display: grid;
     grid-template-columns: 1fr 1fr;
     gap: 24px;
-    align-items: start;
+    /* stretch 而非 start：两列都吃满行高，右列那个滚动列表才有高可用。
+       用 start 的话行高由最高的一列决定，短的那列留白 —— 同一个病。 */
+    align-items: stretch;
+    /* 行高必须是 minmax(0,1fr) 而不是隐式 auto：auto 行高由内容决定，
+       视口一小内容压不下去，滚动就又跑到外层 body 去了。 */
+    grid-template-rows: minmax(0, 1fr);
+    flex: 1;
+    min-height: 0;
 }
 
 .dshr-comboFormLeft {
@@ -2571,6 +2532,15 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     flex-direction: column;
     gap: 12px;
     min-width: 0;
+    min-height: 0;
+}
+
+/* 「模型」那一坨（标题 + 列表）吃掉剩余高度，列表才有空间滚动 */
+.dshr-comboFormLeft > div:last-child {
+    display: flex;
+    flex-direction: column;
+    flex: 1;
+    min-height: 0;
 }
 
 .dshr-comboFormRight {
@@ -2578,7 +2548,7 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     flex-direction: column;
     gap: 6px;
     min-width: 0;
-    max-height: 460px;
+    min-height: 0;
 }
 
 .dshr-comboFormRight .dshr-comboPickList {
@@ -2588,12 +2558,33 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
 
 /* 组合编辑弹窗：加宽加高（body 更高，内部列表同步放大） */
 .dshr-modal-wide {
+    /* 高度上限必须**扣掉遮罩的 24px×2 padding**：原来的 90vh 在视口
+       低于 480px 时，90vh + 48px 必然超过视口，弹窗顶出遮罩。
+       （基础 .dshr-modal 用 80vh 所以一直没这问题，只有 -wide 变体有。） */
+    --dshr-modalMaxH: calc(100vh - 48px);
     width: min(760px, 100%);
-    max-height: min(90vh, 820px);
+    max-height: min(var(--dshr-modalMaxH), 820px);
 }
 
+/* ⚠️ 这条 min-height **只预留**了高度，不往内传递：body 是块容器，里面的内容
+   各自按自己的 max-height 摆（pick list 300 / 左列表 380 / 右列 460），
+   560 - 内容高 就是底部那条空白 —— 选 2 个模型时最明显，选满时反而看不见，
+   所以它一直躲过了「按内容相关问题」的眼。
+   改成 flex 列，并让 .dshr-modalForm 吃掉剩余高度，预留才真正被内容用掉。
+
+   ⚠️ 地板也不能写死：视口一小，560px 会把弹窗顶出遮罩，逼得**外层 body**
+   出来滚动（多一道滚动条，还裁掉一截）。上限跟着 --dshr-modalMaxH 走
+   （60 = 头部 48 + 边框 2 + 余量），空间不够时该滚的是内层
+   .dshr-comboPickList，不是整个 body。 */
 .dshr-modal-wide .dshr-modalBody {
-    min-height: 560px;
+    min-height: min(560px, calc(var(--dshr-modalMaxH) - 60px));
+    display: flex;
+    flex-direction: column;
+}
+
+.dshr-modal-wide .dshr-modalForm {
+    flex: 1;
+    min-height: 0;
 }
 
 /* 左右分栏之间的分割线 */
@@ -3375,7 +3366,9 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     gap: 16px;
     min-width: 0;
     border-bottom: 0.5px solid var(--dsw-alias-border-l2);
-    padding: 12px 2px;
+    /* ⚠️ 左右 14px（原先 2px）：行贴着卡片边缘，文字几乎顶到边框，读起来"挤"。
+       2026-09-29 用户提出。与 `-compHead` 的内缩对齐。 */
+    padding: 12px 14px;
 }
 
 .dshr-compRow:last-child {
@@ -3417,11 +3410,88 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     overflow-wrap: anywhere;
 }
 
+/* 扩展子开关的浮动提示：`dshr-toast` 的**窄范围覆盖**。
+   ⚠️ 不去改 `.dshr-toast` 本身 —— 它被 `SupplierDetail` 也在用（那边全是
+   「连接池顺序已保存」这种 9 字短句，所以从没暴露过宽度问题）。
+   本处的错误文案更长（「只能删除自定义准则（内置条目请用开关关掉）」19 字），
+   而 `.dshr-toast` 是 `white-space: nowrap` **且没有 `max-width`** ⇒ 会横向溢出屏幕。
+   ⇒ 只加**换行 + 上限 + 居中**，定位用绝对定位挂在提示自身，**不影响既有调用方**。 */
+.dshr-toastWrap {
+    position: fixed;
+    z-index: 2000;
+    left: 50%;
+    bottom: 28px;
+    transform: translateX(-50%);
+    max-width: min(420px, calc(100vw - 32px));
+    padding: 8px 16px;
+    border-radius: 8px;
+    color: var(--rs-text);
+    background: var(--rs-layer-2);
+    border: 1px solid var(--rs-line-strong);
+    box-shadow: 0 6px 20px rgb(0 0 0 / 0.18);
+    font-size: 12px;
+    font-weight: 500;
+    white-space: pre-wrap;   /* 允许换行，不再 nowrap 溢出 */
+    text-align: center;
+    animation: dshrToastIn 0.18s ease;
+}
+
+/* 标题 + 「修改」按钮的**同一行**（`ExtDetail` 的子开关区）。
+   ⚠️ 单独一个类而不改 `.dshr-compRowName`：那个类 `RouterComponentsSection` /
+   `ExtTestPanel` 也在用，给它加 `display:flex` 会把**那些页面的标题**也变成
+   flex 盒子（它们标题后面没有按钮，平白多一层）。
+   没有这层时按钮会掉到**下一行**：`.dshr-compRowMain` 是 column，而
+   `.dshr-compRowName` 是行内元素、标题一长就折行（2026-09-29 用户报）。 */
+/* 子开关区：`.dshr-compGroup` 的 `gap: 12px` 覆盖为 0（2026-09-30 用户要求）。
+   ⚠️ **不能直接改 `.dshr-compGroup`**：它还被 `RouterComponentsSection` 用着，
+   那里的 12px 隔的是「组标题 / hint / 列表」三块，删了会挤成一坨。
+   ⇒ 本处单独覆盖，且**只覆盖 gap**（其余属性仍复用同一个类）。
+   本页不需要这个间距：页头自带 `border-bottom` 分割线，再加 12px 留白
+   会让分割线"悬"在一段空白上方（用户说的「分割线有高度」）。 */
+.dshr-compGroupTight {
+    gap: 0;
+}
+
+/* 行内的「修改」按钮：**hover 该行才显形**（2026-09-29）。
+   14 行各挂一个常驻图标 = 一排按钮压过内容本身。
+   ⚠️ **必须同时有 `:focus-within`**：纯 `:hover` 会让**键盘用户永远够不到**
+     （Tab 到它时它是 `opacity:0`，看得见焦点环但看不见按钮）。
+   ⚠️ 用 `opacity` 而不是 `visibility`/`display` —— 后两者会让它**不可聚焦**
+     （`visibility:hidden` 的元素不进 Tab 序），`opacity:0` 仍在。 */
+.dshr-compRowAct {
+    opacity: 0;
+    transition: opacity 0.12s ease;
+}
+
+.dshr-compRow:hover .dshr-compRowAct,
+.dshr-compRow:focus-within .dshr-compRowAct {
+    opacity: 1;
+}
+
+/* 触屏没有 hover ⇒ 按钮永远点不到。窄屏（触屏为主）直接常显。 */
+@media (hover: none) {
+    .dshr-compRowAct {
+        opacity: 1;
+    }
+}
+
+.dshr-compRowTitleLine {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+    min-width: 0;
+}
+
 .dshr-compRowState {
     color: var(--dsw-alias-label-tertiary);
     font-size: 11.5px;
     line-height: 16px;
     overflow-wrap: anywhere;
+    /* 保留换行：子开关的**原文**是这个类的另一个用法（2026-09-29 合并进来），
+       它是多行段落。状态文案都是单行，所以这条对它们没有副作用。
+       ⇒ 原来的 `.dshr-compRowBody` 整块删掉：14 条规则的正文不需要左边框 +
+       缩进那种「引用块」的额外装饰（用户要求），层级只靠颜色就够。 */
+    white-space: pre-wrap;
 }
 
 /* ============================================================

package/src/ext/contract.ts

@@ -64,12 +64,123 @@ export interface RouterExt {
    * 再在下面列一遍就是同一个东西显示两处。
    */
   readonly source?: 'builtin'
+  /**
+   * 扩展自带的**子开关**（可选；不声明 = 只有总开关）。
+   *
+   * 为什么需要：有些扩展的「开/关」不是一件事而是**几件独立的事** —— 例如分层
+   * 提示词有 14 个准则分类，每条都该能单独关。硬塞进一个总开关 = 要么全给、
+   * 要么全不给。
+   *
+   * ⚠️ **与总开关的关系**：子开关是**叠加**在总开关之上的，总开关关 ⇒ 全部子开关
+   *   一起失效（但**不清零**用户的子开关选择）。详情页在总开关关时把它们显示为
+   *   禁用而不是隐藏 —— 隐藏会让用户以为它们不存在。
+   *
+   * ⚠️ **值存哪**：核心**不认识**这些子开关的语义，只负责搬运。落盘一律走
+   *   `ExtStoreService.writeData`（`data` 抽屉），由扩展自己读回。核心不替扩展
+   *   存一份 —— 那样会变成两份可能漂移的真相。
+   */
+  /**
+   * 扩展自报的**子开关**列表。
+   *
+   * ⚠️ **实现方应当每次读都重算**（getter），而不是在构造时算好一个数组快照：
+   *   核心每次 `GET /ext` 都读它，面板也靠它刷新。若它是快照，改完文本再刷新
+   *   面板拿到的仍是**旧值** —— 用户会看到"保存了、又变回去了"
+   *   （实测踩过：2026-09-29 第一版用 `CATEGORIES.map(...)`，编辑生效但列表
+   *   不跟着变，而注释里还写着"现算不缓存"——**注释与事实不符**，比没写更坏）。
+   */
+  readonly controls?: ExtControl[]
+  /**
+   * 改一个子开关（面板调用；可选 —— 没有 `controls` 就不需要）。
+   *
+   * ⚠️ **为什么由扩展自己写、核心不代劳**：子开关的落盘形状归扩展所有
+   *   （本仓是 `data.categories[id]`），核心一旦代写就得认识那个形状 ——
+   *   换个扩展就是换个形状，核心会变成「认识所有扩展的私有数据格式」的地方。
+   *   核心只负责：把 `{ controlId, on }` 递进来，并把**成功/失败**如实回给面板。
+   *
+   * @param controlId - 要改的子开关 id。
+   * @param on - 目标状态。
+   * @returns 落盘结果。返回 false 时核心回 400，且**不写盘**。
+   */
+  setControl?(controlId: string, on: boolean): boolean
+  /**
+   * 改一个子开关的**文本**（标题 / 正文），可选 —— 不实现就是不可编辑。
+   *
+   * ⚠️ **与 `setControl` 分开而不是合并**：开关是**布尔**、文本是**字符串**，
+   *   合成一个方法就得在里面判类型，面板那边也要问"这次改的是哪个" ——
+   *   那是两个独立动作、两种失败原因（未知 id / 空标题）。
+   *
+   * ⚠️ 落盘形状仍归扩展（本仓是 `data.text[id]`，与开关的 `data.categories[id]`
+   *   **分开两个键**）：开关是"开不开"，文本是"写成什么样"，混在一个键里
+   *   改标题会顺手碰到开关状态。
+   *
+   * @param controlId - 要改的子开关 id。
+   * @param patch - 要覆盖的字段；**未出现的字段保持原样**（部分更新）。
+   * @returns 落盘结果。返回 false 时核心回 400，且**不写盘**。
+   */
+  setControlText?(controlId: string, patch: { title?: string; body?: string }): boolean
+  /**
+   * 改**展示顺序**（拖动）。落盘一串 id；扩展负责过滤自己不认识的 id。
+   *
+   * ⚠️ 与前三者都不同：它改的是**列表本身**，不是某一条的内容。
+   */
+  setControlOrder?(ids: string[]): boolean
+  /**
+   * 新增一条**自建**条目，返回新 id（由扩展生成，避免前端编 id 撞内置）。
+   * @returns 新 id；失败（如空标题/空正文）返回 null。
+   */
+  addCustomControl?(title: string, body: string): string | null
+  /**
+   * 删一条 —— **扩展应当只允许删自建条目**（内置的删除手段是关开关）。
+   * @returns 落盘结果；false 时核心回 400 且不写盘。
+   */
+  removeCustomControl?(controlId: string): boolean
+  /**
+   * 还原一条的文本（丢掉覆盖，回到扩展自带的内容）。
+   * 自建条目**没有"自带内容"**可回退，扩展应当对它返回 false。
+   */
+  resetControlText?(controlId: string): boolean
   /** 当前运行时状态（ready + 不就绪时的说明）。 */
   getState(): ExtState
   /** 卸载清理（表删除时由 dsh-router 调用，可选）。 */
   dispose?(): void
 }
 
+/**
+ * 一个可独立开关的子项（如准则的某一条）。
+ *
+ * ⚠️ `id` 是**持久化键**（落进 `data` 抽屉），**改名会让用户已保存的选择丢失**。
+ */
+export interface ExtControl {
+  /** 稳定 id（持久化键）。 */
+  readonly id: string
+  /** 面板显示名。 */
+  readonly title: string
+  /** 当前是否开启（扩展自算：默认值 + 用户已存的选择）。 */
+  readonly on: boolean
+  /** 一句话说明这一条管什么（面板副行，可选）。 */
+  readonly detail?: string
+  /**
+   * 这一条的**原文**（可选）—— 面板点开即可读到。
+   *
+   * 为什么值得加：不给出原文的话，用户是在**盲切** —— 只看到「结构」「交付」
+   * 这样的名字，不知道它到底写了什么，也无从判断该不该关掉这一条。给出原文
+   * ⇒「看内容 → 决定开关」这个动作才成立。
+   */
+  readonly body?: string
+  /**
+   * 这一条的**文本可被编辑**（可选；缺省 = 只读）。
+   *
+   * ⚠️ 为什么要显式声明而不是「有 `setControlText` 就可编辑」：扩展实现了写入
+   *   能力但某些条目**刻意锁住**（例如标题是分类 id 的可读形式，改了会和
+   *   `data` 里的键失去对应关系）。由扩展逐条说了算。
+   */
+  readonly editable?: boolean
+  /** 自建条目（可删除）。缺省 = 内置（不可删除，只有开关与还原）。 */
+  readonly custom?: boolean
+  /** 文本被用户改过（决定「还原」按钮是否可点）。 */
+  readonly overridden?: boolean
+}
+
 /** 面板/API 用的一条扩展器信息 = 核心存的开关 + 插件报的运行时事实。 */
 export interface ExtInfo {
   id: string

package/src/ext-prompt/assembly.test.ts

@@ -0,0 +1,79 @@
+/**
+ * 提示词**装配结果**的断言 —— 回答「我关掉的分类，真的没进 prompt 吗」。
+ *
+ * 为什么单独一个文件：这不是某个函数的单测，而是**跨模块的合成事实** ——
+ *   content.ts（内容）→ render.ts（按开关拼）→ mount.ts（注册 provider）
+ *   → ctx.systemPrompt（平台装配）→ renderPrompt（最终文本）
+ * 任何一环坏了，单测都绿而 prompt 里没有。
+ *
+ * ⚠️ 全部用**真 cordis + 真 dsh-system-prompt**。假 systemPrompt 会立即回调、
+ * 立刻返回，`assemble()` 返回什么全凭我写 —— 那就是自己给自己判分
+ * （2026-09-29 刚栽过：假 ctx 的 inject 立即回调，恰好把「准则没挂上」这个
+ * 真 bug 完美掩盖）。
+ */
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { Context } from '@deepseek-ai/cordis'
+import { SystemPrompt, renderPrompt, type PromptAssembly } from '@deepseek-ai/dsh-system-prompt'
+import { mountPromptSection, PROMPT_SECTION_NAME } from './mount.ts'
+import { renderPromptText } from './render.ts'
+import { PROMPT_CATEGORIES } from './content.ts'
+
+/** 起一个真 systemPrompt 并挂上本扩展。 */
+async function assemble(
+  opts: { masterOn?: boolean; data?: unknown } = {},
+): Promise<PromptAssembly> {
+  const ctx = new Context()
+  new SystemPrompt(ctx, {})
+  let enabled = true
+  const data = opts.data
+  const dispose = mountPromptSection({
+    getSystemPrompt: () => ctx.systemPrompt,
+    isEnabled: () => (opts.masterOn ?? enabled),
+    readData: () => data as never,
+  })
+  void enabled
+  void dispose
+  await new Promise((r) => setTimeout(r, 10))
+  return ctx.systemPrompt.assemble({})
+}
+
+test('★ 装配结果里真的有准则段落（不是「我以为我挂了」）', async () => {
+  const a = await assemble()
+  const mine = a.sections.find((s) => s.name === PROMPT_SECTION_NAME)
+  assert.ok(mine, `装配里没有 ${PROMPT_SECTION_NAME} 段落；现有：${a.sections.map((s) => s.name).join(', ')}`)
+  const text = renderPrompt(a)
+  // ⚠️ 断言用**正文里真有的串**，不用分类的**显示名** ——
+  //   `懒人梯子` 只是分类的 title，它的 body 开头是「梯子：停在第一个成立的档」。
+  //   我原先断言 '懒人梯子'，而那个串**只存在于旧标题**里 ⇒
+  //   2026-09-29 把标题改成 `[准则 v5]` 后，这断言红了 —— 它一直在测标题，
+  //   从来没测过正文。判据钉错了东西，改成钉正文里稳定的片段。
+  assert.ok(text.includes('停在第一个成立的档'), '最终 prompt 文本里没有准则正文')
+  assert.ok(text.includes('准则 v5'), '标题不在（拆分时最容易丢的就是它）')
+})
+
+test('★ 关掉某条分类 ⇒ 装配结果里那条真的不在', async () => {
+  const a = await assemble({ data: { categories: { structure: false } } })
+  const text = renderPrompt(a)
+  const body = PROMPT_CATEGORIES.find((c) => c.id === 'structure')!.body
+  assert.equal(text.includes(body), false, `「结构」关了却仍在 prompt 里：${body.slice(0, 20)}`)
+  // 反向：没关的必须在
+  const keep = PROMPT_CATEGORIES.find((c) => c.id === 'delivery')!.body
+  assert.ok(text.includes(keep), '没关的分类被误删了')
+})
+
+test('★ 总开关关 ⇒ 整个段落被丢弃（空文本不产出任何内容）', async () => {
+  const a = await assemble({ masterOn: false })
+  const mine = a.sections.find((s) => s.name === PROMPT_SECTION_NAME)
+  // 平台对空 section 的处理是「不产出文本」——断言**文本**里没有，而不是
+  // 「section 不存在」：section 仍注册着，只是 text 为空。
+  assert.equal(renderPrompt(a).includes('懒人梯子'), false, '总开关关了准则还在')
+  void mine
+})
+
+test('装配结果与 renderPromptText 的内容一致（渲染逻辑只有一处实现）', async () => {
+  const a = await assemble()
+  const text = renderPrompt(a)
+  const expected = renderPromptText(true, undefined)
+  assert.ok(text.includes(expected), '装配结果里找不到 renderPromptText 的输出 ⇒ 两处实现漂移了')
+})