@chengxianglibra/dsh-data-analysis 0.1.1 → 0.1.2

package/skills/dsh-data-analysis-presentation/references/examples/charts.draft.json

@@ -0,0 +1,392 @@
+{
+  "schemaVersion": 1,
+  "title": "图表与探索样例（全部为合成演示数据）",
+  "datasets": [
+    {
+      "id": "charts-series",
+      "kind": "computed",
+      "path": "presentation-example/charts-series.dataset.json",
+      "sourceIds": []
+    },
+    {
+      "id": "charts-shares",
+      "kind": "computed",
+      "path": "presentation-example/charts-shares.dataset.json",
+      "sourceIds": []
+    },
+    {
+      "id": "charts-bins",
+      "kind": "computed",
+      "path": "presentation-example/charts-bins.dataset.json",
+      "sourceIds": []
+    },
+    {
+      "id": "charts-boxes",
+      "kind": "computed",
+      "path": "presentation-example/charts-boxes.dataset.json",
+      "sourceIds": []
+    },
+    {
+      "id": "charts-composition",
+      "kind": "computed",
+      "path": "presentation-example/charts-composition.dataset.json",
+      "sourceIds": []
+    },
+    {
+      "id": "charts-funnel",
+      "kind": "computed",
+      "path": "presentation-example/charts-funnel.dataset.json",
+      "sourceIds": []
+    },
+    {
+      "id": "charts-waterfall",
+      "kind": "computed",
+      "path": "presentation-example/charts-waterfall.dataset.json",
+      "sourceIds": []
+    },
+    {
+      "id": "charts-precision",
+      "kind": "computed",
+      "path": "presentation-example/charts-precision.dataset.json",
+      "sourceIds": []
+    }
+  ],
+  "sources": [],
+  "blocks": [
+    {
+      "id": "intro",
+      "kind": "markdown",
+      "text": "全部为合成演示数据。统计量在 Python 示例中预计算；探索只改变本次页面显示。"
+    },
+    {
+      "id": "gallery-line",
+      "kind": "chart",
+      "datasetId": "charts-series",
+      "chart": "line",
+      "x": "period",
+      "y": ["a", "b"],
+      "numericMode": "exact",
+      "preparedViews": [
+        {
+          "id": "prepared-stackedBar100",
+          "label": "stackedBar100",
+          "datasetId": "charts-shares",
+          "chart": "stackedBar100",
+          "x": "category",
+          "y": ["a", "b"],
+          "numericMode": "exact",
+          "bindings": {
+            "denominator": "denominator"
+          }
+        },
+        {
+          "id": "prepared-histogram",
+          "label": "histogram",
+          "datasetId": "charts-bins",
+          "chart": "histogram",
+          "x": "bin",
+          "y": ["frequency"],
+          "numericMode": "exact",
+          "bindings": {
+            "binStart": "lower",
+            "binEnd": "upper"
+          }
+        },
+        {
+          "id": "prepared-scatter",
+          "label": "scatter",
+          "datasetId": "charts-series",
+          "chart": "scatter",
+          "x": "coordinate",
+          "y": ["a"],
+          "numericMode": "exact",
+          "bindings": {
+            "size": "volume",
+            "label": "period",
+            "color": "segment"
+          }
+        },
+        {
+          "id": "prepared-waterfall",
+          "label": "waterfall",
+          "datasetId": "charts-waterfall",
+          "chart": "waterfall",
+          "x": "step",
+          "y": ["change"],
+          "numericMode": "exact",
+          "bindings": {
+            "start": "start",
+            "end": "end",
+            "role": "role"
+          }
+        },
+        {
+          "id": "prepared-boxPlot",
+          "label": "boxPlot",
+          "datasetId": "charts-boxes",
+          "chart": "boxPlot",
+          "x": "group",
+          "y": ["median"],
+          "numericMode": "exact",
+          "bindings": {
+            "minimum": "minimum",
+            "q1": "q1",
+            "q3": "q3",
+            "maximum": "maximum"
+          }
+        }
+      ],
+      "options": {
+        "showPoints": "always",
+        "series": {
+          "a": {
+            "lineStyle": "solid",
+            "role": "actual"
+          },
+          "b": {
+            "lineStyle": "dashed",
+            "role": "forecast"
+          }
+        },
+        "valueLabels": "none",
+        "referenceLines": [
+          {
+            "axis": "y",
+            "value": 20,
+            "label": "参考值"
+          }
+        ]
+      }
+    },
+    {
+      "id": "gallery-area",
+      "kind": "chart",
+      "datasetId": "charts-series",
+      "chart": "area",
+      "x": "period",
+      "y": ["a", "b"],
+      "numericMode": "exact"
+    },
+    {
+      "id": "gallery-stackedArea",
+      "kind": "chart",
+      "datasetId": "charts-series",
+      "chart": "stackedArea",
+      "x": "period",
+      "y": ["a", "b"],
+      "numericMode": "exact"
+    },
+    {
+      "id": "gallery-bar",
+      "kind": "chart",
+      "datasetId": "charts-series",
+      "chart": "bar",
+      "x": "period",
+      "y": ["a", "b"],
+      "numericMode": "exact"
+    },
+    {
+      "id": "gallery-horizontalBar",
+      "kind": "chart",
+      "datasetId": "charts-series",
+      "chart": "horizontalBar",
+      "x": "period",
+      "y": ["a", "b"],
+      "numericMode": "exact"
+    },
+    {
+      "id": "gallery-stackedBar",
+      "kind": "chart",
+      "datasetId": "charts-series",
+      "chart": "stackedBar",
+      "x": "period",
+      "y": ["a", "b"],
+      "numericMode": "exact"
+    },
+    {
+      "id": "gallery-stackedBar100",
+      "kind": "chart",
+      "datasetId": "charts-shares",
+      "chart": "stackedBar100",
+      "x": "category",
+      "y": ["a", "b"],
+      "numericMode": "exact",
+      "bindings": {
+        "denominator": "denominator"
+      }
+    },
+    {
+      "id": "gallery-horizontalStackedBar",
+      "kind": "chart",
+      "datasetId": "charts-series",
+      "chart": "horizontalStackedBar",
+      "x": "period",
+      "y": ["a", "b"],
+      "numericMode": "exact"
+    },
+    {
+      "id": "gallery-horizontalStackedBar100",
+      "kind": "chart",
+      "datasetId": "charts-shares",
+      "chart": "horizontalStackedBar100",
+      "x": "category",
+      "y": ["a", "b"],
+      "numericMode": "exact",
+      "bindings": {
+        "denominator": "denominator"
+      }
+    },
+    {
+      "id": "gallery-histogram",
+      "kind": "chart",
+      "datasetId": "charts-bins",
+      "chart": "histogram",
+      "x": "bin",
+      "y": ["frequency"],
+      "numericMode": "exact",
+      "bindings": {
+        "binStart": "lower",
+        "binEnd": "upper"
+      }
+    },
+    {
+      "id": "gallery-scatter",
+      "kind": "chart",
+      "datasetId": "charts-series",
+      "chart": "scatter",
+      "x": "coordinate",
+      "y": ["a"],
+      "numericMode": "exact",
+      "bindings": {
+        "size": "volume",
+        "label": "period",
+        "color": "segment"
+      }
+    },
+    {
+      "id": "gallery-heatmap",
+      "kind": "chart",
+      "datasetId": "charts-series",
+      "chart": "heatmap",
+      "x": "period",
+      "y": ["a", "b"],
+      "numericMode": "exact"
+    },
+    {
+      "id": "gallery-pie",
+      "kind": "chart",
+      "datasetId": "charts-composition",
+      "chart": "pie",
+      "x": "category",
+      "y": ["value"],
+      "numericMode": "exact",
+      "bindings": {
+        "share": "share"
+      }
+    },
+    {
+      "id": "gallery-leaderboard",
+      "kind": "chart",
+      "datasetId": "charts-composition",
+      "chart": "leaderboard",
+      "x": "category",
+      "y": ["value"],
+      "numericMode": "exact",
+      "bindings": {
+        "rank": "rank"
+      }
+    },
+    {
+      "id": "gallery-sparkline",
+      "kind": "chart",
+      "datasetId": "charts-series",
+      "chart": "sparkline",
+      "x": "period",
+      "y": ["a"],
+      "numericMode": "exact"
+    },
+    {
+      "id": "gallery-funnel",
+      "kind": "chart",
+      "datasetId": "charts-funnel",
+      "chart": "funnel",
+      "x": "stage",
+      "y": ["value"],
+      "numericMode": "exact",
+      "bindings": {
+        "share": "share"
+      }
+    },
+    {
+      "id": "gallery-waterfall",
+      "kind": "chart",
+      "datasetId": "charts-waterfall",
+      "chart": "waterfall",
+      "x": "step",
+      "y": ["change"],
+      "numericMode": "exact",
+      "bindings": {
+        "start": "start",
+        "end": "end",
+        "role": "role"
+      }
+    },
+    {
+      "id": "gallery-boxPlot",
+      "kind": "chart",
+      "datasetId": "charts-boxes",
+      "chart": "boxPlot",
+      "x": "group",
+      "y": ["median"],
+      "numericMode": "exact",
+      "bindings": {
+        "minimum": "minimum",
+        "q1": "q1",
+        "q3": "q3",
+        "maximum": "maximum"
+      }
+    },
+    {
+      "id": "gallery-dotted",
+      "kind": "chart",
+      "datasetId": "charts-series",
+      "chart": "line",
+      "x": "period",
+      "y": ["a", "b"],
+      "numericMode": "exact",
+      "options": {
+        "showPoints": "never",
+        "series": {
+          "a": {
+            "lineStyle": "dotted"
+          },
+          "b": {
+            "lineStyle": "solid",
+            "role": "comparison"
+          }
+        }
+      }
+    },
+    {
+      "id": "gallery-single",
+      "kind": "chart",
+      "datasetId": "charts-series",
+      "chart": "bar",
+      "x": "period",
+      "y": ["a"],
+      "numericMode": "exact",
+      "options": {
+        "valueLabels": "all"
+      }
+    },
+    {
+      "id": "gallery-precision",
+      "kind": "chart",
+      "datasetId": "charts-precision",
+      "chart": "line",
+      "x": "label",
+      "y": ["amount"],
+      "numericMode": "approximate"
+    }
+  ]
+}

