Repository navigation
0.2.1 — 把调好的分析存成模板
亮点
- 新增第 6 个工具
duckbi_recipe:把一次调好的分析存成本地 Markdown 配方——口径说明、
SQL 模板、参数声明、依赖表的结构指纹(列清单 + 行数)。下次一句话重跑,不用重新澄清"要什么、怎么算"。 - 为什么不存裸 SQL:表名由文件名派生、列名会变、口径不在 SQL 里、参数被硬编码——
这四种失效都不会报错,只给错数。配方把口径和指纹一起存下来,失效时能说清哪里变了。 - 三道保险:
- 保存前把 SQL 包成
SELECT * FROM (…) LIMIT 0干跑 → 列名写错当场失败; - 重跑前校验表/列是否还在 → 失败时给出当前列清单并建议
revise; - 行数漂移不阻断执行,但在结果里标注"与上次不可直接比较"。
- 保存前把 SQL 包成
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