@wubaoqi/guancopilot 0.0.0-stage → 0.2.0

package/skills-bundle/guanvis/evals/comparative_mvp_roundtrip/verify_default_roundtrip.sh

@@ -0,0 +1,92 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
+EVAL_DIR="$ROOT_DIR/evals/comparative_mvp_roundtrip"
+OUT_DIR="$EVAL_DIR/.roundtrip"
+
+mkdir -p "$OUT_DIR"
+
+cd "$ROOT_DIR"
+
+go run ./cmd/guanvis preview "$EVAL_DIR" > "$OUT_DIR/preview_payload.json"
+go run ./cmd/guanvis publish "$EVAL_DIR" > "$OUT_DIR/publish.log"
+
+guancli card get p3bc51ab664e095ab2dff402 --profile default --raw > "$OUT_DIR/raw_normal.json"
+guancli card get o360e50afb73bcc998353c13 --profile default --raw > "$OUT_DIR/raw_filter_based.json"
+guancli card preview p3bc51ab664e095ab2dff402 --profile default --limit 50 -f json > "$OUT_DIR/preview_normal.json"
+guancli card preview o360e50afb73bcc998353c13 --profile default --limit 50 -f json > "$OUT_DIR/preview_filter_based.json"
+
+python3 - "$OUT_DIR" <<'PY'
+import json
+import sys
+from pathlib import Path
+
+out = Path(sys.argv[1])
+
+cases = [
+    {
+        "kind": "normal",
+        "raw": out / "raw_normal.json",
+        "preview": out / "preview_normal.json",
+        "expected_aliases": [
+            "月同比对比值",
+            "季同比增长值",
+            "年同比增长率",
+            "上月末增长率",
+            "上季度末增长值",
+            "上年末对比值",
+        ],
+    },
+    {
+        "kind": "filter_based",
+        "raw": out / "raw_filter_based.json",
+        "preview": out / "preview_filter_based.json",
+        "expected_aliases": [
+            "日环比增长值",
+            "周同比增长率",
+            "默认年同比增长率",
+            "年同比按周对比值",
+            "自定义后移增长率",
+        ],
+    },
+]
+
+summary = {"cards": []}
+
+for case in cases:
+    raw_obj = json.loads(case["raw"].read_text())
+    response = raw_obj.get("response") or raw_obj.get("data") or raw_obj
+    zone_data = response["content"]["meta"]["chartMain"]["zoneData"]
+    metrics = zone_data.get("metric", [])
+    by_alias = {m.get("alias"): m for m in metrics if m.get("alias")}
+    rows = json.loads(case["preview"].read_text())
+
+    card_summary = {
+        "kind": case["kind"],
+        "cardId": response.get("cdId") or response.get("id"),
+        "name": response.get("name"),
+        "previewRows": len(rows),
+        "aliases": {},
+    }
+
+    for alias in case["expected_aliases"]:
+        metric = by_alias.get(alias)
+        if metric is None:
+            raise SystemExit(f"{case['kind']}: missing metric alias {alias}")
+        if "formula" in metric:
+            raise SystemExit(f"{case['kind']}: {alias} degraded to formula")
+        adv_calc = metric.get("advCalc")
+        if not adv_calc:
+            raise SystemExit(f"{case['kind']}: {alias} missing advCalc")
+        if adv_calc.get("advType") != "COMPARATIVE":
+            raise SystemExit(f"{case['kind']}: {alias} advType is not COMPARATIVE")
+        if not any(isinstance(row, dict) and row.get(alias) not in ("", None) for row in rows):
+            raise SystemExit(f"{case['kind']}: {alias} has no non-empty preview value")
+        card_summary["aliases"][alias] = adv_calc["advValue"]
+
+    summary["cards"].append(card_summary)
+
+(out / "summary.json").write_text(json.dumps(summary, ensure_ascii=False, indent=2), encoding="utf-8")
+print(json.dumps(summary, ensure_ascii=False, indent=2))
+PY

package/skills-bundle/guanvis/evals/complex_report_pro/card_01_monthly.js

