# 日常使用手册

> 部署完成后，每天只需花 5 分钟看一眼。大部分时间什么都不用做。
>
> 配合 `DEPLOY.md`（部署指南）、`USAGE.md`（项目逻辑）、`mihomo代理部署教程.md`（代理）一起看。

---

## 自动运行的部分（不用管）

| 任务 | 频率 | 做什么 |
|------|------|--------|
| paper bot | 24/7 | 模拟跟单，直连 |
| live bot | 24/7 | 真钱跟单，走代理 |
| mihomo 代理 | 24/7 | 日本节点绕 geo-block |
| dashboard | 24/7 | 网页展示实时账本 |
| daily.sh | 每天 02:00 UTC（10:00 北京） | 刷新钱包池、打分、回测、推 Gitea |
| 代理健康检查 | 每 5 分钟 | 节点挂了自动换 |

---

## 每日检查流程（约 5 分钟）

### 第 1 步：看 dashboard

浏览器打开 `http://45.207.206.36:18080/`（**先关掉本地 Clash 系统代理**，否则打不开）

dashboard 顶部现在有 3 个自动面板，一眼看完不用 SSH：

1. **系统健康**面板：
   - 4 个服务状态（Paper/Live/Dashboard/代理）全绿 = 正常
   - `CASH≠CHAIN: 正常` = 账本对得上
   - `心跳: X分X秒前` = bot 最后更新时间（>1 小时可能有问题，见紧急处理）

2. **每日流水线**面板：
   - `✓ 正常` + 上次运行时间 = daily.sh 今天跑成功了
   - 钱包池数量（76 skilled / 12 sharps）

3. **钱包建议**面板：
   - ❌ 已淘汰 = 当前跟的但不在 watch_sharps 里了 -> 必须换（见下方"换跟单钱包"）
   - ⬆️ 建议加 = 排名靠前但没跟的 -> 可以考虑
   - 全 ✅ = 不用动

然后点右上角按钮切到 **LIVE** 模式，看交易数据：
- **现金**：还剩多少能下单
- **已实现盈亏**：赚了还是亏了
- **开放订单**：有没有卡住的仓位
- **账本漂移**：是不是 $0.00（不是 = 有问题，见紧急处理）

> 如果 dashboard 三个面板全绿 + LIVE 数据正常，第 2-4 步可以跳过。

### 第 2 步：看日志有没有异常

SSH 上服务器，跑：

```bash
# live bot 最近 1 小时有没有报错
journalctl -u copybot-live --since "1 hour ago" --no-pager | grep -E "⚠|ERROR|FAIL|CASH≠CHAIN"

# 代理正常吗
/opt/mihomo-healthcheck.sh && echo "代理正常" || echo "代理异常"
```

- 没有 `⚠` 输出 = 正常
- 有 `CASH≠CHAIN` = 见下方紧急处理
- 代理异常 = 见下方紧急处理

### 第 3 步：看 daily.sh 有没有跑成功

```bash
# 看今天的日志末尾
tail -10 /opt/winning-wallet-finder/live/daily.log
```

预期末尾看到 `done -> watch_sharps.json + dashboard.html`。

如果没跑或报错，手动跑：

```bash
cd /opt/winning-wallet-finder/live && bash daily.sh
```

### 第 4 步：看钱包池有没有大变化（可选）

```bash
cat /opt/winning-wallet-finder/live/watch_sharps.json | python3 -m json.tool | grep -E "name|copy_pnl"
```

如果排名靠前的钱包变了，或者你正在跟的钱包被淘汰了，考虑换（见下方"换跟单钱包"）。

---

## 定期任务

### 换跟单钱包（每周看一次）

#### 去哪看

**方法 1（推荐）：dashboard 面板**

打开 `http://45.207.206.36:18080/`，顶部"钱包建议"面板直接显示：

```
当前跟的          排名    copy_pnl    信念胜率    状态
Vahan88          #1      +3486       86%        ✅ 正常
Kruto2027        #2      +2247       69%        ✅ 正常
0xbadaf319       #3      +1010       80%        ✅ 正常
1kto1m           #5      +719        98%        ✅ 正常
LSB1             #6      +706        91%        ✅ 正常

建议加:
⬆️ BikesAreTheBikes · #4 · +813 · 21%
```