package/skills/dsh-data-analysis-presentation/references/examples/comparison-selected.dataset.json

@@ -0,0 +1,24 @@
+{
+  "schemaVersion": 1,
+  "columns": [
+    { "id": "category", "label": "category", "type": "string", "nullable": false },
+    { "id": "baseline", "label": "baseline", "type": "int64", "nullable": false },
+    { "id": "current", "label": "current", "type": "int64", "nullable": false },
+    {
+      "id": "delta_current_minus_baseline",
+      "label": "delta_current_minus_baseline",
+      "type": "int64",
+      "nullable": false
+    },
+    {
+      "id": "decrease_baseline_minus_current",
+      "label": "decrease_baseline_minus_current",
+      "type": "int64",
+      "nullable": false
+    }
+  ],
+  "rows": [["A", "100", "50", "-50", "50"], ["B", "80", "50", "-30", "30"]],
+  "rowCount": 2,
+  "limit": 5000,
+  "truncated": false
+}

package/skills/dsh-data-analysis-presentation/references/examples/comparison-summary.dataset.json

@@ -0,0 +1,22 @@
+{
+  "schemaVersion": 1,
+  "columns": [
+    { "id": "scope", "label": "scope", "type": "string", "nullable": false },
+    { "id": "baseline", "label": "baseline", "type": "int64", "nullable": false },
+    { "id": "current", "label": "current", "type": "int64", "nullable": false },
+    {
+      "id": "delta_current_minus_baseline",
+      "label": "delta_current_minus_baseline",
+      "type": "int64",
+      "nullable": false
+    }
+  ],
+  "rows": [
+    ["全量", "200", "150", "-50"],
+    ["选中 A、B", "180", "100", "-80"],
+    ["其他 C", "20", "50", "30"]
+  ],
+  "rowCount": 3,
+  "limit": 5000,
+  "truncated": false
+}

