# T1 基线状态文档 v1.0
> 快照时间：2026-03-25
> 版本：T1 v8.0 Baseline
> 用途：未来所有升级以此为准，异常时可还原到此状态

---

## 一、系统架构

```
yitb.com
├── /                          首页（动态读取JSON数据）
├── /claw-rankings.html        Claw产品排行榜
├── /model-rankings.html       AI模型排行榜
├── /skills-rankings.html      Skills排行榜
├── /product/model-*.html       AI模型落地页（50个）
├── /product/product-*.html   Claw产品落地页（25个）
├── /product/skill-*.html     Skills落地页（30个）
├── /category/news/            新闻分类
├── /category/guides/          新手指南分类
├── /category/mcp/            MCP生态分类
└── /usr/uploads/covers/       文章封面图
```

---

## 二、数据规模

| 数据 | 数量 | 文件 | 说明 |
|------|------|------|------|
| AI模型落地页 | 50 | `rankings.json` | 含ELO/价格/上下文 |
| Claw产品落地页 | 25 | `claw_rankings.json` | 含龙虾指数/开发商 |
| Skills落地页 | 30 | `skills_rankings.json` | 含周下载量/版本 |
| 产品详情页 | 149个 | `/product/` | 静态HTML |
| 文章 | 实时 | Typecho DB | 持续更新中 |

---

## 三、排行榜规范

### 3.1 URL结构（固定不变）

| 排行榜 | URL | 数量字段 |
|--------|-----|---------|
| Claw产品 | `/claw-rankings.html` | `count($clawData)` |
| AI模型 | `/model-rankings.html` | `count($models)` |
| Skills | `/skills-rankings.html` | `count($skillData)` |

### 3.2 跳转规则（固定不变）

- **整行点击** → `data-url` → 产品落地页 → **新窗口**打开
- **跳转按钮**（官网URL）→ `official_url` → 官网 → **新窗口**打开

### 3.3 data-url 内容（当前状态）

| 分类 | data-url 指向 | 例子 |
|------|--------------|------|
| AI模型 | `/product/model-{slug}.html` | `/product/model-claude-opus-46.html` |
| Claw产品 | `/product/product-{slug}.html` | `/product/product-openclaw.html` |
| Skills | `/product/skill-{slug}.html` | `/product/skill-wecom-openclaw-plugin.html` |

---

## 四、产品落地页规范（当前标准）

### 4.1 HTML标题格式
```
{产品名} - {一句话tagline} - 龙虾官网
例：Claude Opus 4.6 - 综合能力第一的旗舰AI模型 - 龙虾官网
```

### 4.2 Meta标签
```html
<title>{产品名} - {tagline} - 龙虾官网</title>
<meta name="description" content="{500字以上产品描述}">
<meta name="keywords" content="{产品名}，{产品名}官网">
```

### 4.3 页面结构
```
顶部导航栏：🦞龙虾官网（logo）
Hero区：徽章 + Logo emoji + 产品名 + tagline + 跳转官网按钮（新窗口）
正文：
  产品介绍（500字+）
  核心亮点（6个标签）
  详细参数（表格）
  立即使用（跳转官网按钮）
Footer：🦞 龙虾官网 · yitb.com
```

### 4.4 落地页生成脚本
```
/tmp/rebuild_all_pages.py（服务器）→ 输出 /tmp/all_pages_v2/*.html
部署：SCP到 /alidata/www/yitb/product/ + chown apache:apache
```

---

## 五、JSON数据字段规范

### 5.1 AI模型 (rankings.json)
```json
{
  "name": "Claude Opus 4.6",
  "slug": "model-claude-opus-46",
  "provider": "Anthropic",
  "elo": 1476,
  "tagline": "综合能力第一的旗舰AI模型",
  "input_price": "$3.5",
  "output_price": "$15",
  "context_window": 200000,
  "release_date": "2024-03",
  "category": "通用",
  "highlights": ["最强综合能力","200K上下文","顶级推理","优秀写作"],
  "logo": "🤖",
  "url": "https://yitb.com/product/model-claude-opus-46.html",
  "official_url": "https://www.anthropic.com/claude"
}
```

### 5.2 Claw产品 (claw_rankings.json)
```json
{
  "name": "OpenClaw",
  "slug": "product-openclaw",
  "provider": "OpenClaw",
  "tagline": "开源AI智能体开发平台",
  "category": "Claw产品",
  "lobster_score": 98,
  "highlights": ["开源免费","MCP支持","500+Skills","本地运行"],
  "logo": "🦞",
  "url": "https://yitb.com/product/product-openclaw.html",
  "official_url": "https://openclaw.ai"
}
```

