@hedeqiang/dsh-nl2sql 0.11.1 → 0.11.2

package/CHANGELOG.md

@@ -4,6 +4,14 @@
 
 ## [未发布]
 
+## [0.11.2] - 2026-11-12
+
+### 改进
+- 看板：每个图表显示所属数据源（数据源已删除时提示）；看板含多个数据源时显示「包含数据源」，并可切换「全部数据源 / 仅当前数据源」（按浏览器记住）；只看当前数据源时拖拽排序不会打乱被隐藏的图表。
+- 文档：README 改为以 npm 安装为主（插件页「添加插件」或 `dsh plugin add`），补充升级、卸载和从源码安装说明。
+- 推送大结果时不再静默省略：消息中会注明「共 N 行，消息中显示前 M 行」。飞书卡片表格最多 50 行（客户端内分页），Telegram 20 行，企业微信、钉钉 10 行。
+- 飞书应用机器人、Telegram 会把超出显示范围的结果作为完整数据 Excel 附件随消息发送（可在发送对话框取消，Agent 工具参数 `attachFull`）；附件失败不影响消息本身，会在推送记录中提示。
+
 ## [0.11.1] - 2026-11-12
 
 ### 修复

package/README.en.md

@@ -11,7 +11,8 @@ An enterprise NL2SQL plugin for DeepSeek Harness: connect databases, ask in plai
 - **Asking:** in a Harness conversation through the `nl2sql_*` tools; results render as ECharts charts or tables.
 - **Drill-down and "why did it change":** split by a dimension, show rows, rank dimensions by their contribution to a change.
 - **Metric library and business knowledge:** glossary, governed metrics (`nl2sql_metric`), column notes, verified examples; import / export; accuracy evaluation against the examples.
-- **Dashboards:** multiple boards, global filters, drag-to-reorder, three widths, snapshots, Excel export.
+- **Dashboards:** multiple boards, global filters, drag-to-reorder, three widths, snapshots, Excel export; a board may mix data sources — each chart shows its source and the board can be scoped to the current source.
+- **Large results in IM:** messages say how many rows are shown; Lark app bots and Telegram attach the full data as Excel.
 - **Channels:** Lark / Feishu, Telegram, WeCom and DingTalk through pluggable adapters ([docs/CHANNELS.md](docs/CHANNELS.md)); push Markdown and results (native charts, images or tables per platform), and @-mention bots that need no public URL.
 - **Automation:** scheduled reports, metric alerts (threshold / change / anomaly / missing), schema change detection.
 - **Safety:**
@@ -22,14 +23,40 @@ An enterprise NL2SQL plugin for DeepSeek Harness: connect databases, ask in plai
 
 ## Install
 
