⚡ spr

spr — Strategic Portfolio Report

原名	fof-portfolio-report（已改名 spr）
类别	用户安装
来源	`https://git.atibm.com/at/skill-portfolio-report.git`
安装路径	`/opt/data/home/skill-portfolio-report/`
Skill 文件	`/opt/data/skills/financial-services/spr/SKILL.md`
分支模型	`main`（稳定） + `dev`（长期开发） + `fix/xxx`/`feature/xxx`（短生命分支）
CLI 入口	`spr`（`~/skill-portfolio-report/scripts/spr`）
当前版本	v1.0.0（2026-06-01）

功能概述

AI-powered 投资组合对比报告生成器。从 FOF/SPR 回测数据（评价指标 CSV + 资金结算日频净值 CSV + 资产 CSV）自动生成面向投资人的 ECharts 可视化 HTML 报告。

核心能力

数据输入：支持标准命名目录、业务命名目录、FOF2026 命名格式、zip 压缩包自动检测
回测评价指标：年化收益率、最大回撤、波动率、卡玛比率、夏普比率
净值曲线：从资金结算 CSV 提取日频净值绘制收益曲线
标的级数据：从资产 CSV 提取每个标的的累计收益率
分组详情：逐场景表格，标的+管理人=行，累计收益率+评价指标=列
可视化：ECharts 5.x 深色金融风，含柱状图、散点图、秩次图、净值曲线
叙事分析：4 种策略对比 + 分组对比分析
分组对比：稳定性/相关性子分类，FOF2026 四维业务字段（滤日期/评估期/夏普筛选/筛选类型）

CLI 用法

spr /path/to/data          → 生成报告（自动检测目录/zip/URL）
spr update                 → 从远端 tag 拉取最新版并安装
spr version                → 显示版本、安装日期、git 仓库信息

更新流程

spr update 内部由 CLI 脚本处理完整 git 生命周期：

save_git_state()：保存当前分支 + stash 未提交变更
切换到目标分支 → git pull（已最新则跳过）
install_to_hermes()：同步到 Hermes skill 目录
write_version_meta()：更新 VERSION.json
restore_git_state()：切回原分支 + pop stash

AI 仅需执行 spr update 并转发 CLI 输出，不做额外 git 操作。

分支模型

main        ← stable, production-ready
dev         ← 长期开发分支
fix/xxx     ← 短期修复分支，基于 dev，合并至 main，然后 dev 同步 main
feature/xxx ← 短期功能分支（同 fix 模式）
tag         ← 在 main 上标记版本（v1.0.0、v1.1 等）

合并回填模式：fix/feature 分支合并入 main 后，dev 必须 merge main 保持同步。

策略配色

■ 只用组合算法	■ 只用风筹
■ 满仓等权（基准）	■ 管理人003_FOF

v1.0.0 变更（2026-06-01）

STDD 可视化增强：回测周期智能格式化、筛选分组方法提取、场景名用目录短名、净值曲线高度+75°日期轴、标的曲线默认隐藏/单元素legend切换、夏普/卡玛拆为独立柱状图、散点图tooltip修复、所有数字保留3位小数
分支模型重构：从 iter 分支 → main + dev + fix/feature 分支模型
SKILL.md 重构：新增 AI 执行流程章节（spr update / spr version），指引 AI 调用 CLI 而非手动 git
CLI 更新：update 子命令从 local → tag 安装，增加 save_git_state/restore_git_state 保护

版本历史

版本	日期	说明
v1.0.0	2026-06-01	可视化增强 + 分支模型重构 + SKILL.md AI执行流程修正
v0.1.0	2026-05-28	首个正式发布版本（含全部迭代修复）