### 5.3 Skills (skills_rankings.json)
```json
{
  "name": "@wecom/wecom-openclaw-plugin",
  "slug": "skill-wecom-openclaw-plugin",
  "tagline": "企业微信 OpenClaw 频道插件",
  "provider": "WeCom",
  "category": "communication",
  "highlights": ["企业微信","官方插件","消息同步"],
  "version": "1.0.0",
  "downloads": 12000,
  "url": "https://yitb.com/product/skill-wecom-openclaw-plugin.html",
  "official_url": "https://github.com/wecom/OpenClaw-plugin"
}
```

---

## 六、关键脚本清单

| 脚本 | 位置 | 用途 |
|------|------|------|
| `rebuild_all_pages.py` | `/tmp/`（服务器） | 重新生成全部149个落地页HTML |
| `yitb_content.py` | 本地 `tasks/T1/` | 新闻RSS→改写→封面→发布 |
| `yitb_maintenance.py` | 本地 `tasks/T1/` | 排行榜数据更新（含合并保护逻辑） |
| `generate_product_pages.py` | 本地 `tasks/T1/` | 旧版生成器（参考用） |

---

## 七、服务器关键路径

| 内容 | 路径 |
|------|------|
| 产品页目录 | `/alidata/www/yitb/product/` |
| 数据目录 | `/alidata/www/yitb/data/` |
| 封面图目录 | `/alidata/www/yitb/usr/uploads/covers/` |
| 主题模板 | `/alidata/www/yitb/usr/themes/yitb/` |
| 文档目录 | `/alidata/www/yitb/docs/` |
| PHP模板 | `page-models.php / page-claw.php / page-skills.php / index.php` |

---

## 八、首页动态数据（当前值）

```php
count($clawData)   // 读取claw_rankings.json products数量 → 50
count($models)     // 读取rankings.json models数量 → 50
count($skillData)  // 读取skills_rankings.json skills数量 → 50
```

---

## 九、封面图权限规范（当前配置）

封面SCP上传后必须执行：
```bash
chown apache:apache /alidata/www/yitb/usr/uploads/covers/{文件名}
```

---

## 十、当前排行榜跳转逻辑（PHP模板）

```php
// page-*.php 中：
<tr data-url="<?php echo htmlspecialchars($row['url'], ENT_QUOTES, 'UTF-8'); ?>">

// JavaScript（新窗口）：
if (url) window.open(url, "_blank", "noopener,noreferrer");
```

---

## 十一、快速还原指南

如需还原到此基线状态：

```bash
# 1. 恢复JSON数据
scp rankings.json root@39.104.13.44:/alidata/www/yitb/data/
scp claw_rankings.json root@39.104.13.44:/alidata/www/yitb/data/
scp skills_rankings.json root@39.104.13.44:/alidata/www/yitb/data/

# 2. 重新生成落地页
python3 rebuild_all_pages.py

# 3. 部署落地页
cp /tmp/all_pages_v2/*.html /alidata/www/yitb/product/
chown -R apache:apache /alidata/www/yitb/product/

# 4. 恢复PHP模板（如需）
scp page-*.php root@39.104.13.44:/alidata/www/yitb/usr/themes/yitb/
```

---

## 十二、快照文件清单

```
snapshots/v1-baseline-20260325/
├── T1_BASELINE.md              ← 本文件
├── T1_RUNBOOK.md               ← 运营规范文档
├── rankings.json               ← 50个AI模型数据
├── claw_rankings.json          ← 50个Claw产品数据
├── skills_rankings.json         ← 50个Skills数据
├── products_db.json            ← 完整产品数据库
├── rebuild_all_pages.py        ← 落地页生成脚本（服务器版）
├── yitb_content.py             ← 新闻内容脚本
├── yitb_maintenance.py         ← 维护脚本
├── page-models.php             ← AI模型排行榜模板
├── page-claw.php               ← Claw产品排行榜模板
├── page-skills.php             ← Skills排行榜模板
└── index.php                   ← 首页模板
```

---

*本文件为 T1 基线状态的唯一快照。未来任何升级均需与此对比，确保不破坏已有功能。*

---

## 十三、文件保护状态

服务器文件已设置 `chattr +i`（不可删除/修改属性）：
- `/alidata/www/yitb/data/rankings.json` → 已保护
- `/alidata/www/yitb/data/claw_rankings.json` → 已保护
- `/alidata/www/yitb/data/skills_rankings.json` → 已保护
- `/alidata/www/yitb/product/` → 已保护
- `page-*.php` → 已保护

更新流程：解锁(chattr -i) → 更新 → 重新加锁(chattr +i)
详细见：T1_RUNBOOK.md 第十节
