chore: 优化 scale skill

lxfu1 · lxfu1 · commit 390baf67cde7 · 2026-04-09T14:23:44.000+08:00
diff --git a/cli/index/full.index.json b/cli/index/full.index.json
@@ -1187,14 +1187,15 @@
         "在图表中添加标注层"
       ],
       "anti_patterns": [
-        "只有单个 Mark 时不需要 view 容器，直接用对应 type 即可"
+        "只有单个 Mark 时不需要 view 容器，直接用对应 type 即可",
+        "children 中嵌套 type: 'view'——当某个子 Mark 需要独立数据时，直接在该 Mark 上指定 data 字段，而非再套一层 view + children"
       ],
       "related": [
         "g2-core-chart-init",
         "g2-comp-annotation",
         "g2-comp-facet-rect"
       ],
-      "embedding_text": "Title: G2 视图组合（view + children）\nDescription:  G2 v5 通过 type: 'view' 容器和 children 数组实现多 Mark 叠加、\nTags: view, children, 视图组合, 多Mark叠加, layer, 复合图表, spec\nUse Cases: 在同一坐标系中叠加多种图形（折线+散点、面积+折线）; 为多个子 Mark 共享数据源; 在图表中添加标注层\nAnti-patterns: 只有单个 Mark 时不需要 view 容器，直接用对应 type 即可\n## 核心概念\n\n```\nchart.options({\n  type: 'view',      // 容器类型\n   [...],       // 父级数据（子 Mark 可继承）\n  encode: {...},     // 父级编码（子 Mark 可继承）\n  children: [        // 子 Mark 列表（按顺序渲染，后面的在上层）\n    { type: 'area', ... },\n    { type: 'line', ... },\n    { type: 'point', ... },\n  ],\n});\n```\n\n**数据继承规则**：\n- 子 Mark 若未指定 `data`，继承父级 `data`\n- 子 Mark 若未指定 `encode`，继承父级 `encode` 中对应通道\n\n\n## 常见错误与修正\n"
+      "embedding_text": "Title: G2 视图组合（view + children）\nDescription:  G2 v5 通过 type: 'view' 容器和 children 数组实现多 Mark 叠加、\nTags: view, children, 视图组合, 多Mark叠加, layer, 复合图表, spec\nUse Cases: 在同一坐标系中叠加多种图形（折线+散点、面积+折线）; 为多个子 Mark 共享数据源; 在图表中添加标注层\nAnti-patterns: 只有单个 Mark 时不需要 view 容器，直接用对应 type 即可; children 中嵌套 type: 'view'——当某个子 Mark 需要独立数据时，直接在该 Mark 上指定 data 字段，而非再套一层 view + children\n## 核心概念\n\n```\nchart.options({\n  type: 'view',      // 容器类型\n   [...],       // 父级数据（子 Mark 可继承）\n  encode: {...},     // 父级编码（子 Mark 可继承）\n  children: [        // 子 Mark 列表（按顺序渲染，后面的在上层）\n    { type: 'area', ... },\n    { type: 'line', ... },\n    { type: 'point', ... },\n  ],\n});\n```\n\n**数据继承规则**：\n- 子 Mark 若未指定 `data`，继承父级 `data`\n- 子 Mark 若未指定 `encode`，继承父级 `encode` 中对应通道\n\n\n## 常见错误与修正\n"
     },
     {
       "id": "g2-data-ema",
diff --git a/cli/index/g2.index.json b/cli/index/g2.index.json
@@ -1187,14 +1187,15 @@
         "在图表中添加标注层"
       ],
       "anti_patterns": [
-        "只有单个 Mark 时不需要 view 容器，直接用对应 type 即可"
+        "只有单个 Mark 时不需要 view 容器，直接用对应 type 即可",
+        "children 中嵌套 type: 'view'——当某个子 Mark 需要独立数据时，直接在该 Mark 上指定 data 字段，而非再套一层 view + children"
       ],
       "related": [
         "g2-core-chart-init",
         "g2-comp-annotation",
         "g2-comp-facet-rect"
       ],
