投资笔记

PrimeEdge 提供专门的投资笔记模块，支持盘前计划和盘后复盘两种笔记类型，并在列表页集成收益率统计面板，自动计算年度/月度收益、跑赢上证指数幅度、最大回撤等核心指标。

功能概览

• 盘前计划 — 记录早盘思路、今日关注标的、持仓操作预案
• 盘后复盘 — 记录当日盈亏、交易明细、重要消息、经验总结、高手动向
• 收益率统计面板 — 自动复利计算、月均收益、跑赢上证指数对比、最大回撤
• 日历热力图 — 每日盈亏以日历形式可视化呈现
• 月度走势图表 — 按年分组的月度收益柱状图
• 历史记录 — 按年份汇总总收益和跑赢大盘幅度

目录结构

content/investing/
├── _index.md              # 投资笔记首页
├── 2026/
│   ├── 01/
│   │   └── 2026-01-25-post.md
│   ├── 03/
│   │   └── 2026-03-31-post.md
│   └── 04/
│       ├── 2026-04-21-post.md   # 盘后复盘
│       └── 2026-04-22-pre.md    # 盘前计划

创建投资笔记首页

创建 content/investing/_index.md：

---
title: "投资笔记"
description: "记录交易心得，复盘每日操作，积累投资智慧"
---

笔记类型

投资笔记分为两种类型，通过 note_type 字段区分。

盘前计划（pre-market）

盘前计划用于记录每日开盘前的思路、观察池和操作预案。

---
title: "4月22日盘前笔记"
date: 2026-04-21T19:51:00+08:00
note_type: "pre-market"
watchlist:
  - name: "中衡设计"
    code: "300750"
    reason: "关注连板情绪，关注致航一号航景"
  - name: "顺灏股份"
    code: "002565"
    reason: "关于连板情绪和轨道晨光融资消息"
holdings_plan:
  - name: "天银机电"
    code: "603698"
    plan: "拿到周四一季度报"
  - name: "航天工程"
    code: "300750"
    plan: "观望承接,无承接清仓"
  - name: "法尔胜"
    code: "000890"
    plan: "逢高清仓"
---

盘前计划的正文内容（即 Markdown 正文部分）会作为盘前思考展示在页面中，支持完整的 Markdown 语法。

盘前计划 Front Matter 字段

watchlist 子字段：

holdings_plan 子字段：

盘后复盘（post-market）

盘后复盘用于记录当日收盘后的盈亏情况、交易明细、消息面和经验总结。

---
title: "本月第一篇复盘"
date: 2026-04-21T19:26:00+08:00
note_type: "post-market"
daily_pnl_percent: 53.56
benchmark: 48.58
trades:
  - name: "法尔胜"
    code: "000890"
    action: "买入"
    price: 13.777
    position_ratio: "5.904%"
    close_pnl: 0.6
  - name: "航天工程"
    code: "603698"
    action: "买入"
    price: 0
    position_ratio: "-1.458%"
    close_pnl: 0.6
news:
  - time: "18:36"
    type: "industry"
    type_name: "官方消息"
    title: "上海重磅发布：加快千帆星座建设，推动卫星互联网业务商务试点"
lessons: |
  - 航天工程买得有点早，应在下午2点30分后再买
expert_content: |
  今日没时间整理
---

盘后复盘 Front Matter 字段

trades 子字段：

news 子字段：

经验总结与高手动向支持 Markdown

lessons 和 expert_content 字段使用 YAML 管道符（|）定义多行字符串，支持完整的 Markdown 语法：

