@hedeqiang/dsh-nl2sql 0.14.4 → 0.14.5

package/CHANGELOG.md

@@ -5,6 +5,11 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [0.14.5] - 2026-11-13
+
+### Changed
+- **Data health settings** are laid out like the Settings page: two groups (Data freshness, Data quality patrol) with switches and one explanation per row; a group's fields are hidden while it is off. With freshness off, its table and events are no longer shown on the Data health page either — just a note and the switch.
+
 ## [0.14.4] - 2026-11-13
 
 ### Added
@@ -164,7 +169,8 @@ These features are tested with local databases and fake IM / Lark servers; real
 
 - Redesigned UI; Lark push (Markdown and native charts); access control, feedback loop, dashboard global filters; PostgreSQL / Elasticsearch, SSH tunnels, privacy settings, automatic overviews, scheduled reports; semantic layer, ER graph, scan guard, history and audit, dashboards; first version.
 
-[Unreleased]: https://github.com/hedeqiang/dsh-nl2sql/compare/v0.14.4...HEAD
+[Unreleased]: https://github.com/hedeqiang/dsh-nl2sql/compare/v0.14.5...HEAD
+[0.14.5]: https://github.com/hedeqiang/dsh-nl2sql/compare/v0.14.4...v0.14.5
 [0.14.4]: https://github.com/hedeqiang/dsh-nl2sql/compare/v0.14.3...v0.14.4
 [0.14.3]: https://github.com/hedeqiang/dsh-nl2sql/compare/v0.14.2...v0.14.3
 [0.14.2]: https://github.com/hedeqiang/dsh-nl2sql/compare/v0.14.1...v0.14.2

package/lib/client.js