-      "embedding_text": "Title: G2 视图组合（view + children）\nDescription:  G2 v5 通过 type: 'view' 容器和 children 数组实现多 Mark 叠加、\nTags: view, children, 视图组合, 多Mark叠加, layer, 复合图表, spec\nUse Cases: 在同一坐标系中叠加多种图形（折线+散点、面积+折线）; 为多个子 Mark 共享数据源; 在图表中添加标注层\nAnti-patterns: 只有单个 Mark 时不需要 view 容器，直接用对应 type 即可\n## 核心概念\n\n```\nchart.options({\n  type: 'view',      // 容器类型\n   [...],       // 父级数据（子 Mark 可继承）\n  encode: {...},     // 父级编码（子 Mark 可继承）\n  children: [        // 子 Mark 列表（按顺序渲染，后面的在上层）\n    { type: 'area', ... },\n    { type: 'line', ... },\n    { type: 'point', ... },\n  ],\n});\n```\n\n**数据继承规则**：\n- 子 Mark 若未指定 `data`，继承父级 `data`\n- 子 Mark 若未指定 `encode`，继承父级 `encode` 中对应通道\n\n\n## 常见错误与修正\n"
+      "embedding_text": "Title: G2 视图组合（view + children）\nDescription:  G2 v5 通过 type: 'view' 容器和 children 数组实现多 Mark 叠加、\nTags: view, children, 视图组合, 多Mark叠加, layer, 复合图表, spec\nUse Cases: 在同一坐标系中叠加多种图形（折线+散点、面积+折线）; 为多个子 Mark 共享数据源; 在图表中添加标注层\nAnti-patterns: 只有单个 Mark 时不需要 view 容器，直接用对应 type 即可; children 中嵌套 type: 'view'——当某个子 Mark 需要独立数据时，直接在该 Mark 上指定 data 字段，而非再套一层 view + children\n## 核心概念\n\n```\nchart.options({\n  type: 'view',      // 容器类型\n   [...],       // 父级数据（子 Mark 可继承）\n  encode: {...},     // 父级编码（子 Mark 可继承）\n  children: [        // 子 Mark 列表（按顺序渲染，后面的在上层）\n    { type: 'area', ... },\n    { type: 'line', ... },\n    { type: 'point', ... },\n  ],\n});\n```\n\n**数据继承规则**：\n- 子 Mark 若未指定 `data`，继承父级 `data`\n- 子 Mark 若未指定 `encode`，继承父级 `encode` 中对应通道\n\n\n## 常见错误与修正\n"
     },
     {
       "id": "g2-data-ema",
diff --git a/skills/g2/references/core/g2-core-view-composition.md b/skills/g2/references/core/g2-core-view-composition.md
@@ -30,6 +30,7 @@ use_cases:
 
 anti_patterns:
   - "只有单个 Mark 时不需要 view 容器，直接用对应 type 即可"
+  - "children 中嵌套 type: 'view'——当某个子 Mark 需要独立数据时，直接在该 Mark 上指定 data 字段，而非再套一层 view + children"
 
 difficulty: "intermediate"
 completeness: "full"
@@ -159,7 +160,54 @@ chart.options({
 });
 ```
 
-### 错误 2：子 Mark 的 encode 字段名与数据不匹配
+### 错误 2：children 中嵌套 view（为子 Mark 单独变换数据时的常见误区）
+
+```javascript
+// ❌ 错误：在 children 里再套一层 type:'view' + children
+chart.options({
+  type: 'view',
+  data,
+  children: [
+    { type: 'line', encode: { x: 'time', y: 'value' } },
+    {
+      type: 'view',                        // ❌ 不必要的嵌套 view
+      data: data.map(d => ({              // 只是想用派生数据
+        time: d.time,
+        min: d.value - 0.1,
+        max: d.value + 0.1,
+      })),
+      children: [
+        { type: 'rangeY', encode: { x: 'time', y: 'min', y1: 'max' } },
+      ],
+    },
+  ],
+});
+
+// ✅ 正确：直接在子 Mark 上指定 data，无需嵌套 view
+chart.options({
+  type: 'view',
+  data,
+  children: [
+    { type: 'line', encode: { x: 'time', y: 'value' } },
+    {
+      type: 'rangeY',
+      data: data.map(d => ({             // ✅ 直接在 Mark 上声明独立 data
+        time: d.time,
+        min: d.value - 0.1,
+        max: d.value + 0.1,
+      })),
+      encode: { x: 'time', y: 'min', y1: 'max' },
+      style: { fillOpacity: 0.1 },
+    },
+  ],
+});
+```
+
+**规则**：`children` 数组的每个元素必须是 Mark（`line`/`point`/`interval` 等），
+当某个 Mark 需要独立或派生数据时，在该 Mark 节点上直接写 `data`，而不是再包一层 `view`。
+G2 不支持在 `children` 内嵌套 `view`。
+
+### 错误 3：子 Mark 的 encode 字段名与数据不匹配
 ```javascript
 // ❌ 错误：父级和子级 encode 的字段名应保持一致
 chart.options({
diff --git a/skills/g2/references/recipes/g2-recipe-timeseries-compare.md b/skills/g2/references/recipes/g2-recipe-timeseries-compare.md
@@ -116,9 +116,7 @@ chart.options({
     y: 'count',
     color: 'metric',
   },
-  scale: {
-    x: { type: 'time' },          // 字符串日期需显式声明
-  },
+  // 无需 scale.x.type，data 中已使用 new Date()，G2 自动识别
   labels: [
     {
       text: 'metric',
@@ -178,9 +176,6 @@ chart.options({
       style: { lineWidth: 2 },
     },
   ],
-  scale: {
-    x: { type: 'time' },
-  },
   axis: {
     x: { labelFormatter: 'YYYY-MM' },
     y: { labelFormatter: (v) => `${(v/10000).toFixed(1)}万` },
@@ -238,25 +233,26 @@ chart.options({
 
 ## 常见错误与修正
 
-### 错误：字符串日期未声明 time scale 导致排序错乱
+### 错误：日期用字符串而非 Date 对象，导致排序错乱
 ```javascript
-// ❌ 错误：字符串日期默认被当作分类，按数据原始顺序排列
+// ❌ 错误：字符串日期在数据乱序时 x 轴按原始顺序渲染
 chart.options({
   type: 'line',
   data: [
     { date: '2024-03', value: 130 },
     { date: '2024-01', value: 100 },   // 乱序数据
   ],
   encode: { x: 'date', y: 'value' },
-  // 缺少 scale: { x: { type: 'time' } }，x 轴会按数据顺序显示
 });
 
-// ✅ 正确：声明 time scale，G2 自动按时间排序
+// ✅ 正确：转为 Date 对象并排序，G2 自动按时间处理，无需 scale.x.type
+const data = rawData
+  .map(d => ({ ...d, date: new Date(d.date) }))
+  .sort((a, b) => a.date - b.date);
 chart.options({
   type: 'line',
   data,
   encode: { x: 'date', y: 'value' },
-  scale: { x: { type: 'time' } },   // ✅ 字符串日期需要显式声明
 });
 ```
 
diff --git a/skills/g2/references/scales/g2-scale-time.md b/skills/g2/references/scales/g2-scale-time.md
@@ -99,40 +99,61 @@ chart.options({
 });
 ```
 
-## 字符串日期需显式声明 type
+## 字符串日期（推荐转为 Date 对象）
+
+G2 v5 对 `YYYY-MM-DD` 格式的字符串有一定自动识别能力，但行为依赖内部推断，**不稳定**。
+推荐在数据预处理阶段统一转为 `Date` 对象，避免歧义：
 
 ```javascript
-// 数据中日期是字符串格式
-const data = [
+// ✅ 推荐：预处理时转为 Date 对象
+const rawData = [
   { date: '2024-01-01', value: 100 },
   { date: '2024-02-01', value: 130 },
 ];
+const data = rawData.map(d => ({ ...d, date: new Date(d.date) }));
 
 chart.options({
   type: 'line',
   data,
   encode: { x: 'date', y: 'value' },
-  scale: {
-    x: { type: 'time' },   // 必须显式声明，否则被当作 ordinal scale
-  },
+  // 无需 scale.x.type，G2 自动识别 Date 对象为 Time Scale
 });
 ```
 
+**不要**在字符串日期上显式写 `scale: { x: { type: 'time' } }`，这是多余的配置，
+且在某些场景（如 fold 后数据类型变化）会引发渲染异常。
+
 ## 常见错误与修正
 
-### 错误 1：日期字符串未声明 time scale 导致排序错误
+### 错误 1：显式声明 type: 'time'（不必要且有风险）
 ```javascript
-// ❌ 错误：字符串日期不声明 type: 'time'，会被当作分类数据，顺序可能错乱
+// ❌ 不推荐：在字符串日期上显式写 type: 'time'
+chart.options({
+  type: 'line',
+  data: [{ date: '2024-01-01', value: 100 }],
+  encode: { x: 'date', y: 'value' },
+  scale: { x: { type: 'time' } },   // ❌ 多余，可能引发异常
+});
+
+// ✅ 正确：转为 Date 对象，让 G2 自动处理
+const data = rawData.map(d => ({ ...d, date: new Date(d.date) }));
+chart.options({
+  type: 'line',
+  data,
+  encode: { x: 'date', y: 'value' },
+});
+```
+
+### 错误 2：数据乱序导致折线错乱
+```javascript
+// ❌ 错误：数据顺序混乱，折线会连错
 const data = [
-  { date: '2024-03-01', value: 110 },
-  { date: '2024-01-01', value: 100 },  // 数据无序
+  { date: new Date('2024-03-01'), value: 110 },
+  { date: new Date('2024-01-01'), value: 100 },  // 时间倒序
 ];
-chart.options({ type: 'line', data, encode: { x: 'date', y: 'value' } });
-// 结果：x 轴顺序是数据原始顺序，不按时间排序
-
-// ✅ 方案 1：将字符串转为 Date 对象（推荐）
-const processedData = data.map(d => ({ ...d, date: new Date(d.date) }));
 
-// ✅ 方案 2：显式声明 time scale
-chart.options({ scale: { x: { type: 'time' } } });
+// ✅ 正确：按时间排序后再传入
+const data = rawData
+  .map(d => ({ ...d, date: new Date(d.date) }))
+  .sort((a, b) => a.date - b.date);
 ```
diff --git a/web/server.js b/web/server.js
@@ -168,11 +168,8 @@ function buildMessages(query, systemPrompt, intent, currentCode) {
 
 // ── AI SDK (unified) ──────────────────────────────────────────────────────────
 
-const {
-  callAI,
-  AgentLoop,
-  PROVIDER_CONFIG: SDK_PROVIDER_CONFIG
-} = require('../eval/utils/ai-sdk');
+const { callAI, AgentLoop } = require('../eval/utils/ai-sdk');
+const { PROVIDERS } = require('../eval/utils/provider-registry');
 const ProviderRegistry = require('../eval/utils/provider-registry');
 const {
   TOOLS,
@@ -191,7 +188,7 @@ function resolveProviderModel(reqProvider, reqModel) {
   const model =
     reqModel ||
     process.env.AI_MODEL ||
-    SDK_PROVIDER_CONFIG[provider]?.defaultModel ||
+    PROVIDERS[provider]?.defaultModel ||
     'qwen3-coder-480b-a35b-instruct';
   return { provider, model };
 }
