feat: 页面按钮 + 设置分区 + 修掉同步注册事故

- fix(host): 工具/设置注册从 async 续体挪回 apply 同步段 —— cordis 的 ctx 在 apply 返回后失效，
  之前真机报 'cannot create effect on inactive context'，导致 float_window 没装上
- feat(host): tapIndex 往 index.html 注入『悬浮窗』按钮（自带状态点/看门狗/被 SPA 重建后自动补回），
  实测带 auth cookie 拉首页 HTML 已含该按钮；config.button=false 可关
- feat(client): 客户端半 lib/client.js（ModuleLoader 格式，无需构建）注册 sidebar.footer.action
  与 settings.section（设置→悬浮窗整页：打开/全屏/固定/锁定/隐藏/关闭 + 会话状态）；接管后摘掉注入的备用按钮
- package.json: exports['./client'] + dsh.client{inject,platform}

lib/host.js

@@ -155,7 +155,7 @@ const SAMPLE_TYPES = new Set(['user/message', 'assistant/chunk', 'assistant/mess
 export function apply(ctx, config) {
   // 浮窗设置：DSH 设置页写进 profile 条目 config 的值 + 默认值
   const floatCfg = Object.assign(
-    { topmost: true, posLock: false, sizeLock: false, exclude: true, opacity: 0.92, scale: 1, backdrop: 'opaque', tool: true },
+    { topmost: true, posLock: false, sizeLock: false, exclude: true, opacity: 0.92, scale: 1, backdrop: 'opaque', tool: true, button: true },
     (config && typeof config === 'object') ? config : {},
   )
 
@@ -562,28 +562,27 @@ export function apply(ctx, config) {
   }
 
   // ---------------------------------------------------------------- Agent 工具
-  // 踩坑（真机事故）：0.1.7 的 tools 服务要求模型侧看到的是 **JSON Schema**，
-  // 参数必须经 `defineTool()`（内部 parameterSchemaSpecToJsonSchema）转换后再注册。
-  // 直接塞 DSL 对象会让 provider 收到 `parameters.type = null`，于是**每一轮请求都被拒**：
-  //   Invalid schema for function 'float_window': schema must be a JSON Schema of 'type: "object"'
-  // 所以这里：解析不到 defineTool 就**宁可不注册**；注册前再自检一次 type === 'object'。
+  // 踩坑（真机事故 ×2）：
+  //  a) 0.1.7 的 tools 服务要求模型侧看到的是 **JSON Schema**，参数必须经 `defineTool()`
+  //     （内部 parameterSchemaSpecToJsonSchema）转换。直接塞 DSL 对象会让 provider 收到
+  //     `parameters.type = null`，于是**每一轮请求都被拒**：
+  //     Invalid schema for function 'float_window': schema must be a JSON Schema of 'type: "object"'
+  //     所以：解析不到 defineTool 就**宁可不注册**；注册前自检 type === 'object'。
+  //  b) 注册必须发生在 apply() 的**同步**阶段。放进 async 续体会拿到
+  //     "cannot create effect on inactive context"（cordis 的 ctx 在 apply 返回后失效）。
   status.shell = shellPath()
   writeStatus()
 
-  ; (async () => {
-    try {
-      const tools = ctx.get('tools')
-      if (!tools?.register) { log('tools service not available; agent trigger disabled'); return }
-      if (floatCfg.tool === false) { log('tool disabled by config (tool: false)'); return }
-
-      let defineTool = null
-      try { defineTool = (await import('@deepseek-ai/dsh-tools')).defineTool } catch { }
-      if (!defineTool) defineTool = loadHostModule('@deepseek-ai/dsh-tools')?.defineTool
-      if (typeof defineTool !== 'function') {
-        log('defineTool unresolvable; tool NOT registered (avoid emitting an invalid schema)')
-        return
-      }
-
+  try {
+    const tools = ctx.get('tools')
+    const defineTool = loadHostModule('@deepseek-ai/dsh-tools')?.defineTool
+    if (floatCfg.tool === false) {
+      log('tool disabled by config (tool: false)')
+    } else if (!tools?.register) {
+      log('tools service not available; agent trigger disabled')
+    } else if (typeof defineTool !== 'function') {
+      log('defineTool unresolvable; tool NOT registered (avoid emitting an invalid schema)')
+    } else {
       const tool = defineTool({
         name: 'float_window',
         description: '控制 DSH 悬浮窗（始终置顶的会话镜像小窗）：open 打开/聚焦，close 关闭，pin 切换固定位置，fullscreen 切换全屏，hide 临时隐藏（抓屏前用）。',
@@ -596,22 +595,19 @@ export function apply(ctx, config) {
           return `float-window: ${r.text}`
         },
       })
-
-      // 自检：provider 只接受 object 根 schema，这里挡住任何回归
       const schema = tool?.parameters
       if (!schema || schema.type !== 'object' || !schema.properties) {
-        log('tool schema self-check FAILED; not registering:', short(schema, 200))
         status.toolSchema = schema ?? null
-        writeStatus()
-        return
+        log('tool schema self-check FAILED; not registering: ' + short(schema, 200))
+      } else {
+        tools.register(tool)
+        status.tool = true
+        status.toolSchema = schema
+        log('tool float_window registered; schema: ' + short(schema, 240))
       }
-      tools.register(tool)
-      status.tool = true
-      status.toolSchema = schema
-      log('tool float_window registered; schema: ' + short(schema, 240))
-    } catch (e) { log('tool registration failed:', String(e?.message || e)) }
-    writeStatus()
-  })()
+    }
+  } catch (e) { log('tool registration failed:', String(e?.message || e)) }
+  writeStatus()
 
   const broadcast = (msg) => {
     const payload = `data: ${JSON.stringify(msg)}\n\n`
@@ -619,6 +615,46 @@ export function apply(ctx, config) {
   }
   const pushHidden = () => broadcast({ type: 'cmd', cmd: 'hide' })
 
+  // ---------------------------------------------------------------- 页面按钮（index.html 注入）
+  // 宿主侧往 index.html 里塞一个悬浮按钮：不依赖客户端插件 roster，web/桌面壳都生效。
+  // 客户端半（lib/client.js）如果注册成功，会把按钮移除，避免出现两个入口。
+  if (floatCfg.button !== false) {
+    try {
+      const pill = `<style>
+#dsh-float-pill{position:fixed;left:14px;bottom:58px;z-index:2147000000;display:flex;align-items:center;gap:7px;
+padding:7px 12px;border-radius:999px;font:13px/1.2 "Segoe UI","Microsoft YaHei UI",system-ui,sans-serif;cursor:pointer;
+border:1px solid rgba(120,140,180,.35);background:rgba(22,26,34,.92);color:#e6eaf2;box-shadow:0 6px 20px rgba(0,0,0,.45);backdrop-filter:blur(6px)}
+#dsh-float-pill:hover{border-color:#4d7cfe}
+#dsh-float-pill i{width:7px;height:7px;border-radius:50%;background:#f0b429;display:inline-block}
+#dsh-float-pill.on i{background:#3ecf8e;box-shadow:0 0 6px #3ecf8e}
+#dsh-float-pill.hide{display:none}
+</style>
+<button id="dsh-float-pill" title="DSH 悬浮窗：始终置顶的会话镜像小窗（抓屏时自动隐身）"><i></i>悬浮窗</button>
+<script>(function(){
+  var R='/dsh-float-window';
+  function call(a){ return fetch(R+'/window',{method:'POST',headers:{'content-type':'application/json'},body:JSON.stringify({action:a})}).then(function(r){return r.json()}).catch(function(){return null}) }
+  function mount(){
+    if(window.__DSH_FLOAT_UI__) return;            // 客户端半接管了就不重复
+    var b=document.getElementById('dsh-float-pill');
+    if(!b){                                       // SPA 重建 body 时自动补回
+      if(!document.body) return;
+      var wrap=document.createElement('div'); wrap.innerHTML=${JSON.stringify('<button id="dsh-float-pill" title="DSH 悬浮窗：始终置顶的会话镜像小窗（抓屏时自动隐身）"><i></i>悬浮窗</button>')};
+      b=wrap.firstChild; document.body.appendChild(b);
+    }
+    if(b.__bound) return; b.__bound=true;
+    b.addEventListener('click', function(){ b.classList.add('on'); call('open'); });
+    function ping(){ call('status').then(function(j){ if(!j){b.classList.add('hide');return} b.classList.remove('hide'); if(j.alive) b.classList.add('on'); }) }
+    ping(); setInterval(ping, 5000);
+  }
+  mount(); setInterval(mount, 3000);
+})();</script>`
+      ctx.effect(() => ctx.webServer.tapIndex((html) => (typeof html === 'string' && html.includes('</body>')
+        ? html.replace('</body>', pill + '</body>')
+        : html)))
+      log('index pill injected')
+    } catch (e) { log('index pill injection skipped:', String(e?.message || e)) }
+  }
+
   // 抓屏前隐藏的对外门面：交给宿主的共享对象。
   // 注意 cordis 要求先 provide 再 set，否则会抛 "cannot set property ... without provide"
   // （实测：漏了 provide 会让整个插件树加载失败、DSH 起不来）。这里做成可选的，
@@ -628,62 +664,30 @@ export function apply(ctx, config) {
     ctx.set?.('floatWindow', { hide: pushHidden, show: () => broadcast({ type: 'cmd', cmd: 'show' }), snapshot, endpoint: () => endpointFile })
   } catch (e) { log('floatWindow facade skipped:', String(e?.message || e)) }
 
-  // ---------------------------------------------------------------- DSH 设置入口
-  // 注册一个设置命名空间，DSH 的「设置 → 插件」会把它渲染成一张卡片。
-  // schemastery 是从 profile 的 node_modules 解析的；link: 安装的插件解析不到时
-  // 只跳过这一步（浮窗自己的设置面板照常可用）。
+  // ---------------------------------------------------------------- DSH 设置入口（0.1.0 的 settings 服务路径）
+  // 0.1.7 走的是"插件 Config schema"（见文件顶部导出的 Config），这条是旧版兼容路径。
+  // 同样必须**同步**注册：async 续体里的 ctx 已经失效（inactive context）。
   log('services: ' + ['settings', 'sessions', 'tools', 'tokenMeter', 'sessionProjection', 'llm', 'shell', 'sandboxPolicy', 'webServer']
     .map((n) => `${n}=${(() => { try { return ctx.get(n) ? 'y' : 'n' } catch { return '?' } })()}`).join(' '))
-  ; (async () => {
-    try {
-      const settings = ctx.get('settings')
-      if (!settings?.register) { log('settings service absent; skip settings entry'); return }
-      let z = null
-      // link: 安装时插件自己的目录里没有 node_modules，裸导入会失败；
-      // 依次尝试：常规解析 -> 以宿主入口为基准解析 -> profile 目录解析
-      try { z = (await import('@deepseek-ai/schemastery')).default } catch { }
-      if (!z) {
-        try {
-          const { createRequire } = await import('node:module')
-          const req = createRequire(process.argv[1] || path.join(dshHome(), 'index.js'))
-          const m = req('@deepseek-ai/schemastery')
-          z = m?.default || m
-        } catch { }
-      }
-      if (!z) {
-        try {
-          const { createRequire } = await import('node:module')
-          for (const prof of ['desktop', 'web']) {
-            const req = createRequire(path.join(dshHome(), 'profiles', prof, 'package.json'))
-            const m = req('@deepseek-ai/schemastery')
-            z = m?.default || m
-            if (z) break
-          }
-        } catch { }
-      }
-      if (!z) { log('schemastery not resolvable; skip settings entry'); return }
-      const schema = z.object({
-        topmost: z.boolean().default(true).description('始终置顶'),
-        posLock: z.boolean().default(false).description('固定位置'),
-        sizeLock: z.boolean().default(false).description('锁定尺寸'),
-        exclude: z.boolean().default(true).description('抓屏时隐藏本窗'),
-        opacity: z.number().min(0.3).max(1).default(0.92).description('不透明度'),
-        scale: z.number().min(0.8).max(1.5).default(1).description('界面缩放'),
-        backdrop: z.union(['opaque', 'translucent', 'acrylic', 'mica', 'blur']).default('opaque').description('背景效果'),
-      })
-      const scope = settings.register('dsh-float-window', schema)
-      const scope2 = scope
+  try {
+    const settings = ctx.get('settings')
+    if (!settings?.register) {
+      log('settings service absent; skip settings entry')
+    } else if (!floatSchema) {
+      log('schemastery not resolvable; skip settings entry')
+    } else {
+      const scope = settings.register('dsh-float-window', floatSchema)
       ctx.effect(() => {
-        const stop = scope2.watch?.((next) => {
+        const stop = scope?.watch?.((next) => {
           try { broadcast({ type: 'settings', value: next?.value ?? next }) } catch { }
         })
         return () => { try { stop?.() } catch { } }
       })
-      log('settings namespace registered')
       status.settings = true
-      writeStatus()
-    } catch (e) { log('settings registration failed:', String(e?.message || e)) }
-  })()
+      log('settings namespace registered')
+    }
+  } catch (e) { log('settings registration failed:', String(e?.message || e)) }
+  writeStatus()
 
   log('ready; endpoints:', `${ROUTE}/events`, `${ROUTE}/state`, `${ROUTE}/health`)
 }