@@ -0,0 +1,63 @@
+var salesView = createCard(ChartType.DATA_GRID, "sales")
+    .setId("crpchildsales00000000001")
+    .bindDataset(DS)
+    .addRow(f("区域"))
+    .addRow(f("门店"))
+    .addMetric(f("销售额", { aggrType: AggrType.SUM }))
+    .addMetric(f("利润", { aggrType: AggrType.SUM }));
+
+var workbook = createReportWorkbook()
+    .addSheet("经营月报", function(sheet) {
+        sheet.setColumnWidth("A", 18)
+            .setColumnWidth("B", 18)
+            .setColumnWidth("C", 16)
+            .setColumnWidth("D", 16)
+            .setRowHeight(1, 28)
+            .merge("A1:D1")
+            .setValue("A1", "门店经营月报", {
+                fontSize: 16,
+                bold: true,
+                horizontalAlignment: "center",
+                verticalAlignment: "center",
+                backgroundColor: "#D9EAF7",
+                borderColor: "#8AA8BF"
+            })
+            .setValue("A2", "区域", { bold: true, backgroundColor: "#EEF5FA", borderColor: "#8AA8BF" })
+            .setValue("B2", "门店", { bold: true, backgroundColor: "#EEF5FA", borderColor: "#8AA8BF" })
+            .setValue("C2", "销售额", { bold: true, backgroundColor: "#EEF5FA", borderColor: "#8AA8BF" })
+            .setValue("D2", "利润", { bold: true, backgroundColor: "#EEF5FA", borderColor: "#8AA8BF" })
+            .bindDimension("A3", reportField("sales", "区域"), {
+                expansion: "vertical",
+                group: "merge",
+                style: { borderColor: "#D0D7DE" }
+            })
+            .bindDimension("B3", reportField("sales", "门店"), {
+                expansion: "vertical",
+                context: "A3",
+                style: { borderColor: "#D0D7DE" }
+            })
+            .bindMetric("C3", reportField("sales", "销售额"), {
+                aggregate: "SUM",
+                expansion: "vertical",
+                context: "B3",
+                numberFormat: "#,##0.00",
+                style: { borderColor: "#D0D7DE" }
+            })
+            .bindMetric("D3", reportField("sales", "利润"), {
+                aggregate: "SUM",
+                expansion: "vertical",
+                context: "B3",
+                numberFormat: "#,##0.00",
+                style: { borderColor: "#D0D7DE" }
+            });
+    });
+
+var report = createComplexReportPro("门店经营月报 Pro")
+    .setId("crpparentmonthly00000001")
+    .setDescription("GuanVis 结构化工作簿 DSL 生成的复杂报表 Pro")
+    .setWorkbook(workbook)
+    .addDataView("sales", salesView)
+    .setPagination(false)
+    .setColumnWidthStretch(true);
+
+registerComplexReportPro(report.build());

package/skills-bundle/guanvis/evals/complex_report_pro/page.js

@@ -0,0 +1,6 @@
+var page = createPage("复杂报表 Pro DSL 示例")
+    .setId("crppagemonthly0000000001")
+    .setDescription("结构化 xlsx、字段绑定、样式和复杂报表 Pro 原生附件协议")
+    .addFullWidthCard(0, 12);
+
+registerPage(page.build());

package/skills-bundle/guanvis/evals/complex_report_pro/schema.js

@@ -0,0 +1,6 @@
+defineDataset("complex_report_sales", [
+    { fdId: "region_fd", name: "区域", fdType: "STRING", metaType: "DIM" },
+    { fdId: "store_fd", name: "门店", fdType: "STRING", metaType: "DIM" },
+    { fdId: "sales_fd", name: "销售额", fdType: "DOUBLE", metaType: "METRIC" },
+    { fdId: "profit_fd", name: "利润", fdType: "DOUBLE", metaType: "METRIC" }
+], { displayType: "CSV" });

package/skills-bundle/guanvis/evals/custom_chart_echarts/card_01_bar.js

@@ -0,0 +1,13 @@
+var dataView = createCard(ChartType.DATA_GRID, "区域营收数据")
+    .setId("a000000000000000000child")
+    .bindDataset(DS)
+    .addRow(f("区域"))
+    .addMetric(f("营收", { aggrType: AggrType.SUM }));
+
+var chart = createCustomChart("区域营收柱状图")
+    .setId("a000000000000000000chart")
+    .setSubType(CustomChartSubType.ECHARTS_LITE)
+    .loadContent("charts/bar")
+    .addDataView(dataView);
+
+registerCustomChart(chart.build());

package/skills-bundle/guanvis/evals/custom_chart_echarts/card_02_pie.js

