-
-
- 
-
-- Introduction • - Demo • - Tutorial • - API• - OpenApi -
+| Skill | Tasks | +| --- | --- | +| [vchart-development-assistant](skills/vchart-development-assistant/SKILL.md) | Chart generation, diagnosis, image replication and React integration | +| [vtable-development-assistant](skills/vtable-development-assistant/SKILL.md) | List tables, pivot tables/charts, interactions and diagnosis | - - -[](https://www.npmjs.com/package/@visactor/vmind) -[](https://www.npmjs.com/package/@visactor/vmind) -[](https://github.com/VisActor/VMind/blob/main/CONTRIBUTING.md#your-first-pull-request) +Each skill includes its instructions, local references, templates and scripts. No separate VisActor CLI, MCP server, model key or hosted VisActor API is required. The host agent supplies the model. - [](https://github.com/visactor/vmind/blob/main/LICENSE) +**Recommended: use the Skills directly in Codex or Claude Code.** Your agent provides model access and tool execution. Other compatible agents may also use these Skills, but do not have dedicated setup instructions here. -
- Edit src/App.tsx and save to test HMR
-
Click on the Vite and React logos to learn more
- - ); -} - -export default App; diff --git a/common/autoinstallers/create/templates/library/vite/src/assets/react.svg b/common/autoinstallers/create/templates/library/vite/src/assets/react.svg deleted file mode 100644 index 6c87de9b..00000000 --- a/common/autoinstallers/create/templates/library/vite/src/assets/react.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/common/autoinstallers/create/templates/library/vite/src/index.css b/common/autoinstallers/create/templates/library/vite/src/index.css deleted file mode 100644 index 2c3fac68..00000000 --- a/common/autoinstallers/create/templates/library/vite/src/index.css +++ /dev/null @@ -1,69 +0,0 @@ -:root { - font-family: Inter, system-ui, Avenir, Helvetica, Arial, sans-serif; - line-height: 1.5; - font-weight: 400; - - color-scheme: light dark; - color: rgba(255, 255, 255, 0.87); - background-color: #242424; - - font-synthesis: none; - text-rendering: optimizeLegibility; - -webkit-font-smoothing: antialiased; - -moz-osx-font-smoothing: grayscale; - -webkit-text-size-adjust: 100%; -} - -a { - font-weight: 500; - color: #646cff; - text-decoration: inherit; -} -a:hover { - color: #535bf2; -} - -body { - margin: 0; - display: flex; - place-items: center; - min-width: 320px; - min-height: 100vh; -} - -h1 { - font-size: 3.2em; - line-height: 1.1; -} - -button { - border-radius: 8px; - border: 1px solid transparent; - padding: 0.6em 1.2em; - font-size: 1em; - font-weight: 500; - font-family: inherit; - background-color: #1a1a1a; - cursor: pointer; - transition: border-color 0.25s; -} -button:hover { - border-color: #646cff; -} -button:focus, -button:focus-visible { - outline: 4px auto -webkit-focus-ring-color; -} - -@media (prefers-color-scheme: light) { - :root { - color: #213547; - background-color: #ffffff; - } - a:hover { - color: #747bff; - } - button { - background-color: #f9f9f9; - } -} diff --git a/common/autoinstallers/create/templates/library/vite/src/main.tsx b/common/autoinstallers/create/templates/library/vite/src/main.tsx deleted file mode 100644 index b3ad8a59..00000000 --- a/common/autoinstallers/create/templates/library/vite/src/main.tsx +++ /dev/null @@ -1,11 +0,0 @@ -import React from 'react'; -import ReactDOM from 'react-dom'; -import App from './App.tsx'; -import './index.css'; - -ReactDOM.render( -
-
-## Obtain DeepSeek API Key
-
-Register with DeepSeek and create your API key on the [DeepSeek API](https://platform.deepseek.com/api_keys) official website.
-
-
-
-## Configure Cursor
-
-Official website: https://www.cursor.com/
-
-Download and register, open your VChart project with Cursor, and configure Cursor.
-
-Using DeepSeek-V3 as an example, its API model name is `deepseek-chat`, and the API address is https://api.deepseek.com/v1. For more details, see the [API usage official website](https://api-docs.deepseek.com/zh-cn).
-
-Create a new model on the model page, set the corresponding API address and model name.
-
-
-
-Of course, you can also use any other AI model; here, we use DeepSeek.
-
-# Inject Official Tutorial into @Docs
-
-# Practical Verification
-
-## VTable Test
-
-VTable (https://www.visactor.io/vtable/; https://www.visactor.com/vtable/) is a powerful table component in the VisActor visualization library. It is designed to meet diverse data presentation needs, offering high flexibility and customizability. Whether it's simple data listing or complex data analysis display scenarios, VTable can provide excellent solutions.
-
-VTable has the following core features:
-
-- Supports various table types: basic tables, pivot tables, transposed tables, pivot charts, etc.
-
-- Powerful interaction features: sorting, filtering, row and column dragging, cell editing, etc.
-
-- Rich cell types: text, charts, progress bars, checkboxes, sparklines, etc.
-
-- High-performance rendering: supports smooth display of millions of data
-
-- Multi-platform adaptation: perfect support for mainstream frameworks like Vue, React
-
-### Invoke AI Interaction Panel in Cursor and Generate Code
-
-After setting up the project environment, use `cmd + i` to invoke the AI interaction panel. We directly let AI generate a basic table code snippet for inserting VTable.
-
-
-
-However, the initial generation result shows that AI does not recognize VTable's `ListTable`, possibly due to the inability to accurately recognize VTable's ListTable configuration.
-
-
-
-### Inject Official Tutorial into @Docs
-
-To solve the above problem, we inject the official tutorial into @Docs.
-
-
-
-Explicitly specify `VisActor VTable` in the `prompt` in @Docs. After this step, we are pleasantly surprised to find that AI can correctly write the implementation logic according to the `option` in VTable.
-
-
-
-### Code Application and Effect Display
-
-Copy the generated code into the corresponding file, run the project, and you can see the initial effect, with the table correctly generated.
-
-
-
-Then, we continue to let AI modify the table style. AI provided reasonable modification suggestions,
-
-
-
-After running the project again, we got a display effect that better meets the requirements:
-
-
-
-## VChart Test
-
-### Add a Bar Chart
-
-Invoke AI interaction with the `cmd+i` command, and let AI help us generate a simple bar chart code first.
-
-
-
-Directly apply this spec, and we check the result; a simple bar chart is rendered. It can be seen that DeepSeek has a certain understanding of VChart, and simple charts can be directly added. Let's try a more complex scenario.
-
-
-
-### Complex Scenario, Inject Docs
-
-We hope to add an average auxiliary line on the y-axis, check the result, but the result is incorrect. Upon closer inspection, it can be found that although the markLine is written as if it is correct, the spec does not conform to the specification, and the average line is calculated. We solve this problem by injecting docs.
-
-
-
-
-
-#### Set Docs
-
-Enter the Cursor settings page, select `Features`, add new docs, the docs address is https://visactor.com/vchart (https://visactor.io/vchart); you can also directly add through @Docs on the editing page.
-
-
-
-### Experimental Results
-
-By editing again with the newly added docs, the correct result can be obtained!
-
-
-
-
-
-## VStory Test
-
-VStory (GitHub: https://github.com/VisActor/VStory/; site: https://www.visactor.io/vstory/, https://www.visactor.com/vstory/) is a narrative-oriented visualization development framework that integrates the capabilities of all VisActor visualization components, making it more challenging to use. We conduct a simple test.
-
-Invoke AI interaction with the `cmd+i` command, and let AI help us generate a simple dashboard demo first.
-
-
-
-It can be found that it is completely incorrect because DeepSeek uses data from 2023, and VStory had not been released at that time, so it does not know how to use it. At this point, we need to let it read the documentation to learn.
-
-### Inject Docs
-
-We solve this problem by injecting docs.
-
-Enter the Cursor settings page, select `Features`, add new docs, the docs address is https://visactor.com/vstory/guide/tutorial_docs/VStory_Website_Guide; you can also directly add through @Docs on the editing page.
-
-
-
-### Experimental Results
-
-By editing again with the newly added docs, the correct result can be obtained!
-
-
-
-
-
-**Since VStory uses VChart, VTable, and VRender, to achieve better results, you should add the documentation of VChart, VTable, and VRender to the context simultaneously.**
-
-# Simple Summary
-
-1. Improve Development Efficiency
-
-- Quick Access: Directly access VisActor API documentation through Cursor
-
-- Intelligent Suggestions: Precise code completion based on VisActor documentation
-
-2. Enhance Development Experience
-
-- Seamless Integration: Directly obtain VTable usage guidance in the development environment
-
-- Real-time Feedback: Quickly verify code effects
-
-3. Reduce Learning Costs
-
-- Documentation Assistance: Access VisActor official examples at any time
-
-- Code Generation: Automatically generate code that complies with VisActor standards
-
-4. Improve Code Quality
-
-- Standard Check: Ensure code complies with VTable best practices
-
-- Performance Optimization: Automatically generate high-performance table configurations
-
-# Contact Us
-
-GitHub: [github.com/VisActor](https://link.juejin.cn/?target=https%3A%2F%2Fgithub.com%2FVisActor)
-
-Leave a message on the VisActor WeChat subscription account (you can join the WeChat group through the subscription account menu):
-
-
-
-VisActor official website: [www.visactor.io/](https://link.juejin.cn/?target=https%3A%2F%2Fwww.visactor.io%2Fvtable); [www.visactor.](https://link.juejin.cn/?target=https%3A%2F%2Fwww.visactor.io%2Fvtable)com
-
-Feishu Group:
-
-
-
-Discord: https://discord.com/invite/3wPyxVyH6m
-
-
----
-
-The doc is contributed by [玄魂](https://github.com/xuanhun)
\ No newline at end of file
diff --git a/docs/assets/guide/en/Intro_to_VMind.md b/docs/assets/guide/en/Intro_to_VMind.md
deleted file mode 100644
index 4c349da7..00000000
--- a/docs/assets/guide/en/Intro_to_VMind.md
+++ /dev/null
@@ -1,73 +0,0 @@
-
-# Introduction to VMind
-## Preface
-VisActor is a full-process visualization solution, which takes "visual storytelling" and "intelligence" as its core development direction. The components of VisActor that carry the ability of "visual storytelling" mainly include VChart, VTable, and VGrammar, all of which provide simple and easy-to-use interfaces. However, we hope that in some typical scenarios, users can generate charts and narrative works without writing code, thereby reducing the learning cost and complexity for users. The powerful generation ability of the large language model provides a natural language interaction interface for the VisActor visualization system, allowing us to directly call various functions of visualization components such as VChart and VTable through natural language, thereby completing visualization creation simply, quickly, and with high quality.
-
-
-
-
-
-VMind is an intelligent visualization component built on the basic capabilities of visualization component libraries such as VChart and VTable. We hope that in some typical scenarios, users can generate charts and narrative works with just one sentence, thereby reducing the learning cost and complexity for users.
-
-## VMind Architecture Design
-Intelligence is the future core direction of VisActor. Only on this basis can we truly reduce the access and development costs of developers and allow them to focus on things outside of visualization. VMind is an intelligent visualization component in the VisActor system. It provides intelligent interfaces in various ways such as rule algorithms, artificial intelligence, machine learning, and large language models to minimize the mental burden of developers using visualization components.
-
-
-
-
-
-In the VMind component, the bottom layer is the chart rendering, animation, annotation capabilities, VChart documentation provided by the VChart chart library, and the natural language understanding and code generation capabilities provided by the LLM. Among them, the data processing and interaction layer is responsible for processing user input data and natural language, including data aggregation modules for field parsing, data conversion, aggregation, etc., and the interaction communication module is responsible for handling communication between users and VMind, VMind and the LLM, including user intent recognition, Prompt management, model communication, result parsing.
-
-## VMind Core Capabilities
-
-
-
-
-
-The core capabilities of VMind include intelligent chart generation, intelligent chart editing, and intelligent color matching.
-- Intelligent chart generation refers to the process of directly generating charts from the display intent + data described in natural language.
-- Intelligent chart editing is the process of generating edited charts based on the original chart through the editing intent described in natural language.
-- Intelligent color matching is the process of generating stylized charts from natural language.
-
-Advanced capabilities are further applications of core capabilities, including complete visual narrative generation, data interpretation, and insight reports.
-
-## VMind Chart Creation Process
-
-
-
-
-
-Based on VMind's intelligent chart generation, conversational editing, and intelligent color matching modules, we can summarize the full process of using VMind for chart creation:
-First, the user provides a natural language description of the data display intent and chart data, or provides a natural language description of the chart editing intent and data news fragments, etc. These inputs are processed by the intent recognition module and routed to different modules. The intelligent chart generation module generates preliminary charts; the intelligent color matching module will generate corresponding theme color palettes according to user input, making the color matching of the chart more harmonious and beautiful; the conversational editing module will repeatedly apply a series of editing operations to fine-tune and optimize the chart until a chart that meets user needs is generated.
-
-The collaboration of these modules allows users to create visualization works without any threshold. This process not only greatly simplifies the complexity of chart creation but also greatly improves the efficiency and quality of chart creation.
-
-This process makes full use of the function call capability of the LLM. Chart generation, chart editing, and intelligent color matching are provided as functions for the model to call. LLM serves as the interface for interacting with users, selects the corresponding function according to user intent, and passes in parameters to execute the function of the corresponding module. In the future, VMind will also integrate insight extraction and data interpretation functions to interpret the generated charts, generate insight reports, or add annotations to the charts to display insight information in the data. At the same time, the model also has a powerful natural language dialogue capability, which can have multiple rounds of dialogue with users, and help users complete the entire process from chart creation to data analysis in a simple, natural, and friendly manner. Developers can easily integrate VMind into their systems as a data visualization assistant.
-
-## Practical Application of VMind
-### Data Video
-Data video is a type of video that presents and interprets data content through charts, animations, annotations, voiceovers, etc. This method can transform abstract data into intuitive graphics, present it in a more lively and interesting way, and make it easier for the audience to understand and accept.
-
-The steps to make a data video include:
-
-- Determine the data source and theme
-- Collect and organize data
-- Create, edit, and export charts
-- Video editing
-In the traditional data video production process, after collecting data, the creator needs to use professional visualization software to convert the data into charts; or use various chart libraries to draw charts through programming and export them as videos. In the era of short videos, everyone can become a video creator. However, non-professional video creators often do not have the skills to visualize data into charts and export them as videos, which greatly increases the threshold for making data videos.
-
-When using VMind to make data videos, users only need to describe the content they want to show in one sentence after collecting the data, and they can directly generate chart animations and support one-click export to videos and GIFs, which greatly reduces the difficulty of making data videos.
-
-
-
-
-
-### Intelligent Chart Assistant
-With the intelligent chart assistant built with VMind, you can use the function call capability of the large language model to judge the user's intent and call the VMind interface to realize chart generation and data interpretation, thereby reducing the difficulty of data visualization.
-
-
-__You can try the VMind Chart Assistant on [Cici](https://ciciai.com/bot/fUuxvgvv).__
-
-
-
-
diff --git a/docs/assets/guide/en/VMind_OpenAPI.md b/docs/assets/guide/en/VMind_OpenAPI.md
deleted file mode 100644
index fefafe3f..00000000
--- a/docs/assets/guide/en/VMind_OpenAPI.md
+++ /dev/null
@@ -1,90 +0,0 @@
-# VMind OpenAPI
-
-Built on the VMind chart generation tool, the VisActor team has launched VMind Agent, which improves the accuracy and efficiency of intelligent generation and adds multi‑turn editing capabilities. VMind Agent currently provides OpenAPI interfaces that you can call to achieve more advanced intelligent generation. The [VMind Agent Playground](/vmind/playground) offers a simple testing environment to experience VMind Agent’s capabilities.
-
-## VSeed
-
-VSeed is a domain‑specific language (DSL) for analytics. It encapsulates commonly used charting capabilities, greatly improving the efficiency of building analytic reporting platforms. In most cases, given a dataset and chart type, it can render directly; each chart type comes with extensive default conventions.
-
-VSeed is a subset of VChart and VTable. Its configuration is greatly simplified compared with VChart and VTable, making the options easier for large models to understand. It is a chart library specifically packaged for LLM‑driven generation.
-
-VSeed repository: [https://github.com/VisActor/VSeed](https://github.com/VisActor/VSeed)
-
-VSeed showcase: [https://visactor.github.io/VSeed/galley/chartType/line.html](https://visactor.github.io/VSeed/galley/chartType/line.html)
-
-VMind Agent prioritizes using VSeed for code generation for better results, while also supporting native code generation for VChart and VTable.
-
-## VMind Agent
-
-The overall technical approach of VMind Agent is as follows:
-
-When the user provides instructions and code blocks to VMind Agent, the agent uses the LLM to actively call tools and proceeds step by step through Generate/Edit → Check → Edit → Check … until the user’s requirements are met, outputting the corresponding code blocks and explanatory text.
-
-Compared with traditional chart generation tools, VMind Agent offers advantages in the following areas:
-- 🤖 ReAct architecture: Reasoning–action loop implemented with LangGraph
-- 🛠️ Diverse tools: Supports multiple chart generation and editing tools
-- 📊 Chart types: Supports many chart and table types
-- 🎨 Template system: Prebuilt chart templates
-- 🔧 Chart editing: Supports modifying existing charts
-- 💬 Natural language: Supports generating charts from pure natural‑language input
-
-### VMind Agent Architecture
-
-VMind Agent is composed of a Coordinator (scheduler) and a set of tools, and is implemented with the `@langchain/langgraph` library. The main modules are:
-
-
-
-#### Coordinator
-
-The scheduler’s main job is to determine, based on the current state, which tool to call next or whether to end the task.
-
-#### Generate Tool
-
-The generation tool is invoked when the user has not provided code or explicitly asks to regenerate code. If no chart type is specified, the tool recommends a suitable chart type based on the data. Each chart or table type provides a basic template; the LLM uses the user’s data and the template to generate the simplest code block for subsequent editing.
-
-#### Edit Tool
-
-The editing tool is the core of VMind Agent. Based on the current code and the user’s goal, the LLM breaks the task into multiple simple steps and completes them one by one. Before executing each edit step, the tool retrieves relevant materials from the knowledge base according to the step’s requirements to assist the LLM.
-
-#### Check Tool
-
-After each edit operation, the check tool verifies whether the change introduces serious errors or fails to achieve the step’s goal. If the check fails, the previous edit is rolled back.
-
-#### Short‑term Memory
-
-Each conversation records the current `sessionId`, allowing the same user to recall the state saved in previous turns and continue multi‑turn editing.
-
-### VMind Agent Knowledge Base
-
-To prevent hallucinations during editing, VMind Agent strictly limits the edit scope to the knowledge base fragments provided for each operation. The knowledge base consists of two parts:
-
-#### RAG
-
-Tutorial documents, demo examples, and Q&A content have strong independence and are well suited to a RAG approach. Relevant fragments are vectorized and stored in a vector database. For each edit operation, the system retrieves a set of related texts and code snippets for the model’s reference. When editing, if highly similar content is retrieved, the model can accurately perform the corresponding edits on the matched code snippets.
-
-#### Type Docs
-
-Configuration schemas for charts and tables are split by chart/table type and by module (e.g., axes, legends) into separate typed documentation fragments. Each fragment includes property names, types, and descriptions, and different fragments are indexed by different TopKeys. The LLM summarizes each fragment into Markdown and stores it in the database. For each TopKey, the LLM also produces a concise summary describing the scope covered by that TopKey.
-
-For each edit, the system first retrieves relevant TopKeys based on the instruction, then injects the associated Markdown fragments into the prompt. The LLM’s edits are strictly constrained to the range covered by the retrieved knowledge to avoid hallucination‑driven errors.
-
-## VMind Agent Applications
-
-### Playground
-
-VMind Agent Playground provides a simple testing environment to experience the agent’s capabilities. You can enter instructions and code blocks to see the generation and editing results.
-
-[VMind Agent Playground](/vmind/playground)
-
-### Douyin Mini Program
-
-Based on VMind Agent, we have developed a sample mini program. In Douyin mini programs, search for “数据智能洞察助手”. Users can input text for intelligent insights and experience the agent’s generation and editing results.
-
-
-
-## VMind OpenAPI Support
-
-Join our Feishu group to contact us and consult on VMind OpenAPI usage.
-
-
-
diff --git a/docs/assets/guide/en/VMind_Website_Guide.md b/docs/assets/guide/en/VMind_Website_Guide.md
deleted file mode 100644
index 6a788e72..00000000
--- a/docs/assets/guide/en/VMind_Website_Guide.md
+++ /dev/null
@@ -1,54 +0,0 @@
-
-# VMind Site Guide
-
-The purpose of this article is to help you use the VMind website more effectively and quickly find the information you need.
-
-## VMind OpenAPI
-
-VMind provides OpenAPI interfaces that allow you to achieve more advanced intelligent generation capabilities by calling these interfaces. You can learn more about OpenAPI in the [VMind OpenAPI](./VMind_OpenAPI) section.
-
-## Quick Start
-
-### Getting Started
-
-First, you need to read the [Getting Started](./Getting_Started) section of VMind. This section will teach you how to configure and use the environment required by VMind, as well as how to use VMind to build your first intelligent visualization application.
-
-### Learn More About VMind
-
-After you complete [Getting Started](./Getting_Started), you can learn about the functional positioning and related concepts of VMind in [Intro to VMind](./Intro_to_VMind). The [Create VMind Object](./Create_VMind_Object) chapter will teach you how to initialize a VMind object for subsequent operations. You can also learn about the data types supported by VMind in the [Data Input and Process](./Data_Input_and_Process) chapter. In the [Chart Generation](./Chart_Generation) chapter, you can learn more about how to use VMind for intelligent chart generation. The [Data Aggregation](./Data_Aggregation) chapter will teach you how to sort, filter, and aggregate data using VMind.
-
-## Documentation
-
-The VMind documentation provides detailed information on functions and APIs. Depending on your needs, you can view the following sections:
-
-- [Tutorials](./Basic_Tutorial/Create_VMind_Instance): Introduces the basic concepts of VMind and various usage methods.
-
-- [API](../api/VMind_Instance): Provides detailed descriptions of all available interfaces of VMind.
-
-
-
-## How to Use the Search Function
-
-This site provides a powerful search function that allows you to quickly find relevant usage information. Click on the search box at the top of the site, enter the keyword, and you will see the matching results in the drop-down list. Select the appropriate result to view the relevant content.
-
-## How to Ask Questions & Suggestions
-
-We are happy to help you! If you encounter any problems while using VMind, you can ask questions in the following ways:
-
-1. Submit an issue in the GitHub repository: Visit [VMind GitHub](https://github.com/VisActor/VMind/issues/new/choose), describe the problem you encountered in detail, and our team will respond and resolve it as soon as possible.
-
-2. Submit a discussion in the GitHub repository: Visit [VMind Discussion](https://github.com/VisActor/VMind/discussions), and we welcome you to share your ideas and suggestions here. Our team will respond and resolve it as soon as possible.
-
-## How to Report Errors
-
-If you find any problems in the document examples or think that some parts can be improved, please let us know. You can provide us with error correction information in the following ways:
-
-1. Submit a pull request in the GitHub repository: Correct the content and submit it, and a team member will review and merge it.
-
-2. Submit an issue: Point out the problems in the document, and a team member will verify and correct it as soon as possible.
-
-Thank you for your help! We will continue to improve the documentation and provide a better learning experience for all VMind users.
diff --git a/docs/assets/guide/menu.json b/docs/assets/guide/menu.json
deleted file mode 100644
index 4ee20fce..00000000
--- a/docs/assets/guide/menu.json
+++ /dev/null
@@ -1,128 +0,0 @@
-{
- "menu": "scripts",
- "children": [
- {
- "path": "VMind_Website_Guide",
- "title": {
- "zh": "VMind站点指引",
- "en": "VMind Website Guide"
- }
- },
- {
- "path": "VMind_OpenAPI",
- "title": {
- "zh": "VMind OpenAPI",
- "en": "VMind OpenAPI"
- }
- },
- {
- "path": "Intro_to_VMind",
- "title": {
- "zh": "VMind简介",
- "en": "Introduction to VMind"
- }
- },
- {
- "path": "Getting_Started",
- "title": {
- "zh": "快速上手",
- "en": "Getting Started"
- },
- "children": [
- {
- "path": "Getting_Started",
- "title": {
- "zh": "VMind快速上手",
- "en": "Getting Started with VMind"
- }
- },
- {
- "path": "Quickly_Get_Started_with_VisActor_Using_Trae_Context_Doc",
- "title": {
- "zh": "使用Trace Context快速上手VisActor",
- "en": "Quickly Get Started with VisActor Using Trace Context"
- }
- }
- ]
- },
- {
- "path": "Contribution_Guide",
- "title": {
- "zh": "贡献指南",
- "en": "Contribution Guide"
- }
- },
- {
- "path": "Basic_Tutorial",
- "title": {
- "zh": "基础教程",
- "en": "Basic Tutorial"
- },
- "children": [
- {
- "path": "How_to_Get_VMind",
- "title": {
- "zh": "如何获取VMind",
- "en": "How to Get VMind"
- }
- },
- {
- "path": "How_to_Import_VMind",
- "title": {
- "zh": "如何在项目中引用 VMind",
- "en": "How to Import VMind"
- }
- },
- {
- "path": "Create_VMind_Instance",
- "title": {
- "zh": "创建VMind实例",
- "en": "Create VMind Instance"
- }
- },
- {
- "path": "Data_Process",
- "title": {
- "zh": "数据格式与数据处理",
- "en": "Data Format and Data Process"
- }
- },
- {
- "path": "Data_Aggregation",
- "title": {
- "zh": "智能数据聚合",
- "en": "Intelligent Data Aggregation"
- }
- },
- {
- "path": "Chart_Generation",
- "title": {
- "zh": "图表智能生成",
- "en": "Intelligent Chart Generation"
- }
- },
- {
- "path": "Chart_Advisor",
- "title": {
- "zh": "基于规则的图表生成",
- "en": "Rule-based Chart Generation"
- }
- },
- {
- "path": "Data_Extraction",
- "title": {
- "zh": "数据提取——从文本一步生成图表",
- "en": "Text to Chart"
- }
- },
- {
- "path": "Chart_Insight",
- "title": {
- "zh": "智能洞察",
- "en": "Auto Insight"
- }
- }
- ]
- }
- ]
-}
\ No newline at end of file
diff --git a/docs/assets/guide/zh/Basic_Tutorial/Chart_Advisor.md b/docs/assets/guide/zh/Basic_Tutorial/Chart_Advisor.md
deleted file mode 100644
index 0da2e0ce..00000000
--- a/docs/assets/guide/zh/Basic_Tutorial/Chart_Advisor.md
+++ /dev/null
@@ -1,84 +0,0 @@
-# 基于规则的图表生成
-VMind可以结合内建的@visactor/chart-advisor，自动根据当前数据集生成图表。chart-advisor完整依赖于可视化规则，不需要调用大型语言模型。当你使用generateChart，而大模型无法成功生成图表时，VMind会使用chart-advisor作为备选方案来创建一个图表。
-
-你同样可以主动选择使用chart-advisor来生成图表，只需在初始化VMind对象时，将模型类型设置为chart-advisor：
-```ts
-import VMind, { Model } from '@visactor/vmind'
-
-const vmind = new VMind({
-model: Model.CHART_ADVISOR,
-})
-const userPrompt = '';
-const advisorResult = await vmind.generateChart(userPrompt, fieldInfo, dataset);
-```
-由于chart-advisor不依赖大型模型，userPrompt可以设为空。
-你可以在[数据格式与数据处理](./Data_Process)章节了解fieldInfo和dataset的更多相关信息。
-
-chart-advisor会根据一系列规则生成几种可用的图表，此时generateChart将返回包含图表类型、得分以及spec的列表。
-
-## 示例
-下面是一个使用商品销售额数据，通过chart-advisor生成图表的示例：
-
-```ts
-const dataset = [
-{
-"Product name": "Coke",
-"Sales": 2350
-},
-{
-"Product name": "Sprite",
-"total_sales": 1056
-},
-{
-"Product name": "Fanta",
-"total_sales": 4778
-},
-{
-"Product name": "Mirinda",
-"total_sales": 3336
-}
-// ...more data
-]
-
-const fieldInfo = [
-{
-"fieldName": "Product name",
-"type": "string",
-"role": "dimension"
-},
-{
-"fieldName": "Sales",
-"type": "int",
-"role": "measure"
-}
-]
-
-const advisorResult = await vmind.generateChart(userPrompt, fieldInfo, dataset);
-
-```
-advisorResult结果如下：
-```json
-[
-{
-"chartSource": "chartAdvisor", //图表来源
-"spec": ..., //生成的图表spec
-"chartType": "BAR CHART", //图表类型
-"score": 1, //当前图表得分
-},
-{
-"chartSource": "chartAdvisor",
-"spec": ..., //生成的图表spec
-"chartType": "RADAR CHART", //图表类型
-"score": 0.16666666666666666 //当前图表得分
-}
-]
-```
-
-其中，score表示当前图表类型与输入数据的匹配程度，分数越高表示该类型的图表越适用于展示当前数据。
-
-
-生成的图表如下：
-
-
-
-根据输入数据的特性以及fieldInfo中的字段信息，chart-advisor会基于一整套可视化规则，为每种图表类型打分，并依分数将各图表类型排序。这些规则确保了可视化结果的准确度和美观性，并尽可能地减少图表中的视觉混乱和视觉错误。
diff --git a/docs/assets/guide/zh/Basic_Tutorial/Chart_Generation.md b/docs/assets/guide/zh/Basic_Tutorial/Chart_Generation.md
deleted file mode 100644
index 309fa323..00000000
--- a/docs/assets/guide/zh/Basic_Tutorial/Chart_Generation.md
+++ /dev/null
@@ -1,545 +0,0 @@
-# 图表生成
-本教程将向你详细介绍VMind中的图表智能生成功能，并提供一些示例。
-
-生成图表的方式有很多，比如你可以在PowerBI、Tableau等专业的BI可视化工具中，利用数据集的字段来制作可视化图表；或者你也可以直接使用VChart、ECharts、MatPlotlib等图表库，通过编写代码来绘制图表。此外，VChart、Echarts等图表库还提供了简单易用的图表编辑器，用户可以上传数据并进行图表制作。
-
-然而，传统的图表生成方式也存在一些问题：
-
-- 对于编程新手来说，他们可能不会编写代码，也就无法使用图表库来生成图表。
-- 图表类型繁多，用户展示数据的目的各不相同，这就导致了适合展示的图表类型和对应的字段映射也会有所不同。对于非专业用户来说，他们可能无法准确地选择出最能表达自己观点的图表类型。
-
-- 用户对于图表样式、动画的需求各不相同，往往需要一定的设计能力才能满足。设计出令人眼前一亮的图表并不容易，它需要设计技能和审美意识，而这些是许多用户所缺乏的。
-
-这些问题增加了数据可视化的创作门槛，阻碍了非专业用户创作符合自己意图的可视化作品。
-
-VMind的解决方案是，利用大语言模型的自然语言理解能力和公域知识，根据用户的数据和展示意图，推荐合适的图表类型，并将字段映射到合适的视觉通道上，实现图表的智能生成，从而降低用户进行数据可视化的门槛。
-
-
-## generateChart
-VMind的generateChart函数是一个强大的工具，它可以帮助你智能生成图表。这个函数需要以下几个参数：
-- userPrompt (string): 用户的可视化意图（你想用图表展示什么信息）
-- fieldInfo (Array): 数据集中字段的信息，包括字段名称，类型等
-- dataset (Array): 图表中使用的原始数据集，可以是undefined。若dataset为undefined，则会生成一个spec模板，后续可以调用fillSpecTemplateWithData将数据填充到spec模板。
-- options: 可选，选项参数，包括以下内容：
-
- - chartTypeList (ChartType[]，可选): 支持的图表类型列表。若不为undefined，则会从该列表指定的图表类型中选择生成。
- - enableDataQuery (boolean, 可选): 决定是否在图表生成过程中开启数据聚合
- - colorPalette (Array
-
-# 什么上下文Doc 功能
-
-指定上下文可以让 AI 助手提供更精准的回答，但是大模型对一个组件的理解的实时程度是低于组件自己的官方文档的。如果我们在使用一个不熟悉的组件的时候，如果能将该组件的相关文档引入到上下文中，可以大大的提升智能化编程水平。
-
-
-
-Trae 使用 “#” 来指定上下文。
-
-
-
-输入“#Doc：”，可以索引文档集。 我们添加VisActor 的文档，进行测试。 目前Trae 还没有内置任何文档集，所以需要手动添加。
-
-首先添加文档集：
-
-
-
-
-
-这里我们通过url的方式添加各组件的入口url：
-
-* VChart：https://www.visactor.io/vchart/
-
-* VTable：https://www.visactor.io/vtable
-
-* VMind：https://www.visactor.io/vmind
-
-* ....
-
-
-
-整个过程略微缓慢，但是索引效果，明显好于 Cursor。
-
-
-
-
-
-下面我们实地测试一下引用文档作为上下文是否会给编程带来实际的益处。
-
-# 效果测试
-
-## 创建测试项目
-
-我们创建一个最简单web 项目
-
-```
-npm create vite@latest my-ts-web -- --template typescript
-cd my-ts-web
-
-```
-
-
-# 实践验证
-
-## 新增一个线图
-
-我们要求Trae 生成一段代码，在当前文件中添加一个VChart 线图。
-
-
-
-生成的结果还是有错误的。
-
-
-
-我们下面引入文档，看看是不是会有所改变。
-
-
-
-重新生成的代码修复了之前的api 错误调用。
-
-
-
-生成了一个正确的线图。
-
-
-
-## 加大难度
-
-首先我们来修改数据，显示三条线。
-
-
-
-问题的分析和答案都比较靠谱：
-
-
-
-
-
-主要修改点：
-
-1. 重构了数据结构，使用type字段来区分不同系列
-
-1. 使用seriesField来指定系列的分类字段
-
-1. 每个数据点包含year（x轴）、value（y轴）和type（系列）三个字段
-
-
-
-修改入场动画效果：
-
-
-
-
-
-主要修改：
-
-1. 添加了animation配置
-
-1. appear设置入场动画为fadeIn（淡入淡出）
-
-1. duration设置动画持续时间为1000毫秒
-
-结果如下：
-
-
-
-
-
-## 更多问答
-
-因为有了官方文档，我们可以让Trae 回答更多类型的问题，不只是代码本身。
-
-比如基本的图表概念：
-
-
-
-或者 具体用法：
-
-
-
-导航到更相关文档：
-
-
-
-
-
-# 简单总结
-
-Trae 结合文档有如下好处：
-
-1. 提升开发效率
-
-- 快速访问：通过Marscode直接查阅VisActor API文档
-
-- 智能提示：基于VisActor文档的精准代码补全
-
-2. 增强开发体验
-
-- 无缝集成：在开发环境中直接获取VTable使用指导
-
-- 实时反馈：快速验证代码效果
-
-3. 降低学习成本
-
-- 文档辅助：随时查阅VisActor官方示例
-
-- 代码生成：自动生成符合VisActor规范的代码
-
-4. 提高代码质量
-
-- 规范检查：确保代码符合VisActor最佳实践
-
-- 性能优化：自动生成高性能表格配置
-
-# 联系我们
-
-github ：[github.com/VisActor](https://link.juejin.cn/?target=https%3A%2F%2Fgithub.com%2FVisActor)
-
-VisActor 微信订阅号留言（可以通过订阅号菜单加入微信群）：
-
-
-
-VisActor 官网：[www.visactor.io/](https://link.juejin.cn/?target=https%3A%2F%2Fwww.visactor.io%2Fvtable) ； [www.visactor.](https://link.juejin.cn/?target=https%3A%2F%2Fwww.visactor.io%2Fvtable)com
-
-飞书群：
-
-
-
-discord：https://discord.com/invite/3wPyxVyH6m
-
-
----
-
-The doc is contributed by [玄魂](https://github.com/xuanhun)
diff --git a/docs/assets/guide/zh/Intro_to_VMind.md b/docs/assets/guide/zh/Intro_to_VMind.md
deleted file mode 100644
index 1ca6bbd4..00000000
--- a/docs/assets/guide/zh/Intro_to_VMind.md
+++ /dev/null
@@ -1,86 +0,0 @@
-# VMind简介
-## 前言
-VisActor是一款全流程可视化解决方案，它以“可视化叙事”和“智能化”为核心发展方向。VisActor承载“可视化叙事” 能力的组件主要有VChart、VTable 和 VGrammar，它们都提供了简单易用的接口。然而，我们希望在一些典型场景中，用户能够无需编写代码就能生成图表和叙事作品，以此降低用户的学习成本和使用复杂度。大语言模型的强大生成能力为VisActor可视化体系提供了一个自然语言的交互接口，使我们能够通过自然语言直接调用VChart、VTable等可视化组件的各项功能，从而简单、快速、高质量地完成可视化创作。
-
-
-
-
-
-VMind是在VChart、VTable等可视化组件库的基础能力之上，构建的一个智能可视化组件。我们希望在一些典型场景中，用户能够只需一句话就能生成图表和叙事作品，以此降低用户的学习成本和使用复杂度。
-
-## VMind架构设计
-智能化是VisActor的未来核心方向，只有在此基础上，我们才能真正降低开发者的接入和研发成本，让他们能够将注意力集中在可视化之外。VMind是VisActor体系中的智能可视化组件，它基于规则算法、人工智能、机器学习、大语言模型等多种方式提供智能化接口，以最大限度降低开发者使用可视化组件的心智负担。
-
-
-
-
-
-在VMind组件中，最底层是由VChart图表库提供的图表渲染、动画、标注能力、VChart文档，以及大语言模型提供的自然语言理解、代码生成能力。其中，数据处理与交互层负责处理用户输入的数据和自然语言，包括数据聚合模块进行字段解析、数据转换、聚合等操作，交互通信模块负责处理用户与VMind、VMind与大语言模型之间的通信，包括用户意图识别、Prompt管理，模型通信，结果解析。
-
-
-## VMind核心能力
-
-
-
-
-
-VMind的核心能力包括图表智能生成、图表智能编辑和智能配色。
-- 图表智能生成，是指从自然语言描述的展示意图+数据直接生成图表的过程
-- 图表智能编辑是在原有图表的基础上，通过自然语言描述编辑意图，生成编辑后的图表
-- 智能配色是从自然语言生成风格化图表的过程。
-
-进阶能力是对核心能力的进一步应用，包括完整的可视化叙事生成、数据解读与洞察报告。
-
-
-## VMind图表创作流程
-
-
-
-
-
-基于VMind的图表智能生成、对话式编辑和智能配色模块，我们可以概括出使用VMind进行图表创作的全流程：
-首先，用户提供自然语言描述的数据展示意图和图表数据，或者提供自然语言描述的图表编辑意图和数据新闻片段等。这些输入经过意图识别模块的处理，路由到不同模块。图表智能生成模块生成初步的图表；智能配色模块会根据用户的输入生成相应的主题色板，使得图表的颜色搭配更加和谐、美观；对话式编辑模块会反复应用一系列编辑操作，对图表进行微调和优化，直到生成一张满足用户需求的图表。
-
-这些模块之间的协同作用，使得用户可以零门槛创作可视化作品。这种流程不仅大大简化了图表创作的复杂度，也极大地提升了图表创作的效率和质量。
-
-这一流程充分利用了大模型的function call能力。图表生成、图表编辑与智能配色作为function供模型调用，LLM作为与用户交互的接口，根据用户意图选择对应的function并传入参数，执行对应模块的功能。在未来，VMind还将集成洞察提取、数据解读功能，对生成的图表进行解读，生成洞察报告，或者在图表中添加标注展示数据中的洞察信息。与此同时，模型还具有强大的自然语言对话能力，能够与用户进行多轮对话，简单、自然、友好地帮助用户完成从图表创作到数据分析的全过程。开发人员可以轻松地将VMind集成到他们的系统中，作为一个数据可视化助手。
-
-
-
-## VMind使用场景
-### 数据视频
-数据视频是一种将数据内容通过图表、动画、标注、旁白等形式进行展示和解读的视频类型。这种方式能够将原本抽象的数据转化为直观的图形，以更加生动有趣的方式呈现，使观众更容易理解和接受。
-
-制作数据视频的步骤包括：
-
-- 确定数据来源和主题
-- 收集和整理数据
-- 制作、编辑和导出图表
-- 视频编辑
-在传统的数据视频制作流程中，创作者需要在收集数据后，使用专业的可视化软件将数据转化为图表；或者使用各种图表库，通过编程绘制图表并导出为视频。在短视频时代，每个人都有可能成为视频的创作者。但是，非专业的视频创作者往往没有将数据可视化为图表并导出为视频的技能，这就大大提高了制作数据视频的门槛。
-
-而使用 VMind 制作数据视频，用户只需要在收集好数据之后，用一句话描述想要展示的内容，就能直接生成图表动画，并支持一键导出为视频和 GIF，这极大地降低了制作数据视频的难度。
-
-
-
-
-
-
-### 图表智能助手
-借助VMind打造的图表智能助手，你可以利用大语言模型的function call能力，判断用户的意图并调用VMind接口，实现图表的生成和数据的解读，从而降低数据可视化的难度。
-
-
-__你可以在[Cici](https://ciciai.com/bot/fUuxvgvv)体验VMind图表助手。__
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/docs/assets/guide/zh/VMind_OpenAPI.md b/docs/assets/guide/zh/VMind_OpenAPI.md
deleted file mode 100644
index 18846485..00000000
--- a/docs/assets/guide/zh/VMind_OpenAPI.md
+++ /dev/null
@@ -1,90 +0,0 @@
-# VMind OpenAPI
-
-在VMind图表生成工具的基础上，VisActor团队全新推出了VMind Agent，提升了智能生成的准确性和效率，并新增了多轮编辑能力。目前VMind Agent提供了OpenAPI接口，你可以通过调用这些接口来实现更高级的智能生成能力。[VMind Agent Playground](/vmind/playground)提供了一个简单的测试环境，方便体验VMind Agent的能力。
-
-## VSeed
-
-VSeed是一个面向分析领域的DSL, 封装了该领域常用的图表能力, 极大地提升分析式报表平台的搭建效率。一般情况下, 给定数据集和图表类型, 即可直接出图，每类图表类型存在大量的默认约定逻辑。
-
-VSeed是VChart和VTable的子集，配置相比VChart和VTable大幅简化，配置项更适合大模型理解，是专为LLM生成封装的图表库。
-
-VSeed 项目仓库：[https://github.com/VisActor/VSeed](https://github.com/VisActor/VSeed)
-
-VSeed 能力展示：[https://visactor.github.io/VSeed/galley/chartType/line.html](https://visactor.github.io/VSeed/galley/chartType/line.html)
-
-VMind Agent优先推荐使用VSeed进行代码生成，生成效果更加优秀，也同时支持VChart和VTable的原生代码生成。
-
-## VMind Agent
-
-VMind Agent的整体技术方案如下：
-
-用户输入的指令和代码块，输入VMind Agent后，Agent会基于LLM主动调用工具，开始逐步进行 生成/编辑 -> 检查 -> 编辑 -> 检查 ...... 任务流，最终完成用户的要求，输出对应的代码块和文本解释说明。
-
-相比传统的图表生成工具，VMind Agent在一下方面有优势：
-- 🤖 ReAct 架构: 基于 LangGraph 实现的推理-行动循环
-- 🛠️ 多样化工具: 支持多种图表生成和编辑工具
-- 📊 图表类型: 支持多种图表类型和表格类型
-- 🎨 模板系统: 预置多种图表模板
-- 🔧 图表编辑: 支持对现有图表进行修改
-- 💬 自然语言: 支持纯自然语言输入生成图表
-
-### VMind Agent 架构
-
-VMind Agent 主要由Coordinator调度器和若干工具组成，基于`@langchain/langgraph库`完成Agent的实现。主要模块如下：
-
-
-
-#### Coordinator
-
-调度器主要工作是：基于当前状态，判断下一步应该调用哪一个工具，或结束任务。
-
-#### Generate Tool
-
-生成工具在用户没有输入代码，或指令要求重新生成代码时调用。如果没有指定图表类型，工具会基于数据推荐适合的图表类型。每一种图表/表格类型都会提供基础的模版，LLM会基于用户的数据和模版生成最简单的代码块，供进一步编辑使用。
-
-#### Edit Tool
-
-编辑工具是VMind Agent的核心部分，LLM会基于当前的代码和用户的目标，将任务拆分为多个简单的步骤并逐一完成。在执行每次编辑任务前，工具会基于本次步骤的任务要求，在知识库中召回对应的资料，辅助LLM进行编辑。
-
-#### Check Tool
-
-检查工具在每一步编辑操作后执行，用来检查当次编辑操作是否会引起恶性错误，或是否没有达到当次步骤的目标。如果检查不通过，会回退上一次编辑操作。
-
-#### 短期记忆
-
-每一次对话会记录当前的sessionId，方便同一个用户进行多轮对话时，找回之前轮次的对话所记录的状态，方便用户进行多轮编辑操作。
-
-### VMind Agent 知识库
-
-为了避免LLM在编辑代码时出现幻觉，VMind Agent将编辑范围严格限制在每次编辑操作提供的知识库片段中。知识库主要分为两部分：
-
-#### RAG
-
-教程文档、示例Demo和Q&A问答内容，内容独立性强，适合使用RAG方案。相应片段进行向量化后，存入向量数据库。每次进行编辑操作时，会召回对应的若干文本及代码片段，供大模型参考。
-大模型进行编辑时，如果召回有非常接近的内容，会已经对应的代码片段准确进行相应的编辑。
-
-#### Type Docs
-
-图表和表格的配置Schema，按照不同的图表/表格类型，以及不同的模块（例如坐标轴、图例等）进行拆分，组织成一个个类型说明片段。每个片段中有该部分对应的属性名称、属性类型和属性说明，不同的片段使用不同的TopKey进行索引。使用LLM将每个每个片段进行归纳总结，生成对应的说明Markdown片段，存储在数据库中。每一个TopKey也依据对应的Markdown片段，使用LLM总结一段简单的说明，介绍这个TopKey下的功能范围。
-
-每次编辑时，首先依据编辑指令召回对应的若干TopKey，之后将TopKey对应的Markdown文本片段，作为知识库加入prompt中，大模型的编辑操作会被严格限制在本次召回的知识库的范围，避免幻觉影响编辑结果。
-
-## VMind Agent 应用
-
-### Playground
-
-VMind Agent Playground提供了一个简单的测试环境，方便体验VMind Agent的能力。你可以在Playground中输入指令和代码块，查看Agent的生成和编辑结果。
-
-[VMind Agent Playground](/vmind/playground)
-
-### 抖音小程序
-
-基于VMind Agent的，我们开发了一个示例小程序，抖音小程序搜索 数据智能洞察助手 对话小程序，用户可以在小程序中输入需要进行智能洞察的文本，体验Agent的生成和编辑结果。
-
-
-
-## VMind OpenAPI 使用咨询
-
-加入飞书群欢迎联系我们，咨询VMind OpenAPI的使用方案。
-
-
diff --git a/docs/assets/guide/zh/VMind_Website_Guide.md b/docs/assets/guide/zh/VMind_Website_Guide.md
deleted file mode 100644
index c712c20f..00000000
--- a/docs/assets/guide/zh/VMind_Website_Guide.md
+++ /dev/null
@@ -1,55 +0,0 @@
-
-# VMind站点指南
-
-本篇文章的目的是为了帮助你更有效地使用 VMind 网站，让你能更快地找到你需要的信息。
-
-## VMind OpenAPI
-
-VMind 提供了 OpenAPI 接口，你可以通过调用这些接口来实现更高级的智能生成能力。你可以在[VMind OpenAPI](./VMind_OpenAPI)章节了解更多关于 OpenAPI 的信息。
-
-## 快速开始
-
-### 快速上手
-
-首先，你需要阅读 VMind 的[快速上手](./Getting_Started)章节。这个章节会教你如何配置和使用 VMind 所需的环境，以及如何使用 VMind 构建你的第一个智能可视化应用。
-
-### 深入了解 VMind
-
-在你完成[快速上手](./Getting_Started)后，你可以在[VMind简介](./Intro_to_VMind)了解 VMind 的功能定位和相关概念。
-[创建VMind对象](./Create_VMind_Object)章节将教你如何初始化一个 VMind 对象以进行后续操作。你还可以通过阅读[数据处理与输入](./Data_Input_and_Process)章节来了解 VMind 支持的数据类型。在[图表生成](./Chart_Generation)章节，你可以深入了解如何使用 VMind 进行图表智能生成。[数据聚合](./Data_Aggregation)章节将教你如何使用 VMind 对数据进行排序、筛选、聚合等操作。
-
-## 文档
-
-VMind 的文档提供了详细的功能和 API 信息。根据你的需求，你可以查看以下几个部分：
-
-- [教程](./Basic_Tutorial/Create_VMind_Instance)：介绍了 VMind 的基本概念和各种使用方法。
-
-- [API](../api/VMind_Instance)：提供了 VMind 的所有可用接口的详细说明。
-
-
-
-## 如何使用搜索功能
-
-本站点提供了一个强大的搜索功能，让你可以快速找到相关的使用信息。点击站点顶部的搜索框，输入关键词后，你将在下拉列表中看到匹配的结果。选择合适的结果即可查看相关内容。
-
-## 如何提问&建议
-
-我们很高兴为你提供帮助! 如果你在使用 VMind 过程中遇到问题，可以通过以下方式提问：
-
-1. 在 GitHub 仓库中提交一个 issue：访问 [VMind GitHub](https://github.com/VisActor/VMind/issues/new/choose)，详细描述你遇到的问题，我们的团队将尽快回应并解决。
-
-2. 在 GitHub 仓库提交一个 discussion：访问 [VMind Discussion](https://github.com/VisActor/VMind/discussions)，非常欢迎你在这里提出你的想法和建议，我们的团队将尽快回应并解决。
-
-## 如何纠错
-
-如果你在文档示例中发现问题，或者认为某些部分可以改进，务必告诉我们。你可以通过以下方式为我们提纠错信息：
-
-1. 在 GitHub 仓库中提交一个 pull request：纠正的内容并提交，会有团队成员审核并合并。
-
-2. 提交一个 issue：指出文档中存在的问题，团队成员会尽快核实并修正。
-
-感谢你的帮助！我们将不断完善文档，为所有 VMind 用户提供更好的学习体验。
diff --git a/docs/assets/openManus/Amazon_Fashion_Sales_Analysis_Report.md b/docs/assets/openManus/Amazon_Fashion_Sales_Analysis_Report.md
deleted file mode 100644
index fbfca095..00000000
--- a/docs/assets/openManus/Amazon_Fashion_Sales_Analysis_Report.md
+++ /dev/null
@@ -1,125 +0,0 @@
-# Amazon Fashion Sales Analysis and Growth Strategy
-## January 2025 Performance Review and 10% Growth Plan
-
-## Executive Summary
-
-This comprehensive analysis examines the January 2025 sales data from your Amazon Fashion store to identify patterns, trends, and opportunities for growth. The analysis reveals several key insights, including day-of-week performance variations, the impact of discount strategies, and customer purchasing behaviors. Based on these findings, we've developed a multi-faceted strategy projected to increase sales by 14%, well above the requested 10% target. The strategy focuses on optimizing day-specific promotions, enhancing customer purchase behavior, refining pricing and promotion tactics, and improving inventory management. This report provides both detailed analysis and actionable recommendations with implementation timelines to achieve sustainable growth.
-
-## Data Analysis Methodology
-
-The analysis began with a thorough exploration of the January 2025 sales data, which included 31 days of daily metrics covering orders, customers, units sold, and various financial indicators. The data was preprocessed to create derived metrics such as average order value, units per order, profit margins, and day-of-week features. Comprehensive statistical analysis was performed to identify patterns, correlations, and anomalies in the data. Multiple visualizations were created to illustrate key trends and relationships, providing a foundation for data-driven strategy development.
-
-## Sales Performance Overview
-
-January 2025 showed overall healthy performance with a total of 1,213 orders, generating approximately $166,000 in gross sales and $57,000 in net profit. The average daily performance included 39 orders, 101 units sold, and $5,349 in gross sales, with an average order value of $136.11 and a profit margin of 34.11%. The data revealed significant day-to-day variations, with a notable peak on January 14th that substantially outperformed all other days.
-
-### Weekly Performance Trends
-
-The sales data demonstrated a clear pattern of growth and decline throughout the month. Week 3 (January 15-21) showed peak performance with 316 orders, $45,546 in gross sales, and $15,827 in net profit. This represented a 39.8% increase in orders and a 49.9% increase in gross sales compared to Week 1. However, Weeks 4 and 5 showed a progressive decline, with Week 5 recording only 148 orders and $20,751 in gross sales. This mid-month peak followed by end-of-month decline suggests a cyclical pattern that requires strategic intervention to maintain momentum throughout the entire month.
-
-Average order value also fluctuated weekly, peaking in Week 3 at $144.97, while Week 4 had the lowest AOV at $125.07. This 16% variation in AOV between weeks indicates significant potential for optimization through targeted promotional strategies. Profit margins showed similar fluctuations, ranging from 31.64% in Week 4 to 36.44% in Week 5, suggesting opportunities for margin improvement through strategic product mix and pricing adjustments.
-
-### Day-of-Week Analysis
-
-The analysis revealed substantial performance variations by day of week. Tuesdays consistently outperformed other days with an average of 52.25 orders and $7,152 in gross sales, while Thursdays showed the weakest performance with only 28.6 orders and $3,763 in gross sales. This 82.7% difference in order volume between the best and worst-performing days represents a significant opportunity for targeted interventions to boost underperforming days.
-
-Weekend days (Saturday and Sunday) averaged higher orders (43.88) compared to weekdays (37.48), but showed lower average order values ($129.74 vs. $138.33). This suggests different shopping behaviors between weekday and weekend customers, with weekend shoppers making more frequent but smaller purchases. Mondays showed the highest average order value at $146.42, indicating potential for premium product focus on this day.
-
-### Outlier Analysis: January 14th
-
-Tuesday, January 14th stood out as an exceptional outlier, with 79 orders (82.31% above the average Tuesday), $11,752 in gross sales (109.14% above average), and $4,010 in net profit (113.58% above average). This single day accounted for approximately 7% of the month's total sales. The exceptional performance extended across all metrics, including a higher average order value ($148.76 vs. $128.29) and more units per order (2.84 vs. 2.42) compared to other Tuesdays.
-
-The dramatic outperformance of January 14th suggests specific factors that drove success on this day, potentially including promotional activities, external events, or seasonal factors. Identifying and replicating these success factors represents a significant opportunity for boosting overall sales performance.
-
-## Customer Behavior Insights
-
-The analysis revealed several important patterns in customer purchasing behavior that provide opportunities for optimization. The near-perfect 100% conversion rate across all days suggests most visitors are returning customers or highly qualified leads, indicating a loyal customer base but also potential for expanding reach to new customers.
-
-Customers purchased an average of 2.57 units per order, with higher units per order on Tuesdays (2.84) and lower on weekends (2.35). This variation suggests different shopping motivations throughout the week and opportunities for increasing basket size through strategic cross-selling and bundling. The data also showed that orders and unique customers were nearly identical, indicating most customers place only one order per day, highlighting potential for encouraging multiple purchases.
-
-## Financial Performance Analysis
-
-Profit margins showed significant variation, ranging from 26.97% to 42.03%, with an average of 34.11%. Weekdays demonstrated higher profit margins (35.47%) compared to weekends (33.38%), suggesting different product mix preferences between weekday and weekend shoppers. The correlation analysis revealed a moderate positive relationship (0.41) between profit margin and average order value, indicating that higher-value orders tend to be more profitable.
-
-The cost structure analysis showed Amazon fees remained relatively consistent at 19-21% of gross sales, while product costs varied more significantly, ranging from 38.39% to 50.67% of gross sales. This variation in product costs suggests opportunities for optimizing the product mix to favor higher-margin items during strategic promotional periods.
-
-## Discount and Shipping Impact
-
-The analysis of discount strategies revealed that medium discounts ($1-2 per order) correlated with the highest orders (44.17), gross sales ($6,174.53), and net profit ($2,129.66). Higher discounts showed diminishing returns, with lower profit margins (32.09% for high discounts vs. 34.60% for low discounts) and no corresponding increase in order volume. Discounts showed negative correlations with average order value (-0.10) and profit margin (-0.32), suggesting the need for strategic application to maximize overall profitability.
-
-Shipping charge analysis showed that medium shipping charges ($5-6 per order) correlated with the highest profit margins (35.47%). Shipping charges showed minimal correlation with orders (-0.01) and sales (0.01), suggesting limited price sensitivity to shipping costs within the current range. The negative correlation (-0.39) between shipping and discount suggests these are used as alternative promotional tactics, providing an opportunity for more strategic coordination between these levers.
-
-## Data-Driven Growth Strategies
-
-Based on the comprehensive analysis of January 2025 sales data, we've developed a multi-faceted strategy to achieve a minimum 10% increase in sales for the upcoming month. The strategy focuses on four key areas: day-of-week optimization, customer behavior optimization, pricing and promotion refinement, and inventory management improvements.
-
-### Day-of-Week Optimization Strategies
-
-The significant performance variations by day of week present clear opportunities for targeted interventions. For Tuesdays, which already show strong performance, we recommend enhancing their success by analyzing what made January 14th exceptional and implementing similar tactics on all Tuesdays. This includes implementing 3-hour flash sales with medium-level discounts ($1-2 per order) that showed optimal performance in our analysis, and scheduling targeted email campaigns to be delivered Monday evening to drive Tuesday traffic. These Tuesday enhancements are projected to increase Tuesday sales by 15%, contributing 3% to overall monthly sales.
-
-For underperforming Thursdays, we recommend a rescue plan featuring Thursday-exclusive promotions, free shipping offers, and bundle deals to increase units per order from the current 2.57 average. These Thursday interventions are expected to increase Thursday sales by 20%, contributing 2% to overall monthly sales.
-
-Weekend strategies should focus on improving average order value, which currently lags behind weekday performance. This includes promoting higher-value items on weekends and implementing tiered shipping discounts that increase with order value to encourage larger weekend purchases. These weekend AOV improvements are projected to increase weekend AOV by 8%, contributing 1.5% to overall monthly sales.
-
-### Customer Behavior Optimization
-
-To increase units per order from the current 2.57 average, we recommend implementing AI-powered product recommendations based on cart contents, offering tiered discounts for purchasing multiple items, and featuring complementary products on product pages and during checkout. These strategies are expected to increase average units per order to 2.8 (+9%), contributing 2% to overall monthly sales.
-
-To encourage repeat purchases within the same month, we recommend sending follow-up emails with time-limited discount codes for next purchases and implementing a points-based loyalty program. These repeat purchase incentives are projected to generate 5% additional orders from repeat customers, contributing 1% to overall monthly sales.
-
-### Pricing and Promotion Optimization
-
-Based on the analysis of discount impact, we recommend refining the discount strategy to focus on the medium discount range ($1-2 per order) that showed highest orders, gross sales, and net profit. Discounts should be applied strategically to products with higher profit margins to maintain overall profitability. This optimized discount strategy is expected to improve conversion while maintaining profit margins, contributing 1.5% to overall monthly sales.
-
-For shipping strategy, we recommend implementing free shipping for orders above $150 to increase average order value (currently $136.11) and focusing on medium shipping charges ($5-6) that showed highest profit margins. These shipping optimizations are projected to increase AOV by 5%, contributing 1% to overall monthly sales.
-
-### Inventory and Product Mix Strategies
-
-To optimize the product mix, we recommend identifying and featuring products with above-average profit margins and expanding selection in categories showing highest units per order. This product mix optimization is expected to improve overall profit margin while increasing sales, contributing 1% to overall monthly sales.
-
-To address the observed decline in sales during Weeks 4-5, we recommend creating special promotions for the last week of the month and implementing a strategic discounting of slow-moving inventory during the final week. These end-of-month boost strategies are projected to reduce the Week 4-5 decline by 50%, contributing 1% to overall monthly sales.
-
-## Implementation Plan
-
-The implementation of these strategies should follow a phased approach over four weeks:
-
-Week 1 should focus on building the foundation by setting up technical infrastructure for all promotions, preparing email templates and marketing materials, and configuring discount rules and shipping tiers.
-
-Week 2 should launch the core strategies, including the Tuesday Power Day strategy, Units Per Order initiatives, and Discount Strategy Refinement.
-
-Week 3 should expand the implementation to include the Thursday Rescue Plan, Weekend AOV Improvement tactics, and Repeat Purchase Incentives.
-
-Week 4 should focus on optimization by deploying the End-of-Month Sales Boost, fine-tuning all strategies based on early results, and preparing for continuation in the following month.
-
-## Expected Results
-
-The combined impact of these strategies is projected to increase sales by 14%, exceeding the 10% target:
-- Day-of-Week Optimization: +6.5%
-- Customer Behavior Optimization: +3.0%
-- Pricing and Promotion Optimization: +2.5%
-- Inventory and Product Mix Strategies: +2.0%
-
-This comprehensive approach provides a buffer for any strategies that may underperform expectations while maintaining or improving profit margins. The strategies are designed to be sustainable and scalable, providing a foundation for continued growth beyond the immediate target period.
-
-## Conclusion
-
-The January 2025 sales data reveals a healthy business with significant opportunities for optimization and growth. By strategically addressing day-of-week performance variations, enhancing customer purchase behavior, refining pricing and promotion tactics, and improving inventory management, we project a 14% increase in sales for the upcoming month. The recommended strategies are data-driven, actionable, and designed to not only increase sales volume but also maintain or improve profit margins. Implementation should follow the phased approach outlined in this report, with ongoing monitoring and adjustment to maximize results.
-
-## Appendix: Key Visualizations
-
-The analysis includes several key visualizations that illustrate the patterns and insights discussed in this report:
-
-1. Daily Gross Sales Trend - January 2025
-2. Weekly Gross Sales - January 2025
-3. Average Daily Orders by Day of Week
-4. Weekend vs Weekday Performance Comparison
-5. January 14th vs Average Tuesday Comparison
-6. Impact of Discount Levels on Sales Metrics
-7. Profit Margin by Discount Range
-8. Units per Order vs Average Order Value
-9. Impact of Shipping Levels on Sales Metrics
-10. Daily Profit Margin Trend - January 2025
-11. Daily Average Order Value Trend - January 2025
-12. Correlation Matrix of Sales Metrics
-
-These visualizations provide visual confirmation of the patterns identified in the analysis and support the strategic recommendations outlined in this report.
diff --git a/docs/assets/openManus/Readme.md b/docs/assets/openManus/Readme.md
deleted file mode 100644
index c5a8bb65..00000000
--- a/docs/assets/openManus/Readme.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Case of Sales Analysis and Strategies for Amazon Store
-
-The current folder contains all execution artifacts of [the Sales Analysis and Strategies for Amazon Store case in manus](https://manus.im/share/c3onakN6Iajcm1Vt1xAVG7?replay=1)
\ No newline at end of file
diff --git a/docs/assets/openManus/amazon_sales_jan2025.csv b/docs/assets/openManus/amazon_sales_jan2025.csv
deleted file mode 100644
index 177fcadd..00000000
--- a/docs/assets/openManus/amazon_sales_jan2025.csv
+++ /dev/null
@@ -1,32 +0,0 @@
-Date,Orders,Unique Customers,Units Sold,Gross Sales,Shipping Revenue,Coupon Discounts,Amazon Fees,Product Costs,Net Profit
-2025-01-01,37,37,83,4813.44,275.91,706.65,734.33,2241.35,1407.02
-2025-01-02,43,43,111,6182.74,489.61,833.44,848.23,2936.95,2053.73
-2025-01-03,32,31,114,6914.35,427.26,888.52,1074.84,3491.21,1887.05
-2025-01-04,41,41,91,6138.23,471.18,643.65,747.82,3200.84,2017.1
-2025-01-05,46,46,102,7394.39,509.73,966.82,903.9,3815.65,2217.75
-2025-01-06,32,32,116,9157.3,676.22,1369.04,1550.84,4377.13,2536.5
-2025-01-07,35,35,86,4861.82,316.4,520.24,688.49,2652.06,1317.44
-2025-01-08,38,38,99,5039.76,339.21,634.59,643.19,2639.77,1461.42
-2025-01-09,41,40,114,3188.5,206.54,458.72,482.53,1611.58,842.2
-2025-01-10,35,34,101,7134.65,398.52,977.72,1185.78,3647.03,1722.64
-2025-01-11,38,37,92,7297.66,523.05,984.09,970.22,3590.15,2276.24
-2025-01-12,33,33,96,4047.84,236.49,546.96,637.02,1921.81,1178.54
-2025-01-13,41,41,96,6275.02,318.33,740.29,785.14,3047.13,2020.79
-2025-01-14,41,41,107,7174.17,497.63,822.73,883.15,3772.07,2193.85
-2025-01-15,79,78,93,11752.01,650.04,1650.78,1784.91,5305.32,3661.04
-2025-01-16,42,42,95,6619.66,517.75,930.1,1009.09,3055.68,2142.54
-2025-01-17,30,30,101,5610.81,441.11,804.33,887.89,2550.68,1809.03
-2025-01-18,34,33,94,3523.28,272.86,513.21,576.29,1599.82,1106.82
-2025-01-19,35,35,93,6922.58,423.0,869.25,1236.03,3707.36,1532.94
-2025-01-20,40,39,93,7336.22,370.21,917.58,1107.61,3817.52,1863.72
-2025-01-21,51,50,109,6450.31,502.15,902.49,899.03,3208.5,1942.45
-2025-01-22,41,40,108,3916.81,246.15,518.97,656.89,1800.89,1186.22
-2025-01-23,29,29,105,4221.79,333.52,570.36,575.22,2107.36,1302.38
-2025-01-24,24,24,102,3652.92,288.25,510.64,534.56,1816.77,1079.19
-2025-01-25,37,37,112,6503.53,491.6,939.76,811.04,3039.23,2205.1
-2025-01-26,46,46,91,7251.14,426.61,847.66,881.17,3577.61,2371.32
-2025-01-27,35,35,104,5985.29,368.41,710.93,1063.94,2931.9,1646.94
-2025-01-28,31,31,92,6759.36,510.56,707.7,1150.17,3457.99,1954.07
-2025-01-29,44,44,90,4047.1,240.83,521.73,654.65,2078.22,1033.33
-2025-01-30,43,42,98,5567.35,306.68,566.74,804.69,2530.53,1972.07
-2025-01-31,44,44,88,3293.75,219.71,406.05,429.5,1605.58,1072.33
diff --git a/docs/assets/openManus/aov_trend.png b/docs/assets/openManus/aov_trend.png
deleted file mode 100644
index 31cafa7834ff3a7114e61fa0beba7e3c21b3bf55..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 326655
zcmeEubyU{b+BOq9Gb%DO1`3E>lr%o138H{Ory>H<$U~>2BN&9Dbg4*}bc2e7bR#WN
zKBTntcWsZJGw=G&_y70D>sn`>F?iy)_rC9|?tSlqoD}^!rge05boA0^PF