## 全局地图 ``` 服务器 │ ├── /opt/winning-wallet-finder/ ← 项目代码（git clone 来的） │ ├── copybot.py ← bot 主程序 │ ├── copybot.paper.json ← paper 配置（跟哪些钱包、金额） │ ├── config.live.json ← live 配置（跟哪些钱包、金额） │ ├── copybot_state.json ← paper bot 的账本（自动生成） │ ├── copybot_state.live.json ← live bot 的账本（自动生成） │ ├── copybot_fills.jsonl ← paper 成交记录 │ ├── copybot_fills.live.jsonl ← live 成交记录 │ └── live/ │ ├── serve_dashboard.py ← 网页 dashboard 程序 │ ├── bot_dashboard.html ← 中文界面 │ ├── copybot_live.json ← paper bot 的实时 feed │ ├── copybot_live_real.json ← live bot 的实时 feed │ ├── portfolio.py ← 回测程序 │ ├── backtest.json ← 回测配置 │ ├── daily.sh ← 每日流水线 │ └── cache.duckdb ← 钱包历史数据缓存 │ ├── /etc/systemd/system/ ← systemd 服务定义（4 个） │ ├── copybot-paper.service ← paper bot 服务 │ ├── copybot-live.service ← live bot 服务 │ ├── copybot-dashboard.service ← dashboard 服务 │ └── mihomo.service ← 代理服务 │ ├── /etc/copybot/ ← 环境变量文件（密钥、代理） │ ├── paper.env ← paper bot 的环境变量 │ └── live.env ← live bot 的环境变量 │ ├── /etc/mihomo/ ← 代理配置 │ ├── config.yaml ← Clash 订阅配置 │ └── cache.db ← 记住上次选的节点 │ ├── /usr/local/bin/mihomo ← 代理程序本体（二进制） ├── /opt/mihomo-healthcheck.sh ← 代理健康检查脚本 ├── /opt/winning-wallet-finder/.netrc ← Gitea PAT 认证（wwf 用户用，bot 自动 push 时读） │ └── crontab ← 定时任务 ├── 0 2 * * * daily.sh ← 每日 10:00 北京时间跑回测 └── */5 * * * * mihomo-healthcheck.sh ← 每 5 分钟检查代理 ``` > `.netrc` 不在目录树里显示是因为它是隐藏文件（以 `.` 开头）。用 `ls -la` 才能看到。 ## 三个文件夹的分工 | 文件夹 | 放什么 | 为什么在这 | | ----------------------------- | -------------------------- | ---------------------------------- | | `/opt/winning-wallet-finder/` | 项目代码 + 配置 + 状态 | git clone 来的，所有代码在这 | | `/etc/systemd/system/` | 服务定义（.service 文件） | Linux 约定俗成，systemd 服务都放这 | | `/etc/copybot/` | 环境变量（密钥、代理地址） | 敏感文件不放代码仓库，独立管理 | | `/etc/mihomo/` | 代理配置 | mihomo 的数据目录 | > `/opt` 是你的代码，`/etc` 是系统配置。分开是因为**密钥不应该跟代码放一起**（怕 commit 到 Gitea 泄露）。 ## live.env 和 config.live.json 怎么连起来的 它们**不在一个文件夹**，但 systemd 是桥梁： ``` /etc/systemd/system/copybot-live.service │ │ ExecStart=python3 copybot.py --config config.live.json --live │ ↑ │ 读 /opt/winning-wallet-finder/config.live.json │ （跟哪些钱包、金额、风险参数） │ │ EnvironmentFile=/etc/copybot/live.env │ ↑ │ 读 /etc/copybot/live.env │ （私钥、代理地址、确认短语） │ ▼ copybot.py 启动时： 1. 从 EnvironmentFile 读 LIVE_PRIVATE_KEY -> 放进 config["live"]["private_key"] 2. 从 EnvironmentFile 读 HTTPS_PROXY -> 所有网络请求走代理 3. 从 --config 读 config.live.json -> 知道跟哪些钱包、bankroll 多少 4. 合并两者 -> 完整配置 ``` 简单说： | 文件 | 内容 | 在哪 | 谁读 | | ------------------ | -------------------------- | ----------------------------- | ------------------------------------------ | | `config.live.json` | 跟哪些钱包、金额、风险参数 | `/opt/winning-wallet-finder/` | `--config` 参数传给 copybot.py | | `live.env` | 私钥、代理、确认短语 | `/etc/copybot/` | systemd `EnvironmentFile` 自动注入环境变量 | **为什么要分开**：config.live.json 可以 commit 到 Gitea（里面没有密钥），live.env 绝不能 commit（里面有私钥）。 ## 每个服务的完整启动链 ``` paper bot: systemd -> copybot.py --config copybot.paper.json + EnvironmentFile: paper.env (ALCHEMY_RPC_URL) = 直连 Polymarket，不走代理 live bot: systemd -> copybot.py --config config.live.json --live + EnvironmentFile: live.env (LIVE_PRIVATE_KEY + HTTPS_PROXY + TRADE LIVE) = 走代理绕 geo-block，真钱下单 dashboard: systemd -> serve_dashboard.py = 读本地 JSON 文件（不涉及 Gitea），网页展示 - /api/feed -> live/copybot_live.json (paper) - /api/live -> live/copybot_live_real.json (live) - / -> live/bot_dashboard.html (中文界面) mihomo: systemd -> mihomo -d /etc/mihomo = 代理服务，监听 127.0.0.1:7890 ``` ## bot 自动推 Gitea（自动备份 + 远程可读） bot 和 daily.sh 会自动把状态文件 commit + push 到 Gitea，**不需要你手动操作**。 ### 推什么 | 推什么 | 频率 | 谁推的 | 目的 | |---|---|---|---| | `copybot_state.json` / `copybot_state.live.json` | 有状态变化时（节流） | bot 自动（`publish_feed()`） | 备份账本 | | `live/copybot_live.json` / `live/copybot_live_real.json` | 有状态变化时 | bot 自动 | 备份 feed | | `copybot_fills.jsonl` / `copybot_fills.live.jsonl` | 有成交时 | bot 自动 | 备份成交记录 | | `live/watch_sharps.json` + `watch_skilled.json` + `dashboard.html` + `portfolio.json` | 每天 1 次 | daily.sh 自动 | 刷新钱包池 | ### 认证方式 wwf 用户的 `.netrc` 文件（`/opt/winning-wallet-finder/.netrc`）里有 Gitea PAT，git push 时自动读，不需要手动输密码。 ### git log 里你会看到 ``` copybot: live paper feed [skip ci] ← bot 自动推的（每次有状态变化） fix: re-query order after cancel... ← 你手动推的（改代码） docs: add 日常使用.md... ← 你手动推的（改文档） ``` `[skip ci]` 表示跳过 CI（这个项目没配 CI，只是习惯标记）。 ### 这导致的副作用 你在本地改完代码 `git push` 时经常被拒： ``` ! [rejected] main -> main (fetch first) ``` 因为服务器上的 bot 已经自动 commit 了新的 state。解决方法： ```bash # 方法 1：rebase（推荐，保留你的改动） git pull --rebase --autostash origin main && git push origin main # 方法 2：强制用远程版本（会丢本地未提交的改动，慎用） git fetch origin && git reset --hard origin/main ``` ### 远程读 JSON（不用 SSH 上服务器） Gitea 提供 raw URL，浏览器直接访问就能看 bot 的实时数据： ``` # paper bot feed https://code.aifunny.ltd/gavindiaz/winning-wallet-finder/raw/branch/main/live/copybot_live.json # live bot feed https://code.aifunny.ltd/gavindiaz/winning-wallet-finder/raw/branch/main/live/copybot_live_real.json # 钱包候选列表 https://code.aifunny.ltd/gavindiaz/winning-wallet-finder/raw/branch/main/live/watch_sharps.json ``` > 但 raw JSON 不好看，建议还是用 dashboard（`http://45.207.206.36:18080/`）。 ### ⚠️ 注意：本地 Clash 会拦截直连 IP 如果你本地开了 Clash Verge 系统代理，访问 `http://45.207.206.36:18080/` 可能被拦截（Clash 把直连 IP 也走了代理）。解决方法： 1. **关掉 Clash 系统代理**（最简单） 2. 或在 Clash 规则里加 `IP-CIDR,45.207.206.36/32,DIRECT`（让这个 IP 直连不走代理） --- ## 你日常改东西去哪改 | 想改什么 | 改哪个文件 | 在哪 | | --------------------------- | ------------------------------------------ | ----------------------------- | | 跟哪些钱包 / 金额 | `copybot.paper.json` 或 `config.live.json` | `/opt/winning-wallet-finder/` | | 私钥 / 代理地址 / 确认短语 | `live.env` | `/etc/copybot/` | | Alchemy RPC | `paper.env` | `/etc/copybot/` | | bot 程序参数（poll 间隔等） | `.service` 文件 | `/etc/systemd/system/` | | 代理节点 / 订阅 | `config.yaml` | `/etc/mihomo/` | | 每日 cron 时间 | `crontab -e` | 系统 | | dashboard 端口 | `.service` 文件加 `Environment="PORT=xxx"` | `/etc/systemd/system/` | 改完任何东西记得 `systemctl restart 对应服务`。