@@ -0,0 +1,13 @@
+var dataView = createCard(ChartType.DATA_GRID, "产品成本数据")
+    .setId("b000000000000000000child")
+    .bindDataset(DS)
+    .addRow(f("产品"))
+    .addMetric(f("成本", { aggrType: AggrType.SUM }));
+
+var chart = createCustomChart("产品成本饼图")
+    .setId("b000000000000000000chart")
+    .setSubType(CustomChartSubType.ECHARTS_LITE)
+    .loadContent("charts/pie")
+    .addDataView(dataView);
+
+registerCustomChart(chart.build());

package/skills-bundle/guanvis/evals/custom_chart_echarts/charts/bar.js

@@ -0,0 +1,11 @@
+var cols = data[0] || [];
+var categories = (cols[0] || {}).data || [];
+var values = (cols[1] || {}).data || [];
+
+option = {
+  tooltip: { trigger: "axis" },
+  xAxis: { type: "category", data: categories },
+  yAxis: { type: "value" },
+  series: [{ type: "bar", data: values }],
+  color: config.colors
+};

package/skills-bundle/guanvis/evals/custom_chart_echarts/charts/pie.js

@@ -0,0 +1,15 @@
+var cols = data[0] || [];
+var names = (cols[0] || {}).data || [];
+var values = (cols[1] || {}).data || [];
+
+option = {
+  tooltip: { trigger: "item" },
+  legend: { bottom: 10 },
+  series: [{
+    type: "pie",
+    radius: ["30%", "60%"],
+    data: names.map(function(name, i) { return { name: name, value: values[i] }; }),
+    label: { formatter: "{b}: {d}%" }
+  }],
+  color: config.colors
+};

package/skills-bundle/guanvis/evals/custom_chart_echarts/page.js

@@ -0,0 +1,5 @@
+var page = createPage("自定义图表示例")
+    .setId("na865a38893e52efa3a47c1d")
+    .addHalfWidthCards(0, 1);
+
+registerPage(page.build());

package/skills-bundle/guanvis/evals/custom_chart_echarts/schema.js

@@ -0,0 +1,9 @@
+// Auto-generated by guanvis schema command
+// DO NOT EDIT — regenerate with: guanvis schema s9ded2338f43807b095fbb4f
+
+defineDataset("s9ded2338f43807b095fbb4f", [
+    { fdId: "jb16f22f6c1c21c3f6e8e293", name: "区域", fdType: "STRING", metaType: "DIM" },
+    { fdId: "o7093aaf2b2f32c9e964c41a", name: "产品", fdType: "STRING", metaType: "DIM" },
+    { fdId: "lb1c31b4dc86511a27049a98", name: "营收", fdType: "DOUBLE", metaType: "METRIC" },
+    { fdId: "aece10cd6806966be56f52ff", name: "成本", fdType: "DOUBLE", metaType: "METRIC" }
+], { displayType: "CSV" });

package/skills-bundle/guanvis/evals/custom_chart_sdk/card_01_level_nodes.js

@@ -0,0 +1,19 @@
+// 自定义图表 SDK 模式最小示例：横向等级进度节点图（自定义 HTML/CSS + GDPlugin）。
+// 适用场景：内置图表做不出来的自定义 DOM 布局（节点图/进度轴/卡片流等）；
+// 纯 ECharts 需求改用 CustomChartSubType.ECHARTS_LITE（见 evals/custom_chart_echarts/）。
+var dataView = createCard(ChartType.DATA_GRID, "等级数据视图")
+    .setId("a000000000000000sdkchild")
+    .bindDataset(DS)
+    .addRow(f("等级"))
+    .addMetric(f("占比", { aggrType: AggrType.SUM }))
+    // 节点顺序必须显式排序，否则依赖查询返回顺序；数据集有序号字段时优先按序号排
+    .addSort(f("等级", { sortType: SortOrder.ASC }));
+
+var chart = createCustomChart("等级进度节点图")
+    .setId("a000000000000000sdkchart")
+    .setSubType(CustomChartSubType.SDK)
+    .loadContent("charts/level_nodes")
+    .addDataView(dataView);
+
+// 自定义图表必须用 registerCustomChart；registerCard 会在 preview 时报类型错配。
+registerCustomChart(chart.build());

package/skills-bundle/guanvis/evals/custom_chart_sdk/charts/level_nodes.css

