配置说明

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"],
  "watchingCrypto": ["BTC/CRO", "ETH/CRO"],
  "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 汇率自动换算。
watchingCrypto 否 加密货币交叉盘数组,格式为 "BASE/QUOTE"(例如 ["BTC/CRO", "ETH/CRO"])— 即”以 QUOTE 计价的 BASE 价格”。仅观察的换币信号,价格来自 crypto.com 的免密钥公开 API 而非 Yahoo。详见下文加密货币交叉盘。
intradayAlerts 否 盘中提醒设置(见下文)。省略时使用默认值。
cryptoAlerts 否 --crypto 排程的提醒设置。字段与 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 名额。

加密货币交叉盘

可选的 watchingCrypto 数组回答的是 Richfolio 其他部分不回答的问题:不是”我该用现金买入吗?”,而是”我已经持有币种 X — 现在是把其中一部分换成币种 Y 的好时机吗?”

{
  "watchingCrypto": ["BTC/CRO", "ETH/CRO"]
}

写法

"BASE/QUOTE" 表示以 QUOTE 计价的 BASE 价格 — 即”你要买入的资产”除以”你要花掉的资产”。

因此 "BTC/CRO" 表示”1 个 BTC 值多少 CRO”,而这正是你在把 CRO 换成 BTC 之前希望越低越好的数字。新增、删除或替换交易对都只需改配置:"SOL/CRO"、"BTC/USDT"、"ETH/BTC" 无需改动任何代码即可使用。

为什么必须统一方向

交易所会按自己的习惯挂出市场的任意一侧。在 crypto.com 上,CRO 是 CRO_BTC 的基础币,却是 ETH_CRO 的计价币 — 若按原样解读,这两个交易对方向完全相反:你会希望 CRO_BTC 高时把 CRO 换成 BTC,却希望 ETH_CRO 低时把 CRO 换成 ETH。同一份简报里存在两种极性极易误读,而且每新增一个交易对都会更糟。

Richfolio 把一切归一化为”以你要花掉的货币计价的、你要买入的资产”,因此低 = 便宜 = 换币的好时机,恒定不变。交易所究竟挂在哪一侧,会依据其自身的交易品种元数据自动判定,必要时对序列取倒数。

有什么,缺什么

   
价格来源 crypto.com 交易所公开 API — 无需密钥、无需注册
计价单位 计价币(例如 1,313,198 CRO),绝不换算成你的报表货币
技术指标 全套 — SMA50/200、RSI、MACD、布林带、ATR、随机指标、OBV、90 日分位
52 周区间 由 365 根日线推导(加密货币每个自然日都交易)
P/E、基本面、股息、财报、分析师目标价 对币对而言根本不存在 — 已明确告知 AI,不会凭空编造价值评级
配置目标 / 缺口 无 — 仅观察,与 watching 列表一致
suggestedBuyValue 恒为 0(你是在换币,没有现金支出)
公开发布到 X/Facebook 等 绝不发布,即使已启用社交发帖

由于不存在 P/E,交叉盘只有两个价格层面的入场信号(而非三个):52 周位置 < 30%,以及价格低于 200 日均线。提示词中已明确告知 AI:缺少 P/E 不算未通过的检查。

推送与频率

交叉盘会出现在两个地方:

  1. 每日简报的观察列表,与你的 watching 标的并列。
  2. 它们自己每天 8 次的排程(.github/workflows/crypto-monitor.yml,每 3 小时一次),仅在信号发生实质变化时才发送邮件/Telegram。

之所以值得提高频率,是因为加密货币 7×24 小时交易,而股票盘中检查大多在美股休市时触发。本地运行请使用 npm run crypto。

注意日线仍然每天只收一次盘,因此相隔三小时的两次运行,技术指标是完全一致的 — 没有价格变动的动作翻转只是评分噪音,而非信号。cryptoAlerts.minPriceMovePctToAlert(默认 1.0)会将其抑制。cryptoAlerts 的字段与intradayAlerts完全相同,可独立调整:

{
  "cryptoAlerts": {
    "enabled": true,
    "minConfidenceToAlert": 80,
    "minPriceMovePctToAlert": 1.0
  }
}

设为 "enabled": false 可保留每日简报中的交叉盘,但停止独立提醒。

如何解读信号

交叉盘的建议是换币信号,因此动作词要相应理解:

动作 含义
STRONG BUY / BUY 把计价币换成基础币的有利窗口
HOLD / WAIT 以计价币衡量,基础币偏贵 — 继续等待

有一点值得留意:两条腿都有波动,因此有利的交叉盘价格可能来自基础币下跌,也可能来自计价币上涨。数据允许时,AI 会被要求说明是哪一种。

股票代码格式

类型 格式 示例
美股/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 免费层如今是整套系统里最紧张的限制:2026 年 8 月的一次真实 429 报错显示 `gemini-2.5-flash` 的请求额度约为每日 20 次,而 richfolio 的调度(1 次 daily + 5 次 intraday)每天要用掉 13 次以上请求 — 因此 Gemini 经常会耗尽额度,并在当天较晚的运行中掉线。Token 吞吐量并不是问题所在(即使 100 个代码,在每分钟 25 万 token 的限速下,每次运行也只需约 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.