\r \r

财经日报 (Finance Daily Report)\r

\r

Overview\r

\r Generate a professional, interactive HTML financial daily report covering A-shares, Hong Kong stocks, and major global indices. The report follows Chinese stock market conventions (red for up, green for down) and uses AKShare for free real-time data.\r \r

When to Use\r

\r Trigger this skill when the user asks for:\r

• 财经日报 / 今日财经 / 股市日报\r
• A daily financial market report\r
• Stock market overview or analysis\r
• 大盘分析 / 今日股市 / 金融日报\r
• Any request involving generating a daily financial summary\r \r

Workflow\r

\r

Step 1: Prepare Environment\r

\r Before running the script, ensure dependencies are installed:\r \r

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple akshare pandas --trusted-host pypi.tuna.tsinghua.edu.cn\r
```\r
\r
Use the managed Python runtime at `C:/Users/PC/.workbuddy/binaries/python/versions/3.13.12/python.exe` and create/use a venv if needed.\r
\r
### Step 2: Run the Report Generator\r
\r
Execute the main script to generate the report:\r
\r
```bash\r
python scripts/generate_report.py [--output \x3Cpath>] [--date YYYY-MM-DD]\r
```\r
\r
Options:\r
- `--output`: Output HTML file path (default: current working directory `finance_daily_report_YYYY-MM-DD.html`)\r
- `--date`: Target date in YYYY-MM-DD format (default: today). Note: only historical dates work for complete data; today may have incomplete real-time data.\r
\r
### Step 3: Present the Report\r
\r
After generation, present the HTML file to the user using `present_files`. The report is a self-contained interactive HTML file that opens directly in the browser.\r
\r
## Report Modules\r
\r
The generated report includes 6 modules:\r
\r
1. **大盘指数概览** — A-share main indices (SSE, SZSE, ChiNext, STAR 50), Hang Seng, Hang Seng Tech, with real-time price, change %, and change amount.\r
2. **行业板块热力** — Top 5 gaining and top 5 declining industry sectors with representative stocks.\r
3. **资金流向** — North-bound capital flow, total market turnover, main capital flow direction.\r
4. **外汇与商品** — USD/CNY exchange rate, gold price, crude oil price.\r
5. **财经要闻** — Key financial news headlines for the day.\r
6. **明日关注** — Financial calendar events and upcoming economic data releases.\r
\r
## Visual Conventions\r
\r
- **Red (红色 #e74c3c)**: Price increase (涨) — Chinese market convention\r
- **Green (绿色 #27ae60)**: Price decrease (跌) — Chinese market convention\r
- Interactive charts powered by Chart.js (loaded from CDN)\r
- Responsive design, mobile-friendly\r
\r
## Data Sources\r
\r
The script uses the following AKShare data sources (v1.18+ optimized for China network):\r
\r
| Module | API | Source |\r
|--------|-----|--------|\r
| A-share indices | `ak.stock_zh_index_spot_sina()` | Sina (reliable in China) |\r
| HK indices | `ak.stock_hk_index_spot_sina()` | Sina |\r
| Industry sectors | `ak.stock_board_industry_summary_ths()` | TongHuaShun (THS) |\r
| North-bound flow | `ak.stock_hsgt_hist_em(symbol='沪股通')` | EastMoney |\r
| Turnover | Calculated from `stock_zh_index_spot_sina()` | Sina |\r
| Forex | `ak.fx_spot_quote()` | - |\r
| Commodities | `ak.futures_global_spot_em()` | EastMoney |\r
| News | `ak.stock_news_em()` | EastMoney |\r
\r
See `references/akshare_apis.md` for detailed API mappings and column schemas.\r
\r
## Important: Encoding\r
\r
On Windows, always set `PYTHONIOENCODING=utf-8` when running the script to avoid GBK encoding errors:\r
\r
```bash\r
PYTHONIOENCODING=utf-8 python scripts/generate_report.py --date 2026-06-16\r
```\r
\r
## Error Handling\r
\r
- Each API call includes automatic 2-retry with 1s delay for transient failures\r
- Failed modules gracefully degrade: show "暂无数据" placeholder in report\r
- Sina-based APIs (`stock_zh_index_spot_sina`, `stock_hk_index_spot_sina`) are preferred over EastMoney for reliability in China\r
- If AKShare is not installed, guide the user to install it first\r