mariusfit-passive-income-tracker

在一个地方跟踪所有被动收入加密应用的收益、收款与 USD/EUR 换算。

## 概述（中文）

在一个地方跟踪所有被动收入加密应用的收益、收款与 USD/EUR 换算。

## 技能正文

# 被动收入跟踪器 — 带宽与加密货币收益仪表盘

在一个地方跟踪你所有的被动收入加密应用。统一仪表盘展示 Grass.io、Storj、Mysterium、Honeygain、EarnApp 等应用的每日收益、收款历史以及 USD/EUR 总额。

## 功能介绍

- **统一收益仪表盘** — 所有应用一览无余
- **每日/每周摘要** — 自动推送至 WhatsApp/Telegram
- **收款跟踪** — 记录已确认收款并估算待发奖励
- **USD/EUR 换算** — 获取实时加密货币价格进行法币估值
- **正常运行时间关联** — 将收益与服务正常运行时间交叉核对
- **低收益告警** — 当某应用停止收益时发出警告（节点宕机？）
- **CSV/JSON 导出** — 用于电子表格或报税

## 支持的应用

| 应用 | 方式 | 数据 |
|-----|--------|------|
| **Grass.io** | API（会话令牌） | 积分、已用带宽、等级 |
| **Storj** | Satellite API | 已用存储、收益、收款 |
| **Mysterium** | 本地节点 API (3478) | 会话、共享的 GiB、赚取的 MYST |
| **Honeygain** | API（邮箱+密码） | 信用额、推荐、余额 |
| **EarnApp** | API（令牌） | 已售带宽、余额、流量 |
| **Peer2Profit** | API（令牌） | P2P 流量收益 |
| **Custom** | HTTP 端点 | JSON 轮询 |

## 快速开始

```bash
# Initialize tracker
passive-income-tracker init

# Add Grass.io (requires session token from browser)
passive-income-tracker add-app grass \
  --token "your-grass-session-token"

# Add Storj node
passive-income-tracker add-app storj \
  --satellite "us1.storj.io:7777" \
  --api-key "your-api-key"

# Add Mysterium node (local)
passive-income-tracker add-app mysterium \
  --node-url "http://localhost:3478"

# Check current earnings
passive-income-tracker status

# Get weekly summary
passive-income-tracker summary --period week

# Setup daily WhatsApp report at 8am
passive-income-tracker alert-setup \
  --channel whatsapp \
  --schedule "every day at 8am"
```

## 命令

| 命令 | 说明 |
|---------|-------------|
| `passive-income-tracker init` | 设置配置和数据目录 |
| `passive-income-tracker add-app <name>` | 添加一个新的被动收入应用 |
| `passive-income-tracker list` | 显示所有已配置的应用 |
| `passive-income-tracker status` | 所有应用的当前收益 |
| `passive-income-tracker summary` | 每日/每周/每月摘要 |
| `passive-income-tracker history [app]` | 收益历史图表 |
| `passive-income-tracker alert-setup` | 配置告警和报告 |
| `passive-income-tracker export` | 导出为 CSV/JSON |

## 示例输出

```
╔══════════════════════════════════════════════╗
║   PASSIVE INCOME TRACKER — 2026-02-25        ║
╠══════════════════════════════════════════════╣
║ App          │ Today    │ This Week │ Status  ║
╠══════════════════════════════════════════════╣
║ Grass.io     │ 412 pts  │ 2,891 pts │ 🟢 LIVE ║
║ Storj        │ $0.84    │ $5.88     │ 🟢 LIVE ║
║ Mysterium    │ 0.31 MYST│ 2.17 MYST │ 🟢 LIVE ║
║ Honeygain    │ $0.22    │ $1.54     │ 🟢 LIVE ║
╠══════════════════════════════════════════════╣
║ TOTAL (est.) │ ~$1.87   │ ~$13.09   │         ║
║ Monthly est. │          │           │ ~$56/mo ║
╚══════════════════════════════════════════════╝

💡 Grass.io earnings down 18% vs yesterday. Check node uptime.
```

## 每日 WhatsApp 摘要

配置告警后，你会在早晨收到一条消息：

```
📊 Passive Income — Daily Report (Feb 25)

Grass.io: 412 pts (+3.2%)
Storj: $0.84 (+1.1%)
Mysterium: 0.31 MYST (~$0.47)
Honeygain: $0.22

Total: ~$1.87 today
Weekly: ~$13.09
Monthly projection: ~$56

⚡ Action: Storj payout threshold ($10) reached in 3 days
```

## Grass.io 设置

获取你的会话令牌：
1. 在 Chrome 中登录 app.getgrass.io
2. 打开 DevTools → Application → Local Storage → app.getgrass.io
3. 复制 `userId` 和 `accessToken` 的值
4. 粘贴到 `passive-income-tracker add-app grass --token <accessToken>`

> 注意：Grass.io 没有官方公开 API。本技能使用与网页仪表盘相同的端点。令牌可能会过期；若收益显示为 0，请重新认证。

## Storj 设置

```bash
# Get API key from Storj dashboard → Access → Create API Key
passive-income-tracker add-app storj \
  --satellite "eu1.storj.io:7777" \
  --api-key "your-16-char-key" \
  --wallet "0xYourEthereumAddress"
```

## Mysterium 设置

```bash
# Mysterium node must be running locally (Docker or native)
# Default API port is 4449 (not 3478 — check your config)
passive-income-tracker add-app mysterium \
  --node-url "http://localhost:4449" \
  --token "$(cat ~/.mysterium/keystore/node.key)"
```

## 价格数据

实时价格从 CoinGecko 获取（免费，无需 API 密钥）。支持：
- MYST → EUR/USD
- STORJ → EUR/USD  
- GRASS token → EUR/USD（上市后）
- Custom token → 通过 CoinGecko ID

## 数据与隐私

所有数据本地存储于 `~/.openclaw/workspace/passive-income-tracker/`。使用 SQLite 数据库。无遥测、无云同步。API 令牌静态加密存储。

## 报税导出

```bash
# Export 2025 earnings for tax reporting
passive-income-tracker export \
  --from 2025-01-01 \
  --to 2025-12-31 \
  --format csv \
  --output ~/passive-income-2025.csv
```

输出包括：date、app、amount、currency、USD_value、EUR_value（按收益发生时计算）。

## 要求

- Python 3.8+
- OpenClaw 1.0+
- 正在运行的被动收入应用（Grass、Storj、Mysterium 等）
- 可选：CoinGecko API（免费层即可）

## 来源与问题反馈

- **Source:** https://github.com/mariusfit/passive-income-tracker
- **Issues:** https://github.com/mariusfit/passive-income-tracker/issues
- **Author:** [@mariusfit](https://github.com/mariusfit)