Skip to content

DuckBI 0.2.1

Latest

Choose a tag to compare

@don2ccc don2ccc released this 02 Nov 00:39
· 3 commits to main since this release

0.2.1 — 把调好的分析存成模板

亮点

  • 新增第 6 个工具 duckbi_recipe:把一次调好的分析存成本地 Markdown 配方——口径说明、
    SQL 模板、参数声明、依赖表的结构指纹(列清单 + 行数)。下次一句话重跑,不用重新澄清"要什么、怎么算"。
  • 为什么不存裸 SQL:表名由文件名派生、列名会变、口径不在 SQL 里、参数被硬编码——
    这四种失效都不会报错,只给错数。配方把口径和指纹一起存下来,失效时能说清哪里变了。
  • 三道保险:
    • 保存前把 SQL 包成 SELECT * FROM (…) LIMIT 0 干跑 → 列名写错当场失败;
    • 重跑前校验表/列是否还在 → 失败时给出当前列清单并建议 revise;
    • 行数漂移不阻断执行,但在结果里标注"与上次不可直接比较"。
  • duckbi_query 新增 params:? 位置参数绑定,日期/名字不再拼进 SQL。
  • 新增配置 recipesDir(默认 <dataDir>/recipes);revise 升版本并把旧版归档到 .history/。

升级说明

  • 工具数 5 → 6,无破坏性改动。
  • 数据目录不受影响:表与已保存的 recipe 都在 ~/.dsh/duckbi 下,升级不丢。
  • 升级后必须重启 Harness,否则对话里看不到 duckbi_recipe(插件源码改动必须重启)。

安装 / 升级

dsh plugin --profile desktop add https://github.com/don2ccc/DuckBI-DSH/releases/download/v0.2.1/duckbi-dsh-plugin-duckbi-0.2.1.tgz
node "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\@duckbi\dsh-plugin-duckbi\install.mjs" --no-link

验证

  • 端到端 78/78(真实 cordis + 真实 DuckDB),较 0.2.0 的 64 项新增 14 项 recipe 断言
  • 图表冒烟 15/15,Excel/PDF 导出断言全部通过
  • 真数据验收:销售 CSV 存配方 → 默认参数重跑 → 换参数重跑,结果与口径一致

仓库附带(不在 npm 包里)

  • scripts/doa-to-long.mjs:把合并单元格的权限矩阵展开成可 SQL 查询的长表
  • scripts/report-sales.mjs:销售报表(PDF 4 页 + Excel 5 表 + 图)
  • scripts/report.mjs:报表时间戳改用本地时区

SHA256: 701b0253b76897ee80e33e28d5c50700324a038ac6a23dc11ac040ea73a5abcf