@guandata/guanvis 0.1.37 → 0.1.39

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## @guandata/guanvis 0.1.39 - 2026-08-20
+
+- 修复 `attachCard` 场景下计算字段的序列化问题，减少附加卡片发布/导出时字段配置异常的情况。
+- 优化 `publish` 在 `profile` 模式下的输出反馈，发布后可直接看到页面 URL，便于确认结果和继续验收。
+- 改进自定义图表的生成与接入体验，补充更直接的速查入口、最小 SDK 模板，并增加注册函数的类型校验护栏，降低接入出错成本。
+- 澄清自定义图表视觉验收与 `screenshot` 使用规则的边界，完善相关操作指引。
+- 提升 npm 安装与 Skill 自动安装体验，包括更明确的安装反馈、删除确认流程修复，以及 Windows CLI 兼容性改进。
+
+## @guandata/guanvis 0.1.38 - 2026-08-13
+
+- 新增 `live` 系列命令和完整实时项目工作流，可对线上仪表板执行受控、可回溯的创建与维护操作。
+- 大幅扩展指标图、进度图、迷你图、地图、气泡图、雷达图、箱线图、热力图等专项图表属性，复杂看板的表达能力更完整。
+- 新增系统图标查询与引用能力，指标图等场景可直接使用 BI 环境中的图标资源。
+- 增强实时项目输入校验、已有仪表板附着、初始化、覆盖保护和任务诊断，减少误操作并提升问题定位效率。
+
 ## @guandata/guanvis 0.1.37 - 2026-08-07
 
 - 发布前新增字段 `fdId` 线上活性校验，提前发现无效字段绑定，降低发布失败风险。

package/README.md

@@ -5,10 +5,11 @@
 ## 安装
 
 ```bash
-npm install -g @guandata/guanvis
-guanvis install-skill
+npm install -g --foreground-scripts @guandata/guanvis
 ```
 
+> 全局安装/升级时会通过 postinstall 自动执行一次 `guanvis install-skill` 刷新 AI skill。`--foreground-scripts` 用于显示明确的成功、失败或跳过结果；失败时按提示手动运行 `guanvis install-skill`。CI 等无需 skill 的环境可设 `GUAN_SKIP_INSTALL_SKILL=1` 跳过。
+
 安装后即可在终端使用：
 
 ```bash
@@ -54,6 +55,19 @@ guanvis publish ./my_dashboard/ --allow-overwrite
 
 ## 版本更新
 
+### @guandata/guanvis 0.1.39
+
+- 修复 `attachCard` 计算字段序列化问题，减少附加卡片配置异常。
+- `profile` 模式发布后会直接输出页面 URL，便于继续验收。
+- 完善自定义图表速查入口、最小 SDK 模板和注册函数类型校验。
+- 改进 Skill 自动安装反馈、删除确认和 Windows CLI 兼容性。
+
+### @guandata/guanvis 0.1.38
+
+- 新增 `live` 系列命令和完整实时项目工作流，可受控地创建与维护线上仪表板。
+- 扩展指标图、进度图、迷你图、地图、气泡图、雷达图、箱线图、热力图等专项图表属性。
+- 支持查询和引用 BI 环境中的系统图标，并增强输入校验、覆盖保护和任务诊断。
+
 ### @guandata/guanvis 0.1.37
 
 - 完善筛选器、页面布局和组合图配置，仪表板搭建更灵活。

package/bin/install-env.js

@@ -0,0 +1,73 @@
+"use strict";
+
+const { spawnSync } = require("child_process");
+
+const SANITIZED_MARKER = "GUAN_INSTALL_ENV_SANITIZED";
+const SAFE_DELETE_TARGET = String.raw`(?:"(?:[^"]*[\\/])?genie-safe-delete\.cjs"|'(?:[^']*[\\/])?genie-safe-delete\.cjs'|(?:[^\s"']*[\\/])?genie-safe-delete\.cjs)`;
+
+function envKey(env, expected) {
+  return Object.keys(env).find((key) => key.toLowerCase() === expected.toLowerCase());
+}
+
+function stripWorkBuddySafeDelete(nodeOptions) {
+  const pattern = new RegExp(
+    String.raw`(^|\s)(?:--require|-r)(?:=|\s+)${SAFE_DELETE_TARGET}(?=\s|$)(?:\s+|$)`,
+    "gi"
+  );
+  let removed = false;
+  const value = String(nodeOptions || "").replace(pattern, (_, prefix) => {
+    removed = true;
+    return prefix ? " " : "";
+  }).trim();
+  return { value, removed };
+}
+
+function hasWorkBuddySafeDelete(env = process.env) {
+  const key = envKey(env, "NODE_OPTIONS");
+  return Boolean(key && stripWorkBuddySafeDelete(env[key]).removed);
+}
+
+function createInstallChildEnv(env = process.env) {
+  const childEnv = { ...env };
+  for (const key of Object.keys(childEnv)) {
+    if (key.toLowerCase() === "npm_config_global") {
+      delete childEnv[key];
+    }
+  }
+
+  const nodeOptionsKey = envKey(childEnv, "NODE_OPTIONS");
+  if (nodeOptionsKey) {
+    const cleaned = stripWorkBuddySafeDelete(childEnv[nodeOptionsKey]);
+    if (cleaned.removed) {
+      if (cleaned.value) childEnv[nodeOptionsKey] = cleaned.value;
+      else delete childEnv[nodeOptionsKey];
+      childEnv[SANITIZED_MARKER] = "1";
+    }
+  }
+  return childEnv;
+}
+
+function reexecInstallCommand(scriptPath, args, options = {}) {
+  const env = options.env || process.env;
+  if (env[SANITIZED_MARKER] === "1" || !hasWorkBuddySafeDelete(env)) {
+    return false;
+  }
+
+  const spawn = options.spawn || spawnSync;
+  const exit = options.exit || process.exit;
+  const nodePath = options.nodePath || process.execPath;
+  const result = spawn(nodePath, [scriptPath, ...args], {
+    stdio: "inherit",
+    env: createInstallChildEnv(env),
+    shell: false,
+  });
+  if (result.error) throw result.error;
+  exit(result.status == null ? 1 : result.status);
+  return true;
+}
+
+module.exports = {
+  createInstallChildEnv,
+  hasWorkBuddySafeDelete,
+  reexecInstallCommand,
+};