-Requires DeepSeek Harness (desktop or `dsh web`).
+Requires DeepSeek Harness 0.2 or later (desktop or `dsh web`). Published on npm as [`@hedeqiang/dsh-nl2sql`](https://www.npmjs.com/package/@hedeqiang/dsh-nl2sql).
+
+[![npm](https://img.shields.io/npm/v/@hedeqiang/dsh-nl2sql)](https://www.npmjs.com/package/@hedeqiang/dsh-nl2sql)
+
+**In Harness (recommended)**
+
+1. Sidebar → **Plugins** → **Add plugin**.
+2. Enter `@hedeqiang/dsh-nl2sql` (optionally with a version, e.g. `@hedeqiang/dsh-nl2sql@0.11.1`), install and enable it.
+3. **Data Q&A** appears in the sidebar, and the Data Q&A preset is available for new conversations.
+
+You can also ask the Harness agent: "install the plugin @hedeqiang/dsh-nl2sql".
+
+**Command line**
+
+```bash
+dsh plugin --profile desktop add @hedeqiang/dsh-nl2sql   # desktop app profile; dsh web uses "web" by default
+```
+
+Then enable it on the **Plugins** page (or restart Harness).
+
+**Upgrade:** update it from the plugin's details on the **Plugins** page, or run `dsh plugin --profile desktop update @hedeqiang/dsh-nl2sql`, then re-enable the plugin. Configuration and data live in `~/.dsh/nl2sql` and survive upgrades; older configuration is migrated on first load.
+
+**Uninstall:** remove it on the **Plugins** page or with `dsh plugin --profile desktop remove @hedeqiang/dsh-nl2sql`. Data in `~/.dsh/nl2sql` is kept; delete the directory if you no longer need it. Database passwords live in the Harness credential store.
+
+> All dependencies (mysql2, pg, ssh2, echarts, @resvg/resvg-js, @larksuiteoapi/node-sdk) ship prebuilt; no install scripts need to run.
+
+**From source (development)**
 
 ```bash
-git clone <this repo> dsh-nl2sql && cd dsh-nl2sql
+git clone https://github.com/hedeqiang/dsh-nl2sql.git && cd dsh-nl2sql
 pnpm install --ignore-scripts
 ```
 
-Install the directory as a bundle (plugin manager `install_bundle` with the absolute path), or add `@hedeqiang/dsh-nl2sql` to your profile's `dsh.profile.bundles` with a `link:` dependency. Once published, install `@hedeqiang/dsh-nl2sql` from npm.
+Enter the directory's absolute path in **Plugins** → **Add plugin** (it is linked, so re-enabling the plugin picks up code changes), or ask the agent to install the directory with the plugin manager.
 
 ## Use
 

package/README.md

@@ -1,6 +1,6 @@
 # dsh-nl2sql · 数据问答
 
-[DeepSeek Harness](https://github.com/deepseek-ai) 的企业级 NL2SQL 插件：连接数据库，用自然语言提问，Agent 写只读 SQL、执行并在对话中画图；结果可以固定到看板、推送到飞书，还能在飞书群里直接 @机器人提问。
+[DeepSeek Harness](https://github.com/deepseek-ai) 的企业级 NL2SQL 插件：连接数据库，用自然语言提问，Agent 写只读 SQL、执行并在对话中画图；结果可以固定到看板、推送到飞书 / Telegram / 企业微信 / 钉钉，还能在群里直接 @机器人提问。
 
 [English](README.en.md)
 
@@ -16,6 +16,8 @@
 
 **看板与推送**
 - 多看板、全局筛选（时间范围 / 维度）、拖拽排序、三档宽度、快照、Excel 导出。
+- 一个看板可以放多个数据源的图表：每个图表标注所属数据源，可切换「全部数据源 / 仅当前数据源」。
+- 推送大结果时注明「共 N 行，显示前 M 行」；飞书应用机器人和 Telegram 会附带完整数据 Excel。
 - IM 渠道：飞书 / Lark、Telegram、企业微信、钉钉（推送 Markdown 与结果，图表按平台能力用原生图表、图片或表格）；架构见 [docs/CHANNELS.md](docs/CHANNELS.md)，新增平台只需实现一个适配器。
 - 定时报告（基于 Harness 定时任务）、指标告警（阈值 / 环比 / 异常 / 无数据）、表结构变更检测。
 - 群聊 @机器人提问：飞书长连接、Telegram 长轮询、企业微信智能机器人长连接、钉钉 Stream 模式，都不需要公网地址。
@@ -28,22 +30,40 @@
 
 ## 安装
 
-需要 DeepSeek Harness 桌面版或 `dsh web`。
+需要 DeepSeek Harness 0.2 及以上（桌面版或 `dsh web`）。插件已发布到 npm：[`@hedeqiang/dsh-nl2sql`](https://www.npmjs.com/package/@hedeqiang/dsh-nl2sql)。
+
+[![npm](https://img.shields.io/npm/v/@hedeqiang/dsh-nl2sql)](https://www.npmjs.com/package/@hedeqiang/dsh-nl2sql)
+
+**方式一：在 Harness 里添加（推荐）**
+
+1. 打开左侧栏 **插件** → **添加插件**。
+2. 输入包名 `@hedeqiang/dsh-nl2sql`（可加版本，如 `@hedeqiang/dsh-nl2sql@0.11.1`），确认安装并启用。
+3. 左侧栏出现 **数据问答**，新建对话时也可以选择「数据问答」预设。
+
+也可以直接对 Harness 的 Agent 说：「安装插件 @hedeqiang/dsh-nl2sql」。
+
+**方式二：命令行**
 
 ```bash
-# 从源码（开发）
-git clone <this repo> dsh-nl2sql && cd dsh-nl2sql
-pnpm install --ignore-scripts      # 依赖：mysql2、pg、ssh2、echarts、@larksuiteoapi/node-sdk、@resvg/resvg-js
+dsh plugin --profile desktop add @hedeqiang/dsh-nl2sql   # 桌面版的 profile 名为 desktop；dsh web 默认为 web
 ```
 
-然后在 Harness 中让 Agent 安装本地目录（插件管理器 `install_bundle`，目标为本目录的绝对路径），或在 profile 的 `package.json` 中加入：
+然后在 **插件** 页启用它（或重启 Harness）。
 
-```json
-{ "dsh": { "profile": { "bundles": ["@hedeqiang/dsh-nl2sql"] } },
-  "dependencies": { "@hedeqiang/dsh-nl2sql": "link:/path/to/dsh-nl2sql" } }
+**升级**：在 **插件** 页的插件详情中更新，或执行 `dsh plugin --profile desktop update @hedeqiang/dsh-nl2sql`，然后重新启用插件。配置和数据保存在 `~/.dsh/nl2sql`，升级不会丢失；旧版本的配置会在首次加载时自动迁移。
+
+**卸载**：在 **插件** 页移除，或 `dsh plugin --profile desktop remove @hedeqiang/dsh-nl2sql`。卸载不会删除 `~/.dsh/nl2sql` 中的数据；不再需要时可手动删除该目录，数据库密码等凭据在 Harness 凭据库中，可在设置中清除。
+
+> 依赖（mysql2、pg、ssh2、echarts、@resvg/resvg-js、@larksuiteoapi/node-sdk）都使用预编译包，安装时不需要运行构建脚本。
+
+**从源码安装（开发）**
+
+```bash
+git clone https://github.com/hedeqiang/dsh-nl2sql.git && cd dsh-nl2sql
+pnpm install --ignore-scripts
 ```
 
-发布到 npm 后可直接安装 `@hedeqiang/dsh-nl2sql`。
+在 **插件** → **添加插件** 中填入本目录的绝对路径（以链接方式安装，改代码后重新启用插件即可生效），或让 Agent 用插件管理器安装该目录。
 
 ## 使用
 

package/channels/dingtalk.js

@@ -159,7 +159,7 @@ export function resultAsDingText(r, maxRows = 10, maxCols = 6) {
   const cell = (c, v) => (c.kind === 'number' ? fmtNum(v) : cellText(v, 30)).replace(/\|/g, '｜')
   const out = [`**${cols.map(c => c.name).join(' ｜ ')}**`, '', ...rows.map((row, i) => `${i + 1}. ${cols.map((c, j) => cell(c, row[j])).join(' ｜ ')}`)]
   const total = r.rowCount ?? r.rows.length
-  if (total > rows.length) out.push('', `> 共 ${total} 行，仅显示前 ${rows.length} 行`)
+  if (total > rows.length) out.push('', `> 共 ${total} 行，仅显示前 ${rows.length} 行；完整数据可在数据问答页面查看或导出 Excel`)
   return out.join('\n')
 }
 
@@ -508,7 +508,7 @@ const webhookKind = {
     { key: 'webhookUrl', type: 'secret', secret: true, required: true, label: { zh: 'Webhook 地址', en: 'Webhook URL' }, placeholder: 'https://oapi.dingtalk.com/robot/send?access_token=…', pattern: WEBHOOK_RE.source, help: { zh: '群设置 → 机器人 → 添加机器人 → 自定义，完成后复制 Webhook', en: 'Group settings → Bots → Add → Custom, then copy the webhook' } },
     { key: 'signSecret', type: 'secret', secret: true, required: false, label: { zh: '加签密钥（可选）', en: 'Signing secret (optional)' }, placeholder: 'SEC…', help: { zh: '安全设置选择「加签」时显示的 SEC 开头字符串', en: 'The SEC… string shown when “Sign” is selected in security settings' } },
   ],
-  capabilities: { push: true, markdown: 'basic', charts: 'none', chartModes: ['table'], tables: 'text', buttons: false, bot: false, listTargets: false, mentionAll: true, maxMessageBytes: MD_LIMIT },
+  capabilities: { push: true, markdown: 'basic', charts: 'none', chartModes: ['table'], tables: 'text', tableRows: 10, files: false, buttons: false, bot: false, listTargets: false, mentionAll: true, maxMessageBytes: MD_LIMIT },
   setupSteps: {
     zh: [
       '在钉钉群：群设置 → 机器人 → 添加机器人 → 自定义（通过 Webhook 接入）。',
@@ -542,7 +542,7 @@ const appKind = {
     { key: 'openConversationId', type: 'text', required: false, label: { zh: '推送目标群（openConversationId，可选）', en: 'Push target group (openConversationId, optional)' }, placeholder: 'cid…', help: { zh: '机器人收到该群消息时的 conversationId（以 cid 开头）', en: 'The conversationId (cid…) seen in a message from that group' } },
     { key: 'userId', type: 'text', required: false, label: { zh: '推送目标成员 userId（可选）', en: 'Push target member userId (optional)' }, help: { zh: '未填群会话 ID 时，推送到该成员与机器人的单聊', en: 'Used when no group is set: pushes to the member’s chat with the bot' } },
   ],
-  capabilities: { push: true, markdown: 'basic', charts: 'none', chartModes: ['table'], tables: 'text', buttons: false, bot: true, listTargets: false, mentionAll: false, maxMessageBytes: MD_LIMIT },
+  capabilities: { push: true, markdown: 'basic', charts: 'none', chartModes: ['table'], tables: 'text', tableRows: 10, files: false, buttons: false, bot: true, listTargets: false, mentionAll: false, maxMessageBytes: MD_LIMIT },
   setupSteps: {
     zh: [
       '钉钉开发者后台（open-dev.dingtalk.com）→ 应用开发 → 企业内部应用 → 创建应用，记下 Client ID 与 Client Secret。',

package/channels/lark.js

@@ -16,7 +16,7 @@
  */
 import { createHash, createHmac } from 'node:crypto'
 import { ChannelError, request } from './http.js'
-import { MD_TABLE, cellText, chartOption, chartable, dualAxis, kpiText, isKpi, num, parseMdTable, renderChartPng, resultMeta } from './message.js'
+import { MD_TABLE, cellText, chartOption, chartable, dualAxis, kpiText, isKpi, needsAttachment, num, omittedNote, parseMdTable, renderChartPng, resultMeta } from './message.js'
 
 export { ChannelError, ChannelError as ImError, chartOption, chartable, dualAxis, renderChartPng }
 
@@ -677,6 +677,18 @@ async function uploadImage(channel, secrets, png) {
   return json.data.image_key
 }
 
+/** Upload a file (≤ 30 MB) for a file message; returns file_key. https://open.feishu.cn/document/server-docs/im-v1/file/create */
+async function uploadFile(channel, secrets, buf, fileName, fileType = 'xls') {
+  const token = await pushToken(channel, secrets)
+  const form = new FormData()
+  form.set('file_type', fileType)
+  form.set('file_name', fileName)
+  form.set('file', new Blob([buf], { type: 'application/octet-stream' }), fileName)
+  const { status, json } = await request(`${hostFor(channel)}/open-apis/im/v1/files`, { method: 'POST', headers: { authorization: `Bearer ${token}` }, body: form, timeoutMs: 60000, label: '飞书' })
+  if (json.code !== 0) throw larkPushError(json, status)
+  return json.data.file_key
+}
+
 // ===========================================================================
 // Cards (JSON 2.0)
 // ===========================================================================
@@ -687,6 +699,7 @@ function tableElement(result, maxRows) {
   const cols = result.columns.slice(0, 8)
   return {
     tag: 'table',
+    // page_size is 1..10 per the card spec; more rows are paged in the client.
     page_size: Math.min(10, Math.max(1, Math.min(maxRows, result.rows.length))),
     row_height: 'low',
     header_style: { background_style: 'grey', bold: true, text_size: 'normal' },
@@ -820,7 +833,7 @@ export function actionElement(spec) {
  * Build a JSON 2.0 card from an OutboundMessage.
  * Results may carry `imageKey` (uploaded PNG) and `actions` (ActionSpec; legacy name `cardActions`).
  */
-export function buildCard(message, { maxRows = 10, charts = true, actions = true } = {}) {
+export function buildCard(message, { maxRows = 50, charts = true, actions = true } = {}) {
   const elements = [...markdownElements(message.text)]
   let tables = elements.filter(e => e.tag === 'table').length
   let chartCount = 0
@@ -844,8 +857,12 @@ export function buildCard(message, { maxRows = 10, charts = true, actions = true
     } else if (tables < 5) {
       elements.push(tableElement(r, maxRows))
       tables++
+      const note = omittedNote(r, Math.min(maxRows, r.rows.length), { attached: Boolean(r.attached) })
+      if (note) elements.push({ tag: 'markdown', content: `<font color='grey'>${note}</font>`, text_size: 'notation' })
     } else {
       elements.push({ tag: 'markdown', content: r.rows.slice(0, 5).map(row => row.slice(0, 6).map(v => cellText(v)).join(' | ')).join('\n') })
+      const note = omittedNote(r, Math.min(5, r.rows.length), { attached: Boolean(r.attached) })
+      if (note) elements.push({ tag: 'markdown', content: `<font color='grey'>${note}</font>`, text_size: 'notation' })
     }
     const spec = r.actions ?? r.cardActions
     if (spec && actions) {
@@ -863,7 +880,7 @@ export function buildCard(message, { maxRows = 10, charts = true, actions = true
   }
   // Card bodies are limited to ~30 KB: shrink tables/charts until it fits.
   const size = Buffer.byteLength(JSON.stringify(card))
-  if (size > CARD_LIMIT && maxRows > 3) return buildCard(message, { maxRows: Math.max(3, Math.floor(maxRows / 2)), charts, actions })
+  if (size > CARD_LIMIT && maxRows > 5) return buildCard(message, { maxRows: Math.max(5, Math.floor(maxRows / 2)), charts, actions })
   if (size > CARD_LIMIT && charts) return buildCard(message, { maxRows, charts: false, actions })
   if (size > CARD_LIMIT) {
     card.body.elements = elements.filter(e => e.tag !== 'table')
@@ -915,6 +932,7 @@ export async function sendMessage(channel, secrets, message) {
     }
     results.push(r)
   }
+  if (channel.type === 'lark_app' && message.attachment?.buffer) for (let i = 0; i < results.length; i++) if (message.attachment.resultIndexes?.includes(i)) results[i] = { ...results[i], attached: true }
   const card = buildCard({ ...message, results }, { charts: message.chartMode !== 'image' && message.chartMode !== 'table' })
   if (channel.type === 'lark_webhook') {
     if (!secrets.webhookUrl) throw new ChannelError('im/config', '缺少 Webhook 地址')
@@ -944,7 +962,17 @@ export async function sendMessage(channel, secrets, message) {
     if (json.code !== 0 && !fatal.includes(json.code) && card.body.elements.some(e => e.tag === 'chart')) ({ status, json } = await send(buildCard({ ...message, results }, { charts: false })))
     if (json.code !== 0 && !fatal.includes(json.code)) ({ status, json } = await send(legacyCard(card)))
     if (json.code !== 0) throw larkPushError(json, status)
-    return { messageId: json.data?.message_id, images }
+    // Full data as an Excel file message after the card (app bots only; webhooks cannot send files).
+    let files = 0
+    if (message.attachment?.buffer) {
+      try {
+        const fileKey = await uploadFile(channel, secrets, message.attachment.buffer, message.attachment.fileName)
+        const fr = await postJson(url, { receive_id: channel.receiveId, msg_type: 'file', content: JSON.stringify({ file_key: fileKey }) }, { authorization: `Bearer ${token}` })
+        if (fr.json.code === 0) files++
+        else message.attachmentError = larkPushError(fr.json, fr.status).message
+      } catch (error) { message.attachmentError = error.message }
+    }
+    return { messageId: json.data?.message_id, images, files, ...(message.attachmentError ? { warning: `完整数据附件发送失败：${message.attachmentError}` } : {}) }
   }
   throw new ChannelError('im/config', `不支持的渠道类型：${channel.type}`)
 }
@@ -1104,7 +1132,7 @@ export const kinds = [
       { key: 'webhookUrl', label: { zh: 'Webhook 地址', en: 'Webhook URL' }, type: 'secret', secret: true, required: true, placeholder: 'https://open.feishu.cn/open-apis/bot/v2/hook/…', pattern: WEBHOOK_RE.source },
       { key: 'signSecret', label: { zh: '签名密钥', en: 'Signing secret' }, type: 'secret', secret: true, help: { zh: '机器人开启「签名校验」时填写', en: 'Only when signature verification is enabled' } },
     ],
-    capabilities: { push: true, markdown: 'full', charts: 'native', chartModes: ['native', 'table'], tables: 'native', buttons: false, bot: false, listTargets: false, mentionAll: true, maxMessageBytes: 28000 },
+    capabilities: { push: true, markdown: 'full', charts: 'native', chartModes: ['native', 'table'], tables: 'native', tableRows: 50, files: false, buttons: false, bot: false, listTargets: false, mentionAll: true, maxMessageBytes: 28000 },
     setupSteps: WEBHOOK_SETUP,
     validate(input, existing) {
       const config = {}
@@ -1141,7 +1169,7 @@ export const kinds = [
       ] },
       { key: 'receiveId', label: { zh: '接收者 ID', en: 'Receiver ID' }, type: 'text', required: true, placeholder: 'oc_…', target: true, help: { zh: '推送目标；选择群时可点「列出群聊」', en: 'Push target; use "List chats" to pick a chat' } },
     ],
-    capabilities: { push: true, markdown: 'full', charts: 'native', chartImages: true, chartModes: ['native', 'image', 'table'], tables: 'native', buttons: true, bot: true, listTargets: true, mentionAll: true, maxMessageBytes: 28000 },
+    capabilities: { push: true, markdown: 'full', charts: 'native', chartImages: true, chartModes: ['native', 'image', 'table'], tables: 'native', tableRows: 50, files: true, buttons: true, bot: true, listTargets: true, mentionAll: true, maxMessageBytes: 28000 },
     setupSteps: APP_SETUP,
     validate(input, existing) {
       const c = input.config ?? {}

package/channels/message.js

@@ -42,6 +42,23 @@ export function isKpi(result) {
 }
 
 /** "12 行（已截断） · 已筛选：…" */
+/**
+ * One line telling the reader how much of a result the message shows, or ''
+ * when everything is shown. `attached` = a full-data file follows.
+ */
+export function omittedNote(result, shown, { attached = false } = {}) {
+  const total = result.rowCount ?? result.rows?.length ?? 0
+  if (shown >= total && !result.truncated) return ''
+  const base = shown < total ? `共 ${total} 行，消息中显示前 ${shown} 行` : `查询结果已按行数上限截断（${total} 行）`
+  return attached ? `${base}，完整数据见附件 Excel` : `${base}；完整数据可在数据问答页面查看或导出 Excel`
+}
+
+/** Results whose rows do not all fit in a message (candidates for a full-data attachment). */
+export function needsAttachment(result, shown) {
+  if (!result || result.error || !result.rows?.length) return false
+  return (result.rowCount ?? result.rows.length) > shown
+}
+
 export function resultMeta(result) {
   return `${result.rowCount ?? result.rows?.length ?? 0} 行${result.truncated ? '（已截断）' : ''}${result.filters?.length ? ` · 已筛选：${result.filters.map(f => f.description).join('；')}` : ''}`
 }
@@ -204,7 +221,7 @@ export function resultAsMarkdownTable(result, maxRows = 10, { maxCols = 8 } = {}
     ...rows.map(r => `| ${cols.map((c, i) => mdCell(c.kind === 'number' && Number.isFinite(Number(r[i])) && r[i] !== null && r[i] !== '' ? Number(r[i]).toLocaleString('en-US', { maximumFractionDigits: 4 }) : r[i])).join(' | ')} |`),
   ]
   const total = result.rowCount ?? result.rows?.length ?? 0
-  if (total > rows.length) lines.push('', `…共 ${total} 行，仅显示前 ${rows.length} 行`)
+  if (total > rows.length) lines.push('', `…共 ${total} 行，仅显示前 ${rows.length} 行${result.attached ? '，完整数据见附件 Excel' : ''}`)
   return lines.join('\n')
 }
 

package/channels/telegram.js

@@ -280,7 +280,7 @@ export function inlineKeyboard(spec) {
 
 // ------------------------------------------------------------ rendering
 
-function resultMarkdown(r, { includeSql, maxRows = 10 } = {}) {
+function resultMarkdown(r, { includeSql, maxRows = 20 } = {}) {
   const head = `**${r.title || '查询结果'}**  ${resultMeta(r)}`
   if (r.error) return `${head}\n${r.error}`
   const lines = [head]
@@ -353,6 +353,16 @@ function createSender(api) {
     return msg?.message_id
   }
 
+  async function sendDocument(chatId, buf, fileName, { caption, threadId } = {}) {
+    const form = new FormData()
+    form.append('chat_id', String(chatId))
+    form.append('document', new Blob([buf], { type: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' }), fileName)
+    if (caption) form.append('caption', caption.slice(0, 1024))
+    if (threadId) form.append('message_thread_id', String(threadId))
+    const msg = await api.call('sendDocument', undefined, { form, timeoutMs: 60000 })
+    return msg?.message_id
+  }
+
   /** Deliver an OutboundMessage. Returns { messageId, images }. */
   async function deliver(chatId, message, { replyTo, threadId, renderChartPng = defaultRenderChartPng, logger, buttons = true } = {}) {
     let images = 0
@@ -376,10 +386,16 @@ function createSender(api) {
       messageId ??= id
       reply = undefined
     }
-    return { messageId: messageId === undefined ? undefined : String(messageId), images }
+    // Full data as an Excel document (Bot API sendDocument, ≤ 50 MB).
+    let files = 0
+    let warning
+    if (message.attachment?.buffer) {
+      try { await sendDocument(chatId, message.attachment.buffer, message.attachment.fileName, { caption: '完整数据', threadId }); files++ } catch (error) { warning = `完整数据附件发送失败：${error.message}` }
+    }
+    return { messageId: messageId === undefined ? undefined : String(messageId), images, files, ...(warning ? { warning } : {}) }
   }
 
-  return { sendText, sendPhoto, deliver }
+  return { sendText, sendPhoto, sendDocument, deliver }
 }
 
 // ------------------------------------------------------------ validate
@@ -627,7 +643,7 @@ const telegramBot = {
     { key: 'chatId', type: 'text', required: false, target: true, label: { zh: 'Chat ID（推送目标）', en: 'Chat ID (push target)' }, placeholder: '-1001234567890 / @mychannel', pattern: CHAT_RE.source, help: { zh: '群组/超级群为负数（通常以 -100 开头），公开频道可填 @用户名；仅作机器人使用时可留空', en: 'Negative number for groups (usually -100…), or @username for public channels; may be empty for bot-only use' } },
     { key: 'apiBase', type: 'url', required: false, label: { zh: 'API 地址（可选）', en: 'API base URL (optional)' }, placeholder: DEFAULT_API_BASE, help: { zh: '自建 Bot API 服务器或反向代理地址；留空使用官方 api.telegram.org', en: 'Self-hosted Bot API server or proxy; empty = api.telegram.org' } },
   ],
-  capabilities: { push: true, markdown: 'basic', charts: 'image', chartModes: ['image', 'table'], tables: 'text', buttons: true, bot: true, listTargets: false, mentionAll: false, maxMessageBytes: TEXT_LIMIT },
+  capabilities: { push: true, markdown: 'basic', charts: 'image', chartModes: ['image', 'table'], tables: 'text', tableRows: 20, files: true, buttons: true, bot: true, listTargets: false, mentionAll: false, maxMessageBytes: TEXT_LIMIT },
   setupSteps: {
     zh: [
       '在 Telegram 中打开 @BotFather，发送 /newbot 按提示创建机器人，复制 Bot Token。',

package/channels/wecom.js

@@ -522,7 +522,7 @@ const webhookKind = {
   fields: [
     { key: 'webhookUrl', type: 'secret', secret: true, required: true, label: { zh: 'Webhook 地址', en: 'Webhook URL' }, placeholder: 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=…', pattern: WEBHOOK_RE.source, help: { zh: '群聊 → 右上角 … → 消息推送 → 添加，复制 Webhook 地址', en: 'Group chat → … → Message push → Add, copy the webhook URL' } },
   ],
-  capabilities: { push: true, markdown: 'basic', charts: 'image', chartModes: ['image', 'table'], tables: 'markdown', buttons: false, bot: false, listTargets: false, mentionAll: true, maxMessageBytes: WEBHOOK_LIMIT },
+  capabilities: { push: true, markdown: 'basic', charts: 'image', chartModes: ['image', 'table'], tables: 'markdown', tableRows: 10, files: false, buttons: false, bot: false, listTargets: false, mentionAll: true, maxMessageBytes: WEBHOOK_LIMIT },
   setupSteps: {
     zh: [
       '在企业微信群聊中点击右上角「…」→「消息推送」（旧版为「群机器人」）→「添加」，创建后复制 Webhook 地址。',
@@ -553,7 +553,7 @@ const aibotKind = {
     { key: 'chatId', type: 'text', required: false, label: { zh: '推送目标会话 ID（可选）', en: 'Push target chat id (optional)' }, help: { zh: '群聊 chatid（来自机器人收到的消息）或成员 userid；会话需先给机器人发过消息', en: 'Group chatid (from a received message) or member userid; the chat must have messaged the bot first' } },
     { key: 'chatType', type: 'select', required: false, label: { zh: '会话类型', en: 'Chat type' }, options: [{ value: 'group', label: { zh: '群聊', en: 'Group' } }, { value: 'single', label: { zh: '单聊', en: 'Single' } }] },
   ],
-  capabilities: { push: true, markdown: 'full', charts: 'none', chartModes: ['table'], tables: 'markdown', buttons: false, bot: true, listTargets: false, mentionAll: false, maxMessageBytes: AIBOT_LIMIT },
+  capabilities: { push: true, markdown: 'full', charts: 'none', chartModes: ['table'], tables: 'markdown', tableRows: 10, files: false, buttons: false, bot: true, listTargets: false, mentionAll: false, maxMessageBytes: AIBOT_LIMIT },
   setupSteps: {
     zh: [
       '企业微信管理后台 → 应用管理 → 智能机器人 → 创建（或选择）机器人 → 开启「API 模式」并选择「长连接」。',

package/index.js

@@ -310,6 +310,7 @@ function registerSendTool(ctx, service) {
         chartMode: { type: 'string', enum: ['native', 'image', 'table'], description: 'How attached results render: native card charts, PNG images, or tables. Omit to use the channel default; unsupported modes fall back to it.' },
         resultIds: { type: 'array', items: { type: 'string' }, description: 'resultIds from nl2sql_query / nl2sql_chart / nl2sql_overview to include.' },
         includeSql: { type: 'boolean', description: 'Also include each result\'s SQL.' },
+        attachFull: { type: 'boolean', description: 'Where the channel can send files (Lark app bot, Telegram), results with more rows than the message shows get the full data attached as an Excel file. Default true.' },
       },
       additionalProperties: false,
     },
@@ -318,7 +319,7 @@ function registerSendTool(ctx, service) {
     execute: async (args, exec) => {
       try {
         if (args.action === 'list') return { channels: service.listChannels().map(c => ({ ...pick(c, ['id', 'name', 'type', 'platform', 'description', 'isDefault']), ...(c.capabilities ? { capabilities: pick(c.capabilities, ['markdown', 'charts', 'tables', 'chartModes']) } : {}) })) }
-        return await service.sendToChannel({ channelId: args.channel, title: args.title, text: args.text, resultIds: args.resultIds ?? [], includeSql: args.includeSql, chartMode: args.chartMode, source: 'agent', sessionId: exec.agent?.id })
+        return await service.sendToChannel({ channelId: args.channel, title: args.title, text: args.text, resultIds: args.resultIds ?? [], includeSql: args.includeSql, attachFull: args.attachFull, chartMode: args.chartMode, source: 'agent', sessionId: exec.agent?.id })
       } catch (error) {
         throw error instanceof UserError ? new Error(error.message) : error
       }

package/lib/client.js

@@ -15,6 +15,18 @@ window.__ModuleLoader__.load({
     // ------------------------------------------------------------ locale
 
     const zh = {
+      'dash.sourceOf': "数据源",
+      'dash.sourceMissing': "该图表的数据源已删除，无法刷新",
+      'dash.sourceMissingShort': "数据源已删除",
+      'dash.scope': "显示范围",
+      'dash.scopeAll': "全部数据源",
+      'dash.scopeCurrent': "仅 {name}",
+      'dash.sources': "包含数据源：{list}",
+      'dash.scopeEmpty': "这个看板里没有「{name}」的图表",
+      'dash.scopeEmptyHint': "另有 {n} 个其他数据源的图表被隐藏。",
+      'im.attachFull': "超过 {n} 行的结果附带完整数据 Excel",
+      'im.rowsLimit': "消息中每个结果最多显示 {n} 行，超出部分会注明；完整数据可在页面导出 Excel",
+      'im.sentFile': "已附带完整数据 Excel",
       "settings.botDefaultRole": "未登记的用户",
       "settings.larkDefaultRole": "未登记的用户",
       "ch.savedTestFailedMsg": "已保存，但测试失败：{msg}",
@@ -1006,6 +1018,18 @@ window.__ModuleLoader__.load({
       'error.generic': '操作失败：{message}',
     }
     const en = {
+      'dash.sourceOf': "Data source",
+      'dash.sourceMissing': "This chart's data source was deleted; it cannot refresh",
+      'dash.sourceMissingShort': "source deleted",
+      'dash.scope': "Show",
+      'dash.scopeAll': "All sources",
+      'dash.scopeCurrent': "Only {name}",
+      'dash.sources': "Sources: {list}",
+      'dash.scopeEmpty': "No charts from \"{name}\" on this dashboard",
+      'dash.scopeEmptyHint': "{n} charts from other sources are hidden.",
+      'im.attachFull': "Attach full data as Excel for results over {n} rows",
+      'im.rowsLimit': "Messages show up to {n} rows per result and say when rows are omitted; export Excel on the page for full data",
+      'im.sentFile': "full data attached as Excel",
       "settings.botDefaultRole": "Unregistered users",
       "settings.larkDefaultRole": "Unregistered users",
       "ch.savedTestFailedMsg": "Saved, but the test failed: {msg}",
@@ -1919,6 +1943,8 @@ window.__ModuleLoader__.load({
 .n2s-morebtn:hover{background:var(--n2s-hover);color:var(--dsw-alias-label-primary)}
 .n2s-btn.danger-text{color:var(--n2s-err)}
 /* ---- 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}
 .n2s-dash{grid-template-columns:repeat(6,minmax(0,1fr));align-items:start}
 .n2s-widget.w-third{grid-column:span 2}
 .n2s-widget.w-half{grid-column:span 3}
@@ -3993,7 +4019,7 @@ window.__ModuleLoader__.load({
     /** Modal dialog sending a title, text and results to an IM channel. */
     function SendDialog({ t, initial, onClose }) {
       const channels = useChannels()
-      const [form, setForm] = useState(() => ({ channelId: '', title: initial.title ?? '', text: initial.text ?? '', includeSql: false, chartMode: '' }))
+      const [form, setForm] = useState(() => ({ channelId: '', title: initial.title ?? '', text: initial.text ?? '', includeSql: false, chartMode: '', attachFull: true }))
       const [resultIds, setResultIds] = useState(initial.resultIds ?? [])
       const [loading, setLoading] = useState(Boolean(initial.message))
       useEffect(() => {
@@ -4021,9 +4047,9 @@ window.__ModuleLoader__.load({
         setState({ busy: true })
         try {
           const res = initial.dashboard
-            ? await call('sendDashboard', { channelId: form.channelId, title: form.title, ...(form.chartMode ? { chartMode: form.chartMode } : {}) })
-            : await call('sendToChannel', { channelId: form.channelId, title: form.title, text: form.text, resultIds, includeSql: form.includeSql, ...(form.chartMode ? { chartMode: form.chartMode } : {}), sessionId: initial.message?.sessionId })
-          setState({ ok: fmt(t, 'im.sent', { channel: res.channel, images: res.images }) })
+            ? await call('sendDashboard', { channelId: form.channelId, title: form.title, attachFull: form.attachFull, ...(form.chartMode ? { chartMode: form.chartMode } : {}) })
+            : await call('sendToChannel', { channelId: form.channelId, title: form.title, text: form.text, resultIds, includeSql: form.includeSql, attachFull: form.attachFull, ...(form.chartMode ? { chartMode: form.chartMode } : {}), sessionId: initial.message?.sessionId })
+          setState({ ok: `${fmt(t, 'im.sent', { channel: res.channel, images: res.images })}${res.files ? ` · ${t('im.sentFile')}` : ''}`, warn: res.warning })
           refreshChannels()
           setTimeout(onClose, 1200)
         } catch (e) {
@@ -4047,9 +4073,14 @@ window.__ModuleLoader__.load({
                 h('span', { className: 'n2s-small' }, t('im.chartMode')),
                 channel?.capabilities?.charts === 'none' && h('span', { className: 'n2s-faint n2s-small' }, t('ch.tablesOnly')),
                 h('div', { className: 'n2s-seg', role: 'group', 'aria-label': t('im.chartMode') }, ['', ...chartModesFor(channel?.capabilities, channel?.type)].map(v => h('button', { key: v || 'def', type: 'button', 'aria-pressed': form.chartMode === v, onClick: () => setForm(f => ({ ...f, chartMode: v })) }, t(v ? `im.cm.${v}` : 'im.cm.default'))))),
-              !initial.dashboard && resultIds.length > 0 && h('label', { className: 'n2s-check' }, h('input', { type: 'checkbox', checked: form.includeSql, onChange: e => setForm(f => ({ ...f, includeSql: e.target.checked })) }), t('im.includeSql'))),
+              !initial.dashboard && resultIds.length > 0 && h('label', { className: 'n2s-check' }, h('input', { type: 'checkbox', checked: form.includeSql, onChange: e => setForm(f => ({ ...f, includeSql: e.target.checked })) }), t('im.includeSql')),
+              (resultIds.length > 0 || initial.dashboard) && h('div', { className: 'n2s-field' },
+                channel?.capabilities?.files
+                  ? h('label', { className: 'n2s-check' }, h('input', { type: 'checkbox', checked: form.attachFull, onChange: e => setForm(f => ({ ...f, attachFull: e.target.checked })) }), fmt(t, 'im.attachFull', { n: channel.capabilities.tableRows ?? 10 }))
+                  : h('span', { className: 'n2s-faint n2s-small' }, fmt(t, 'im.rowsLimit', { n: channel?.capabilities?.tableRows ?? 10 })))),
           state?.error && h('div', { className: 'n2s-notice err', style: { marginTop: 10 } }, state.error),
           state?.ok && h('div', { className: 'n2s-notice ok', style: { marginTop: 10 } }, state.ok),
+          state?.warn && h('div', { className: 'n2s-notice warn', style: { marginTop: 8 } }, state.warn),
           h('div', { className: 'n2s-row', style: { marginTop: 14, justifyContent: 'flex-end' } },
             h('button', { type: 'button', className: 'n2s-btn ghost', onClick: onClose }, t('ds.cancel')),
             h('button', { type: 'button', className: 'n2s-btn primary', disabled: !form.channelId || !form.title.trim() || state?.busy || loading, onClick: send }, state?.busy ? h('span', { className: 'n2s-spin' }) : null, t('im.send'))))), document.body)
@@ -4411,7 +4442,7 @@ window.__ModuleLoader__.load({
             h('td', { title: d.title }, d.title),
             h('td', { className: 'n2s-muted' }, tOpt(t, `im.src.${d.source}`) || d.source),
             h('td', { title: d.error ?? '' }, d.status === 'ok'
-              ? h('span', { className: 'n2s-statusdot ok' }, [t('im.sentOk'), d.results ? fmt(t, 'im.resultsN', { count: d.results }) : ''].filter(Boolean).join(' · '))
+              ? h('span', { className: 'n2s-statusdot ok' }, [t('im.sentOk'), d.results ? fmt(t, 'im.resultsN', { count: d.results }) : '', d.files ? t('im.sentFile') : '', d.error ? d.error : ''].filter(Boolean).join(' · '))
               : h('span', { className: 'n2s-statusdot err' }, d.error ?? t('im.lastFailed')))))))))
     }
 
@@ -4465,7 +4496,7 @@ window.__ModuleLoader__.load({
     const HIDDEN_PIN = { hidden: true }
     const WIDGET_WIDTHS = ['third', 'half', 'full']
 
-    function DashboardWidget({ t, widget, onRemove, onChanged, onMove, tick, first, last, filters, filterCount, otherBoards = [], onTransfer, onLoaded, drag }) {
+    function DashboardWidget({ t, widget, onRemove, onChanged, onMove, tick, first, last, filters, filterCount, otherBoards = [], onTransfer, onLoaded, drag, source, showSource }) {
       const [state, setState] = useState({ busy: true })
       const [local, setLocal] = useState(0)
       useEffect(() => {
@@ -4491,6 +4522,7 @@ window.__ModuleLoader__.load({
             onKeyDown: (e) => { if (e.key === 'ArrowUp' || e.key === 'ArrowLeft') { e.preventDefault(); if (!first) onMove(-1) } if (e.key === 'ArrowDown' || e.key === 'ArrowRight') { e.preventDefault(); if (!last) onMove(1) } },
           }, svg(14, [h('circle', { key: 1, cx: 6, cy: 4, r: .9, fill: 'currentColor' }), h('circle', { key: 2, cx: 10, cy: 4, r: .9, fill: 'currentColor' }), h('circle', { key: 3, cx: 6, cy: 8, r: .9, fill: 'currentColor' }), h('circle', { key: 4, cx: 10, cy: 8, r: .9, fill: 'currentColor' }), h('circle', { key: 5, cx: 6, cy: 12, r: .9, fill: 'currentColor' }), h('circle', { key: 6, cx: 10, cy: 12, r: .9, fill: 'currentColor' })])),
           h('span', { className: 'title', title: widget.title }, widget.title),
+          showSource && h('span', { className: `n2s-badge n2s-srcbadge${source ? '' : ' warn'}`, title: source ? `${t('dash.sourceOf')}: ${source.name} · ${typeLabel(t, source.type)}` : t('dash.sourceMissing') }, Icon.db(11), source ? source.name : t('dash.sourceMissingShort')),
           state.busy ? h('span', { className: 'n2s-spin n2s-faint', 'aria-label': t('dash.loading') }) : ago && h('span', { className: 'n2s-faint n2s-small n2s-hide-narrow', title: state.result?.cached ? fmt(t, 'dash.cachedAt', { time: new Date(state.result.cachedAt).toLocaleTimeString() }) : t('dash.updatedAt') }, state.result?.cached ? `${ago} · ${t('dash.cached')}` : ago),
           state.result?.filters?.length > 0 && h('span', { className: 'n2s-badge blue', title: state.result.filters.map(f => f.description).join('\n') }, fmt(t, 'filter.appliedCount', { count: state.result.filters.length })),
           state.result && filterCount > 0 && !(state.result.filters?.length) && h('span', { className: 'n2s-badge', title: t('filter.notApplied') }, t('filter.notAppliedShort')),
@@ -4511,7 +4543,7 @@ window.__ModuleLoader__.load({
         state.result && h(ResultView, { result: widgetResult, t, compact: true, embedded: true, onPinned: HIDDEN_PIN }))
     }
 
-    function DashboardTab({ t }) {
+    function DashboardTab({ t, ds, datasources = [] }) {
       const [boardId, setBoardId] = useState(null)
       const list = useAsync(() => call('listDashboard'), [boardId])
       const boards = useAsync(() => call('listDashboards'), [boardId])
@@ -4526,7 +4558,17 @@ window.__ModuleLoader__.load({
       const [order, setOrder] = useState(null)
       useEffect(() => { setOrder(null) }, [list.value])
       const serverWidgets = list.value ?? []
-      const widgets = order ? order.map(id => serverWidgets.find(w => w.id === id)).filter(Boolean) : serverWidgets
+      const allWidgets = order ? order.map(id => serverWidgets.find(w => w.id === id)).filter(Boolean) : serverWidgets
+      // Widgets keep the data source they were pinned from; a board may mix sources.
+      // Scope: all sources, or only the one selected at the top right (remembered per browser).
+      const [scope, setScopeState] = useState(() => { try { return localStorage.getItem('nl2sql:dashScope') === 'current' ? 'current' : 'all' } catch { return 'all' } })
+      const setScope = (v) => { setScopeState(v); try { localStorage.setItem('nl2sql:dashScope', v) } catch {} }
+      const sourceIds = [...new Set(allWidgets.map(w => w.datasourceId))]
+      const mixed = sourceIds.length > 1
+      const dsById = new Map(datasources.map(d => [d.id, d]))
+      const widgets = scope === 'current' && ds ? allWidgets.filter(w => w.datasourceId === ds.id) : allWidgets
+      const hiddenByScope = allWidgets.length - widgets.length
+      const showSource = mixed || (ds && sourceIds.some(id => id !== ds.id))
       const saved = useAsync(() => call('getDashboardFilters'), [boardId])
       const [filters, setFilters] = useState(null)
       const [filtersFor, setFiltersFor] = useState(null)
@@ -4548,7 +4590,11 @@ window.__ModuleLoader__.load({
       // Drag and drop.
       const [dragId, setDragId] = useState(null)
       const [over, setOver] = useState(null) // { id, pos: 'before'|'after' }
-      const commitOrder = async (ids) => {
+      const commitOrder = async (visibleIds) => {
+        // Hidden (other-source) widgets keep their slots; visible ones take the new order.
+        const queue = [...visibleIds]
+        const visible = new Set(visibleIds)
+        const ids = allWidgets.map(w => (visible.has(w.id) ? queue.shift() : w.id))
         setOrder(ids)
         try { await call('reorderWidgets', { dashboardId: boards.value?.current, ids }) } catch (e) { notifyError(e); setOrder(null) }
         list.reload()
@@ -4587,9 +4633,13 @@ window.__ModuleLoader__.load({
       }
       return h('div', null,
         h(DashboardSwitcher, { t, value: { id: boardId }, onChange: (id) => setBoardId(`${id}:${Date.now()}`) }),
-        widgets.length > 0 && h('div', { className: 'n2s-toolbar n2s-dashbar' },
+        allWidgets.length > 0 && h('div', { className: 'n2s-toolbar n2s-dashbar' },
           h('div', { className: 'n2s-grow', style: { minWidth: 0 } },
-            h('div', { className: 'n2s-h2', style: { margin: 0 } }, fmt(t, 'dash.count', { count: widgets.length })),
+            h('div', { className: 'n2s-row', style: { gap: 10 } },
+              h('div', { className: 'n2s-h2', style: { margin: 0 } }, fmt(t, 'dash.count', { count: widgets.length })),
+              (mixed || hiddenByScope > 0 || (ds && sourceIds.some(id => id !== ds.id))) && h('div', { className: 'n2s-seg small', role: 'group', 'aria-label': t('dash.scope') },
+                ['all', 'current'].map(v => h('button', { key: v, type: 'button', 'aria-pressed': scope === v, disabled: v === 'current' && !ds, onClick: () => setScope(v) }, v === 'all' ? t('dash.scopeAll') : fmt(t, 'dash.scopeCurrent', { name: ds?.name ?? '' }))))),
+            showSource && h('div', { className: 'n2s-faint n2s-small' }, fmt(t, 'dash.sources', { list: sourceIds.map(id => dsById.get(id)?.name ?? t('dash.sourceMissingShort')).join('、') })),
             h('div', { className: 'n2s-faint n2s-small', role: 'status', 'aria-live': 'polite' },
               loadingN > 0 ? fmt(t, 'dash.loadingN', { n: loadingN }) : lastAt ? fmt(t, 'dash.lastRefresh', { time: new Date(lastAt).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit', second: '2-digit' }) }) : '',
               cachedN > 0 && loadingN === 0 ? h('span', null, ' · ', h('button', { type: 'button', className: 'n2s-link', title: t('dash.cachedHint'), onClick: () => setTick(x => x + 1) }, fmt(t, 'dash.cachedN', { n: cachedN }))) : null,
@@ -4606,11 +4656,12 @@ window.__ModuleLoader__.load({
         widgets.length > 0 && filtersReady && h(FilterBar, { key: `f:${boardId ?? 'b'}`, t, filters, onChange: changeFilters }),
         sendingDash && h(SendDialog, { t, initial: { title: t('im.dashboardTitle'), dashboard: true }, onClose: () => setSendingDash(false) }),
         list.error && h('div', { className: 'n2s-notice err' }, list.error.message),
-        !list.loading && widgets.length === 0 && h('div', { className: 'n2s-empty' }, h('h3', null, t('dash.empty')), h('div', null, t('dash.emptyHint')), h('button', { type: 'button', className: 'n2s-btn', onClick: () => fbCtx.navigate?.({ tab: 'ask' }) }, t('dash.goAsk'))),
+        !list.loading && widgets.length === 0 && hiddenByScope > 0 && h('div', { className: 'n2s-empty' }, h('h3', null, fmt(t, 'dash.scopeEmpty', { name: ds?.name ?? '' })), h('div', null, fmt(t, 'dash.scopeEmptyHint', { n: hiddenByScope })), h('button', { type: 'button', className: 'n2s-btn', onClick: () => setScope('all') }, t('dash.scopeAll'))),
+        !list.loading && allWidgets.length === 0 && h('div', { className: 'n2s-empty' }, h('h3', null, t('dash.empty')), h('div', null, t('dash.emptyHint')), h('button', { type: 'button', className: 'n2s-btn', onClick: () => fbCtx.navigate?.({ tab: 'ask' }) }, t('dash.goAsk'))),
         widgets.length > 1 && h('div', { className: 'n2s-faint n2s-small n2s-hide-narrow', style: { margin: '-4px 0 8px' } }, t('dash.dragTip')),
         filtersReady && !list.loading && h('div', { className: `n2s-dash${dragId ? ' is-dragging' : ''}`, key: `d:${boardId ?? 'b'}` }, widgets.map((w, i) => h(DashboardWidget, {
           key: w.id, t, widget: w, tick, first: i === 0, last: i === widgets.length - 1, filters: filters ?? [], filterCount: (filters ?? []).length,
-          onChanged: () => list.reload(), onLoaded, drag: dragProps(w),
+          onChanged: () => list.reload(), onLoaded, drag: dragProps(w), source: dsById.get(w.datasourceId), showSource,
           onMove: (delta) => move(w, delta),
           onRemove: async () => { if (!await confirmDialog({ title: fmt(t, 'dash.removeConfirm', { title: w.title }), danger: true })) return; try { await call('unpinWidget', { id: w.id }); notify(t('dash.removed'), 'ok') } catch (e) { notifyError(e) } list.reload() },
           otherBoards, onTransfer: async (to, copy) => { try { await call('transferWidget', { id: w.id, toDashboardId: to, copy }); notify(copy ? t('dash.copied') : t('dash.moved'), 'ok') } catch (e) { notifyError(e) } list.reload(); boards.reload() },
@@ -5441,7 +5492,7 @@ window.__ModuleLoader__.load({
                 nav.tab === 'schema' ? h(SchemaTab, { t, ds, onAskTable: (tb) => ask(fmt(t, 'ask.tablePrompt', { name: tb.name, comment: tb.comment ? `（${tb.comment}）` : '' })) }) :
                 nav.tab === 'knowledge' ? h(KnowledgeTab, { t, ds }) :
                 nav.tab === 'history' ? h(HistoryTab, { t, datasources, onOpenSession: (id) => ctx.uiWorkspace.openSession(id) }) :
-                nav.tab === 'dashboard' ? h(DashboardTab, { t }) :
+                nav.tab === 'dashboard' ? h(DashboardTab, { t, ds, datasources }) :
                 h(AdminArea, { t, ctx, section: ADMIN_SECTIONS.includes(nav.section) ? nav.section : 'sources', sub: nav.sub, onNavigate: setNav, ds, datasources }))),
             h(FeedbackLayer, { t })))
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hedeqiang/dsh-nl2sql",
-  "version": "0.11.1",
+  "version": "0.11.2",
   "description": "Data Q&A (NL2SQL) for DeepSeek Harness: ask MySQL / PostgreSQL / Elasticsearch / CSV in plain language, charts, dashboards, alerts, IM push and bots (Lark/Feishu, Telegram, WeCom, DingTalk), access control.",
   "type": "module",
   "exports": {

package/service/channels.js

@@ -11,7 +11,8 @@
  * Secrets live in one credential record per channel: `nl2sql/ch-<id>`.
  */
 import { ChannelError } from '../channels/http.js'
-import { renderChartPng } from '../channels/message.js'
+import { needsAttachment, renderChartPng } from '../channels/message.js'
+import { writeXlsx } from '../xlsx.js'
 import { getAdapter, kindOf, listCatalog, loadAdapters, requireKind, secretKeys } from '../channels/index.js'
 import { UserError, newId, pick, requireText, upsert } from './shared.js'
 
@@ -292,7 +293,7 @@ export const methods = {
    * process' cache) or given inline; each is re-checked against privacy:
    * masked values stay masked because results are stored masked.
    */
-  async sendToChannel({ channelId, title, text, resultIds = [], results = [], includeSql = false, source = 'ui', sessionId, footer, chartMode, template, mentionAll }) {
+  async sendToChannel({ channelId, title, text, resultIds = [], results = [], includeSql = false, source = 'ui', sessionId, footer, chartMode, template, mentionAll, attachFull }) {
     await loadAdapters()
     const c = this.requireChannel(channelId)
     const resolved = []
@@ -319,15 +320,30 @@ export const methods = {
       ...(template ? { template } : {}),
       footer: footer ?? `数据问答 · ${new Date().toLocaleString('zh-CN', { hour12: false })}${resolved[0]?.datasourceName ? ` · ${resolved[0].datasourceName}` : ''}`,
     }
+    // Results with more rows than the message can show: attach the full data as Excel
+    // where the platform can send files (default on; per send `attachFull: false` to skip).
+    const caps = found.kind.capabilities ?? {}
+    const shown = caps.tableRows ?? 10
+    const wantAttach = attachFull ?? c.attachFull ?? true
+    if (caps.files && wantAttach) {
+      const idx = message.results.map((r, i) => (needsAttachment(r, shown) ? i : -1)).filter(i => i >= 0)
+      if (idx.length) {
+        const sheets = idx.map(i => ({ name: (message.results[i].title || `结果${i + 1}`).slice(0, 31), columns: message.results[i].columns, rows: message.results[i].rows }))
+        if (includeSql) sheets.push({ name: 'SQL', columns: [{ name: '结果', kind: 'text' }, { name: 'SQL', kind: 'text' }], rows: idx.map(i => [message.results[i].title ?? '', message.results[i].sql ?? '']) })
+        const buffer = writeXlsx(sheets, { creator: 'DeepSeek Harness 数据问答' })
+        const safe = String(message.title).replace(/[\\/:*?"<>|\s]+/g, '_').slice(0, 60) || '数据'
+        message.attachment = { buffer, fileName: `${safe}_${new Date().toISOString().slice(0, 10)}.xlsx`, resultIndexes: idx }
+      }
+    }
     const started = Date.now()
     try {
       if (c.needsSecret) throw new ChannelError('channel/config', `渠道「${c.name}」需要重新填写密钥后才能使用`)
       const sent = await found.kind.send(this.adapterChannel(c), await this.channelSecrets(c), message, { renderChartPng, logger: console, fetch: globalThis.fetch })
       c.lastSentAt = Date.now()
       delete c.lastError
-      this.recordDelivery({ channel: c, title: message.title, status: 'ok', results: resolved.length, images: sent?.images, source, sessionId, elapsedMs: Date.now() - started })
+      this.recordDelivery({ channel: c, title: message.title, status: 'ok', results: resolved.length, images: sent?.images, files: sent?.files, ...(sent?.warning ? { error: sent.warning } : {}), source, sessionId, elapsedMs: Date.now() - started })
       await this.save()
-      return { ok: true, channel: c.name, platform: c.platform, messageId: sent?.messageId ?? null, images: sent?.images ?? 0, results: resolved.length }
+      return { ok: true, channel: c.name, platform: c.platform, messageId: sent?.messageId ?? null, images: sent?.images ?? 0, files: sent?.files ?? 0, ...(sent?.warning ? { warning: sent.warning } : {}), results: resolved.length }
     } catch (error) {
       c.lastError = error.message
       this.recordDelivery({ channel: c, title: message.title, status: 'error', error: error.message, results: resolved.length, source, sessionId, elapsedMs: Date.now() - started })
@@ -336,8 +352,8 @@ export const methods = {
     }
   },
 
-  recordDelivery({ channel, title, status, error, results, images, source, sessionId, elapsedMs }) {
-    this.records.put('delivery', { id: newId('dl'), at: Date.now(), channelId: channel.id, channelName: channel.name, ...(channel.platform ? { platform: channel.platform } : {}), title, status, ...(error ? { error: String(error).slice(0, 500) } : {}), results, images: images ?? 0, source, sessionId: sessionId ?? null, elapsedMs })
+  recordDelivery({ channel, title, status, error, results, images, files, source, sessionId, elapsedMs }) {
+    this.records.put('delivery', { id: newId('dl'), at: Date.now(), channelId: channel.id, channelName: channel.name, ...(channel.platform ? { platform: channel.platform } : {}), title, status, ...(error ? { error: String(error).slice(0, 500) } : {}), results, images: images ?? 0, files: files ?? 0, source, sessionId: sessionId ?? null, elapsedMs })
   },
 
   listDeliveries(limit = 100) {

package/service/push.js

@@ -64,7 +64,7 @@ export const methods = {
   },
 
   /** Send the current dashboard (with saved global filters) to a channel. */
-  async sendDashboard({ channelId, title, filters, dashboardId, chartMode }) {
+  async sendDashboard({ channelId, title, filters, dashboardId, chartMode, attachFull }) {
     const results = []
     const d = dashboardId ? this.requireDashboard(dashboardId) : this.currentDashboardObj()
     for (const w of d.widgets.slice(0, 10)) {
@@ -76,7 +76,7 @@ export const methods = {
       }
     }
     if (!results.length) throw new UserError('nl2sql/invalid', '看板为空')
-    const sent = await this.sendToChannel({ channelId, title: title || d.name || '数据看板', results, source: 'dashboard', chartMode })
+    const sent = await this.sendToChannel({ channelId, title: title || d.name || '数据看板', results, source: 'dashboard', chartMode, attachFull })
     await this.saveDashboardSnapshot(d, results, 'push')
     return sent
   },