package/skills/dsh-data-analysis-presentation/references/examples/comparison.dataset.json

@@ -0,0 +1,18 @@
+{
+  "schemaVersion": 1,
+  "columns": [
+    { "id": "category", "label": "category", "type": "string", "nullable": false },
+    { "id": "baseline", "label": "baseline", "type": "int64", "nullable": false },
+    { "id": "current", "label": "current", "type": "int64", "nullable": false },
+    {
+      "id": "delta_current_minus_baseline",
+      "label": "delta_current_minus_baseline",
+      "type": "int64",
+      "nullable": false
+    }
+  ],
+  "rows": [["A", "100", "50", "-50"], ["B", "80", "50", "-30"], ["C", "20", "50", "30"]],
+  "rowCount": 3,
+  "limit": 5000,
+  "truncated": false
+}

package/skills/dsh-data-analysis-presentation/references/examples/comparison.draft.json

@@ -0,0 +1,79 @@
+{
+  "schemaVersion": 1,
+  "title": "演示：减少项与其他项抵消后的净变化",
+  "datasets": [
+    {
+      "id": "full",
+      "kind": "computed",
+      "path": "presentation-example/comparison.dataset.json",
+      "sourceIds": []
+    },
+    {
+      "id": "selected",
+      "kind": "computed",
+      "path": "presentation-example/comparison-selected.dataset.json",
+      "sourceIds": []
+    },
+    {
+      "id": "summary",
+      "kind": "computed",
+      "path": "presentation-example/comparison-summary.dataset.json",
+      "sourceIds": []
+    }
+  ],
+  "sources": [],
+  "blocks": [
+    {
+      "id": "answer",
+      "kind": "markdown",
+      "text": "演示数据，不是真实业务结果。全量 baseline 200 → current 150，净变化 -50；变化率为 -25%，分母是 baseline 全量 200。A、B 的减少量合计 80，其他项 C 增加 30，抵消后净减少 50。这里是观测值的贡献分解，没有解释变化原因的证据。"
+    },
+    {
+      "id": "net-change",
+      "kind": "metric",
+      "datasetId": "summary",
+      "columnId": "current",
+      "rowIndex": 0,
+      "label": "全量当前值",
+      "comparisons": [
+        {
+          "label": "较基准",
+          "referenceColumnId": "baseline",
+          "deltaColumnId": "delta_current_minus_baseline",
+          "sentiment": "neutral"
+        }
+      ]
+    },
+    {
+      "id": "selection",
+      "kind": "markdown",
+      "text": "## 按减少量降序选取 Top 2\n从完整三项按 baseline - current 降序预选 A、B。图展示的是反向命名明确的减少量，不是全量净变化。writer 收到两行，rowCount = 2、truncated = false；这不表示未做预选。80 / 50 = 160% 是局部减少量与全量净减少的比值，不能称为覆盖率。"
+    },
+    {
+      "id": "selected-decreases",
+      "kind": "chart",
+      "datasetId": "selected",
+      "chart": "bar",
+      "x": "category",
+      "y": ["decrease_baseline_minus_current"],
+      "numericMode": "exact"
+    },
+    {
+      "id": "reconciliation",
+      "kind": "markdown",
+      "text": "## 全量与余项核对\n下面各表的 delta 均为 current - baseline。选中项 -80 + 其他项 +30 = 全量 -50；保留其他项的净贡献，不能将选中项的减少量 80 写成全量净减少。"
+    },
+    {
+      "id": "scope-values",
+      "kind": "table",
+      "datasetId": "summary",
+      "columns": ["scope", "baseline", "current", "delta_current_minus_baseline"]
+    },
+    {
+      "id": "all-values",
+      "kind": "table",
+      "datasetId": "full",
+      "columns": ["category", "baseline", "current", "delta_current_minus_baseline"]
+    }
+  ]
+}

