investment-pnl-daily-report

Overview

提供一套可复用的组合盈亏日报工作流：初始化模板、读取用户维护的持仓与基准、按统一口径计算多账户当日盈亏与持仓盈亏、持续维护净值时间序列，并输出 Markdown 日报、净值记录 CSV、净值走势图 HTML 与可选的短摘要文案。

When to Use

在以下场景触发本 skill：

• 用户要做“每日盈亏汇总”“持仓日报”“收盘汇总”“净值汇总”
• 用户要把多账户 A 股/港股持仓汇总到一个统一日报里
• 用户要维护净值基准、资金迁移口径、当日新增仓与旧仓的区分规则
• 用户要生成或更新净值走势小图、净值记录表、企微摘要模板
• 用户要把这套流程初始化成一个可配置、可迁移、可复用的日报模板

不用于以下场景：

• 单只股票是否买卖的投资建议：优先交给 trading-analysis
• 纯行情拉取、财报查询、资金流查询：优先交给 finance-data-retrieval
• 高度定制化量化回测或券商 API 自动下单

Quick Start

1. 初始化工作区

在没有现成日报工作区时，运行：

python3 scripts/init_report_workspace.py --target <目标目录>

默认会创建以下目录和文件：

• inputs/report-config.yaml
• inputs/current-holdings.md
• reports/nav-record.csv
• reports/nav-chart.html
• outputs/daily-report-template.md
• outputs/wecom-summary-template.md

2. 填写输入文件

优先要求用户维护两份输入：

1. inputs/report-config.yaml
• 控制时区、基准资金、报告名称、输出路径、默认口径
2. inputs/current-holdings.md
• 控制账户基准、当前持仓、现金基准、最近调仓记录

3. 运行日报流程

按以下顺序执行：

1. 读取配置与持仓底稿
2. 确认时间与口径
3. 拉取 A 股/港股价格与汇率
4. 计算分账户结果、组合结果与净值变化
5. 更新 reports/nav-record.csv
6. 输出日报 Markdown 与净值走势图
7. 如用户需要，再生成短摘要

Workflow

Step 1. 读取输入并识别本次任务类型

优先判断用户当前需求属于哪一类：

• 初始化类：首次搭建日报模板、复制到新 workspace、准备参赛演示环境
• 执行类：按当日口径生成一次盈亏日报
• 修正类：修正资金基准、调仓记录、现金口径、净值记录
• 展示类：更新净值图、压缩摘要、准备企微推送文案

始终先读：

• inputs/report-config.yaml
• inputs/current-holdings.md
• reports/nav-record.csv（若存在）

如文件缺失，优先运行初始化脚本补齐模板，而不是直接凭空编造结构。

Step 2. 确认时间与口径

在所有涉及“今天 / 昨天 / 盘中 / 收盘”的任务里，先确认当前时间，再决定使用哪一类价格：

• 收盘口径：市场已收盘且用户明确要收盘汇总
• 盘中口径：市场未收盘，或用户明确要盘中快照
• 历史复盘口径：用户明确指定某一交易日

对时间敏感任务，输出中必须明确写出：

• 当前时间
• 使用的价格口径
• 使用的汇率口径
• 是否存在兜底数据源

Step 3. 拉取数据

A 股 / 港股价格

优先使用 finance-data-retrieval 获取：

• A 股日线或分钟级价格
• 港股收盘价 / 昨收 / 当日行情
• 如有需要，补充指数或市场背景数据

汇率

涉及港股折算时：

• 优先使用当日可核验的公开 HKD/CNY 汇率
• 汇总到人民币总资产与净值时，不要沿用过期汇率
• 若发生数据源切换，在日报中明确说明

兜底策略

若首选行情源失败：

• 说明失败原因
• 改用公开可核验的备选来源
• 在“数据口径提示”或“特别说明”中保留来源说明

Step 4. 统一计算规则

今日浮盈

严格区分两类仓位：

1. 旧仓
• 公式：(当前价或收盘价 - 昨收) × 股数
2. 当日新增仓位
• 公式：(当前价或收盘价 - 实际买入价) × 股数

持仓盈亏

统一按：

(当前价或收盘价 - 当前持仓成本) × 股数

资金迁移

对入金、银证转账、银行现金转证券账户这类动作：

• 视为现金位置迁移
• 不计入投资收益
• 不直接改变净值基准，除非用户明确要求切换基准

场外现金口径

当资金已经实际转入证券账户后：

• 不再单列“场外现金仓位”
• 只在证券账户可用资金中体现
• 只有在解释历史口径迁移时，才提及旧场外现金背景

港股折算

港股汇总到组合总资产、组合盈亏和净值时：

• 先将港股市值与盈亏折算为人民币
• 再并入组合汇总

Step 5. 生成输出

主报告

默认输出到：

reports/YYYY-M-D-盈亏汇总.md

报告结构固定为：

1. 时间与口径
2. 今日整体浮盈
3. 分账户结果
4. 组合汇总
5. 持仓盈亏明细
6. 风险提示
7. 自检结论

净值记录

持续维护：

reports/nav-record.csv

最少包含这些列：

• 日期
• 净值
• 相对基准变化
• 相对前一次净值变化(百分点)
• 总资产(元)
• 备注（可选保留为底层留痕字段）

净值图

更新：

reports/nav-chart.html

默认要求：

• 展示净值基准线 1.0000
• 展示时间序列折线
• 展示净值记录明细表
• 悬停时展示核心信息即可
• 默认不在明细表中展示备注列，避免信息过长

短摘要

用户要求消息推送、企微摘要或 IM 摘要时：

• 基于同一份正式日报压缩生成
• 保留时间口径、整体结果、净值变化、异常说明
• 不得出现与正式日报冲突的数据

Self-Check

在输出结果前，逐项自检：

1. 是否先确认了当前时间与价格口径
2. 是否区分了旧仓与当日新增仓的今日浮盈
3. 是否把港股按当日汇率折算成人民币
4. 是否把资金迁移误算成收益
5. 是否误保留了已经迁入证券账户的独立场外现金描述
6. 是否更新了 reports/nav-record.csv
7. 是否让日报、净值记录、净值图三者口径一致
8. 是否在结果里明确说明了异常数据源或 fallback

Resource Map

Scripts

• scripts/init_report_workspace.py
• 初始化日报工作区，复制模板并创建目录

References

• references/report-workflow.md
• 详细流程、公式、口径与异常处理规则
• references/file-spec.md
• 输入输出文件格式说明

Assets

• assets/templates/report-config.yaml
• assets/templates/current-holdings-template.md
• assets/templates/daily-report-template.md
• assets/templates/nav-record-template.csv
• assets/templates/nav-chart.html
• assets/templates/wecom-summary-template.md

Public Submission Notes

面向公开上架或比赛提交时，始终执行以下要求：

• 使用脱敏后的模板，不夹带个人真实持仓、账户号、密钥、私有接口
• 不硬编码 Token、Secret、Cookie、企业内部网关地址
• 提供可执行内容，不提交空壳说明或大量占位文本
• 让普通用户只靠模板和说明就能初始化并跑通一次日报

这套 skill 的参赛卖点应聚焦在四点：

1. 真实提效：把手工对账、计算、写日报、维护净值图合并成一套流程
2. 可配置：账户、基准、现金口径、输出路径都可替换
3. 可迁移：可直接复制给另一个用户或另一个 workspace
4. AI 原生：数据读取、口径判断、异常说明、摘要压缩都由同一 agent 流程完成