Crypto SAFE 投资组合分析器 Pro

跟踪加密货币投资组合，基于自定义成本基础计算盈亏（P&L），并结合实时市场数据生成全面报告。

概览

本技能为加密货币投资者提供专业级投资组合追踪能力。它从 CoinGecko 获取实时价格，依据您设定的成本基础精确计算盈亏（P&L），并生成详细报告，涵盖持仓明细、资产配置比例及各项绩效指标。

核心功能：

• 支持 20+ 种加密货币的实时价格追踪
• 支持自定义成本基础，实现精准 P&L 计算
• 提供投资组合配置分析，支持目标配置与实际配置对比
• 面向关注列表（watchlist）开展市场情绪分析
• 支持多种输出格式（纯文本报告、JSON 数据）
• 开箱即用，便于集成至 Discord 机器人、自动化告警系统及 cron 任务

快速上手

1. 分析持仓组合

如需快速分析投资组合，请以 JSON 对象形式提供持仓信息：

python3 scripts/portfolio-analyzer.py portfolio --holdings '{"BTC": 1.5, "ETH": 10.2, "SOL": 50, "DOGE": 10000}'

预期输出：

📊 CRYPTO PORTFOLIO REPORT
==================================================
💰 总价值：$125,750.50
🟢 总盈亏（P&L）：$15,750.50（+14.32%）

📈 持仓明细：
BTC:
  💵 价值：$89,237.50（占投资组合 71.0%）
  🟢 盈亏：$8,987.50（+11.20%）
  🔴 24 小时涨跌幅：-3.92%

2. 市场概览

获取关注列表中资产的情绪与价格概览：

python3 scripts/portfolio-analyzer.py market

3. 配置文件设置

如需启用成本基础追踪等高级功能，请创建 portfolio-config.json 文件：

{
  "cost_basis": {
    "BTC": 45000,
    "ETH": 2800,
    "SOL": 85
  },
  "watchlist": ["BTC", "ETH", "SOL", "DOGE", "XRP"],
  "target_allocation": {
    "BTC": 40,
    "ETH": 30,
    "SOL": 20,
    "Other": 10
  }
}

核心能力

1. 投资组合估值计算

计算投资组合总价值，并提供逐项持仓明细：

• 实时价格：通过 CoinGecko API 获取（无需 API 密钥）
• 成本基础追踪：确保 P&L 计算准确无误
• 24 小时变动：显示每项持仓的 24 小时涨跌幅
• 投资组合配置比例：按币种统计占比
• 整体投资组合盈亏：含金额与百分比增益/亏损

支持的币种：BTC、ETH、SOL、DOGE、XRP、ADA、AVAX、LINK、DOT、UNI、NEAR、ATOM 等。

2. 市场分析

针对您的关注列表提供市场情绪分析：

• 市场情绪分类（看涨 / 看跌 / 中性）
• 所有已追踪币种的平均 24 小时涨跌幅
• 各币种单独表现（含当前价格与涨跌幅）
• 市值数据：覆盖所支持的加密货币

3. 报告生成

提供多种输出格式，适配不同使用场景：

文本格式：人类可读报告，含 emoji 指示符与格式化数字

# 生成文本报告
python3 scripts/portfolio-analyzer.py portfolio --holdings holdings.json

JSON 格式：结构化数据，适用于自动化流程与系统集成

# 生成 JSON 数据用于自动化
python3 scripts/portfolio-analyzer.py portfolio --holdings holdings.json --format json

4. 即插即用式集成能力

专为自动化与系统集成而设计：

• Discord 机器人集成：自动推送每日投资组合更新
• cron 任务自动化：定时执行投资组合检查
• 告警系统：监控投资组合价值阈值
• API 消费就绪：JSON 输出可直接对接 Webhook 或外部 API

常见使用场景

每日投资组合监控

配置自动化每日报告：

# 添加至 cron 或 OpenClaw cron 任务
python3 scripts/portfolio-analyzer.py portfolio --holdings ~/.crypto/holdings.json > daily-report.txt

再平衡分析

对比当前配置与目标配置：

1. 在 portfolio-config.json 中设定目标配置比例
2. 运行投资组合分析，查看当前实际配置
3. 识别需调整仓位的资产

绩效追踪

长期监控盈亏变化趋势：

# 记录每日数值用于趋势分析
echo "$(date): $(python3 scripts/portfolio-analyzer.py portfolio --holdings holdings.json --format json | jq '.total_value')" >> portfolio-history.log

税务申报支持

生成盈亏明细数据，辅助税务计算：

# 导出详细的盈亏分解数据
python3 scripts/portfolio-analyzer.py portfolio --holdings holdings.json --format json | jq '.breakdown'

配置选项

成本基础设置

定义各币种平均买入价，确保盈亏计算准确：

{
  "cost_basis": {
    "BTC": 45000,    // 您的 BTC 平均买入价
    "ETH": 2800,     // 您的 ETH 平均买入价
    "SOL": 85        // 您的 SOL 平均买入价
  }
}

若未配置成本基础，P&L 计算将以当前市价为基准（结果将显示 $0 P&L）。

关注列表定制

自定义市场概览中需追踪的币种：

{
  "watchlist": ["BTC", "ETH", "SOL", "DOGE", "XRP", "ADA", "AVAX", "LINK"]
}

目标配置比例

设定再平衡分析所需的目标资产配置比例：

{
  "target_allocation": {
    "BTC": 40,    // 目标比特币占比 40%
    "ETH": 30,    // 目标以太坊占比 30%
    "SOL": 20,    // 目标索拉纳占比 20%
    "Other": 10   // 目标其他资产占比 10%
  }
}

错误处理机制

本技能内置健壮的错误处理逻辑：

• API 故障：CoinGecko 不可用时自动优雅降级
• 持仓格式错误：对非法 JSON 输入提供清晰错误提示
• 配置文件缺失：缺失配置时采用合理默认值
• 网络超时：设 10 秒超时限制，并附带错误上报机制

集成示例

Discord 机器人集成

const { exec } = require('child_process');

async function postPortfolioUpdate() {
  const command = 'python3 scripts/portfolio-analyzer.py portfolio --holdings holdings.json --format json';
  exec(command, (error, stdout) => {
    if (!error) {
      const portfolio = JSON.parse(stdout);
      const message = `📊 投资组合：$${portfolio.total_value.toLocaleString()} | P&L：${portfolio.total_pnl >= 0 ? '🟢' : '🔴'} ${portfolio.total_pnl_pct.toFixed(2)}%`;
      // 发送至 Discord 频道
    }
  });
}

OpenClaw 自动化集成

// 在 OpenClaw 技能或 cron 任务中
const portfolioData = await exec('python3 ~/.openclaw/workspace/skills/crypto-portfolio-tracker/scripts/portfolio-analyzer.py portfolio --holdings holdings.json --format json');
const portfolio = JSON.parse(portfolioData);

if (portfolio.total_value > 100000) {
  await notify('投资组合已突破 $100k！');
}

资源目录

scripts/

• portfolio-analyzer.py：主投资组合追踪与分析脚本
• portfolio-tracker.js：Node.js 集成封装器（源自 crypto-alerts 项目）

references/

• usage-examples.md：详尽的使用示例、配置说明与集成模式
• config-example.json：包含全部可用配置项的样例配置文件

更多详细示例与集成模式，请参阅 references/usage-examples.md。