# T1 运行更新文档 — yitb.com 龙虾官网

> 版本: v1.0 | 创建: 2026-03-27 | 维护: 梵高(C电脑)
> 规则变更时同步更新本文档（本地 + 服务器）
> 本地: ~/.openclaw/workspace/T2/T1运行更新文档.md
> 服务器: https://yitb.com/docs/T1运行更新文档.md

---

## 一、排行榜系统（3个）

### 1.1 三大排行榜

| 排行榜 | URL | 数据文件 | 目标数量 |
|--------|-----|---------|---------|
| OpenClaw排行榜 | /claw-rankings.html | data/claw_rankings.json | **50条** |
| AI模型排行榜 | /model-rankings.html | data/rankings.json | **50条** |
| Skills排行榜 | /skills-rankings.html | data/skills_rankings.json | **50条** |

### 1.2 排行榜统一展示要求

每行必须包含：

| 字段 | 说明 | 必填 |
|------|------|------|
| 排名序号 | 1-50 | ✅ |
| 名称 | 产品/模型/Skill名称 | ✅ |
| 指数/评分 | 龙虾指数/ELO/热力指数 | ✅ |
| 价格 | 定价或"免费/开源" | ✅ |
| 关键信息 | 分类/厂商/Stars/下载量等 | ✅ |

### 1.3 排行榜数据要求

- **每个排行榜必须50条数据**，不足的需补充
- 数据来源优先自动采集（API），其次AI辅助填充
- 每周至少更新1次（Cron每周一09:00）
- 数据变动>3位自动生成"排名异动"新闻

### ⚠️ 1.4 排行榜更新铁律（联动三件套）

**任何排行榜数据变更，必须同时完成以下3步，缺一不可：**

```
排行榜JSON更新 ──→ ① 新产品生成落地页（/product/xxx.html）
                  ② 首页/排行榜页数据同步刷新
                  ③ T1运行更新文档同步更新变更日志
```

- **新增产品** → 自动生成对应落地页HTML → SCP上传 → chown
- **产品下架** → 落地页保留（301到排行榜页），JSON移除
- **数据修改** → 落地页同步更新（重新生成覆盖）
- **首页数据** → 如首页展示Top N排行，同步更新
- **文档同步** → 变更日志记录日期+变更内容

**执行顺序：JSON → 落地页 → 首页 → 文档 → 验证**

### 1.4 当前缺口

| 排行榜 | 当前数量 | 缺口 | 修复优先级 |
|--------|---------|------|-----------|
| Claw产品 | 25 | **缺25** | 🔴 高 |
| AI模型 | 17（详情页）/ ~30（JSON） | **缺20+** | 🔴 高 |
| Skills | 30 | **缺20** | 🟡 中 |

---

## 二、AI产品落地页系统

### 2.1 铁律

**排行榜每增加一个产品，必须同时创建对应的产品落地页。**

```
排行榜点击名称 → 新窗口打开 → /product/model-{slug}.html
                              /product/product-{slug}.html
                              /product/skill-{slug}.html
```

### 2.2 落地页URL规范

| 类型 | URL格式 | 示例 |
|------|---------|------|
| Claw产品 | /product/product-{slug}.html | /product/product-openclaw.html |
| AI模型 | /product/model-{slug}.html | /product/model-claude-opus-4-6.html |
| Skills | /product/skill-{slug}.html | /product/skill-wecom-openclaw-plugin.html |

### 2.3 落地页SEO标准（每页必须满足）

```html
<title>{产品名} - {tagline一句话描述} - 龙虾官网</title>
<meta name="description" content="{200字以上描述，覆盖核心功能+使用场景+对比优势}">
<meta name="keywords" content="{产品名},{开发商},AI模型,LLM,AI Agent,龙虾官网">
```

### 2.4 落地页内容规范

| 区域 | 内容 | 必须 |
|------|------|------|
| Hero区 | 产品名 + Logo/Emoji + 评分 + **🌐跳转到官网**按钮 | ✅ |
| 核心亮点 | 标签云（3-6个关键特性标签） | ✅ |
| 详细参数表 | 模型：ELO/价格/上下文/模态；产品：Stars/定价/平台 | ✅ |
| 产品介绍 | 200字以上详细描述 | ✅ |
| 底部CTA | **"立即使用"/"跳转到官网"**醒目按钮 | ✅ |
| 相关推荐 | 同类产品3-5个链接 | ✅ |

### 2.5 落地页生成方式

- 数据源：`data/products_db.json`
- 生成器：`generate_product_pages.py`
- 新增产品时：更新JSON → 运行生成器 → SCP上传 → chown apache:apache

---

## 三、新闻系统（3个分类）

### 3.1 三大新闻分类

| 分类 | URL | 内容方向 |
|------|-----|---------|
| 龙虾新闻 | /category/news/ | AI行业每日热点，全球AI前沿动态，OpenClaw相关，国产Claw内容 |
| 龙虾新手指南 | /category/guides/ | 从零学AI，手把手入门龙虾AI生态，OpenClaw教程，国产Claw使用 |
| MCP生态 | /category/mcp/ | MCP协议解析，Server开发实战，Agent赚钱案例 |

