$npx -y skills add FTShare-Lab/FTShare-skills --skill fund-cal-return-single-fund-specific-periodGet cumulative return time series for a specific fund over a given period. Use when user asks about 基金累计收益率, 近1年/近3个月收益, YTD收益, 基金收益曲线.
| 1 | # 查询指定基金在指定区间的累计收益率 |
| 2 | |
| 3 | ## 参数 |
| 4 | |
| 5 | | 参数 | 类型 | 必填 | 说明 | 示例 | |
| 6 | |------|------|------|------|------| |
| 7 | | `--institution-code` | string | 是 | 6 位数字基金代码 | `159619` | |
| 8 | | `--cal-type` | string | 是 | 区间类型:`1M` / `3M` / `6M` / `1Y` / `3Y` / `5Y` / `YTD` | `1Y` | |
| 9 | |
| 10 | ## 用法 |
| 11 | |
| 12 | 通过主目录 `run.py` 调用(必填 `--institution-code`、`--cal-type`): |
| 13 | |
| 14 | ```bash |
| 15 | python <RUN_PY> fund-cal-return-single-fund-specific-period --institution-code 159619 --cal-type 1Y |
| 16 | ``` |
| 17 | |
| 18 | `<RUN_PY>` 为主 SKILL.md 同级的 `run.py` 绝对路径。脚本输出 JSON 数组,每项含 `date`(YYYYMMDD 整型)和 `return`(小数形式累计收益率),按时间序列展示。 |
| 19 | |
| 20 | ## 注意 |
| 21 | |
| 22 | - 响应为数组,不是分页结构 |
| 23 | - `return` 为小数(如 0.0234 表示 2.34%),展示时可乘以 100 转为百分比 |
| 24 | - 区间选项:`1M`(近1月)、`3M`(近3月)、`6M`(近6月)、`1Y`(近1年)、`3Y`(近3年)、`5Y`(近5年)、`YTD`(今年来) |
| 25 | - 若用户只给基金名称,建议先用 `fund-support-symbols-all-funds-paginated` 或 `fund-overview-all-funds-paginated` 查到对应 6 位 `institution-code` 再查询收益。 |