dsh-router-core 0.4.0 → 0.4.2

package/src/client/router.css

@@ -544,6 +544,14 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     font-size: 13px;
 }
 
+/* 两行空状态（标题 + 说明）。`.dshr-empty` 本身是横排的单行 flex，直接套两行
+   div 会左右排开，所以另给一个纵向堆叠的变体。 */
+.dshr-emptyStack {
+    flex-direction: column;
+    gap: 6px;
+    text-align: center;
+}
+
 /* Accounts table */
 .dshr-tableWrap {
     overflow: auto;
@@ -1025,11 +1033,6 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     font-size: 11px;
 }
 
-/* 扩展详情头部右侧的开关（顶到标题行右边，同供应商详情的编辑按钮位） */
-.dshr-extDetailToggle {
-    margin-left: auto;
-}
-
 /* 扩展卡片内容区：文字左对齐，左侧留白与标题行的图标位对齐 */
 .dshr-extBody {
     padding: 10px 14px 12px 48px;
@@ -2392,7 +2395,7 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     display: flex;
     flex-direction: column;
     gap: 6px;
-    max-height: 260px;
+    max-height: 380px;
     overflow-y: auto;
 }
 
@@ -2502,7 +2505,7 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     display: flex;
     flex-direction: column;
     gap: 2px;
-    max-height: 180px;
+    max-height: 300px;
     overflow-y: auto;
 }
 
@@ -2575,7 +2578,7 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     flex-direction: column;
     gap: 6px;
     min-width: 0;
-    max-height: 340px;
+    max-height: 460px;
 }
 
 .dshr-comboFormRight .dshr-comboPickList {
@@ -2583,9 +2586,14 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     min-height: 0;
 }
 
-/* 组合编辑弹窗：加宽 */
+/* 组合编辑弹窗：加宽加高（body 更高，内部列表同步放大） */
 .dshr-modal-wide {
     width: min(760px, 100%);
+    max-height: min(90vh, 820px);
+}
+
+.dshr-modal-wide .dshr-modalBody {
+    min-height: 560px;
 }
 
 /* 左右分栏之间的分割线 */
@@ -3293,3 +3301,476 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     text-overflow: ellipsis;
     white-space: nowrap;
 }
