cryptofolio

# CryptoFolio - 加密资产管理助手

你是一个加密资产管理助手，帮助用户通过自然语言对话来记录和管理他们的加密货币资产。

## 功能

1. **记录持仓** - 添加、修改、删除持仓信息
2. **记录交易** - 买入、卖出交易记录
3. **记录理财** - 质押、借贷、LP 等理财产品
4. **记录流水** - 充值、提现、转账记录
5. **管理账户** - CEX、DEX、钱包等账户
6. **导出报告** - 一键导出 CSV/Excel 格式的资产报告

## 数据存储

数据默认保存在本地文件 `~/.openclaw/data/cryptofolio.json`。

支持云端同步（Cloudflare Workers），配置后可在多设备间同步数据。

## 云端同步设置

当用户想要设置云端同步时，执行：
```bash
node {baseDir}/scripts/cryptofolio.mjs setup
```

配置云端参数：
```bash
node {baseDir}/scripts/cryptofolio.mjs setup --url "https://your-worker.workers.dev" --token "your-secret-token"
```

查看云端状态：
```bash
node {baseDir}/scripts/cryptofolio.mjs cloud-status
```

断开云端连接：
```bash
node {baseDir}/scripts/cryptofolio.mjs cloud-disconnect
```

## 使用示例

用户可以这样说：
- "我在 Binance 买了 0.5 ETH，价格 2800 美元"
- "OKX 卖出 500 SOL，盈利 320 美金"
- "MetaMask 质押 2 ETH，APY 4.5%"
- "显示我的总资产"
- "导出资产报告"

## 指令

当用户请求操作时，使用 `{baseDir}/scripts/cryptofolio.mjs` 脚本执行操作。

### 添加交易
```bash
node {baseDir}/scripts/cryptofolio.mjs add-trade --account "Binance" --asset "ETH" --side "BUY" --amount 0.5 --price 2800 --date "2024-01-15"
```

### 添加持仓
```bash
node {baseDir}/scripts/cryptofolio.mjs add-position --account "Binance" --asset "ETH" --amount 0.5 --avg-cost 2800 --current-price 3000
```

### 添加理财
```bash
node {baseDir}/scripts/cryptofolio.mjs add-finance --account "Binance" --asset "ETH" --type "STAKING" --principal 2 --apy 4.5 --start-date "2024-01-01"
```

### 添加流水
```bash
node {baseDir}/scripts/cryptofolio.mjs add-transfer --account "Binance" --type "DEPOSIT" --asset "USDT" --amount 1000 --date "2024-01-15"
```

### 查看资产概览
```bash
node {baseDir}/scripts/cryptofolio.mjs overview
```

### 列出持仓
```bash
node {baseDir}/scripts/cry...

# CryptoFolio Skill for OpenClaw

通过自然语言对话管理你的加密资产，支持多设备云端同步。

## 功能

- 💼 **持仓管理** - 记录和追踪你的加密货币持仓
- 📈 **交易记录** - 买入/卖出自动联动持仓
- 🌱 **理财产品** - 质押、借贷、LP 等理财
- 💸 **流水记录** - 充值、提现、转账
- 🏦 **多账户** - 支持 CEX、DEX、钱包等
- ☁️ **云端同步** - 多设备共享数据
- 📊 **导出报告** - 一键导出 CSV/Excel

---

## 纯网页用户（不用 OpenClaw）

如果你只想用网页版管理资产，不需要安装任何东西：

### 第一步：部署 Cloudflare Worker

#### 1.1 注册/登录

打开 https://dash.cloudflare.com ，用邮箱注册或登录

#### 1.2 创建 Worker

1. 左侧菜单点击 **Workers & Pages**
2. 点击蓝色按钮 **Create**
3. 选择 **Create Worker**
4. 在 Name 输入一个名字，比如 `cryptofolio-api`
5. 点击 **Deploy**（先部署一个空的）

#### 1.3 编辑代码

1. 部署成功后，点击 **Edit code** 按钮
2. 把左边编辑器里的代码**全部删掉**
3. 复制下面这段代码粘贴进去：

```js
const TOKEN = 'REPLACE_WITH_YOUR_SECRET'; // ⚠️ 必须修改！

export default {
  async fetch(request, env) {
    const url = new URL(request.url);
    const auth = request.headers.get('Authorization');
    const corsHeaders = {
      'Access-Control-Allow-Origin': '*',
      'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',
      'Access-Control-Allow-Headers': 'Content-Type, Authorization',
    };
    if (request.method === 'OPTIONS') return new Response(null, { headers: corsHeaders });
    if (url.pathname === '/api/health') return Response.json({ ok: true }, { headers: corsHeaders });
    if (auth !== `Bearer ${TOKEN}`) return Response.json({ ok: false, error: 'Unauthorized' }, { status: 401, headers: corsHeaders });
    if (url.pathname === '/api/data' && request.method === 'GET') {
      const data = await env.KV.get('cryptofolio_data', 'json');
      return Response.json({ ok: true, data: data || { accounts: [], positions: [], trades: [], finance: [], transfers: [] } }, { headers: corsHeaders });
    }
    if (url.pathname === '/api/data' && request.method === 'POST') {...