dsh-plugin-choice-refresh 0.1.0

package/lib/index.js

@@ -0,0 +1,31 @@
+/**
+ * dsh-plugin-choice-refresh — 选择增强插件（服务端半边）
+ *
+ * 功能：在 ask_user_question / ask_user_choice 的选择卡上提供两个增强按钮：
+ *   1. 重新生成选项（refresh）：用户对当前选项都不满意时，一键让模型换一批选项；
+ *   2. 更多选项（more）：选项太少时，一键让模型在保留原选项的基础上补充更多。
+ *
+ * 实现完全在客户端：按钮点击后
+ *   1) 通过 pending.cancel() 以「用户关闭」解除当前待答问题（与原生 UI 的
+ *      「放弃整组问题」同一答案协议）；
+ *   2) 通过 session.prompt(content, 'steer') 向 agent 注入一条结构化的
+ *      用户消息（【系统 · 选项刷新/更多选项】），模型随即重新调用
+ *      ask_user_question / ask_user_choice 提问。
+ * 不注册任何工具、不新增路由、不改核心包；对原生 ask_user_question 与
+ * dsh-plugin-image-tools 的 ask_user_choice（含图片标记）都生效。
+ *
+ * 服务端半边因此为空实现：插件以「自带 bundle patch」方式挂载进 profile，
+ * 客户端半边由 dsh.client 声明经 /plugins/<id>/client.js 送达浏览器。
+ *
+ * @module dsh-plugin-choice-refresh
+ */
+
+export const name = 'dsh-plugin-choice-refresh'
+
+/** 服务端不依赖任何宿主服务（所有逻辑在客户端半边）。 */
+export const inject = []
+
+/** 插件入口：空实现。详见文件头注释。 */
+export function apply() {
+  // 无服务端注册项：刷新协议是纯客户端交互（cancel + steer prompt）。
+}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "dsh-plugin-choice-refresh",
+  "description": "DSH 选择增强插件：在 ask_user_question / ask_user_choice 的选择卡上提供「重新生成选项」（都不满意一键刷新）与「更多选项」（选项太少一键补充）按钮。纯前端交互实现（取消当前问题 + steer 提示模型重新提问），不改核心包、不新增工具。",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "scripts",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE",
+    "设计说明.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Pasumao/dsh-plugin-choice-refresh.git"
+  },
+  "homepage": "https://github.com/Pasumao/dsh-plugin-choice-refresh",
+  "bugs": {
+    "url": "https://github.com/Pasumao/dsh-plugin-choice-refresh/issues"
+  },
+  "scripts": {
+    "selfcheck": "node scripts/selfcheck.mjs",
+    "smoke": "node scripts/selfcheck.mjs && node scripts/smoke-client.mjs",
+    "pack": "npm pack"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek",
+    "harness",
+    "cordis",
+    "plugin",
+    "choice",
+    "refresh",
+    "regenerate",
+    "options"
+  ],
+  "license": "MIT",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [],
+      "platform": "web"
+    }
+  }
+}

package/scripts/selfcheck.mjs