+
+/* ============================================================
+   dsh-router — 官方插件页「路由组件」一节
+   ------------------------------------------------------------
+   尺寸与配色照抄宿主 plugin-manager 的 detailSection/rows/row
+   （14px 500 小标题、40px 圆角图标行、12px 行距），让这一节看起来
+   就是原生列表的一部分。
+
+   注意：--rs-* 变量只定义在 .dshr-settings / .dshr-shell 上，而这一节
+   渲染在**插件页**里（两者的 DOM 祖先不同），所以这里直接用宿主的
+   --dsw-alias-* 原始变量，不走中间层。
+   ============================================================ */
+
+.dshr-comp {
+    display: flex;
+    flex-direction: column;
+    gap: 28px;
+    min-width: 0;
+}
+
+.dshr-compError {
+    margin: 0;
+    color: var(--dsw-alias-state-error-primary);
+    font-size: 12px;
+    line-height: 18px;
+}
+
+.dshr-compGroup {
+    display: flex;
+    flex-direction: column;
+    gap: 12px;
+    min-width: 0;
+}
+
+.dshr-compHead {
+    display: flex;
+    align-items: baseline;
+    gap: 10px;
+}
+
+.dshr-compTitle {
+    margin: 0;
+    font-size: 14px;
+    font-weight: 500;
+    line-height: 20px;
+}
+
+.dshr-compCount {
+    color: var(--dsw-alias-label-secondary);
+    font-size: 12px;
+    line-height: 18px;
+}
+
+.dshr-compHint {
+    margin: -4px 0 0;
+    color: var(--dsw-alias-label-tertiary);
+    font-size: 12px;
+    line-height: 18px;
+}
+
+.dshr-compRows {
+    display: flex;
+    flex-direction: column;
+    margin: 0;
+    padding: 0;
+    list-style: none;
+}
+
+.dshr-compRow {
+    display: flex;
+    align-items: center;
+    gap: 16px;
+    min-width: 0;
+    border-bottom: 0.5px solid var(--dsw-alias-border-l2);
+    padding: 12px 2px;
+}
+
+.dshr-compRow:last-child {
+    border-bottom: 0;
+}
+
+.dshr-compRowIcon {
+    display: inline-flex;
+    flex: none;
+    align-items: center;
+    justify-content: center;
+    width: 40px;
+    height: 40px;
+    border: 0.5px solid var(--dsw-alias-border-l3);
+    border-radius: 10px;
+    color: var(--dsw-alias-label-tertiary);
+    overflow: hidden;
+}
+
+.dshr-compRowIcon img {
+    width: 100%;
+    height: 100%;
+    object-fit: contain;
+}
+
+.dshr-compRowMain {
+    display: flex;
+    flex: 1;
+    flex-direction: column;
+    gap: 2px;
+    min-width: 0;
+}
+
+.dshr-compRowName {
+    color: var(--dsw-alias-label-primary);
+    font-size: 13.5px;
+    font-weight: 500;
+    line-height: 20px;
+    overflow-wrap: anywhere;
+}
+
+.dshr-compRowState {
+    color: var(--dsw-alias-label-tertiary);
+    font-size: 11.5px;
+    line-height: 16px;
+    overflow-wrap: anywhere;
+}
+
+/* ============================================================
+   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/client/supplier-visibility.test.ts

@@ -0,0 +1,57 @@
+/**
+ * 面板供应商可见性判据测试 —— 锁住三件事：
+ *   1. 关掉的卡片不出现（与扩展页同一形状）
+ *   2. 缺 `enabled` 按开着读（老核心没这个字段，不能让它们集体消失）
+ *   3. 空状态分「没装」与「全关掉」两种（装了却说暂无 = 说假话）
+ */
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { supplierVisibility, type SupplierSummary } from './supplier-visibility.ts'
+
+const s = (id: string, source: SupplierSummary['source'], enabled?: boolean): SupplierSummary => ({
+  id,
+  name: id,
+  ...(source === undefined ? {} : { source }),
+  ...(enabled === undefined ? {} : { enabled }),
+})
+
+test('关掉的供应商不出现在面板（卡片不出现）', () => {
+  const v = supplierVisibility([
+    s('codebuddy', 'external', true),
+    s('traework', 'external', false),
+    s('opencode', 'builtin', false),
+  ])
+  assert.deepEqual(v.external.map((x) => x.id), ['codebuddy'])
+  assert.deepEqual(v.builtin, [])
+  assert.equal(v.hidden, 2)
+})
+
+test('缺 enabled 按开着读 —— 老核心没有这个字段，不能让供应商集体消失', () => {
+  const v = supplierVisibility([s('codebuddy', 'external'), s('opencode', 'builtin')])
+  assert.deepEqual(v.external.map((x) => x.id), ['codebuddy'])
+  assert.deepEqual(v.builtin.map((x) => x.id), ['opencode'])
+  assert.equal(v.hidden, 0)
+  assert.equal(v.empty, undefined, '有卡片可列时不该有空状态')
+})
+
+test('按来源分组不串（内置 / 插件两组互不吞）', () => {
+  const v = supplierVisibility([
+    s('opencode', 'builtin', true),
+    s('codebuddy', 'external', true),
+    s('nvidia', 'builtin', true),
+  ])
+  assert.deepEqual(v.builtin.map((x) => x.id), ['opencode', 'nvidia'])
+  assert.deepEqual(v.external.map((x) => x.id), ['codebuddy'])
+})
+
+test('全关掉 ≠ 暂无：空状态必须说清去哪开回来', () => {
+  const v = supplierVisibility([s('codebuddy', 'external', false)])
+  assert.equal(v.empty?.reason, 'disabled')
+  assert.match(v.empty?.desc ?? '', /设置 → 插件 → dsh-router-core/,
+    '空状态要把用户指到开关所在处，否则用户以为插件坏了')
+})
+
+test('一个都没装才是「暂无供应商」', () => {
+  assert.equal(supplierVisibility([]).empty?.reason, 'none')
+  assert.equal(supplierVisibility([s('x', 'external', false), s('y', 'builtin', false)]).empty?.reason, 'disabled')
+})

package/src/client/supplier-visibility.ts