package/skills/dsh-data-analysis-presentation/references/examples/computed-sources.draft.json

@@ -0,0 +1,35 @@
+{
+  "schemaVersion": 1,
+  "title": "演示：computed 的多个声明来源",
+  "datasets": [
+    {
+      "id": "quarter",
+      "kind": "computed",
+      "path": "presentation-example/computed.dataset.json",
+      "sourceIds": ["sales", "accounts"]
+    }
+  ],
+  "sources": [
+    {
+      "id": "sales",
+      "ref": {
+        "sessionId": "example-sales-session",
+        "artifactRef": "example-sales-artifact",
+        "findingId": "example-sales-finding"
+      }
+    },
+    {
+      "id": "accounts",
+      "ref": { "sessionId": "example-accounts-session", "artifactRef": "example-accounts-artifact" }
+    }
+  ],
+  "blocks": [
+    {
+      "id": "scope",
+      "kind": "markdown",
+      "text": "演示草稿：来源引用需替换为实际引用。声明多个 Artifact 不表示 computed 计算已经过验证；不可恢复的来源由 reader 如实显示。"
+    },
+    { "id": "values", "kind": "table", "datasetId": "quarter" },
+    { "id": "sources", "kind": "source", "sourceIds": ["sales", "accounts"] }
+  ]
+}