- **❌ 已淘汰** = 当前跟的但不在 watch_sharps 里了 -> 必须踢
- **⬆️ 建议** = watch_sharps 排名前 6 但没跟的 -> 可以考虑加
- **✅ 正常** = 不用动

**方法 2：命令行看原始数据**

```bash
# 看 watch_sharps 排名（12 个可复制钱包）
cat /opt/winning-wallet-finder/live/watch_sharps.json | python3 -m json.tool | grep -E "name|copy_pnl|conv_win"

# 看你当前跟的 5 个
python3 -c "import json; [print(w['name']) for w in json.load(open('/opt/winning-wallet-finder/config.live.json'))['wallets']]"
```

#### 什么时候要换

- dashboard 面板里有 **❌ 已淘汰** -> 必须踢，换成 ⬆️ 建议的
- 某个钱包连续亏钱（看 dashboard 的"最近结算"盈亏列）-> 考虑踢
- ⬆️ 建议的钱包 copy_pnl 明显高于你跟的最差的 -> 考虑优化

#### 怎么换

**改哪两个文件**：

| 文件 | 位置 | 改什么 |
|------|------|--------|
| `config.live.json` | `/opt/winning-wallet-finder/config.live.json` | live bot 跟的钱包 |
| `copybot.paper.json` | `/opt/winning-wallet-finder/live/copybot.paper.json` | paper bot 跟的钱包 |

> 两个文件必须改一致（paper 和 live 跟同一批钱包，结果才可比）。

**换的脚本**（踢旧的 + 加新的，paper 和 live 一起改）：

```bash
cd /opt/winning-wallet-finder

python3 <<'PYEOF'
import json

# === 在这里配置：保留哪些、加哪些 ===
keep_names = {"Kruto2027", "0xbadaf319", "1kto1m"}       # 保留的
add_names = ("Vahan88", "LSB1")                            # 新加的

# 从 watch_sharps.json 查新钱包地址
sharps = json.load(open("live/watch_sharps.json"))
addr_map = {}
for w in sharps:
    if w.get("name") in add_names:
        addr_map[w["name"]] = w["wallet"]

# 改 paper 配置和 live 配置
for cfg_path in ["live/copybot.paper.json", "config.live.json"]:
    cfg = json.load(open(cfg_path))
    old = [w["name"] for w in cfg["wallets"]]
    new = [w for w in cfg["wallets"] if w["name"] in keep_names]
    for name in add_names:
        if name in addr_map:
            new.append({"wallet": addr_map[name], "name": name,
                         "class": "volume", "floor": 25.0})
    cfg["wallets"] = new
    json.dump(cfg, open(cfg_path, "w"), indent=2)
    print(f"{cfg_path}: {old} -> {[w['name'] for w in new]}")
PYEOF

# 修权限
chown wwf:wwf live/copybot.paper.json config.live.json

# 重启两个 bot
systemctl restart copybot-paper
systemctl restart copybot-live
sleep 10

# 验证
journalctl -u copybot-paper --since "10 seconds ago" --no-pager | grep "watching"
journalctl -u copybot-live --since "10 seconds ago" --no-pager | grep "watching"
```

> 改之前把 `keep_names` 和 `add_names` 换成你实际的值。新钱包 floor 先设 $25，明天 daily.sh 会自动算真实 p80 门槛。

**改完后的操作**：
1. 上面脚本已经自动重启了两个 bot
2. 验证两个 bot 都 `watching 5 wallets`
3. 刷新 dashboard，"钱包建议"面板应该全是 ✅ 正常

### 手动兑现已结算仓位

bot 只自动跟单买卖，不自动 redeem（兑现）。已结算的仓位需要手动去 Polymarket 网站兑现。

1. 浏览器登录 https://polymarket.com（MetaMask）
2. 看 Portfolio 里有没有 "Redeem" 按钮
3. 点兑现，钱回到存款钱包
4. 兑现后更新 bankroll（见下方"充钱后更新 bankroll"）

### 充钱后更新 bankroll

从交易所充 USDC 到存款钱包后，bot 不会自动认。需要手动更新：