lessons: |
  ## 今日教训

  1. **买入时机**：航天工程买得有点早，应在下午2点30分后再买
  2. **仓位控制**：单票仓位不应超过总资金的10%
  3. [参考链接](https://example.com)

页面渲染时会自动解析 Markdown，生成带标题、列表、加粗、链接等样式的内容。

收益率统计面板

投资笔记列表页（layouts/investing/list.html）在第一页自动展示收益率统计面板，包含三个标签页：

年度标签页

展示当年累计数据：

• 年度收益率 — 基于各月复利自动计算。每月内部先对 daily_pnl_percent 做日复利，然后各月之间再做月复利
• 月均收益 — 年度总收益除以当年数据中覆盖到的最大月份数。例如数据覆盖到4月就除4，到5月除5，明年1月重新开始除1
• 跑赢上证指数 — 调用腾讯财经 K 线 API 获取上证指数真实月 K 数据，计算年度涨跌幅后与你的收益对比
• 最大回撤 — 基于历史交易记录自动计算峰值到谷值的最大跌幅

下方还有月度收益走势柱状图，按月份展示盈亏幅度。

本月标签页

展示当月明细：

• 本月收益率 — 当月复利收益
• 交易天数 — 当月实际写了复盘的天数
• 跑赢上证指数 — 当月收益与当月上证指数涨跌幅的差值
• 最大回撤 — 当月最大回撤

下方有每日盈亏日历热力图，绿色表示盈利日，红色表示亏损日，颜色深浅对应盈亏幅度。

历史标签页

按年份倒序列出每一年的：

• 年度总收益率
• 跑赢上证指数幅度
• 交易天数

上证指数数据来源

收益率面板通过腾讯财经 K 线 API（https://web.ifzq.gtimg.cn/appstock/app/fqkline/get）获取上证指数月 K 线数据，支持 CORS，浏览器端直接请求。数据缓存 24 小时，避免频繁调用 API。

手动补充历史数据

如果某些月份没有写复盘文章，可以在 layouts/investing/list.html 的 JavaScript 中手动补充：

const MANUAL_MONTHLY_DATA = {
  '2025-11': { compound: 98.27, days: 20, maxDrawdown: 3.2 },
  '2025-12': { compound: 21.59, days: 23, maxDrawdown: 3.2 },
};

手动数据会与文章中的实际数据合并，以实际数据为优先。

创建投资笔记模板

建议在 archetypes/ 目录下创建投资笔记模板，方便快速创建新笔记。

盘后复盘模板 archetypes/investing-post.md

---
title: "{{ .Date.Format "1月2日" }}盘后复盘"
date: {{ .Date }}
url: /investing/{{ .Date.Format "2006-01-02" }}-post/
note_type: "post-market"
daily_pnl_percent:
benchmark:
trades:
  - name: ""
    code: ""
    action: "买入"
    price:
    position_ratio: ""
    close_pnl:
news:
  - time: ""
    type: "industry"
    type_name: ""
    title: ""
lessons: |

expert_content: |

---

盘前计划模板 archetypes/investing-pre.md

---
title: "{{ .Date.Format "1月2日" }}盘前计划"
date: {{ .Date }}
url: /investing/{{ .Date.Format "2006-01-02" }}-pre/
note_type: "pre-market"
watchlist:
  - name: ""
    code: ""
    reason: ""
holdings_plan:
  - name: ""
    code: ""
    plan: ""
---

开盘前的思考记录在这里。

使用建议

目录组织

建议按年份和月份组织文件：

content/investing/
├── 2026/
│   ├── 01/                # 1月份笔记
│   ├── 02/
│   ├── 03/
│   └── 04/
└── _index.md

命名规范

• 盘后复盘：YYYY-MM-DD-post.md
• 盘前计划：YYYY-MM-DD-pre.md
• URL 建议保持统一格式，方便后续查找和链接

数据填写建议

• daily_pnl_percent 填写当日总盈亏百分比，不是单笔交易盈亏。如果你本月只写一篇复盘，可以填写当月总收益
• trades 中的 close_pnl 是当日收盘后的浮盈浮亏百分比
• lessons 尽量用 Markdown 结构化记录，方便后续回顾时快速定位重点

隐私保护

如需保护交易隐私：

1. 使用代号代替真实股票名称
2. 模糊处理具体金额和仓位比例
3. 设置 draft: true 不公开某篇笔记
4. 整个投资笔记目录可通过 Hugo 部署配置限制访问

与其他内容的关系

• 笔记 — 可用 notes 快速记录盘中一闪而过的想法，晚上写复盘时再整理进 investing
• 文章 — 深度分析某只股票或某个策略时，用 posts 写长文，在复盘中引用链接
• 文档 — 整理自己的交易系统规则时，用 docs 编写可查阅的文档

下一步

• 笔记 — 快速记录投资灵感
• 文章写作 — 分享深度投资分析
• 好物推荐 — 推荐投资工具和书籍