dsh-dock 0.13.0 → 0.14.0

package/features/mobile-relay/view.jsx

@@ -4,10 +4,9 @@
 // 访问地址二维码；远程设备上经 window.__DSH_REMOTE__ 显示退出登录。
 import { useCallback, useEffect, useMemo, useState } from 'react'
 import QRCode from 'qrcode'
-import { openPanel, subscribePanel, panelNav } from '../../src/shared.js'
 
 function rpc(method, payload) {
-  return fetch('/dsh-dock/mobile-relay/' + method, {
+  return fetch('dsh-dock/mobile-relay/' + method, {
     method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(payload || {}),
   }).then(async (res) => {
     const body = await res.json().catch(() => ({}))
@@ -157,290 +156,12 @@ export function MobileRelayView() {
 }
 
 /**
- * 手机端会话抽屉（窄屏 ≤700px）：底部 Tab 栏「会话」页签拉出侧边栏 + 遮罩点击收起。
- *
- * 直接操作 document.body 下的 DOM（渲染返回 null）——若作为 overlayLayer 的子元素，
- * 会落入 overlayLayer（z 90）的堆叠上下文，遮罩压不住侧栏抽屉（z 80）、Tab 栏也盖不住内容；
- * 挂到 body 下 z 序才是设计值（遮罩 75 < 侧栏 80 < overlayLayer 90）。
- * 左缘浮动「抽屉把手」已移除（与底部 Tab 栏「会话」页签功能重复，还悬浮在内容上）。
- *
- * 与宿主 tapIndex 注入版（features/mobile-relay/host.js，重启 dsh web 后才生效）互斥：
- * window.__dshDockMobileDrawer 先到先得——宿主脚本在 <head> 先跑并置 'host'，本组件
- * 见旗标即整体让位（遮罩/底部 Tab/收起逻辑全归宿主）；宿主未就位（旧版无注入、
- * 或刷新早于重启）时本组件自建全套。本组件的价值是 client bundle 按内容 hash 服务、
- * 刷新页面即生效，无需重启。
- * ⚠️ 两个版本绝不能各建一套：曾出现双底部 Tab 栏（两套按钮叠在一起）与客户端 CSS
- * 覆盖宿主 place() 定位的回归。
- * 与旧版宿主行为脚本并存是安全的：收起链路同一事件内第二次 collapse() 因 aria-label
- * 已翻转而自然空转。
+ * 【远程访问】不再挂 Overlay：「预览版说明」自动确认已迁到插件级
+ * （src/welcome-ack.js 经 index.js 注册 tapIndex，不随任何功能开关启停）——
+ * 关掉远程访问、主实例直接绑 0.0.0.0 的直连形态同样每次重弹，归属不能在本模块。
+ * 手机端 chrome（底部 Tab 栏 / 抽屉遮罩 / 面板互斥）归【手机适配】
+ * （features/mobile/view.js + features/mobile/host.js）。远程访问只负责「远程入口」本身。
  */
-export function MobileRelayOverlay() {
-  // —— 预览版说明自动确认（独立 effect，与下方抽屉 chrome 的宿主互斥无关）——
-  // 根因（dsh 0.2.0-rc.2 ui-settings-models/src/client/welcome-store.ts，文件头注释原文）：
-  // 回环浏览器的确认走宿主持久化，一次确认永久生效；**远程（非回环）浏览器的设置 scope
-  // 是 memory 模式，确认只存页面进程内存，刷新即丢**——所以从局域网/组网 IP 打开时
-  // 「预览版说明」每次刷新都重弹，profile patch 里钉 welcomeNoticeVersion 也救不了
-  // （memory 分支根本不读持久值）。这里在远程访问场景下替用户点一次「继续」：
-  // 每次页面加载最多点一次，回环地址不介入（让 dsh 原生的一次性持久确认自然工作）。
-  useEffect(() => {
-    if (typeof window === 'undefined' || typeof document === 'undefined') return undefined
-    const host = (window.location && window.location.hostname) || ''
-    const loopback = host === '127.0.0.1' || host === 'localhost' || host === '::1' || host.endsWith('.localhost')
-    if (loopback) return undefined
-    if (typeof MutationObserver === 'undefined') return undefined
-    let done = false
-    const tryDismiss = () => {
-      if (done) return
-      const dialogs = document.querySelectorAll('[role="dialog"]')
-      for (const dialog of dialogs) {
-        const text = (dialog.textContent || '')
-        if (!/预览版说明|Preview Notice/.test(text)) continue
-        const btn = [...dialog.querySelectorAll('button')].find((b) => {
-          const t = (b.textContent || '').trim()
-          return t === '继续' || t === 'Continue'
-        })
-        if (btn) {
-          done = true
-          btn.click()
-          observer.disconnect()
-        }
-        break
-      }
-    }
-    const observer = new MutationObserver(tryDismiss)
-    observer.observe(document.body, { childList: true, subtree: true })
-    tryDismiss()
-    // 兜底停止：说明若 60 秒内没出现（未来版本改版/被官方移除），观察器自动退场
-    const stopTimer = setTimeout(() => observer.disconnect(), 60000)
-    return () => { clearTimeout(stopTimer); observer.disconnect() }
-  }, [])
-
-  useEffect(() => {
-    if (typeof window === 'undefined' || typeof document === 'undefined') return undefined
-    const mq = window.matchMedia ? window.matchMedia('(max-width:700px)') : null
-    if (!mq) return undefined
-    // 宿主版接管中：整套 chrome 由宿主负责，本组件零副作用退出。
-    if (window.__dshDockMobileDrawer === 'host') return undefined
-    window.__dshDockMobileDrawer = 'client'
-
-    const narrow = () => mq.matches
-    const frameEl = () => document.querySelector('[class$="frame"]')
-    const sidebarCollapsed = () => { const f = frameEl(); return !!f && f.hasAttribute('data-sidebar-collapsed') }
-    const dialogOpen = () => !!document.querySelector('[role="dialog"][class*="panel"]')
-    // 右侧详情面板：dsh 0.1.7 起 detailsCol 改名 rightbarCol，窄屏原生全屏展开
-    // （data-sidebar-right-panel / data-sidebar-right-open，折叠钮 data-sidebar-right-toggle）。
-    const rightOpen = () => !!document.querySelector('[data-sidebar-right-panel][data-sidebar-right-open]')
-    const collapse = () => { const b = document.querySelector('button[aria-label="收起侧边栏"],button[aria-label="Collapse sidebar"]'); if (b) b.click() }
-    const expand = () => { const b = document.querySelector('button[aria-label="打开侧边栏"],button[aria-label="Open sidebar"]'); if (b) b.click() }
-    const closeDetails = () => {
-      const panel = document.querySelector('[data-sidebar-right-panel][data-sidebar-right-open]')
-      if (!panel) return
-      const toggle = panel.querySelector('[data-sidebar-right-toggle]')
-      if (toggle) toggle.click()
-    }
-
-    // 抽屉遮罩：侧栏展开（浮层态）时盖住页面，点击经全局捕获 handler 收起。
-    // 左缘的浮动「抽屉把手」已移除：底部 Tab 栏的「会话」页签就是会话抽屉的唯一入口，
-    // 把手悬浮在内容上还压过输入区左下角（用户实测截图），纯属重复。
-    const scrim = document.createElement('div')
-    scrim.className = 'dsh-mobile-scrim'
-    document.body.appendChild(scrim)
-
-    // ---- 仿 ZCode 手机端底部 Tab 栏：会话 / 插件 / 设置 ----
-    // 「任务」「功能坞」合并为一个「插件」页签（用户反馈两个入口冗余）：插件面板里
-    // 本来就有运行状态页，任务状态以角标显示在「插件」上——进行中蓝色数量、等待确认
-    // 红色脉冲；有任务在跑时点「插件」直接落到运行状态页，否则进面板首页。
-    // 挂 body（避开 overlayLayer 堆叠上下文），z 序 65：
-    // 低于遮罩 75 / 侧栏抽屉 80 / 功能坞面板 200，这些打开时自然盖住 Tab 栏。
-    // 走到这里说明宿主旗标不存在（宿主版未注入）——宿主版自建的 Tab 栏不会出现；
-    // 兜底摘一次历史上可能残留的旧 Tab 栏，保证全程只有一份。
-    document.querySelectorAll('.dsh-mobile-tabbar').forEach((el) => el.remove())
-    const tabbar = document.createElement('nav')
-    tabbar.className = 'dsh-mobile-tabbar'
-    tabbar.setAttribute('aria-label', '底部导航')
-    // 最近一次角标轮询看到的任务数（驱动「插件」页签的直达目标与角标显隐）。
-    let tasksActive = 0
-    let tasksWaiting = 0
-    const tabDefs = [
-      {
-        id: 'sessions', label: '会话',
-        icon: '<svg viewBox="0 0 24 24"><path d="M21 12a8 8 0 0 1-8 8H5l-2 2V12a8 8 0 0 1 8-8h2a8 8 0 0 1 8 8z"/></svg>',
-        act: () => expand(),
-      },
-      {
-        id: 'dock', label: '插件',
-        icon: '<svg viewBox="0 0 24 24"><rect x="4" y="4" width="7" height="7" rx="1.5"/><rect x="13" y="4" width="7" height="7" rx="1.5"/><rect x="4" y="13" width="7" height="7" rx="1.5"/><rect x="13" y="13" width="7" height="7" rx="1.5"/></svg>',
-        act: () => {
-          // 始终打开、不再当开关用：若功能坞处于打开态但被原生全屏页/弹层（如从侧栏
-          // 进的官方插件管理页）盖住，再点一下会把功能坞关掉、露出的反而是原生页——
-          // 看起来就是「点插件出官方插件页」（用户实测截图）。关闭走面板自己的 ✕。
-          // 配合手机端把功能坞面板 z 序抬到原生弹层之上（媒体查询内 2000）。
-          openPanel((tasksActive > 0 || tasksWaiting > 0) ? 'runstate' : 'home')
-        },
-      },
-      {
-        id: 'settings', label: '设置',
-        icon: '<svg viewBox="0 0 24 24"><circle cx="12" cy="12" r="3.2"/><path d="M19.4 15a1.7 1.7 0 0 0 .34 1.87l.06.06a2 2 0 1 1-2.83 2.83l-.06-.06A1.7 1.7 0 0 0 15 19.4a1.7 1.7 0 0 0-1 1.55V21a2 2 0 1 1-4 0v-.09A1.7 1.7 0 0 0 9 19.4a1.7 1.7 0 0 0-1.87.34l-.06.06a2 2 0 1 1-2.83-2.83l.06-.06A1.7 1.7 0 0 0 4.6 15a1.7 1.7 0 0 0-1.55-1H3a2 2 0 1 1 0-4h.09A1.7 1.7 0 0 0 4.6 9a1.7 1.7 0 0 0-.34-1.87l-.06-.06a2 2 0 1 1 2.83-2.83l.06.06A1.7 1.7 0 0 0 9 4.6a1.7 1.7 0 0 0 1-1.55V3a2 2 0 1 1 4 0v.09a1.7 1.7 0 0 0 1 1.51 1.7 1.7 0 0 0 1.87-.34l.06-.06a2 2 0 1 1 2.83 2.83l-.06.06A1.7 1.7 0 0 0 19.4 9c.23.6.86 1 1.51 1H21a2 2 0 1 1 0 4h-.09a1.7 1.7 0 0 0-1.51 1z"/></svg>',
-        act: () => { const b = [...document.querySelectorAll('button')].find((x) => (x.getAttribute('aria-label') || '') === '设置' || (x.textContent || '').trim() === '设置'); if (b) b.click() },
-      },
-    ]
-    let tasksBadge = null
-    const tabButtons = tabDefs.map((def) => {
-      const b = document.createElement('button')
-      b.type = 'button'
-      b.className = 'dsh-mobile-tab'
-      b.dataset.tab = def.id
-      b.innerHTML = def.icon + '<span>' + def.label + '</span>'
-      b.addEventListener('click', () => def.act())
-      if (def.id === 'dock') {
-        tasksBadge = document.createElement('span')
-        tasksBadge.className = 'dsh-mobile-tab-badge'
-        tasksBadge.style.display = 'none'
-        b.appendChild(tasksBadge)
-      }
-      tabbar.appendChild(b)
-      return b
-    })
-    document.body.appendChild(tabbar)
-    const syncTabs = () => {
-      const expanded = !sidebarCollapsed()
-      const settingsOpen = dialogOpen()
-      for (const b of tabButtons) {
-        const id = b.dataset.tab
-        const on = (id === 'sessions' && expanded)
-          || (id === 'dock' && panelNav.open)
-          || (id === 'settings' && settingsOpen)
-        b.classList.toggle('on', on)
-      }
-    }
-    const unsubPanel = subscribePanel(syncTabs)
-
-    // 「任务」角标：低频轮询 runstate 宿主路由（3s，仅窄屏 + 页面可见时发）；
-    // 进行中 = 蓝色数量，等待确认 = 红色数量 + 脉冲。路由不存在（runstate 未启用
-    // 或宿主旧版）时静默停轮询并摘掉角标，不报错不打扰。
-    let runstateGone = false
-    const pollTasks = () => {
-      if (runstateGone || !tasksBadge || !narrow() || document.visibilityState === 'hidden' || !tabbar.isConnected) return
-      fetch('/dsh-dock/runstate/status', {
-        method: 'POST', headers: { 'content-type': 'application/json' }, body: '{}',
-      }).then(async (res) => {
-        if (res.status === 404 || res.status === 405) { runstateGone = true; tasksActive = 0; tasksWaiting = 0; tasksBadge.style.display = 'none'; return null }
-        const body = await res.json().catch(() => null)
-        if (!body) return null
-        const active = (body.data && body.data.active) || []
-        const waiting = active.filter((t) => t.approvals && t.approvals.length).length
-        tasksActive = active.length
-        tasksWaiting = waiting
-        if (waiting > 0) {
-          tasksBadge.textContent = String(waiting)
-          tasksBadge.className = 'dsh-mobile-tab-badge wait'
-          tasksBadge.style.display = ''
-        } else if (active.length > 0) {
-          tasksBadge.textContent = String(active.length)
-          tasksBadge.className = 'dsh-mobile-tab-badge'
-          tasksBadge.style.display = ''
-        } else {
-          tasksBadge.style.display = 'none'
-        }
-      }).catch(() => {})
-    }
-    const tasksTimer = setInterval(pollTasks, 3000)
-
-    // 软键盘判定：visualViewport 与布局视口高度差超阈值视为键盘弹出（挂
-    // html.dsh-dock-kbd，样式表随之隐藏 Tab 栏并收窄滚动体留白——打字时
-    // 这两样只会挤占键盘上方的一线空间）。老内核没有 visualViewport 就跳过
-    // （那些内核键盘行为是整页缩放，原生命中适配）。
-    const vv = window.visualViewport || null
-    const kbdSync = () => {
-      if (!vv) return
-      const kbd = vv.height > 0 && (window.innerHeight - vv.height) > 120
-      document.documentElement.classList.toggle('dsh-dock-kbd', kbd)
-    }
-
-    const sync = () => {
-      kbdSync()
-      // 兜底摘除历史上可能残留的旧 Tab 栏（正常路径下走到这里说明宿主版未注入，
-      // 不会有第二份；保险起见 sync 周期里也保持全局只有一份）。
-      document.querySelectorAll('.dsh-mobile-tabbar').forEach((el) => { if (el !== tabbar) el.remove() })
-      const on = narrow() && !!frameEl() && !dialogOpen()
-      const collapsed = sidebarCollapsed()
-      // 右侧详情面板（窄屏原生全屏，z 40）打开时：Tab 栏 65 比它高会压边，整体让位，
-      // 面板收起（它自带折叠钮）后再回来。
-      const right = rightOpen()
-      if (scrim) scrim.style.display = on && !collapsed ? '' : 'none'
-      // Tab 栏：窄屏且页面骨架就绪后常驻；功能坞面板/设置弹窗/右侧详情面板打开时隐藏（避免露边压内容）
-      tabbar.style.display = narrow() && !!frameEl() && !panelNav.open && !right ? '' : 'none'
-      syncTabs()
-    }
-    sync()
-    pollTasks()
-    // MutationObserver 跟属性翻转即时同步；1.5s 轮询覆盖路由重渲等一切边角
-    const observer = typeof MutationObserver !== 'undefined' ? new MutationObserver(sync) : null
-    if (observer) observer.observe(document.documentElement, { attributes: true, attributeFilter: ['data-sidebar-collapsed'], subtree: true })
-    const timer = setInterval(sync, 1500)
-    const onMq = () => sync()
-    if (mq.addEventListener) mq.addEventListener('change', onMq)
-    else if (mq.addListener) mq.addListener(onMq)
-    window.addEventListener('resize', kbdSync)
-    if (vv && vv.addEventListener) vv.addEventListener('resize', kbdSync)
-    const onVisible = () => { if (document.visibilityState === 'visible') pollTasks() }
-    document.addEventListener('visibilitychange', onVisible)
-
-    // 捕获阶段统一处理（仅自建模式；宿主就位时宿主已有同款全局捕获）：
-    // Tab 栏自身排除（否则页签动作会被"点外部收起"当场撤销）；
-    // 遮罩不挂自己的 click——它的点击也走这里 collapse()，单一路径防止同一事件两次 toggle。
-    const onClick = (e) => {
-      if (!narrow()) return
-      const t = e.target
-      if (!t || !t.closest) return
-      if (t.closest('.dsh-mobile-tabbar')) return
-      const expanded = !!document.querySelector('button[aria-label="收起侧边栏"],button[aria-label="Collapse sidebar"]')
-      const col = document.querySelector('[class*="sidebarCol"]')
-      const inSidebar = col && col.contains(t)
-      if (!expanded && !inSidebar) return
-      if (inSidebar) {
-        // 只有点「会话」才收抽屉：会话行的 data-row-key 以 session: 开头（0.1.7 结构，
-        // ui-workspace Rows.tsx）；工作区文件夹行是 workspace: 开头——点它只是展开/收拢
-        // 分组，不能收抽屉（旧的「无子 treeitem 即叶子」判定会误伤折叠状态的文件夹：
-        // 折叠时其子节点不在 DOM 里）。搜索结果行无 data-row-key，回退按无子叶判定。
-        const row = t.closest('[role="treeitem"]')
-        const rowKey = (row && row.getAttribute('data-row-key')) || ''
-        const sessionRow = (rowKey && rowKey.startsWith('session:'))
-          || (row && !rowKey && !row.querySelector('[role="treeitem"]') && row.closest('[role="tree"]'))
-        const fresh = t.closest('[class*="newSession"]')
-        if (sessionRow || fresh) setTimeout(() => { collapse(); closeDetails() }, 300)
-        else {
-          // 侧栏入口（插件/自动化任务/设置/记忆/自动进化…）点击后会弹出面板，而面板
-          // z 序常低于展开的抽屉——被盖住等于「点了没反应」（用户实测截图）。稍候
-          // 探测：有面板弹出就收起抽屉让它露出来；目录折叠/搜索等不弹面板的点击不受影响。
-          setTimeout(() => { if (document.querySelector('[role="dialog"]')) collapse() }, 260)
-        }
-        return
-      }
-      if (t.closest('[role="dialog"],[class*="dockm"],[class*="dgfab"],[class*="dgwin"],[class*="dgame"],[data-sidebar-right-panel]')) return
-      collapse()
-    }
-    document.addEventListener('click', onClick, true)
-
-    return () => {
-      document.removeEventListener('click', onClick, true)
-      if (observer) observer.disconnect()
-      clearInterval(timer)
-      clearInterval(tasksTimer)
-      unsubPanel()
-      if (mq.removeEventListener) mq.removeEventListener('change', onMq)
-      else if (mq.removeListener) mq.removeListener(onMq)
-      window.removeEventListener('resize', kbdSync)
-      if (vv && vv.removeEventListener) vv.removeEventListener('resize', kbdSync)
-      document.removeEventListener('visibilitychange', onVisible)
-      document.documentElement.classList.remove('dsh-dock-kbd')
-      if (scrim) scrim.remove()
-      tabbar.remove()
-      if (window.__dshDockMobileDrawer === 'client') delete window.__dshDockMobileDrawer
-    }
-  }, [])
-  return null
-}
 
 export function MobileRelayHomeStat() {
   const [summary, setSummary] = useState('未开启，开启后可远程登录')
@@ -463,49 +184,7 @@ export const feature = {
   description: '账号密码登录的远程入口：所有设备访问同一个 DSH，任务进度实时一致', defaultEnabled: false,
   css: `
 .dmr{--dmr-accent:var(--dk-accent,#2f6fed);--dmr-accent-soft:color-mix(in srgb,var(--dmr-accent) 13%,transparent);display:flex;flex-direction:column;gap:16px;max-width:720px;color:var(--dsw-alias-label-primary);font-size:13px;line-height:1.5}.dmr h3,.dmr h4,.dmr p{margin:0}.dmr h3{font-size:17px;line-height:1.25;letter-spacing:-.01em}.dmr h4{font-size:13px}.dmr-hero,.dmr-status-head{display:flex;align-items:flex-start;gap:12px}.dmr-hero>div,.dmr-status-head>div{min-width:0;display:flex;flex-direction:column;gap:4px}.dmr-hero p,.dmr-status-head p,.dmr-field small,.dmr-share small,.dmr-overview-card small,.dmr-task small,.dmr-note p{color:var(--dsw-alias-label-secondary);font-size:12px;line-height:1.55}.dmr-hero-icon{width:42px;height:42px;display:inline-flex;align-items:center;justify-content:center;flex:none;border-radius:14px;background:var(--dmr-accent-soft);color:var(--dmr-accent);border:1px solid color-mix(in srgb,var(--dmr-accent) 35%,var(--dsw-alias-border-l1))}.dmr-steps{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:10px;margin:0;padding:0;list-style:none}.dmr-steps li{display:flex;gap:9px;padding:11px;border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-1);border-radius:12px}.dmr-steps li>span{width:21px;height:21px;display:inline-flex;align-items:center;justify-content:center;flex:none;border-radius:50%;font-size:11px;font-weight:700;color:var(--dmr-accent);background:var(--dmr-accent-soft)}.dmr-steps div{display:flex;flex-direction:column;gap:3px;min-width:0}.dmr-steps strong{font-size:12px}.dmr-steps small{font-size:11px;color:var(--dsw-alias-label-secondary);line-height:1.45}.dmr-field{display:flex;flex-direction:column;gap:6px;font-weight:600}.dmr-field input,.dmr-field select,.dmr-note textarea{box-sizing:border-box;width:100%;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);border-radius:10px;padding:10px 12px;min-height:44px;font:inherit;outline:none;transition:border-color .18s ease,box-shadow .18s ease}.dmr-field input:focus,.dmr-field select:focus,.dmr-note textarea:focus{border-color:var(--dmr-accent);box-shadow:0 0 0 3px var(--dmr-accent-soft)}.dmr-field small{font-weight:400}.dmr-network-grid{display:grid;grid-template-columns:minmax(0,1.4fr) minmax(150px,.6fr);gap:12px}.dmr-security{padding:12px 13px;border:1px solid color-mix(in srgb,var(--dk-warn) 48%,var(--dsw-alias-border-l1));border-radius:12px;background:color-mix(in srgb,var(--dk-warn) 9%,transparent)}.dmr-security strong{display:block;margin-bottom:4px;color:var(--dk-warn);font-size:12px}.dmr-security p{font-size:12px;color:var(--dsw-alias-label-secondary);line-height:1.55}.dmr-primary,.dmr-secondary,.dmr-text-button,.dmr-icon-button{font:inherit;touch-action:manipulation;cursor:pointer;transition:transform .15s ease,background .18s ease,border-color .18s ease,opacity .18s ease}.dmr-primary,.dmr-secondary{min-height:44px;display:inline-flex;align-items:center;justify-content:center;gap:8px;border-radius:10px;padding:9px 13px;font-weight:600}.dmr-primary{align-self:flex-start;border:1px solid var(--dmr-accent);background:var(--dmr-accent);color:#fff}.dmr-primary:hover{filter:brightness(1.05)}.dmr-secondary{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary)}.dmr-secondary:hover{border-color:var(--dmr-accent);background:var(--dmr-accent-soft)}.dmr-primary:active,.dmr-secondary:active,.dmr-icon-button:active{transform:scale(.98)}.dmr-primary:disabled,.dmr-secondary:disabled,.dmr-text-button:disabled,.dmr-icon-button:disabled{cursor:not-allowed;opacity:.5}.dmr-message{display:flex;align-items:flex-start;gap:7px;padding:10px 12px;border-radius:10px;font-size:12px}.dmr-message.success{color:var(--dsw-alias-state-success-primary);background:color-mix(in srgb,var(--dsw-alias-state-success-primary) 10%,transparent)}.dmr-message.error{color:var(--dsw-alias-state-error-primary);background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 10%,transparent)}.dmr-status-head{justify-content:space-between}.dmr-eyebrow{display:inline-flex;align-items:center;gap:6px;font-size:11px;font-weight:600;color:var(--dmr-accent)}.dmr-eyebrow i{width:7px;height:7px;border-radius:50%;background:currentColor;box-shadow:0 0 0 4px var(--dmr-accent-soft)}.dmr-icon-button{display:inline-flex;align-items:center;justify-content:center;flex:none;width:44px;height:44px;border:1px solid var(--dsw-alias-border-l2);border-radius:10px;background:transparent;color:var(--dsw-alias-label-secondary)}.dmr-icon-button:hover{color:var(--dsw-alias-state-error-primary);border-color:currentColor}.dmr-share{display:flex;flex-direction:column;gap:9px;padding:13px;border:1px solid color-mix(in srgb,var(--dmr-accent) 32%,var(--dsw-alias-border-l1));border-radius:13px;background:var(--dmr-accent-soft)}.dmr-share-layout{display:grid;grid-template-columns:196px minmax(0,1fr);gap:16px;align-items:center}.dmr-qr-card{box-sizing:border-box;display:flex;flex-direction:column;align-items:center;gap:5px;padding:10px;border-radius:12px;background:#fff;color:#111827;text-align:center}.dmr-qr-card img{display:block;width:176px;height:176px;max-width:100%;object-fit:contain}.dmr-qr-card strong{font-size:12px}.dmr-qr-card small{color:#4b5563;font-size:10px}.dmr-qr-loading{display:grid;place-items:center;width:176px;height:176px;color:#64748b;font-size:12px}.dmr-share-detail{min-width:0;display:flex;flex-direction:column;gap:10px}.dmr-share-detail>div:first-child{display:flex;flex-direction:column;gap:4px}.dmr-link{padding:10px 11px;border-radius:8px;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);font:12px/1.4 ui-monospace,SFMono-Regular,Menlo,monospace;word-break:break-all;color:var(--dsw-alias-label-secondary)}.dmr-share-actions{display:flex;gap:8px;flex-wrap:wrap}.dmr-share-actions .dmr-primary{align-self:auto}.dmr-overview{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:10px}.dmr-overview-card{display:flex;flex-direction:column;gap:3px;padding:12px;border:1px solid var(--dsw-alias-border-l1);border-radius:12px;background:var(--dsw-alias-bg-layer-1)}.dmr-overview-card>span{font-size:11px;color:var(--dsw-alias-label-tertiary)}.dmr-overview-card strong{font-size:16px;letter-spacing:-.01em}.dmr-section{display:flex;flex-direction:column;gap:9px}.dmr-section-head{display:flex;align-items:center;justify-content:space-between;gap:10px}.dmr-section-head small{font-size:11px;color:var(--dsw-alias-label-tertiary)}.dmr-text-button{border:0;background:transparent;color:var(--dmr-accent);padding:8px;min-height:36px;font-weight:600}.dmr-task-list{display:flex;flex-direction:column;gap:8px}.dmr-task{display:flex;align-items:flex-start;gap:9px;padding:10px 11px;border:1px solid var(--dsw-alias-border-l1);border-radius:10px;background:var(--dsw-alias-bg-layer-1)}.dmr-task>div{display:flex;min-width:0;flex:1;flex-direction:column;gap:2px}.dmr-task strong{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.dmr-phase{flex:none;border-radius:999px;padding:3px 8px;font-size:11px;background:var(--dmr-accent-soft);color:var(--dmr-accent)}.dmr-phase.write{color:var(--dsw-alias-state-success-primary)}.dmr-phase.code{color:var(--dk-warn)}.dmr-phase.search{color:#0d9488}.dmr-empty{padding:18px 12px;text-align:center;border:1px dashed var(--dsw-alias-border-l2);border-radius:10px;color:var(--dsw-alias-label-secondary);font-size:12px}.dmr-note{display:flex;flex-direction:column;gap:9px;padding-top:2px}.dmr-note blockquote{margin:0;padding:10px 12px;border-left:3px solid var(--dmr-accent);border-radius:0 9px 9px 0;background:var(--dmr-accent-soft);white-space:pre-wrap;font-size:12px}.dmr-note textarea{min-height:88px;resize:vertical;line-height:1.5}.dmr-note .dmr-secondary{align-self:flex-start}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}@media (max-width:680px){.dmr{gap:14px;font-size:14px}.dmr h3{font-size:18px}.dmr-steps{grid-template-columns:1fr;gap:8px}.dmr-steps li{padding:10px}.dmr-steps small,.dmr-hero p,.dmr-status-head p,.dmr-field small,.dmr-share small,.dmr-overview-card small,.dmr-task small,.dmr-note p{font-size:12px}.dmr-network-grid{grid-template-columns:1fr;gap:10px}.dmr-field input,.dmr-field select{font-size:16px}.dmr-primary,.dmr-secondary{width:100%;font-size:14px}.dmr-share-layout{grid-template-columns:1fr;gap:12px}.dmr-qr-card{width:min(240px,100%);margin:0 auto}.dmr-qr-card img,.dmr-qr-loading{width:210px;height:210px}.dmr-share-actions{flex-direction:column}.dmr-share-actions .dmr-primary{width:100%}.dmr-overview{gap:8px}.dmr-overview-card{padding:11px}.dmr-status-head{gap:8px}.dmr-link{font-size:11px}.dmr-note textarea{font-size:16px;min-height:104px}.dmr-note .dmr-secondary{align-self:stretch}.dmr-compact .dmr-hero-icon{width:40px;height:40px;border-radius:13px}}@media (prefers-reduced-motion:reduce){.dmr-primary,.dmr-secondary,.dmr-text-button,.dmr-icon-button,.dmr-field input,.dmr-field select,.dmr-note textarea{transition:none}}.dmr-lan{flex:none;margin-top:6px;padding-top:16px;border-top:1px solid var(--dsw-alias-border-l1)}.dmr-lan-head{display:flex;align-items:flex-start;justify-content:space-between;gap:12px}.dmr-lan-title{min-width:0;display:flex;flex-direction:column;gap:4px}.dmr-lan-title p{color:var(--dsw-alias-label-secondary);font-size:12px;line-height:1.55}.dmr-lan-badge{flex:none;display:inline-flex;align-items:center;gap:6px;border-radius:999px;padding:5px 10px;font-size:11px;font-weight:700;border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-tertiary)}.dmr-lan-badge.on{border-color:color-mix(in srgb,var(--dmr-accent) 45%,transparent);background:var(--dmr-accent-soft);color:var(--dmr-accent)}.dmr-lan-active,.dmr-lan-idle{display:flex;flex-direction:column;gap:12px}.dmr-lan-active .dmr-share-detail small strong{color:var(--dsw-alias-state-error-primary)}.dmr-danger{border-color:color-mix(in srgb,var(--dsw-alias-state-error-primary) 45%,var(--dsw-alias-border-l2));color:var(--dsw-alias-state-error-primary)}.dmr-danger:hover{border-color:var(--dsw-alias-state-error-primary);background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 10%,transparent)}
-/* 抽屉遮罩：侧栏浮层展开时盖住页面。左缘浮动「抽屉把手」已移除——会话入口
- * 统一走底部 Tab 栏「会话」页签，把手悬浮在内容上还压过输入区（用户实测）。 */
-@media (max-width:700px){.dsh-mobile-scrim{position:fixed;inset:0;z-index:75;background:rgba(8,10,14,.45);backdrop-filter:blur(2px);-webkit-backdrop-filter:blur(2px);touch-action:none}
-/* ---- 仿 ZCode 手机端：底部 Tab 栏 + 输入区吸附底部 ---- */
-.dsh-mobile-tabbar{position:fixed;left:0;right:0;bottom:0;z-index:65;display:flex;align-items:stretch;justify-content:space-around;padding:6px 8px calc(8px + env(safe-area-inset-bottom,0px));background:color-mix(in srgb,var(--dsw-alias-bg-layer-2,#1c2230) 92%,transparent);backdrop-filter:blur(12px);-webkit-backdrop-filter:blur(12px);border-top:1px solid var(--dsw-alias-border-l1,rgba(127,139,161,.25));touch-action:manipulation}
-.dsh-mobile-tab{flex:1;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:3px;min-height:48px;padding:4px 0;border:0;background:transparent;color:var(--dsw-alias-label-tertiary,#8b95ab);font:600 11px/1.2 inherit;cursor:pointer;-webkit-tap-highlight-color:transparent;border-radius:10px}
-.dsh-mobile-tab svg{width:21px;height:21px;fill:none;stroke:currentColor;stroke-width:1.7;stroke-linecap:round;stroke-linejoin:round}
-.dsh-mobile-tab.on{color:var(--dsw-alias-label-primary,#e6eaf2)}
-.dsh-mobile-tab.on svg{color:var(--dk-accent,#4d9fff)}
-.dsh-mobile-tab:active{transform:scale(.94)}
-/* 「任务」页签角标：进行中=蓝（数量），等待确认=红（数量+脉冲）——接力场景里
- * 等待确认是最需要人介入的状态，一眼可见；数据来自 runstate 宿主路由低频轮询。 */
-.dsh-mobile-tab{position:relative}
-.dsh-mobile-tab-badge{position:absolute;top:0;right:calc(50% - 26px);box-sizing:border-box;min-width:16px;height:16px;padding:0 4px;border-radius:9px;display:flex;align-items:center;justify-content:center;background:#4d9fff;color:#fff;font-size:10px;font-weight:700;line-height:1;font-variant-numeric:tabular-nums;box-shadow:0 2px 8px rgba(0,0,0,.35);pointer-events:none}
-.dsh-mobile-tab-badge.wait{background:#ef4444;animation:dsh-badge-pulse 1.2s ease-in-out infinite}
-@keyframes dsh-badge-pulse{0%,100%{transform:scale(1)}50%{transform:scale(1.18)}}
-@media (prefers-reduced-motion:reduce){.dsh-mobile-tab-badge.wait{animation:none}}
-/* 输入区吸附到 Tab 栏上方：宿主把欢迎内容 justify-content:center 垂直居中，
- * 手机视口下输入卡片悬在中部、下方留出大片空白。改用「输入区 margin-top:auto」
- * 贴底，并给滚动体留出 Tab 栏高度的内边距，避免内容被 Tab 栏遮挡。
- * ⚠️ 绝不能给滚动体加 justify-content:flex-end/center 贴底：内容会被挤到滚动体
- * 起点之外，Chrome 不把起点方向溢出算进 scrollHeight（手机视口实测
- * scrollHeight==clientHeight、maxScroll==0），会话记录彻底滚不动、首条消息永远
- * 看不到。宿主半部旧版注入里还留着那条 flex-end（要重启 dsh web 才消失），这里
- * 用更高优先级的选择器显式复位：刷新页面即修好，不必等重启。 */
-[class*="scrollBody"][data-conversation-scroll]{justify-content:flex-start !important;padding-bottom:calc(72px + env(safe-area-inset-bottom,0px)) !important}
-[class*="scrollBody"]{padding-bottom:calc(72px + env(safe-area-inset-bottom,0px)) !important}
-[class*="scrollBody"]>[class*="composerSeat"]{margin-top:auto;padding-bottom:6px}
-/* 输入区工具行上的 dsh-dock chip（用量/余额）：窄屏下 28cqw 的宽度上限把它们挤成
- * 「…」「余..」（手机实测），既读不出数值又白占输入行空间。手机端整组收起，数值在
- * 底部「功能坞」里看（用量/余额页信息更全）；桌面端不动。 */
-.dockchip-row{display:none}
-/* 收起的侧栏轨道（collapsed rail）在窄屏只剩 1px 占位，但轨道里的按钮
- * 仍会溢出贴在左边缘（功能坞/进化/设置三枚露出半边的圆钮）。隐藏整列，
- * 这些入口已由底部 Tab 栏接管；展开抽屉（z 80）不受影响。 */
-[class*="sidebarCol"]:has([class*="collapsed"]){visibility:hidden}
-/* 软键盘弹出（visualViewport 判定，挂 html.dsh-dock-kbd）：Tab 栏整体让位（打字时
- * 它只会挤占键盘上方的一线空间），滚动体留白收窄。选择器特异性高于上面的 72px
- * 留白规则，能压过去。宿主接管期间由宿主脚本同步置/摘这个类。 */
-html.dsh-dock-kbd .dsh-mobile-tabbar{display:none !important}
-html.dsh-dock-kbd [class*="scrollBody"]{padding-bottom:12px !important}
-/* 功能坞面板在手机端抬到原生弹层之上：从侧栏进的官方插件管理页等原生弹层 z 序高于
- * 面板默认的 200，功能坞开在下面会被盖住——「插件」页签点了像没反应/露出原页面。 */
-[class*="dockm-backdrop"]{z-index:2000 !important}}`,
-  View: MobileRelayView, HomeStat: MobileRelayHomeStat, Overlay: MobileRelayOverlay,
+`,
+
+  View: MobileRelayView, HomeStat: MobileRelayHomeStat,
 }

package/features/modelconfig/host.js

@@ -10,9 +10,17 @@
 //   - schemastery 保留未知字段（实测），dockTags 对官方校验透明
 //   - POST 也收图片理解代理配置（visionProxy 分支，写 dsh-dock 自有命名空间）
 import { DOCK_NS, sendJson, readBody, walkPath, readDockRoot, mutateDockSection } from '../../src/host-core.js'
+// 凭据引用（apiKeyEnv → 本地凭据库条目）。注意：只从本模块取 credentialRef；
+// 不同 dsh 版本导出的辅助函数不一致（isCredentialRefName 在运行期并不存在），
+// 非法环境变量名一律用 try/catch + credentialRef 兜住。
+import { credentialRef } from '@deepseek-ai/dsh-credentials'
 
 /** 官方 schema 接受的输入模态（写回配置的 input 只允许这两个）。 */
 const HOST_MODALITIES = ['text', 'image']
+/** pi-ai 路由支持的 API 协议。 */
+const PI_AI_APIS = ['openai-completions', 'openai-responses', 'anthropic-messages']
+/** Provider 路由 key（= settings 里 providers.<route> 的 key），须能安全用作对象键与凭据寻址。 */
+const ROUTE_KEY_RE = /^[A-Za-z0-9][A-Za-z0-9._-]*$/
 /** pi-ai 支持的思考档位（升序）。 */
 const PI_AI_LEVELS = ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max']
 /** deepseek 官方支持的思考档位。 */
@@ -147,6 +155,9 @@ export function readModelDirectory(ctx) {
         kind,
         settingsNs: e.settingsNs,
         settingsPath: [...e.settingsPath],
+        // 用户层原始配置：编辑表单按它回填，未知字段（自配 compat/description 等）原样保留。
+        rawProfile: profileUser && typeof profileUser === 'object' && !Array.isArray(profileUser) ? profileUser : {},
+        apis: PI_AI_APIS.slice(),
         defaultInput: strList(resolvedProfile.defaultInput),
         models: models.map((m) => piAiModelView(m && typeof m === 'object' ? m : { id: String(m) }, resolvedProfile.defaultInput)),
       })
@@ -184,6 +195,24 @@ async function enrichRuntimeInput(ctx, dir) {
   })))
 }
 
+/**
+ * 并行补 Provider 的 apiKeyConfigured：apiKeyEnv 指向的条目是否已在本地凭据库配置。
+ * 凭据库不可用 / 环境变量名非法时一律降级为 false（不抛错，避免整表 500）。
+ */
+async function enrichApiKeyStatus(ctx, dir) {
+  const credentials = ctx.get('credentials')
+  if (!credentials || typeof credentials.describe !== 'function') return
+  await Promise.all((dir.providers || []).filter((p) => p.kind === 'pi-ai').map(async (p) => {
+    if (typeof p.apiKeyEnv !== 'string' || !p.apiKeyEnv) { p.apiKeyConfigured = false; return }
+    try {
+      const d = await credentials.describe(credentialRef(p.apiKeyEnv))
+      p.apiKeyConfigured = !!(d && d.configured)
+    } catch {
+      p.apiKeyConfigured = false
+    }
+  }))
+}
+
 /** 校验面板数字草稿并落到条目上（空 = 删除字段，继承默认）。 */
 function setPosInt(entry, field, value) {
   if (value === undefined || value === null || value === '') {
@@ -354,6 +383,164 @@ async function writeModelConfig(ctx, body) {
   return { ok: true, savedAt: Date.now() }
 }
 
+/**
+ * Provider 级增 / 改 / 删（走 llm-pi-ai 的 providers 字典，不改内核）。
+ *   body.action = 'create' | 'update' | 'delete'
+ *   body.route  = providers 字典的 key（= 路由 id）
+ *   body.profile = { displayName, api, baseURL, apiKeyEnv, defaultInput, models: [草稿...] }
+ *   body.apiKey  = 可选明文 Key（写本地凭据库，不落到配置文件）
+ *   body.revisions['llm-pi-ai'] = GET 拿到的 revision（乐观锁，撞车 409）
+ * 未在 profile 里出现的未知字段？——不会：base 以原 profile 为基础合并，用户自配的
+ * compat / description 等原样保留，只覆盖面板负责的那几个键。
+ */
+async function writeProviderConfig(ctx, body) {
+  const settings = ctx.get('settings')
+  if (!settings || typeof settings.mutate !== 'function') throw new Error('settings 服务不可用或不可写')
+  const action = body.action
+  const route = typeof body.route === 'string' ? body.route.trim() : ''
+  const revision = body.revisions && typeof body.revisions['llm-pi-ai'] === 'number'
+    ? body.revisions['llm-pi-ai'] : undefined
+  const bad = (msg) => { const e = new Error(msg); e.statusCode = 400; return e }
+
+  if (action === 'delete') {
+    if (!route) throw bad('请求缺少 route')
+    const dir = readModelDirectory(ctx)
+    const p = (dir.providers || []).find((x) => (x.route || x.id) === route)
+    if (!p) throw bad(`未找到 Provider：${route}`)
+    if (p.kind !== 'pi-ai') throw bad('内置 Provider（如 DeepSeek 官方）不能删除，只能编辑其模型')
+    try {
+      await settings.mutate('llm-pi-ai', [{ op: 'unset', path: ['providers', p.route || route] }], revision)
+    } catch (e) {
+      const msg = e && e.message ? e.message : String(e)
+      const err = new Error(`删除被拒绝：${msg}`)
+      err.statusCode = /conflict|revision/i.test(msg) ? 409 : 400
+      throw err
+    }
+    return { ok: true, deleted: p.route || route, savedAt: Date.now() }
+  }
+
+  if (action !== 'create' && action !== 'update') throw bad(`不支持的 action：${action}`)
+  if (!route || !ROUTE_KEY_RE.test(route)) throw bad('路由 key 非法：须以字母数字开头，只能含字母、数字与 . _ -')
+  const src = body.profile && typeof body.profile === 'object' && !Array.isArray(body.profile) ? body.profile : {}
+  const api = typeof src.api === 'string' ? src.api : ''
+  if (PI_AI_APIS.indexOf(api) < 0) throw bad(`api 非法：只支持 ${PI_AI_APIS.join(' / ')}`)
+  const baseURL = typeof src.baseURL === 'string' ? src.baseURL.trim() : ''
+  if (!/^https?:\/\//i.test(baseURL)) throw bad('baseURL 非法：须以 http:// 或 https:// 开头')
+  let apiKeyEnv = typeof src.apiKeyEnv === 'string' ? src.apiKeyEnv.trim() : ''
+  if (apiKeyEnv) {
+    try { credentialRef(apiKeyEnv) } catch { throw bad('apiKeyEnv 非法：须是合法的环境变量名（如 MODELSCOPE_API_KEY）') }
+  }
+  const models = Array.isArray(src.models) ? src.models : []
+  if (models.length === 0) throw bad('至少需要一个模型')
+  const seen = new Set()
+  for (const m of models) {
+    const id = m && typeof m.id === 'string' ? m.id.trim() : ''
+    if (!id) throw bad('模型 id 不能为空')
+    if (seen.has(id)) throw bad(`模型 id 重复：${id}`)
+    seen.add(id)
+  }
+
+  const base = Object.assign({}, src)
+  delete base.models
+  const displayName = typeof src.displayName === 'string' ? src.displayName.trim() : ''
+  if (displayName) base.displayName = displayName; else delete base.displayName
+  base.api = api
+  base.baseURL = baseURL
+  if (apiKeyEnv) base.apiKeyEnv = apiKeyEnv; else delete base.apiKeyEnv
+  base.models = models.map((m) => piAiModelWrite(
+    Object.assign({}, m, { id: String(m.id).trim() }),
+    { api, route, baseURL }
+  ))
+
+  const apiKey = typeof body.apiKey === 'string' ? body.apiKey.trim() : ''
+  if (apiKey) {
+    if (!apiKeyEnv) {
+      // Key 填了但 apiKeyEnv 留空：按路由 key 自动生成凭据库条目名（与客户端 dkmEnvFromRoute 一致），
+      // 不再要求用户现编一个环境变量名
+      const s = String(route || '').toUpperCase().replace(/[^A-Z0-9]+/g, '_').replace(/^_+|_+$/g, '')
+      apiKeyEnv = (s ? (/^[0-9]/.test(s) ? 'KEY_' + s : s) : 'PROVIDER') + '_API_KEY'
+      base.apiKeyEnv = apiKeyEnv
+    }
+    const credentials = ctx.get('credentials')
+    if (!credentials || typeof credentials.set !== 'function') throw bad('凭据库不可用，无法保存 API Key')
+    try {
+      await credentials.set(credentialRef(apiKeyEnv), apiKey)
+    } catch (e) {
+      const msg = e && e.message ? e.message : String(e)
+      const err = new Error(`写入本地凭据库失败：${msg}`)
+      err.statusCode = 400
+      throw err
+    }
+  }
+
+  try {
+    await settings.mutate('llm-pi-ai', [{ op: 'set', path: ['providers', route], value: base }], revision)
+  } catch (e) {
+    const msg = e && e.message ? e.message : String(e)
+    const err = new Error(`写回官方配置被拒绝：${msg}`)
+    err.statusCode = /conflict|revision/i.test(msg) ? 409 : 400
+    throw err
+  }
+  return { ok: true, route, created: action === 'create', savedAt: Date.now() }
+}
+
+/**
+ * 拉取 Provider 的可用模型列表：OpenAI 兼容端点 GET {baseURL}/models。
+ * Key 优先用请求里刚填的明文（还没保存就能先拉列表），否则回退到已配置的凭据库条目。
+ * 只做「列目录」，不代表该模型真能调用（额度/权限以上游为准）。
+ */
+async function fetchProviderModels(ctx, body) {
+  const bad = (msg) => { const e = new Error(msg); e.statusCode = 400; return e }
+  const baseURL = typeof body.baseURL === 'string' ? body.baseURL.trim().replace(/\/+$/, '') : ''
+  if (!/^https?:\/\//i.test(baseURL)) throw bad('请先填写合法的 baseURL（http:// 或 https://）')
+  let key = typeof body.apiKey === 'string' ? body.apiKey.trim() : ''
+  if (!key && typeof body.apiKeyEnv === 'string' && body.apiKeyEnv.trim()) {
+    const credentials = ctx.get('credentials')
+    if (credentials && typeof credentials.resolve === 'function') {
+      try {
+        const got = await credentials.resolve(credentialRef(body.apiKeyEnv.trim()))
+        key = typeof got === 'string' ? got : (got && typeof got.value === 'string' ? got.value : '')
+      } catch { key = '' }
+    }
+  }
+  const headers = { accept: 'application/json' }
+  if (key) {
+    if (body.api === 'anthropic-messages') {
+      headers['x-api-key'] = key
+      headers['anthropic-version'] = '2023-06-01'
+    } else {
+      headers.authorization = 'Bearer ' + key
+    }
+  }
+  let res
+  try {
+    res = await fetch(baseURL + '/models', { headers, signal: AbortSignal.timeout(20000) })
+  } catch (e) {
+    const err = new Error(`请求 ${baseURL}/models 失败：${(e && e.message) || String(e)}`)
+    err.statusCode = 400
+    throw err
+  }
+  let text = ''
+  try { text = await res.text() } catch { text = '' }
+  if (!res.ok) {
+    const err = new Error(`上游返回 HTTP ${res.status}${text ? '：' + text.slice(0, 240) : ''}`)
+    err.statusCode = 400
+    throw err
+  }
+  let json = null
+  try { json = JSON.parse(text) } catch { /* 非 JSON：下面按空列表处理 */ }
+  let list = []
+  if (Array.isArray(json)) list = json
+  else if (json && Array.isArray(json.data)) list = json.data
+  else if (json && Array.isArray(json.models)) list = json.models
+  const models = list.map((x) => {
+    if (typeof x === 'string') return { id: x }
+    const o = x && typeof x === 'object' ? x : {}
+    return { id: String(o.id || o.model || o.name || ''), name: typeof o.name === 'string' ? o.name : undefined }
+  }).filter((m) => m.id)
+  return { ok: true, count: models.length, models, fetchedAt: Date.now() }
+}
+
 /** 功能注册表条目：index.js 组装 hostSetups 时使用。 */
 export const feature = {
   // id 必须与客户端视图描述符（view.js 的 feature.id）一致：面板开关 / 补推同步都按它
@@ -371,6 +558,7 @@ export const feature = {
         if (req.method === 'GET') {
           const payload = readModelDirectory(ctx)
           await enrichRuntimeInput(ctx, payload)
+          await enrichApiKeyStatus(ctx, payload)
           // 附带图片理解代理配置与自有命名空间 revision（面板保存用）
           try {
             const v = readDockRoot(ctx)
@@ -391,7 +579,13 @@ export const feature = {
         }
         if (req.method === 'POST') {
           const body = await readBody(req)
-          const result = await writeModelConfig(ctx, body)
+          const action = body && typeof body === 'object' ? body.action : undefined
+          // action 显式区分三条链路：拉模型列表 / Provider 增删改 / 旧版模型目录写回
+          const result = action === 'listModels'
+            ? await fetchProviderModels(ctx, body)
+            : (action === 'create' || action === 'update' || action === 'delete')
+              ? await writeProviderConfig(ctx, body)
+              : await writeModelConfig(ctx, body)
           sendJson(res, 200, result)
           return
         }