本地 7011 CLI 表元数据验证

运行时间：2026-07-01T23:25:11

MaybeSheet URL：http://localhost:3003/docs/spreadsheets/d/6a4530c6eddfd7cff0d6cde5?gid=0

API base：http://localhost:7011；上游：localhost:8080 与 localhost:18080。

流程

flowchart LR CLI[CLI 本地命令] --> BE[play-be localhost:7011] BE --> Excelize[excelize-mcp localhost:8080] BE --> Meta[/api/v1/excel/table/metadata] Meta --> Filter[过滤空 range / 0 行 / 0 列] Filter --> Green[A1:N18 content-backed table] BE -. PG 路由可用 .-> SheetTable[SheetTable localhost:18080] classDef local fill:#dbeafe,stroke:#2563eb,color:#111827; classDef pass fill:#dcfce7,stroke:#16a34a,color:#111827; classDef fallback fill:#fef3c7,stroke:#d97706,color:#111827; class CLI,BE,Excelize,SheetTable local; class Meta,Filter,Green pass; 
flowchart LR
  CLI[CLI 本地命令] --> BE[play-be localhost:7011]
  BE --> Excelize[excelize-mcp localhost:8080]
  BE --> Meta[/api/v1/excel/table/metadata]
  Meta --> Filter[过滤空 range / 0 行 / 0 列]
  Filter --> Green[A1:N18 content-backed table]
  BE -. PG 路由可用 .-> SheetTable[SheetTable localhost:18080]
  classDef local fill:#dbeafe,stroke:#2563eb,color:#111827;
  classDef pass fill:#dcfce7,stroke:#16a34a,color:#111827;
  classDef fallback fill:#fef3c7,stroke:#d97706,color:#111827;
  class CLI,BE,Excelize,SheetTable local;
  class Meta,Filter,Green pass;

对比结果

类别用例实际路径结果备注
本地端口play-be / excelize-mcp / SheetTablelocalhost:7011 / localhost:8080 / localhost:18080PASS使用 debugging-runtime.md 标准端口；未使用 7012/18082。
上传workbook import/api/v1/excel/uploadPASS返回文档 6a4530c6eddfd7cff0d6cde5。
原生表元数据excel-table metadata/api/v1/excel/table/metadataPASS表范围 A1:N18，行 17，列 14。
后端直连/api/v1/excel/table/metadatacurl local 7011PASS返回 1 个 content-backed table。
list-tableexcel-worksheet list-table/api/v1/excel/table/metadataPASSnative table metadata response 已过滤空表候选。
样例读取excel-table sample --limit 3/api/v1/excel/read_sheetPASS通过解析到的 A1:N18 范围读取前 3 行。

返回的 content-backed tables

table_idworksheet_namerange_addressrow_countcolumn_countengine
1LayoutA1:N181714excelize

样例读取

_AUTO_COL_1_AUTO_COL_2_AUTO_COL_3_AUTO_COL_4_AUTO_COL_5_AUTO_COL_6_AUTO_COL_7_AUTO_COL_8_AUTO_COL_9_AUTO_COL_10_AUTO_COL_11_AUTO_COL_12_AUTO_COL_13_AUTO_COL_14
order_idregionamountstatusreturn_idskuqtyreasonapproved
N-001north120openR-001SKU-71damagedtrue
N-002north95closedR-002SKU-22wrong itemfalse

覆盖率

区域已覆盖总数百分比未覆盖
本地标准端口33100%none
CLI 路由44100%none
空范围过滤11100%视觉框选仍需人工确认

需要人工核验

请在 Chrome 打开上面的 MaybeSheet URL，确认 UI 中显示的是绿色内容区域对应的数据；自动化已验证后端和 CLI 只返回 A1:N18 这个 content-backed range。