@@ -17,7 +17,20 @@ window.__ModuleLoader__.load({
     // ------------------------------------------------------------ locale
 
     const zh = {
-      'fq.set.showInUi': "在页面上显示数据新鲜度（查询结果下的滞后提示、表结构页的新鲜度面板）",
+      'fq.admin.fOffNote': "数据新鲜度已关闭：不检查、不推送，页面上也不显示。需要时在下方「设置」中开启。",
+      'fq.set.gFresh': "数据新鲜度",
+      'fq.set.gQuality': "数据质量巡检",
+      'fq.set.fEnabledShort': "启用",
+      'fq.set.fEnabledHint': "定时检查各表最新数据时间，滞后时推送通知；Agent 回答「今天 / 昨天」等近期数据前会先检查。关闭后以上全部停止，页面上也不再显示。",
+      'fq.set.showShort': "在页面上显示",
+      'fq.set.showHint': "查询结果下方的「数据滞后」提示和表结构页的新鲜度面板。隐藏后仍会定时检查和推送通知。",
+      'fq.set.staleHint': "超过这个时长没有新数据即视为滞后；每张表可在上方表格单独设置，0 表示不监控。",
+      'fq.set.fChannelHint': "每次滞后只推送一次，恢复时再推送一次。",
+      'fq.set.qEnabledHint': "每天定时检查空值、重复键、异常值、未来时间与负值，并给出健康分。",
+      'fq.set.on': "已开启",
+      'fq.set.off': "已关闭",
+      'fq.set.shown': "显示",
+      'fq.set.hidden': "已隐藏",
       'mcp.client.claudeCode': 'Claude Code', 'mcp.client.cline': 'Cline', 'mcp.client.windsurf': 'Windsurf', 'mcp.client.codex': 'Codex CLI', 'mcp.client.gemini': 'Gemini CLI', 'mcp.client.zed': 'Zed', 'mcp.client.continue': 'Continue',
       'mcp.where.claudeCode': '在终端运行（HTTP 直连；下方为 stdio 桥接写法）。', 'mcp.where.cline': '写入 cline_mcp_settings.json（Cline 面板 → MCP Servers → Configure）。', 'mcp.where.windsurf': '写入 Windsurf 的 mcp_config.json（Cascade → MCP → 打开配置文件）。', 'mcp.where.codex': '写入 ~/.codex/config.toml（或项目的 .codex/config.toml）。', 'mcp.where.gemini': '写入 ~/.gemini/settings.json 或项目的 .gemini/settings.json。', 'mcp.where.zed': '写入 Zed 的 settings.json。', 'mcp.where.continue': '保存为工作区 .continue/mcpServers/nl2sql.yaml。',
       'mcp.test': '测试连接', 'mcp.testOk': '连接正常：发现 {n} 个工具。', 'mcp.testFail': '连接失败：{error}', 'mcp.testFailSteps': '连接测试未通过：',
@@ -81,7 +94,6 @@ window.__ModuleLoader__.load({
       "fq.admin.qOff": "每日质量巡检已关闭",
       "fq.admin.noDs": "请先添加数据源",
       "fq.set.title": "设置",
-      "fq.set.fEnabled": "启用数据新鲜度（定时检查、滞后通知、Agent 回答近期数据时的提醒）；关闭后页面上也不再显示",
       "fq.set.qEnabled": "每日数据质量巡检",
       "fq.set.interval": "新鲜度检查间隔（分钟）",
       "fq.set.time": "质量巡检时间",
@@ -90,7 +102,6 @@ window.__ModuleLoader__.load({
       "fq.set.fChannel": "数据延迟通知渠道",
       "fq.set.qChannel": "健康分下降通知渠道",
       "fq.set.noPush": "不推送",
-      "fq.set.hint": "每张表的阈值可在上方表格中单独设置（0 表示不监控）；延迟通知每个滞后周期只推送一次，恢复时再推送一次。",
       "fq.saved": "已保存",
       'pro.close': '关闭', 'pro.sendNow': '立即推送', 'pro.sent': '已推送', 'pro.deleteConfirm': '删除「{name}」？', 'pro.weekday': '星期',
       'pro.wd.0': '周日', 'pro.wd.1': '周一', 'pro.wd.2': '周二', 'pro.wd.3': '周三', 'pro.wd.4': '周四', 'pro.wd.5': '周五', 'pro.wd.6': '周六',
@@ -1179,7 +1190,20 @@ window.__ModuleLoader__.load({
       'policy.tablesLabel': '可访问的表',
     }
     const en = {
-      'fq.set.showInUi': "Show data freshness on the page (stale-data bars under results, the freshness panel in Schema)",
+      'fq.admin.fOffNote': "Data freshness is off: no checks, no notifications, nothing shown on the page. Turn it on in Settings below.",
+      'fq.set.gFresh': "Data freshness",
+      'fq.set.gQuality': "Data quality patrol",
+      'fq.set.fEnabledShort': "Enabled",
+      'fq.set.fEnabledHint': "Checks the latest timestamp of every table on a schedule and notifies when data stops updating; the agent checks it before answering about recent periods. When off, all of this stops and nothing is shown on the page.",
+      'fq.set.showShort': "Show on the page",
+      'fq.set.showHint': "Stale-data bars under results and the freshness panel in Schema. Checks and notifications keep running when hidden.",
+      'fq.set.staleHint': "Data older than this counts as stale; set per-table thresholds in the table above (0 = not monitored).",
+      'fq.set.fChannelHint': "One notification per stale episode, and one when it recovers.",
+      'fq.set.qEnabledHint': "Daily check of null rates, duplicate keys, outliers, future timestamps and negative amounts, with a health score.",
+      'fq.set.on': "On",
+      'fq.set.off': "Off",
+      'fq.set.shown': "Shown",
+      'fq.set.hidden': "Hidden",
       'mcp.client.claudeCode': 'Claude Code', 'mcp.client.cline': 'Cline', 'mcp.client.windsurf': 'Windsurf', 'mcp.client.codex': 'Codex CLI', 'mcp.client.gemini': 'Gemini CLI', 'mcp.client.zed': 'Zed', 'mcp.client.continue': 'Continue',
       'mcp.where.claudeCode': 'Run in a terminal (HTTP; the stdio bridge variant is below).', 'mcp.where.cline': 'Add to cline_mcp_settings.json (Cline panel → MCP Servers → Configure).', 'mcp.where.windsurf': 'Add to Windsurf\'s mcp_config.json (Cascade → MCP → open config file).', 'mcp.where.codex': 'Add to ~/.codex/config.toml (or the project\'s .codex/config.toml).', 'mcp.where.gemini': 'Add to ~/.gemini/settings.json or the project\'s .gemini/settings.json.', 'mcp.where.zed': 'Add to Zed\'s settings.json.', 'mcp.where.continue': 'Save as .continue/mcpServers/nl2sql.yaml in the workspace.',
       'mcp.test': 'Test connection', 'mcp.testOk': 'Connected: {n} tools discovered.', 'mcp.testFail': 'Connection failed: {error}', 'mcp.testFailSteps': 'Connection test failed:',
@@ -1243,7 +1267,6 @@ window.__ModuleLoader__.load({
       "fq.admin.qOff": "Daily quality patrol is off",
       "fq.admin.noDs": "Add a data source first",
       "fq.set.title": "Settings",
-      "fq.set.fEnabled": "Enable data freshness (scheduled checks, stale-data notifications, warnings in answers about recent data); when off, nothing is shown on the page either",
       "fq.set.qEnabled": "Daily data quality patrol",
       "fq.set.interval": "Freshness check interval (min)",
       "fq.set.time": "Quality patrol time",
@@ -1252,7 +1275,6 @@ window.__ModuleLoader__.load({
       "fq.set.fChannel": "Delay notification channel",
       "fq.set.qChannel": "Score drop notification channel",
       "fq.set.noPush": "Do not push",
-      "fq.set.hint": "Per-table thresholds can be set in the table above (0 = not monitored). A delay is pushed once per stale episode, and once more when it recovers.",
       "fq.saved": "Saved",
       'pro.close': 'Close', 'pro.sendNow': 'Send now', 'pro.sent': 'Sent', 'pro.deleteConfirm': 'Delete "{name}"?', 'pro.weekday': 'Weekday',
       'pro.wd.0': 'Sunday', 'pro.wd.1': 'Monday', 'pro.wd.2': 'Tuesday', 'pro.wd.3': 'Wednesday', 'pro.wd.4': 'Thursday', 'pro.wd.5': 'Friday', 'pro.wd.6': 'Saturday',
@@ -2369,6 +2391,9 @@ window.__ModuleLoader__.load({
 .n2s-mcp-steps{margin:6px 0 0;padding-left:18px;font-size:12.5px}
 .n2s-mcp-log .n2s-select{max-width:200px}
 .n2s-mcp-logtable td{vertical-align:middle}
+.n2s-fq-settings{padding-top:6px}
+.n2s-fq-setgroup{margin:14px 0 2px;font-size:12.5px;font-weight:600;color:var(--n2s-muted);letter-spacing:.02em}
+.n2s-fq-setgroup:first-child{margin-top:4px}
 /* ---- dashboard v2 ---- */
 .n2s-srcbadge{display:inline-flex;align-items:center;gap:3px;max-width:160px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;flex:none}
 .n2s-seg.small button{height:26px;padding:0 10px;font-size:12px}
@@ -6796,19 +6821,24 @@ window.__ModuleLoader__.load({
           onSaved?.()
         } catch (e) { notifyError(e) }
       })
-      return h('div', { className: 'n2s-card' },
-        h('div', { className: 'n2s-form' },
-          h('label', { className: 'n2s-check' }, h('input', { type: 'checkbox', checked: Boolean(form.freshness.enabled), onChange: e => setF('enabled', e.target.checked) }), t('fq.set.fEnabled')),
-          h('label', { className: 'n2s-check' }, h('input', { type: 'checkbox', checked: form.freshness.showInUi !== false && Boolean(form.freshness.enabled), disabled: !form.freshness.enabled, onChange: e => setF('showInUi', e.target.checked) }), t('fq.set.showInUi')),
-          h('label', { className: 'n2s-check' }, h('input', { type: 'checkbox', checked: Boolean(form.quality.enabled), onChange: e => setQ('enabled', e.target.checked) }), t('fq.set.qEnabled')),
-          h('label', { className: 'n2s-field' }, h('span', null, t('fq.set.interval')), h('input', { className: 'n2s-input', type: 'number', min: 5, max: 1440, value: form.freshness.intervalMin, onChange: e => setF('intervalMin', e.target.value) })),
-          h('label', { className: 'n2s-field' }, h('span', null, t('fq.set.time')), h('input', { className: 'n2s-input', type: 'time', value: form.quality.time, onChange: e => setQ('time', e.target.value) })),
-          h('label', { className: 'n2s-field' }, h('span', null, t('fq.set.staleHours')), h('input', { className: 'n2s-input', type: 'number', min: 0.25, step: 0.25, value: form.freshness.staleHours, onChange: e => setF('staleHours', e.target.value) })),
-          h('label', { className: 'n2s-field' }, h('span', null, t('fq.set.drop')), h('input', { className: 'n2s-input', type: 'number', min: 1, max: 100, value: form.quality.dropPoints, onChange: e => setQ('dropPoints', e.target.value) })),
-          h('div', { className: 'n2s-field' }, h('label', { htmlFor: 'n2s-fq-fch', className: 'n2s-flabel' }, t('fq.set.fChannel')), h(ChannelPicker, { t, id: 'n2s-fq-fch', value: form.freshness.channelId ?? '', noneLabel: t('fq.set.noPush'), onChange: v => setF('channelId', v) })),
-          h('div', { className: 'n2s-field' }, h('label', { htmlFor: 'n2s-fq-qch', className: 'n2s-flabel' }, t('fq.set.qChannel')), h(ChannelPicker, { t, id: 'n2s-fq-qch', value: form.quality.channelId ?? '', noneLabel: t('fq.set.noPush'), onChange: v => setQ('channelId', v) }))),
-        h('div', { className: 'n2s-faint n2s-small', style: { marginTop: 10 } }, t('fq.set.hint')),
-        h('div', { className: 'n2s-row', style: { marginTop: 12, justifyContent: 'flex-end' } },
+      const fOn = Boolean(form.freshness.enabled)
+      const qOn = Boolean(form.quality.enabled)
+      const sw = (checked, onChange, label, disabled) => h('label', { className: 'n2s-switch' }, h('input', { type: 'checkbox', role: 'switch', checked, disabled, 'aria-label': label, onChange: e => onChange(e.target.checked) }), h('span', null, label))
+      const num = (id, value, onChange, attrs) => h('input', { id, className: 'n2s-input', type: 'number', style: { maxWidth: 160 }, value, onChange: e => onChange(e.target.value), ...attrs })
+      const picker = (id, value, onChange) => h('div', { style: { maxWidth: 360 } }, h(ChannelPicker, { t, id, value: value ?? '', noneLabel: t('fq.set.noPush'), onChange }))
+      return h('div', { className: 'n2s-card n2s-fq-settings' },
+        h('div', { className: 'n2s-fq-setgroup' }, t('fq.set.gFresh')),
+        h(SettingRow, { label: t('fq.set.fEnabledShort'), hint: t('fq.set.fEnabledHint') }, sw(fOn, v => setF('enabled', v), fOn ? t('fq.set.on') : t('fq.set.off'))),
+        fOn && h(SettingRow, { label: t('fq.set.showShort'), hint: t('fq.set.showHint') }, sw(form.freshness.showInUi !== false, v => setF('showInUi', v), form.freshness.showInUi !== false ? t('fq.set.shown') : t('fq.set.hidden'))),
+        fOn && h(SettingRow, { label: t('fq.set.interval'), htmlFor: 'n2s-fq-int' }, num('n2s-fq-int', form.freshness.intervalMin, v => setF('intervalMin', v), { min: 5, max: 1440 })),
+        fOn && h(SettingRow, { label: t('fq.set.staleHours'), htmlFor: 'n2s-fq-stale', hint: t('fq.set.staleHint') }, num('n2s-fq-stale', form.freshness.staleHours, v => setF('staleHours', v), { min: 0.25, step: 0.25 })),
+        fOn && h(SettingRow, { label: t('fq.set.fChannel'), htmlFor: 'n2s-fq-fch', hint: t('fq.set.fChannelHint') }, picker('n2s-fq-fch', form.freshness.channelId, v => setF('channelId', v))),
+        h('div', { className: 'n2s-fq-setgroup' }, t('fq.set.gQuality')),
+        h(SettingRow, { label: t('fq.set.qEnabled'), hint: t('fq.set.qEnabledHint') }, sw(qOn, v => setQ('enabled', v), qOn ? t('fq.set.on') : t('fq.set.off'))),
+        qOn && h(SettingRow, { label: t('fq.set.time'), htmlFor: 'n2s-fq-time' }, h('input', { id: 'n2s-fq-time', className: 'n2s-input', type: 'time', style: { maxWidth: 160 }, value: form.quality.time, onChange: e => setQ('time', e.target.value) })),
+        qOn && h(SettingRow, { label: t('fq.set.qChannel'), htmlFor: 'n2s-fq-qch' }, picker('n2s-fq-qch', form.quality.channelId, v => setQ('channelId', v))),
+        qOn && form.quality.channelId && h(SettingRow, { label: t('fq.set.drop'), htmlFor: 'n2s-fq-drop' }, num('n2s-fq-drop', form.quality.dropPoints, v => setQ('dropPoints', v), { min: 1, max: 100 })),
+        h('div', { className: 'n2s-row', style: { marginTop: 14, justifyContent: 'flex-end' } },
           h('button', { type: 'button', className: 'n2s-btn primary', disabled: busy, onClick: save }, busy ? h('span', { className: 'n2s-spin' }) : null, t('ds.save'))))
     }
 
@@ -6905,7 +6935,10 @@ window.__ModuleLoader__.load({
           ' · ',
           status.value.quality.enabled ? fmt(t, 'fq.admin.nextQ', { time: status.value.quality.time }) : t('fq.admin.qOff')),
         !dsId ? h('div', { className: 'n2s-empty' }, h('h3', null, t('fq.admin.noDs'))) : h(React.Fragment, null,
-          h(HealthFreshnessTable, { key: `f-${dsId}`, t, dsId }),
+          // When freshness is turned off, its table and events are not shown (and not queried).
+          status.value && !status.value.freshness.enabled
+            ? h('div', { className: 'n2s-notice', style: { marginBottom: 6 } }, t('fq.admin.fOffNote'))
+            : h(HealthFreshnessTable, { key: `f-${dsId}`, t, dsId }),
           h(HealthQuality, { key: `q-${dsId}`, t, dsId })),
         h('div', { className: 'n2s-setsub' }, t('fq.set.title')),
         h(HealthSettings, { t, onSaved: () => status.reload() }))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hedeqiang/dsh-nl2sql",
-  "version": "0.14.4",
+  "version": "0.14.5",
   "description": "Ask MySQL, PostgreSQL, Elasticsearch and CSV/Excel in plain language inside DeepSeek Harness: charts, dashboards, alerts, and IM push and bots for Lark/Feishu, Telegram, WeCom and DingTalk.",
   "type": "module",
   "bin": {