@hedeqiang/dsh-nl2sql 0.14.3 → 0.14.4

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.4] - 2026-11-13
+
+### Added
+- Data freshness can be switched off, or hidden from the page only (**Manage → Data health → Settings**). When off, nothing is shown under results or in Schema, no scheduled checks run and the agent's `nl2sql_freshness` tool reports that it is off; "hide on page" keeps checks and notifications but removes the warning bars and the Schema panel. The Data health page keeps showing the data either way.
+
 ## [0.14.3] - 2026-11-13
 
 ### Changed
@@ -159,7 +164,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.3...HEAD
+[Unreleased]: https://github.com/hedeqiang/dsh-nl2sql/compare/v0.14.4...HEAD
+[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
 [0.14.1]: https://github.com/hedeqiang/dsh-nl2sql/compare/v0.14.0...v0.14.1

package/lib/client.js

@@ -17,6 +17,7 @@ window.__ModuleLoader__.load({
     // ------------------------------------------------------------ locale
 
     const zh = {
+      'fq.set.showInUi': "在页面上显示数据新鲜度（查询结果下的滞后提示、表结构页的新鲜度面板）",
       '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': '连接测试未通过：',
@@ -80,7 +81,7 @@ window.__ModuleLoader__.load({
       "fq.admin.qOff": "每日质量巡检已关闭",
       "fq.admin.noDs": "请先添加数据源",
       "fq.set.title": "设置",
-      "fq.set.fEnabled": "定时检查数据新鲜度",
+      "fq.set.fEnabled": "启用数据新鲜度（定时检查、滞后通知、Agent 回答近期数据时的提醒）；关闭后页面上也不再显示",
       "fq.set.qEnabled": "每日数据质量巡检",
       "fq.set.interval": "新鲜度检查间隔（分钟）",
       "fq.set.time": "质量巡检时间",
@@ -1178,6 +1179,7 @@ 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)",
       '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:',
@@ -1241,7 +1243,7 @@ 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": "Check data freshness on a schedule",
+      "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",
@@ -6630,19 +6632,21 @@ window.__ModuleLoader__.load({
           const key = `${datasourceId}\u0000${sql ?? ''}`
           const hit = map.get(key)
           if (hit && Date.now() - hit.at < TTL) return hit.promise
-          const promise = call('freshnessFor', { datasourceId, ...(sql ? { sql } : {}) })
+          const promise = call('freshnessFor', { datasourceId, panel: true, ...(sql ? { sql } : {}) })
           map.set(key, { at: Date.now(), promise })
           promise.catch(() => map.delete(key))
           return promise
         },
         async refresh(datasourceId) {
-          const v = await call('freshnessFor', { datasourceId, refresh: true })
+          const v = await call('freshnessFor', { datasourceId, refresh: true, panel: true })
           for (const k of [...map.keys()]) if (k.startsWith(`${datasourceId}\u0000`)) map.delete(k)
           map.set(`${datasourceId}\u0000`, { at: Date.now(), promise: Promise.resolve(v) })
           rev++
           for (const f of subs) f()
           return v
         },
+        /** Drop everything (e.g. after the show / enable settings change) and re-render subscribers. */
+        reset() { map.clear(); rev++; for (const f of subs) f() },
         subscribe(f) { subs.add(f); return () => subs.delete(f) },
         rev: () => rev,
       }
@@ -6691,6 +6695,7 @@ window.__ModuleLoader__.load({
         fqCache.get(dsId, sql).then(v => alive && setView(v), () => {})
         return () => { alive = false }
       }, [dsId, sql, rev])
+      if (view?.disabled) return null
       const stale = (view?.tables ?? []).filter(x => x.stale)
       if (!stale.length) return null
       return h('div', { className: 'n2s-fq-bar', role: 'status' },
@@ -6719,7 +6724,7 @@ window.__ModuleLoader__.load({
         return () => { alive = false }
       }, [ds?.id, rev])
       const v = state.value
-      if (!ds || state.error || !v || !v.tables?.length) return null
+      if (!ds || state.error || !v || v.disabled || !v.tables?.length) return null
       const stale = v.tables.filter(x => x.stale).length
       const warn = v.tables.filter(x => x.status === 'warn').length
       const expanded = open ?? stale > 0
@@ -6786,6 +6791,7 @@ window.__ModuleLoader__.load({
           const { overrides: _o, ...freshness } = form.freshness
           const out = await call('saveHealthSettings', { freshness: { ...freshness, intervalMin: Number(freshness.intervalMin), staleHours: Number(freshness.staleHours), channelId: freshness.channelId || null }, quality: { ...form.quality, dropPoints: Number(form.quality.dropPoints), channelId: form.quality.channelId || null } })
           setForm(structuredClone(out))
+          fqCache.reset()
           notify(t('fq.saved'), 'ok')
           onSaved?.()
         } catch (e) { notifyError(e) }
@@ -6793,6 +6799,7 @@ window.__ModuleLoader__.load({
       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) })),
@@ -6807,7 +6814,7 @@ window.__ModuleLoader__.load({
 
     function HealthFreshnessTable({ t, dsId }) {
       const rev = useFqRev()
-      const fr = useAsync(() => (dsId ? fqCache.get(dsId) : null), [dsId, rev])
+      const fr = useAsync(() => (dsId ? call('freshnessFor', { datasourceId: dsId }) : null), [dsId, rev])
       const settings = useAsync(() => call('healthSettings'), [dsId, rev])
       const events = useAsync(() => (dsId ? call('freshnessEvents', { datasourceId: dsId, limit: 10 }) : []), [dsId, rev])
       const [busy, setBusy] = useState(false)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hedeqiang/dsh-nl2sql",
-  "version": "0.14.3",
+  "version": "0.14.4",
   "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": {

package/service/freshness.js

@@ -19,7 +19,8 @@ import { UserError, lastDailySlot, newId } from './shared.js'
 
 // ------------------------------------------------------------------ constants
 
-export const FRESHNESS_DEFAULTS = { enabled: true, intervalMin: 30, staleHours: 24, overrides: {}, channelId: null }
+// enabled: scheduled checks + notifications + the agent tool; showInUi: warning bars under results and the schema panel.
+export const FRESHNESS_DEFAULTS = { enabled: true, showInUi: true, intervalMin: 30, staleHours: 24, overrides: {}, channelId: null }
 export const QUALITY_DEFAULTS = { enabled: false, time: '06:30', channelId: null, dropPoints: 10, maxTableRows: 5000000, maxTables: 60 }
 const DATE_TYPES = new Set(['date', 'datetime', 'timestamp', 'timestamptz'])
 const NUM_TYPES = new Set(['tinyint', 'smallint', 'mediumint', 'int', 'integer', 'bigint', 'decimal', 'numeric', 'float', 'double', 'real'])
@@ -271,6 +272,7 @@ export const methods = {
     if (freshness) {
       const s = this.freshnessState().settings
       if (freshness.enabled !== undefined) s.enabled = Boolean(freshness.enabled)
+      if (freshness.showInUi !== undefined) s.showInUi = Boolean(freshness.showInUi)
       if (freshness.intervalMin !== undefined) s.intervalMin = Math.round(intIn(freshness.intervalMin, 5, 1440, 'intervalMin'))
       if (freshness.staleHours !== undefined) s.staleHours = intIn(freshness.staleHours, 0.25, 24 * 90, 'staleHours')
       if (freshness.channelId !== undefined) s.channelId = channel(freshness.channelId)
@@ -422,9 +424,12 @@ export const methods = {
   },
 
   /** RPC: stored freshness (computed on first use or when refresh); `sql` narrows to referenced tables. */
-  async freshnessFor({ datasourceId, refresh = false, sql } = {}) {
+  async freshnessFor({ datasourceId, refresh = false, sql, panel = false } = {}) {
     const ds = this.requireDatasource(datasourceId ?? this.state.current)
     const f = this.freshnessState()
+    // Page panels (result bars, schema panel) ask with panel: true; when the feature or its
+    // page display is off they get nothing and no query runs.
+    if (panel && (!f.settings.enabled || f.settings.showInUi === false)) return { datasourceId: ds.id, disabled: true, tables: [] }
     let store = f[ds.id]
     if (refresh || !store) {
       if (refresh) store = await this.withJobLock(`freshness:${ds.id}`, () => this.refreshFreshness(ds))
@@ -737,6 +742,7 @@ export const FEATURE = {
       presentCall: (args) => ({ card: 'generic', title: args?.tables?.length ? `数据新鲜度 ${args.tables.join(', ')}` : '数据新鲜度', kind: 'read' }),
       execute: async (args, exec) => {
         try {
+          if (!service.freshnessState().settings.enabled) return { disabled: true, message: 'Data freshness checks are turned off by the administrator (Data Q&A → Manage → Data health). Answer without freshness warnings.' }
           return await service.freshnessForSession({ sessionId: exec?.agent?.id, datasource: args?.datasource, tables: args?.tables })
         } catch (error) {
           throw error instanceof UserError ? new Error(error.message) : error