CLI 本地端点验证报告

摘要

运行时间：20260701-230803

API base：http://127.0.0.1:63197

验证完成：PASS=3，FAIL=0，WARN=0

目标：验证 CLI 对本地 /api/v1/excel/* 端点的调用会忽略空范围，只使用内容表。

流程

sequenceDiagram
  participant CLI as mbs CLI
  participant Local as 本地兼容端点
  participant Resolver as table_resolver
  CLI->>Local: POST /api/v1/excel/list_worksheets
  Local-->>CLI: 返回空范围和内容表
  CLI->>Resolver: 过滤 row_count/column_count/range
  Resolver-->>CLI: 仅保留 B2:E8
  CLI->>Local: POST /api/v1/excel/read_sheet range=B2:E8
  Local-->>CLI: 返回样例数据

对比结果

用例结果备注
excel-worksheet list-table 过滤空范围PASS仅保留 Data!B2:E8 的内容表，empty-left/empty-right/empty-only 已过滤。
excel-table metadata 默认选择内容表PASS默认解析到第一个内容表 orders，范围 B2:E8。
excel-table sample 使用内容表范围PASSread_sheet 请求使用 B2:E8，样例按 --limit=2 截断。

本地端点收到的请求

路径请求体
/api/v1/excel/list_worksheets
{
  "uri": "https://www.maybe.ai/docs/spreadsheets/d/doc-local-e2e"
}
/api/v1/excel/workbook_profile
{
  "document_id": "doc-local-e2e",
  "uri": "https://www.maybe.ai/docs/spreadsheets/d/doc-local-e2e",
  "worksheet_name": "Data"
}
/api/v1/excel/workbook_profile
{
  "document_id": "doc-local-e2e",
  "uri": "https://www.maybe.ai/docs/spreadsheets/d/doc-local-e2e",
  "worksheet_name": "Data"
}
/api/v1/excel/read_sheet
{
  "uri": "https://www.maybe.ai/docs/spreadsheets/d/doc-local-e2e",
  "worksheet_name": "Data",
  "range_address": "B2:E8"
}

需要人工核验

无必须项。若要核验真实上传内容，需要把同一 CLI 命令指向本地 play-be + excelize-mcp + SheetTable 联调环境。