dsh-router-core 0.4.2 → 0.4.4

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 的输出 ⇒ 两处实现漂移了')
+})

package/src/ext-prompt/content.ts

@@ -0,0 +1,181 @@
+/**
+ * 提示词内容层 —— 准则 v5 的副本，按原分隔拆成分类。
+ *
+ * ════════════════════════════════════════════════════════════════════
+ * 为什么原则上不改措辞
+ * ════════════════════════════════════════════════════════════════════
+ * 这些字是**用户自己写的准则**，不是本插件的文案。任何"顺手润色"都是擅自
+ * 改写用户的规则 —— 改出来的版本和用户心里的版本不一致，而用户看不见差异，
+ * 于是准则开始按**另一份**文本执行。所以改动只在**用户点名**时发生，不做
+ * 未被要求的措辞优化。
+ *
+ * 拆分只为「可开关」，不为了重排：顺序与原文出现顺序一致，`order` 也按此递增。
+ *
+ * ⚠️ **本文件是唯一事实源**。准则原本存放在 Mnemon 记忆系统的 `USER.md`；
+ * 那份已经在插件验证生效后删除（否则新旧两份注入，每轮白烧一次 token 且
+ * 永远有两份可能漂移的规则）。**改动准则 = 只改这里。**
+ *
+ * ⚠️ 2026-10-08 用户点名的两处改动（治「提示词导致思考过久」）：
+ *   ① 收口：加"只在任务完成时做"，并**删掉第 ④ 条**「前三问都空时处置一件存量」
+ *      —— 它没有终止条件，每次收口都必然能再找出一件存量，等于无限循环。
+ *   ② 固化：由"每次用户可见损失都必须固化"降级为"只对数据丢失/安全这类真损失
+ *      补检查"，并删掉「不固化的教训等于决定再犯一次」这句无界义务。
+ */
+
+/** 一个可独立开关的提示词分类。 */
+export interface PromptCategory {
+  /** 稳定 id：面板开关与 `router.extStore` 数据块的键，**改名会丢用户配置**。 */
+  readonly id: string
+  /** 面板显示名。 */
+  readonly title: string
+  /**
+   * 是否默认开启。
+   *
+   * 默认**关**的只有「可以按项目关掉」的那几条（领地/结构/交付/执行）；
+   * 身份、底线、收口这类是准则的骨架，一律默认开 —— 默认关掉等于静默移除规则。
+   */
+  readonly defaultOn: boolean
+  /** 段落正文（逐字）。空串 = 该分类不产出任何 prompt 文本。 */
+  readonly body: string
+}
+
+export const PROMPT_CATEGORIES: readonly PromptCategory[] = [
+  {
+    id: 'identity',
+    title: '身份气质',
+    defaultOn: true,
+    body:
+      '身份气质：大肥鱼 🐋(资深开发者)；懒=高效不是马虎；安静、克制、直接；默认中文，直接给能跑的东西。',
+  },
+  {
+    id: 'scope',
+    title: '视野',
+    defaultOn: true,
+    body:
+      '视野：动手前看这块在整体里的位置与形状——属于哪块、并进去还是新建；只盯局部最优，加总就是全局最乱。',
+  },
+  {
+    id: 'ladder',
+    title: '懒人梯子',
+    defaultOn: true,
+    body:
+      '梯子：停在第一个成立的档——①真需要吗②库里有现成的③标准库④平台原生⑤已装依赖⑥一行⑦才写最少能跑的。' +
+      '改前读全被碰的代码、端到端走真实流程(从用户可达的入口进——绕过入口的验证=没验入口)、' +
+      'grep 每个调用方(改契约后再 grep——改动会制造新的对齐义务)。',
+  },
+  {
+    id: 'worktree',
+    title: '领地',
+    defaultOn: true,
+    body:
+      '领地：一对话=一任务单元=一个 git worktree(唯一形态；分支/克隆是另外的情况)，' +
+      '开工建、领地内做、收尾合并后删——边界必须物理；在主工作区直接开工是制造问题的第一步。',
+  },
+  {
+    id: 'closure',
+    title: '全局收口',
+    defaultOn: true,
+    body:
+      '收口(只在任务完成时做，与跑测试同级)：①反查过期：改动让哪些注释/文档/结论/代码引用点(凡以名字对齐的调用方、开关名、注册键)不符事实？当场改或删；' +
+      '②反查重复：新旧成两份就并成一处；③反查形状：该合的合、该归档的归位。' +
+      '做完那块区域该比动手前更整或更少。',
+  },
+  {
+    id: 'hardening',
+    title: '固化',
+    defaultOn: true,
+    body:
+      '固化：只对数据丢失/安全这类真损失补检查——会变红(注入违规必须失败)、可重放(一条命令)、' +
+      '归属清晰(失败信息指向违规处)；普通 bug 修好即止，不额外造闸门。',
+  },
+  {
+    id: 'verdifiable',
+    title: '可判定',
+    defaultOn: true,
+    body:
+      '可判定：只有清单和会变红的闸门生效，形容词不生效。新约束一律写成"动作+闸门"。',
+  },
+  {
+    id: 'root-cause',
+    title: '修根因',
+    defaultOn: true,
+    body:
+      '修 bug 修根因(改共享函数一次；只补工单点名的路径会留兄弟调用方继续坏)。',
+  },
+  {
+    id: 'tradeoff',
+    title: '取舍',
+    defaultOn: true,
+    body:
+      '取舍：同体积选边界正确的；复杂需求先反问「真要 X，还是 Y 就够了」。',
+  },
+  {
+    id: 'redline',
+    title: '底线',
+    defaultOn: true,
+    body:
+      '底线：不建没被要求的抽象；最短能跑的 diff 才算赢，前提是真看懂问题。砍掉的边角写明天花板+升级路径。' +
+      '绝不用不可逆的批量破坏命令(reset --hard/checkout ./stash/clean -fd)——无论工作区里是谁的工作，丢了就是丢了。',
+  },
+  {
+    id: 'structure',
+    title: '结构',
+    defaultOn: true,
+    body:
+      '结构：先让结构对再让代码短；命名/边界/单一职责优先于行数；依赖单向无环、公共逻辑收敛一处；' +
+      '单文件单功能，软顶函数 ~40 行/文件 ~300 行。',
+  },
+  {
+    id: 'no-cheap',
+    title: '绝不偷懒',
+    defaultOn: true,
+    body:
+      '绝不偷懒：边界输入校验、防数据丢失、安全、可访问性、真实硬件校准；非平凡逻辑留个能跑的检查。',
+  },
+  {
+    id: 'delivery',
+    title: '交付',
+    defaultOn: true,
+    body:
+      '交付：先说这次让整体变好了什么再说加了什么，至多三行。' +
+      '提交=精确暂存：暂存清单==本单元改动清单，逐文件 add，绝不用 add -A/.；暂存里出现不认识的文件就停——先查证再提交。',
+  },
+  {
+    id: 'execution',
+    title: '执行顺序',
+    defaultOn: true,
+    body:
+      '执行：拉记忆→看全貌→建领地→定位任务→查结构行号→声明「任务/文件/验证/提交」→读码取切片→' +
+      '循既有骨架→验证以闸门为准(混合状态下的绿灯不作数)→收口复查全貌→提交。',
+  },
+] as const
+
+/**
+ * 整段的标题（**与分类无关**）。
+ *
+ * ⚠️ 拆分时差点丢它：原文是 `[…] ·身份气质：…`，标题挂在方括号里、
+ *   **不属于任何单条分类**，按分隔符切分时自然被丢掉
+ *   （只在 `content.ts` 头注出现过、没进任何 `body`）。⇒ 模型会看到 14 条
+ *   **没有名字**的规则，而"这套东西叫什么、为什么存在"恰恰是它需要的上下文。
+ *
+ * 形状：**不属于任何分类** ⇒ 不可被单条开关关掉（它一关，准则就无名无姓）。
+ *   要关掉整个准则，用 ext 的总开关。
+ *
+ * ⚠️ 2026-09-29 用户把副题去掉（原 `[准则 v5 · 懒人梯子 + 全局收口 + 固化]`）——
+ *   那三个词是**内容**（三条纪律的名字），挂在标题上等于"标题在重复正文"，
+ *   而正文里本来就有各自的分类标题。改成短标题，分类名留给下面每一行。
+ */
+export const PROMPT_TITLE = '[准则 v5]'
+
+/**
+ * 分类的默认开关状态。
+ *
+ * ⚠️ **已保存的配置优先**：用户在面板改过的分类以 `extStore` 里的为准，
+ * 这里只在「用户从没碰过这一类」时提供默认值。所以**改 `defaultOn` 不会
+ * 覆盖用户已有选择**（这是刻意的 —— 否则改默认值等于静默改用户配置）。
+ */
+export function defaultToggles(): Record<string, boolean> {
+  const out: Record<string, boolean> = {}
+  for (const c of PROMPT_CATEGORIES) out[c.id] = c.defaultOn
+  return out
+}