feat(qa-ops): 重做四页布局与周报草稿导出
build / build (push) Successful in 1m3s

This commit is contained in:
姚章浩
2026-10-18 20:00:38 +08:00
parent 3e7fcce0b1
commit 93aabc8a81
18 changed files with 1037 additions and 157 deletions
+12
View File
@@ -76,6 +76,18 @@
> `0.1.12`),由 `scripts/version.py` 从 git **算出来**;开发交付的独立说明写入本文件“开发快照”章节,并打 `snapshot/vX.Y.Z` 注释标签 ⇒ 每次开发交付均可追溯,
> 但"发布版本"仍然只能由人定(CI 不会自动升版本、不会打 tag)。
## 开发快照 snapshot/v0.1.29 - 2026-10-18
### Added
- 问答运营调整为“问题流水、问题统计看板、区域配置、周报生成”四页,流水与看板共用年份、自然周和查询条件;区域页不再显示问题查询框,完整字段及人工复核入口保留。
- 重做统计看板:展示完整筛选范围的问题量、覆盖率、正确率、人工复核、北京时间每日趋势、质量分布、区域、问题类型和产品分类;个人月明细折叠保留,未知分类与零分母不虚构结论。
- 周报页提供手动草稿、Markdown 预览及 MD/完整明细 CSV 下载。核对副本版本、完整数量、质量范围与覆盖分布后生成;CSV 保留完整十五列并防护公式注入,不发送、不归档、不作为正式持久化周报验收。
### Changed
- 删除问答记录、同步栏和区域页中的冗余解释文字、读取时间与源连接提示,保留真实错误、未同步、权限阻断和安全告警。
## 开发快照 snapshot/v0.1.28 - 2026-10-18
### Added
+1 -1
View File
@@ -25,6 +25,6 @@ describe('AI answer Markdown preview', () => {
expect(html).toContain('查看图片')
})
it('does not confuse an empty answer with a positive assessment', () => {
expect(renderToStaticMarkup(<QAAnswerMarkdown answer="" />)).toContain('尚无答案;不默认判覆盖或正确')
expect(renderToStaticMarkup(<QAAnswerMarkdown answer="" />)).toContain('暂无答案')
})
})
+1 -1
View File
@@ -16,7 +16,7 @@ export function safeAnswerURL(value: string): string {
export function QAAnswerMarkdown({ answer }: { answer: string }) {
const [showImages, setShowImages] = useState(false)
if (!answer) return <p>尚无答案;不默认判覆盖或正确</p>
if (!answer) return <p>暂无答案</p>
return (
<div className="qa-answer">
<div className="qa-answer-tools">
+42
View File
@@ -0,0 +1,42 @@
import { renderToStaticMarkup } from 'react-dom/server'
import { describe, it, expect, vi } from 'vitest'
import { qaDailySeries, qaCategorySeries } from './qaDashboard'
import { QADashboardView } from './QADashboard'
import type { QARecord, QAQuery } from './qaOps'
const query: QAQuery = { start: '2026-10-11T16:00:00Z', end: '2026-10-13T16:00:00Z', keyword: '', cursor: '' }
const records = [
{ id: 'a', asked_at: '2026-10-11T16:30:00Z', product_category: '<img src=x onerror=alert(1)>', problem_type: '通信' },
{ id: 'b', asked_at: '2026-10-12T16:01:00Z' },
] as QARecord[]
describe('question dashboard projections', () => {
it('groups by Beijing day and keeps zero days instead of using the browser timezone', () => {
expect(qaDailySeries(records, query)).toEqual([
{ label: '2026-10-12', count: 1 },
{ label: '2026-10-13', count: 1 },
])
expect(qaDailySeries([], query).map((p) => p.count)).toEqual([0, 0])
})
it('keeps unclassified records distinct without inventing a category', () => {
expect(qaCategorySeries(records, 'problem_type')).toEqual([
{ label: '通信', count: 1 },
{ label: '未分类', count: 1 },
])
})
it('renders the real dashboard panels and escaped category text', () => {
const html = renderToStaticMarkup(
<QADashboardView
page={{ items: records, columns: [], total: 2, has_more: false, next_cursor: '', as_of: query.end }}
query={query}
quality={null}
usage={null}
loading={false}
error=""
onRetry={vi.fn()}
/>
)
for (const title of ['问题总量', '每日提问趋势', '质量分布', '区域分布', '产品分类', '问题类型'])
expect(html).toContain(title)
expect(html).not.toContain('<img src=x')
expect(html).not.toContain('0.0%')
})
})
+223
View File
@@ -0,0 +1,223 @@
import { useEffect, useState } from 'react'
import type { QARecordPage, QAQuery } from './qaOps'
import type { QualitySummary, QualityRate } from './qaQuality'
import type { QAUsage } from './qaUsage'
import { fetchQAUsage, usageLabels } from './qaUsage'
import { qaDailySeries, qaCategorySeries, fetchQADashboardQuality } from './qaDashboard'
import type { QACountPoint } from './qaDashboard'
import { QAMonthly } from './QAMonthly'
import './qaDashboard.css'
export interface QADashboardProps {
page: QARecordPage | null
query: QAQuery | null
quality: QualitySummary | null
usage: QAUsage | null
loading: boolean
error: string
onRetry: () => void
}
const percent = (r: QualityRate | undefined) => (r?.percent == null ? '—' : `${r.percent.toFixed(1)}%`)
function Bars({ points }: { points: QACountPoint[] }) {
const max = Math.max(1, ...points.map((p) => p.count))
return points.length ? (
<div className="qa-chart-bars">
{points.map((p) => (
<div className="qa-chart-bar" key={p.label}>
<span title={p.label}>{p.label}</span>
<div className="qa-chart-track">
<i style={{ width: `${(p.count / max) * 100}%` }} />
</div>
<b>{p.count}</b>
</div>
))}
</div>
) : (
<p className="qa-chart-empty">暂无数据</p>
)
}
export function QADashboardView(p: QADashboardProps) {
const page = p.loading ? null : p.page,
items = page?.items || [],
q = page && p.quality?.summary.total === page.total ? p.quality : null
const b = q?.summary.rates.breakdown
const daily = page && p.query ? qaDailySeries(items, p.query) : []
const max = Math.max(1, ...daily.map((d) => d.count))
const outcomes = b
? [
['已覆盖', b.covered],
['未覆盖', b.uncovered],
['部分覆盖', b.partial],
['待确认', b.pending],
['未评估', b.unassessed],
['不计入', b.excluded],
['待重新核对', b.stale],
].map(([label, count]) => ({ label: String(label), count: Number(count) }))
: []
return (
<section className="qa-dashboard" aria-label="问题统计看板">
{p.error ? (
<div role="alert" className="error-banner">
{p.error}{' '}
<button type="button" onClick={p.onRetry}>
重新读取
</button>
</div>
) : null}
{p.loading ? <p role="status">正在读取完整统计范围…</p> : null}
<div className="qa-dashboard-metrics" aria-label="问题概览">
<div>
<span>问题总量</span>
<strong>{page?.total ?? '—'}</strong>
<small>条</small>
</div>
<div>
<span>知识覆盖率</span>
<strong>{percent(q?.summary.rates.coverage)}</strong>
<small>
{q ? `${q.summary.rates.coverage.numerator} / ${q.summary.rates.coverage.denominator}` : '分子 / 分母'}
</small>
</div>
<div>
<span>回答正确率</span>
<strong>{percent(q?.summary.rates.correctness)}</strong>
<small>
{q
? `${q.summary.rates.correctness.numerator} / ${q.summary.rates.correctness.denominator}`
: '分子 / 分母'}
</small>
</div>
<div>
<span>已人工复核</span>
<strong>{q?.summary.reviewed ?? '—'}</strong>
<small>{q ? `待复核 ${q.summary.unreviewed}` : '条'}</small>
</div>
</div>
<div className="qa-dashboard-grid">
<section className="qa-chart qa-chart-wide">
<h3>每日提问趋势</h3>
{daily.length ? (
<div className="qa-daily-chart" role="img" aria-label="北京时间每日提问量">
{daily.map((d) => (
<div key={d.label} title={`${d.label}:${d.count} 条`}>
<b>{d.count}</b>
<div>
<i style={{ height: `${(d.count / max) * 100}%` }} />
</div>
<span>{d.label.slice(5)}</span>
</div>
))}
</div>
) : (
<p className="qa-chart-empty">暂无数据</p>
)}
</section>
<section className="qa-chart">
<h3>质量分布</h3>
<Bars points={outcomes} />
</section>
<section className="qa-chart qa-chart-wide">
<h3>区域分布</h3>
<Bars
points={
p.usage?.rows
.filter((r) => r.questions > 0)
.map((r) => ({ label: usageLabels[r.key] || r.key, count: r.questions })) || []
}
/>
{p.usage ? (
<div className="qa-dashboard-region-table">
<table>
<thead>
<tr>
<th>区域</th>
<th>提问量</th>
<th>已关联使用人数</th>
</tr>
</thead>
<tbody>
{p.usage.rows
.filter((r) => r.questions > 0 || r.roster_people !== null)
.map((r) => (
<tr key={r.key}>
<td>{usageLabels[r.key] || r.key}</td>
<td>{r.questions}</td>
<td>{r.users ?? '—'}</td>
</tr>
))}
</tbody>
</table>
</div>
) : null}
</section>
<section className="qa-chart">
<h3>问题类型</h3>
<Bars points={qaCategorySeries(items, 'problem_type')} />
</section>
<section className="qa-chart qa-chart-full">
<h3>产品分类</h3>
<Bars points={qaCategorySeries(items, 'product_category')} />
</section>
</div>
</section>
)
}
export function QADashboard({
page,
query,
loading,
error,
revision,
onRetry,
}: {
page: QARecordPage | null
query: QAQuery | null
loading: boolean
error: string | null
revision: number
onRetry: () => void
}) {
const [quality, setQuality] = useState<QualitySummary | null>(null),
[usage, setUsage] = useState<QAUsage | null>(null),
[failure, setFailure] = useState(''),
[monthly, setMonthly] = useState(false)
useEffect(() => {
setQuality(null)
setUsage(null)
setFailure('')
if (!query) return
const abort = new AbortController()
void fetchQADashboardQuality(query, abort.signal)
.then((v) => {
if (!abort.signal.aborted) setQuality(v)
})
.catch((e) => {
if (!abort.signal.aborted) setFailure(e instanceof Error ? e.message : '质量统计读取失败')
})
void fetchQAUsage(query, abort.signal)
.then((v) => {
if (!abort.signal.aborted) setUsage(v)
})
.catch((e) => {
if (!abort.signal.aborted) setFailure(e instanceof Error ? e.message : '区域统计读取失败')
})
return () => abort.abort()
}, [query, revision])
const mismatch = !!page && !!quality && page.total !== quality.summary.total
return (
<div className="qa-dashboard-scroll">
<QADashboardView
page={page}
query={query}
quality={quality}
usage={usage}
loading={loading}
error={error || failure || (mismatch ? '统计范围已更新,请重新查询' : '')}
onRetry={onRetry}
/>
<details className="qa-monthly-disclosure" onToggle={(e) => setMonthly(e.currentTarget.open)}>
<summary>个人月明细</summary>
{monthly ? <QAMonthly /> : null}
</details>
</div>
)
}
+2 -2
View File
@@ -22,7 +22,7 @@ describe('local Q&A synchronization strip', () => {
expect(html).toContain('本地数据库')
expect(html).toContain('首次同步尚未完成')
expect(html).toContain('立即同步')
expect(html).toContain('每 5 分钟')
expect(html).not.toContain('每 5 分钟后台同步 · 查询不请求远端')
})
it('keeps the last-good dataset visibly stale after a failed sync', () => {
const status = {
@@ -38,7 +38,7 @@ describe('local Q&A synchronization strip', () => {
const html = renderToStaticMarkup(<QAMirrorSyncView status={status} error="" submitting={false} onSync={vi.fn()} />)
expect(html).toContain('639')
expect(html).toContain('保留上次成功数据')
expect(html).toContain('最近成功同步')
expect(html).not.toContain('不承诺实时源快照')
})
it('distinguishes authorization blocking from an ordinary network failure', () => {
const html = renderToStaticMarkup(
+2 -3
View File
@@ -9,7 +9,6 @@ interface ViewProps {
submitting: boolean
onSync: () => void
}
const stamp = (v: string) => new Date(v).toLocaleString('zh-CN', { hour12: false })
export function QAMirrorSyncView(p: ViewProps) {
const s = p.status
const active = mirrorSyncActive(s)
@@ -17,7 +16,7 @@ export function QAMirrorSyncView(p: ViewProps) {
<section className="qa-mirror-sync" aria-label="问答本地数据库与同步状态">
<div className="qa-mirror-sync-line">
<strong>本地数据库</strong>
<span>每 5 分钟后台同步 · 查询不请求远端</span>
{s?.ready ? <span>已同步 {s.records} 条</span> : null}
<button type="button" onClick={p.onSync} disabled={p.submitting || !s?.worker_ready || active}>
{p.submitting ? '正在入队…' : active ? '后台同步中…' : '立即同步'}
@@ -30,7 +29,7 @@ export function QAMirrorSyncView(p: ViewProps) {
? '源端权限校验未通过,本地读取已阻断;修复授权后可重新同步。'
: !s.ready
? '首次同步尚未完成,暂不把未同步数据视为空结果。'
: `最近成功同步:${stamp(s.last_success_at!)};页面基于该本地副本,不承诺实时源快照。`}
: ''}
{s?.job && active ? (
<span>
{' '}
+14 -1
View File
@@ -1,6 +1,6 @@
import { renderToStaticMarkup } from 'react-dom/server'
import { describe, expect, it, vi } from 'vitest'
import { QAOperationsView } from './QAOperations'
import { QAOperationsTabs, QAOperationsView } from './QAOperations'
import type { QARecord, QARecordPage } from './qaOps'
import { restoreWorkspace } from './workspace'
@@ -50,6 +50,19 @@ const props = {
}
describe('QA operations workbench', () => {
it('uses the four requested destinations in their fixed order', () => {
const html = renderToStaticMarkup(<QAOperationsTabs view="records" onChange={vi.fn()} />)
const labels = ['问题流水', '问题统计看板', '区域配置', '周报生成']
for (const label of labels) expect(html).toContain(label)
for (let i = 1; i < labels.length; i++) expect(html.indexOf(labels[i - 1])).toBeLessThan(html.indexOf(labels[i]))
expect(html).not.toContain('部门/区域保留源快照')
})
it('removes explanatory banners without hiding errors or any required column', () => {
const html = renderToStaticMarkup(<QAOperationsView {...props} />)
expect(html).not.toContain('本次读取')
expect(html).not.toContain('固定显示完整字段')
expect(html).not.toContain('DobotAI 2.0 / 钉钉')
})
it('shows all required columns even when empty and keeps false/downvotes visible', () => {
const html = renderToStaticMarkup(<QAOperationsView {...props} />)
expect(html).toContain('原始问题')
+106 -138
View File
@@ -5,9 +5,9 @@ import { fetchQARecord, fetchAllQARecords, fetchQAStatus, qaCellValue, qaColumns
import type { QAQuery, QARecord, QARecordPage, QAStatus } from './qaOps'
import './qaOps.css'
import { QARegions } from './QARegions'
import { QAUsage } from './QAUsage'
import { QAMonthly } from './QAMonthly'
import { QAQualityEditor, QAQualityCounts } from './QAQuality'
import { QADashboard } from './QADashboard'
import { QAWeekly } from './QAWeekly'
import { QAQualityEditor } from './QAQuality'
import { qualityLabels } from './qaQuality'
import { usageLabels } from './qaUsage'
import { QAWeekPicker } from './QAWeekPicker'
@@ -15,6 +15,25 @@ import { QAAnswerMarkdown } from './QAAnswerMarkdown'
import { QAMirrorSync } from './QAMirrorSync'
import { currentQAWeek, qaDateTimeToISO, qaWeekQueryRange } from './qaWeeks'
export type QAOpsView = 'records' | 'dashboard' | 'regions' | 'weekly'
export function QAOperationsTabs({ view, onChange }: { view: QAOpsView; onChange: (view: QAOpsView) => void }) {
return (
<nav className="qa-region-tabs" aria-label="问答运营视图">
{(
[
['records', '问题流水'],
['dashboard', '问题统计看板'],
['regions', '区域配置'],
['weekly', '周报生成'],
] as const
).map(([id, label]) => (
<button key={id} type="button" aria-pressed={view === id} onClick={() => onChange(id)}>
{label}
</button>
))}
</nav>
)
}
interface ViewProps {
onQualitySaved?: (record: QARecord) => void
onReloadDetail?: () => void
@@ -30,7 +49,6 @@ interface ViewProps {
progress?: { loaded: number; total: number }
onRetry: () => void
}
const stateLabels = { disabled: '未配置', unavailable: '连接不可用', blocked: '接入被阻断', connected: '已连接' }
const warningLabels: Record<string, string> = {
database_temp_enabled: '数据库仍允许临时对象:未视为完全只读验收通过',
database_transport_unencrypted: '数据库连接未启用 TLS:上线前须完成传输安全审核',
@@ -59,17 +77,8 @@ export function QAOperationsView(props: ViewProps) {
? `共 ${page.total} 条 · 已展示 ${page.items.length} 条`
: '尚未读取问答'}
</span>
<span className="qa-ops-source">
DobotAI 2.0 / 钉钉 · 本地问答副本{props.status ? ` · ${stateLabels[props.status.state]}` : ''}
</span>
</div>
{page?.organization ? (
<p className="qa-ops-muted qa-ops-organization">
{page.organization.state === 'ready'
? `缺失组织信息按当前通讯录补全(${stamp(page.organization.synced_at!)}),不代表提问时归属。目录:${page.organization.directory_id};区域版本:${page.organization.revision_id || '未保存'}`
: '尚无完整通讯录,仅展示源端已有组织快照,不根据姓名推断。'}
</p>
) : null}
{props.status?.warnings.map((warning) => (
<p className="qa-ops-warning" key={warning}>
{warningLabels[warning] ?? '数据源有待审核的安全告警'}
@@ -138,12 +147,7 @@ export function QAOperationsView(props: ViewProps) {
) : page && !props.loading && !props.error ? (
<p className="qa-ops-empty">没有符合条件的问答,请调整时间范围或关键词。</p>
) : null}
{page ? (
<footer className="qa-ops-page-bar">
<span>本次读取:{stamp(page.as_of)} · 固定显示完整字段,左右滚动查看;— 表示暂无数据</span>
<span>{page.items.length === page.total ? '已全部展示' : '全量读取尚未完成'}</span>
</footer>
) : null}
{showDrawer ? (
<>
<button
@@ -299,8 +303,7 @@ function initialDraft() {
}
export function QAOperations() {
const [view, setView] = useState<'records' | 'regions' | 'usage'>('records')
const [usageMode, setUsageMode] = useState<'regions' | 'monthly'>('regions')
const [view, setView] = useState<QAOpsView>('records')
const auth = useOptionalAuth()
const canRead = auth?.identity?.role === 'admin'
const [draft, setDraft] = useState(initialDraft)
@@ -331,7 +334,7 @@ export function QAOperations() {
useEffect(() => {
if (!query || !canRead) return
if (view !== 'records') {
if (view !== 'records' && view !== 'dashboard') {
setLoading(false)
detailRequest.current?.abort()
setDetail(null)
@@ -414,13 +417,11 @@ export function QAOperations() {
setDetailLoading(false)
returnFocus.current?.focus()
}
const queryView = view === 'records' || view === 'dashboard'
return (
<section className="qa-ops" aria-label="问答运营">
<header className="qa-ops-header">
<h2>
问答运营 <span>/ {view === 'regions' ? '区域归属' : view === 'usage' ? '使用统计' : '问答记录'}</span>
</h2>
<p>本地问答查询;远端只读后台同步,原始记录与人工复核分开保留。</p>
<h2>问答运营</h2>
</header>
{!canRead ? (
<p className="error-banner" role="alert">
@@ -428,78 +429,48 @@ export function QAOperations() {
</p>
) : (
<>
<QAMirrorSync
onChanged={() => {
if (detail || detailLoading) {
setMirrorChanged(true)
return
}
setQuery((q) => (q ? { ...q } : q))
setRevision((v) => v + 1)
setQualityRevision((v) => v + 1)
}}
/>
{mirrorChanged ? (
<p className="qa-ops-warning">本地副本已更新;当前详情和未保存复核不会被覆盖,关闭详情后刷新列表。</p>
) : null}
<nav className="qa-region-tabs" aria-label="问答运营视图">
<button type="button" aria-pressed={view === 'records'} onClick={() => setView('records')}>
问答记录
</button>
<button type="button" aria-pressed={view === 'usage'} onClick={() => setView('usage')}>
使用统计
</button>
<button type="button" aria-pressed={view === 'regions'} onClick={() => setView('regions')}>
区域使用
</button>
</nav>
{view === 'usage' ? (
<nav className="qa-region-tabs" aria-label="使用统计视图">
<button type="button" aria-pressed={usageMode === 'regions'} onClick={() => setUsageMode('regions')}>
区域汇总
</button>
<button type="button" aria-pressed={usageMode === 'monthly'} onClick={() => setUsageMode('monthly')}>
个人月明细
</button>
</nav>
) : null}
{view === 'usage' && usageMode === 'monthly' ? (
<QAMonthly />
) : view === 'regions' ? (
<QARegions />
) : (
<QAOperationsTabs view={view} onChange={setView} />
{queryView ? (
<>
<QAMirrorSync
onChanged={() => {
if (detail || detailLoading) {
setMirrorChanged(true)
return
}
setQuery((q) => (q ? { ...q } : q))
setRevision((v) => v + 1)
setQualityRevision((v) => v + 1)
}}
/>
{mirrorChanged ? <p className="qa-ops-warning">数据已更新,关闭详情后刷新。</p> : null}
<form className="qa-ops-query" onSubmit={submit}>
{view === 'records' ? (
<QAWeekPicker
year={draft.year}
week={draft.week}
onCurrentWeek={() => {
const current = initialDraft()
setDraft({ ...current, keyword: draft.keyword })
setQuery({
start: qaDateTimeToISO(current.start),
end: qaDateTimeToISO(current.end),
keyword: draft.keyword,
cursor: '',
})
}}
onChange={(year, week) => {
setDraft((old) => {
if (week === null) return { ...old, year, week }
const { start, end } = qaWeekQueryRange(year, week)
return { ...old, year, week, start, end }
})
}}
/>
) : null}
<QAWeekPicker
year={draft.year}
week={draft.week}
onCurrentWeek={() => {
const current = initialDraft()
setDraft({ ...current, keyword: draft.keyword })
setQuery({
start: qaDateTimeToISO(current.start),
end: qaDateTimeToISO(current.end),
keyword: draft.keyword,
cursor: '',
})
}}
onChange={(year, week) =>
setDraft((old) =>
week === null ? { ...old, year, week } : { ...old, ...qaWeekQueryRange(year, week) }
)
}
/>
<label>
开始时间(北京时间)
<input
type="datetime-local"
required
value={draft.start}
onChange={(event) => setDraft({ ...draft, start: event.target.value, week: null })}
onChange={(e) => setDraft({ ...draft, start: e.target.value, week: null })}
/>
</label>
<label>
@@ -508,7 +479,7 @@ export function QAOperations() {
type="datetime-local"
required
value={draft.end}
onChange={(event) => setDraft({ ...draft, end: event.target.value, week: null })}
onChange={(e) => setDraft({ ...draft, end: e.target.value, week: null })}
/>
</label>
<label className="qa-ops-keyword">
@@ -518,59 +489,56 @@ export function QAOperations() {
maxLength={200}
placeholder="检索原始问题"
value={draft.keyword}
onChange={(event) => setDraft({ ...draft, keyword: event.target.value })}
onChange={(e) => setDraft({ ...draft, keyword: e.target.value })}
/>
</label>
<button type="submit" disabled={loading}>
查询
</button>
</form>
<p className="qa-ops-slice-note">
部门/区域保留源快照,缺失时按当前通讯录补全;使用统计不是绩效结论。外语翻译与AI评估仍暂缓,空值不默认填“否”。
</p>
{view === 'records' ? <QAQualityCounts query={query} revision={qualityRevision} /> : null}
{view === 'usage' ? (
<QAUsage query={query} />
) : (
<QAOperationsView
page={page}
status={status}
error={error}
loading={loading}
detail={detail}
detailLoading={detailLoading}
detailError={detailError}
onReloadDetail={() => {
if (detail) void select(detail.id)
}}
onQualitySaved={(fresh) => {
if (fresh.id !== detail?.id) return
setDetail(fresh)
setPage((old) => {
if (!old) return old
const all = new Set(old.columns)
const f = fresh.quality?.effective
if (f) {
if (f.coverage) all.add('coverage')
if (f.correctness) all.add('is_correct')
for (const key of ['product_category', 'problem_type', 'root_cause'] as const)
if (f[key]) all.add(key)
}
return {
...old,
items: old.items.map((item) => (item.id === fresh.id ? fresh : item)),
columns: qaColumns.filter((c) => all.has(c.key)).map((c) => c.key),
}
})
setQualityRevision((v) => v + 1)
}}
onSelect={(id) => void select(id)}
onCloseDetail={close}
progress={progress}
onRetry={() => setRevision((value) => value + 1)}
/>
)}
</>
) : null}
{view === 'regions' ? (
<QARegions />
) : view === 'weekly' ? (
<QAWeekly query={query} />
) : view === 'dashboard' ? (
<QADashboard
page={page}
query={query}
loading={loading}
error={error}
revision={qualityRevision}
onRetry={() => {
setRevision((v) => v + 1)
setQualityRevision((v) => v + 1)
}}
/>
) : (
<QAOperationsView
page={page}
status={status}
error={error}
loading={loading}
detail={detail}
detailLoading={detailLoading}
detailError={detailError}
onReloadDetail={() => {
if (detail) void select(detail.id)
}}
onQualitySaved={(fresh) => {
if (fresh.id !== detail?.id) return
setDetail(fresh)
setPage((old) =>
old ? { ...old, items: old.items.map((item) => (item.id === fresh.id ? fresh : item)) } : old
)
setQualityRevision((v) => v + 1)
}}
onSelect={(id) => void select(id)}
onCloseDetail={close}
progress={progress}
onRetry={() => setRevision((v) => v + 1)}
/>
)}
</>
)}
+1 -1
View File
@@ -87,7 +87,7 @@ describe('region mapping workbench', () => {
const html = renderToStaticMarkup(<RegionMappingView {...props} />)
expect(html).toContain('历史快照')
expect(html).toContain('跨区域待核对:1')
expect(html).toContain('配置区域归属不等于纳入绩效考核')
expect(html).not.toContain('配置区域归属不等于纳入绩效考核')
expect(html).not.toContain('<script>test</script>')
expect(html).not.toContain('达标率')
expect(html).toMatch(/disabled=""[^>]*>保存归属/)
+2 -7
View File
@@ -85,9 +85,7 @@ export function RegionMappingView(p: Props) {
{p.state.revision_id || '尚未保存'}
</p>
) : null}
<p className="qa-ops-muted">
父部门包含子部门,子部门单独配置优先。配置区域归属不等于纳入绩效考核;跨区域多部门人员先待核对。
</p>
{p.error ? (
<p role="alert" className="error-banner">
{p.error}
@@ -97,7 +95,7 @@ export function RegionMappingView(p: Props) {
{!p.state ? (
<p role="status">{p.busy ? '正在读取通讯录…' : '尚未读取通讯录'}</p>
) : !available ? (
<p className="qa-ops-empty">尚无完整通讯录快照。先接入已验证的全量同步结果,不能使用按需人员缓存或编造部门。</p>
<p className="qa-ops-empty">暂无通讯录,请先同步。</p>
) : (
<>
<div className="qa-region-filters">
@@ -185,9 +183,6 @@ export function RegionMappingView(p: Props) {
</table>
{!departments.length ? <p>没有匹配的部门路径</p> : null}
</div>
<p className="qa-ops-muted">
此处仅预览通讯录归属人数;2.0 使用次数、考核名单与绩效统计尚未接入。不会将未知在职状态当作已确认在职人数。
</p>
</>
)}
</section>
+1 -2
View File
@@ -15,8 +15,7 @@ describe('QA week picker', () => {
expect(html).toContain('value="40" selected=""')
expect(html).toContain('第40周(09-28 到 10-04)')
expect(html).toContain('第53周(2026-12-28 到 2027-01-03)')
expect(html).toContain('北京时间')
expect(html).toContain('周一至周日')
expect(html).not.toContain('北京时间 · 周一至周日 · 本周截至当前')
})
it('preserves custom range mode and does not offer invalid week 53', () => {
const html = renderToStaticMarkup(<QAWeekPicker year={2027} week={null} onChange={vi.fn()} />)
-1
View File
@@ -50,7 +50,6 @@ export function QAWeekPicker({ year, week, onChange, onCurrentWeek }: Props) {
<button className="qa-week-current" type="button" onClick={onCurrentWeek}>
本周
</button>
<span className="qa-ops-muted">北京时间 · 周一至周日 · 本周截至当前</span>
</div>
)
}
+97
View File
@@ -0,0 +1,97 @@
import { useEffect, useRef, useState } from 'react'
import type { QAQuery } from './qaOps'
import { fetchAllQARecords } from './qaOps'
import { fetchQADashboardQuality } from './qaDashboard'
import { fetchQAMirrorStatus } from './qaMirror'
import { buildQAWeeklyDraft, downloadQAWeekly } from './qaWeekly'
import type { QAWeeklyDraft } from './qaWeekly'
import { QAAnswerMarkdown } from './QAAnswerMarkdown'
export function QAWeekly({ query }: { query: QAQuery | null }) {
const [draft, setDraft] = useState<QAWeeklyDraft | null>(null),
[loading, setLoading] = useState(false),
[error, setError] = useState('')
const request = useRef<AbortController | null>(null)
useEffect(() => {
request.current?.abort()
setDraft(null)
setError('')
setLoading(false)
return () => request.current?.abort()
}, [query])
const generate = async () => {
if (!query || loading) return
request.current?.abort()
const controller = new AbortController()
request.current = controller
setLoading(true)
setDraft(null)
setError('')
try {
const before = await fetchQAMirrorStatus(controller.signal)
if (!before.ready || before.blocked) throw Error('本地同步未就绪,暂不能生成周报')
const [page, quality] = await Promise.all([
fetchAllQARecords(query, controller.signal),
fetchQADashboardQuality(query, controller.signal),
])
const after = await fetchQAMirrorStatus(controller.signal)
if (!after.ready || after.blocked || before.revision !== after.revision || page.local_revision !== after.revision)
throw Error('本地副本在生成期间已更新,请重新生成')
const result = buildQAWeeklyDraft(page, query, quality, new Date().toISOString())
if (!controller.signal.aborted) setDraft(result)
} catch (e) {
if (!controller.signal.aborted) setError(e instanceof Error ? e.message : '周报生成失败')
} finally {
if (!controller.signal.aborted) setLoading(false)
}
}
const suffix = query ? new Date(Date.parse(query.start) + 8 * 60 * 60 * 1000).toISOString().slice(0, 10) : 'draft'
return (
<section className="qa-weekly" aria-label="周报生成">
<header className="qa-weekly-toolbar">
<div>
<h3>周报生成</h3>
{query ? (
<span>
{new Date(query.start).toLocaleDateString('zh-CN', { timeZone: 'Asia/Shanghai' })} 至{' '}
{new Date(Date.parse(query.end) - 1).toLocaleDateString('zh-CN', { timeZone: 'Asia/Shanghai' })}
</span>
) : null}
</div>
<button type="button" onClick={() => void generate()} disabled={loading || !query}>
{loading ? '正在生成…' : '生成周报草稿'}
</button>
{draft ? (
<>
<span className="qa-weekly-badge">草稿 · {draft.questions} 条</span>
<button
type="button"
onClick={() =>
downloadQAWeekly(draft.markdown, `DobotAI-问答周报-${suffix}.md`, 'text/markdown;charset=utf-8')
}
>
下载 MD
</button>
<button
type="button"
onClick={() => downloadQAWeekly(draft.csv, `DobotAI-问题明细-${suffix}.csv`, 'text/csv;charset=utf-8')}
>
下载明细 CSV
</button>
</>
) : null}
</header>
{error ? (
<p role="alert" className="error-banner">
{error}
</p>
) : null}
{draft ? (
<article className="qa-weekly-preview">
<QAAnswerMarkdown answer={draft.markdown} />
</article>
) : (
<div className="qa-weekly-empty">{loading ? '正在汇总本地问答…' : '尚未生成周报。'}</div>
)}
</section>
)
}
+244
View File
@@ -0,0 +1,244 @@
.qa-dashboard-scroll {
min-height: 0;
overflow: auto;
flex: 1;
overscroll-behavior: contain;
}
.qa-dashboard {
min-width: 0;
display: flex;
flex-direction: column;
gap: 16px;
}
.qa-dashboard-metrics {
display: grid;
grid-template-columns: repeat(4, minmax(0, 1fr));
border: 1px solid var(--border-base);
background: var(--bg-panel);
}
.qa-dashboard-metrics > div {
padding: 18px 22px;
display: flex;
flex-direction: column;
gap: 8px;
border-right: 1px solid var(--border-base);
}
.qa-dashboard-metrics > div:last-child {
border-right: 0;
}
.qa-dashboard-metrics span {
color: var(--ink-mute);
font-size: 12px;
}
.qa-dashboard-metrics strong {
color: var(--ink-strong);
font-size: 30px;
font-weight: 650;
font-variant-numeric: tabular-nums;
letter-spacing: -0.04em;
}
.qa-dashboard-metrics small {
font-size: 11px;
color: var(--ink-mute);
}
.qa-dashboard-grid {
display: grid;
grid-template-columns: minmax(0, 1.6fr) minmax(260px, 1fr);
gap: 14px;
}
.qa-chart {
min-width: 0;
padding: 18px 20px;
background: var(--bg-panel);
border: 1px solid var(--border-base);
}
.qa-chart-full {
grid-column: 1/-1;
}
.qa-chart h3 {
font-size: 14px;
font-weight: 600;
margin: 0 0 20px;
color: var(--ink-strong);
}
.qa-chart-bars {
display: grid;
gap: 13px;
}
.qa-chart-bar {
display: grid;
grid-template-columns: minmax(70px, 120px) minmax(0, 1fr) 40px;
gap: 12px;
align-items: center;
font-size: 12px;
}
.qa-chart-bar > span {
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.qa-chart-bar b {
text-align: right;
font-weight: 500;
font-variant-numeric: tabular-nums;
}
.qa-chart-track {
height: 7px;
background: var(--bg-canvas, #f1f5f9);
overflow: hidden;
border-radius: 2px;
}
.qa-chart-track i {
display: block;
height: 100%;
background: #377bc9;
border-radius: 2px;
}
.qa-chart-empty {
padding: 28px 0;
text-align: center;
color: var(--ink-mute);
font-size: 12px;
}
.qa-daily-chart {
display: flex;
gap: clamp(6px, 1.5vw, 22px);
height: 180px;
align-items: stretch;
overflow-x: auto;
}
.qa-daily-chart > div {
flex: 1;
min-width: 24px;
display: flex;
flex-direction: column;
align-items: center;
gap: 7px;
font-size: 11px;
color: var(--ink-mute);
}
.qa-daily-chart > div > div {
height: 125px;
width: 100%;
display: flex;
align-items: flex-end;
border-bottom: 1px solid var(--border-base);
}
.qa-daily-chart i {
display: block;
width: 100%;
background: #377bc9;
border-radius: 2px 2px 0 0;
min-height: 0;
}
.qa-daily-chart b {
font-size: 11px;
color: var(--ink-strong);
font-variant-numeric: tabular-nums;
font-weight: 500;
}
.qa-dashboard-region-table {
margin-top: 18px;
overflow-x: auto;
}
.qa-dashboard-region-table table {
width: 100%;
font-size: 12px;
}
.qa-dashboard-region-table th,
.qa-dashboard-region-table td {
padding: 8px 10px;
text-align: left;
white-space: normal;
}
.qa-monthly-disclosure {
margin-top: 14px;
border-top: 1px solid var(--border-base);
padding: 14px 0;
}
.qa-monthly-disclosure > summary {
font-size: 13px;
cursor: pointer;
}
.qa-monthly-disclosure .qa-monthly {
min-height: 400px;
max-height: 650px;
margin-top: 12px;
overflow: auto;
}
@media (max-width: 900px) {
.qa-dashboard-grid {
grid-template-columns: minmax(0, 1fr);
}
.qa-chart-full {
grid-column: auto;
}
.qa-dashboard-metrics > div {
padding: 14px;
}
.qa-dashboard-metrics strong {
font-size: 25px;
}
}
@media (max-width: 560px) {
.qa-dashboard-metrics {
grid-template-columns: repeat(2, minmax(0, 1fr));
}
.qa-dashboard-metrics > div:nth-child(2) {
border-right: 0;
}
.qa-dashboard-metrics > div:nth-child(-n + 2) {
border-bottom: 1px solid var(--border-base);
}
.qa-chart {
padding: 16px 12px;
}
.qa-chart-bar {
grid-template-columns: minmax(65px, 100px) minmax(0, 1fr) 30px;
}
}
.qa-weekly {
display: flex;
flex-direction: column;
gap: 14px;
min-height: 0;
flex: 1;
overflow: auto;
}
.qa-weekly-toolbar {
display: flex;
align-items: center;
gap: 10px;
flex-wrap: wrap;
padding: 16px;
background: var(--bg-panel);
border: 1px solid var(--border-base);
}
.qa-weekly-toolbar > div {
margin-right: auto;
}
.qa-weekly-toolbar h3 {
font-size: 15px;
margin: 0 0 6px;
}
.qa-weekly-toolbar span {
font-size: 12px;
color: var(--ink-mute);
}
.qa-weekly-badge {
padding: 4px 7px;
border: 1px solid var(--border-base);
}
.qa-weekly-preview {
padding: 20px;
background: var(--bg-panel);
border: 1px solid var(--border-base);
min-width: 0;
}
.qa-weekly-empty {
padding: 50px 20px;
text-align: center;
font-size: 13px;
color: var(--ink-mute);
}
+50
View File
@@ -0,0 +1,50 @@
import type { QARecord, QAQuery } from './qaOps'
import { getPayload } from './qaOps'
import { parseQualitySummary } from './qaQuality'
export type QACountPoint = { label: string; count: number }
const day = 24 * 60 * 60 * 1000,
offset = 8 * 60 * 60 * 1000
export function qaDailySeries(items: QARecord[], query: QAQuery): QACountPoint[] {
const start = Date.parse(query.start),
end = Date.parse(query.end)
if (!Number.isFinite(start) || !Number.isFinite(end) || start >= end || end - start > 90 * day)
throw Error('统计时间范围无效')
const counts = new Map<string, number>()
for (let t = Math.floor((start + offset) / day) * day; t <= Math.floor((end - 1 + offset) / day) * day; t += day)
counts.set(new Date(t).toISOString().slice(0, 10), 0)
for (const item of items) {
const stamp = Date.parse(item.asked_at)
if (stamp >= start && stamp < end) {
const key = new Date(stamp + offset).toISOString().slice(0, 10)
counts.set(key, (counts.get(key) || 0) + 1)
}
}
return [...counts].map(([label, count]) => ({ label, count }))
}
export function qaCategorySeries(items: QARecord[], key: 'product_category' | 'problem_type'): QACountPoint[] {
const counts = new Map<string, number>()
for (const item of items) {
const label =
(item.quality?.state === 'stale' ? '' : item.quality?.effective[key] || item[key] || '').trim() || '未分类'
counts.set(label, (counts.get(label) || 0) + 1)
}
return [...counts]
.map(([label, count]) => ({ label, count }))
.sort((a, b) => b.count - a.count || a.label.localeCompare(b.label, 'zh-CN'))
}
export async function fetchQADashboardQuality(query: QAQuery, signal?: AbortSignal) {
const value = parseQualitySummary(
await getPayload('/api/v1/qa-ops/quality/query', signal, {
method: 'POST',
headers: { 'Content-Type': 'application/json', 'X-Governance-Action': 'qa-quality' },
body: JSON.stringify({ start: query.start, end: query.end, keyword: query.keyword }),
})
)
if (
Date.parse(value.start) !== Date.parse(query.start) ||
Date.parse(value.end) !== Date.parse(query.end) ||
value.keyword !== query.keyword
)
throw Error('质量统计与当前查询范围不一致')
return value
}
+107
View File
@@ -0,0 +1,107 @@
import { describe, it, expect } from 'vitest'
import { renderToStaticMarkup } from 'react-dom/server'
import { createElement } from 'react'
import { QAAnswerMarkdown } from './QAAnswerMarkdown'
import { buildQAWeeklyDraft } from './qaWeekly'
import type { QARecordPage, QAQuery } from './qaOps'
import type { QualitySummary } from './qaQuality'
const query: QAQuery = { start: '2026-10-11T16:00:00Z', end: '2026-10-18T10:00:00Z', keyword: '', cursor: '' }
const page = {
items: [
{
id: 'fixture',
status: 'succeeded',
time_source: 'request_message.created_at',
asker: 'fixture person',
trigger_person: '',
department: '',
region: '',
references: [],
media: [],
source_coverage: { verdict: '', reason_code: '', evaluator_version: '' },
question: '=HYPERLINK("https://example.invalid")',
answer: '暂无已发布',
asked_at: '2026-10-14T00:00:00Z',
coverage: {
verdict: 'uncovered',
state: 'checked',
rule_version: 'governance-answer-substring-v1',
matched_text: '暂无已发布',
},
feedback: { asker_value: '', up: 0, down: 0 },
},
],
columns: [],
total: 1,
has_more: false,
next_cursor: '',
as_of: query.end,
local_revision: 1,
} as QARecordPage
const quality = {
start: query.start,
end: query.end,
keyword: '',
as_of: query.end,
scope: 'whole_filter',
ai_state: 'not_configured',
summary: {
total: 1,
reviewed: 0,
unreviewed: 1,
stale: 0,
pending_confirmation: 0,
rule_uncovered: 1,
rates: {
policy_version: 'quality-rates-human-first-v1',
coverage: { numerator: 0, denominator: 1, percent: 0 },
correctness: { numerator: 0, denominator: 0, percent: null },
breakdown: {
covered: 0,
uncovered: 1,
partial: 0,
pending: 0,
unassessed: 0,
excluded: 0,
stale: 0,
covered_correct: 0,
covered_incorrect: 0,
covered_pending: 0,
covered_unassessed: 0,
},
},
},
} as QualitySummary
describe('weekly draft export', () => {
it('builds preview and downloadable evidence from the same complete query without invented correctness', () => {
const d = buildQAWeeklyDraft(page, query, quality, '2026-10-18T10:00:00Z')
expect(d.questions).toBe(1)
expect(d.revision).toBe(1)
expect(d.markdown).toContain('周报(草稿)')
expect(d.markdown).toContain('正确率:—')
expect(renderToStaticMarkup(createElement(QAAnswerMarkdown, { answer: d.markdown }))).toContain('<table')
expect(d.csv.charCodeAt(0)).toBe(0xfeff)
expect(d.markdown.split(String.fromCharCode(10)).length).toBeGreaterThan(10)
expect(d.csv.split(String.fromCharCode(13, 10)).length).toBe(2)
expect(d.csv).toContain('原始问题')
expect(d.csv).toContain("'=HYPERLINK")
})
it('escapes source question Markdown and line breaks rather than injecting a report link or row', () => {
const input = {
...page,
items: page.items.map((r) => ({
...r,
question: '中文 [链接](https://example.invalid) **危险**' + String.fromCharCode(10) + '第二行',
})),
}
const d = buildQAWeeklyDraft(input, query, quality, query.end)
const html = renderToStaticMarkup(createElement(QAAnswerMarkdown, { answer: d.markdown }))
expect(html).not.toContain('>链接</a>')
expect(html).not.toContain('<strong>危险</strong>')
expect(d.markdown).not.toContain(String.fromCharCode(10) + '第二行')
})
it('refuses incomplete ranges or statistics from another scope', () => {
expect(() => buildQAWeeklyDraft({ ...page, has_more: true }, query, quality, query.end)).toThrow()
expect(() => buildQAWeeklyDraft(page, query, { ...quality, keyword: 'other' }, query.end)).toThrow()
})
})
+132
View File
@@ -0,0 +1,132 @@
import type { QARecordPage, QAQuery } from './qaOps'
import { qaCellValue, qaColumns } from './qaOps'
import type { QualitySummary, QualityRate } from './qaQuality'
import { qaDailySeries, qaCategorySeries } from './qaDashboard'
export interface QAWeeklyDraft {
markdown: string
csv: string
questions: number
revision: number
generatedAt: string
}
const stamp = (v: string) => new Date(v).toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai', hour12: false })
const rate = (v: QualityRate) =>
v.percent === null ? '—' : `${v.percent.toFixed(1)}%(${v.numerator} / ${v.denominator})`
const cell = (v: unknown) =>
String(v ?? '')
.replace(/&/g, '&amp;')
.replace(/</g, '&lt;')
.replace(/>/g, '&gt;')
.replace(/[\`*_[\]|]/g, '\\$&')
.replace(/[\r\n]+/g, ' ')
function csvCell(value: unknown) {
const v = String(value ?? '')
const safe = /^[\t\r\n]|^\s*[=+\-@]/.test(v) ? "'" + v : v
return '"' + safe.replace(/"/g, '""') + '"'
}
export function buildQAWeeklyDraft(
page: QARecordPage,
query: QAQuery,
quality: QualitySummary,
generatedAt: string
): QAWeeklyDraft {
if (
page.has_more ||
page.items.length !== page.total ||
new Set(page.items.map((i) => i.id)).size !== page.total ||
quality.summary.total !== page.total ||
Date.parse(quality.start) !== Date.parse(query.start) ||
Date.parse(quality.end) !== Date.parse(query.end) ||
quality.keyword !== query.keyword ||
!Number.isFinite(Date.parse(generatedAt))
)
throw Error('周报范围或完整性不一致,请重新生成')
const groups: Record<string, number> = {
covered: 0,
uncovered: 0,
partial: 0,
pending: 0,
unassessed: 0,
excluded: 0,
stale: 0,
}
for (const r of page.items) {
const state =
r.quality?.state === 'stale' ? 'stale' : r.quality?.effective.coverage || r.coverage?.verdict || 'unassessed'
const key = state === 'unknown' ? 'unassessed' : state
if (!(key in groups)) throw Error('周报存在未知覆盖状态')
groups[key]++
}
for (const [key, count] of Object.entries(groups))
if (quality.summary.rates.breakdown[key as keyof typeof quality.summary.rates.breakdown] !== count)
throw Error('复核结果在生成期间发生变化,请重新生成')
const s = quality.summary
const daily = qaDailySeries(page.items, query)
.map((p) => `| ${p.label} | ${p.count} |`)
.join('\n')
const products = qaCategorySeries(page.items, 'product_category')
.map((p) => `| ${cell(p.label)} | ${p.count} |`)
.join('\n')
const gaps = page.items.filter(
(r) => (r.quality?.effective.coverage || r.coverage?.verdict) === 'uncovered' && r.quality?.state !== 'stale'
)
const md =
[
'# DobotAI 问答运营周报(草稿)',
`统计范围:${stamp(query.start)} 至 ${stamp(query.end)}(结束不含)`,
query.keyword ? `关键词:${cell(query.keyword)}` : '',
`生成:${stamp(generatedAt)}`,
`本地数据版本:${page.local_revision ?? '—'}`,
'## 问答概览',
`- 问题总量:${page.total}`,
`- 知识覆盖率:${rate(s.rates.coverage)}`,
`- 回答正确率:${rate(s.rates.correctness)}`,
`- 已人工复核:${s.reviewed}`,
`- 待重新核对:${s.stale}`,
`- 人工待确认:${s.pending_confirmation}`,
'## 质量分布',
'| 已覆盖 | 未覆盖 | 部分覆盖 | 待确认 | 未评估 | 不计入 | 待重新核对 |',
'| --- | --- | --- | --- | --- | --- | --- |',
`| ${groups.covered} | ${groups.uncovered} | ${groups.partial} | ${groups.pending} | ${groups.unassessed} | ${groups.excluded} | ${groups.stale} |`,
'## 每日提问',
'| 日期 | 问题量 |',
'| --- | ---: |',
daily,
'## 产品分类',
'| 分类 | 问题量 |',
'| --- | ---: |',
products,
'## 未覆盖问题',
gaps.length ? '| 提问时间 | 问题 | 产品分类 |' : '当前无有效未覆盖记录',
gaps.length ? '| --- | --- | --- |' : '',
...gaps.map(
(r) =>
`| ${stamp(r.asked_at)} | ${cell(qaCellValue(r, 'question_chinese') || r.question)} | ${cell(r.quality?.effective.product_category || r.product_category || '—')} |`
),
]
.filter(Boolean)
.join('\n\n') + '\n'
const csv =
'\ufeff' +
[
qaColumns.map((c) => csvCell(c.label)).join(','),
...page.items.map((row) => qaColumns.map((c) => csvCell(qaCellValue(row, c.key))).join(',')),
].join('\r\n')
return {
markdown: md.replace(/\|\n\n\|/g, '|\n|'),
csv,
questions: page.total,
revision: page.local_revision ?? 0,
generatedAt,
}
}
export function downloadQAWeekly(content: string, filename: string, type: string) {
const url = URL.createObjectURL(new Blob([content], { type }))
const a = document.createElement('a')
a.href = url
a.download = filename
document.body.append(a)
a.click()
a.remove()
setTimeout(() => URL.revokeObjectURL(url), 1000)
}