a65adcc2e5
Sources: extracted from two upstream archives (skill-repo, skills-main),
merged with the following policy:
- 15 broken symlinks (pointing to /Users/jameslee/.cc-switch/skills or
../../.agents/skills on a foreign machine) discarded
- 3 real name collisions with identical content (ai-pair, ifind-http-api,
zhipu-websearch) kept as one copy
- Functional overlaps deduped keeping the strongest variant:
- docx family: kept docx (official, full toolchain) + docx-cn
(GB/T 9704 Chinese official-document constants),
dropped docx_writer (no scripts, name collided with docx)
- humanizer family: kept humanizer-zh (6 zh reference docs),
dropped humanizer (en, redundant for CN workflow)
- Skills that only ran in a foreign environment removed:
ablemind-ops, app-publish, hlb-design-system, openclaw-adj-skill,
claude-driver
- alphapai excluded from this public repo because its SKILL.md hard-coded
live credentials
Result: 25 skills, 572 files, ~7.5 MB.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
106 lines
3.1 KiB
Markdown
106 lines
3.1 KiB
Markdown
# Flow D — Tushare 实时数据→报告
|
||
|
||
使用 Tushare 金融数据 API 获取 A 股实时数据，通过变换处理后生成投资分析报告。
|
||
|
||
## 前置条件
|
||
|
||
1. 安装 tushare: `pip install tushare`
|
||
2. 配置 Token（任选一种）:
|
||
- 环境变量: `export TUSHARE_TOKEN=your_token_here`
|
||
- `.env` 文件（ppt-st 目录下）: `TUSHARE_TOKEN=your_token_here`
|
||
|
||
Token 获取: 注册 https://tushare.pro 后在个人主页获取。
|
||
|
||
## 方式一: Job JSON + run_job.py
|
||
|
||
适合声明式编排，数据获取和渲染一步完成。
|
||
|
||
### 完整 Tushare Job JSON 示例
|
||
|
||
```json
|
||
{
|
||
"template": {"path": "aim/aim03.pptx"},
|
||
"datasources": {
|
||
"stock": {
|
||
"type": "tushare",
|
||
"api_name": "pro_bar",
|
||
"ts_code": "600519.SH",
|
||
"start_date": "20250101",
|
||
"end_date": "20251231"
|
||
},
|
||
"index": {
|
||
"type": "tushare",
|
||
"api_name": "pro_bar",
|
||
"ts_code": "000300.SH",
|
||
"start_date": "20250101",
|
||
"end_date": "20251231"
|
||
}
|
||
},
|
||
"transforms": {
|
||
"chart_data": {
|
||
"from": ["stock", "index"],
|
||
"ops": [
|
||
{"type": "sort", "sort_by": ["trade_date"]},
|
||
{"type": "compute", "expr": "close / close.iloc[0] - 1", "output_col": "累计收益率"}
|
||
]
|
||
}
|
||
},
|
||
"slides": [
|
||
{
|
||
"id": "cover",
|
||
"texts": [
|
||
{"target": "标题", "value": "贵州茅台2025年度分析报告"},
|
||
{"target": "日期", "value": "2025-12-31"}
|
||
]
|
||
}
|
||
],
|
||
"output": {"path": "output/tushare_report.pptx", "overwrite": true}
|
||
}
|
||
```
|
||
|
||
```bash
|
||
python scripts/run_job.py tushare_job.json
|
||
```
|
||
|
||
### Tushare 数据源字段
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| `api_name` | `"pro_bar"`（股票日线）或 `"index_daily"`（指数日线）|
|
||
| `ts_code` | 证券代码，如 `"600519.SH"`, `"000300.SH"` |
|
||
| `start_date` | 起始日期 `"YYYYMMDD"` |
|
||
| `end_date` | 结束日期 `"YYYYMMDD"` |
|
||
|
||
返回的 DataFrame 已按 `trade_date` 升序排列，`trade_date` 为 datetime 类型。
|
||
|
||
常用字段: `trade_date`, `open`, `high`, `low`, `close`, `vol`, `amount`
|
||
|
||
## 方式二: gen_moutai_report.py 示例脚本
|
||
|
||
独立示例脚本，演示完整的 Tushare 数据获取 + 计算 + 报告生成流程:
|
||
|
||
```bash
|
||
python scripts/gen_moutai_report.py
|
||
```
|
||
|
||
该脚本:
|
||
1. 从 Tushare 获取贵州茅台和沪深300的当年及5年数据
|
||
2. 计算累计收益率、成交额等指标
|
||
3. 生成 CSV 中间文件
|
||
4. 通过 Flow A（模板替换）生成包含双轴图表的 PPT
|
||
|
||
输出目录: `ppt-st/output/moutai_report/`
|
||
|
||
**定位说明**: 此脚本是一个完整的端到端示例，展示了自定义数据处理 + PPT 生成的模式。对于新的报告需求，建议:
|
||
- 简单场景: 参考此脚本模式编写自定义脚本
|
||
- 声明式场景: 使用 Job JSON + `run_job.py`
|
||
|
||
## 常见问题
|
||
|
||
| 问题 | 解决方案 |
|
||
|------|---------|
|
||
| `Tushare token not configured` | 检查 TUSHARE_TOKEN 环境变量或 .env 文件 |
|
||
| API 调用频率限制 | Tushare 有调用频率限制，适当添加延时 |
|
||
| `pro_bar` 返回空数据 | 检查 ts_code 格式和日期范围是否有效 |
|
||
| 指数数据获取失败 | 使用 `api_name: "pro_bar"` + `asset: "I"` 替代 `index_daily` |
|