配置说明

Richfolio 用一个 JSON 配置承载所有投资组合数据 — 你的组合信息保持私有。

设置步骤

进入你 Fork 的仓库 Settings → Secrets and variables → Actions → Variables 标签页 → 创建一个名为 CONFIG_JSON 的变量,内容为下方的 JSON。

示例 

{
  "targetPortfolio": {
    "VOO": 20,
    "QQQ": 15,
    "GLD": 10,
    "BSV": 20,
    "SMH": 5,
    "BTC": 1.5
  },
  "currentHoldings": {
    "AAPL": 30,
    "VOO": 1,
    "BTC": 0.0002
  },
  "watching": ["MSFT", "NVDA", "AMD"],
  "totalPortfolioValue": 50000,
  "defaultCurrency": "USD",
  "intradayAlerts": {
    "enabled": true,
    "confidenceIncreaseThreshold": 10
  }
}

字段参考

字段 必填 描述
targetPortfolio 是 目标配置百分比。键为股票代码,值为百分比,总和应约为 100%。
currentHoldings 是 你当前持有的股数。可以包含不在目标组合中的股票(例如 AAPL 用于 ETF 重叠检测)。
watching 否 跟踪但不在目标组合内的股票代码数组。会被抓取数据、经 AI 评分,并在独立的 “Watch List” 段呈现 — 而不会污染配置计算。详见下方 观察列表。
totalPortfolioValue 是 你估计的投资组合总价值(以 defaultCurrency 计价)。当实际持仓小于目标时,用于配置计算。
defaultCurrency 否 ISO 4217 货币代码(例如 "USD"、"GBP"、"AUD")。默认值:"USD"。邮件/Telegram 中的所有金额都以该币种呈现;不匹配的标的会通过实时 Yahoo Finance 汇率自动换算。
intradayAlerts 否 盘中提醒设置(见下文)。省略时使用默认值。

盘中提醒

intradayAlerts 段控制盘中检查何时发送提醒。所有字段都可选 — 有合理的默认值。

提醒只会因 STRONG BUY 相关的变化而触发:

  1. 升级为 STRONG BUY — 其它级别 → STRONG BUY
  2. 从 STRONG BUY 降级 — STRONG BUY → 其它级别
  3. 置信度变化 — 保持 STRONG BUY 的同时置信度变化 ≥ 阈值
字段 默认值 描述
enabled true 总开关。设为 false 可完全禁用盘中提醒。
confidenceIncreaseThreshold 10 触发 STRONG BUY 股票提醒所需的最小置信度变化(绝对值,百分点)。

刷新分析

用最新价格(含盘后/盘前)重新分析单个股票代码。发送邮件 + Telegram,并附上新的分析 URL。

Actions → Portfolio Monitor → Run workflow → mode: refresh、ticker: SMH。

可用时会使用 Yahoo Finance 的 postMarketPrice 和 preMarketPrice。如果盘后数据不可用,会回退到正常市价。

观察列表 (Watch List)

可选的 watching 数组用来跟踪那些你想要获得评分并作为信号呈现、但又不想纳入目标投资组合的标的。它们会与组合内的标的一起被抓取、送入 AI 提示词并获得评分,但会绕过所有基于配置缺口的规则。

适用场景:

  • 你正在研究一只股票,还没决定给它一个目标权重
  • 你想对当前并未持有的标的获得建议(例如“现在是不是开仓 NVDA 的好时机?”)
  • 你想对一些标的获得信号,又不想让组合总和超过 100%

Watch 标的与组合标的的区别

行为 组合标的 Watch 标的
计入配置百分比 是 否
计算配置缺口 是 否
STRONG BUY 要求 gap ≥ 2% 是 否 — 改为要求多信号共振
应用超配仓位守护 是 否
计入最多 2 个 STRONG BUY 上限 是 否 — 每个达标的 watch STRONG BUY 都会呈现
填充 suggestedBuyValue 是(基于缺口) 始终为 0 — 由你手动确定仓位规模
在主 “AI Buy Recommendations” 段渲染 是 否 — 单独的 “Watch List” 段
建议限价单价格 是 是(同一套逻辑)
详细 STRONG BUY 分析页 是 是

