@guandata/guanvis 0.1.36 → 0.1.38

package/skills/guanvis/references/checkout-editing.md

@@ -25,7 +25,8 @@ checkout 读到的是"当前账号视角"的卡片定义，publish 会把它整
 - **通用操作**：已有卡片可继续串接常用 `createCard` 后续操作，包括标题/描述（`setName`/`setDescription`）、`setRawSettings`、图例/标签/坐标轴/表格/拆分等视觉设置。
 - **Zone 操作按链式顺序真实执行**：`addRow/addMetric/...` 追加字段；`insertMetric(index, field)` 插入；`removeMetric(selector)` 删除字段并保守清理其它 zone 中同字段引用；`moveMetric(selector, index)` 调整顺序；`updateMetric(selector, patch)` / `patchMetric(...)` 修改已有字段属性并保留未设置字段配置。`setRows/setMetrics/...` 和 `clearRows/clearMetrics/...` 是整 zone 重建，不会继承被替换字段的格式，并会在验证时提示 warning——默认优先用 `update*/patch*/add*/remove*/move*`。
 - **自定义图表内容编辑**：仅限 subType 为 **SDK / ECHARTS_LITE**。checkout 自动反编译出 `charts/<cdId>.js`（含内嵌资源抽取），card JS 里 `attachCard(...).loadContent("charts/<cdId>")`；也可用 `.setScript()/.setHtml()/.setCss()/.setLibs()/.addLib()` 内联修改。COMPLEX_REPORT（走 Pro 流程）、PLUGIN/PLUGIN_LITE（事实源是插件市场资源）、REPORT_FORM（填报模板配置）调用这些内容编辑 API 会直接报错，不要对它们生成此类修改；详见 `builder-reference.md` 自定义图表章节。
-- **已有 selector 联动**：用 `.addLink(cardIdOrIndex, targetFieldName?)` / `.removeLink(cardIdOrIndex)` / `.clearLinks()` 叠加修改现有 `settings.asFilter`，不要反向改 JSON。
+- **已有 selector 配置**：用 `.setSelectorSetting()` 修改筛选器配置；禁止原地改变 selector 类型或重新绑定字段/参数。完整配置结构和适用规则见 `builder-reference.md` 的 SelectorBuilder 章节。
+- **已有 selector 联动**：用 `.addLink(cardIdOrIndex, targetFieldName?)` / `.removeLink(cardIdOrIndex)` / `.clearLinks()` 叠加修改现有 `settings.asFilter`，不要把有顺序的联动增删混进 `.setSelectorSetting()`，也不要反向改 JSON。
 - **Page 快捷筛选区**：按有序操作执行——`setFilterLayout` 整体设置，`clearFilterLayout` 清空，`addFilterLayoutItem` 追加去重，`insert/remove/moveFilterSelector` 局部调整；筛选栏布局、名称/控件/按钮字体、控件风格、按钮色、背景色和背景图用 `setFilterPanelLayout()`。省略字段保留 base，显式 `null` 删除对应覆盖并恢复产品/主题默认。
 - **筛选器在筛选栏和画布间移动**：优先用动作级 API：`moveFilterSelectorToCanvas(selectorId, x, y, w, h)` / `moveCanvasSelectorToFilter(selectorId, index?)`；筛选器组用 `moveSelectorGroupToCanvas(group, x, y, w, h)` / `moveCanvasSelectorGroupToFilter(group, index?)`。
 - **新增卡片**必须使用 `createCard()` / `createSelector()` 等工厂函数（新建资源 ID 用 `guanvis genid` 生成）。

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,13 +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` |
+| `.setBarSetting(obj)` | 设置柱形图/条形图的柱体宽度、间距和圆角；帕累托图还支持数据点显隐 |
+| `.setStackSplitSetting(obj)` | 设置分组堆积柱形图/条形图的堆积分组模式 |
+| `.setWaterfallSetting(obj)` | 设置瀑布图的正负值颜色和累计值 |
+| `.setParetoSetting(obj)` | 设置帕累托图的累计曲线名称和百分比精度 |
+| `.setMapSetting(obj)` | 设置地图专属属性 |
+| `.setBubbleSetting(obj)` | 设置气泡半径 |
+| `.setRadarSetting(obj)` | 设置雷达图显示属性 |
+| `.setBoxPlotSetting(obj)` | 设置箱线图属性 |
+| `.setHeatMapSetting(obj)` | 设置热力图属性 |
 | `.setShapeColorType(type)` | 设置图形填充 |
 | `.setLineSetting(obj)` | 设置折线显示 |
+| `.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` 里，数值/百分比格式由字段类型与图表区域规则自动处理。