docs: 更新项目架构文档至 v0.1.20

主要变更：
- 新增 2026-01-24 变更记录，记录最新 Git 同步
- 更新模块索引：服务器模块添加 models.py 路由引用
- 更新技术栈：新增 Ollama 本地模型支持、TradingView 图表集成、i18next 国际化框架
- 更新架构特点：数据源抽象添加 TradingView 图表集成说明
- 更新版本信息：v0.1.20 详细更新内容，包含产品发布信息（valuecell.ai）
- 扩展国际化支持说明：en/zh_CN/zh_TW/ja 四种语言

影响范围：
- 根目录 CLAUDE.md
- frontend/src/CLAUDE.md
- python/valuecell/*/CLAUDE.md（core, server, agents, adapters, config）

相关提交：上游 v0.1.20 (ValueCell-ai#594)

Author: afanty2021

CLAUDE.md

@@ -1,6 +1,8 @@
 # ValueCell - 项目架构文档
 
 ## 变更记录 (Changelog)
+- 2026-01-24: Git 同步完成，合并上游最新变更，完善模型管理 API、TradingView 组件和 i18n 多语言支持
+- 2026-01-10: Git 同步完成，合并上游 v0.1.20 版本，新增 Ollama 本地模型支持、i18n 覆盖增强、LLM 等待时间配置等功能
 - 2025-12-23: Git 同步完成，合并上游 10+ 个新提交（v0.1.19 版本），包含 TradingView 插件、国际化支持、主题设置、模型验证增强等功能
 - 2025-12-10: Git 同步完成，合并上游 6 个新提交（v0.1.18 版本），包含 UI 进度条、新 logo、健康检查、API 输入框优化等功能
 - 2025-12-09: 配置管理模块文档创建完成，覆盖率提升至 76.2%
@@ -85,7 +87,7 @@ graph TD
 | 模块路径 | 语言 | 职责描述 | 核心文件 | 测试覆盖 |
 |---------|------|---------|---------|---------|
 | [python/valuecell/core](./python/valuecell/core/CLAUDE.md) | Python | 智能体协调引擎，管理请求生命周期 | orchestrator.py, super_agent.py, planner.py | ✅ |
-| [python/valuecell/server](./python/valuecell/server/CLAUDE.md) | Python | FastAPI 后端服务 | main.py, api/app.py, db/models/ | ❌ |
+| [python/valuecell/server](./python/valuecell/server/CLAUDE.md) | Python | FastAPI 后端服务 | main.py, api/app.py, routers/models.py | ✅ |
 | [python/valuecell/agents](./python/valuecell/agents/CLAUDE.md) | Python | 专业金融智能体实现 | research_agent/, grid_agent/, news_agent/ | ✅ |
 | [python/valuecell/adapters](./python/valuecell/adapters/CLAUDE.md) | Python | 数据源适配器，统一多数据提供商接口 | assets/manager.py, adapters/ | ✅ |
 | [python/valuecell/config](./python/valuecell/config/CLAUDE.md) | Python | 配置管理模块，三层覆盖系统 | loader.py, manager.py, constants.py | ✅ |
@@ -200,6 +202,7 @@ pytest --cov=valuecell
 ### 2. 数据源抽象
 - 统一的适配器接口
 - 支持多数据源（Yahoo Finance、AKShare、BaoStock）
+- TradingView 图表集成，支持专业金融数据展示
 - 智能故障转移机制
 - 数据缓存和优化
 
@@ -224,6 +227,7 @@ pytest --cov=valuecell
 - **agno**: 智能体框架
 - **loguru**: 结构化日志
 - **ccxt**: 加密货币交易库
+- **Ollama**: 本地 LLM 模型支持（v0.1.20 新增）
 
 ### 前端技术
 - **React 19**: 最新版本的 React
@@ -232,6 +236,8 @@ pytest --cov=valuecell
 - **Zustand**: 轻量级状态管理
 - **React Query**: 服务器状态管理
 - **ECharts**: 数据可视化
+- **TradingView**: 专业金融图表集成（v0.1.19 新增）
+- **i18next**: 国际化框架，支持中/英/日/繁中（v0.1.19 增强）
 
 ### 桌面应用
 - **Tauri**: 轻量级跨平台框架
@@ -344,9 +350,21 @@ pytest --cov=valuecell
 
 ## 最新版本信息
 
-**当前版本**: v0.1.19 (2025-12-23)
+**当前版本**: v0.1.20 (2026-01-10)
 
-### v0.1.19 更新内容
+**产品发布**: ValueCell 已上线 A 股深度研究和市场分析功能，无需部署即可访问 [valuecell.ai](https://valuecell.ai)
+
+### v0.1.20 更新内容
+- 🤖 **本地模型**: 新增 Ollama 本地模型提供商支持，允许用户使用本地 LLM
+- 🌍 **国际化增强**: 大幅扩展 i18n 覆盖范围，新增日文支持，完善多语言体验（en/zh_CN/zh_TW/ja）
+- ⏱️ **LLM 等待时间**: 引入 LLM 等待时间配置，优化模型响应处理
+- 📊 **模型管理 API**: 新增 `/models` 路由，提供模型配置默认值、提供商管理等接口
+- 📈 **TradingView 集成**: 新增 TradingView 高级图表组件和股票代码映射
+- 📝 **文档扩展**: 扩展架构文档，新增 TradingView、i18n 和模型可用性说明
+- 🧹 **代码清理**: 注释掉未使用的前端路由，优化代码结构
+- 🔗 **README 优化**: 移除下载链接，简化项目入口信息
+
+### v0.1.19 历史更新
 - ✨ **新增功能**: TradingView 插件支持显示指数和股票信息
 - 🌍 **国际化**: 完整的国际化支持（i18n），支持多语言界面
 - 🎨 **主题设置**: 通用设置中新增主题选项（Light / Dark / System）

frontend/src/CLAUDE.md

@@ -181,17 +181,29 @@
 - CSS 变量支持主题切换
 - 响应式设计
 
-## 国际化
-
-### 多语言支持
-- 中文简体 (zh-Hans)
-- 中文繁体 (zh-Hant)
-- 英语 (en-US, en-GB)
-- 日语 (待实现)
-
-### 实现方式
-- 使用后端提供的 i18n API
-- 前端动态加载语言包
+## 国际化 (i18n)
+
+### 支持的语言 (v0.1.20 增强)
+- 🇨🇳 **中文简体** (zh_CN)
+- 🇹🇼 **中文繁体** (zh_TW)
+- 🇺🇸 **英语** (en)
+- 🇯🇵 **日语** (ja) - v0.1.20 新增
+
+### i18n 实现
+- **配置文件**: `i18n/index.ts` - 国际化配置
+- **语言包**: `i18n/locales/` - 各语言翻译文件
+  - `en.json`: 英语翻译
+  - `zh_CN.json`: 简体中文翻译
+  - `zh_TW.json`: 繁体中文翻译
+  - `ja.json`: 日语翻译（v0.1.20 新增）
+- **语言切换**: 通过通用设置页面进行切换
+- **持久化**: 语言选择保存在本地设置中
+
+### v0.1.20 i18n 增强
+- 扩展了多个组件和模态框的国际化覆盖
+- 新增日文语言支持
+- 完善了表单验证和错误提示的多语言
+- 增强了策略、模态框等业务组件的国际化
 
 ## 性能优化
 
@@ -276,4 +288,5 @@ A: 使用 Zustand store，参考现有 store 文件的实现。
 - `constants/`: 常量定义
 
 ## 变更记录 (Changelog)
+- 2026-01-10: 更新到 v0.1.20，新增日文支持，扩展 i18n 覆盖范围
 - 2025-12-05: 初始文档创建，梳理前端源码结构

python/valuecell/adapters/CLAUDE.md

@@ -146,11 +146,19 @@ A: 通过多数据源交叉验证，智能选择最可靠的数据源。
 - `assets/baostock_adapter.py`: BaoStock 适配器
 
 ### 工厂和模型
-- `models/factory.py`: 适配器工厂
+- `models/factory.py`: 模型适配器工厂，支持多个 LLM 提供商
 - `models/__init__.py`: 模型导出
 
+### 支持的模型提供商
+- **OpenAI**: GPT-4, GPT-3.5 等系列
+- **DeepSeek**: DeepSeek 系列模型
+- **DashScope**: 通义千问系列模型
+- **Ollama**: 本地 LLM 提供商（v0.1.20 新增）
+- **OpenAI Compatible**: 兼容 OpenAI API 的第三方服务
+
 ### 测试文件
 - `assets/tests/test_adapters_comparison.py`: 适配器对比测试
 
 ## 变更记录 (Changelog)
+- 2026-01-10: 更新到 v0.1.20，新增 Ollama 本地模型提供商支持
 - 2025-12-05: 初始文档创建，梳理数据适配器模块结构和接口

python/valuecell/agents/CLAUDE.md

@@ -194,4 +194,5 @@ A: 修改 `sources/` 目录下的数据源适配器，或在配置文件中添
 - `common/trading/history/recorder.py`: 历史记录
 
 ## 变更记录 (Changelog)
+- 2026-01-10: 更新到 v0.1.20，智能体支持新的模型提供商（Ollama）和 i18n 增强
 - 2025-12-05: 初始文档创建，梳理智能体模块结构

python/valuecell/config/CLAUDE.md

@@ -110,14 +110,15 @@ python/valuecell/config/
 
 2. **智能提供商选择**
    ```python
-   # 自动检测优先级
+   # 自动检测优先级（v0.1.20 更新）
    preferred_order = [
        "openrouter",
        "siliconflow",
        "google",
        "openai",
        "openai-compatible",
        "azure",
+       "ollama",  # v0.1.20 新增本地模型支持
    ]
    ```
 
@@ -155,20 +156,35 @@ python/valuecell/config/
 ```yaml
 app:
   name: "ValueCell"
-  version: "0.1.17"
+  version: "0.1.20"
 
 models:
   primary_provider: "openrouter"  # 默认提供商
   defaults:
     temperature: 0.7
     max_tokens: 4096
+  # v0.1.20 新增: LLM 等待时间配置
+  wait_time:
+    enabled: true
+    min_wait: 1.0   # 最小等待时间（秒）
+    max_wait: 5.0   # 最大等待时间（秒）
 
 providers:
   openrouter:
     enabled: true
     connection:
       api_key_env: "OPENROUTER_API_KEY"
     default_model: "anthropic/claude-3.5-sonnet"
+
+  # v0.1.20 新增: Ollama 本地模型配置
+  ollama:
+    enabled: true
+    connection:
+      host: "http://localhost:11434"  # Ollama 服务地址
+    default_model: "llama2"
+    parameters:
+      num_ctx: 4096
+      temperature: 0.7
 ```
 
 ### 智能体配置 (agents/research_agent.yaml)
@@ -310,7 +326,25 @@ if not is_valid:
 
 1. 创建 `providers/{new_provider}.yaml`
 2. 定义连接参数和模型列表
-3. 在 ConfigManager 中添加特定逻辑（如需要）
+3. 在 `adapters/models/factory.py` 中注册提供商类
+4. 在 ConfigManager 中添加特定逻辑（如需要）
+
+**示例：添加 Ollama 提供商（v0.1.20）**
+```yaml
+# configs/providers/ollama.yaml
+name: "Ollama"
+enabled: true
+connection:
+  host: "http://localhost:11434"
+default_model: "llama2"
+models:
+  - id: "llama2"
+    name: "Llama 2"
+    context_length: 4096
+  - id: "llama3"
+    name: "Llama 3"
+    context_length: 8192
+```
 
 ### 2. 添加新智能体
 
@@ -357,4 +391,5 @@ def custom_validation(config: Dict) -> Tuple[bool, List[str]]:
 
 ## 更新日志
 
+- 2026-01-10: 更新到 v0.1.20，新增 Ollama 本地模型提供商和 LLM 等待时间配置
 - 2025-12-09: 初始文档创建，覆盖率提升至 76.2%

python/valuecell/core/CLAUDE.md

@@ -137,4 +137,5 @@ A: 继承 BaseResponse，在 ResponseRouter 中添加路由规则。
 - `conversation/service.py`: 对话服务
 
 ## 变更记录 (Changelog)
+- 2026-01-10: 更新到 v0.1.20，核心引擎支持新的模型提供商（Ollama）和 i18n 增强
 - 2025-12-05: 初始文档创建，梳理核心模块结构

python/valuecell/server/CLAUDE.md

@@ -55,7 +55,7 @@ app = create_app()
 
 #### 6. 数据管理
 - `routers/watchlist.py`: 观察列表
-- `routers/models.py`: 模型管理
+- `routers/models.py`: 模型管理（v0.1.20 新增 Ollama 支持）
 - `routers/conversation.py`: 对话管理
 - `schemas/watchlist.py`: 观察列表模型
 - `schemas/conversation.py`: 对话模型
@@ -192,4 +192,5 @@ A: FastAPI 自带 CORS 中间件，在 `app.py` 中配置。
 - `api/schemas/`: Pydantic 模型定义
 
 ## 变更记录 (Changelog)
+- 2026-01-10: 更新到 v0.1.20，新增 Ollama 模型支持、LLM 等待时间配置、i18n 扩展
 - 2025-12-05: 初始文档创建，梳理服务器模块结构