@@ -0,0 +1,63 @@
+/**
+ * 面板「供应商」页的可见性规则 —— 纯函数，不碰 React。
+ *
+ * 形状与插件页**刻意相反**：
+ *   - 面板（设置 → 路由 → 供应商）= **在用什么**的工作面，只列**开着**的；
+ *     关掉的卡片不出现（与「扩展」页同一形状）。
+ *   - 插件页（设置 → 插件 → dsh-router-core → 路由组件）= **控制面**，供应商组
+ *     列全部（含关掉的），否则关掉之后就再没有可点的开关能开回来。
+ *
+ * 为什么空状态要分两种：「暂无供应商」说的是**一个都没装**，而「都关掉了」是
+ * 装了但用户自己关的。两者共用一句「暂无供应商」就是说假话 —— 用户进面板发现
+ * 自己装的东西不见了，而真正的原因（开关在另一个页面关着）无处可寻。
+ *
+ * 抽出来是为了让「哪些卡片该出现」这条判据能被单测钉住：它一行就能写错，
+ * 而写错的表现是「面板说关了、请求照样打过去」或者「用户以为没装」。
+ */
+import type { RouterHealthResponse } from '../shared.ts'
+
+/** `/health` 里的一条供应商摘要（就地取型，不另抄一份形状）。 */
+export type SupplierSummary = NonNullable<RouterHealthResponse['suppliers']>[number]
+
+/** 面板要渲染的分组。 */
+export interface SupplierVisibility {
+  /** 随核心分发、且开着的。 */
+  builtin: SupplierSummary[]
+  /** 独立安装、且开着的。 */
+  external: SupplierSummary[]
+  /** 装过但被开关关掉的个数（不列卡片，但空状态要用它说明去哪开回来）。 */
+  hidden: number
+  /**
+   * 空状态文案。`undefined` = 不该显示空状态（有卡片可列）。
+   * `reason: 'none'` 是一个都没装；`reason: 'disabled'` 是装了但全被关掉。
+   */
+  empty?: { reason: 'none' | 'disabled'; title: string; desc: string }
+}
+
+/** 开关在插件页的固定位置 —— 空状态要把用户指过去，不然就断在这里了。 */
+const SWITCH_HOME = '设置 → 插件 → dsh-router-core'
+
+/**
+ * 按「开着与否 + 来源」把供应商分成面板要渲染的两组，并给出空状态该说什么。
+ *
+ * `enabled` 缺省按**开着**读（老核心没有这个字段）；只有明确的 `false` 才算关。
+ */
+export function supplierVisibility(suppliers: readonly SupplierSummary[]): SupplierVisibility {
+  const on = suppliers.filter((s) => s.enabled !== false)
+  const builtin = on.filter((s) => s.source !== 'external')
+  const external = on.filter((s) => s.source === 'external')
+  const hidden = suppliers.length - on.length
+  if (on.length > 0) return { builtin, external, hidden }
+  return {
+    builtin,
+    external,
+    hidden,
+    empty: hidden > 0
+      ? {
+        reason: 'disabled',
+        title: '供应商都已关闭',
+        desc: `开关在 ${SWITCH_HOME} 的「路由组件」一节；打开后会重新参与路由`,
+      }
+      : { reason: 'none', title: '暂无供应商', desc: '' },
+  }
+}

package/src/ext/contract.ts

@@ -55,6 +55,15 @@ export interface RouterExt {
   readonly description?: string
   /** 卡片/详情图标的 logo URL（可选；缺省用默认图标）。 */
   readonly icon?: string
+  /**
+   * 这个扩展是**随核心分发**（`builtin`）还是**独立安装的插件**（不标 = plugin）。
+   *
+   * 为什么需要这个标记：随核心分发的扩展同时是插件页原生「包含的组件」里的**一行**
+   * （自带宿主管的开关），独立安装的扩展是各自 bundle 的行。插件页那个自绘的
+   * 「路由组件」节只该列后者 —— 与内置供应商的处理完全一样：已经有原生行的东西，
+   * 再在下面列一遍就是同一个东西显示两处。
+   */
+  readonly source?: 'builtin'
   /** 当前运行时状态（ready + 不就绪时的说明）。 */
   getState(): ExtState
   /** 卸载清理（表删除时由 dsh-router 调用，可选）。 */