portfolio-tracker

KO | EN

gitlite — search

#hacktoberfest #golang #go #deep-learning #docker #macos #java #nodejs #cli #awesome-list #pytorch #security #ios #open-source

portfolio-tracker

(★ 10)

A股 ETF 组合实时跟踪工具。

portfolio-tracker 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Portfolio Tracker — ETF 组合实时跟踪

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python](https://img.shields.io/badge/Python-3.9%2B-blue.svg)](https://www.python.org/)
[![Platform](https://img.shields.io/badge/Platform-macOS%20%7C%20Linux-lightgrey.svg)]()

> A lightweight terminal tool for tracking A-share ETF portfolios in real time — quotes, positions, P&L, moving averages, snapshot logging, and chart generation. Optional Streamlit dashboard included.

这个小工具做两件事：

1. **实时拉取行情**（无需登录券商），在终端里滚动展示你的 ETF 组合：价格、涨跌幅、仓位权重、浮盈亏。
2. **记录快照并画图**：把轮询到的快照写入 CSV，然后一键生成「组合净值线」和「各持仓权重线」。

> 说明：使用的是公开行情接口（非官方），接口可能随时变更/限频；请把轮询频率控制在合理范围（例如 3–10 秒）。

## 快速开始

```bash
cd portfolio-tracker
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp portfolio.example.json portfolio.json
```

### macOS 常见问题：`pip` 报 SSL 证书校验失败

如果你看到类似 `SSLCertVerificationError: certificate verify failed`，通常是 Python 没拿到系统根证书。先在同一个终端里执行：

```bash
export SSL_CERT_FILE=/etc/ssl/cert.pem
export REQUESTS_CA_BUNDLE=/etc/ssl/cert.pem
pip install -r requirements.txt
```

仍不行的话，运行 Python 自带的证书修复脚本（按你的 Python 版本改路径）：

```bash
/Applications/Python\ 3.12/Install\ Certificates.command
```

编辑 `portfolio-tracker/portfolio.json`，把你的**份额**（`shares`）和**成本**（`cost`，可选）填进去。

如果你在 `positions[].name` 里写了自定义名称，界面会优先显示这个名称（不会被行情源返回的官方简称覆盖）。

### 1) 终端实时看盘 + 记录快照

```bash
python pt.py watch --config portfolio.json --interval 5 --provider auto --log data/snapshots.csv
```

表格最右侧会显示 `MA5/MA10/MA30`。这些均线来自你的 `close` 日快照：如果本地记录不够，`close` 会尝试用历史 K 线回填（默认拉近 60 个交易日），通常不用等攒够 30 天；拉取失败/没跑过 `close` 时会显示 `-`。

现在 `watch`/`quote_once` 走的是简洁口径：

- 主表展示价格、涨跌、份额、市值、`TotalPnL`、`DayPnL`、`MA5/10/30`
- 标题汇总展示现金/总资产/`TotalPnL`/`DayPnL`
- 若开启了 `--benchmark`（默认 `SH000001`），会展示指数：点位、实时涨跌、`O/H/L`

如果你有场外基金，也可以在配置里加 `off_positions`。终端会附加展示场外基金（`OFxxxxxx`），并在标题里显示 `Off(est)`（盘中估值）、`Off(nav)`（确认净值）或 `Off(mix)`（混合来源），以及 `OffPnL`、`OffDay`。

场外基金优先使用新浪盘中估值；新浪未覆盖或非当日数据时，自动回退东财最新确认净值。QDII 等不提供盘中估值的基金通常会触发回退，因此组合汇总可能显示 `Off(mix)`。

如果你不想频繁改 `portfolio.json`，也可以临时覆盖现金：

```bash
CASH=9200 sh quote_once.sh
```

只拉一次（不循环）：

```bash
python pt.py watch --config portfolio.json --once
```

也可以一键拉一次（自动处理 venv/依赖，macOS 可双击）：

- `portfolio-tracker/quote_once.command`
- `portfolio-tracker/pt.command`（菜单：quote/watch/close/brief/plot）

### 1.5)（可选）收盘后记录一条「隐秘」日快照

收盘后运行一次，把当日快照写入一个**不太好直接看懂**的行文件（默认：`data/.pt_daily.dat`）：

```bash
python pt.py close --config portfolio.json --provider auto
```

提示：
- `close` 会把周末视为「最近一个交易日」（例如周六运行会记到周五），避免生成非交易日记录。
- 交易时段默认会跳过（避免把盘中数据当成收盘）；如需强制写入可加 `--allow-open`。

`close` 默认会额外计算并写入各持仓的 `MA5/MA10/MA30`（必要时会拉历史 K 线回填）。如需关闭：

```bash
python pt.py close --no-ma
```

`close` 会把当次快照写入日记录，并在终端打印 `DayPnL` + `TotalPnL`（如果配置了 `off_positions`，也会附带场外估值汇总）。

如果 `off_positions` 里配置了 `daily_add` / `weekly_add`，`close` 结束时会按当次场外价格自动把定投金额落到 `portfolio.json` 的 `shares/cost`（同一 `trade_date` 自动防重，不会重复累计）。如果要临时跳过某个交易日，可在对应标的上加 `skip_auto_add_trade_dates: ["YYYY-MM-DD"]`。

如需临时关闭自动落地：

```bash
python pt.py close --no-apply-off-add
```

如果你这边 Eastmoney 拉不通，可以试试指定腾讯源：

```bash
python pt.py close --ma-provider tencent
```

查看最近记录（可选）：

```bash
python pt.py daily --tail 10
```

macOS 也可以双击运行：

- `portfolio-tracker/log_close.command`

### 1.6)（可选）看「近 N 日前低」还有多远

先确保你每天收盘后都跑过 `close`（累计越久越准）。然后用 `low` 从 `data/.pt_daily.dat` 里算：

```bash
python pt.py low --code 159852 --days 60
```

也可以对配置里的全部持仓一起算：

```bash
python pt.py low --all --days 60
```

### 1.7)（可选）生成「更贴近持仓」的近 N 日简报（成分股/公告/业绩/产业新闻）

```bash
python pt.py brief --config portfolio.json --days 7
```

说明：
- 会先拉取每个 ETF 的**前 N 大成分股**（默认 10，口径=基金最新披露；来源：Eastmoney fundf10，非官方接口）。
- 再从**前 `--scan` 大成分股**里抓取近 N 日公司公告，并按关键词把公告拆成「公司公告 / 业绩相关」各取 Top3（默认）。
- 「产业新闻」为关键词搜索（best-effort）：可能抓不到、也可能因页面结构变更而失效。
- 默认启用 HTTP 缓存：`data/.pt_cache`，减少重复请求；离线复盘可用 `--offline`（需缓存命中）。

也可以一键运行（自动处理 venv/依赖，macOS 可双击）：

- `portfolio-tracker/brief_7d.command`

### 2) 从快照生成走势图

```bash
python pt.py plot --log data/snapshots.csv --out charts
open charts/portfolio_value.png
open charts/weights.png
```

## 可选：用 Streamlit 做成网页仪表盘（自动刷新）

```bash
pip install -r requirements-dashboard.txt
streamlit run streamlit_app.py
```

也可以直接双击运行（macOS）：

- `portfolio-tracker/run_dashboard.command`

如果启动时出现 `OSError: [Errno 49] Can't assign requested address`，一般是系统禁用了 IPv6 导致绑定 `localhost(::1)` 失败；脚本已强制使用 `127.0.0.1`，也可以手动改用别的端口（例如 `8502`）。

## 配置格式

见 `portfolio-tracker/portfolio.example.json`。常用字段：

- `cash`：现金（可选）
- `positions[].exchange`：`SH` 或 `SZ`
- `positions[].code`：6 位代码（例如 `588200`）
- `positions[].shares`：持有份额
- `positions[].cost`：持仓成本（可选，用于估算浮盈亏）
- `off_positions[]`：场外基金（可选）
- `off_positions[].code`：6 位基金代码（例如 `161725`）
- `off_positions[].shares`：持有份额（按你账户口径填写）
- `off_positions[].cost`：持仓成本（可选，用于估算场外浮盈亏）
- `off_positions[].daily_add`：每日定投金额（可选；`close` 时自动入账）
- `off_positions[].weekly_add` + `off_positions[].weekly_day`：每周定投金额与执行日（可选；`weekly_day` 支持 `Thu`/`周四`/`4` 等）
- `off_positions[].skip_auto_add_trade_dates`：临时跳过自动定投的交易日列表（可选；例如 `["2026-04-02"]`）
- `off_positions[].dynamic_add*`：仅保留备注，脚本默认不自动执行（规则依赖平台）

## 数据来源 / Data Sources

行情和基础数据来自公开的非官方接口（如 Eastmoney、Sina、Tencent 等）。这些接口**未经任何授权**，可能随时变更、限频或失效。本项目仅做技术演示和个人使用，请勿用于生产或高频商业场景。

## 免责声明 / Disclaimer

本项目仅供学习与个人记账参考，**不构成任何投资建议**。所有数据可能存在延迟、错误或缺失。基于本工具做出的任何投资决策与作者无关，盈亏自负。

This project is provided for educational and personal use only. It is **not financial advice**. Data may be delayed, incorrect, or missing. The authors assume no liability for any investment decisions made using this tool.

## 贡献 / Contributing

欢迎 Issue 和 PR：

- Bug 报告：请尽量附上 Python 版本、操作系统、复现步骤、相关 log。
- 新功能：建议先开 Issue 讨论一下方向再写代码。
- 代码风格：尽量保持现有风格；不引入不必要的依赖。

## 社区讨论 / Community

本项目在 [LINUX DO](https://linux.do) 社区开源推广，欢迎佬友们到讨论帖交流、反馈、提建议：

> 讨论帖：[https://linux.do/t/topic/2248259](https://linux.do/t/topic/2248259)

## License

You are free to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of this software, with attribution.

portfolio-tracker

portfolio-tracker 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

portfolio-tracker

portfolio-tracker 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README