发布一个每日基金 Home Assistant 集成

每日基金 Home Assistant 集成

hacs_badge

这是一个 Home Assistant 自定义集成,用于跟踪您的基金投资情况。通过对接天天基金网 API,实时获取基金估值数据,并在 Home Assistant 中展示详细的基金信息。

功能特点

  • :bar_chart: 实时基金数据 - 获取基金的实时估算净值和官方净值
  • :moneybag: 收益计算 - 自动计算持仓收益、收益率和市值
  • :chart_with_upwards_trend: 趋势指示 - 通过涨跌图标直观显示基金走势
  • :clock3: 定时更新 - 可配置的更新间隔,确保数据及时性
  • :mag: 详细分类 - 数据按基础数据、净值数据和估算数据分类展示

安装方法

方法一:通过 HACS 安装(推荐)

  1. 确保已安装 HACS
  2. 在 HACS 的 “Integrations” 页面,点击右上角的三个点菜单,选择 “Custom repositories”
  3. 在弹出窗口中添加仓库地址:GitHub - lambilly/hass_daily_fund: 这是一个 Home Assistant 自定义集成,用于跟踪您的基金投资情况。通过对接天天基金网 API,实时获取基金估值数据,并在 Home Assistant 中展示详细的基金信息。 ,类别选择 “Integration”
  4. 在 HACS 中搜索 “每日基金”
  5. 点击下载
  6. 重启 Home Assistant

方法二:手动安装

  1. 下载本集成文件
  2. custom_components/daily_fund 文件夹复制到您的 Home Assistant 配置目录中的 custom_components 文件夹内
  3. 重启 Home Assistant

智能更新策略

本集成采用智能更新策略,根据不同的时段自动调整数据更新频率:

交易时段 (9:30-11:30, 13:00-15:00)

  • 默认间隔: 5分钟
  • 可配置范围: 1-60分钟
  • 特点: 获取实时估值变化

净值公布时段 (18:00-22:00)

  • 默认间隔: 15分钟
  • 可配置范围: 5-60分钟
  • 特点: 及时获取基金公司公布的官方净值

非交易时段

  • 固定间隔: 1小时
  • 特点: 节省资源,数据变化较少

优势

  • :clock3: 智能优化: 根据时段自动调整更新频率
  • :floppy_disk: 资源节约: 非交易时段减少不必要的API请求
  • :bar_chart: 数据及时: 重要时段确保数据及时更新
  • :gear: 灵活配置: 用户可根据需求调整更新间隔

配置

  1. 在 Home Assistant 的「集成」页面,点击「添加集成」
  2. 搜索「每日基金」
  3. 按照提示填写以下信息:
    • 基金代码:6位数字基金代码(如:012889)
    • 基金名称:基金显示名称
    • 平均净值:您的持仓平均净值(可选)
    • 持仓份额:您持有的基金份额(可选)
    • 初始成本:您的初始投资成本(可选)
    • 更新间隔:数据更新频率,默认600秒(可选)

实体属性

每个基金实体包含以下分类数据:

基础数据

  • 基金代码、基金名称、基金全称
  • 涨跌净值、涨跌图标
  • 平均净值、持仓份额、初始成本

净值数据

  • 净值日期、单位净值
  • 持仓市值、持仓收益、持仓收益率

估算数据

  • 估算时间、估算净值、估算增长率
  • 估算市值、估算收益、估算收益率

支持

如果您遇到任何问题或有建议,请通过以下方式联系:

许可证

MIT License