@@ -0,0 +1,132 @@
+/**
+ * dsh-plugin-choice-refresh 自检：对 lib/client.js 导出的纯函数做离线断言。
+ * 运行：node scripts/selfcheck.mjs
+ */
+import { readFileSync } from 'node:fs'
+import { createRequire } from 'node:module'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { strict as assert } from 'node:assert'
+
+const require = createRequire(import.meta.url)
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+const profileRequire = createRequire(join('C:/Users/18303/.dsh/profiles/node_modules', 'noop.cjs'))
+const reactRoot = dirname(profileRequire.resolve('react'))
+const reactModule = profileRequire('react')
+
+// 1) 模拟浏览器模块加载器并物化 factory
+let spec = null
+globalThis.window = {
+  __ModuleLoader__: { load: (value) => { spec = value } },
+}
+const code = readFileSync(join(ROOT, 'lib', 'client.js'), 'utf8')
+new Function(code)()
+assert.ok(spec !== null, 'module loader not invoked')
+assert.equal(spec.id, 'dsh-plugin-choice-refresh')
+
+const shimRequire = (name) => {
+  if (name === 'react/jsx-runtime') return require(join(reactRoot, 'jsx-runtime.js'))
+  if (name === 'react') return reactModule
+  throw new Error(`unexpected require: ${name}`)
+}
+const mod = spec.factory(shimRequire)
+assert.equal(typeof mod.apply, 'function')
+assert.deepEqual(mod.inject, ['slots', 'locale', 'sessions', 'remote'])
+assert.equal(typeof mod.parseMarker, 'function')
+assert.equal(typeof mod.isPlanReviewBatch, 'function')
+assert.equal(typeof mod.buildSteerText, 'function')
+assert.equal(typeof mod.selectChoice, 'function')
+assert.equal(typeof mod.ChoiceComposer, 'function')
+
+let passed = 0
+function ok(name, fn) {
+  fn()
+  passed += 1
+  console.log(`  ok  ${name}`)
+}
+
+console.log('[dsh-plugin-choice-refresh] selfcheck')
+
+// --- parseMarker（与 image-tools 标记格式互通） ---
+function encodeBase64Url(json) {
+  return Buffer.from(json, 'utf8').toString('base64url')
+}
+ok('parseMarker round-trip', () => {
+  const marker = '<!--dsh-pick:v1:' + encodeBase64Url(JSON.stringify({ pickId: 'pick-9', images: [0, 2] })) + '-->'
+  assert.deepEqual(mod.parseMarker(marker + '\n\n补充说明'), { pickId: 'pick-9', images: [0, 2], human: '\n\n补充说明' })
+})
+ok('parseMarker absent -> null', () => {
+  assert.equal(mod.parseMarker(undefined), null)
+  assert.equal(mod.parseMarker('普通 detail'), null)
+  assert.equal(mod.parseMarker('<!--dsh-pick:v1:broken-->'), null)
+})
+
+// --- isPlanReviewBatch ---
+ok('isPlanReviewBatch detects single plan-review question', () => {
+  assert.equal(mod.isPlanReviewBatch([{ id: 'a', question: 'q', detail: 'plan', intent: { kind: 'plan-review', approve: '执行' }, options: [{ label: '执行' }] }]), true)
+})
+ok('isPlanReviewBatch passes normal questions', () => {
+  assert.equal(mod.isPlanReviewBatch([{ id: 'a', question: 'q', options: [{ label: 'A' }] }]), false)
+  assert.equal(mod.isPlanReviewBatch([{ id: 'a', question: 'q' }, { id: 'b', question: 'q2' }]), false)
+  assert.equal(mod.isPlanReviewBatch([]), false)
+  assert.equal(mod.isPlanReviewBatch(undefined), false)
+  // 多题批里即便有 plan-review 意图也不按 plan-review 处理（原生同样放行给通用流）
+  assert.equal(mod.isPlanReviewBatch([{ id: 'a', question: 'q', detail: 'd', intent: { kind: 'plan-review', approve: 'x' }, options: [{ label: 'x' }] }, { id: 'b', question: 'q2' }]), false)
+})
+
+// --- buildSteerText ---
+ok('buildSteerText zh refresh mentions intent and batch', () => {
+  const text = mod.buildSteerText('refresh', [{ id: 'a', question: '选封面' }, { id: 'b', question: '选风格' }], 0, true)
+  assert.ok(text.includes('选项刷新'), '应标记为选项刷新')
+  assert.ok(text.includes('ask_user_question'), '应点名工具')
+  assert.ok(text.includes('ask_user_choice'), '应点名工具')
+  assert.ok(text.includes('5~8'), '应给出数量区间')
+  assert.ok(text.includes('共 2 道'), '应说明批内题目数')
+})
+ok('buildSteerText zh more keeps original options', () => {
+  const text = mod.buildSteerText('more', [{ id: 'a', question: '选模型' }], 0, true)
+  assert.ok(text.includes('更多选项'), '应标记为更多选项')
+  assert.ok(text.includes('保留原选项'), '应要求保留原选项')
+  assert.ok(text.includes('6~10'), '应给出目标数量')
+})
+ok('buildSteerText en refresh', () => {
+  const text = mod.buildSteerText('refresh', [{ id: 'a', question: 'pick a cover' }], 0, false)
+  assert.ok(text.includes('Regenerate options'))
+  assert.ok(text.includes('ask_user_choice'))
+})
+ok('buildSteerText tolerates empty questions', () => {
+  const text = mod.buildSteerText('refresh', undefined, 0, true)
+  assert.equal(typeof text, 'string')
+  assert.ok(text.length > 0)
+})
+
+// --- parseRecommendedLabel ---
+ok('parseRecommendedLabel strips suffix', () => {
+  assert.deepEqual(mod.parseRecommendedLabel('A (Recommended)'), { label: 'A', recommended: true })
+  assert.deepEqual(mod.parseRecommendedLabel('A（推荐）'), { label: 'A', recommended: true })
+  assert.deepEqual(mod.parseRecommendedLabel('A'), { label: 'A', recommended: false })
+})
+
+// --- selectChoice ---
+ok('selectChoice claims normal question', () => {
+  const q = { kind: 'question', key: 'q:1', sessionId: 's1', payload: { questions: [{ id: 'a', question: 'q', options: [{ label: 'A' }] }] } }
+  assert.equal(mod.selectChoice({ interactions: [q] }), q)
+})
+ok('selectChoice skips plan-review and approval', () => {
+  const plan = { kind: 'question', key: 'q:1', sessionId: 's1', payload: { questions: [{ id: 'a', question: 'q', detail: 'plan', intent: { kind: 'plan-review', approve: '执行' }, options: [{ label: '执行' }] }] } }
+  const approval = { kind: 'approval', key: 'a:1', sessionId: 's1', payload: {} }
+  assert.equal(mod.selectChoice({ interactions: [approval, plan] }), null, 'plan-review 应放行给原生 PlanReviewPanel')
+})
+ok('selectChoice prefers question over approval and falls through to later', () => {
+  const q = { kind: 'question', key: 'q:2', sessionId: 's2', payload: { questions: [{ id: 'b', question: 'q2' }] } }
+  const approval = { kind: 'approval', key: 'a:1', sessionId: 's1', payload: {} }
+  assert.equal(mod.selectChoice({ interactions: [approval, q] }), q)
+  assert.equal(mod.selectChoice({ interactions: [approval] }), null)
+})
+ok('selectChoice claims image-marked question too', () => {
+  const marker = '<!--dsh-pick:v1:' + encodeBase64Url(JSON.stringify({ pickId: 'p1', images: [0] })) + '-->'
+  const q = { kind: 'question', key: 'q:3', sessionId: 's3', payload: { questions: [{ id: 'c', question: '选图', detail: marker, options: [{ label: 'A' }] }] } }
+  assert.equal(mod.selectChoice({ interactions: [q] }), q, '带图问题应由本插件渲染（含刷新/更多按钮）')
+})
+
+console.log(`\n[dsh-plugin-choice-refresh] ${passed} checks passed`)