Watch STRONG BUY 标准

因为没有配置缺口作为锚点,watch 标的需要更强的信号共振才能获得 STRONG BUY:

  • ≥ 1 个价位信号(P/E 低于历史均值、52 周位置 < 30%,或价格低于 200 日均线)
  • ≥ 2 个动量信号与价位信号相互印证(RSI < 35、MACD 金叉看涨、布林带 %B < 0.15、随机指标 %K < 20、OBV 上升)
  • 无重大风险标记
  • 仅基于信号共振即可达到置信度 ≥ 80%
  • 价值评级为 A 或 B(仅针对股票;ETF 与加密货币跳过此项)

示例 

{
  "targetPortfolio": { "VOO": 20, "GLD": 10, ... },
  "currentHoldings": { "VOO": 5, "AAPL": 30 },
  "watching": ["MSFT", "NVDA", "AMD", "AVGO"]
}

这份配置持有 AAPL + VOO,并把 MSFT/NVDA/AMD/AVGO 仅作为研究信号跟踪。Watch 标的会出现在邮件/Telegram 的独立段中,既不会让组合总和超过 100%,也不会挤占组合自身的 STRONG BUY 名额。

股票代码格式

类型 格式 示例
美股/ETF 标准代码 AAPL、VOO、QQQ、SMH
加密货币 简称 BTC、ETH(自动转为 BTC-USD、ETH-USD)
国际市场 Yahoo Finance 代码 0700.HK(腾讯)、TM(丰田)

小贴士

  • 目标百分比总和应为 100%。若不为 100%,配置缺口计算仍然有效,但建议买入金额可能偏大或偏小。

  • 目标之外的持仓会用于 ETF 重叠检测。例如,持有 AAPL 会降低包含 AAPL 的 ETF(如 VOO 或 QQQ)的买入优先级。

  • 支持小数股 — 对加密货币("BTC": 0.000188)或支持小数股交易的券商很有用。

  • 投资组合估值取实际持仓价值与配置估值中的较大者。即使你的当前持仓还小于目标配置,缺口计算依然有意义。

最多能添加多少个股票代码?
Richfolio 在聚焦的投资组合中表现最好。虽然没有硬编码上限,但免费版 API 配额和简报的可读性给出了实际边界。 **推荐范围:** | 数量 | 评价 | |------|------| | **10-20** | 最佳区间 — 聚焦、可执行、所有免费额度都宽裕 | | **20-30** | 仍然不错 — 简报可读,额度仍有余 | | **30-50** | 技术上可行,但每日简报会显得杂乱 | | **50+** | 不推荐(见下) | **为什么 50+ 不推荐:** - **NewsAPI(每日 100 次)** — 新闻按每 5 个代码一批获取。在 50 个代码下,daily + intraday 大约用掉 22 次;100 个代码约为 42 次,留给刷新的余量很少。 - **AI 分析质量** — 一次评估太多选项时,Gemini 的建议会变得稀释。 - **简报可读性** — 邮件会变长,Telegram 会在 4,096 字符处截断。信噪比急剧下降。 - **执行时间** — 每个代码都需要 Yahoo Finance 调用获取价格、技术指标和基本面,会拖慢 GitHub Actions 运行。 Gemini 免费层(每日 250 次请求、每分钟 25 万 token)很慷慨,基本不会成为瓶颈 — 即使 100 个代码,每次运行也只需 ~5.3 万 token。真正的限制是 NewsAPI 额度和信息过载。 **结论 — 为获得最佳免费体验,建议控制在 30 个代码以内。**

更新配置

当持仓变化时,在 GitHub 上用新的 JSON 内容更新 CONFIG_JSON 变量(Settings → Secrets and variables → Actions → Variables 标签页)。

Richfolio — free, open-source portfolio monitoring. · Privacy Policy

This site uses Just the Docs, a documentation theme for Jekyll.