@guandata/guanvis 0.1.37 → 0.1.39

package/skills/guanvis/references/metric-chart-reference.md

@@ -116,7 +116,7 @@ registerMetricChart(card.build());
 | `subtotalSetting.aggrType` | 小计聚合方式 |
 | `advCalc` | 高级计算，如排名、占比 |
 | `filter` | 指标业务限定 |
-| `miniChart` | 表格内迷你图 |
+| `miniChart` | 表格内迷你图的前端字段配置；不要直接手写，使用 `.setMiniChart()`，样式使用 `.setMiniChartSetting()` |
 | `formula` / `formulaField` | 复合/原子拆分公式 |
 | `parentFdName` / `granularity` | 日期派生字段信息 |
 | `key` / `subZoneId` / `dzId` | 字段实例 key / 子区域 / 动态字段 |
@@ -179,15 +179,23 @@ registerMetricChart(card.build());
 | `.setSpecialValue(config)` | 设置特殊值显示；仅支持前端开放该属性的图表类型 |
 | `.setShowTitle(show)` / `.setCardTitleStyle(config)` | 设置卡片标题显隐与样式 |
 | `.setColumns(columns)` | 设置 `content.columns` 与 dsInfo.columns |
-| `.setTableSetting(obj)` | 设置表格行为与视觉样式；详细字段见 `chart-properties.md` |
+| `.setTableSetting(obj)` | 设置表格行为与视觉样式 |
 | `.setTableCellMerge(obj)` | 设置透视表单元格合并 |
 | `.setPieSetting(obj)` / `.setPieCenterText(obj)` | 设置饼图属性 |
+| `.setTreemapDataLabel(obj)` / `.setFunnelDataLabel(obj)` | 设置矩形树图分层数据标签、漏斗图各类数据标签 |
 | `.setSplitSetting(obj)` | 设置拆分图属性 |
-| `.setBarSetting(obj)` | 设置柱形图/条形图的柱体宽度、间距和圆角；详细字段见 `chart-properties.md` |
-| `.setWaterfallSetting(obj)` | 设置瀑布图的正负值颜色和累计值；详细字段见 `chart-properties.md` |
+| `.setBarSetting(obj)` | 设置柱形图/条形图的柱体宽度、间距和圆角；帕累托图还支持数据点显隐 |
+| `.setStackSplitSetting(obj)` | 设置分组堆积柱形图/条形图的堆积分组模式 |
+| `.setWaterfallSetting(obj)` | 设置瀑布图的正负值颜色和累计值 |
+| `.setParetoSetting(obj)` | 设置帕累托图的累计曲线名称和百分比精度 |
+| `.setMapSetting(obj)` | 设置地图专属属性 |
+| `.setBubbleSetting(obj)` | 设置气泡半径 |
+| `.setRadarSetting(obj)` | 设置雷达图显示属性 |
+| `.setBoxPlotSetting(obj)` | 设置箱线图属性 |
+| `.setHeatMapSetting(obj)` | 设置热力图属性 |
 | `.setShapeColorType(type)` | 设置图形填充 |
 | `.setLineSetting(obj)` | 设置折线显示 |
-| `.setComboSetting(obj)` | 设置组合图的显示方式、折线或符号样式；详细字段见 `chart-properties.md` |
+| `.setComboSetting(obj)` | 设置组合图的显示方式、折线或符号样式 |
 | `.setAuxiliaryLine(obj)` | 设置辅助线 |
 | `.setGrandTotal(obj)` | 设置透视表/分组表行列总计及样式；字段小计通过 `metricDim()` / `metric()` overrides 配置 |
 | `.setFreeDrill(enabled, position)` | 设置 `config.freeDrillConfig` |

package/skills/guanvis/references/theme.md

@@ -85,8 +85,8 @@ AI 选择主题时不要把租户主题列表里的默认“浅色”/“深色
 
 `design-rule.json` 只用于两类配置：
 
-- `componentDefaults`：卡片静态默认规则，例如 `SINGLE_VALUE` 单指标卡、`KPI_CARD` 对比指标卡的默认布局与样式。指标卡/对比指标卡布局类配置只通过这里统一配置，不放进 `themePatch`，也不提供单张卡片 props 透出。
-- `themePatch`：仅用于主题已开放的主题配置，例如页面背景、标题样式、主题色等；不要把指标卡布局类配置放进 `themePatch`。
+- `componentDefaults`：卡片静态默认规则，用于统一项目内同类卡片的默认布局与样式，不属于主题覆盖。
+- `themePatch`：仅用于主题已开放的配置，例如页面背景、标题样式、主题色等；卡片自身的专属属性不放在这里。
 
 数据格式不放在 `design-rule.json` 里，数值/百分比格式由字段类型与图表区域规则自动处理。
 

package/skills/guanvis/references/troubleshooting.md

@@ -11,6 +11,9 @@
 | `unknown chart type 'X'` | ChartType 枚举值错误 | 使用 `ChartType.XXX` 常量，不要手写字符串 |
 | `auth: ...` / `401` | Token 过期或 profile 错误 | 运行 `guancli auth status`，必要时重新 `auth login` |
 | `run scripts: ...ReferenceError` | JS 脚本中引用了未定义的变量 | 检查是否使用了 `new XxxBuilder()` 而非工厂函数 `createXxx()` |
+| `registerXxx() received a 'yyy' build result — use registerYyy(...) instead` | 注册函数与工厂函数错配（最常见：自定义图表误用 `registerCard`） | 按提示换成配对的注册函数，如 `createCustomChart` → `registerCustomChart(chart.build())` |
+| 自定义图表发布后渲染空白 | SDK 模式脚本没调 `new GDPlugin().init(renderChart)`；或 ECHARTS_LITE 脚本误用 `GDPlugin`/没给 `option` 赋值 | 对照 `evals/custom_chart_sdk/`（SDK）或 `evals/custom_chart_echarts/`（ECHARTS_LITE）模板检查渲染脚本入口 |
+| 自定义图表数值显示 `0.86%` 而非 `86%` | 没确认字段量纲就写格式化逻辑 | 先 `guancli ds preview <dsId>` 看真实数据，0~1 小数才需要 ×100 |
 | `placeCard index out of range` | placeCard 的 cardIndex 超出已注册卡片数量 | 检查 registerCard/registerTextCard 的调用顺序和总数 |
 | `page has no cards` | page.js 中没有 placeCard | 确保 page.js 中为每个已注册的卡片调用了 placeCard |
 | `selector not linked to any card` | selector 没有调用 linkTo/linkToAll | 添加 `.linkToAll()` 或 `.linkTo(cardIndex)` |