feat(catalog): 首次扫描中的来源也出现在「来源与目录」,并显示实时进度

用户反馈:加了钉盘来源后「来源与目录」里看不到。根因不是丢数据,而是列表只列"已经有快照"
的来源 —— 首次扫描要几分钟到几十分钟(钉盘空间 2900+ 个文件夹),这段时间页面上什么都没有。

- 新 Store 方法 ListCatalogScanProgress:已启用 + 还没有 catalog head + 有在跑/排队的
  source.catalog.refresh(三条件同时成立)。进度直接取 worker 写在任务载荷里的同一份计数
  (progress/message/scanned_directories/discovered_directories/scanned_files),不另立口径。
- /api/v1/source-catalog/sources 在既有列表后追加这些行(snapshot_status="scanning" +
  scan_progress/scan_message)。走窄接口按需接线:未接线时安静跳过,不会把旧列表弄坏。
- 前端:左列显示「首次扫描中 44%」,选中后是进度面板(百分比 + 进度条 + 当前文案 +
  已发现文件数),并说明"扫完自动出现目录";有来源在扫描时每 3 秒自动刷新列表,
  扫完那一行自动变成「本地只读快照」。扫描中不拉目录节点、也不显示标注/格式入口。
- 解析器保持严格:snapshot_status 只接受 ready/scanning,scanning 必须带 scan_progress,
  否则整包拒绝 —— 不给"假装 0%"的机会。

测试:postgres 集成测试(真库)覆盖四种不该出现的来源(停用、已有快照、任务类型不符、
历史上已完成的那次任务);前端 parser + 渲染各一条;Go 全绿、前端 192 条 + tsc 干净。

面板实测:左列「公司级营销资料管理 · 首次扫描中 44%」,主区「首次扫描中 · 44% /
正在扫描目录:已完成 1540 个文件夹 / 已发现约 4934 份文件」。
This commit is contained in:
姚章浩
2026-10-10 17:04:59 +08:00
parent ed60b20790
commit 1283f65a95
9 changed files with 248 additions and 6 deletions
+10
View File
@@ -29,3 +29,13 @@
.pill-dot.retry{background:var(--c-warn)}
.catalog-refresh-hide{margin-left:auto;border:0;background:transparent;color:#4c7d9e;font:inherit;font-size:11px;text-decoration:underline;padding:0 2px}
.catalog-refresh-failed-note{margin:6px 0 0;color:var(--c-fail);font-size:11px}
/* 首次扫描中的来源:还没快照,但立刻出现在列表里并显示进度。 */
.catalog-source.scanning strong { color: #b45309; }
.catalog-scanning-state { display: flex; flex-direction: column; gap: 10px; padding: 18px; border: 1px solid var(--border, #e3e8ec); border-radius: 10px; background: var(--card, #fff); }
.catalog-scanning-state > div { display: flex; align-items: baseline; gap: 10px; }
.catalog-scanning-state strong { font-size: 15px; }
.catalog-scanning-state span { color: var(--muted-foreground, #5b6773); font-size: 13px; }
.catalog-scanning-state progress { width: 100%; height: 10px; }
.catalog-scanning-state p { margin: 0; font-size: 13px; }
.catalog-scanning-state small { color: var(--muted-foreground, #5b6773); font-size: 12px; }