```bash
# 1. 停 bot
systemctl stop copybot-live

# 2. 查链上实际 pUSD 余额
export LIVE_PRIVATE_KEY=$(grep LIVE_PRIVATE_KEY /etc/copybot/live.env | cut -d= -f2-)
export HTTPS_PROXY=http://127.0.0.1:7890
python3 -c "from polymarket import SecureClient; c=SecureClient.create(private_key='$LIVE_PRIVATE_KEY'); b=c.get_balance_allowance(asset_type='COLLATERAL'); print('链上 pUSD: %.2f' % (b.balance/1e6)); c.close()"

# 3. 把上面的数字填进去（替换 X.XX）
sed -i 's/"bankroll_usd": [0-9.]*/"bankroll_usd": X.XX/' /opt/winning-wallet-finder/config.live.json

# 4. 清 state
rm -f /opt/winning-wallet-finder/copybot_state.live.json
rm -f /opt/winning-wallet-finder/copybot_fills.live.jsonl
rm -f /opt/winning-wallet-finder/live/copybot_live_real.json

# 5. 重启
systemctl start copybot-live
sleep 10
journalctl -u copybot-live --since "15 seconds ago" --no-pager | grep -E "bankroll|armed"
```

---

## 紧急处理

### CASH≠CHAIN（账本与链上不一致）

**怎么发现**：dashboard 显示"账本漂移"不为 $0.00，或日志有 `⚠ CASH≠CHAIN`

**原因**：in-play 赛事的订单成交了但 bot 没追踪到（已修复大部分情况，但极端情况可能还会出现）

**处理**：跟"充钱后更新 bankroll"流程一样--停 bot、查链上余额、改 bankroll、清 state、重启。

```bash
systemctl stop copybot-live
export LIVE_PRIVATE_KEY=$(grep LIVE_PRIVATE_KEY /etc/copybot/live.env | cut -d= -f2-)
export HTTPS_PROXY=http://127.0.0.1:7890
python3 -c "from polymarket import SecureClient; c=SecureClient.create(private_key='$LIVE_PRIVATE_KEY'); b=c.get_balance_allowance(asset_type='COLLATERAL'); print('链上 pUSD: %.2f' % (b.balance/1e6)); c.close()"

# 用查到的数字替换 X.XX
sed -i 's/"bankroll_usd": [0-9.]*/"bankroll_usd": X.XX/' /opt/winning-wallet-finder/config.live.json
rm -f /opt/winning-wallet-finder/copybot_state.live.json /opt/winning-wallet-finder/copybot_fills.live.jsonl /opt/winning-wallet-finder/live/copybot_live_real.json
systemctl start copybot-live
```

> 钱不会丢，在链上。清 state 只是重置 bot 的账本，让它在正确的余额上重新开始。

### 代理挂了

**怎么发现**：`/opt/mihomo-healthcheck.sh` 返回异常，或 live bot 日志报连接超时

**处理**：

```bash
# 1. 看 mihomo 活着吗
systemctl status mihomo

# 2. 没活就启动
systemctl start mihomo
sleep 5

# 3. 看当前节点
curl -s http://127.0.0.1:9090/proxies/GLOBAL | python3 -c "import sys,json; print('当前:', json.load(sys.stdin).get('now'))"

# 4. 测代理通不通
HTTPS_PROXY=http://127.0.0.1:7890 python3 /opt/winning-wallet-finder/host/geocheck.py | tail -1

# 5. 不通就手动换节点
curl -s -X PUT http://127.0.0.1:9090/proxies/GLOBAL \
  -H "Content-Type: application/json" \
  -d '{"name":"🇯🇵日本高速06|BGP|CTCU"}'

# 6. live bot 会自动重启（Requires=mihomo.service）
```

### RTDS 断了（`⚠ rtds down`）

**怎么发现**：日志有 `⚠ rtds down`，或 `24h lag` 变大（从 ~3 秒变成 ~17 秒以上），`slip` 变差

**原因**：实时 WebSocket 连接断了（网络抖动 / 代理切换 / 服务器重启），bot 退回到 60 秒轮询模式

