@hedeqiang/dsh-nl2sql 0.11.1 → 0.12.0

package/lib/client.js

@@ -15,6 +15,32 @@ window.__ModuleLoader__.load({
     // ------------------------------------------------------------ locale
 
     const zh = {
+      'mb.pick.people': "从和机器人说过话的人中选择",
+      'mb.pick.chats': "从机器人所在的群中选择",
+      'mb.pick.refresh': "刷新",
+      'mb.pick.noPeople': "还没有人和机器人说过话。先让对方在群里 @机器人 或私聊发一句话（会提示未开通），这里就会出现，点一下即可添加。",
+      'mb.pick.noChats': "还没有可选的群。把机器人拉进群并 @它一次，或确认应用已开通「获取群信息」权限。",
+      'mb.pick.peopleHint': "点选即可自动填入账号 ID 和名称，也可以在下方手动填写。",
+      'mb.pick.chatsHint': "点选群即可自动填入群 ID 和群名；群内所有成员按该群的权限使用。",
+      'mb.pick.via': "来自渠道：{name}",
+      'mb.pick.taken': "已是成员「{name}」",
+      'mb.pick.refused': "曾因未开通被拒绝",
+      'mb.pick.pending': "待开通",
+      'mb.pick.added': "已添加",
+      'mb.pending.title': "有 {n} 个人或群向机器人提问时因未开通被拒绝，点一下即可添加为成员：",
+      'mb.pending.add': "添加",
+      '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 +1032,32 @@ window.__ModuleLoader__.load({
       'error.generic': '操作失败：{message}',
     }
     const en = {
+      'mb.pick.people': "Pick someone who talked to a bot",
+      'mb.pick.chats': "Pick a group the bot is in",
+      'mb.pick.refresh': "Refresh",
+      'mb.pick.noPeople': "Nobody has talked to a bot yet. Ask them to @-mention the bot or DM it once (they will be told they have no access); they then appear here for one-click adding.",
+      'mb.pick.noChats': "No groups to pick yet. Add the bot to a group and @-mention it once, or check the app can read chat info.",
+      'mb.pick.peopleHint': "Picking fills in the account id and name; you can also type them below.",
+      'mb.pick.chatsHint': "Picking fills in the chat id and name; everyone in the group uses its access.",
+      'mb.pick.via': "via channel: {name}",
+      'mb.pick.taken': "already member \"{name}\"",
+      'mb.pick.refused': "was refused (no access)",
+      'mb.pick.pending': "pending",
+      'mb.pick.added': "added",
+      'mb.pending.title': "{n} people or groups were refused by a bot because they are not members. Click to add:",
+      'mb.pending.add': "Add",
+      '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}",
@@ -1918,7 +1970,17 @@ window.__ModuleLoader__.load({
 .n2s-morebtn{display:flex;align-items:center;justify-content:center;gap:6px;width:100%;height:36px;margin-top:6px;border:.5px dashed var(--n2s-line-2);border-radius:var(--n2s-radius-sm);background:transparent;color:var(--n2s-muted);font:inherit;font-size:13px;cursor:pointer}
 .n2s-morebtn:hover{background:var(--n2s-hover);color:var(--dsw-alias-label-primary)}
 .n2s-btn.danger-text{color:var(--n2s-err)}
+/* ---- member identity picker ---- */
+.n2s-pickchips{display:flex;flex-wrap:wrap;gap:6px}
+.n2s-pickchip{display:inline-flex;align-items:center;gap:6px;max-width:100%;height:30px;padding:0 10px;border:.5px solid var(--n2s-line-2);border-radius:999px;background:var(--n2s-surface);color:inherit;font:inherit;font-size:12.5px;cursor:pointer}
+.n2s-pickchip:hover:not(:disabled){background:var(--n2s-hover)}
+.n2s-pickchip[aria-pressed=true]{border-color:var(--n2s-accent);background:var(--n2s-accent-soft,rgba(51,112,255,.08));color:var(--n2s-accent)}
+.n2s-pickchip:disabled{opacity:.55;cursor:default}
+.n2s-pickchip-name{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;max-width:220px}
+.n2s-idpicker{gap:6px}
 /* ---- 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}
@@ -2096,6 +2158,10 @@ window.__ModuleLoader__.load({
     /** Current UI language ('zh' | 'en'), updated by the page/tool views on render. */
     let uiLang = 'zh'
     // LocaleSnapshot is { active, locales, revision } (dsh-client-locale); older hosts passed a string.
+    /** Join a list for display in the UI language: 「a、b」 / "a, b". */
+    const joinList = (items, sep) => (items ?? []).filter(x => x !== undefined && x !== null && x !== '').join(sep ?? (uiLang === 'zh' ? '、' : ', '))
+    /** Label + colon in the UI language: 「标签：」 / "Label: ". */
+    const colon = (label) => (uiLang === 'zh' ? `${label}：` : `${label}: `)
     const setUiLang = (snapshot) => {
       const id = typeof snapshot === 'string' ? snapshot : (snapshot?.active ?? snapshot?.locale ?? 'zh')
       uiLang = /^zh/i.test(String(id)) ? 'zh' : 'en'
@@ -3280,7 +3346,7 @@ window.__ModuleLoader__.load({
       if (section === 'glossary') list = k.glossary.length ? k.glossary.map(g => item(g.id, h(React.Fragment, null, g.term, g.synonyms?.length ? h('span', { className: 'n2s-muted n2s-small' }, `  ${g.synonyms.join(' / ')}`) : null),
         h('div', null, h('div', null, g.definition), g.sql && h('code', { className: 'n2s-md-code', style: { display: 'inline-block', marginTop: 6 } }, g.sql)), 'glossary', g)) : empty(t('kb.glossaryEmpty'))
       if (section === 'metric') list = k.metrics.length ? k.metrics.map(m => item(m.id, h(React.Fragment, null, m.name, m.unit ? h('span', { className: 'n2s-badge', style: { marginLeft: 6 } }, m.unit) : null),
-        h('div', null, h('div', { className: 'n2s-mono n2s-small' }, `${m.expression}${m.table ? ` FROM ${m.table}` : ''}${m.filter ? ` WHERE ${m.filter}` : ''}`), m.timeColumn && h('div', { className: 'n2s-muted n2s-small' }, `${t('kb.timeColumn')}: ${m.timeColumn}${m.dimensions?.length ? ` · ${t('kb.dimensions')}: ${m.dimensions.join('、')}` : ''}${m.synonyms?.length ? ` · ${t('kb.synonymsLabel')}: ${m.synonyms.join('、')}` : ''}`), m.description && h('div', { className: 'n2s-muted n2s-small' }, m.description)), 'metric', m)) : empty(t('kb.metricsEmpty'))
+        h('div', null, h('div', { className: 'n2s-mono n2s-small' }, `${m.expression}${m.table ? ` FROM ${m.table}` : ''}${m.filter ? ` WHERE ${m.filter}` : ''}`), m.timeColumn && h('div', { className: 'n2s-muted n2s-small' }, `${t('kb.timeColumn')}: ${m.timeColumn}${m.dimensions?.length ? ` · ${t('kb.dimensions')}: ${m.dimensions.join(uiLang === 'zh' ? '、' : ', ')}` : ''}${m.synonyms?.length ? ` · ${t('kb.synonymsLabel')}: ${m.synonyms.join(uiLang === 'zh' ? '、' : ', ')}` : ''}`), m.description && h('div', { className: 'n2s-muted n2s-small' }, m.description)), 'metric', m)) : empty(t('kb.metricsEmpty'))
       if (section === 'note') {
         const entries = Object.entries(k.notes).sort(([a], [b]) => a.localeCompare(b))
         list = h(React.Fragment, null,
@@ -3465,7 +3531,7 @@ window.__ModuleLoader__.load({
           h('span', { className: 'n2s-tile', 'aria-hidden': true }, svg(16, [h('circle', { key: 1, cx: 8, cy: 8, r: 5.5 }), h('path', { key: 2, d: 'M8 5v3.2l2 1.3' })])),
           h('div', { className: 'n2s-grow', style: { minWidth: 0 } },
             h('div', { className: 'n2s-row', style: { gap: 6 } }, h('span', { className: 'n2s-list2-title' }, r.title), r.channelName && h('span', { className: 'n2s-badge' }, Icon.send(11), r.channelName)),
-            h('div', { className: 'n2s-list2-sub' }, `${t(`rep.period.${r.period}`)} ${r.period === 'weekly' ? r.weekdays.map(d => t(`rep.wd.${d}`)).join('、') + ' ' : ''}${r.time.slice(0, 5)} · ${r.datasourceName} · ${r.scope === 'question' ? r.question : t('rep.scope.dashboard')}`)),
+            h('div', { className: 'n2s-list2-sub' }, `${t(`rep.period.${r.period}`)} ${r.period === 'weekly' ? r.weekdays.map(d => t(`rep.wd.${d}`)).join(uiLang === 'zh' ? '、' : ', ') + ' ' : ''}${r.time.slice(0, 5)} · ${r.datasourceName} · ${r.scope === 'question' ? r.question : t('rep.scope.dashboard')}`)),
           h('div', { className: 'n2s-list2-side' },
             statusDot(r.status),
             h('span', { className: 'n2s-faint n2s-small' }, r.scheduledAt && r.status === 'active' ? `${t('rep.next')} ${new Date(r.scheduledAt).toLocaleString([], { month: 'numeric', day: 'numeric', hour: '2-digit', minute: '2-digit' })}` : '')),
@@ -3643,7 +3709,7 @@ window.__ModuleLoader__.load({
 
     // ------------------------------------------- channels: catalog & shapes
     // The host may be older (flat Lark-only channels, no channelCatalog /
-    // botStatus RPCs) or newer (docs/CHANNELS.md). Everything below normalizes
+    // botStatus RPCs) or newer (docs/channels.md). Everything below normalizes
     // both so the pages only deal with { platform, type, config, secretsSet,
     // capabilities, bot }.
 
@@ -3993,7 +4059,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 +4087,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 +4113,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 +4482,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 +4536,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 +4562,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 +4583,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 +4598,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 +4630,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 +4673,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(uiLang === 'zh' ? '、' : ', ') })),
             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 +4696,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() },
@@ -4664,7 +4755,7 @@ window.__ModuleLoader__.load({
           h('span', { className: 'n2s-wf-bar' }, h('span', { className: `n2s-wf-fill ${it.delta > 0 ? 'up' : it.delta < 0 ? 'down' : ''}`, style: { width: `${Math.max(2, Math.abs(it.delta) / max * 100)}%` } })),
           h('span', { className: 'n2s-wf-num' }, `${it.delta >= 0 ? '+' : ''}${formatCompact(it.delta)}`),
           h('span', { className: 'n2s-wf-share n2s-faint' }, it.share === null || Math.abs(it.share) > 3 ? '' : `${Math.round(it.share * 100)}%`)))),
-        why.dimensions.filter(d => !d.attribution).length > 0 && h('div', { className: 'n2s-faint n2s-small' }, `${t('drill.failedDims')}：${why.dimensions.filter(d => !d.attribution).map(d => d.dimension).join('、')}`))
+        why.dimensions.filter(d => !d.attribution).length > 0 && h('div', { className: 'n2s-faint n2s-small' }, `${colon(t('drill.failedDims'))}${why.dimensions.filter(d => !d.attribution).map(d => d.dimension).join(uiLang === 'zh' ? '、' : ', ')}`))
     }
 
     // ------------------------------------------------------------ alerts
@@ -4820,7 +4911,7 @@ window.__ModuleLoader__.load({
           h('div', { className: 'n2s-row' }, h('strong', null, fmt(t, 'sc.title', { count: c.changes.length, time: new Date(c.at).toLocaleString([], { month: 'numeric', day: 'numeric', hour: '2-digit', minute: '2-digit' }) })), h('span', { className: 'n2s-grow' }),
             h('button', { type: 'button', className: 'n2s-btn small', onClick: async () => { await call('ackSchemaChange', { id: c.id }); list.reload() } }, t('sc.ack'))),
           h('div', { className: 'n2s-small', style: { marginTop: 4 } }, c.changes.slice(0, 8).map(x => `${kindLabel(x.kind)} ${x.table}${x.column ? `.${x.column}` : ''}${x.detail ? `（${x.detail}）` : ''}`).join('；')),
-          c.impacts.length > 0 && h('div', { className: 'n2s-small', style: { marginTop: 4 } }, h('strong', null, `${t('sc.impacts')}：`), c.impacts.slice(0, 8).map(i => `${t(`sc.imp.${i.kind}`)}「${i.name}」`).join('、')))))
+          c.impacts.length > 0 && h('div', { className: 'n2s-small', style: { marginTop: 4 } }, h('strong', null, `${colon(t('sc.impacts'))}`), c.impacts.slice(0, 8).map(i => `${t(`sc.imp.${i.kind}`)}「${i.name}」`).join(uiLang === 'zh' ? '、' : ', ')))))
     }
 
     // -------------------------------------------------- knowledge io
