� Important Clarification - DashScope API Key Requirements:
� Updated Documentation:
- docs/en-US/quick_start_guide.md
- docs/en-US/configuration_guide.md
- .env.example
� DashScope API Key is ONLY required when:
1. � Analyzing Chinese A-share stocks (uses TongDaXin data + DashScope embeddings)
2. � Choosing DashScope as LLM provider (Qwen models)
✅ For US Stock Analysis:
- OpenAI + FinnHub: ✅ No DashScope needed
- Google AI + FinnHub: ✅ No DashScope needed
- Anthropic + FinnHub: ✅ No DashScope needed
✅ DashScope Required Cases:
- China A-Share + Any LLM: ✅ DashScope needed (for embeddings)
- US Stock + DashScope LLM: ✅ DashScope needed (for Qwen models)
- China A-Share + DashScope LLM: ✅ DashScope needed (both reasons)
� Updated Configuration Examples:
- Example 1: US stocks with OpenAI (no DashScope)
- Example 2: US stocks with Google AI (no DashScope)
- Example 3: China A-shares (DashScope required)
- Example 4: US stocks with DashScope LLM (DashScope required)
- Example 5: Full features with database
� Key Benefits:
- Users can start with familiar LLM providers (OpenAI/Google)
- DashScope only needed for Chinese market features
- Clear separation of requirements by use case
- Reduced barrier to entry for US-only users
This clarification makes it easier for users to understand
exactly when they need which API keys based on their
specific use case and market focus.
� Market Selection Simplification:
- Remove all Chinese text from CLI interface
- Remove Hong Kong Stock support (as requested)
- Keep only US Stock and China A-Share markets
- English-only error messages and validation
� Supported Markets:
1. US Stock
- Examples: SPY, AAPL, TSLA, NVDA, MSFT
- Format: 1-5 letter stock symbols
- Data Source: Yahoo Finance
- Pattern: ^[A-Z]{1,5}$
2. China A-Share
- Examples: 000001, 600036, 300001, 688001
- Format: 6-digit numeric codes
- Data Source: TongDaXin API
- Pattern: ^\d{6}$
� Technical Changes:
- Simplified market selection function
- Removed Chinese text from all user-facing messages
- Maintained TongDaXin integration for A-shares
- Kept format validation and data source routing
- English-only interface throughout
✅ Test Results:
- Market Selection: ✅ Pass
- Supported Markets: ✅ Pass (US + China A-Share only)
- Ticker Validation: ✅ Pass (English messages)
- Data Source Routing: ✅ Pass
- English-Only Interface: ✅ Pass
� User Experience:
- Clean English-only interface
- Two clear market options
- Automatic format validation
- TongDaXin real-time data for A-shares
- No language barriers for international users
Supported Chinese Exchanges:
• Shanghai Stock Exchange: 60xxxx
• Shenzhen Stock Exchange: 00xxxx
• ChiNext Board: 30xxxx
• STAR Market: 68xxxx
� Fixed Issues:
- Resolve 404 error when using DashScope LLM with OpenAI embeddings
- Add missing DashScope model options in CLI selection
- Improve embedding provider fallback logic
� Memory System Updates:
- Add DashScope embedding support (text-embedding-v3)
- Implement intelligent fallback: DashScope → OpenAI → Error
- Add proper API key validation and error messages
- Support multiple embedding providers based on LLM selection
� CLI Enhancements:
- Add DashScope models to SHALLOW_AGENT_OPTIONS and DEEP_AGENT_OPTIONS
- Support qwen-turbo, qwen-plus, qwen-max, qwen-max-longcontext
- Fix KeyError when selecting DashScope as LLM provider
✅ Test Results:
- All .env configuration tests pass
- DashScope embeddings working correctly
- Proper fallback to OpenAI when DashScope unavailable
- Memory initialization successful with real API keys
� Now users can successfully:
1. Select DashScope in CLI without errors
2. Use DashScope embeddings for memory system
3. Automatic fallback if DashScope unavailable
4. Complete end-to-end DashScope workflow
liuping