**影响**：检测延迟从 ~3 秒变成 ~17 秒，滑点变差。$5 测试资金无所谓，加大资金后延迟 = 滑点 = 亏钱

**处理**：重启 live bot 重连 WebSocket：

```bash
systemctl restart copybot-live
sleep 10
journalctl -u copybot-live --since "15 seconds ago" --no-pager | grep -E "rtds|armed"
```

预期看到 `rtds: connected - activity/trades stream up (T0 detection)`，不再是 `rtds down`。

### dashboard 打不开

**怎么发现**：浏览器访问 `http://45.207.206.36:18080/` 超时或拒绝连接

**原因**：dashboard 服务挂了，或端口没监听

**处理**：

```bash
# 1. 看服务状态
systemctl status copybot-dashboard --no-pager | head -10

# 2. 看端口在不在
ss -tlnp | grep 18080

# 3. 不在就重启
systemctl restart copybot-dashboard
sleep 3
ss -tlnp | grep 18080
```

重启后端口在监听就能打开。如果还是不行，看日志：

```bash
journalctl -u copybot-dashboard --since "5 minutes ago" --no-pager | tail -20
```

### live bot 崩了

**怎么发现**：dashboard 不更新，或 `systemctl status copybot-live` 不是 active

**处理**：

```bash
# 看报错
journalctl -u copybot-live --since "30 minutes ago" --no-pager | tail -30

# 大部分情况重启就行
systemctl restart copybot-live
sleep 10
journalctl -u copybot-live --since "15 seconds ago" --no-pager | grep -E "armed|bankroll|watching|rtds"
```

### paper bot 崩了

```bash
journalctl -u copybot-paper --since "30 minutes ago" --no-pager | tail -30
systemctl restart copybot-paper
```

### 紧急退出（一键清仓所有 live 仓位）

**什么时候用**：发现严重问题需要立刻清仓（bot 失控 / edge 消失 / 需要紧急撤资）

```bash
# 停 bot 防止它继续下单
systemctl stop copybot-live

# 一键市价卖出所有仓位
cd /opt/winning-wallet-finder
export LIVE_PRIVATE_KEY=$(grep LIVE_PRIVATE_KEY /etc/copybot/live.env | cut -d= -f2-)
export HTTPS_PROXY=http://127.0.0.1:7890
python3 host/flatten_positions.py
```

> ⚠️ 这是**真钱操作**，市价卖出可能有滑点损失。只在紧急情况用。

### edge 消失（钱包突然不交易或从 API 消失）

**怎么发现**：某个跟单钱包连续 1 周没有 FOLLOW 信号，或 watch_sharps 里突然找不到

**原因**：作者研究发现 edge 可能随时消失（钱包可能被 Polymarket 封禁、改变策略、或信息源断了）

**处理**：
1. 确认钱包是否还在 watch_sharps.json 里
2. 如果不在了 -> 从跟单配置里踢掉，从 bench 里选替补
3. 如果还在但不交易 -> 观察 1 周，无改善则踢掉
4. **赚钱了定期取出来**，不要假设 edge 永久存在

---

## 更新代码

本地改完代码推到 Gitea 后，在服务器上拉：

```bash
cd /opt/winning-wallet-finder
git fetch origin
git reset --hard origin/main

# 如果改了 copybot.py，重启两个 bot
systemctl restart copybot-paper
systemctl restart copybot-live
```

> `git reset --hard` 会丢弃服务器上的本地改动（bot 自动 commit 的 state 文件等）。如果 bot 在跑，拉之前先 `systemctl stop copybot-paper copybot-live`，拉完再 `systemctl start`。

---

## 常用命令速查

### 看日志

```bash
journalctl -u copybot-live -f          # live bot 实时日志
journalctl -u copybot-paper -f         # paper bot 实时日志
journalctl -u copybot-dashboard -f     # dashboard 日志
journalctl -u mihomo -f                # 代理日志
tail -f /opt/winning-wallet-finder/live/daily.log  # daily.sh 日志
```

> `Ctrl+C` 退出日志查看，**不会停服务**。

### 服务管理

```bash
systemctl status copybot-live          # 看状态
systemctl restart copybot-live         # 重启
systemctl stop copybot-live            # 停
systemctl start copybot-live           # 启动
```