@@ -4889,7 +4980,7 @@ window.__ModuleLoader__.load({
       if (s.kind === 'example') return h('pre', { className: 'n2s-code', style: { marginTop: 6, maxHeight: 140 } }, prettySql(it.sql ?? ''))
       if (s.kind === 'metric') return h('div', null,
         h('div', { className: 'n2s-mono n2s-small' }, `${it.expression}${it.table ? ` FROM ${it.table}` : ''}${it.filter ? ` WHERE ${it.filter}` : ''}`),
-        (it.timeColumn || it.dimensions?.length) && h('div', { className: 'n2s-muted n2s-small' }, [it.timeColumn && `${t('kb.timeColumn')}: ${it.timeColumn}`, it.dimensions?.length && `${t('kb.dimensions')}: ${it.dimensions.join('、')}`].filter(Boolean).join(' · ')))
+        (it.timeColumn || it.dimensions?.length) && h('div', { className: 'n2s-muted n2s-small' }, [it.timeColumn && `${t('kb.timeColumn')}: ${it.timeColumn}`, it.dimensions?.length && `${t('kb.dimensions')}: ${it.dimensions.join(uiLang === 'zh' ? '、' : ', ')}`].filter(Boolean).join(' · ')))
       if (s.kind === 'note') return h('div', { className: 'n2s-small' }, it.text)
       return h('div', null, h('div', { className: 'n2s-small' }, it.definition), it.sql && h('code', { className: 'n2s-md-code', style: { display: 'inline-block', marginTop: 4 } }, it.sql))
     }
