@gehennawu/dsh-service 0.20.0 → 0.21.1

package/README.en.md

@@ -10,6 +10,8 @@ A service-control and operations plugin for self-hosted DSH Web. Provides safe r
 
 The Settings panel "Service Control" page has seven top-level tabs: **Overview, Notifications, Health, Model stats, Quota lookup, Backups, Restart**; the Restart and Quota lookup tabs can each enable a quick entry at the bottom of the settings left navigation (off by default).
 
+The plugin also appears under **Plugins → Plugin configuration**, with five host-level switches enabled by default: **Model statistics, Quota lookup, Backup maintenance, Task notifications, and the `/healthz` liveness endpoint**. Disabling one hides its UI, stops the associated polling/subscriptions, and makes the Host reject that capability; Overview, Health diagnostics, and Restart remain available. All five switches are live settings: disabling or re-enabling them requires neither a page reload nor a DSH Web restart. Statistics refreshes, quota requests, or backup operations already in flight are allowed to finish; quota re-enablement preserves existing cache, TTL, and backoff state, so its UI and calls return immediately but a new upstream request is not guaranteed at once.
+
 ### Version and updates
 
 - Displays current DSH and plugin versions with links to GitHub Releases
@@ -43,7 +45,7 @@ The Settings panel "Service Control" page has seven top-level tabs: **Overview,
 ### Quota lookup
 
 - A dedicated "Quota lookup" tab shows adapted providers as separate cards, each window rendered as a percentage with its own bar and a reset countdown on its own line, plus a refresh icon beside the updated time that force-refreshes that provider on click (bypassing the poll interval); unadapted providers take no space — a "Manual adapt" row at the bottom enables one by picking its type, and each card's footer can switch type, fall back to auto-detect, or disable lookup at any time
-- A quota ring inside the conversation composer follows the provider selected by the current session and shows the tightest budget window as a percentage (green below 80%, amber at or above); clicking opens a panel headed by the provider name, with a bar and used percentage for each window and reset times on their own lines
+- A quota ring inside the conversation composer follows the provider selected by the current session and shows the tightest budget window as a percentage (green below 80%, amber at or above); clicking opens a panel headed by the provider name, with a bar and used percentage for each window and reset times on their own lines; on narrow viewports (phones) the panel switches to a viewport-centered floating layer — fully visible, scrolling internally when too tall — and rotates or resizing wider flips it back to the anchored placement above the ring
 - A "Show a remote quota entry in the settings left navigation" switch lives in the Quota lookup tab (off by default), mirroring the Restart entry
 - Built-in adaptations: **OpenCode Go** (`{baseURL}/usage`), **Zhipu GLM Coding Plan / zai-coding-cn** (official monitor `quota/limit` endpoint with three windows — 5-hour rolling tokens, weekly tokens, monthly MCP quota; an idle 5-hour window hides its reset time, matching the official console), **OpenRouter** (credits used %), **Kimi/Moonshot** and **SiliconFlow** (CNY balance text); dialects that natively report remaining percentage flip the panel word to "Remaining" and invert the warn threshold; transient network errors retry automatically and the Zhipu dual-domain candidate chain switches automatically; the provider-to-kind mapping lives in `DSH_HOME/dsh-service-quota.json`, and known services are auto-detected from their baseURL (e.g. opencode.ai, bigmodel.cn) with no manual picking; no upstream request is ever made for unadapted or disabled providers; disabling can be done via "Disable" in a card's footer or by writing `"<provider>": null` in the config file (both are equivalent). Zhipu reset cards have no API-key-queryable endpoint yet — you can add any number of them via each provider card's "Add reset card" button on the tab (name plus expiry time, down to the minute), and remove each one independently — the ring panel shows them too (stored in the same config file); expired cards are flagged automatically
 - Anti-rate-limit pacing is enforced by the host: successful results are cached for 60 seconds (shared across tabs), failures back off exponentially (30 s doubling, capped at 15 minutes), upstream timeout is 15 s; the panel can set auto query to manual only / 1 / 2 / 5 / 10 minutes (manual only by default), paused automatically while the page is hidden

package/README.md

@@ -10,6 +10,8 @@
 
 设置页「服务控制」面板包含七个顶部标签：**概览、通知、健康诊断、模型统计、额度查询、备份维护、重启**；重启与额度查询标签还可在设置页左侧标签列底部开启快捷入口（默认关闭）。
 
+插件同时出现在「插件 → 插件配置」，提供五个默认开启的宿主级开关：**模型统计、额度查询、备份维护、任务通知、`/healthz` 探活端点**。关闭后不仅隐藏对应界面，也会停止相关轮询/订阅并由宿主拒绝对应能力；概览、健康诊断与重启固定保留。设置写入 DSH settings，五项均为热生效：关闭或重新开启都无需刷新页面或重启 DSH Web。已在途的统计刷新、额度请求或备份操作允许完成；额度重新开启时保留既有缓存、TTL 与退避状态，因此可立即恢复界面和调用，但不保证立刻重新请求上游。
+
 ### 版本与更新
 
 - 显示当前 DSH 和插件版本，版本号链接到 GitHub Releases
@@ -43,7 +45,7 @@
 ### 额度查询
 
 - 独立的「额度查询」标签：以卡片分区展示已适配的供应商，每个窗口显示百分比、独立进度条，重置时间单独一行；卡片头部更新时间旁有刷新图标，点击即强制重拉该供应商（不受轮询间隔限制）；未适配的不占位置，统一收进底部「手动适配」行选择类型启用，卡片脚部可随时切换适配类型、回退自动识别或停用查询