@@ -0,0 +1,51 @@
+/* 横向节点+连接线布局范式：
+ * 圆点和连接线放进同一个固定高度的 .circle-area，连接线绝对定位、top 对准圆心。
+ * 把连接线做成与节点同级的独立 flex 项无法与圆心垂直对齐（客户实测踩坑）。 */
+#container {
+  width: 100%;
+  height: 100%;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-family: -apple-system, "PingFang SC", "Microsoft YaHei", sans-serif;
+}
+.node {
+  flex: 1;
+  max-width: 160px;
+  text-align: center;
+}
+.node .name {
+  font-size: 14px;
+  font-weight: 600;
+  margin-bottom: 8px;
+}
+.node .circle-area {
+  position: relative;
+  height: 16px; /* 与圆点直径一致，连接线以此垂直居中 */
+}
+.node .dot {
+  width: 16px;
+  height: 16px;
+  border-radius: 50%;
+  background: #4575b4;
+  margin: 0 auto;
+  position: relative;
+  z-index: 1;
+}
+/* 连接线：从本节点圆心向右延伸到下一节点圆心 */
+.node .connector {
+  position: absolute;
+  top: 7px; /* (circle-area 高 16 - 线高 2) / 2 */
+  left: 50%;
+  width: 100%;
+  height: 2px;
+  background: #c3d4e8;
+}
+.node:last-child .connector {
+  display: none;
+}
+.node .value {
+  font-size: 13px;
+  color: #666;
+  margin-top: 8px;
+}

package/skills-bundle/guanvis/evals/custom_chart_sdk/charts/level_nodes.html

@@ -0,0 +1 @@
+<div id="container"></div>

package/skills-bundle/guanvis/evals/custom_chart_sdk/charts/level_nodes.js

@@ -0,0 +1,28 @@
+// SDK 模式渲染代码：实现 renderChart 并用 new GDPlugin().init(renderChart) 挂载。
+// data[i] 对应第 i 个数据视图的列数据: [{name:"字段名", data:[...]}, ...]
+// config.colors 是主题色数组。联动回传（仅在 dataView 配置了 .linkTo() 时需要）：
+//   clickFunc({ clickedItems: [{ idx: [viewIndex, columnIndex], colName: "列名", value: ["选中值"] }] })
+function renderChart(data, clickFunc, config) {
+  var cols = data[0] || [];
+  var names = (cols[0] || {}).data || [];
+  var values = (cols[1] || {}).data || [];
+  var color = (config && config.colors && config.colors[0]) || "#4575b4";
+
+  var container = document.getElementById("container");
+  container.innerHTML = "";
+  for (var i = 0; i < names.length; i++) {
+    var node = document.createElement("div");
+    node.className = "node";
+    // 量纲以 guancli ds preview 看到的真实数据为准：0~1 小数才需要 ×100
+    var pct = (Number(values[i]) * 100).toFixed(1) + "%";
+    node.innerHTML =
+      '<div class="name"></div>' +
+      '<div class="circle-area"><div class="connector"></div><div class="dot"></div></div>' +
+      '<div class="value"></div>';
+    node.querySelector(".name").textContent = String(names[i]);
+    node.querySelector(".dot").style.background = color;
+    node.querySelector(".value").textContent = pct;
+    container.appendChild(node);
+  }
+}
+new GDPlugin().init(renderChart);

package/skills-bundle/guanvis/evals/custom_chart_sdk/page.js

@@ -0,0 +1,5 @@
+var page = createPage("自定义图表 SDK 示例")
+    .setId("a000000000000000sdkpage0")
+    .addFullWidthCard(0, 8);
+
+registerPage(page.build());

package/skills-bundle/guanvis/evals/custom_chart_sdk/schema.js

@@ -0,0 +1,7 @@
+// Auto-generated by guanvis schema command
+// DO NOT EDIT — regenerate with: guanvis schema <dsId>
+
+defineDataset("s0000000000000000000demo", [
+    { fdId: "f0000000000000000000lvl1", name: "等级", fdType: "STRING", metaType: "DIM" },
+    { fdId: "f0000000000000000000rat2", name: "占比", fdType: "DOUBLE", metaType: "METRIC" }
+], { displayType: "CSV" });

package/skills-bundle/guanvis/evals/dynamic_fields/card_01_dynamic_dataset.js