package/bin/postinstall.js

@@ -41,18 +41,21 @@ function main() {
   );
   if (result.error || result.status !== 0) {
     console.warn(
-      `[${CLI_NAME}] postinstall: automatic skill install did not complete` +
+      `[${CLI_NAME}] postinstall: AI skill update FAILED` +
         (result.error ? ` (${result.error.message})` : ` (exit ${result.status})`) +
         `; run \`${CLI_NAME} install-skill\` manually to refresh SKILL.md.`
     );
+    return;
   }
+  console.log(`[${CLI_NAME}] postinstall: AI skill updated successfully.`);
 }
 
 try {
   main();
 } catch (err) {
   console.warn(
-    `[${CLI_NAME}] postinstall: ${err.message}; run \`${CLI_NAME} install-skill\` manually.`
+    `[${CLI_NAME}] postinstall: AI skill update FAILED (${err.message}); ` +
+      `run \`${CLI_NAME} install-skill\` manually.`
   );
 }
 process.exit(0);

package/bin/run.js

@@ -6,6 +6,7 @@ const { execFileSync, execSync, spawnSync } = require("child_process");
 const path = require("path");
 const fs = require("fs");
 const os = require("os");
+const { createInstallChildEnv, reexecInstallCommand } = require("./install-env");
 
 const PLATFORM_MAP = {
   "darwin-arm64": "guanvis-darwin-arm64",
@@ -111,6 +112,7 @@ function resolveNpxInvocation() {
 }
 
 if (process.argv[2] === "install-skill") {
+  reexecInstallCommand(__filename, process.argv.slice(2));
   const pkgRoot = path.join(__dirname, "..");
   const extraArgs = process.argv.slice(3);
   const args = [
@@ -128,8 +130,11 @@ if (process.argv[2] === "install-skill") {
   console.log("Installing guanvis to AI coding assistants...");
   const npxInvocation = resolveNpxInvocation();
   const result = spawnSync(npxInvocation.command, [...npxInvocation.argsPrefix, ...args], {
+    // Avoid leaking project-only Agent markers (for example PromptScript) from
+    // the caller's cwd into this global installation.
+    cwd: pkgRoot,
     stdio: "inherit",
-    env: process.env,
+    env: createInstallChildEnv(process.env),
     shell: false,
   });
   if (result.error) throw result.error;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guandata/guanvis",
-  "version": "0.1.37",
+  "version": "0.1.39",
   "description": "观远 BI Card/Page 生成工具 - 通过 JS DSL 创建图表和仪表板",
   "bin": {
     "guanvis": "bin/run.js"

package/skills/guanvis/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: guanvis
 description: 当用户要新建、修改、组装观远 BI / Guandata 的 Card（图表/报表卡片）、复杂报表 Pro（COMPLEX_REPORT_PRO）、用指标平台指标创建的指标卡片、文本卡片、图片卡片、筛选器（selector，含日历/时间宏/区间/离散值）或仪表板（Page），或给出 Card ID、数据集 ID、指标 ID、card.js/page.js、图表类型关键词（柱状/折线/饼/KPI/表格/漏斗/地图/散点等 30+ 种）时，优先使用这个 skill。即使用户只说"做个销售仪表板""创建一个复杂报表 Pro""用这个指标做张卡片""加个 KPI 卡片""新建一个区域筛选器联动所有图""帮我改一下这个图的图例""把这几个 card 拼成一个 page""加一个本月/近 7 天的快捷日期筛选"，也要主动使用。它通过 AI 编写简洁的 JS 脚本（card_*.js / selector_*.js / page.js）定义卡片、筛选器和页面布局，再 pack/publish 上传到目标 BI。认证复用 guancli 共享配置。只想查现有 Card/Page 内容走 guancli。旧版复杂报表不支持创建或编辑。
-compatibility: "Requires Node.js 14+. Install via npm link (local) or npm install -g @guandata/guanvis (from internal Nexus registry). CLI command: guanvis."
+compatibility: "Requires Node.js 14+. Install via npm link --foreground-scripts (local) or npm install -g --foreground-scripts @guandata/guanvis (from internal Nexus registry) so the AI skill refresh result is visible. CLI command: guanvis."
 ---
 
 # guanvis
@@ -30,7 +30,7 @@ compatibility: "Requires Node.js 14+. Install via npm link (local) or npm instal
 - 先 `preview` 做本地结构验证，再 `publish`（publish 自带构建打包上传，**发布前不需要单独 `pack`**；`pack` 只用于生成离线 ZIP 走 `upload`）。仅修复描述用 `card/page set-description` 并同步 JS 中的 `.setDescription(...)`；改看板内容按「线上仪表板更新红线」处理。
 - **编辑红线（编辑 ≠ 删除重建）**：修改/改名已发布 Page 或 Card 必须保留原 pgId/cdId 原地覆盖发布。本地源工程还在且线上未被网页端改动 → 直接改本地 JS 同 ID 重新 publish；否则 → `checkout` 后编辑，且**不得**把 `attachCard` 改写成 `createCard()`（绕过 base JSON 会丢线上配置）。**禁止**用"新建 + 删除旧的"模拟编辑——资源 ID 变化会让收藏、分享、订阅、门户引用和页面权限全部失效且无法迁移；"保留旧页面出新版本"用 `guanvis page save-as`。全局参数同理只能 `parameter update <dpId>` 原地更新，禁止 delete 后重建同名参数（dpId 断链）。分流决策见 `references/checkout-editing.md` §4。
 - **资源包安全红线**：Agent 只编辑 DSL 源文件；资源包 ZIP 是 `guanvis pack/publish` 的派生产物，不手工生成、解包修改或重打包。`guanvis upload` 只允许上传 `guanvis pack` 原样生成的 ZIP。若用户要求批量重绑资源、迁移已有页面或复用线上页面结构，先停下来说明风险并确认方案，不要直接改 ZIP。
-- 发布后优先用 `guancli page get/card get` 回读结构与配置；`guanvis screenshot` 仅在明确需要视觉质量判断且模型支持图像理解时使用（额外消耗 token），不作默认闭环步骤。
+- 发布后优先用 `guancli page get/card get` 回读结构与配置；`guanvis screenshot` 仅在明确需要视觉质量判断且模型支持图像理解时使用（额外消耗 token），不作默认闭环步骤。**例外**：自定义图表的视觉验收按速查第 24 条执行。
 
 ## AI Quick Reference（速查，详细说明见按需参考资料）
 
@@ -41,7 +41,7 @@ compatibility: "Requires Node.js 14+. Install via npm link (local) or npm instal
 **图表属性配置**：设置图表属性时，先读 `references/chart-properties.md`，按其中的方法和参数配置。
 
 1. **工厂函数**：数据集图表 `createCard()`；复杂报表 Pro `createComplexReportPro()` + `createReportWorkbook()`；已有线上普通卡片 `attachCard(cardId, jsonPath)`；指标卡片 `createMetricChart()`；筛选器/文本/图片/杜邦/Tab/页面用对应工厂函数，不要 `new XxxBuilder()`。旧版复杂报表拒绝，Pro 父卡不能用泛化 `attachCard()`
-2. **注册函数**：`registerCard` / `registerComplexReportPro` / `registerMetricChart` / `registerSelector` / `registerTextCard` / `registerImageCard` / `registerDuPontChart` / `registerPage`，入参一律 `xxx.build()`
+2. **注册函数**：`registerCard` / `registerComplexReportPro` / `registerMetricChart` / `registerSelector` / `registerTextCard` / `registerImageCard` / `registerCustomChart` / `registerDuPontChart` / `registerPage`，入参一律 `xxx.build()`；注册函数与工厂函数必须配对（如 `createCustomChart` 只能 `registerCustomChart`），错配会在 preview 时直接报错并提示正确函数
 3. **字段引用**：单数据集用 `f("字段名")`，多数据集用 `field(DS, "字段名")`
 4. **zone maxCount**：`BASIC_COLUMN/BAR/LINE` metric=1；`GROUPED_*/STACKED_*` metric=∞；`KPI_CARD` metric=1；组合图 `*_WITH_LINE` row=1
 5. **column vs colorBy**：column 放维度（按类别分组着色），colorBy 放度量（按值渐变着色）
@@ -63,7 +63,8 @@ compatibility: "Requires Node.js 14+. Install via npm link (local) or npm instal
 21. **布局组件**：AreaTitle/CardGroup/SelGroup/Tab 只支持放画布根布局、不支持嵌套组合；SelGroup 内只能放 selector；详见 `references/builder-reference.md`
 22. **资源包/checkout JSON 禁止手改**：只改 DSL 源文件，不改 ZIP 内部文件与 `.guanvis/**` JSON；批量重绑、迁移页面等需求先讨论方案，必要时扩展 DSL，不手工改生成物。
 23. **动态字段**：用户明确需要字段切换时用 `.addDynamicRow()` / `.addDynamicMetric()` 等（普通卡动态维度/数值，指标卡动态维度/指标）；细节见 `references/builder-reference.md`。
-24. **复杂报表 Pro**：非默认功能，需单独授权——只有用户明确点名"复杂报表 / 复杂报表 Pro"或被修改卡片已是 Pro 才选 Pro；用户只说"表格/报表/透视表"一律用原生卡片（DATA_GRID/PIVOT_TABLE 等），版式做不到时告知"Pro 可实现但需授权"由用户决定。动手前必读 `references/complex-report-pro-patterns.md`（§0 选型、§2 配方、§3 数据视图规则、§4 报错修复、§5 编辑闭环、§6 验证闭环），全部结构红线与修复表以该文件为准；工作流程见下文「复杂报表 Pro 工作方式」
+24. **自定义图表（HTML/CSS/JS 自绘）**：内置图表满足不了的可视化才走 `createCustomChart()`。子类型选型：纯 ECharts 配置能画 → `CustomChartSubType.ECHARTS_LITE`（脚本给 `option` 赋值，禁用 `GDPlugin`）；需要自定义 DOM/CSS 布局或第三方库（节点图、进度轴、Vega 等）→ `CustomChartSubType.SDK`（`charts/<name>.{html,css,js}` 三件套 + `loadContent("charts/<name>")`，js 里实现 `renderChart(data, clickFunc, config)` 并 `new GDPlugin().init(renderChart)`）。数据用 `.addDataView(createCard(ChartType.DATA_GRID, ...))` 传入。最小可运行工程直接抄 `evals/custom_chart_sdk/`（SDK）或 `evals/custom_chart_echarts/`（ECHARTS_LITE）。**视觉验收**：preview 只校验结构不渲染 HTML/CSS，本地 file:// 打开也不可靠——正确闭环是发布（可先发到测试目录）后 `guanvis screenshot <pgId>` 读图确认（这是总则"screenshot 不作默认闭环"的例外：自定义图表视觉由手写 HTML/CSS 决定，结构回读覆盖不到）；模型不支持图像理解时，改为把 publish 成功后输出的 `Page URL` 交给用户人工确认。不要浪费时间做本地渲染验证。完整 API 见 `references/builder-reference.md` 的 CustomChartBuilder 章节。
+25. **复杂报表 Pro**：非默认功能，需单独授权——只有用户明确点名"复杂报表 / 复杂报表 Pro"或被修改卡片已是 Pro 才选 Pro；用户只说"表格/报表/透视表"一律用原生卡片（DATA_GRID/PIVOT_TABLE 等），版式做不到时告知"Pro 可实现但需授权"由用户决定。动手前必读 `references/complex-report-pro-patterns.md`（§0 选型、§2 配方、§3 数据视图规则、§4 报错修复、§5 编辑闭环、§6 验证闭环），全部结构红线与修复表以该文件为准；工作流程见下文「复杂报表 Pro 工作方式」
 
 ## 何时使用
 
@@ -87,6 +88,7 @@ guancli auth status
 
 ```bash
 guancli ds search <关键词>                        # 查找数据集 ID
+guancli ds preview <dsId>                         # 先看几行真实数据再动笔：确认量纲与格式（如"比例"是 0~1 小数还是百分数）
 guanvis init <dsId1> <dsId2> -d ./my_dashboard/   # 生成 schema.js（多数据集加 --alias 命名全局变量）
 ```
 
@@ -203,9 +205,13 @@ guanvis check-dataset-switch . --from <oldDs> --to <newDs> --mode full   # 详
 # 仪表板主题（详见 references/theme.md）
 guanvis theme preference --keywords "..." --sync   # 另有 --theme-id / --clear；theme list/show/sync
 
-# 单张图表主题色
+# 获取当前环境中可用的图表主题色
 guanvis theme-color list
 guanvis theme-color sync -d ./my_dashboard
+
+# 获取当前 BI 环境可用的图标
+guanvis icon list
+guanvis icon list --group default_line -f json
 ```
 
 **多子目录工程**：每个子目录是独立工程，preview/pack/publish/`theme *` 必须 `cd` 进各子目录分别执行、各出各的资源包；根目录直接运行时若任一子目录有 `themes/` 会拒绝执行并打印 cd 提示。
@@ -244,7 +250,8 @@ guanvis theme-color sync -d ./my_dashboard
 |------|------|------|
 | 基础仪表板 | `evals/sales_dashboard/` | 普通卡片 + 筛选器 + 页面布局 |
 | 拆分图 | `evals/split_charts/` | 图表按字段拆分 |
-| 自定义图表 | `evals/custom_chart_echarts/` | ECharts Lite，`loadContent()` 文件模式 |
+| 自定义图表（ECharts Lite） | `evals/custom_chart_echarts/` | 纯 ECharts `option`，`loadContent()` 文件模式 |
+| 自定义图表（SDK/自定义 DOM） | `evals/custom_chart_sdk/` | HTML/CSS 节点进度图，`GDPlugin` + 连接线对齐布局范式 |
 | 复杂报表 Pro | `evals/complex_report_pro/` | 最小 Workbook DSL 工程（结构配方以 patterns.md §2 为准） |
 | Tab 布局 | `evals/tab_layout/` | 根布局指标卡 + panel 内卡片 + 筛选器 |
 

package/skills/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/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/guanvis/evals/custom_chart_sdk/charts/level_nodes.html

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

package/skills/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/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/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/guanvis/references/api-reference.md

@@ -4,7 +4,7 @@
 
 | 函数 | 说明 |
 |------|------|
-| `defineDataset(dsId, columns, options?)` | 定义数据集 schema（由 init 命令生成）。第一个数据集自动暴露为 `global.DS`（dsId 字符串）。`options.displayType` 指定数据集类型（如 `"EXCEL"`, `"DATAFLOW"`），确保看板页面正确显示数据集图标 |
+| `defineDataset(dsId, columns, options?)` | 定义数据集 schema（由 init 命令生成）。第一个数据集自动暴露为 `global.DS`（dsId 字符串）。`options.displayType` 指定数据集类型（如 `"EXCEL"`, `"DATAFLOW"`）；`options.sourceType` 保存数据源运行方式，用于直连能力限制等校验 |
 | `field(dsId, fieldName, overrides?)` | 从 schema 构造字段引用，`dsId` 是字符串。可叠加 aggrType/alias/numberFormat/sortType/granularity 等 |
 | `f(fieldName, overrides?)` | `field(DS, fieldName, overrides)` 的简写，仅适用于**单数据集**场景 |
 | `chartField(zone, index)` | 按最终数据区和位置引用图表字段，用于 `setAuxiliaryLine()` 的计算辅助线 |

package/skills/guanvis/references/builder-reference.md

@@ -25,8 +25,18 @@
 | `.addLocation(field)` / `.addTarget(field)` / `.addCompare(field)` | 位置/目标/对比 |
 | `.setSplitSetting(config)` | 拆分图配置 |
 | `.setColorByColors(preset_or_config)` | 渐变色配置 |
-| `.setBarSetting(config)` | 柱形图/条形图的柱体宽度、间距和圆角配置 |
+| `.setBarSetting(config)` | 柱形图/条形图的柱体宽度、间距和圆角配置；帕累托图还支持数据点显隐 |
+| `.setStackSplitSetting(config)` | 分组堆积柱形图/条形图的堆积分组模式 |
 | `.setWaterfallSetting(config)` | 瀑布图的正负值颜色和累计值配置 |
+| `.setParetoSetting(config)` | 帕累托图的累计曲线名称和百分比精度配置 |
+| `.setMapSetting(config)` | 地图专属属性配置 |
+| `.setBubbleSetting(config)` | 气泡半径配置 |
+| `.setRadarSetting(config)` | 雷达图显示配置 |
+| `.setBoxPlotSetting(config)` | 箱线图配置 |
+| `.setHeatMapSetting(config)` | 热力图配置 |
+| `.setSingleValueSetting(config)` / `.setKPISetting(config)` | 指标卡、对比指标卡配置 |
+| `.setProgressBarSetting(config)` / `.setProgressPieSetting(config)` | 进度条、进度环配置 |
+| `.setActivityGaugeSetting(config)` / `.setLiquidGaugeSetting(config)` / `.setSolidGaugeSetting(config)` | 活动仪表盘、水波图、实心仪表盘配置 |
 | `.setShapeColorType(type)` | 图形填充配置 |
 | `.setLineSetting(config)` | 折线显示配置 |
 | `.setComboSetting(config)` | 组合图的显示方式、折线或符号样式配置 |
@@ -34,9 +44,11 @@
 | `.setShowTitle(show)` / `.setCardTitleStyle(config)` | 卡片标题显隐和样式配置 |
 | `.setShowLegend(show, position?)` / `.setChartLegend(config)` | 图例配置 |
 | `.setDataLabel(config)` / `.setMetricAdditionalDataLabel(config)` | 数据标签配置 |
+| `.setTreemapDataLabel(config)` / `.setFunnelDataLabel(config)` | 矩形树图分层数据标签、漏斗图各类数据标签配置 |
 | `.setAxis(config)` | 坐标轴配置 |
 | `.setTooltip(config)` | 工具提示配置 |
 | `.setTableSetting(config)` / `.setTableCellMerge(config)` | 表格行为、视觉样式与单元格配置 |
+| `.setMiniChart(selector, config)` / `.setMiniChartSetting(selector, config)` | 设置透视表数值字段的迷你图类型、维度及字段 key 对应样式 |
 | `.setPieSetting(config)` / `.setPieCenterText(config)` | 饼图配置 |
 | `.setGrandTotal(config)` | 表格总计与小计配置 |
 | `.setSummary(field, options?)` / `.setSummaryStyle(config)` | 汇总指标及样式配置 |
@@ -167,13 +179,25 @@ attachCard(CARD_ID, BASE_PATH)
 | `.setShowTitle()` / `.setCardTitleStyle()` | 卡片标题显隐和样式配置 |
 | `.setShowLegend()` / `.setChartLegend()` | 图例配置 |
 | `.setDataLabel()` / `.setMetricAdditionalDataLabel()` | 数据标签配置 |
+| `.setTreemapDataLabel()` / `.setFunnelDataLabel()` | 矩形树图分层数据标签、漏斗图各类数据标签配置 |
 | `.setAxis()` / `.setAuxiliaryLine()` / `.setTooltip()` | 坐标轴、辅助线和工具提示配置 |
 | `.setLineSetting()` | 折线显示配置 |
 | `.setComboSetting()` | 组合图的显示方式、折线或符号样式配置 |
-| `.setBarSetting()` | 柱形图/条形图的柱体宽度、间距和圆角配置 |
+| `.setBarSetting()` | 柱形图/条形图的柱体宽度、间距和圆角配置；帕累托图还支持数据点显隐 |
+| `.setStackSplitSetting()` | 分组堆积柱形图/条形图的堆积分组模式 |
 | `.setWaterfallSetting()` | 瀑布图的正负值颜色和累计值配置 |
+| `.setParetoSetting()` | 帕累托图的累计曲线名称和百分比精度配置 |
+| `.setMapSetting()` | 地图专属属性配置 |
+| `.setBubbleSetting()` | 气泡半径配置 |
+| `.setRadarSetting()` | 雷达图显示配置 |
+| `.setBoxPlotSetting()` | 箱线图配置 |
+| `.setHeatMapSetting()` | 热力图配置 |
+| `.setSingleValueSetting()` / `.setKPISetting()` | 指标卡、对比指标卡配置 |
+| `.setProgressBarSetting()` / `.setProgressPieSetting()` | 进度条、进度环配置 |
+| `.setActivityGaugeSetting()` / `.setLiquidGaugeSetting()` / `.setSolidGaugeSetting()` | 活动仪表盘、水波图、实心仪表盘配置 |
 | `.setPieSetting()` / `.setPieCenterText()` | 饼图配置 |
 | `.setTableSetting()` / `.setTableCellMerge()` / `.setGrandTotal()` | 表格行为、视觉样式与汇总配置 |
+| `.setMiniChart()` / `.setMiniChartSetting()` | 设置透视表数值字段的迷你图和样式；支持已有 MetricChart 增量编辑 |
 | `.setSplitSetting()` / `.setShapeColorType()` | 拆分图和图形填充配置 |
 | `.setRawSettings()` | 原始设置 |
 | `.setProps(obj)` | 设置指标卡片 `meta.chartMain.props` |
@@ -1773,6 +1797,10 @@ project/
 | `AggrType` | `SUM`, `AVG`, `COUNT`(=CNT), `COUNT_DISTINCT`(=CNT_DISTINCT), `MIN`, `MAX` | 聚合类型 |
 | `FieldType` | `STRING`, `INT`, `LONG`, `DOUBLE`, `FLOAT`, `DATE`, `BOOL`, `DECIMAL` | 字段数据类型 |
 | `SortOrder` | `ASC`, `DESC` | 排序方向 |
+| `MiniChartType` | `LINE`, `COLUMN`, `PIE`, `PROGRESS` | 透视表字段迷你图类型 |
+| `MiniChartSort` | `ASC`, `DESC` | 迷你图维度排序方向 |
+| `MapRegion` | `COUNTRY`, `PROVINCE`, `CITY`, `AUTO` | 中国行政类地图的显示范围 |
+| `MapSymbol` | `CIRCLE`, `DIAMOND`, `SQUARE`, `TRIANGLE`, `TRIANGLE_DOWN` | 符号行政地图的内置符号 |
 | `Granularity` | `NONE`, `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAYOFWEEK`, `DAY`, `HOUR`, `MINUTE`, `SECOND` | 日期粒度 |
 | `GrandTotalPosition` | `LEFT`, `RIGHT`, `TOP`, `BOTTOM` | 表格总计位置；行总计用左右，列总计用上下 |
 | `ContentSpaceSize` | `SMALL`, `MIDDLE`, `LARGE` | 卡片内容间距 |