### 代理管理

```bash
# 看当前节点
curl -s http://127.0.0.1:9090/proxies/GLOBAL | python3 -c "import sys,json; print('当前:', json.load(sys.stdin).get('now'))"

# 换节点
curl -s -X PUT http://127.0.0.1:9090/proxies/GLOBAL -H "Content-Type: application/json" -d '{"name":"节点名"}'

# 测代理
HTTPS_PROXY=http://127.0.0.1:7890 python3 /opt/winning-wallet-finder/host/geocheck.py | tail -1

# 手动健康检查
/opt/mihomo-healthcheck.sh && echo "正常" || echo "异常"
```

### 查链上余额

```bash
export LIVE_PRIVATE_KEY=$(grep LIVE_PRIVATE_KEY /etc/copybot/live.env | cut -d= -f2-)
export HTTPS_PROXY=http://127.0.0.1:7890
python3 -c "from polymarket import SecureClient; c=SecureClient.create(private_key='$LIVE_PRIVATE_KEY'); b=c.get_balance_allowance(asset_type='COLLATERAL'); print('链上 pUSD: %.2f' % (b.balance/1e6)); c.close()"
```

### 改配置

```bash
nano /opt/winning-wallet-finder/config.live.json           # live 跟单钱包/金额
nano /opt/winning-wallet-finder/live/copybot.paper.json    # paper 跟单钱包/金额
nano /etc/copybot/live.env                                 # 私钥/代理/确认短语
nano /etc/copybot/paper.env                                # Alchemy RPC
```

改完记得重启对应服务。

### 一键健康检查

```bash
# 如果 healthcheck.sh 还在 /tmp（可能重启后没了），重新创建见 DEPLOY.md
# 简化版检查：
echo "=== 服务状态 ==="
systemctl is-active copybot-paper copybot-live copybot-dashboard mihomo
echo "=== 代理 ==="
/opt/mihomo-healthcheck.sh && echo "正常" || echo "异常"
echo "=== live bot 最近心跳 ==="
journalctl -u copybot-live --since "5 minutes ago" --no-pager | tail -3
echo "=== daily.sh 今天跑了没 ==="
tail -3 /opt/winning-wallet-finder/live/daily.log
```

---

## 文件位置速查

| 文件 | 位置 | 用途 |
|------|------|------|
| 项目代码 | `/opt/winning-wallet-finder/` | git clone 来的 |
| live 配置 | `/opt/winning-wallet-finder/config.live.json` | 跟单钱包/金额 |
| paper 配置 | `/opt/winning-wallet-finder/live/copybot.paper.json` | 跟单钱包/金额 |
| live 环境变量 | `/etc/copybot/live.env` | 私钥/代理/确认短语 |
| paper 环境变量 | `/etc/copybot/paper.env` | Alchemy RPC |
| systemd 服务 | `/etc/systemd/system/copybot-*.service` | 4 个服务定义 |
| mihomo 配置 | `/etc/mihomo/config.yaml` | 代理订阅 |
| 健康检查脚本 | `/opt/mihomo-healthcheck.sh` | 代理自动轮换 |
| 钱包候选列表 | `/opt/winning-wallet-finder/live/watch_sharps.json` | 11 个可复制钱包 |
| 钱包池 | `/opt/winning-wallet-finder/live/watch_skilled.json` | 82 个有 edge 的钱包 |
| dashboard | `http://45.207.206.36:18080/` | 浏览器访问 |
| daily.sh 日志 | `/opt/winning-wallet-finder/live/daily.log` | 每日流水线日志 |

---

## 浏览器入口

| 入口 | 地址 | 看什么 |
|------|------|--------|
| 实时 dashboard | `http://45.207.206.36:18080/` | bot 现金/持仓/成交（PAPER/LIVE 可切换） |
| 原始 JSON (paper) | Gitea raw URL | paper bot 的 feed |
| 原始 JSON (live) | Gitea raw URL | live bot 的 feed |
| Polymarket | `https://polymarket.com` | MetaMask 登录看真实仓位/兑现 |
| Gitea 仓库 | `https://code.aifunny.ltd/gavindiaz/winning-wallet-finder` | 代码/文档 |