package/skills/dsh-data-analysis-presentation/references/examples/computed.dataset.json

@@ -0,0 +1,12 @@
+{
+  "schemaVersion": 1,
+  "columns": [
+    { "id": "month", "label": "月份", "type": "string", "nullable": false },
+    { "id": "count", "label": "数量", "type": "int64", "nullable": false },
+    { "id": "amount", "label": "金额", "type": "decimal", "nullable": true }
+  ],
+  "rows": [["2026-01", "12", "120.5000"], ["2026-02", "18", null], ["2026-03", "9", "90.0000"]],
+  "rowCount": 3,
+  "limit": 5000,
+  "truncated": false
+}

package/skills/dsh-data-analysis-presentation/references/examples/computed.draft.json

@@ -0,0 +1,57 @@
+{
+  "schemaVersion": 1,
+  "title": "演示：季度已有数量与精确金额",
+  "datasets": [
+    {
+      "id": "quarter",
+      "kind": "computed",
+      "path": "presentation-example/computed.dataset.json",
+      "sourceIds": []
+    }
+  ],
+  "sources": [],
+  "blocks": [
+    {
+      "id": "scope",
+      "kind": "markdown",
+      "text": "演示数据，不是真实业务分析。数量按月份展示，精确金额和缺失值在表格中保留。"
+    },
+    {
+      "id": "january",
+      "kind": "metric",
+      "datasetId": "quarter",
+      "columnId": "count",
+      "rowIndex": 0,
+      "label": "演示：一月数量"
+    },
+    {
+      "id": "trend-title",
+      "kind": "markdown",
+      "text": "## 数量的月度变化\n按示例已有月份顺序绘图，不对缺失金额补零。"
+    },
+    {
+      "id": "trend",
+      "kind": "chart",
+      "datasetId": "quarter",
+      "chart": "line",
+      "x": "month",
+      "y": ["count"],
+      "numericMode": "exact"
+    },
+    {
+      "id": "comparison",
+      "kind": "chart",
+      "datasetId": "quarter",
+      "chart": "bar",
+      "x": "month",
+      "y": ["count"],
+      "numericMode": "exact"
+    },
+    {
+      "id": "values",
+      "kind": "table",
+      "datasetId": "quarter",
+      "columns": ["month", "count", "amount"]
+    }
+  ]
+}

package/skills/dsh-data-analysis-presentation/references/examples/interaction-detail.dataset.json

@@ -0,0 +1,30 @@
+{
+  "schemaVersion": 1,
+  "columns": [
+    { "id": "category", "label": "category", "type": "string", "nullable": false },
+    { "id": "query_count", "label": "query_count", "type": "int64", "nullable": false }
+  ],
+  "rows": [
+    ["交互查询", "390"],
+    ["批量查询", "160"],
+    ["交互查询", "220"],
+    ["批量查询", "110"],
+    ["交互查询", "170"],
+    ["批量查询", "50"],
+    ["交互查询", "180"],
+    ["批量查询", "70"],
+    ["交互查询", "100"],
+    ["批量查询", "50"],
+    ["交互查询", "80"],
+    ["批量查询", "20"],
+    ["交互查询", "210"],
+    ["批量查询", "90"],
+    ["交互查询", "120"],
+    ["批量查询", "60"],
+    ["交互查询", "90"],
+    ["批量查询", "30"]
+  ],
+  "rowCount": 18,
+  "limit": 5000,
+  "truncated": false
+}