@@ -0,0 +1,20 @@
+var region = f("区域");
+var city = f("城市");
+var sales = f("销售额", { aggrType: AggrType.SUM });
+var profit = f("利润", { aggrType: AggrType.SUM });
+
+var card = createCard(ChartType.GROUPED_COLUMN, "动态维度与动态数值")
+    .setId("dfcarddataset00000000000")
+    .bindDataset(DS)
+    .addDynamicRow("分析维度", [region, city], {
+        defaultValue: [region],
+        multiSelect: false
+    })
+    .addDynamicMetric("分析数值", [sales, profit], {
+        defaultValue: [sales],
+        multiSelect: true,
+        orderType: DynamicFieldOrder.CLICK
+    })
+    .setShowLegend(true, "bottom");
+
+registerCard(card.build());

package/skills-bundle/guanvis/evals/dynamic_fields/card_02_dynamic_metric_chart.js

@@ -0,0 +1,16 @@
+var region = metricDim("销售额", "区域");
+var city = metricDim("销售额", "城市");
+var sales = metric("销售额");
+var profit = metric("利润");
+
+var card = createMetricChart(ChartType.PIVOT_TABLE, "指标平台动态维度与动态指标")
+    .setId("dfmetriccard000000000000")
+    .addDynamicRow("分析维度", [region, city], {
+        defaultValue: [region]
+    })
+    .addDynamicMetric("分析指标", [sales, profit], {
+        defaultValue: [sales],
+        multiSelect: true
+    });
+
+registerMetricChart(card.build());

package/skills-bundle/guanvis/evals/dynamic_fields/metrics.js

@@ -0,0 +1,19 @@
+defineMetric({
+    id: "metric_sales_eval_000001",
+    name: "销售额",
+    subType: "ATOMIC",
+    applicableDims: [
+        { fdId: "region_fd", dsId: "ds_dynamic_fields_eval", name: "区域", fdType: "STRING", metaType: "DIM" },
+        { fdId: "city_fd", dsId: "ds_dynamic_fields_eval", name: "城市", fdType: "STRING", metaType: "DIM" }
+    ]
+});
+
+defineMetric({
+    id: "metric_profit_eval_00001",
+    name: "利润",
+    subType: "ATOMIC",
+    applicableDims: [
+        { fdId: "region_fd", dsId: "ds_dynamic_fields_eval", name: "区域", fdType: "STRING", metaType: "DIM" },
+        { fdId: "city_fd", dsId: "ds_dynamic_fields_eval", name: "城市", fdType: "STRING", metaType: "DIM" }
+    ]
+});

package/skills-bundle/guanvis/evals/dynamic_fields/page.js

@@ -0,0 +1,9 @@
+var page = createPage("动态字段示例")
+    .setId("dfpage000000000000000000")
+    .setDescription("验证动态维度、动态数值和指标平台动态指标的资源包结构。")
+    .setBackgroundColor("#f5f5f5")
+    .setCardMargin(8)
+    .addFullWidthCard(0, 7)
+    .addFullWidthCard(1, 7);
+
+registerPage(page.build());

package/skills-bundle/guanvis/evals/dynamic_fields/schema.js

@@ -0,0 +1,7 @@
+defineDataset("ds_dynamic_fields_eval", [
+    { fdId: "region_fd", name: "区域", fdType: "STRING", metaType: "DIM" },
+    { fdId: "city_fd", name: "城市", fdType: "STRING", metaType: "DIM" },
+    { fdId: "month_fd", name: "月份", fdType: "DATE", metaType: "DIM" },
+    { fdId: "sales_fd", name: "销售额", fdType: "DOUBLE", metaType: "METRIC" },
+    { fdId: "profit_fd", name: "利润", fdType: "DOUBLE", metaType: "METRIC" }
+], { displayType: "CSV" });

package/skills-bundle/guanvis/evals/dynamic_fields/verify_default_roundtrip.sh