@@ -4995,6 +5086,69 @@ window.__ModuleLoader__.load({
         h('button', { type: 'button', className: 'n2s-btn small ghost', style: { justifySelf: 'start' }, onClick: () => onChange([...rows, { platform: rows[rows.length - 1]?.platform ?? platforms[0], id: '', email: '' }]) }, '+ ', t('mb.ids.add')))
     }
 
+    /**
+     * One-click identity picks: people and groups that already talked to a bot
+     * (recorded by the host, including refused ones), plus the groups a bot is
+     * in (channels whose kind can list targets). No id lookup needed.
+     */
+    function IdentityPicker({ t, kind, catalog, onPick, chosen }) {
+      const seen = useAsync(() => call('listSeenIdentities', { kind }).catch(() => []), [kind])
+      const channels = useChannels()
+      const listable = channels.filter(c => (c.capabilities ?? findKind(catalog, c.type)?.kind?.capabilities)?.listTargets)
+      const [groups, setGroups] = useState(null)
+      const [loadingGroups, setLoadingGroups] = useState(false)
+      const loadGroups = async () => {
+        setLoadingGroups(true)
+        const out = []
+        for (const c of listable) {
+          try { for (const g of await call('listChannelTargets', { id: c.id })) out.push({ platform: c.platform, kind: 'chat', id: String(g.id), name: g.name, via: c.name }) } catch (e) { notifyError(e) }
+        }
+        setGroups(out); setLoadingGroups(false)
+      }
+      useEffect(() => { if (kind === 'chat' && listable.length && groups === null) loadGroups() }, [kind, listable.length])
+      const isChosen = (x) => chosen.some(r => r.platform === x.platform && r.id === x.id)
+      const items = [...(seen.value ?? [])]
+      if (kind === 'chat') for (const g of groups ?? []) if (!items.some(x => x.platform === g.platform && x.id === g.id)) items.push(g)
+      const label = (x) => x.name || x.chatName || x.email || x.id
+      return h('div', { className: 'n2s-field full n2s-idpicker' },
+        h('div', { className: 'n2s-row' },
+          h('span', { className: 'n2s-flabel' }, kind === 'chat' ? t('mb.pick.chats') : t('mb.pick.people')),
+          h('span', { className: 'n2s-grow' }),
+          kind === 'chat' && listable.length > 0 && h('button', { type: 'button', className: 'n2s-link n2s-small', disabled: loadingGroups, onClick: loadGroups }, loadingGroups ? h('span', { className: 'n2s-spin' }) : Icon.refresh(12), t('mb.pick.refresh'))),
+        seen.loading && !seen.value ? h('div', { className: 'n2s-skel', style: { height: 34 } }) :
+          items.length === 0
+            ? h('div', { className: 'n2s-faint n2s-small' }, kind === 'chat' ? t('mb.pick.noChats') : t('mb.pick.noPeople'))
+            : h('div', { className: 'n2s-pickchips', role: 'list' }, items.slice(0, 30).map(x => {
+              const taken = x.memberId && !isChosen(x)
+              return h('button', {
+                key: `${x.platform}:${x.id}`, type: 'button', role: 'listitem', className: 'n2s-pickchip', 'aria-pressed': isChosen(x), disabled: Boolean(taken),
+                title: [`${platformName(t, x.platform, catalog)} · ${x.id}`, x.email, x.via ? fmt(t, 'mb.pick.via', { name: x.via }) : '', taken ? fmt(t, 'mb.pick.taken', { name: x.memberName }) : '', x.refused ? t('mb.pick.refused') : ''].filter(Boolean).join('\n'),
+                onClick: () => onPick(x),
+              },
+              h(PlatformMark, { t, platform: x.platform, size: 16 }),
+              h('span', { className: 'n2s-pickchip-name' }, label(x)),
+              x.refused && !x.memberId && h('span', { className: 'n2s-badge warn' }, t('mb.pick.pending')),
+              taken && h('span', { className: 'n2s-faint' }, t('mb.pick.added')),
+              x.lastAt && h('span', { className: 'n2s-faint' }, shortTime(x.lastAt)))
+            })),
+        h('div', { className: 'n2s-faint n2s-small' }, kind === 'chat' ? t('mb.pick.chatsHint') : t('mb.pick.peopleHint')))
+    }
+
+    /** People / groups refused by a bot because they are not members yet: add with one click. */
+    function PendingMembers({ t, onAdd }) {
+      const seen = useAsync(() => call('listSeenIdentities', {}).catch(() => []), [])
+      const { catalog } = useCatalog(t)
+      const pending = (seen.value ?? []).filter(x => x.refused && !x.memberId).slice(0, 6)
+      if (!pending.length) return null
+      return h('div', { className: 'n2s-notice warn n2s-pending', role: 'status', style: { marginBottom: 12 } },
+        h('div', { style: { marginBottom: 6 } }, fmt(t, 'mb.pending.title', { n: pending.length })),
+        h('div', { className: 'n2s-pickchips' }, pending.map(x => h('button', { key: `${x.platform}:${x.kind}:${x.id}`, type: 'button', className: 'n2s-pickchip', onClick: () => onAdd(x), title: `${platformName(t, x.platform, catalog)} · ${x.id}` },
+          h(PlatformMark, { t, platform: x.platform, size: 16 }),
+          h('span', { className: 'n2s-pickchip-name' }, x.name || x.chatName || x.id),
+          h('span', { className: 'n2s-faint' }, x.kind === 'chat' ? t('mb.kind2.chat') : t('mb.kind2.person')),
+          h('span', { className: 'n2s-link' }, t('mb.pending.add'))))))
+    }
+
     function IdentityChips({ t, u, catalog }) {
       const ids = identitiesOf(u)
       if (!ids.length) return h('span', { className: 'n2s-badge warn' }, t('mb.ids.none'))
@@ -5002,11 +5156,11 @@ window.__ModuleLoader__.load({
         h(PlatformMark, { t, platform: x.platform, size: 16 }), h('span', { className: 'n2s-mono' }, x.id || x.email))))
     }
 