package/scripts/smoke-client.mjs

@@ -0,0 +1,151 @@
+/**
+ * dsh-plugin-choice-refresh 客户端冒烟测试：
+ * 用 Node 模拟浏览器模块加载器执行 lib/client.js，再用真实 react /
+ * react-dom/server 渲染一次选择卡，验证：
+ *   1. 模块加载、apply/inject 导出正常；
+ *   2. 纯文字问题：卡片渲染出「重新生成选项 / 更多选项」按钮，标记不泄漏；
+ *   3. 带图片标记的问题：渲染图片卡片（复用 image-tools 路由）；
+ *   4. plan-review 批：selectChoice 放行（不认领）；
+ *   5. Lightbox 放大查看单独渲染正常。
+ *
+ * 运行：node scripts/smoke-client.mjs
+ */
+import { readFileSync } from 'node:fs'
+import { createRequire } from 'node:module'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { strict as assert } from 'node:assert'
+
+const require = createRequire(import.meta.url)
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+const profileRequire = createRequire(join('C:/Users/18303/.dsh/profiles/node_modules', 'noop.cjs'))
+const reactRoot = dirname(profileRequire.resolve('react'))
+const jsxRuntime = join(reactRoot, 'jsx-runtime.js')
+const reactModule = profileRequire('react')
+const reactDomServer = profileRequire('react-dom/server')
+
+// 1) 模拟浏览器模块加载器
+let spec = null
+globalThis.window = {
+  __ModuleLoader__: { load: (value) => { spec = value } },
+}
+const code = readFileSync(join(ROOT, 'lib', 'client.js'), 'utf8')
+new Function(code)()
+assert.ok(spec !== null, 'module loader not invoked')
+assert.equal(spec.id, 'dsh-plugin-choice-refresh')
+
+const shimRequire = (name) => {
+  if (name === 'react/jsx-runtime') return require(jsxRuntime)
+  if (name === 'react') return reactModule
+  throw new Error(`unexpected require: ${name}`)
+}
+const mod = spec.factory(shimRequire)
+assert.equal(typeof mod.apply, 'function')
+assert.deepEqual(mod.inject, ['slots', 'locale', 'sessions', 'remote'])
+assert.equal(typeof mod.selectChoice, 'function')
+assert.equal(typeof mod.ChoiceComposer, 'function')
+
+const { renderToString } = reactDomServer
+const fakeT = (key) => ({
+  'nav.cancel': '放弃整组问题',
+  'nav.prev': '上一题',
+  'nav.next': '下一题',
+  'action.skip': '跳过本题',
+  'action.next': '下一题',
+  'submit': '提交',
+  'option.recommended': '推荐',
+  'custom.placeholder': '输入你的答案',
+  'refresh.button': '重新生成选项',
+  'more.button': '更多选项',
+  'busy.refresh': '重新生成中…',
+  'busy.more': '补充更多选项中…',
+  'image.failed': '图片加载失败',
+  'image.zoom': '放大查看',
+  'image.close': '关闭',
+}[key] ?? key)
+const fakeCtx = { sessions: {}, remote: {} }
+
+function encodeBase64Url(json) {
+  return Buffer.from(json, 'utf8').toString('base64url')
+}
+
+// 2) 纯文字问题：渲染卡片 + 两个增强按钮
+const plainWait = {
+  key: 'q:1',
+  sessionId: 's1',
+  payload: {
+    type: 'question/requested',
+    sessionId: 's1',
+    questions: [
+      { id: 'a', question: '选一个封面风格', header: '封面', detail: '请选择你喜欢的风格', multiSelect: false, options: [
+        { label: '赛博 (Recommended)', description: '霓虹质感' },
+        { label: '水墨' },
+        { label: '极简' },
+      ] },
+    ],
+  },
+  respond: async (r) => ({ accepted: true }),
+}
+let html = renderToString(reactModule.createElement(mod.ChoiceComposer, { matched: plainWait, t: fakeT, ctx: fakeCtx }))
+assert.ok(html.includes('dsr-card'), '卡片未渲染')
+assert.ok(html.includes('选一个封面风格'), '问题文本缺失')
+assert.ok(html.includes('重新生成选项'), '刷新按钮缺失')
+assert.ok(html.includes('更多选项'), '更多选项按钮缺失')
+assert.ok(html.includes('赛博'), '选项 label 缺失')
+assert.ok(html.includes('推荐'), '推荐徽标缺失')
+assert.ok(!html.includes('<!--dsh-pick:v1:'), '图片标记不应出现')
+
+// 3) 带图片标记的问题：渲染图片卡片（image-tools 路由）
+const marker = '<!--dsh-pick:v1:' + encodeBase64Url(JSON.stringify({ pickId: 'pick-7', images: [0, 2] })) + '-->'
+const imageWait = {
+  key: 'q:2',
+  sessionId: 's2',
+  payload: {
+    type: 'question/requested',
+    sessionId: 's2',
+    questions: [
+      { id: 'b', question: '选一张封面图', detail: marker, multiSelect: false, options: [
+        { label: '深海' },
+        { label: '极光' },
+        { label: '沙漠' },
+      ] },
+    ],
+  },
+  respond: async (r) => ({ accepted: true }),
+}
+html = renderToString(reactModule.createElement(mod.ChoiceComposer, { matched: imageWait, t: fakeT, ctx: fakeCtx }))
+assert.ok(html.includes('/dsh-plugin-image-tools/pick-7/0'), '第一张图片 URL 缺失')
+assert.ok(html.includes('/dsh-plugin-image-tools/pick-7/2'), '第三张图片 URL 缺失')
+assert.ok(html.includes('深海'), '图片卡片 label 缺失')
+assert.ok(html.includes('放大查看'), '放大触发按钮缺失')
+assert.ok(html.includes('重新生成选项'), '带图问题的刷新按钮缺失')
+assert.ok(!html.includes('<!--dsh-pick:v1:'), '图片标记不应泄漏到界面')
+
+// 4) plan-review 批放行
+const planWait = {
+  kind: 'question',
+  key: 'q:3',
+  sessionId: 's3',
+  payload: {
+    type: 'question/requested',
+    sessionId: 's3',
+    questions: [
+      { id: 'c', question: '确认执行计划', detail: '# 计划\n1. 做 A', intent: { kind: 'plan-review', approve: '确认执行' }, options: [{ label: '确认执行' }, { label: '拒绝' }] },
+    ],
+  },
+  respond: async (r) => ({ accepted: true }),
+}
+assert.equal(mod.selectChoice({ interactions: [planWait] }), null, 'plan-review 不应被本插件认领')
+
+// 5) Lightbox 单独渲染
+const lightboxHtml = renderToString(reactModule.createElement(mod.Lightbox, {
+  zoom: { src: '/dsh-plugin-image-tools/pick-7/0', label: '深海', description: '第一张' },
+  onClose: () => {},
+  t: fakeT,
+}))
+assert.ok(lightboxHtml.includes('dsr-lightbox'), 'lightbox 遮罩未渲染')
+assert.ok(lightboxHtml.includes('/dsh-plugin-image-tools/pick-7/0'), 'lightbox 大图 URL 缺失')
+assert.ok(lightboxHtml.includes('深海'), 'lightbox 说明缺失')
+assert.ok(lightboxHtml.includes('关闭'), 'lightbox 关闭按钮文案缺失')
+
+console.log('[dsh-plugin-choice-refresh] client smoke passed')

