fundpeek

fundpeek 是一个命令行基金同步工具，用来把养基宝、小倍养基中的基金账户和持仓信息同步到 基估宝 的云端配置中。它支持终端交互式登录、同步前自动备份、恢复备份，以及一个用于查看基金估值和股票持仓明细的 TUI 界面。

功能

• 登录基估宝、养基宝、小倍养基账号，并把凭据保存在本机私有配置目录。
• 从养基宝或小倍养基拉取账户、基金代码、基金名称、份额、成本净值、金额等持仓信息。
• 将多来源持仓合并后写入基估宝云端配置。
• 每次同步或恢复前自动保存基估宝云端配置快照，便于回滚。
• 通过 TUI 查看本地持仓、基金实时估值、当日收益汇总和基金股票持仓明细。

安装

需要 Go 1.25 或更高版本。

go install github.com/icpd/fundpeek/cmd/fundpeek@latest

也可以在仓库内构建本地二进制：

make build
./fundpeek --help

快速开始

1. 登录 基估宝。基估宝用于保存同步后的云端配置。

fundpeek auth real

按提示输入邮箱，并填写邮件中的 OTP 验证码。

2. 登录基金来源。至少登录一个来源：

fundpeek auth yjb
fundpeek auth xb

养基宝会在终端显示二维码；小倍养基会按提示输入手机号和短信验证码。

3. 查看认证状态：

fundpeek status

4. 同步持仓到基估宝：

fundpeek sync all

也可以只同步单个来源：

fundpeek sync yjb
fundpeek sync xb

同步成功后会输出本次处理的账户、基金、分组和持仓数量，并打印自动生成的备份路径。

5. 打开 TUI 查看估值：

fundpeek tui

列表页会显示基金名称、估值涨幅、当日收益、最新净值涨幅和汇总。当天估值不可用时，会回退到最新净值和历史净值计算当日收益。选中基金后按 Enter 可查看股票持仓明细。

常用命令

fundpeek tui
fundpeek backup
fundpeek restore <backup-file>
fundpeek restore <backup-file> --yes
fundpeek logout real
fundpeek logout yjb
fundpeek logout xb

• tui：启动交互式终端界面。
• backup：手动备份当前基估宝云端配置。
• restore：从备份恢复基估宝云端配置；恢复前会再次自动备份当前配置。
• logout：删除指定来源的本地凭据。

常用来源别名：

• real 可写作 r。
• yangjibao 可写作 yjb 或 yj。
• xiaobei 可写作 xb 或 xbyj。
• sync all 可写作 sync a。

TUI 快捷键：

• ↑ / ↓ 或 k / j：移动选择。
• Enter：进入当前基金的股票持仓明细。
• Esc / Backspace：从明细页返回列表；在列表页退出。
• r：刷新当前页面数据。
• R：重新拉取当前页面数据。
• q / Ctrl+C：退出。

配置与本地文件

默认配置目录是 ~/.fundpeek，其中包含：

• credentials.json：本地凭据文件。
• device_id：本机设备 ID。
• backups/：基估宝云端配置备份。

可用环境变量：

FUNDPEEK_CONFIG_DIR=/path/to/config
FUNDPEEK_DEVICE_ID=custom-device-id
FUNDPEEK_SUPABASE_URL=https://example.supabase.co
FUNDPEEK_SUPABASE_ANON_KEY=...

不要提交凭据、备份或本地配置文件。

数据来源说明

同步数据来自养基宝和小倍养基；同步结果写入基估宝云端配置。TUI 的基金估值来自天天基金估值接口和东方财富基金净值数据，基金股票持仓来自东方财富基金 F10，股票实时行情来自腾讯行情接口。股票持仓明细只展示最近 6 个月内的基金持仓报告；过期报告不会展示。

开发

make test
make vet
make build
make verify

make verify 会依次运行测试、静态检查和构建，提交前建议执行。