@@ -0,0 +1,137 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
+EVAL_DIR="$ROOT_DIR/evals/dynamic_fields"
+OUT_DIR="$EVAL_DIR/.roundtrip"
+
+mkdir -p "$OUT_DIR"
+
+cd "$ROOT_DIR"
+
+go run ./cmd/guanvis preview "$EVAL_DIR" > "$OUT_DIR/preview_payload.json"
+go run ./cmd/guanvis pack "$EVAL_DIR" -o "$OUT_DIR/dynamic_fields_package.zip" > "$OUT_DIR/pack.log"
+
+if [[ "${PUBLISH:-0}" == "1" ]]; then
+    go run ./cmd/guanvis publish "$EVAL_DIR" > "$OUT_DIR/publish.log"
+    guancli card get dfcarddataset00000000000 --raw > "$OUT_DIR/raw_dataset_card.json"
+    guancli card get dfmetriccard000000000000 --raw > "$OUT_DIR/raw_metric_card.json"
+fi
+
+python3 - "$OUT_DIR" <<'PY'
+import json
+import sys
+from pathlib import Path
+
+out = Path(sys.argv[1])
+
+expected = {
+    "dfcarddataset00000000000": {
+        "name": "动态维度与动态数值",
+        "mappings": {
+            "分析维度": {"zoneId": "row", "metaType": "DIM", "multiSelect": False},
+            "分析数值": {"zoneId": "metric", "metaType": "METRIC", "multiSelect": True},
+        },
+    },
+    "dfmetriccard000000000000": {
+        "name": "指标平台动态维度与动态指标",
+        "mappings": {
+            "分析维度": {"zoneId": "row", "metaType": "DIM", "multiSelect": False},
+            "分析指标": {"zoneId": "metric", "metaType": "METRIC", "multiSelect": True},
+        },
+    },
+}
+
+def load_json(path):
+    text = path.read_text(encoding="utf-8")
+    start = text.find("{")
+    if start > 0:
+        text = text[start:]
+    return json.loads(text)
+
+def normalize_card(raw):
+    obj = raw.get("response") or raw.get("data") or raw
+    if "card" in obj:
+        card = obj["card"]
+        meta = json.loads(card["meta"]) if isinstance(card.get("meta"), str) else card.get("meta")
+        return {"id": card.get("cdId"), "name": card.get("name"), "meta": meta}
+    content = obj.get("content") or obj
+    return {"id": obj.get("cdId") or obj.get("id"), "name": obj.get("name"), "meta": content.get("meta")}
+
+def preview_cards():
+    payload = load_json(out / "preview_payload.json")
+    cards = []
+    for item in payload.get("cards", []):
+        card = item.get("card", {})
+        meta = json.loads(card["meta"]) if isinstance(card.get("meta"), str) else card.get("meta")
+        cards.append({"id": card.get("cdId"), "name": card.get("name"), "meta": meta})
+    return cards
+
+def assert_dynamic_card(card):
+    card_id = card["id"]
+    if card_id not in expected:
+        return None
+    spec = expected[card_id]
+    chart_main = (card.get("meta") or {}).get("chartMain") or {}
+    zone_data = chart_main.get("zoneData") or {}
+    dz_info = chart_main.get("dynamicZoneInfo") or {}
+    if dz_info.get("hidden") is not False:
+        raise SystemExit(f"{card_id}: dynamicZoneInfo.hidden={dz_info.get('hidden')!r}, want false")
+    mappings = dz_info.get("dzMappings") or []
+    by_name = {m.get("name"): m for m in mappings}
+    if set(by_name) != set(spec["mappings"]):
+        raise SystemExit(f"{card_id}: dzMappings names={sorted(by_name)}, want {sorted(spec['mappings'])}")
+
+    summary = {"cardId": card_id, "name": card.get("name"), "mappings": {}}
+    for name, want in spec["mappings"].items():
+        mapping = by_name[name]
+        for key, want_value in want.items():
+            got = mapping.get(key)
+            if got != want_value:
+                raise SystemExit(f"{card_id}: mapping {name} {key}={got!r}, want {want_value!r}")
+        if mapping.get("selectType") != "SEARCHBOX":
+            raise SystemExit(f"{card_id}: mapping {name} selectType={mapping.get('selectType')!r}, want SEARCHBOX")
+        if mapping.get("orderType") not in ("PRESET", "CLICK"):
+            raise SystemExit(f"{card_id}: mapping {name} invalid orderType={mapping.get('orderType')!r}")
+        dz_id = mapping.get("dzId")
+        defaults = mapping.get("defaultValue") or []
+        if not dz_id:
+            raise SystemExit(f"{card_id}: mapping {name} missing dzId")
+        if not defaults:
+            raise SystemExit(f"{card_id}: mapping {name} defaultValue is empty")
+        zone_fields = zone_data.get(mapping["zoneId"]) or []
+        candidate_keys = {f.get("key") for f in zone_fields if f.get("dzId") == dz_id}
+        if not candidate_keys:
+            raise SystemExit(f"{card_id}: mapping {name} has no zoneData candidates for dzId={dz_id}")
+        missing = [key for key in defaults if key not in candidate_keys]
+        if missing:
+            raise SystemExit(f"{card_id}: mapping {name} defaultValue keys {missing} not found in zoneData.{mapping['zoneId']}")
+        summary["mappings"][name] = {
+            "dzId": dz_id,
+            "zoneId": mapping["zoneId"],
+            "metaType": mapping["metaType"],
+            "multiSelect": mapping["multiSelect"],
+            "defaultValue": defaults,
+            "candidateCount": len(candidate_keys),
+        }
+    return summary
+
+summaries = []
+for card in preview_cards():
+    result = assert_dynamic_card(card)
+    if result:
+        summaries.append(result)
+
+if len(summaries) != len(expected):
+    got = sorted(item["cardId"] for item in summaries)
+    raise SystemExit(f"preview dynamic card count={len(summaries)}, got {got}, want {sorted(expected)}")
+
+if (out / "raw_dataset_card.json").exists() and (out / "raw_metric_card.json").exists():
+    for raw_name in ("raw_dataset_card.json", "raw_metric_card.json"):
+        raw_summary = assert_dynamic_card(normalize_card(load_json(out / raw_name)))
+        summaries.append({**raw_summary, "source": raw_name})
+
+summary = {"cards": summaries}
+(out / "summary.json").write_text(json.dumps(summary, ensure_ascii=False, indent=2), encoding="utf-8")
+print(json.dumps(summary, ensure_ascii=False, indent=2))
+PY