package//350/256/276/350/256/241/350/257/264/346/230/216.md

@@ -0,0 +1,93 @@
+# dsh-plugin-choice-refresh 设计说明
+
+作者向文档：方案、约束、边界。
+
+## 1. 要解决的问题
+
+DSH 的选择类工具（原生 `ask_user_question`、image-tools 的 `ask_user_choice`）
+都是「模型给一批选项 → 用户只能选/跳过/放弃」。用户对选项不满意时只能：
+打字说明（麻烦）、放弃后手动再问（打断流程）。本插件提供两个一键操作：
+
+1. **refresh（重新生成选项）**：都不满意 → 换一批；
+2. **more（更多选项）**：选项太少 → 补充到 6~10 个。
+
+## 2. 为什么用「取消 + steer 注入」而非新工具 / 改服务端
+
+- **不改核心包**：`ask_user_question` 注册在 preset 的 tools 层，同层重名注册会
+  抛 `already registered`，无法覆盖；新增同名不同名工具模型也不会主动用。
+- **不新增工具**：模型本来就会用 `ask_user_question` / `ask_user_choice`。
+  用户点击后真正需要的是「让模型重新问一次」，而 `session.prompt(mode='steer')`
+  正是客户端向 agent 注入用户消息、打断当前回合的标准通道。
+- **协议闭环**：
+  1. `pending.cancel()`：以「用户关闭」解除当前待答问题（与原生「放弃整组问题」
+     同一 wire 编码 `{ok:false, error:{code:'cancelled'}}`）；
+  2. `ctx.sessions.binding(sessionId).session.prompt([{type:'text',text}], 'steer')`
+     （兜底 `ctx.remote.sessions.prompt({mode:'steer'})`）注入结构化指令；
+  3. 模型在下一回合看到指令与上一组选项的上下文，重新调用提问工具。
+- **对任何提问工具生效**：协议挂在交互层（question/requested 帧）而不是工具
+  输出层，所以原生与 image-tools 的提问都被覆盖。
+
+## 3. 客户端渲染策略：链条目全量接管（priority -300）
+
+`conversation.composer` 是 chain 槽：多个条目按 `priority` 升序选举，第一个
+`select` 返回非 null 者渲染（README 原话："first non-null return elects its
+entry"）。要给所有选择卡加按钮，只有两条路：
+
+- **DOM 注入**：MutationObserver 给卡片加按钮——拿不到 React 持有的
+  `PendingWait`（`wait.respond`），无法解除问题，**否决**；
+- **全量接管**：以 -300（先于 image-tools 的 -100 与原生 0）认领全部
+  question 交互，自己渲染选择卡（含图片卡），并在页脚放两个增强按钮。
+
+选择全量接管，代价是复刻原生卡片 UI（约 600 行，样式全走 `--dsw-*` 变量），
+换来对交互载体的完全控制与对两种提问工具的覆盖。
+
+### 边界处理
+
+- **plan-review 意图放行**：`isPlanReviewBatch`（单题 + `intent.kind==='plan-review'`）
+  时 `select` 返回 null，落回原生 `PlanReviewPanel`，避免把计划审阅卡降级成
+  通用选项列表。
+- **无选项的纯文本提问**：不显示两个增强按钮（没有选项可刷新/补充），
+  渲染与原生一致的 textarea。
+- **多题批**：刷新/补充作用于当前题，steer 文案附带整批题目清单，
+  提示模型把其余题目一并重新询问（cancel 会整批解除，必须让模型重新问全）。
+- **图片卡**：解析 image-tools 的 `<!--dsh-pick:v1:...-->` 标记，图片走其
+  公开路由 `/dsh-plugin-image-tools/<pickId>/<index>`；路由 404 时降级为
+  「图片加载失败」占位。未安装 image-tools 时无标记可解析，自动退化为纯文字。
+
+## 4. 与 image-tools 的耦合边界
+
+- 只耦合其**公开路由**与**标记格式**（`buildPickMarker`/`parsePickMarker` 的
+  wire 形状），二者在 image-tools 源码与文档中固定；
+- 不 `require('dsh-plugin-image-tools')`（客户端模块表禁止跨插件值导入），
+  全部自包含；
+- 若未来 image-tools 改动标记格式，本插件的 `parseMarker` 需要同步。
+
+## 5. 已知限制
+
+- **软增强**：刷新质量依赖模型对注入指令的执行力。指令写得非常明确
+  （换角度/数量/保留原选项/立即重新调用工具），但仍非硬保证；用户可再次点击
+  或打字说明。
+- **取消的副作用**：`cancel()` 解除的是整批问题（与原生 ✕ 一致）。多题批里
+  点刷新会连其它题一起解除，靠 steer 文案让模型重新问全批。
+- **执行顺序**：先 cancel 后 steer。若 cancel 成功而 steer 失败（如会话已
+  关闭），问题已解除且无重新生成——卡片随即消失，用户可重新提问；失败路径
+  会在卡片消失前短暂显示错误文案。
+- **steer 消息入历史**：`【系统 · 选项刷新/更多选项】` 会作为用户消息留在
+  会话记录里（这也是模型能理解上下文的原因），多次点击会累积多条。
+  文案刻意保持简短（一句话点明意图 + 数量要求 + 推荐项标注），
+  多题批时附一行「其余题目也请一并重新询问」。
+
+## 6. 测试
+
+- `scripts/selfcheck.mjs`：13 个纯函数断言（标记解析 / plan-review 识别 /
+  steer 文案 zh/en / 选择器行为 / 推荐标注剥离）。
+- `scripts/smoke-client.mjs`：真实 react-dom/server 渲染纯文字卡、图片卡、
+  Lightbox，并断言 plan-review 放行。
+- 服务端半边为空（`apply` 无注册项），无 server 冒烟。
+
+## 7. 挂载方式
+
+采用「profile 手动 insert」（同 workbench/novel）：`cordis.patch.yml` 是
+HMR 层，insert/remove 无需重启 dsh；客户端 bundle 由 `dsh.client` 声明经
+`/plugins/dsh-plugin-choice-refresh/client.js` 送达，profile 的 client-hmr
+监控 bundle 变更自动广播（否则手动刷新一次）。