### 3.2 更新频率（铁律）

```
每天2更：
  第1更：08:00 — 每分类2篇 = 6篇
  第2更：20:00 — 每分类2篇 = 6篇
每天总计：12篇（3分类 × 2篇 × 2更）
```

### 3.3 内容来源与处理规则

**国外内容（汉化）：**
- 来源：RSS（The Verge / Ars Technica / HN / TechCrunch / NVIDIA / VentureBeat）
- 处理规则：
  1. 保留核心信息和技术细节
  2. 翻译成通顺中文（不是机翻）
  3. SEO关键词前置到首段
  4. 去掉原文水印/广告
  5. 适当加入龙虾生态关联（自然不生硬）

**国内内容（SEO原创重写）：**
- 来源：RSS（36kr / 机器之心）+ Brave搜索
- 处理规则：
  1. 保留核心观点和数据
  2. 用自己的话重写（**禁止抄袭原文**）
  3. 标题含核心关键词，利于百度SEO
  4. 首段200字覆盖主关键词
  5. 结构化：用##小标题分段，每段≤3行
  6. 结尾给出用户行动建议

**SEO写作铁律：**
- 字数：800-1500字
- 标题：20-35字，含核心技术关键词
- 不要AI腔：禁用"在当今时代""随着AI发展""总而言之""值得注意的是"
- 每篇必须有技术细节或实用价值
- 自然关联OpenClaw/龙虾生态（不生硬植入）

### 3.4 图片要求

| 图片 | 数量 | 生成方式 | 说明 |
|------|------|---------|------|
| 封面图 | 1张 | Gemini AI生成 | 16:9，与标题相关，无文字水印，同时插入文章开头 |
| 内容配图 | 1张 | Gemini AI生成 | 与文章核心内容匹配，插入正文中部 |
| 合计 | 2张/篇 | — | 每天24张图 |

**图片上传规范：**
```bash
# SCP上传后必须
chown apache:apache /alidata/www/yitb/usr/uploads/covers/*.png
```

### 3.5 模型调用链

```
Gemini Flash(选题+标题) → MiniMax(写作) → Claude Sonnet(润色去AI味) → Gemini(封面+配图)
```

### 3.6 发布API

```bash
curl -X POST https://yitb.com/api/publish.php \
  -H "Content-Type: application/json" \
  -H "X-API-Key: lxgw_auto_2026_Kj8mNp3qRs" \
  -d '{"title":"标题","content":"Markdown正文","category":"news|guides|mcp","tags":["AI"]}'
```

---

## 四、Cron自动化

| 任务 | 时间 | 脚本 | 内容 |
|------|------|------|------|
| T1 微信公众号 | 每天 04:00 | run_daily_all.sh | 5个号自动创作 |
| T2 第1更 | 每天 08:00 | run_yitb_daily.sh | 3分类×2篇=6篇 |
| T2 第2更 | 每天 20:00 | run_yitb_daily.sh | 3分类×2篇=6篇 |
| 排行榜更新 | 每周一 09:00 | 待建 | 3排行榜数据刷新 |

---

## 五、服务器信息

| 项 | 值 |
|---|---|
| IP | 39.104.13.44 |
| SSH | root / 202354MASKid~~ |
| 数据库 | MySQL root / 461f7d470c / yitb |
| 后台 | yitb.com/admin / admin / Wali123456 |
| 网站根目录 | /alidata/www/yitb/ |
| 数据目录 | /alidata/www/yitb/data/ |
| 主题目录 | /alidata/www/yitb/usr/themes/yitb/ |
| 封面目录 | /alidata/www/yitb/usr/uploads/covers/ |
| 产品页目录 | /alidata/www/yitb/product/ |

---

## 六、异常处理

| 异常 | 处理 |
|------|------|
| API发布失败 | 重试1次，失败则记录日志+通知MASK |
| Gemini图片生成失败 | 跳过图片继续发布（文章优先） |
| RSS抓取全部失败 | 用Brave搜索兜底 |
| 模型API限流 | 降级到备用模型（Gemini Flash→Qwen） |
| 服务器不可达 | 立即通知MASK |
| 排行榜数据异常 | 暂停更新，通知MASK人工确认 |
| 新闻每日<6篇 | 记录异常，下次补发 |

---

## 七、变更日志

| 日期 | 变更内容 |
|------|---------|
| 2026-03-27 | v1.0 创建，梵高接管T2运维 |
| 2026-03-27 | 新闻系统上线，3分类×2篇，Cron 08:00 |
| 2026-03-27 | 封面图Gemini生成+SCP上传流水线 |
| 2026-03-27 | SSL证书链修复（Apache分离cert+chain） |
| 2026-03-27 | 新增要求：每天2更共12篇，排行榜补到50，产品落地页 |