本地导入引擎验证报告

运行时间:2026-07-02T15:20:29

API base:http://localhost:7011

提交版本:maybeai-sheet-cli a988277,play-be 76ec7f4,SheetTable 2cafe2c

结果汇总:PASS=2,FAIL=0,WARN=1,SKIP=0

MaybeSheet URL

流程

flowchart LR CLI[mbs CLI] --> Play[play-be /api/v1/excel/import] Play --> Auto{engine=auto} Auto -->|layout/report| Excelize[excelize-mcp] Auto -->|forced pg worksheets| SheetTable[SheetTable] SheetTable --> PG[(PostgreSQL typed tables)] Play --> Response[JSON response] Response --> Report[本地 HTML 报告] classDef excelize fill:#dbeafe,stroke:#2563eb,color:#111827; classDef pg fill:#dcfce7,stroke:#16a34a,color:#111827; classDef warn fill:#fef3c7,stroke:#d97706,color:#111827; class Excelize excelize; class SheetTable,PG pg; class Auto warn;
flowchart LR
  CLI[mbs CLI] --> Play[play-be /api/v1/excel/import]
  Play --> Auto{engine=auto}
  Auto -->|layout/report| Excelize[excelize-mcp]
  Auto -->|forced pg worksheets| SheetTable[SheetTable]
  SheetTable --> PG[(PostgreSQL typed tables)]
  Play --> Response[JSON response]
  Response --> Report[本地 HTML 报告]
  classDef excelize fill:#dbeafe,stroke:#2563eb,color:#111827;
  classDef pg fill:#dcfce7,stroke:#16a34a,color:#111827;
  classDef warn fill:#fef3c7,stroke:#d97706,color:#111827;
  class Excelize excelize;
  class SheetTable,PG pg;
  class Auto warn;

对比结果

类别用例来源文件document_idMaybeSheet URL期望引擎实际引擎worksheet_enginestop-level selected_enginepreprocesslist 数量read 检查结果备注
auto importyunling auto import~/Downloads/yunling_v4_20sheet.xlsx6a460e52e6feec692aa2b7eehttp://localhost:3003/docs/spreadsheets/d/6a460e52e6feec692aa2b7eeexcelizeexcelizeexcelize:21absent021PASSPASS响应仅保留 top-level engine;每个 worksheet_engines 保留 requested_engine/selected_engine。
auto importllm_cost auto import~/Downloads/llm_cost_stats_2026_05_export.xlsx6a460e59e6feec692aa2b7f2http://localhost:3003/docs/spreadsheets/d/6a460e59e6feec692aa2b7f2excelizeexcelizeexcelize:12absent012PASSPASS响应仅保留 top-level engine;每个 worksheet_engines 保留 requested_engine/selected_engine。
forced mixed importllm_cost forced excelize+postgres list~/Downloads/llm_cost_stats_2026_05_export.xlsxn/an/acompositetimeoutSheetTable 日志显示 PG typed writes 已执行;CLI 600s 内未收到 play-be 响应,随后仍在 post-import sync。unknownobserved in SheetTable typed writesn/aSKIPWARN命令 --engine "excelize,postgres,..." 触发 PG typed materialization,但 600s 内未返回响应;临时服务关闭时 play-be 记录 SheetTable import failed/server disconnected。需要进一步查 mixed response/registry completion 与 post-import sync 耗时。

响应结构检查

覆盖率

区域已覆盖总数百分比未覆盖/备注
auto import22100%layout/report 与 large workbook
list worksheets22100%均通过 CLI routed API
range read22100%均返回样例数据
forced mixed route010%SheetTable 完成 typed writes,但 play-be/CLI 响应超时

需要人工核验

打开上面的 localhost MaybeSheet URL,确认 UI 可以加载对应工作簿。自动化已经验证 import/list/read API;UI 渲染不在本次 CLI 自动检查范围内。

原始证据文件

目录:docs/superpowers/reports/import-engine-local-20260702-150800