ValueCell 仓库介绍
ValueCell 是一个社区驱动的多智能体（Multi-Agent）金融应用平台，核心目标是构建全球最大的去中心化金融智能体社区，为用户提供股票选股、深度研究、市场跟踪甚至交易执行等一站式金融服务，且核心敏感数据本地存储，保障数据安全。
一、核心定位与功能
1. 核心价值
- 无需部署即可访问 A 股深度研究、市场分析能力（官网：valuecell.ai）；
- 内置顶尖投资智能体（Agent），覆盖选股、研究、跟踪、交易全流程；
- 敏感数据本地存储，核心数据安全可控；
- 仅用于技术交流，投资有风险，团队不会主动联系社区成员。
2. 关键功能
| 模块 | 能力说明 |
|---|---|
| 多智能体系统 | - DeepResearch Agent：自动检索/分析基本面文档，生成数据洞察与可解释摘要 - Strategy Agent：支持多加密资产、多策略智能交易 - News Retrieval Agent：个性化定时新闻推送，实时跟踪关键信息 |
| 灵活集成能力 | - 多 LLM 提供商：OpenRouter/SiliconFlow/Azure/OpenAI/DeepSeek 等 - 多市场数据：美股/加密货币/港股/A 股等 - 多框架兼容：Langchain、Agno（A2A Protocol） - 交易所对接：OKX、Binance 等（内置风控） |
| 交易能力 | 支持纸交易（Paper Trading）、实盘交易（基于 CCXT 对接交易所），含组合管理、交易历史记录模块 |
二、技术架构
仓库采用前后端分离 + 本地存储的架构，兼顾跨平台性和数据安全性：
1. 目录结构核心模块
valuecell/
├── frontend/ # 前端（跨平台客户端）
├── python/ # 后端核心（多智能体、数据库、交易逻辑）
├── assets/ # 产品截图、架构图等静态资源
├── docs/ # 配置指南等文档
├── docker/ # 容器化相关（未展示细节）
└── 多语言文档 # README.md/zh.md/zh_Hant.md/ja.md
2. 前端（frontend）
- 技术栈：React + TypeScript + Zustand（状态管理） + Tauri（跨平台桌面应用）；
- 核心功能：
- 自选股（Watchlist）管理（增删查改、价格/历史数据查询）；
- 股票详情、K 线历史数据展示；
- 系统状态（用户信息、Token）持久化存储；
- 多语言适配、接口请求封装（React Query 管理异步数据）。
3. 后端（python）
- 架构模式：采用 Repository 模式管理数据库操作，分层设计（API → Service → Repository → DB）；
- 核心模块：
server/db/repositories：资产（Asset）、策略（Strategy）、自选股（Watchlist）的 CRUD 操作，支持本地 SQLite/LanceDB；agents/common/trading：交易代理框架（市场快照、决策生成、交易执行、组合管理、历史记录）；server/api：REST API 层，提供应用信息、股票数据、智能体配置等接口；- 配置系统：支持多环境配置，本地数据库文件可清理（解决兼容性问题）。
三、使用与部署
1. 快速上手（新用户）
- 从 GitHub Releases 下载 MacOS/Windows 客户端；
- 首次使用配置：
- 填写 LLM 提供商 API Key（如 OpenAI/DeepSeek）；
- 配置交易所凭证（Binance/OKX/Coinbase 等，可选）；
- 直接使用内置智能体功能。
2. 本地运行（开发者）
- Windows：执行
.\start.ps1； - 清理数据库兼容问题：删除本地 LanceDB/知识目录/SQLite 文件（路径随系统不同，参考
docs/CONFIGURATION_GUIDE.md）。
四、其他说明
- 多语言支持：文档覆盖英文、简体中文、繁体中文、日语；
- 社区生态：提供 Discord 社区（邀请链接），支持开发者贡献代码、反馈问题；
- 开源许可：基于 Apache 2.0 协议开源；
- 技术栈补充：后端依赖 Python 3.12+，前端使用 Vite/Tauri 构建跨平台应用，数据库支持 SQLite（本地）、LanceDB 等。