@mzzsfy/dsh-context-manager 0.3.0 → 0.4.0

package/README.md

@@ -8,7 +8,7 @@
 
 输入框按 `Alt+↑`,或点击输入框下方工具排的历史按钮(指令/附件右侧,与 Alt+↑ 等效,再点关闭)唤起历史输入浮层:
 
-- 范围导航:`←/→` 按 常用(prompts)→ 当前会话(session)→ 本工作区(workspace)→ 全部工作区(global) 依次切换(边界停住),列表时间倒序
+- 范围导航:顶栏范围标签点击展开 pill 组选择;`←/→` 按 常用(prompts)→ 当前会话(session)→ 本工作区(workspace)→ 全部工作区(global) 依次切换(边界停住),列表时间倒序
 - 收录范围:普通输入与斜杠命令(如 `/goal …`,按会话日志的 command/run 重组为完整命令行),工具结果回填与插件注入不收录
 - 搜索:输入即时过滤(IME 组合输入守卫,命中计数),`↑/↓` 选中、`Enter` 回填
 - 回填经宿主公共契约 `inputActions.setDraft`;`Esc` 两级退出(搜索词非空先清词,再按关闭浮层)
@@ -66,4 +66,4 @@
 
 ## dsh 版本兼容
 
-三版本全部通过:样式注入 data-plugin 契约、历史输入浮层(Alt+↑ 或输入框按钮)、对话 fork、设置「插件」页对话增强卡开关组、host 半区 API(八条 `/api/context/*`)。0.1.6 设置分区卡片位于「插件」页,非独立导航项。
+三版本(0.1.2-rc.1 / 0.1.5-rc.3 / 0.1.7-rc.1)兼容通过:样式注入 data-plugin 契约、历史输入浮层(Alt+↑ 或输入框按钮)、启停路由与方法白名单、激活 live。0.1.6 设置分区卡片位于「插件」页,非独立导航项;0.1.7-rc.1 内置插件页改版为分组列表(无卡片开关锚),样式与 API 面实测正常。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mzzsfy/dsh-context-manager",
   "description": "对话增强:历史输入浮层(范围导航/搜索/subagent排除)、常用提示词收藏、插话撤回、对话 fork(进行中轮分叉/自动重发)",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "main": "src/index.js",
   "exports": {

package/src/client.js

@@ -18,6 +18,7 @@ window.__ModuleLoader__.load({
   factory(require) {
     const React = require('react')
     const { useState, useEffect, useRef } = React
+    const PKG_ID = '@mzzsfy/dsh-context-manager'
 
     // 导航图标声明:交给 dsh-settings-nav-icons 统一渲染;键 = 市场短名(发现页
     // 收录显示形态);该插件未就绪时入队,由其启动时排空
@@ -80,11 +81,19 @@ const CSS = [
   '  color-scheme:light dark; color:light-dark(#0f1115, #e8eaed);',
   '  background:light-dark(#fff, #1e1f22); border-radius:14px;',
   '  box-shadow:0 0 0 0.5px light-dark(rgba(15,17,21,.18), rgba(255,255,255,.14)), 0 4px 16px rgba(0,0,0,.08), 0 16px 48px rgba(0,0,0,.16); }',
-  '.cx-hist__hint { display:flex; align-items:center; gap:10px; padding:9px 14px; flex:none;',
+  '.cx-hist__hint { display:flex; flex-wrap:wrap; align-items:center; gap:10px; padding:9px 14px; flex:none;',
   '  border-bottom:1px solid light-dark(rgba(15,17,21,.08), rgba(255,255,255,.1));',
   '  font:var(--dsw-font-xxs-12, 12px/18px sans-serif); color:light-dark(rgba(15,17,21,.55), rgba(232,234,237,.55)); }',
-  '.cx-hist__scope { padding:2px 10px; border-radius:999px; flex:none;',
-  '  background:#1677ff; color:#fff; font-weight:600; }',
+  // 范围 pill 组:点击直达切换,选中实底蓝,未选淡底
+  '.cx-hist__scopebar { display:flex; align-items:center; gap:4px; flex:none; }',
+  '.cx-hist__pill { appearance:none; border:0; cursor:pointer; flex:none; padding:2px 9px;',
+  '  border-radius:999px; font:var(--dsw-font-xxs-12, 12px/18px sans-serif);',
+  '  color:light-dark(rgba(15,17,21,.6), rgba(232,234,237,.6));',
+  '  background:light-dark(rgba(15,17,21,.06), rgba(255,255,255,.08)); }',
+  '.cx-hist__pill:hover { color:light-dark(rgba(15,17,21,.85), rgba(232,234,237,.85));',
+  '  background:light-dark(rgba(15,17,21,.1), rgba(255,255,255,.14)); }',
+  '.cx-hist__pill--on, .cx-hist__pill--on:hover { background:#1677ff; color:#fff; font-weight:600; }',
+  '.cx-hist__pill:focus-visible { outline:2px solid #1677ff; outline-offset:1px; }',
   '.cx-hist__search { flex:1; min-width:0; padding:3px 10px; border-radius:8px; color-scheme:light dark;',
   '  border:1px solid light-dark(rgba(15,17,21,.14), rgba(255,255,255,.18));',
   '  background:transparent; color:inherit; font:var(--dsw-font-xxs-12, 12px/18px sans-serif); }',
@@ -301,6 +310,8 @@ function HistoryDock({ session, inputActions }) {
   const [items, setItems] = useState(null)
   const [cursor, setCursor] = useState(-1)
   const [scopeIndex, setScopeIndex] = useState(HISTORY_SCOPE_DEFAULT)
+  // 范围标签展开态:默认单胶囊只显当前范围,点击展开 pill 组,选择后收起
+  const [scopeOpen, setScopeOpen] = useState(false)
   const [aligning, setAligning] = useState(false)
   const [loadError, setLoadError] = useState(false)
   // 收藏集合:浮层打开时并行拉一次,行悬停星标据此显示实/空心;
@@ -456,6 +467,7 @@ function HistoryDock({ session, inputActions }) {
     rawItemsRef.current = null
     queryRef.current = ''
     setQuery('')
+    setScopeOpen(false)
     syncView({ open: true, items: null, cursor: -1, scopeIndex: HISTORY_SCOPE_DEFAULT, aligning: false })
     setOpen(true)
     setScopeIndex(HISTORY_SCOPE_DEFAULT)
@@ -468,10 +480,10 @@ function HistoryDock({ session, inputActions }) {
     requestScope(HISTORY_SCOPE_DEFAULT)
   }
 
-  // 切换范围:→ 向大(工作区/全局),← 返回收藏;边界停住;搜索词清空后缓存直接返回
-  function switchScope(delta) {
-    const next = viewRef.current.scopeIndex + delta
-    if (next < 0 || next >= HISTORY_SCOPE_LABELS.length) return
+  // 范围切换共用落点:清过滤与选择态后拉取目标范围;同范围不动,切换即收起展开态
+  function selectScope(next) {
+    if (next === viewRef.current.scopeIndex) return
+    setScopeOpen(false)
     rawItemsRef.current = null
     queryRef.current = ''
     setQuery('')
@@ -485,6 +497,13 @@ function HistoryDock({ session, inputActions }) {
     requestScope(next)
   }
 
+  // ←/→ 相对切换:→ 向大(工作区/全局),← 返回收藏;边界停住
+  function switchScope(delta) {
+    const next = viewRef.current.scopeIndex + delta
+    if (next < 0 || next >= HISTORY_SCOPES.length) return
+    selectScope(next)
+  }
+
   // Alt+↑ 唤起浮层;浮层开 = 菜单模态,捕获阶段拦截导航键,先于 Lexical 光标移动。
   // 设置开关停用时监听器直接放行(读 ref,开关值挂载拉取后即时反映)
   useEffect(() => {
@@ -675,7 +694,20 @@ function HistoryDock({ session, inputActions }) {
   return h('div', { className: 'cx-hist', ref: rootRef },
     open && h('div', { className: 'cx-hist__pop' },
       h('div', { className: 'cx-hist__hint' },
-        h('span', { className: 'cx-hist__scope' }, HISTORY_SCOPE_LABELS[scopeIndex]),
+        h('span', { className: 'cx-hist__scopebar' },
+          scopeOpen
+            ? HISTORY_SCOPE_LABELS.map((label, idx) => h('button', {
+                key: label,
+                className: 'cx-hist__pill' + (idx === scopeIndex ? ' cx-hist__pill--on' : ''),
+                title: idx === scopeIndex ? '收起' : '切换到' + label,
+                onClick: () => (idx === scopeIndex ? setScopeOpen(false) : selectScope(idx)),
+              }, label))
+            : h('button', {
+                className: 'cx-hist__pill cx-hist__pill--on',
+                title: '点击选择范围',
+                onClick: () => setScopeOpen(true),
+              }, HISTORY_SCOPE_LABELS[scopeIndex] + ' ▾'),
+        ),
         inPrompts
           ? h('button', {
               className: 'cx-hist__editbtn',
@@ -1184,7 +1216,7 @@ function ForkDock({ session, forkSession, cancelSession, turnEnds, refreshRef })
 
 // 面板设置项悬停说明:原生 title(设置侧栏为滚动容器,CSS 气泡会被 overflow
 // 裁剪,JS 定位复杂度不成比例);文案与功能行为同源维护,由源码契约测试锁定
-const HISTORY_SWITCH_TITLE = '在输入框按 Alt+↑ 唤起历史输入浮层,浏览并回填历史输入;浮层内 ←/→ 切换范围(常用 / 当前会话 / 本工作区 / 全部工作区),顶部搜索框过滤条目,行悬停星标可收藏常用提示词。停用后快捷键与浮层整体关闭,刷新页面生效。'
+const HISTORY_SWITCH_TITLE = '在输入框按 Alt+↑ 唤起历史输入浮层,浏览并回填历史输入;浮层内 ←/→ 切换范围,点击顶栏范围标签展开选择(常用 / 当前会话 / 本工作区 / 全部工作区),顶部搜索框过滤条目,行悬停星标可收藏常用提示词。停用后快捷键与浮层整体关闭,刷新页面生效。'
 const HISTORY_BUTTON_SWITCH_TITLE = '输入框下方工具排显示历史输入按钮,点击打开浮层,再点关闭,与 Alt+↑ 等效;停用仅隐藏按钮,快捷键与浮层不受影响;刷新页面生效。'
 const STEER_SWITCH_TITLE = '插话发送后、尚未被智能体应用期间,在该插话气泡的操作图标排显示撤回按钮,点击撤回并把原文填回输入框(覆盖输入框现有草稿);含附件的插话不可撤回;消息被应用后按钮随气泡消失,恰在应用瞬间点击会提示已应用且不动草稿。停用即不再注入,刷新页面生效。'
 const FORK_SWITCH_TITLE = '消息气泡操作排显示分叉按钮,点击分叉出新会话到该轮之前(该轮不带入子会话),该轮的用户输入自动回填子会话输入框供编辑重发,子会话自动打开且标题尾号递增;进行中的轮(回复尚未完成)同样可分叉,分叉后自动停止本会话该轮未完成的回复;首轮(无更早上下文可继承,新建会话即为同义操作)与无文本输入的轮(纯图等,无从重发)不注入;停用即不再注入,刷新页面生效。'
@@ -1364,15 +1396,24 @@ function ContextPanel() {
         }, 'context-manager styles')
 
         // 设置卡片:注册进官方「插件」设置页的可配置插件区(keyed slot,
-        // key = 本插件 settings namespace),不占独立设置导航项
+        // key = 本插件 settings namespace),不占独立设置导航项。
+        // 0.1.7-rc.1+ 该槽被宿主移除,卡片换形注册进插件管理页包详情配置槽
+        // (plugins.bundle.config,key = 包名,管理页 ledger.bundles 判定在场);
+        // 两代槽位并存注册:inject 是声明生命周期效应,错误世代宿主永不声明
+        // 该槽,回调挂起不执行,零成本
         ctx.slots.inject('settings.plugin.item', () =>
           ctx.slots.register(
             { name: 'settings.plugin.item', id: 'context', key: 'context' },
             () => React.createElement(ContextPanel),
           ))
+        ctx.slots.inject('plugins.bundle.config', () =>
+          ctx.slots.register(
+            { name: 'plugins.bundle.config', key: PKG_ID },
+            () => React.createElement(ContextPanel),
+          ))
 
         // 历史输入回溯入口:官方 conversation.input.dock 插槽(dsh-client-ui-goal 同构)。
-        // 宿主缺该插槽时注册抛错即禁用本功能,不阻塞其余能力
+        // 宿主缺该插槽时 inject 挂起不注册(声明生命周期效应),本功能静默缺席
         try {
           ctx.slots.inject('conversation.input.dock', () =>
             ctx.slots.register(

package/src/index.js

@@ -61,6 +61,21 @@ const SETTINGS_SCHEMA = schemastery.object({
     .description('会话标题栏的复制 sessionId 按钮,平时隐藏,鼠标悬停标题栏时显示,点击复制当前会话 id;关闭后按钮整体不渲染;变更刷新页面生效'),
 })
 
+// 0.1.7 宿主以静态 Config 导出生成设置节表单(maintain 同构);legacy 宿主经
+// settings.register 注册命名空间。根级 volatile 包装:0.1.7 下整节为 live 表单,
+// 节写经 loader 原地热更;旧宿主 schemastery 无 volatile 方法,特性检测原样返回
+export const Config = volatileWrap(SETTINGS_SCHEMA)
+
+function volatileWrap(schema) {
+  return typeof schema.volatile === 'function' ? schema.volatile() : schema
+}
+
+// volatile ref 动态解包(get 协议):0.1.7 下 apply 入参 config 为整节单 ref;
+// legacy 宿主 config 为普通对象原样透传
+function unwrapVolatile(value) {
+  return typeof value?.get === 'function' ? value.get() : value
+}
+
 function sendJson(res, status, payload) {
   res.writeHead(status, { 'content-type': 'application/json; charset=utf-8' })
   res.end(JSON.stringify(payload))
@@ -77,9 +92,11 @@ function respondError(ctx, res, error) {
   sendJson(res, 400, { error: message })
 }
 
-function readSettings(ctx) {
+function readSettings(ctx, config) {
   const settings = ctx.get('settings')
-  const value = settings ? settings.get(NAMESPACE) : undefined
+  // 双形读(maintain 同构):legacy settings 命名空间 get;0.1.7+ apply 入参
+  // config 整节解包。方法面守卫兼防:服务在但缺 get 时回落默认值,防路由 handler 抛错
+  const value = settings && typeof settings.get === 'function' ? settings.get(NAMESPACE) : unwrapVolatile(config)
   return {
     historyEnabled: !value || value.historyEnabled !== false,
     historyButtonEnabled: !value || value.historyButtonEnabled !== false,
@@ -90,6 +107,22 @@ function readSettings(ctx) {
   }
 }
 
+// 双形写(maintain 同构,判定延迟到使用点):legacy 方法面以 register 为准
+// (0.1.7 的 settings.update 名义在场但按命名空间找条目必败,不可作判据);
+// 0.1.7+ 走 configEditor.edit 落 profile 条目(fiber.entry,与命名空间解耦),
+// 仅 volatile 字段变化时 loader 原地热更不重启。await 保证持久化完成后再读回
+async function persistToggle(ctx, patch) {
+  const settings = ctx.get('settings')
+  if (typeof settings?.register === 'function' && typeof settings?.update === 'function') {
+    await settings.update(NAMESPACE, patch)
+    return
+  }
+  const editor = ctx.get('configEditor')
+  const entry = ctx.fiber?.entry
+  if (!editor || typeof editor.edit !== 'function' || !entry) throw new Error('宿主设置服务不可用')
+  await editor.edit(entry, (current) => ({ ...current, ...patch }))
+}
+
 function readBody(req) {
   const BODY_MAX_BYTES = 64 * 1024
   return new Promise((resolve, reject) => {
@@ -453,7 +486,7 @@ export function apply(ctx, config) {
       handler: async (req, res) => {
         try {
           if (req.method === 'GET') {
-            sendJson(res, 200, { enabled: readSettings(ctx).historyEnabled })
+            sendJson(res, 200, { enabled: readSettings(ctx, config).historyEnabled })
             return
           }
           if (!rejectMethod(req, res, 'POST')) return
@@ -463,11 +496,8 @@ export function apply(ctx, config) {
           } catch {
             throw new Error(MESSAGES.badJsonBody)
           }
-          const settings = ctx.get('settings')
-          if (!settings) throw new Error('宿主设置服务不可用')
-          // update 异步落盘后才提交新值:await 保证持久化完成后再读回
-          await settings.update(NAMESPACE, { historyEnabled: Boolean(body && body.enabled) })
-          sendJson(res, 200, { enabled: readSettings(ctx).historyEnabled })
+          await persistToggle(ctx, { historyEnabled: Boolean(body && body.enabled) })
+          sendJson(res, 200, { enabled: readSettings(ctx, config).historyEnabled })
         } catch (error) {
           respondError(ctx, res, error)
         }
@@ -479,7 +509,7 @@ export function apply(ctx, config) {
       handler: async (req, res) => {
         try {
           if (req.method === 'GET') {
-            sendJson(res, 200, { enabled: readSettings(ctx).historyButtonEnabled })
+            sendJson(res, 200, { enabled: readSettings(ctx, config).historyButtonEnabled })
             return
           }
           if (!rejectMethod(req, res, 'POST')) return
@@ -489,11 +519,8 @@ export function apply(ctx, config) {
           } catch {
             throw new Error(MESSAGES.badJsonBody)
           }
-          const settings = ctx.get('settings')
-          if (!settings) throw new Error('宿主设置服务不可用')
-          // update 异步落盘后才提交新值:await 保证持久化完成后再读回
-          await settings.update(NAMESPACE, { historyButtonEnabled: Boolean(body && body.enabled) })
-          sendJson(res, 200, { enabled: readSettings(ctx).historyButtonEnabled })
+          await persistToggle(ctx, { historyButtonEnabled: Boolean(body && body.enabled) })
+          sendJson(res, 200, { enabled: readSettings(ctx, config).historyButtonEnabled })
         } catch (error) {
           respondError(ctx, res, error)
         }
@@ -505,7 +532,7 @@ export function apply(ctx, config) {
       handler: async (req, res) => {
         try {
           if (req.method === 'GET') {
-            sendJson(res, 200, { enabled: readSettings(ctx).steerRecallEnabled })
+            sendJson(res, 200, { enabled: readSettings(ctx, config).steerRecallEnabled })
             return
           }
           if (!rejectMethod(req, res, 'POST')) return
@@ -515,11 +542,8 @@ export function apply(ctx, config) {
           } catch {
             throw new Error(MESSAGES.badJsonBody)
           }
-          const settings = ctx.get('settings')
-          if (!settings) throw new Error('宿主设置服务不可用')
-          // update 异步落盘后才提交新值:await 保证持久化完成后再读回
-          await settings.update(NAMESPACE, { steerRecallEnabled: Boolean(body && body.enabled) })
-          sendJson(res, 200, { enabled: readSettings(ctx).steerRecallEnabled })
+          await persistToggle(ctx, { steerRecallEnabled: Boolean(body && body.enabled) })
+          sendJson(res, 200, { enabled: readSettings(ctx, config).steerRecallEnabled })
         } catch (error) {
           respondError(ctx, res, error)
         }
@@ -531,7 +555,7 @@ export function apply(ctx, config) {
       handler: async (req, res) => {
         try {
           if (req.method === 'GET') {
-            sendJson(res, 200, { enabled: readSettings(ctx).forkEnabled })
+            sendJson(res, 200, { enabled: readSettings(ctx, config).forkEnabled })
             return
           }
           if (!rejectMethod(req, res, 'POST')) return
@@ -541,11 +565,8 @@ export function apply(ctx, config) {
           } catch {
             throw new Error(MESSAGES.badJsonBody)
           }
-          const settings = ctx.get('settings')
-          if (!settings) throw new Error('宿主设置服务不可用')
-          // update 异步落盘后才提交新值:await 保证持久化完成后再读回
-          await settings.update(NAMESPACE, { forkEnabled: Boolean(body && body.enabled) })
-          sendJson(res, 200, { enabled: readSettings(ctx).forkEnabled })
+          await persistToggle(ctx, { forkEnabled: Boolean(body && body.enabled) })
+          sendJson(res, 200, { enabled: readSettings(ctx, config).forkEnabled })
         } catch (error) {
           respondError(ctx, res, error)
         }
@@ -557,7 +578,7 @@ export function apply(ctx, config) {
       handler: async (req, res) => {
         try {
           if (req.method === 'GET') {
-            sendJson(res, 200, { enabled: readSettings(ctx).forkAutoResendEnabled })
+            sendJson(res, 200, { enabled: readSettings(ctx, config).forkAutoResendEnabled })
             return
           }
           if (!rejectMethod(req, res, 'POST')) return
@@ -567,10 +588,8 @@ export function apply(ctx, config) {
           } catch {
             throw new Error(MESSAGES.badJsonBody)
           }
-          const settings = ctx.get('settings')
-          if (!settings) throw new Error('宿主设置服务不可用')
-          await settings.update(NAMESPACE, { forkAutoResendEnabled: Boolean(body && body.enabled) })
-          sendJson(res, 200, { enabled: readSettings(ctx).forkAutoResendEnabled })
+          await persistToggle(ctx, { forkAutoResendEnabled: Boolean(body && body.enabled) })
+          sendJson(res, 200, { enabled: readSettings(ctx, config).forkAutoResendEnabled })
         } catch (error) {
           respondError(ctx, res, error)
         }
@@ -582,7 +601,7 @@ export function apply(ctx, config) {
       handler: async (req, res) => {
         try {
           if (req.method === 'GET') {
-            sendJson(res, 200, { enabled: readSettings(ctx).copySidEnabled })
+            sendJson(res, 200, { enabled: readSettings(ctx, config).copySidEnabled })
             return
           }
           if (!rejectMethod(req, res, 'POST')) return
@@ -592,10 +611,8 @@ export function apply(ctx, config) {
           } catch {
             throw new Error(MESSAGES.badJsonBody)
           }
-          const settings = ctx.get('settings')
-          if (!settings) throw new Error('宿主设置服务不可用')
-          await settings.update(NAMESPACE, { copySidEnabled: Boolean(body && body.enabled) })
-          sendJson(res, 200, { enabled: readSettings(ctx).copySidEnabled })
+          await persistToggle(ctx, { copySidEnabled: Boolean(body && body.enabled) })
+          sendJson(res, 200, { enabled: readSettings(ctx, config).copySidEnabled })
         } catch (error) {
           respondError(ctx, res, error)
         }
@@ -609,6 +626,14 @@ export function apply(ctx, config) {
   }
 
   ctx.inject(['settings'], (settingsCtx) => {
+    // 方法面守卫:settings 服务缺 register 面(0.1.7 已移除)即走新形态分支;
+    // 0.1.7 关闭原生自动设置页,设置面由本包自带分区承担(maintain 同构)
+    if (typeof settingsCtx.settings.register !== 'function') {
+      if (typeof settingsCtx.settings?.configure === 'function') {
+        settingsCtx.effect(() => settingsCtx.settings.configure({ auto: false }, ctx.fiber))
+      }
+      return
+    }
     settingsCtx.settings.register(NAMESPACE, SETTINGS_SCHEMA, { base: config })
   })
 }

package/test/client-history-scope.test.mjs

@@ -0,0 +1,34 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+
+const CLIENT_SRC = readFileSync(fileURLToPath(new URL('../src/client.js', import.meta.url)), 'utf8')
+
+// 范围标签契约:默认单胶囊只显当前范围,点击展开 pill 组,选择后收起;←/→ 键盘切换走同一落点
+test('源码契约:范围标签默认单胶囊,点击展开 pill 组选择', () => {
+  assert.ok(CLIENT_SRC.includes('const [scopeOpen, setScopeOpen] = useState(false)'), '展开态应默认收起')
+  assert.ok(CLIENT_SRC.includes('HISTORY_SCOPE_LABELS[scopeIndex]'), '默认应单胶囊显示当前范围')
+  assert.ok(CLIENT_SRC.includes('HISTORY_SCOPE_LABELS.map('), '展开后应循环渲染 pill 组')
+  assert.ok(CLIENT_SRC.includes('onClick: () => setScopeOpen(true)'), '单胶囊点击应展开')
+  assert.ok(CLIENT_SRC.includes('onClick: () => (idx === scopeIndex ? setScopeOpen(false) : selectScope(idx))'), 'pill 点击应直达对应范围,当前项点击收起')
+})
+
+test('源码契约:selectScope 为键盘与点击共用的唯一切换落点,切换即收起', () => {
+  assert.ok(CLIENT_SRC.includes('function selectScope('), '应有 selectScope 直达切换函数')
+  // 键盘相对切换委托 selectScope,消除重复切换链
+  assert.ok(/function switchScope\(\s*delta\s*\)\s*\{[\s\S]{0,200}selectScope\(next\)/.test(CLIENT_SRC),
+    'switchScope 应委托 selectScope')
+  // 同范围重复点击不重拉
+  const body = CLIENT_SRC.match(/function selectScope\([^)]*\)\s*\{[\s\S]*?\n  \}/)
+  assert.ok(body && body[0].includes('viewRef.current.scopeIndex'), 'selectScope 应以当前范围守卫幂等')
+  assert.ok(body && body[0].includes('setScopeOpen(false)'), '切换后应收起展开态')
+})
+
+test('源码契约:重开浮层展开态复位,设置悬停说明同步展开语义', () => {
+  // openPopup 内 setScopeOpen(false):浮层重开不残留展开态
+  assert.ok(/function openPopup\(\)\s*\{[\s\S]{0,300}setScopeOpen\(false\)/.test(CLIENT_SRC),
+    '浮层重开应复位展开态')
+  assert.ok(CLIENT_SRC.includes('点击顶栏范围标签展开选择'), '历史说明缺范围标签展开选择语义')
+  assert.ok(CLIENT_SRC.includes('←/→ 切换范围'), '历史说明应保留键盘切换语义')
+})

package/test/client-runtime.test.mjs

@@ -131,4 +131,18 @@ test('运行时:缺 remote.session 时仍完成全部插槽注册', () => {
   plugin.apply(ctx)
   const names = slots.map(({ definition }) => definition.name)
   assert.ok(names.includes('conversation.input.dock'), '输入框 dock 是 fork/历史/撤回三入口的载体')
+})
+
+// 双代插件卡:settings.plugin.item(0.1.2-0.1.5)与 plugins.bundle.config(0.1.7-rc.1+)
+// 并存注册,各自宿主只消费其一;两代定义都必须在 apply 后注册在案
+test('运行时:插件卡双代槽位并存注册且组件可渲染', () => {
+  const { plugin, slots, ctx } = loadPlugin()
+  plugin.apply(ctx)
+  const legacy = slots.find(({ definition }) => definition.name === 'settings.plugin.item')
+  const modern = slots.find(({ definition }) => definition.name === 'plugins.bundle.config')
+  assert.ok(legacy, '缺 settings.plugin.item 注册(0.1.2-0.1.5 设置卡)')
+  assert.equal(legacy.definition.key, 'context', '旧代 key 须配对 settings namespace')
+  assert.ok(modern, '缺 plugins.bundle.config 注册(0.1.7-rc.1+ 插件管理页卡)')
+  assert.equal(modern.definition.key, '@mzzsfy/dsh-context-manager', '新代 key 须为完整包名')
+  assert.equal(typeof modern.component, 'function')
 })

package/test/index.test.mjs

@@ -54,11 +54,16 @@ function makeCtx({
   settingsValue,
   settingsGetError,
   readSessions,
+  configRef,
+  configEditor,
+  settingsService: settingsServiceOverride,
 }) {
   const routes = []
   const pendingInjects = []
   const settingsState = { value: settingsValue }
-  const settingsService = {
+  // settingsServiceOverride(0.1.7 形态桩,如仅 update 的 forms 面)优先;
+  // 缺省时构造 legacy 方法面桩(get/register/update 命名空间语义)
+  const settingsService = settingsServiceOverride ?? {
     // settingsGetError 注入读取期故障:验证 respondError 的系统级错误收敛分支
     get: () => {
       if (settingsGetError) throw settingsGetError
@@ -95,7 +100,12 @@ function makeCtx({
       if (typeof disposer === 'function') effectDisposers.push(disposer)
     },
     inject: (_deps, fn) => { pendingInjects.push(fn) },
-    get: (name) => ({ agents, sessionPersistence, settings: settingsService }[name]),
+    // fiber 桩:0.1.7 configure 装配以本条目 fiber 为 owner
+    fiber: { entry: { options: { id: 'context-manager', name: '@mzzsfy/dsh-context-manager' } } },
+    get: (name) => {
+      if (name === 'configEditor') return configEditor
+      return { agents, sessionPersistence, settings: settingsService }[name]
+    },
     logger: { warns: [], warn(message) { this.warns.push(message) }, infos: [], info(message) { this.infos.push(message) } },
   }
   const ctx = new Proxy(base, {
@@ -108,14 +118,23 @@ function makeCtx({
       return services[prop]
     },
   })
-  apply(ctx, undefined)
+  apply(ctx, configRef)
   return {
     handlers: new Map(routes.map((route) => [route.path, route.handler])),
     logger: base.logger,
     readCounts,
     // 模拟宿主 settings 服务激活:触发 inject 回调(注册)
     activateSettings: () => {
-      while (pendingInjects.length > 0) pendingInjects.shift()({ settings: settingsService })
+      while (pendingInjects.length > 0) {
+        pendingInjects.shift()({
+          settings: settingsService,
+          // 注入上下文的 effect 桩:0.1.7 分支经它注册 configure 装配
+          effect(fn) {
+            const disposer = fn()
+            if (typeof disposer === 'function') effectDisposers.push(disposer)
+          },
+        })
+      }
     },
   }
 }
@@ -899,3 +918,96 @@ test('输入框历史按钮启停:GET 默认启用,POST 切换经 settings 持
   await handlers.get('/api/context/history-button-enabled')(getRequest2('/api/context/history-button-enabled', 'GET'), restored)
   assert.equal(restored.body.enabled, true)
 })
+
+// --- 0.1.7 settings 面双形适配(maintain a913c2c 同构) ---
+
+test('Config 导出契约:根级 volatile 包装,validate 产整节单 ref,默认值对拍', () => {
+  // Given 静态 Config 导出(0.1.7 节表单事实源)
+  assert.ok(indexModule.Config, 'Config 导出必须在场')
+  // When 空配置校验
+  const resolved = indexModule.Config['~standard'].validate({})
+  // Then 产整节单 ref(get 协议),布尔开关默认全开(forkAutoResend 除外)
+  assert.equal(resolved.issues, undefined)
+  const section = resolved.value.get()
+  assert.equal(section.historyEnabled, true)
+  assert.equal(section.forkAutoResendEnabled, false)
+  assert.equal(section.copySidEnabled, true)
+})
+
+test('0.1.7 形态:settings 无 get/register 时读回落 config ref 节值', skipMissingDeps, async () => {
+  // Given settingsForms 只有 update(0.1.7 真实方法面)+ config ref 携带用户值
+  const settingsForms = { update: async () => {} }
+  const configRef = { get: () => ({ historyEnabled: false, copySidEnabled: false }) }
+  const { handlers } = makeCtx({
+    headers: [{ id: 's1', cwd: 'C:/x', createdAt: 0 }],
+    agents: new Map(),
+    settingsService: settingsForms,
+    configRef,
+  })
+  // When GET 开关路由
+  const res = response()
+  await handlers.get('/api/context/history-enabled')(getRequest2('/api/context/history-enabled', 'GET'), res)
+  // Then 返回 config 节值而非默认
+  assert.equal(res.body.enabled, false)
+})
+
+test('0.1.7 形态:开关 POST 经 configEditor.edit 落 fiber.entry 并回显新值', skipMissingDeps, async () => {
+  // Given settingsForms 只有 update + configEditor 桩(合并写回 configStore)
+  const settingsForms = { update: async () => {} }
+  const configStore = {}
+  const editCalls = []
+  const configRef = { get: () => ({ ...configStore }) }
+  const { handlers } = makeCtx({
+    headers: [{ id: 's1', cwd: 'C:/x', createdAt: 0 }],
+    agents: new Map(),
+    settingsService: settingsForms,
+    configRef,
+    configEditor: {
+      async edit(entry, change) {
+        editCalls.push(entry)
+        const next = change({ ...configStore }, {})
+        for (const [key, value] of Object.entries(next)) configStore[key] = value
+      },
+    },
+  })
+  // When POST 关闭历史浮层
+  const off = await postJson(handlers, '/api/context/history-enabled', { enabled: false })
+  // Then edit 定位本条目,合并写回,回显新值
+  assert.equal(off.body.enabled, false)
+  assert.equal(editCalls.length, 1)
+  assert.equal(editCalls[0].options.id, 'context-manager')
+  assert.equal(configStore.historyEnabled, false)
+})
+
+test('0.1.7 形态:configEditor 缺失即 400 拒写,配置不变', skipMissingDeps, async () => {
+  // Given settingsForms 只有 update 且无 configEditor
+  const settingsForms = { update: async () => {} }
+  const configRef = { get: () => ({}) }
+  const { handlers } = makeCtx({
+    headers: [{ id: 's1', cwd: 'C:/x', createdAt: 0 }],
+    agents: new Map(),
+    settingsService: settingsForms,
+    configRef,
+  })
+  // When POST 写开关
+  const denied = await postJson(handlers, '/api/context/history-enabled', { enabled: false })
+  // Then 400 错误响应
+  assert.equal(denied.status, 400)
+  assert.ok(denied.body.error)
+})
+
+test('0.1.7 形态:settings.configure 在场即关闭原生自动页,register 缺失不抛错', skipMissingDeps, () => {
+  // Given settingsForms 带 configure 无 register
+  const configureCalls = []
+  const settingsForms = { configure: (presentation, owner) => { configureCalls.push({ presentation, owner }); return () => {} } }
+  const { activateSettings } = makeCtx({
+    headers: [{ id: 's1', cwd: 'C:/x', createdAt: 0 }],
+    agents: new Map(),
+    settingsService: settingsForms,
+  })
+  // When 激活 settings 注入
+  activateSettings()
+  // Then 关闭自动页且 owner 为本插件 fiber
+  assert.equal(configureCalls.length, 1)
+  assert.deepEqual(configureCalls[0].presentation, { auto: false })
+})