-- 对话输入框内一枚额度圆环，跟随当前会话所选模型的供应商，显示最紧预算窗口的已用百分比（<80% 绿色、≥80% 黄色）；点击弹出面板——头部标明供应商，各窗口带独立进度条与已用百分比、重置时间单独一行
+- 对话输入框内一枚额度圆环，跟随当前会话所选模型的供应商，显示最紧预算窗口的已用百分比（<80% 绿色、≥80% 黄色）；点击弹出面板——头部标明供应商，各窗口带独立进度条与已用百分比、重置时间单独一行；手机等窄屏上面板自动切换为视口居中的浮层（完整可见、超高时内部滚动），旋转或拖宽窗口即时切回圆环上方锚定
 - 可在「额度查询」标签开启「设置页左列显示入口」开关（默认关闭），开启后在设置页左侧标签列底部显示「额度查询」快捷入口（与「重启」入口同模式）
 - 内置适配：**OpenCode Go**（`{baseURL}/usage`）、**智谱 GLM Coding Plan / zai-coding-cn**（官方监控端点 `quota/limit`，含 5 小时滚动 Token、每周 Token、MCP 月度配额三个窗口，5 小时窗口空闲时与官网一致地不显示重置时间）、**OpenRouter**（credits 已用%）、**Kimi/Moonshot** 与 **硅基流动**（人民币余额）；原生报「剩余百分比」的方言会自动把面板头部切换为「剩余」并把预警阈值反向；上游瞬时网络错误自动重试，智谱双域候选链自动切换；供应商与适配类型的对应关系保存在 `DSH_HOME/dsh-service-quota.json`，已知服务商按 baseURL 自动识别适配（如 opencode.ai、bigmodel.cn），无需手选；未适配或已停用的供应商不会被发起任何上游请求，停用可在卡片脚部选「停用查询」或在配置文件写 `"<provider>": null`（两者等价）。智谱的重置卡暂无 API Key 可查的接口，可在「额度查询」标签内点各供应商卡片的「添加重置卡」填写名称与到期时间（可精确到分钟），可连续添加多条、每条独立移除；圆环面板同步显示（数据存入同一配置文件），过期自动标注
 - 防风控节律由宿主统一控制：成功结果缓存 60 秒（多标签共享）、失败指数退避（30 秒起 ×2、封顶 15 分钟）、上游超时 15 秒；面板可把自动查询调成仅手动 / 1 / 2 / 5 / 10 分钟（默认仅手动），页面不可见时自动暂停

package/client.js