-    function UserForm({ t, initial, datasources, onDone, onCancel }) {
+    function UserForm({ t, initial, prefill, datasources, onDone, onCancel }) {
       const { catalog } = useCatalog(t)
       const [form, setForm] = useState(() => {
-        const base = { kind: 'person', name: '', role: 'analyst', allDatasources: initial ? initial.datasourceIds === null : false, datasourceIds: [], note: '', ...(initial ?? {}) }
-        const ids = identitiesOf(initial)
+        const base = { kind: prefill?.kind ?? 'person', name: prefill ? (prefill.name || prefill.chatName || '') : '', role: 'analyst', allDatasources: initial ? initial.datasourceIds === null : false, datasourceIds: [], note: '', ...(initial ?? {}) }
+        const ids = prefill ? [{ platform: prefill.platform, id: prefill.id, ...(prefill.kind === 'person' && prefill.email ? { email: prefill.email } : {}) }] : identitiesOf(initial)
         return { ...base, identities: ids.length ? ids : [{ platform: 'lark', id: '', email: '' }] }
       })
       const [error, setError] = useState(null)
@@ -5038,6 +5192,11 @@ window.__ModuleLoader__.load({
           h('div', { className: 'n2s-field full' }, h('span', { id: 'n2s-mb-kind' }, t('mb.kind')), h('div', { className: 'n2s-seg', role: 'group', 'aria-labelledby': 'n2s-mb-kind', style: { justifySelf: 'start' } }, ['person', 'chat'].map(v => h('button', { key: v, type: 'button', 'aria-pressed': form.kind === v, disabled: Boolean(initial?.id), onClick: () => setForm(f => ({ ...f, kind: v })) }, t(`mb.kind2.${v}`))))),
           h('label', { className: 'n2s-field' }, h('span', null, t('im.name')), h('input', { className: 'n2s-input', value: form.name, onChange: set('name') })),
           h('label', { className: 'n2s-field' }, h('span', null, t('mb.role')), h('select', { className: 'n2s-select', value: form.role, onChange: set('role') }, ['admin', 'analyst', 'viewer'].map(r => h('option', { key: r, value: r }, t(`mb.role.${r}`)))), h('span', { className: 'n2s-faint n2s-small' }, t(`mb.roleHint.${form.role}`))),
+          !initial?.id && h(IdentityPicker, { t, kind: form.kind, catalog, chosen: form.identities, onPick: (x) => setForm(f => {
+            const exists = f.identities.some(r => r.platform === x.platform && r.id === x.id)
+            const rows = exists ? f.identities.filter(r => !(r.platform === x.platform && r.id === x.id)) : [...f.identities.filter(r => r.id || r.email), { platform: x.platform, id: x.id, ...(f.kind === 'person' && x.email ? { email: x.email } : {}) }]
+            return { ...f, identities: rows.length ? rows : [{ platform: x.platform, id: '', email: '' }], name: f.name || (exists ? f.name : (x.name || x.chatName || '')) }
+          }) }),
           h(IdentityEditor, { t, kind: form.kind, rows: form.identities, catalog, errors: idErrors, onChange: (rows) => { setForm(f => ({ ...f, identities: rows })); setIdErrors({}) } }),
           h('div', { className: 'n2s-field full' }, h('span', null, t('mb.scope')),
             h('label', { className: 'n2s-check' }, h('input', { type: 'checkbox', checked: form.allDatasources, onChange: set('allDatasources') }), t('mb.allDs')),
@@ -5128,7 +5287,8 @@ window.__ModuleLoader__.load({
       return h('div', null,
         h(SectionHead, { title: t('tab.members'), desc: t('mb.hint') }, h('button', { type: 'button', className: 'n2s-btn primary', onClick: () => setEditing({}) }, '+ ', t('mb.add'))),
         h(BotsOverview, { t }),
-        editing && h(UserForm, { key: editing.id ?? 'new', t, datasources, initial: editing.id ? editing : null, onCancel: () => setEditing(null), onDone: () => { setEditing(null); users.reload() } }),
+        !editing && h(PendingMembers, { t, onAdd: (x) => setEditing({ prefill: x }) }),
+        editing && h(UserForm, { key: editing.id ?? (editing.prefill ? `p:${editing.prefill.id}` : 'new'), t, datasources, prefill: editing.prefill, initial: editing.id ? editing : null, onCancel: () => setEditing(null), onDone: () => { setEditing(null); users.reload() } }),
         settings.value && h('div', { className: 'n2s-setnote', style: { marginBottom: 10 } },
           t('mb.default'), ' ', h('strong', null, t(`mb.defaultRole.${settings.value.botDefaultRole ?? settings.value.larkDefaultRole ?? 'none'}`)), ' · ',
           h('button', { type: 'button', className: 'n2s-link', onClick: () => fbCtx.navigate?.({ tab: 'admin', section: 'settings' }) }, t('set.changeInSettings'))),
@@ -5140,7 +5300,7 @@ window.__ModuleLoader__.load({
               h('div', { className: 'n2s-grow', style: { minWidth: 0 } },
                 h('div', { className: 'n2s-row', style: { gap: 6 } }, h('span', { className: 'n2s-list2-title' }, u.name), h('span', { className: 'n2s-badge' }, t(`mb.role.${u.role}`)), u.disabled && h('span', { className: 'n2s-badge err' }, t('mb.disabled'))),
                 h('div', { className: 'n2s-row', style: { gap: 6, marginTop: 4 } }, h(IdentityChips, { t, u, catalog }), h('span', { className: 'n2s-muted n2s-small' }, u.datasourceIds === null ? t('mb.allDs') : (u.datasourceNames ?? []).join(uiLang === 'zh' ? '、' : ', ') || t('mb.noDs'))),
-                (u.rowRules ?? []).length > 0 && h('div', { className: 'n2s-list2-sub' }, `${t('mb.rowRules')}：${u.rowRules.map(r => `${r.column} ∈ {${r.values.join(', ')}}`).join('；')}`)),
+                (u.rowRules ?? []).length > 0 && h('div', { className: 'n2s-list2-sub' }, `${colon(t('mb.rowRules'))}${u.rowRules.map(r => `${r.column} ∈ {${r.values.join(', ')}}`).join('；')}`)),
               h('div', { className: 'n2s-list2-side' }, h('span', { className: 'n2s-small' }, us ? fmt(t, 'mb.queries', { n: us.queries }) : t('mb.noUsage')), us?.lastAt && h('span', { className: 'n2s-faint n2s-small' }, new Date(us.lastAt).toLocaleDateString())),
               h(Dropdown, { label: fmt(t, 'ch.actionsFor', { name: u.name }), trigger: { content: Icon.more() }, items: [
                 { label: t('ds.edit'), icon: Icon.edit(14), onClick: () => setEditing(u) },
@@ -5441,7 +5601,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 })))
       }
@@ -5708,7 +5868,7 @@ window.__ModuleLoader__.load({
             h('table', { className: 'n2s-table' }, h('thead', null, h('tr', null, [t('set.section'), t('set.toAdd'), t('set.toUpdate'), t('set.note')].map((x, i) => h('th', { key: i }, x)))),
               h('tbody', null, Object.entries(importState.dry?.report ?? {}).map(([k, r]) => h('tr', { key: k },
                 h('td', null, t(`set.sec.${k}`)), h('td', null, r.add ?? r.added ?? 0), h('td', null, r.update ?? r.updated ?? 0),
-                h('td', { className: 'n2s-muted n2s-small', style: { whiteSpace: 'normal' } }, [r.needsSecret?.length ? fmt(t, 'set.needsSecret', { names: r.needsSecret.join('、') }) : '', r.paused ? t('set.reportsPaused') : '', r.skipped ? fmt(t, 'set.skipped', { n: r.skipped }) : ''].filter(Boolean).join('；')))))),
+                h('td', { className: 'n2s-muted n2s-small', style: { whiteSpace: 'normal' } }, [r.needsSecret?.length ? fmt(t, 'set.needsSecret', { names: r.needsSecret.join(uiLang === 'zh' ? '、' : ', ') }) : '', r.paused ? t('set.reportsPaused') : '', r.skipped ? fmt(t, 'set.skipped', { n: r.skipped }) : ''].filter(Boolean).join('；')))))),
             h('div', { className: 'n2s-row', style: { marginTop: 14, justifyContent: 'flex-end' } },
               h('button', { type: 'button', className: 'n2s-btn ghost', onClick: () => setImportState(null) }, t('ds.cancel')),
               h('button', { type: 'button', className: 'n2s-btn danger', onClick: () => doImport('replace') }, t('kb.replace')),
@@ -5724,7 +5884,7 @@ window.__ModuleLoader__.load({
         row('dataDir', v?.dataDir, true),
         row('runtime', v ? `Node ${v.nodeVersion} · SQLite ${v.sqliteVersion}` : null),
         row('tests', v?.testsCommand, true),
-        row('docs', 'DEVELOPMENT.md'))))
+        row('docs', 'github.com/hedeqiang/dsh-nl2sql'))))
     }
 
     // ------------------------------------------------------------ apply

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hedeqiang/dsh-nl2sql",
-  "version": "0.11.1",
-  "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.",
+  "version": "0.12.0",
+  "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",
   "exports": {
     ".": "./index.js",
@@ -29,10 +29,10 @@
     "locale/*.json",
     "icon.svg",
     "README.md",
-    "README.en.md",
     "LICENSE",
     "CHANGELOG.md",
-    "docs/CHANNELS.md"
+    "README.zh-CN.md",
+    "docs/channels.md"
   ],
   "dependencies": {
     "@larksuiteoapi/node-sdk": "1.76.0",
@@ -93,5 +93,9 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "homepage": "https://github.com/hedeqiang/dsh-nl2sql#readme",
+  "bugs": {
+    "url": "https://github.com/hedeqiang/dsh-nl2sql/issues"
   }
 }

package/service/access.js

@@ -99,7 +99,7 @@ export const methods = {
   /**
    * Members: people and group chats on IM platforms, each with a role
    * (admin | analyst | viewer), a data source scope and platform-scoped
-   * identities [{ platform, id, email? }] (see docs/CHANNELS.md). The local
+   * identities [{ platform, id, email? }] (see docs/channels.md). The local
    * owner is implicit. Bot messages from unknown people fall back to
    * settings.botDefaultRole (none = refuse).
    */
@@ -212,6 +212,43 @@ export const methods = {
     }
   },
 
+  /**
+   * Remember an IM identity that talked to a bot (refused or not), so admins can
+   * add it as a member with one click instead of looking up ids. Bounded list,
+   * most recent first; keyed by (platform, kind, id).
+   */
+  noteSeenIdentity({ platform, kind, id, name, email, chatName, channelId, refused }) {
+    if (!platform || !id) return
+    this.state.seenIdentities ??= []
+    const list = this.state.seenIdentities
+    const key = `${platform}:${kind}:${id}`
+    const i = list.findIndex(x => `${x.platform}:${x.kind}:${x.id}` === key)
+    const prev = i >= 0 ? list.splice(i, 1)[0] : {}
+    list.unshift({ ...prev, platform, kind, id: String(id), ...(name ? { name: String(name).slice(0, 60) } : {}), ...(email ? { email: String(email).slice(0, 200) } : {}), ...(chatName ? { chatName: String(chatName).slice(0, 80) } : {}), ...(channelId ? { channelId } : {}), lastAt: Date.now(), count: (prev.count ?? 0) + 1, refused: Boolean(refused) })
+    if (list.length > 200) list.length = 200
+  },
+
+  /**
+   * People and group chats that talked to a bot recently, for the member form:
+   * [{ platform, kind:'person'|'chat', id, name?, email?, chatName?, lastAt, count, refused, memberId? }].
+   * `memberId` is set when the identity already belongs to a member.
+   */
+  listSeenIdentities({ kind, platform } = {}) {
+    const users = (this.state.users ?? []).map(u => normalizeUserRecord(u))
+    // Group chats seen in bot conversations count too (older data has no seen list).
+    const seen = [...(this.state.seenIdentities ?? [])]
+    for (const c of Object.values(this.state.botConversations ?? {})) {
+      if (c.chatType === 'group' && c.chatId && !seen.some(x => x.kind === 'chat' && x.platform === c.platform && x.id === String(c.chatId))) seen.push({ platform: c.platform ?? 'lark', kind: 'chat', id: String(c.chatId), chatName: c.chatName, name: c.chatName, lastAt: c.lastAt ?? c.createdAt, count: 1, refused: false })
+    }
+    return seen
+      .filter(x => (!kind || x.kind === kind) && (!platform || x.platform === platform))
+      .map(x => {
+        const owner = users.find(u => u.kind === x.kind && u.identities.some(i => i.platform === x.platform && i.id === x.id))
+        return { ...x, ...(owner ? { memberId: owner.id, memberName: owner.name } : {}) }
+      })
+      .sort((a, b) => (b.lastAt ?? 0) - (a.lastAt ?? 0))
+  },
+
   /** Back-compat alias of resolveActor for Lark. */
   resolveLarkActor({ openId, email, name, chatId, chatType }) {
     return this.resolveActor({ platform: 'lark', userId: openId, email, name, chatId, chatType })