antvis/AVA v4 版本升级计划草案 #799
Description
🚀 [antvis/ava] v4 升级计划草案（RFC）
大家好，
我们计划推出 v4 版本，这是一个 不兼容的主版本升级。
旨在简化使用，精简概念。适配大模型生态。解决技术历史债，精简模块，弱化&去除边缘模块和 API。
本 Issue 用于公开讨论升级计划，欢迎大家提出建议、反馈痛点或参与设计。
📌 背景与动机
为什么需要v4？
- 当前版本存在哪些问题？
- 规则推荐有局限性，缺乏数据“理解”。
- 元信息冗余问题，元信息不全或未完全用到。
- 数据结构支持不完整，对于树状结构数据，图结构数据，流向数据等无法很好支持。
- 输出的 g2-spec 对于最新版本的 g2（v5.x.x）没有完全适配。
- 输出的 g2-spec 没有适配 gptvis 等基于 agent 的渲染库。
- 历史债问题，冗余模块太多，引用混乱。
- 技术趋势变化
- 需要更适配大模型生态。
- API 更简化，专注解决方案。弱化各种概念，降低使用门槛。
🔧 变更概览
| 模块 | 变更类型 | 说明 |
|---|---|---|
| packages/ava-react | Breaking | 移除，后续不再提供 react 相关组件封装，包括 InsightCard 组件 |
| packages/ava/src/advisor | Breaking | 重构调用流程，弱化 ckb 概念，加入模型链路调用 |
| packages/ava/src/ckb | Breaking | 移除，内置到 advisor 中，并且后续会融合到知识库中 |
| packages/ava/src/common | Breaking | 移除，合并到 packages/ava/src/types 下 |
| packages/ava/src/data | Breaking | 重构，重构 DataFrame 对象，statistics 模块会继续导出 |
| packages/ava/src/insight | Breaking | 不再导出模块，后续会作为 advisor 中的增强功能 |
| packages/ava/src/ntv | Breaking | 移除，并不再导出模块 |
| packages/ava/src/utils | Breaking | 重构，不会导出模块 |
| packages/ava/src/parser | New | 新增模块，基于大模型进行文本解析 |
| packages/ava/src/types | New | 新增模块，部分导出 |
| packages/ava/src/constants | New | 新增模块，部分导出 |
🗺️ 升级路线图（Roadmap）
| 阶段 | 时间 | 内容 |
|---|---|---|
| RFC 讨论 | 2025.9.22 – 10.10 | 收集团队与社区反馈 |
| Alpha 发布 | 2025.10.15 | alpha.x 发布 实现核心变更，供测试 |
| Beta 发布 | 2025.x.x | beta.x 稳定 API，文档完善 |
| 正式版发布 | 2025.x.x | v4.0.0 |
🤝 如何参与？
欢迎你在评论区反馈：
- 你最关心的 breaking change 是什么？
- 是否有未覆盖的使用场景？
- 你希望 v4 解决哪些问题？
我们也欢迎：
- 👩💻 贡献早期测试
- 📝 协助编写迁移文档
- 🔍 Review 设计提案
📌 最后更新：2025年9月22日