dsh-router-core 0.4.7 → 0.4.9

package/src/client/router.css

@@ -1900,9 +1900,16 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     cursor: default;
 }
 
-.dshr-modelChipId {
+/* 主标签 = 上游的可读名（缺省回落成 key），正文字号；key 用等宽淡字跟在后面，
+   两者相同时不渲染 key（判据见 model-label.ts） */
+.dshr-modelChipName {
+    font-size: 12px;
+}
+
+.dshr-modelChipKey {
     font-family: var(--rs-mono);
-    font-size: 11px;
+    font-size: 10px;
+    color: var(--rs-faint);
 }
 
 .dshr-modelChipCtx {
@@ -2047,61 +2054,6 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     opacity: 1;
 }
 
-/* 旧 .dshr-modelChip 独立样式（disabled 区仍用） */
-.dshr-modelChip {
-    display: inline-flex;
-    align-items: center;
-    gap: 6px;
-    padding: 6px 10px;
-    border: 1px solid var(--rs-line);
-    border-radius: 8px;
-    color: var(--rs-text);
-    background: var(--rs-layer-1);
-    font-size: 12px;
-    cursor: pointer;
-    transition:
-        border-color 0.12s ease,
-        background 0.12s ease,
-        color 0.12s ease;
-}
-
-.dshr-modelChip:hover {
-    border-color: var(--rs-accent);
-    background: color-mix(in srgb, var(--rs-accent) 6%, transparent);
-}
-
-.dshr-modelChip:disabled {
-    opacity: 0.6;
-    cursor: default;
-}
-
-.dshr-modelChipId {
-    font-family: var(--rs-mono);
-    font-size: 11px;
-}
-
-.dshr-modelChipCtx {
-    flex: none;
-    color: var(--rs-faint);
-    font-size: 10px;
-}
-
-.dshr-modelChip-off {
-    border-style: dashed;
-    color: var(--rs-faint);
-    opacity: 0.8;
-}
-
-.dshr-modelChip-off:hover {
-    color: var(--rs-accent);
-    border-color: var(--rs-accent);
-}
-
-.dshr-modelChipRestore {
-    color: var(--rs-accent);
-    font-size: 10px;
-}
-
 /* 计数徽标跟在标题/操作按钮右侧（模型卡片） */
 .dshr-cardMetaAfter {
     margin-left: 0;
@@ -2484,9 +2436,20 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
 }
 
 .dshr-comboPickName {
-    flex: 1;
+    flex: 0 1 auto;
     min-width: 0;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+
+/* 挑选项里的上游 key：可读名之后的小号等宽淡字，两者相同时不渲染 */
+.dshr-comboPickKey {
+    flex: none;
+    margin-left: auto;
     font-family: var(--rs-mono);
+    font-size: 10px;
+    color: var(--rs-faint);
     overflow: hidden;
     text-overflow: ellipsis;
     white-space: nowrap;
@@ -3456,9 +3419,9 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
 }
 
 /* 标题 + 「修改」按钮的**同一行**（`ExtDetail` 的子开关区）。
-   ⚠️ 单独一个类而不改 `.dshr-compRowName`：那个类 `RouterComponentsSection` /
-   `ExtTestPanel` 也在用，给它加 `display:flex` 会把**那些页面的标题**也变成
-   flex 盒子（它们标题后面没有按钮，平白多一层）。
+   ⚠️ 单独一个类而不改 `.dshr-compRowName`：那个类 `RouterComponentsSection`
+   也在用，给它加 `display:flex` 会把**那一页的标题**也变成
+   flex 盒子（那边标题后面没有按钮，平白多一层）。
    没有这层时按钮会掉到**下一行**：`.dshr-compRowMain` 是 column，而
    `.dshr-compRowName` 是行内元素、标题一长就折行（2026-09-29 用户报）。 */
 /* 子开关区：`.dshr-compGroup` 的 `gap: 12px` 覆盖为 0（2026-09-30 用户要求）。
@@ -3512,354 +3475,3 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
        缩进那种「引用块」的额外装饰（用户要求），层级只靠颜色就够。 */
     white-space: pre-wrap;
 }
-
-/* ============================================================
-   dsh-router — 插件自检面板（设置 → 路由 → 扩展 → 插件自检）
-   ------------------------------------------------------------
-   这一页渲染在**宿主的插件页**里，DOM 祖先既不是 .dshr-settings 也不是
-   .dshr-shell，所以文件顶部那套 `--rs-*` 主题变量在这里**不存在**（未定义的
-   var() 会让整条声明失效：边框/文字色退成继承值）。
-
-   所以这里**不用**设置页那套组件样式，直接按宿主页面的视觉语言写，用宿主的
-   `--dsw-alias-*` token：几何对齐它（14px 小标题、12px 次要文字、0.5px 描边、
-   12px 圆角），配色也从同一套 token 取 —— 于是这块面板看起来就是原生的一部分。
-   主按钮不用在这里画：交给宿主的 Button 原语（见 env.d.ts），配色由原语自己的
-   token 家族决定，不必猜「主色底上配什么字色」。
-   ============================================================ */
-
-.dshr-comp {
-    gap: 16px;
-}
-
-.dshr-compIntro {
-    margin: 0;
-    color: var(--dsw-alias-label-secondary);
-    font-size: 13px;
-    line-height: 20px;
-}
-
-/* 三栏收进同一块面板，读起来是「一组控件」而不是三个飘着的输入框。
-   窄了换行（详情区宽度随窗口变，写死三列会在窄窗口挤成一团）。 */
-.dshr-compForm {
-    display: grid;
-    grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
-    gap: 14px 16px;
-    padding: 14px 16px;
-    border: 0.5px solid var(--dsw-alias-border-l1);
-    border-radius: 12px;
-    background: var(--dsw-alias-bg-layer-1);
-}
-
-.dshr-compField {
-    display: flex;
-    flex-direction: column;
-    gap: 6px;
-    min-width: 0;
-}
-
-.dshr-compFieldHead {
-    display: flex;
-    align-items: baseline;
-    justify-content: space-between;
-    gap: 8px;
-}
-
-.dshr-compFieldLabel {
-    color: var(--dsw-alias-label-primary);
-    font-size: 12px;
-    font-weight: 500;
-    line-height: 18px;
-}
-
-/* 标题右侧的用法要点。语义放这里比塞进顶部那段长文字更容易被读到 ——
-   「模型只列可用的」「连接留空 = 池内任选」都是用这一栏时才关心的。 */
-.dshr-compFieldNote {
-    color: var(--dsw-alias-label-tertiary);
-    font-size: 12px;
-    line-height: 18px;
-    text-align: right;
-}
-
-/* 36px / 12px 圆角，与宿主 Button 原语的 md 尺寸对齐。 */
-.dshr-compSelect {
-    width: 100%;
-    height: 36px;
-    padding: 0 32px 0 11px;
-    appearance: none;
-    border: 0.5px solid var(--dsw-alias-border-l2);
-    border-radius: 12px;
-    background-color: var(--dsw-alias-bg-layer-2);
-    background-image:
-        linear-gradient(45deg, transparent 50%, var(--dsw-alias-label-tertiary) 50%),
-        linear-gradient(135deg, var(--dsw-alias-label-tertiary) 50%, transparent 50%);
-    background-position:
-        calc(100% - 17px) 16px,
-        calc(100% - 12px) 16px;
-    background-size: 5px 5px;
-    background-repeat: no-repeat;
-    color: var(--dsw-alias-label-primary);
-    font: inherit;
-    font-size: 13px;
-    line-height: 18px;
-    text-overflow: ellipsis;
-    cursor: pointer;
-}
-
-.dshr-compSelect:hover:not(:disabled) {
-    border-color: var(--dsw-alias-border-l3);
-}
-
-.dshr-compSelect:focus {
-    outline: none;
-    border-color: var(--dsw-alias-brand-primary);
-    box-shadow: 0 0 0 3px color-mix(in srgb, var(--dsw-alias-brand-primary) 22%, transparent);
-}
-
-.dshr-compSelect:disabled {
-    border-color: var(--dsw-alias-border-l1);
-    background-color: var(--dsw-alias-bg-layer-1);
-    color: var(--dsw-alias-label-tertiary);
-    cursor: not-allowed;
-}
-
-/* 动作行：把按钮与它旁边的提示排在一条基线上。两个动作行（访问测试 / 契约体检）
-   共用 `dshr-compBtnRow` —— 那条抬特异性的字色规则就挂在它上面（见下）。 */
-.dshr-compActions {
-    display: flex;
-    align-items: center;
-    gap: 12px;
-}
-
-.dshr-compHint {
-    color: var(--dsw-alias-label-tertiary);
-    font-size: 12px;
-    line-height: 18px;
-}
-
-/* 结果区：成功/失败/请求失败 三种语气。底下垫一层极淡的状态色，比只有一行
-   彩色文字更容易扫到 —— 自检的结果是这一页唯一重要的信息。 */
-.dshr-compNotice {
-    display: flex;
-    gap: 10px;
-    padding: 12px 14px;
-    border: 0.5px solid var(--dsw-alias-border-l1);
-    border-radius: 12px;
-    background: var(--dsw-alias-bg-layer-1);
-}
-
-.dshr-compNotice[data-tone="ok"] {
-    border-color: color-mix(in srgb, var(--dsw-alias-state-success-primary) 34%, transparent);
-    background: color-mix(in srgb, var(--dsw-alias-state-success-primary) 8%, transparent);
-}
-
-.dshr-compNotice[data-tone="fail"],
-.dshr-compNotice[data-tone="network"] {
-    border-color: color-mix(in srgb, var(--dsw-alias-state-error-primary) 34%, transparent);
-    background: color-mix(in srgb, var(--dsw-alias-state-error-primary) 8%, transparent);
-}
-
-.dshr-compNoticeIcon {
-    flex: none;
-    width: 16px;
-    height: 16px;
-    margin-top: 2px;
-    color: var(--dsw-alias-state-success-secondary);
-}
-
-.dshr-compNotice[data-tone="fail"] .dshr-compNoticeIcon,
-.dshr-compNotice[data-tone="network"] .dshr-compNoticeIcon {
-    color: var(--dsw-alias-state-error-primary);
-}
-
-.dshr-compNoticeBody {
-    display: flex;
-    flex-direction: column;
-    gap: 2px;
-    min-width: 0;
-}
-
-.dshr-compNoticeTitle {
-    color: var(--dsw-alias-label-primary);
-    font-size: 13px;
-    font-weight: 500;
-    line-height: 20px;
-}
-
-.dshr-compNoticeText {
-    color: var(--dsw-alias-label-secondary);
-    font-size: 12.5px;
-    line-height: 19px;
-    /* 上游可能回一整段 HTML/JSON，限定宽度换行，别把布局撑破 */
-    overflow-wrap: anywhere;
-}
-
-/* 回显测的是哪三样。一条「通过」如果不带对象，就是没法归因的一串绿字。 */
-.dshr-compNoticeMeta {
-    color: var(--dsw-alias-label-tertiary);
-    font-size: 12px;
-    line-height: 18px;
-    overflow-wrap: anywhere;
-}
-
-/* 宿主 Button 原语的 primary 想把字色设成 --dsw-alias-label-primary-foreground，
-   但上面那条兜底 `.dshr-settings button { color: inherit; font: inherit }`
-   特异性 (1,1) **高于**原语的 `.primary` (1,0) —— 赢的是它。于是按钮变成
-   「#0f1115 的底 + 继承来的 #0f1115 的字」，黑底黑字、按钮看着是空的。
-
-   按本文件既有的抬特异性办法修（见文件里 .dshr-tab-on / .dshr-period 那几处注释：
-   凡是受这条兜底影响的规则，都必须带挂载容器抬到 (2,0) 以上）。这里
-   `.dshr-comp .dshr-compBtnRow button` 是 (2,1)，不依赖源码顺序，以后有人挪块也不会翻车。
-
-   作用域挂在**动作行的共用类 `dshr-compBtnRow`** 上，不是某个具体容器：上一版这条
-   只写了 `.dshr-compActions`，随后新增的「契约体检」按钮在另一个容器里，于是又变回
-   黑底黑字。现在两个动作行共用这个类，再加按钮只需沿用它。
-
-   修的是**把原语的意图还回去**，不是自己另挑一个颜色：字色仍由原语那个 token 决定。 */
-.dshr-comp .dshr-compBtnRow button {
-    color: var(--dsw-alias-label-primary-foreground);
-    font-size: 14px;
-    line-height: 22px;
-}
-
-/* --- 契约体检区（插件自检面板的第二块） ---
-   状态靠 data-state 上色，和「结果卡」那套语气一致：过了是绿、失败是红、
-   没实现是灰、不执行是中性（它是**故意**不跑的，不是问题）。 */
-
-.dshr-compSection {
-    display: flex;
-    flex-direction: column;
-    gap: 12px;
-    margin-top: 4px;
-    padding-top: 16px;
-    border-top: 0.5px solid var(--dsw-alias-border-l1);
-}
-
-.dshr-compHead {
-    display: flex;
-    align-items: baseline;
-    justify-content: space-between;
-    gap: 8px;
-}
-
-.dshr-compSectionTitle {
-    margin: 0;
-    color: var(--dsw-alias-label-primary);
-    font-size: 14px;
-    font-weight: 500;
-    line-height: 20px;
-}
-
-.dshr-compSectionNote {
-    color: var(--dsw-alias-label-tertiary);
-    font-size: 12px;
-    line-height: 18px;
-}
-
-.dshr-compProbeRow {
-    display: flex;
-    align-items: flex-end;
-    gap: 12px;
-}
-
-.dshr-compProbeRow .dshr-compField {
-    flex: 1;
-}
-
-.dshr-compProbeBtn {
-    flex: none;
-}
-
-.dshr-compReport {
-    display: flex;
-    flex-direction: column;
-    gap: 8px;
-    padding: 12px 14px;
-    border: 0.5px solid var(--dsw-alias-border-l1);
-    border-radius: 12px;
-    background: var(--dsw-alias-bg-layer-1);
-}
-
-.dshr-compReportHead {
-    display: flex;
-    align-items: baseline;
-    justify-content: space-between;
-    gap: 10px;
-    flex-wrap: wrap;
-}
-
-.dshr-compReportName {
-    color: var(--dsw-alias-label-primary);
-    font-size: 13px;
-    font-weight: 500;
-    line-height: 20px;
-}
-
-.dshr-compReportSum {
-    color: var(--dsw-alias-label-tertiary);
-    font-size: 12px;
-    line-height: 18px;
-}
-
-.dshr-compMembers {
-    display: flex;
-    flex-direction: column;
-    margin: 0;
-    padding: 0;
-    list-style: none;
-}
-
-.dshr-compMember {
-    display: grid;
-    grid-template-columns: 16px minmax(0, auto) minmax(0, 1fr);
-    align-items: baseline;
-    gap: 10px;
-    padding: 5px 0;
-    border-bottom: 0.5px solid var(--dsw-alias-border-l1);
-}
-
-.dshr-compMember:last-child {
-    border-bottom: 0;
-}
-
-.dshr-compMemberState {
-    flex: none;
-    text-align: center;
-    font-size: 12px;
-    line-height: 18px;
-}
-
-.dshr-compMember[data-state="ok"] .dshr-compMemberState {
-    color: var(--dsw-alias-state-success-secondary);
-}
-
-.dshr-compMember[data-state="fail"] .dshr-compMemberState {
-    color: var(--dsw-alias-state-error-primary);
-}
-
-.dshr-compMember[data-state="absent"] .dshr-compMemberState,
-.dshr-compMember[data-state="skipped"] .dshr-compMemberState {
-    color: var(--dsw-alias-label-tertiary);
-}
-
-.dshr-compMemberName {
-    color: var(--dsw-alias-label-primary);
-    font-size: 12.5px;
-    line-height: 19px;
-    white-space: nowrap;
-}
-
-.dshr-compMemberKey {
-    margin-left: 6px;
-    color: var(--dsw-alias-label-tertiary);
-    font-family: var(--dsw-font-mono, ui-monospace, SFMono-Regular, Menlo, monospace);
-    font-size: 11px;
-}
-
-.dshr-compMemberDetail {
-    color: var(--dsw-alias-label-secondary);
-    font-size: 12px;
-    line-height: 18px;
-    overflow-wrap: anywhere;
-}
-
-

package/src/ext/contract.ts

@@ -182,7 +182,7 @@ export interface ExtControl {
   /**
    * 分组名（可选；缺省 = 无组）—— 面板按它把控制条**分节**渲染，组间插一条
    * 组标题行，组内顺序照旧。**无组的条目照旧平铺** ⇒ 没用这个字段的扩展
-   * （ext-test 等）面板行为一个像素都不变。
+   * 面板行为一个像素都不变。
    *
    * 为什么要有：一条扩展同时管两类东西时（分层提示词 = 准则分类 + 宿主段落），
    * 平铺成一长列会让"哪条是准则、哪条是宿主的段"无从分辨 —— 分组是**归属

package/src/ext-prompt/content.ts

@@ -26,6 +26,17 @@
  *      `categories`/`text`/`order` 里残留的 `hardening` 键无须迁移 ——
  *      `resolveCategories` 规则 2 会忽略不认识的 id。
  *   ② 身份气质：「默认中文」→「回复、思考过程必须使用中文」。
+ *
+ * ⚠️ 2026-10-27 用户点名的四处改动：
+ *   ① **删掉「可判定」分类**（整条移除，id `verdifiable`）；已存配置里的残留键
+ *      由 `resolveCategories` 忽略，无须迁移。
+ *   ② **删掉「绝不偷懒」分类**（整条移除，id `no-cheap`）——用户判定它与别处重复。
+ *   ③ 执行顺序重写：去掉「查结构行号 / 声明任务四件套 / 读码取切片 / 循既有骨架 /
+ *      以闸门为准」几段，改为「循既有架构/提出更优架构 → 验证以测试/e2e 验收」；
+ *      并在首尾补上「读文档」与「更新文档」—— 任务不是从零开始，也不以提交收尾。
+ *   ④ **新增「文档」分类**（id `doc`）：用户口述「文档不写流水账、只写权威内容」
+ *      + 点名范围「docs/ 下的调研、设计、任务」，本文件只做润色。
+ *      排在「全局收口」之后 —— 收口查"文档过期没有"，这条管"文档该写什么"。
  */
 
 /** 一个可独立开关的提示词分类。 */
@@ -87,11 +98,12 @@ export const PROMPT_CATEGORIES: readonly PromptCategory[] = [
       '做完那块区域该比动手前更整或更少。',
   },
   {
-    id: 'verdifiable',
-    title: '可判定',
+    id: 'doc',
+    title: '文档',
     defaultOn: true,
     body:
-      '可判定：只有清单和会变红的闸门生效，形容词不生效。新约束一律写成"动作+闸门"。',
+      '文档：docs/ 里的调研/设计/任务文档，只写权威内容——结论、约束、怎么用；' +
+      '不写流水账(过程、试错、时间线)，历史归 git。',
   },
   {
     id: 'root-cause',
@@ -123,13 +135,6 @@ export const PROMPT_CATEGORIES: readonly PromptCategory[] = [
       '结构：先让结构对再让代码短；命名/边界/单一职责优先于行数；依赖单向无环、公共逻辑收敛一处；' +
       '单文件单功能，软顶函数 ~40 行/文件 ~300 行。',
   },
-  {
-    id: 'no-cheap',
-    title: '绝不偷懒',
-    defaultOn: true,
-    body:
-      '绝不偷懒：边界输入校验、防数据丢失、安全、可访问性、真实硬件校准；非平凡逻辑留个能跑的检查。',
-  },
   {
     id: 'delivery',
     title: '交付',
@@ -143,8 +148,8 @@ export const PROMPT_CATEGORIES: readonly PromptCategory[] = [
     title: '执行顺序',
     defaultOn: true,
     body:
-      '执行：拉记忆→看全貌→建领地→定位任务→查结构行号→声明「任务/文件/验证/提交」→读码取切片→' +
-      '循既有骨架→验证以闸门为准(混合状态下的绿灯不作数)→收口复查全貌→提交。',
+      '执行：拉记忆→读文档→看全貌→定位任务→建领地→循既有架构/提出更优架构→验证以测试/e2e 验收→' +
+      '收口复查全貌→更新文档→提交。',
   },
 ] as const
 

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

@@ -3,7 +3,7 @@
  *   1. 登记进 `router.ext` 表，带上可显示的身份（名字/说明/就绪）；
  *   2. **幂等**：同一个 id 已在表里就不顶掉别人的登记；
  *   3. `source: 'builtin'`（随核心分发 ⇒ 插件页的原生行，自绘节不重复列）；
- *   4. **准则段落真的挂上了** —— ext-test 没有这一条，本扩展多做执行面，必须验。
+ *   4. **准则段落真的挂上了** —— 这是本扩展唯一的执行面，必须单独验。
  *
  * 为什么第 4 条不可省：扩展的「卡片出现与否」取决于它在不在这张表里，而**准则
  * 有没有进 prompt** 取决于段落挂没挂 —— 两者是**不同的失效**，都静默且都不报错。
@@ -75,7 +75,7 @@ test('★ patch 里真的声明了这一行，且 id/name 逐字对得上', () =
   assert.equal(block![1], 'dsh-router-core/ext-prompt', 'patch 的 name 必须是能解析的子路径说明符')
 })
 
-test('★ 那一行默认关闭（与 ext-test 同款）', () => {
+test('★ 那一行默认关闭', () => {
   // `disabled: true` = 行默认关 ⇒ loader 不 import ⇒ 扩展不进 `router.ext` 表 ⇒
   // 卡片不出现、准则不进 prompt。
   //
@@ -148,7 +148,7 @@ test('幂等：同一个 id 已在表里时不顶掉别人的登记', async () =
   assert.equal(table[EXT_PROMPT_ID], first, '重复登记不该换成一个新对象')
 })
 
-test('★ apply 把准则挂成了 system prompt 段落（ext-test 没这层，必须单独验）', async () => {
+test('★ apply 把准则挂成了 system prompt 段落', async () => {
   const { ctx, sections } = await realCtx()
   apply(ctx as unknown as Parameters<typeof apply>[0])
   assert.equal(sections.length, 1, '准则没挂上 = 卡片亮着但 prompt 里没有准则')

package/src/ext-prompt/index.ts

@@ -2,14 +2,12 @@
  * 分层提示词扩展的 **cordis 行** —— 官方插件页（设置 → 插件 → dsh-router-core）详情页
  * 原生「包含的组件」里的那一行。
  *
- * 壳的形状与 `ext-test` 同款（cordis 身份 + 登记，实现 = `plugin.ts`），
- * 但**多一件执行面的事**：挂 system prompt 段落。ext-test 不做拦截、只登记；
- * 本扩展要把准则真注入，所以额外等 `systemPrompt` service 就绪后挂 section。
+ * 壳的形状 = cordis 身份 + 登记，实现 = `plugin.ts`；**执行面的事**是挂
+ * system prompt 段落 —— 所以额外等 `systemPrompt` service 就绪后挂 section。
  *
- * **默认开启**（patch 里不带 `disabled`，与三行内置供应商一致）：
- * 协作准则是每次协作都要的基础设施，不是可选增强。与 `ext-test` 的
- * `disabled: true` **刻意不同** —— 自检是「想跑才跑」的工具，准则不是；
- * 让准则默认缺席，会变成「用户不知道它存在 ⇒ 协作按另一套规则执行」。
+ * **默认关闭**（patch 里 `disabled: true`）：开不开由用户决定。行关闭时 loader
+ * 根本不 import 本模块，扩展就不在 `router.ext` 表里 ——「打开才出现这张卡片」
+ * 是天然的，不需要额外状态位。
  *
  * 登记时把扩展开关置为开：本扩展**没有独立的运行期开关**，它的开关就是这一行
  * （宿主管的那个）。不置上的话，用户开了行还要再点一次，两级开关说同一件事。
@@ -52,8 +50,8 @@ function systemPromptOf(sctx: Context): SystemPromptFace | undefined {
  *
  * ⚠️⚠️ **必须导出这个数组，且 `apply` 里直接用 `ctx.systemPrompt`**（2026-09-29 修）
  * ——我原先写成「在 apply 里 `ctx.inject(['systemPrompt'], cb)`」，**准则一直不进
- * prompt**：面板上卡片、开关、原文全都正常（`GET /router/api/ext` 实测有 14 条
- * controls），但模型看到的 system prompt 里没有它。
+ * prompt**：面板上卡片、开关、原文全都正常（`GET /router/api/ext` 里 controls 一条
+ * 不少），但模型看到的 system prompt 里没有它。
  *
  * 根因（本机 cordis 4.0.4 实测）：`ctx.inject(deps, cb)` 的回调**不是同步触发** ——
  * provide 之后立刻 `inject`，回调要等到下一个异步点才跑。插件的 `apply` 是**同步

package/src/ext-prompt/mount.ts

@@ -2,9 +2,9 @@
  * 挂载层 —— 把准则注册成 `ctx.systemPrompt` 的**一个**段落。
  *
  * ════════════════════════════════════════════════════════════════════
- * 为什么只注册一段，而不是 14 段
+ * 为什么只注册一段，而不是一段一个分类
  * ════════════════════════════════════════════════════════════════════
- * 面板开关的粒度是「分类」，但 prompt 读起来应该是一段连续的准则。分成 14 段
+ * 面板开关的粒度是「分类」，但 prompt 读起来应该是一段连续的准则。分成多段
  * 会让 KV cache 每个分类各占一段，且**增删任意一个分类都让它之后的全部分位**。
  * 一段 + 拼装 ⇒ 分类增删只改这一段内部，段的位置与前缀稳定。
  *

package/src/ext-prompt/plugin.ts

@@ -1,16 +1,14 @@
 /**
  * 分层提示词扩展（`router.ext` 侧的实现）—— 声明与状态都在这里。
  *
- * 与 `ext-test`（插件自检）同款：**不挂任何监听、不改写任何东西**，
- * 唯一作用是让用户在官方插件页里看到一张卡片、能开关它，并把协作准则
- * 注册成一段 system prompt。
+ * **不挂任何监听、不改写任何东西**，唯一作用是让用户在官方插件页里看到一张
+ * 卡片、能开关它，并把协作准则注册成一段 system prompt。
  *
  * 与 `rtk` / `jev` 那类扩展的区别要写清楚：那两家挂 `tools/execute`
  * 改写**工具调用**；本扩展只往 **system prompt** 加一段。名字同族是因为
  * 都在 `router.ext` 这张表里，拦截面不重叠。
  *
- * 复用 `router.ext` 通道只为拿到**发现 + 开关**两件事（见 ext-test 的同款说明），
- * 真正的注入在 `mount.ts`。
+ * 复用 `router.ext` 通道只为拿到**发现 + 开关**两件事，真正的注入在 `mount.ts`。
  */
 import type { ExtStoreService, RouterExt } from '../ext/contract.ts'
 import { PROMPT_CATEGORIES, PROMPT_TITLE } from './content.ts'

package/src/router/index.ts

@@ -1043,9 +1043,8 @@ export class Router {
       // 注意这里**刻意不**把「用户禁用过的模型」也补回来：插件的 listModels 只该报
       // 「模型来源」，启用状态由核心合并（见 loader.ts 的 modelsWithEnabled）。
       // 插件若在 listModels 里就把自己禁用的过滤掉，那是它违约 —— 该修的是插件，
-      // 核心不该反过来替它兜着。兜着的后果比表面症状更糟：面板看着正常了，
-      // 而体检的越权检测（probe.ts 的 hiddenDisabledIds）会因为模型已被补全而
-      // 永远报 OK，那个 bug 就再也没人发现了。
+      // 核心不该反过来替它兜着：兜着之后面板看着正常了，插件那个 bug 就再也没人
+      // 发现了（症状消失、原因还在）。少报就让它少报，用户看得见才好去修插件。
       const seen = new Set(models.map((mm) => mm.id))
       for (const id of custom) {
         if (!seen.has(id)) {