Repository navigation
Releases
Releases · wywincl/data-analysis-agent
v0.1.1
v0.1.1
版本对齐发布:包名变更为 dsh-data-analysis-agent 后,将 package version 同步到 0.1.1。自 v0.1.0(181d66b)以来无代码变更。
v0.1.0 → v0.1.1
- 版本号 0.1.0 → 0.1.1(package.json / package-lock.json)
v0.1.0 包含(自项目首个发布以来)
- 语义层本体构件:实体具名关系(relationships, cardinality)、主键(key)、枚举值域(values)、实体级
extends继承 - 语义层体检新规则:unknown-key-column / relationship-column-missing / enum-filter-value-unknown
- 工作台 UI 重构:sub-tab 分区、吸底保存栏、卡片式语义编辑器、字段保全
- 修复:settings 残留 scaffoldRequest 导致的启动重放
- 数据源:sslSkipVerify(自签 TLS)、duckdb 加固、可移植相对路径
v0.1.0 — 首个版本
dsh-data-analysis-agent v0.1.0
面向 DeepSeek Harness (dsh) 的数据分析智能体插件首个版本:多数据源接入、带护栏的 text2SQL、声明式语义层、Web 工作台、对话内 ECharts 可视化与自包含 HTML 导出。双面插件(Host 半 + Browser 半),不修改官方仓库任何代码。
功能亮点
- 多数据源:SQLite / MySQL / PostgreSQL / ClickHouse / DuckDB / Spark(Mock 或 Livy REST 真后端),统一
DataSourceProvider接口,Schema 内省 + TTL 缓存 - text2SQL 护栏:
node-sql-parser解析级白名单(仅单条 SELECT/WITH),LIMIT 自动注入与收敛,语句级超时、行数硬上限、审批门覆盖全部 SQL 执行路径 - 语义层:YAML 声明式 entities/terms/metrics(轻量分析本体,OBDA 风格),
include多文件拆分 +extends继承,fs.watch热加载,语义体检(lint) - 统计分析:profile / topn / correlation / distribution / insight,NULL/空值不参与统计
- 可视化:ECharts 6 八种图型,Host 侧构建完整 option,SVG 渲染,重启后持久化重放
- 导出:单图自包含 HTML(离线交互 + 跨图筛选)、PNG(2x)、CSV、仪表板;模型生成的字符串在进入 innerHTML 前统一转义
- Web 工作台:数据源连接管理(保存即热生效)、语义层可视化编辑(T0–T4:预览/摘要/脚手架/表单编辑)
- 安全:凭据经
!!js process.env.*注入不回显,TLS 默认校验证书(自签名需显式sslSkipVerify),查询审计与成本计量
快速开始
git clone https://github.com/wywincl/data-analysis-agent.git
cd data-analysis-agent
# 1. 依赖 + 链接本地 dsh checkout(不在常见位置时可用 DSH_CHECKOUT 环境变量或 CLI 参数指定)
npm install && npm run setup:links
# 2. 构建 + 生成演示库
npm run build && npm run demo:seed
# 3. 以 profile 方式安装到独立 DSH_HOME(详见 README)本地开发可用 dev/cordis.overlay.yml overlay 直接加载构建产物,配置中的路径均为相对路径或占位符,无任何机器特定信息。
测试
Vitest 22 个测试文件、206 个用例全绿;npm run typecheck / npm run build 通过。