@@ -11,6 +11,16 @@ window.__ModuleLoader__.load({
     const zh = {
       'nav.label': '服务控制',
       'nav.restart': '重启',
+      'features.cardTitle': '服务控制（dsh-service）',
+      'features.cardHint': '控制可选功能和外部能力。开关立即生效，无需重启；详细状态与操作位于左侧「服务控制」。',
+      'features.optional': '可选功能',
+      'features.external': '外部能力',
+      'features.modelUsage': '模型统计',
+      'features.quotaLookup': '额度查询',
+      'features.backupMaintenance': '备份维护',
+      'features.taskNotifications': '任务通知',
+      'features.healthz': '/healthz 探活端点',
+      'features.readOnly': '当前设置不可写。',
       'overlay.label': '服务重启状态',
       'recovery.waiting.title': '服务重启中…',
       'recovery.waiting.body': '正在等待新的 DSH Web 进程启动，已等待 {seconds} 秒。',
@@ -309,6 +319,16 @@ window.__ModuleLoader__.load({
     const en = {
       'nav.label': 'Service Control',
       'nav.restart': 'Restart',
+      'features.cardTitle': 'Service control (dsh-service)',
+      'features.cardHint': 'Control optional features and external capabilities. Changes take effect immediately without a restart; detailed status and actions remain in Service Control.',
+      'features.optional': 'Optional features',
+      'features.external': 'External capabilities',
+      'features.modelUsage': 'Model statistics',
+      'features.quotaLookup': 'Quota lookup',
+      'features.backupMaintenance': 'Backup maintenance',
+      'features.taskNotifications': 'Task notifications',
+      'features.healthz': '/healthz liveness endpoint',
+      'features.readOnly': 'These settings are read-only.',
       'overlay.label': 'Service restart status',
       'recovery.waiting.title': 'Restarting service…',
       'recovery.waiting.body': 'Waiting for a new DSH Web process. Elapsed: {seconds} seconds.',
@@ -664,7 +684,7 @@ window.__ModuleLoader__.load({
       }
     }
 
-    const inject = ['slots', 'connection', 'timer', 'locale', 'sessions']
+    const inject = ['slots', 'connection', 'timer', 'locale', 'sessions', 'settingsScope']
 
     function apply(ctx) {
       const { useState, useEffect, useRef } = React
@@ -687,6 +707,16 @@ window.__ModuleLoader__.load({
       ctx.effect(() => () => { if (svcStyle) svcStyle.remove() }, 'dsh-service theme styles')
       ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'dsh-service dictionaries')
       const t = ctx.locale.bind(NS)
+      const DEFAULT_FEATURES = { modelUsage: true, quotaLookup: true, backupMaintenance: true, taskNotifications: true, healthz: true }
+      const featureScope = ctx.settingsScope.bind({ namespace: NS })
+      const featureSnapshot = () => featureScope.getSnapshot()
+      const featureValue = () => Object.assign({}, DEFAULT_FEATURES, featureSnapshot().value || {})
+      const featureEnabled = (key) => featureValue()[key] !== false
+      const useFeatures = () => {
+        const [snapshot, setSnapshot] = React.useState(featureSnapshot())
+        React.useEffect(() => featureScope.subscribe(() => setSnapshot(featureSnapshot())), [])
+        return { snapshot, value: Object.assign({}, DEFAULT_FEATURES, snapshot.value || {}) }
+      }
       // 设置页左列三行打标记，配合上方样式换成各自图标；label 走 locale 绑定值。
       ctx.effect(
         () => markSettingsNavRows([
@@ -762,7 +792,7 @@ window.__ModuleLoader__.load({
       let quotaNavDispose = null
       const syncQuotaNavEntry = () => {
         if (quotaNavDispose) { quotaNavDispose(); quotaNavDispose = null }
-        if (!quotaNavEnabled) return
+        if (!quotaNavEnabled || !featureEnabled('quotaLookup')) return
         quotaNavDispose = ctx.slots.register(
           { name: 'settings.section', id: 'dsh-service-quota', order: 498, label: () => t('tabs.quota') },
           () => React.createElement(QuotaSection, null),
@@ -811,11 +841,14 @@ window.__ModuleLoader__.load({
         } catch (_) {}
         return undefined
       }
-      // 会话活跃态（sessions.list 快照派生，订阅推送更新）：后台额度轮询只刷新 running 会话使用的供应商。
+      // 会话活跃态（sessions.list 快照派生，订阅推送更新）：任务通知和后台额度轮询共享这一事实源。
+      // 两项都关闭时彻底摘除订阅；任一重新开启时重新建立当前快照基线，不补发关闭期间的旧边沿。
       const sessionActivity = { anyRunning: false, runningSessionIds: new Set() }
       if (ctx.sessions && typeof ctx.sessions.list?.subscribe === 'function') {
         const observed = new Map()
         let baselined = false
+        let sessionsDispose = null
+        let resetDispose = null
         const observeSessions = () => {
           const snapshot = ctx.sessions.list.getSnapshot()
           if (!snapshot || !snapshot.byId) return
@@ -832,10 +865,10 @@ window.__ModuleLoader__.load({
             const next = { running: summary.running === true, pending: summary.pendingInteraction !== undefined }
             const prev = observed.get(id)
             if (prev !== undefined) {
-              if (prev.running && !next.running && notifyEnabled && notifyDone) {
+              if (prev.running && !next.running && featureEnabled('taskNotifications') && notifyEnabled && notifyDone) {
                 fireNotification(t('notification.doneTitle'), t('notification.doneBody', { title: summary.displayTitle || id }))
               }
-              if (!prev.pending && next.pending && notifyEnabled && notifyInput) {
+              if (!prev.pending && next.pending && featureEnabled('taskNotifications') && notifyEnabled && notifyInput) {
                 const kindKey = NOTIFY_KIND_KEYS[summary.pendingInteraction]
                 const kind = kindKey ? t(kindKey) : String(summary.pendingInteraction)
                 fireNotification(t('notification.inputTitle'), t('notification.inputBody', { title: summary.displayTitle || id, kind }))
@@ -848,12 +881,30 @@ window.__ModuleLoader__.load({
           }
           // agent 启动时轮询链可能已因「隐藏页跳过周期」而死（runQuotaCycle 跳过即不再排下一轮）：
           // 有活跃会话就重新拉起排程（幂等：已有挂起定时器/refs=0/仅手动时 no-op）。
-          // 放在 baselined 早退之后——首次同步调用发生在工厂初始化期（quotaLoop 尚未定义），订阅事件只会在初始化完成后到。
           if (sessionActivity.anyRunning) scheduleQuotaCycle()
         }
-        ctx.effect(() => ctx.sessions.list.subscribe(() => observeSessions()), 'dsh-service: session notification observation')
-        ctx.effect(() => ctx.on('connection/reset', () => { observed.clear(); baselined = false }), 'dsh-service: notification rebaseline on reconnect')
-        observeSessions()
+        const stopSessionObservation = () => {
+          if (sessionsDispose !== null) { sessionsDispose(); sessionsDispose = null }
+          if (resetDispose !== null) { resetDispose(); resetDispose = null }
+          observed.clear()
+          baselined = false
+          sessionActivity.anyRunning = false
+          sessionActivity.runningSessionIds = new Set()
+        }
+        const syncSessionObservation = () => {
+          const needed = featureEnabled('taskNotifications') || featureEnabled('quotaLookup')
+          if (!needed) { stopSessionObservation(); return }
+          if (sessionsDispose !== null) return
+          sessionsDispose = ctx.sessions.list.subscribe(() => observeSessions())
+          resetDispose = ctx.on('connection/reset', () => { observed.clear(); baselined = false })
+          observeSessions()
+        }
+        syncSessionObservation()
+        const unsubscribeFeatures = featureScope.subscribe(syncSessionObservation)
+        ctx.effect(() => () => {
+          unsubscribeFeatures()
+          stopSessionObservation()
+        }, 'dsh-service: shared session observation')
       }
 
       const recoveryListeners = new Set()
@@ -1342,7 +1393,7 @@ window.__ModuleLoader__.load({
       const quotaLoop = { refs: 0, allRefs: 0, nextDispose: null, running: false, onVisible: undefined }
       const isTabHidden = () => typeof document !== 'undefined' && document.visibilityState === 'hidden'
       function scheduleQuotaCycle() {
-        if (quotaLoop.refs === 0 || quotaLoop.nextDispose !== null || readQuotaPollMinutes() <= 0) return
+        if (!featureEnabled('quotaLookup') || quotaLoop.refs === 0 || quotaLoop.nextDispose !== null || readQuotaPollMinutes() <= 0) return
         const minutes = readQuotaPollMinutes()
         quotaLoop.nextDispose = ctx.timer.timeout(() => {
           quotaLoop.nextDispose = null
@@ -1350,7 +1401,7 @@ window.__ModuleLoader__.load({
         }, minutes * 60000)
       }
       function runQuotaCycle() {
-        if (quotaLoop.refs === 0 || quotaLoop.running) return
+        if (!featureEnabled('quotaLookup') || quotaLoop.refs === 0 || quotaLoop.running) return
         // 额度页打开时全量；其余自动/后台轮询只刷新 running 会话供应商。
         const payload = quotaLoop.allRefs > 0 ? { scope: 'all' } : { providers: runningQuotaProviders() }
         if (payload.scope !== 'all' && payload.providers.length === 0) return
@@ -1361,6 +1412,7 @@ window.__ModuleLoader__.load({
         })
       }
       function acquireQuotaLoop(options = {}) {
+        if (!featureEnabled('quotaLookup')) return
         quotaLoop.refs += 1
         if (options.all === true) quotaLoop.allRefs += 1
         // 额度页显式全量；圆环等其他表面由当前交互/后台活跃集合决定目标。
@@ -1377,6 +1429,7 @@ window.__ModuleLoader__.load({
         }
       }
       function releaseQuotaLoop(options = {}) {
+        if (!featureEnabled('quotaLookup') && quotaLoop.refs === 0) return
         quotaLoop.refs = Math.max(0, quotaLoop.refs - 1)
         if (options.all === true) quotaLoop.allRefs = Math.max(0, quotaLoop.allRefs - 1)
         if (quotaLoop.refs > 0) return
@@ -1517,6 +1570,33 @@ window.__ModuleLoader__.load({
         resetNode)
       }
 
+      // v0.21.1 圆环弹窗窄视口居中：宿主事实（别再翻外壳源码）——composer 工具行容器带
+      // container-type:inline-size（布局包含：fixed 后代的 containing block 是它而非视口），
+      // 外层会话滚动体又是 overflow:hidden auto，挂在 conversation.input.right 的弹层在手机上
+      // 必然被裁一半，CSS 覆盖救不了。唯一可靠解法是 portal 到 document.body 后 fixed 视口居中。
+      // react-dom 在平台 seed 表内（官方附件插件同源用 createPortal），老外壳可能缺席：
+      // 惰性尝试，拿不到就回落原锚定弹层（与 modelDirectories 同款可选依赖哲学）。
+      let quotaCreatePortal = null
+      try {
+        const reactDom = require('react-dom')
+        if (reactDom !== null && reactDom !== undefined && typeof reactDom.createPortal === 'function') {
+          quotaCreatePortal = reactDom.createPortal
+        }
+      } catch (_) {
+        quotaCreatePortal = null
+      }
+
+      /** 窄视口判定：matchMedia 优先（可订阅变化），缺席时 innerWidth 兜底；
+       * 无 window（SSR/测试）一律宽视口，维持圆环上方锚定弹层。断点 480px 与外壳窄容器一致。 */
+      function quotaNarrowViewport() {
+        if (typeof window === 'undefined' || window === null) return false
+        if (typeof window.matchMedia === 'function') {
+          const query = window.matchMedia('(max-width: 480px)')
+          return typeof query.matches === 'boolean' ? query.matches : false
+        }
+        return typeof window.innerWidth === 'number' && window.innerWidth <= 480
+      }
+
       function QuotaRing(props) {
         const translate = useTranslation()
         const [quota, setQuota] = useState(quotaStore.getSnapshot())
@@ -1540,6 +1620,22 @@ window.__ModuleLoader__.load({
         }, [store, directoryState, props && props.loadDirectory])
         const [open, setOpen] = useState(false)
         const rootRef = useRef(null)
+        const panelRef = useRef(null)
+        // 窄视口（手机竖屏）：弹层 portal 到 body 视口居中；宽视口保持圆环上方锚定。
+        // matchMedia change 订阅让旋转/拖宽窗口时弹层几何实时迁移，open 态不丢。
+        const [narrow, setNarrow] = useState(quotaNarrowViewport)
+        useEffect(() => {
+          if (typeof window === 'undefined' || window === null || typeof window.matchMedia !== 'function') return undefined
+          const query = window.matchMedia('(max-width: 480px)')
+          const sync = () => setNarrow(query.matches)
+          sync()
+          if (typeof query.addEventListener === 'function') query.addEventListener('change', sync)
+          else if (typeof query.addListener === 'function') query.addListener(sync)
+          return () => {
+            if (typeof query.removeEventListener === 'function') query.removeEventListener('change', sync)
+            else if (typeof query.removeListener === 'function') query.removeListener(sync)
+          }
+        }, [])
         const provider = directoryState?.current?.provider ?? null
         const row = provider !== null ? (quota.providers || []).find((entry) => entry.provider === provider && entry.adapted === true) : null
         const windows = Array.isArray(row?.windows) ? row.windows : []
@@ -1564,6 +1660,8 @@ window.__ModuleLoader__.load({
           if (!open || typeof document === 'undefined') return undefined
           const onPointerDown = (event) => {
             if (rootRef.current && event.target instanceof Node && rootRef.current.contains(event.target)) return
+            // portal 模式下面板挂在 body 下、不在 rootRef 子树内：点面板本体不算外点。
+            if (panelRef.current && event.target instanceof Node && panelRef.current.contains(event.target)) return
             setOpen(false)
           }
           const onKeyDown = (event) => {
@@ -1595,8 +1693,11 @@ window.__ModuleLoader__.load({
           ? React.createElement('div', { style: { marginTop: '8px', fontSize: '11px', color: 'var(--dsw-alias-label-tertiary)' } },
               row.refreshing === true ? translate('quota.refreshing') : translate('quota.updated', { time: formatClockTime(row.fetchedAt) }))
           : null
-        return React.createElement('span', { ref: rootRef, style: { position: 'relative', display: 'inline-flex' } },
-          React.createElement('button', {
+        // 面板先构造、再决定挂载方式：窄视口 portal 到 document.body 后 fixed 视口居中
+        // （根因见 quotaCreatePortal 处注释）；宽视口或 react-dom 缺席时锚定圆环上方（原行为）。
+        const centered = open && narrow && quotaCreatePortal !== null
+          && typeof document !== 'undefined' && document.body !== null && document.body !== undefined
+        const triggerNode = React.createElement('button', {
             type: 'button',
             'data-testid': 'quota-ring-trigger',
             'aria-label': ariaText,
@@ -1617,13 +1718,16 @@ window.__ModuleLoader__.load({
               cx: '7', cy: '7', r: radius, fill: 'none', stroke: color, strokeWidth: '2', strokeLinecap: 'round',
               strokeDasharray: `${(circumference * percent) / 100} ${circumference}`,
               transform: 'rotate(-90 7 7)',
-            }))),
-          open ? React.createElement('div', {
-            role: 'dialog',
-            'aria-label': translate('quota.panel.title'),
-            'data-testid': 'quota-ring-panel',
-            style: { position: 'absolute', bottom: 'calc(100% + 8px)', right: 0, zIndex: 100, boxSizing: 'border-box', width: '240px', padding: '12px', borderRadius: '12px', background: 'var(--dsw-specific-menu)', border: '1px solid var(--dsw-alias-border-inverted)', boxShadow: 'var(--dsw-shadow-lv3)' },
-          },
+            })))
+        const panelNode = open ? React.createElement('div', {
+          ref: panelRef,
+          role: 'dialog',
+          'aria-label': translate('quota.panel.title'),
+          'data-testid': 'quota-ring-panel',
+          style: centered
+            ? { position: 'fixed', left: '50%', top: '50%', transform: 'translate(-50%, -50%)', zIndex: 1000, boxSizing: 'border-box', width: 'min(280px, calc(100vw - 32px))', maxHeight: 'calc(100dvh - 96px)', overflowY: 'auto', padding: '12px', borderRadius: '12px', background: 'var(--dsw-specific-menu)', border: '1px solid var(--dsw-alias-border-inverted)', boxShadow: 'var(--dsw-shadow-lv3)' }
+            : { position: 'absolute', bottom: 'calc(100% + 8px)', right: 0, zIndex: 100, boxSizing: 'border-box', width: '240px', padding: '12px', borderRadius: '12px', background: 'var(--dsw-specific-menu)', border: '1px solid var(--dsw-alias-border-inverted)', boxShadow: 'var(--dsw-shadow-lv3)' },
+        },
           React.createElement('div', { style: { display: 'flex', alignItems: 'baseline', gap: '6px' } },
             React.createElement('span', { style: { fontSize: '12px', color: 'var(--dsw-alias-label-tertiary)' } }, usedWord),
             React.createElement('span', { style: { marginLeft: 'auto', fontSize: '11px', color: 'var(--dsw-alias-label-secondary)' } }, provider)),
@@ -1643,7 +1747,62 @@ window.__ModuleLoader__.load({
                 }))]
             : []),
           errorNode,
-          updatedNode) : null)
+          updatedNode) : null
+        return React.createElement('span', { ref: rootRef, style: { position: 'relative', display: 'inline-flex' } },
+          triggerNode,
+          centered ? quotaCreatePortal(panelNode, document.body) : panelNode)
+      }
+
+      function FeatureSettingsCard() {
+        const translate = useTranslation()
+        const { snapshot, value } = useFeatures()
+        const [open, setOpen] = React.useState(false)
+        const [saving, setSaving] = React.useState('')
+        const writable = snapshot.status === 'ready' && snapshot.writable === true
+        const row = (key) => React.createElement('div', {
+          key,
+          style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: '14px', padding: '7px 0' },
+        },
+        React.createElement('span', { style: { fontSize: '13px', color: 'var(--dsw-alias-label-primary)' } }, translate('features.' + key)),
+        React.createElement('button', {
+          type: 'button',
+          role: 'switch',
+          'data-testid': 'feature-switch-' + key,
+          'aria-checked': String(value[key] !== false),
+          disabled: !writable || saving !== '',
+          onClick: async () => {
+            setSaving(key)
+            try { await featureScope.set(key, value[key] === false) } catch (_) {}
+            setSaving('')
+          },
+          style: { width: '34px', height: '20px', borderRadius: '10px', padding: 0, flexShrink: 0, position: 'relative', border: '1px solid ' + (value[key] !== false ? 'var(--dsw-alias-state-success-primary)' : 'var(--dsw-alias-border-l2)'), background: value[key] !== false ? 'var(--dsw-alias-state-success-primary)' : 'var(--dsw-alias-bg-layer-2)', cursor: writable && saving === '' ? 'pointer' : 'default', opacity: writable ? 1 : 0.5, lineHeight: 0 },
+        }, React.createElement('span', { style: { position: 'absolute', top: '1px', left: value[key] !== false ? '15px' : '1px', width: '16px', height: '16px', borderRadius: '50%', background: value[key] !== false ? '#fff' : 'var(--dsw-alias-label-tertiary)' } })))
+        return React.createElement('li', {
+          style: { listStyle: 'none', border: '1px solid ' + (open ? 'var(--dsw-alias-label-dimmed)' : 'var(--dsw-alias-border-l2)'), borderRadius: '12px', color: 'var(--dsw-alias-label-primary)', background: open ? 'var(--dsw-alias-bg-layer-2)' : 'var(--dsw-alias-bg-layer-3)' },
+        },
+        React.createElement('button', {
+          type: 'button',
+          'data-testid': 'feature-card-toggle',
+          'aria-expanded': String(open),
+          onClick: () => setOpen(!open),
+          style: { appearance: 'none', width: '100%', display: 'flex', alignItems: 'center', gap: '12px', padding: '14px 16px', border: 0, borderRadius: '12px', background: 'transparent', color: 'inherit', font: 'inherit', textAlign: 'left', cursor: 'pointer' },
+        },
+        React.createElement('span', { style: { display: 'flex', minWidth: 0, flex: 1, flexDirection: 'column', gap: '4px' } },
+          React.createElement('span', { style: { fontSize: '15px', fontWeight: 600, lineHeight: 1.4 } }, translate('features.cardTitle')),
+          React.createElement('span', { style: { fontSize: '13px', lineHeight: 1.5, color: 'var(--dsw-alias-label-tertiary)' } }, translate('features.cardHint'))),
+        React.createElement('svg', {
+          viewBox: '0 0 14 14',
+          width: 14,
+          height: 14,
+          'aria-hidden': 'true',
+          style: { flex: 'none', color: 'var(--dsw-alias-label-tertiary)', transform: open ? 'rotate(180deg)' : 'none', transition: 'transform .16s' },
+        }, React.createElement('path', { d: 'M3 5.25 7 9l4-3.75', fill: 'none', stroke: 'currentColor', strokeWidth: 1.4, strokeLinecap: 'round', strokeLinejoin: 'round' }))),
+        open ? React.createElement('div', { style: { margin: '0 16px', padding: '12px 0 8px', borderTop: '1px solid var(--dsw-alias-border-l2)' } },
+          React.createElement('div', { style: { fontSize: '12px', fontWeight: 700 } }, translate('features.optional')),
+          ['modelUsage', 'quotaLookup', 'backupMaintenance', 'taskNotifications'].map(row),
+          React.createElement('div', { style: { fontSize: '12px', fontWeight: 700, marginTop: '8px', paddingTop: '10px', borderTop: '1px solid var(--dsw-alias-border-l1)' } }, translate('features.external')),
+          row('healthz'),
+          !writable ? React.createElement('p', { style: { margin: '6px 0 0', fontSize: '11px', color: 'var(--dsw-alias-label-tertiary)' } }, translate('features.readOnly')) : null) : null)
       }
 
       function QuotaSection() {
@@ -1907,6 +2066,7 @@ window.__ModuleLoader__.load({
 
       function ServicePanel() {
         const translate = useTranslation()
+        const { value: features } = useFeatures()
         const [health, setHealth] = useState(null)
         const [healthError, setHealthError] = useState(null)
         const [diagnostics, setDiagnostics] = useState(null)
@@ -1984,6 +2144,7 @@ window.__ModuleLoader__.load({
           return () => { active = false }
         }, [])
         useEffect(() => {
+          if (!featureEnabled('modelUsage')) return () => {}
           let active = true
           ctx.connection.rpc.call('/dsh-service', 'usage', usageRequestPayload).then(async (res) => {
             if (!active) return
@@ -1998,8 +2159,9 @@ window.__ModuleLoader__.load({
             if (active) setUsageError(translate('usage.error'))
           })
           return () => { active = false }
-        }, [])
+        }, [features.modelUsage])
         useEffect(() => {
+          if (!featureEnabled('backupMaintenance')) return () => {}
           let active = true
           ctx.connection.rpc.call('/dsh-service', 'backup-list', {}).then((res) => {
             if (!active) return
@@ -2009,7 +2171,7 @@ window.__ModuleLoader__.load({
             if (active) setBackupError(translate('backup.error'))
           })
           return () => { active = false }
-        }, [])
+        }, [features.backupMaintenance])
         useEffect(() => {
           let active = true
           let cancelNext = () => {}
@@ -2760,25 +2922,26 @@ window.__ModuleLoader__.load({
         }
         const tabs = [
           ['overview', 'tabs.overview'],
-          ['notify', 'tabs.notify'],
+          ...(features.taskNotifications !== false ? [['notify', 'tabs.notify']] : []),
           ['health', 'tabs.health'],
-          ['usage', 'tabs.usage'],
-          ['quota', 'tabs.quota'],
-          ['backup', 'tabs.backup'],
+          ...(features.modelUsage !== false ? [['usage', 'tabs.usage']] : []),
+          ...(features.quotaLookup !== false ? [['quota', 'tabs.quota']] : []),
+          ...(features.backupMaintenance !== false ? [['backup', 'tabs.backup']] : []),
           ['restart', 'tabs.restart'],
         ]
         const warningTabs = tabs.filter(([id]) => tabWarnings[id]).map(([, label]) => translate(label))
-        const tabContent = activeTab === 'overview'
+        const visibleActiveTab = tabs.some(([id]) => id === activeTab) ? activeTab : 'overview'
+        const tabContent = visibleActiveTab === 'overview'
           ? overviewBlock
-          : activeTab === 'notify'
+          : visibleActiveTab === 'notify'
             ? notifyBlock
-            : activeTab === 'health'
+            : visibleActiveTab === 'health'
               ? healthBlock
-              : activeTab === 'usage'
+              : visibleActiveTab === 'usage'
                 ? usageBlock
-                : activeTab === 'quota'
+                : visibleActiveTab === 'quota'
                   ? React.createElement(RemoteQuotaCard, null)
-                : activeTab === 'backup'
+                : visibleActiveTab === 'backup'
                   ? maintenanceBlock
                   : restartBlock
         return React.createElement('div', null,
@@ -2786,7 +2949,7 @@ window.__ModuleLoader__.load({
             React.createElement('div', { style: { fontSize: '13px', fontWeight: 700 } }, translate('tabs.alert.title')),
             React.createElement('div', { style: Object.assign({}, hint, { marginTop: '3px' }) }, translate('tabs.alert.body', { tabs: warningTabs.join('、') }))) : null,
           React.createElement('div', { 'data-testid': 'tab-list', style: { display: 'flex', gap: '10px', flexWrap: 'wrap', borderBottom: '1px solid var(--dsw-alias-border-l1)' } },
-            tabs.map(([id, label]) => React.createElement('button', { key: id, style: Object.assign({}, inlineTab, activeTab === id ? inlineTabActive : { color: tabWarnings[id] ? 'var(--dsw-alias-state-warn-primary)' : 'var(--dsw-alias-label-secondary)', borderBottom: '2px solid transparent' }), onClick: () => { setActiveTab(id); if (id === 'health') runDiagnostics(false) } }, `${tabWarnings[id] ? '⚠ ' : ''}${translate(label)}`))),
+            tabs.map(([id, label]) => React.createElement('button', { key: id, style: Object.assign({}, inlineTab, visibleActiveTab === id ? inlineTabActive : { color: tabWarnings[id] ? 'var(--dsw-alias-state-warn-primary)' : 'var(--dsw-alias-label-secondary)', borderBottom: '2px solid transparent' }), onClick: () => { setActiveTab(id); if (id === 'health') runDiagnostics(false) } }, `${tabWarnings[id] ? '⚠ ' : ''}${translate(label)}`))),
           React.createElement('div', { 'data-testid': 'tab-panel', style: tabPanel }, tabContent))
       }
 
@@ -2815,14 +2978,28 @@ window.__ModuleLoader__.load({
           },
         }, BellIcon(enabled))
       }
-      ctx.slots.inject('conversation.input.left', () => ctx.slots.register(
-        { name: 'conversation.input.left', id: 'dsh-service-notify', order: 90, label: () => t('notification.bellOn') },
-        () => React.createElement(InlineNotifyBell, null),
-      ))
+      ctx.slots.inject('conversation.input.left', () => {
+        let dispose = null
+        const sync = () => {
+          if (dispose !== null) { dispose(); dispose = null }
+          if (!featureEnabled('taskNotifications')) return
+          dispose = ctx.slots.register(
+            { name: 'conversation.input.left', id: 'dsh-service-notify', order: 90, label: () => t('notification.bellOn') },
+            () => React.createElement(InlineNotifyBell, null),
+          )
+        }
+        sync()
+        const unsubscribe = featureScope.subscribe(sync)
+        return () => { unsubscribe(); if (dispose !== null) dispose() }
+      })
       ctx.slots.inject('sidebar.footer.action', () => ctx.slots.register(
         { name: 'sidebar.footer.action', id: 'dsh-service-update', order: 90, label: () => t('update.badge') },
         () => React.createElement(UpdateBadge, null),
       ))
+      ctx.slots.inject('settings.plugin.item', () => ctx.slots.register(
+        { name: 'settings.plugin.item', id: 'dsh-service', key: 'dsh-service', order: 40 },
+        () => React.createElement(FeatureSettingsCard, null),
+      ))
       ctx.slots.inject('settings.section', () => {
         const disposePanel = ctx.slots.register(
           { name: 'settings.section', id: 'dsh-service', order: 99, label: () => t('nav.label') },
@@ -2831,7 +3008,9 @@ window.__ModuleLoader__.load({
         // 左列「重启」「额度查询」入口由各自标签内的开关控制，默认不注册
         syncRestartNavEntry()
         syncQuotaNavEntry()
+        const unsubscribeFeatures = featureScope.subscribe(syncQuotaNavEntry)
         return () => {
+          unsubscribeFeatures()
           disposePanel()
           if (restartNavDispose) {
             restartNavDispose()
@@ -2852,31 +3031,41 @@ window.__ModuleLoader__.load({
       // （老版本 DSH 没有）。槽位条目无条件注册，服务在条目渲染时（inject(sessionId)）
       // 经 ctx.get 惰性解析——此时会话已渲染、model-selection 必然已挂载，不受注入时序影响；
       // 拿不到服务时 props 为空，QuotaRing 渲染 null 且不启动轮询，其他功能零影响。
-      ctx.slots.inject('conversation.input.right', () => ctx.slots.register({
-        name: 'conversation.input.right',
-        id: 'dsh-service-quota-ring',
-        order: 95,
-        label: () => t('quota.ring.label'),
-        inject: (sessionId) => {
-          if (sessionId === undefined || sessionId === null) return {}
-          try {
-            const models = getModelDirectories()
-            if (models === undefined || typeof models.directoryFor !== 'function') return {}
-            const directory = models.directoryFor(sessionId)
-            return {
-              directoryStore: directory.store,
-              loadDirectory: () => {
-                try {
-                  const pending = directory.load()
-                  if (pending && typeof pending.catch === 'function') pending.catch(() => {})
-                } catch (_) {}
-              },
-            }
-          } catch (_) {
-            return {}
-          }
-        },
-      }, (props) => React.createElement(QuotaRing, props)))
+      ctx.slots.inject('conversation.input.right', () => {
+        let dispose = null
+        const sync = () => {
+          if (dispose !== null) { dispose(); dispose = null }
+          if (!featureEnabled('quotaLookup')) return
+          dispose = ctx.slots.register({
+            name: 'conversation.input.right',
+            id: 'dsh-service-quota-ring',
+            order: 95,
+            label: () => t('quota.ring.label'),
+            inject: (sessionId) => {
+              if (sessionId === undefined || sessionId === null) return {}
+              try {
+                const models = getModelDirectories()
+                if (models === undefined || typeof models.directoryFor !== 'function') return {}
+                const directory = models.directoryFor(sessionId)
+                return {
+                  directoryStore: directory.store,
+                  loadDirectory: () => {
+                    try {
+                      const pending = directory.load()
+                      if (pending && typeof pending.catch === 'function') pending.catch(() => {})
+                    } catch (_) {}
+                  },
+                }
+              } catch (_) {
+                return {}
+              }
+            },
+          }, (props) => React.createElement(QuotaRing, props))
+        }
+        sync()
+        const unsubscribe = featureScope.subscribe(sync)
+        return () => { unsubscribe(); if (dispose !== null) dispose() }
+      })
     }
 
     exports.inject = inject

package/index.js

@@ -9,12 +9,28 @@ import { basename, dirname, join, relative, resolve, sep } from 'node:path'
 import { createRequire } from 'node:module'
 import { fileURLToPath } from 'node:url'
 import https from 'node:https'
+import z from '@deepseek-ai/schemastery'
 
 const require = createRequire(import.meta.url)
 const name = 'dsh-service'
 const inject = ['connection']
 const DSH_PACKAGE = '@deepseek-ai/dsh'
 const PLUGIN_PACKAGE = '@gehennawu/dsh-service'
+const SETTINGS_NAMESPACE = 'dsh-service'
+const DEFAULT_FEATURE_SETTINGS = Object.freeze({
+  modelUsage: true,
+  quotaLookup: true,
+  backupMaintenance: true,
+  taskNotifications: true,
+  healthz: true,
+})
+const FeatureSettingsSchema = z.object({
+  modelUsage: z.boolean().default(true),
+  quotaLookup: z.boolean().default(true),
+  backupMaintenance: z.boolean().default(true),
+  taskNotifications: z.boolean().default(true),
+  healthz: z.boolean().default(true),
+})
 const NPM_REGISTRY = 'https://registry.npmjs.org/'
 const MAX_NPM_RESPONSE_BYTES = 256 * 1024
 const MAX_BACKUP_TRANSFER_BYTES = 128 * 1024 * 1024
@@ -1800,6 +1816,25 @@ function scheduleRestart(ctx) {
 
 function apply(ctx) {
   const dshHome = resolveDshHome()
+  let featureSettings = DEFAULT_FEATURE_SETTINGS
+  const featureSettingsListeners = new Set()
+  const publishFeatureSettings = () => {
+    for (const listener of featureSettingsListeners) listener(featureSettings)
+  }
+  ctx.inject(['settings'], (settingsCtx) => {
+    try {
+      const scope = settingsCtx.settings.register(SETTINGS_NAMESPACE, FeatureSettingsSchema, { base: DEFAULT_FEATURE_SETTINGS })
+      featureSettings = scope.get()
+      publishFeatureSettings()
+      if (typeof scope.watch === 'function') settingsCtx.effect(() => scope.watch((value) => {
+        featureSettings = value ?? scope.get()
+        publishFeatureSettings()
+      }), 'dsh-service feature settings watch')
+    } catch (error) {
+      ctx.logger?.warn?.(`dsh-service: feature settings unavailable: ${error?.message || error}`)
+    }
+  })
+  const featureEnabled = (key) => featureSettings?.[key] !== false
   // 进程运行环境在生命周期内不变：挂载时探测一次，version RPC 与升级分支共用。
   const runtimeEnv = detectRuntimeEnv()
   const permissionPlans = new Map()
@@ -1965,19 +2000,33 @@ function apply(ctx) {
   }
   const webServer = ctx.get('webServer')
   if (webServer !== undefined) {
-    ctx.effect(() => webServer.register({
-      kind: 'exact',
-      path: '/healthz',
-      handler: (req, res) => {
-        if (req.method !== 'GET' && req.method !== 'HEAD') {
-          res.writeHead(405)
+    let healthzDispose = null
+    const syncHealthzRoute = () => {
+      if (healthzDispose !== null) {
+        healthzDispose()
+        healthzDispose = null
+      }
+      if (!featureEnabled('healthz')) return
+      healthzDispose = webServer.register({
+        kind: 'exact',
+        path: '/healthz',
+        handler: (req, res) => {
+          if (req.method !== 'GET' && req.method !== 'HEAD') {
+            res.writeHead(405)
+            res.end()
+            return
+          }
+          res.writeHead(200)
           res.end()
-          return
-        }
-        res.writeHead(200)
-        res.end()
-      },
-    }), 'dsh-service healthz route')
+        },
+      })
+    }
+    syncHealthzRoute()
+    featureSettingsListeners.add(syncHealthzRoute)
+    ctx.effect(() => () => {
+      featureSettingsListeners.delete(syncHealthzRoute)
+      if (healthzDispose !== null) healthzDispose()
+    }, 'dsh-service healthz route')
     ctx.effect(() => webServer.register({
       kind: 'exact',
       path: '/dsh-backup-download',
@@ -2071,6 +2120,7 @@ function apply(ctx) {
     }
 
     if (endpoint === 'usage') {
+      if (!featureEnabled('modelUsage')) return { ok: false, error: 'feature-disabled' }
       try {
         return { ok: true, value: publicUsage(await usageIndexPromise, payload?.timezoneOffsetMinutes) }
       } catch (error) {
@@ -2079,6 +2129,7 @@ function apply(ctx) {
     }
 
     if (endpoint === 'usage-refresh') {
+      if (!featureEnabled('modelUsage')) return { ok: false, error: 'feature-disabled' }
       try {
         if (usageRefreshPromise === undefined) {
           usageRefreshPromise = usageIndexPromise.then((index) => refreshUsageIndex(ctx, dshHome, index)).finally(() => { usageRefreshPromise = undefined })
@@ -2118,6 +2169,7 @@ function apply(ctx) {
     }
 
     if (endpoint === 'backup-list') {
+      if (!featureEnabled('backupMaintenance')) return { ok: false, error: 'feature-disabled' }
       try {
         return { ok: true, value: await listBackups(dshHome) }
       } catch (error) {
@@ -2126,6 +2178,7 @@ function apply(ctx) {
     }
 
     if (endpoint === 'backup-create') {
+      if (!featureEnabled('backupMaintenance')) return { ok: false, error: 'feature-disabled' }
       try {
         return { ok: true, value: await createBackup(ctx, dshHome) }
       } catch (error) {
@@ -2134,6 +2187,7 @@ function apply(ctx) {
     }
 
     if (endpoint === 'backup-export') {
+      if (!featureEnabled('backupMaintenance')) return { ok: false, error: 'feature-disabled' }
       try {
         const value = await exportBackup(dshHome, downloadTokens, payload?.id)
         if (value === undefined) return { ok: false, error: 'unknown-backup' }
@@ -2144,6 +2198,7 @@ function apply(ctx) {
     }
 
     if (endpoint === 'backup-delete') {
+      if (!featureEnabled('backupMaintenance')) return { ok: false, error: 'feature-disabled' }
       try {
         const value = await deleteBackup(dshHome, payload?.id)
         if (value === undefined) return { ok: false, error: 'unknown-backup' }
@@ -2154,6 +2209,7 @@ function apply(ctx) {
     }
 
     if (endpoint === 'backup-restore') {
+      if (!featureEnabled('backupMaintenance')) return { ok: false, error: 'feature-disabled' }
       try {
         const value = await restoreBackup(ctx, dshHome, payload?.id)
         if (value === undefined) return { ok: false, error: 'unknown-backup' }
@@ -2165,6 +2221,7 @@ function apply(ctx) {
     }
 
     if (endpoint === 'backup-import') {
+      if (!featureEnabled('backupMaintenance')) return { ok: false, error: 'feature-disabled' }
       try {
         const value = await importBackup(dshHome, payload?.name, payload?.data)
         if (value === undefined) return { ok: false, error: 'invalid-backup' }
@@ -2175,6 +2232,7 @@ function apply(ctx) {
     }
 
     if (endpoint === 'quota') {
+      if (!featureEnabled('quotaLookup')) return { ok: false, error: 'feature-disabled' }
       try {
         const providers = readLlmProviders(ctx.get('settings'))
         quotaThrottle.prune(new Set(providers.map((profile) => profile.name)))
@@ -2226,6 +2284,7 @@ function apply(ctx) {
     }
 
     if (endpoint === 'quota-refresh') {
+      if (!featureEnabled('quotaLookup')) return { ok: false, error: 'feature-disabled' }
       try {
         // 手动刷新入口：provider 过白名单且 kind 已适配；清掉节流闸后立即 kick。
         // 单飞仍生效（在途时本次点击为 no-op）；上游结果经后续 quota 快照带出，不在此等待。
@@ -2248,6 +2307,7 @@ function apply(ctx) {
     }
 
     if (endpoint === 'quota-config') {
+      if (!featureEnabled('quotaLookup')) return { ok: false, error: 'feature-disabled' }
       try {
         const providerName = typeof payload?.provider === 'string' ? payload.provider : ''
         // 三种写法，语义对齐配置文件解析（显式 kind > 显式 null 停用 > 自动推断）：
@@ -2273,6 +2333,7 @@ function apply(ctx) {
     }
 
     if (endpoint === 'quota-reset-card') {
+      if (!featureEnabled('quotaLookup')) return { ok: false, error: 'feature-disabled' }
       try {
         // 手录重置卡（v0.19 过渡方案；v0.20 免次数、每 provider 可多条）的面板写入口：
         // provider 过宿主清单白名单；{remove:true,id} 删除宿主下发 id 对应的那一条，

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gehennawu/dsh-service",
-  "version": "0.20.0",
+  "version": "0.21.1",
   "description": "DSH Web 自托管运维面板：安全重启、健康监控、备份和 Linux 权限维护。",
   "type": "module",
   "scripts": {
@@ -40,6 +40,9 @@
   "engines": {
     "node": ">=22"
   },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1"
+  },
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"