# 如何新增一条 KOL 工具 / 系统

主人约定：**之后每次发现 KOL 做的网站、TG、雷达、教程、社群，都填进本站**，用于整理与复盘。不要编造收益；自报数字必须写进 `trustNote`。

## 步骤

1. 打开 `public/data/tools.json`
2. 在 `tools` 数组末尾追加一条对象（字段见下）
3. 更新顶层 `updatedAt`（Asia/Shanghai，带 `+08:00`）
4. （可选但推荐）为该 slug 生成详情页 `public/tools/<slug>.html`  
   - 可复制现有详情页改文案，或在 box 上跑：
   ```bash
   cd /workspace/crypto-guide-cf && python3 -c "
   # 若已有生成脚本习惯：重跑与首次相同的详情页生成逻辑
   import json, pathlib
   print('当前条目:', len(json.load(open('public/data/tools.json'))['tools']))
   "
   ```
   - 或让 Grok Bot：「按 CONTRIBUTE 给 slug=xxx 补详情页并 redeploy」
5. 部署：
   ```bash
   cd /workspace/crypto-guide-cf && npx wrangler deploy
   ```
6. 把完整调研笔记落到 `/workspace/<主题>-research.md` 或 playbook，路径写进 `notesPath`

## JSON 字段说明

| 字段 | 必填 | 说明 |
|---|---|---|
| `slug` | ✅ | URL 友好英文短名，如 `xiage-biquanxinhao`；详情页文件名同名 |
| `name` | ✅ | 工具/系统中文名 |
| `kol` | ✅ | KOL handle 或产品名，如 `@PolskaCebula`；非 KOL 产品写 `—` |
| `kolUrl` | ✅ | X 主页或产品站 |
| `type` | ✅ | 只能用：`信号推送` / `CEX雷达` / `链上` / `教程手册` / `社群` / `自建AI` / `数据源` |
| `entryUrl` | ✅ | 用户真正打开的入口（TG / 网页 / 主帖） |
| `oneLiner` | ✅ | 一句话：做什么、怎么触发 |
| `trustNote` | ✅ | 可信度：哪些可核、哪些自报、防骗提醒 |
| `discoveredAt` | ✅ | 发现日期 `YYYY-MM-DD`（Asia/Shanghai） |
| `notesPath` | ✅ | box 上复盘笔记绝对路径 |
| `extraLinks` | 可选 | `[{ "label", "url" }, …]` 教程帖、防伪帖等 |
| `tags` | 可选 | 字符串数组，便于搜索 |

## 模板（复制改）

```json
{
  "slug": "example-tool",
  "name": "示例工具名",
  "kol": "@handle",
  "kolUrl": "https://x.com/handle",
  "type": "信号推送",
  "entryUrl": "https://t.me/example",
  "oneLiner": "一句话说明功能与形态。",
  "trustNote": "可核事实 / 自报收益（未核账） / 防假群注意。",
  "discoveredAt": "2026-10-26",
  "notesPath": "/workspace/example-research.md",
  "extraLinks": [
    { "label": "公开介绍帖", "url": "https://x.com/handle/status/…" }
  ],
  "tags": ["TG", "示例"]
}
```

## 类型怎么选

- **信号推送**：TG/Discord 等私域告警（虾哥）
- **CEX雷达**：交易所微观结构公开网页（杰尼君、SmartVibe）
- **链上**：GMGN / Ave / Dex 类发现工具
- **教程手册**：BAW / 打新 / 配置长文
- **社群**：课程社区、观察群（非信号本体时）
- **自建AI**：蒸馏逻辑 + Grok/Codex 自跑（披萨）
- **数据源**：Coinglass 等原材料，标清「非 KOL 产品」

## 禁止

- 把自报盈亏写成已验证事实
- 把不同产品混成同一 slug（虾哥 ≠ 杰尼君 ≠ 披萨）
- 改坏同账号下的 `x-biz-models` / `fuliji` Worker