package/skills-bundle/guanvis/evals/percentage_advcalc_roundtrip/README.md

@@ -0,0 +1,26 @@
+# Percentage Advanced Calc Round-Trip
+
+This eval verifies the L3 native BI `LEVEL_PERCENTAGE` advanced calculation builder against a real `default` BI environment.
+
+It covers:
+
+- 按列：`SUM`
+- 按行：`SUM` with a column dimension, matching the UI-created path
+- 指定行维度：`SUM`
+- 指定列维度：`SUM`
+- 去重计数：`CNT_DISTINCT`
+- 平均值：`AVG`, covering the backend SUM/CNT auxiliary denominator path
+
+Local payload preview from `guanvis/`:
+
+```bash
+guanvis preview ./evals/percentage_advcalc_roundtrip
+```
+
+Default-environment publish/readback commands intentionally live in the project golden-answer note rather than this PR, because they publish fixed resource IDs to the shared `default` environment. The manual verification checks:
+
+- `advCalc` is preserved in `zoneData.metric[*].advCalc`.
+- No metric silently degrades to a formula.
+- Each expected `measureOnDimRow` / `tfdId` / `auto` field round-trips.
+- Percentage number format is present with two decimal places.
+- `card preview` succeeds and percentage aliases have non-empty values.

package/skills-bundle/guanvis/evals/percentage_advcalc_roundtrip/card_01_percentage_advcalc.js

@@ -0,0 +1,44 @@
+var region = f("地区");
+var province = f("省/自治区");
+var category = f("类别");
+var subcategory = f("子类别");
+
+var percentageCard = createCard(ChartType.PIVOT_TABLE, "L3 占比高级计算")
+    .setId("pct01a02b03c04d05e06f07g")
+    .bindDataset(DS)
+    .addRow(region)
+    .addRow(province)
+    .addColumn(category)
+    .addColumn(subcategory)
+    .addMetric(f("销售额", {
+        alias: "按列SUM占比",
+        aggrType: AggrType.SUM,
+        advCalc: percentage.byColumn()
+    }))
+    .addMetric(f("销售额", {
+        alias: "按行SUM占比",
+        aggrType: AggrType.SUM,
+        advCalc: percentage.byRow()
+    }))
+    .addMetric(f("销售额", {
+        alias: "地区层级SUM占比",
+        aggrType: AggrType.SUM,
+        advCalc: percentage.byField(region)
+    }))
+    .addMetric(f("销售额", {
+        alias: "类别层级SUM占比",
+        aggrType: AggrType.SUM,
+        advCalc: percentage.byField(category)
+    }))
+    .addMetric(f("客户 ID", {
+        alias: "客户去重按列占比",
+        aggrType: AggrType.COUNT_DISTINCT,
+        advCalc: percentage.byColumn()
+    }))
+    .addMetric(f("折扣", {
+        alias: "折扣AVG地区占比",
+        aggrType: AggrType.AVG,
+        advCalc: percentage.byField(region)
+    }));
+
+registerCard(percentageCard.build());