[Feature] Support for LLM-optimized Declarative Protocol (ECharts-Lite) in Markdown/JSON
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 5/5
- Tempo stimato
- Più di una settimana
- Idoneità per principianti
- 25/100
- Tipo di issue
- Funzionalità
- Chiarezza
- Da chiarire
- Stato di attività
- Tranquilla
- Stack tecnologico
- json, markdown, typescript
- Ambito
- data-visualization
Direzione di ricerca
Start with the proposed echarts.renderLite(dom, liteOption, theme) entry point and the echarts-lite/v1 schema described in the issue. Define the Markdown/JSON input and strict validation boundaries, then trace how chart types and dataset dimensions should expand into an ECharts option. Done means a consistent protocol with smart defaults and clear validation errors.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
What problem does this feature solve?
[Context & Rationale]
With the rapid integration of Large Language Models (LLMs) into data analysis and BI tools, ECharts has become a primary target for AI-generated visualizations. However, there is a significant "impedance mismatch" between LLM outputs and the current ECharts option structure. The existing API, while powerful and comprehensive, is highly verbose for LLMs, leading to frequent "hallucinations" in nested JSON structures, high token consumption, and instability in rendering styling details.
[End User Experience]
The goal is to enable a "Zero-Config" experience for AI-native applications. Developers should be able to pass a simplified, intent-based Markdown or JSON structure directly from the LLM to ECharts. The renderer should intelligently handle the "boilerplate" (like tooltips, basic axis styling, and grid layouts) based on the chart type and data, allowing the LLM to focus solely on the data and the high-level visual intent.
[Why it cannot be easily dealt with existing APIs]
While users can write custom "translation" layers, every developer is currently reinventing the wheel. A fragmented ecosystem of "ECharts-Lite" parsers leads to inconsistent user experiences across different AI platforms. By introducing a standardized, declarative "Lite" protocol within the ECharts ecosystem, we can:
Lower the barrier for AI agents to interact with ECharts.
Optimize performance by reducing the payload size in LLM streaming.
Ensure visual consistency by separating data (from LLM) and theme/style (from the developer/ECharts defaults).
What does the proposed API look like?
We propose a Simplified Declarative Schema (e.g., echarts-lite) that can be used either as a standalone JSON or within a Markdown code block. This schema prioritizes a flat structure and the dataset component.
Proposed Schema Example:
JSON
{
"protocol": "echarts-lite/v1",
"type": "line",
"title": "User Growth Trend",
"data": [
["Month", "Users", "Retention"],
["2025-01", 150, 0.85],
["2025-02", 230, 0.82],
["2025-03", 224, 0.88]
],
"options": {
"smooth": true,
"stack": false,
"showSymbol": "auto"
},
"enhance": ["tooltip", "legend", "toolbox"]
}
Implementation Suggestion:
A new static method or a lightweight plugin, e.g., echarts.renderLite(dom, liteOption, theme), which:
Expands the lite protocol into a full echarts.option object internally.
Injects smart defaults for missing UI configurations (e.g., automatically generating series based on the data dimensions).
Validates the input using a strict JSON Schema to provide clear error messages for LLM debugging.
- Lingua principale
- TypeScript
- Stelle
- 67.7k
- Fork
- 19.9k
- Metriche di merge delle PR
- Nessuna PR unita negli ultimi 30g
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Ha un modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di apache/echarts
-
[Bug] String formatter templates only replace the first occurrence of `{a}`/`{b}`/`{c}`Forse già presa Una pull request collegata a questa issue è aperta o già unita. Apertaen pending
Difficoltà 2/5 1-3 ore Idoneità per principianti 80/100
-
[Bug] Inverse axis collapses the grid with outerBoundsContain when a tick is near the axis edgeForse già presa Una pull request collegata a questa issue è aperta o già unita. Apertaen pending
Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100
-
en pending
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
-
en pending
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
-
[Bug] The zoom cursor in the toolbox area is incorrectForse già presa @waterWang l’ha presa 98 giorni fa. Apertabug en pending
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100
Tutte le issue di apache/echarts
Issue simili
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 83/100
pollen-robotics/reachy-mini-desktop-app#341 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
I maintainer di solito rispondono entro 2 giorni
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 77/100
mike-north/AgentMonitors#648 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
vercel-labs/ui#700 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
I maintainer di solito rispondono entro 2 giorni