新增三大股东接口, 补充 SKILLS.md 使用说明书

- 新增 十大流通股东/十大股东明细/股东户数 三个抓取模块并接入 API
- 冒烟测试扩展至 30 用例, 全部通过
- 新增 SKILLS.md (给其他 agent 使用的工具说明书)
- 补充待优化端点清单与文档对齐规范
This commit is contained in:
2026-08-15 10:33:47 +08:00
parent 11ddbd3c49
commit 797369bbed
11 changed files with 561 additions and 3 deletions
+11 -2
View File
@@ -35,7 +35,10 @@ EMWebApi/
│ ├── fin_operate.py # 营运能力
│ ├── fin_growth.py # 成长能力
│ ├── fin_dupont.py # 杜邦分析
│ └── fin_dividend.py # 分红明细 + 分红统计
│ ├── fin_dividend.py # 分红明细 + 分红统计
│ ├── fin_free_holders.py # 十大流通股东
│ ├── fin_holders.py # 十大股东明细
│ ├── fin_holder_num.py # 股东户数
├── tests/
│ └── test_interfaces.py # 冒烟测试 (连真实接口)
└── docs/
@@ -65,6 +68,9 @@ EMWebApi/
| 9 | 成长能力 | `CWFX_CZNL` → `RPT_HSF9_FINA_GROWTH` | ✅ 已实现 |
| 10 | 杜邦分析 | `RPT_HSF9_FINA_DUPONT` | ✅ 已实现 |
| 11 | 分红明细 + 分红统计 | `RPT_HSF9_ASSIGNPLAN_DETAIL` / `_STATICS` | ✅ 已实现 |
| 12 | 十大流通股东 | `RPT_F10_EH_FREEHOLDERS` | ✅ 已实现 |
| 13 | 十大股东明细 | `RPT_DMSK_HOLDERS` | ✅ 已实现 |
| 14 | 股东户数 | `RPT_F10_EH_HOLDERNUM` | ✅ 已实现 |
**文档外补充**:财务摘要(报告期) 用 `RPT_CUSTOM_ORGF9_FIN_SUMMARY`,需 ORG_CODE(不在 api_docs.md 里)。
@@ -88,7 +94,10 @@ EMWebApi/
| 成长能力 | `utils/fin_growth.py` | `GET /fin/growth` |
| 杜邦分析 | `utils/fin_dupont.py` | `GET /fin/dupont` |
| 分红明细 + 统计 | `utils/fin_dividend.py` | `GET /fin/dividend-detail` / `dividend-statics` |
| 测试 | `tests/test_interfaces.py` | `uv run pytest tests/ -q` (24 用例) |
| 十大流通股东 | `utils/fin_free_holders.py` | `GET /fin/free-holders` |
| 十大股东明细 | `utils/fin_holders.py` | `GET /fin/holders` |
| 股东户数 | `utils/fin_holder_num.py` | `GET /fin/holder-num` |
| 测试 | `tests/test_interfaces.py` | `uv run pytest tests/ -q` (30 用例) |
### 🧹 待清理