# 客户端交付（唯一正本目录）

生成：2026-07-16  
路径：`/www/wwwroot/客户端交付/`  
原则：**一类交付物一个固定名**；版本写内容/CF，不写文件名。

---

## 两类客户端（勿混）

| 类 | 固定名 | 用途 |
|----|--------|------|
| **程序代理** | `news.php` | 子站接程序 B；CF 拉 source/token |
| **内容口袋** | `client_hybrid_install.zip`（默认） | 模7绿壳 + 白底五页安装包 |
| **内容口袋·旧白** | `client_pocket_install.zip` | `?pack=white` |

---

## 本目录文件

| 文件 | 说明 |
|------|------|
| `news.php` | 程序代理正本 **1.4.0-cf** |
| `client_hybrid_install.zip` | 默认安装包 |
| `client_pocket_install.zip` | 白底口袋包 |
| `client_white_pack.zip` | 更早白底小包（备用） |
| `get_client.php` | 下载入口脚本 |
| `live/` | Live 预览 → `tiaozhuan/client` |
| `源码_news_正本` | 构建/部署源 |
| `源码_client_t7` | hybrid 构建源 |
| `【固定文件名约定】.md` | 全站固定名表 |

---

## 下载 / Live 地址

DNS 指到本机 `82.41.66.212` 后：

| 用途 | URL |
|------|-----|
| Live 预览 | https://yidingchenggong.cc/client/ |
| 下 hybrid（默认） | https://yidingchenggong.cc/get_client.php |
| 下 white | https://yidingchenggong.cc/get_client.php?pack=white |
| 单下 news.php | https://yidingchenggong.cc/get/client_news/news.php |
| 本目录镜像 | https://yidingchenggong.cc/get/客户端交付/ |
| CDN 镜像包 | https://sanshanyouya.com/pc-packs/client_hybrid_install.zip |

本机 Host 测：

```bash
curl -sI -H 'Host: yidingchenggong.cc' http://127.0.0.1/client/
curl -sI -H 'Host: yidingchenggong.cc' http://127.0.0.1/get_client.php
```

---

## 部署口径

### A. 接程序 B（news.php）

1. 把 **`news.php`** 放到站点运行目录（固定此名）
2. 伪静态：需要进程序的路径指到 `news.php`
3. 换主控/token：**只改 CF Worker**，不必重推所有站  
   - 主：`https://news-proxy-config.sanmao20261987.workers.dev/`  
   - 备：`https://config.daizuoguanggaotelegramidcaishentai.com/`  
   - 默认 source：`https://sanshanyouya.com/news_source.php`

### B. 内容口袋（hybrid）

1. 下 `client_hybrid_install.zip` → 解压得 `pocket/`
2. 访问 `/pocket/`；配置 `pocket/runtime/config.php` 的 `base` / `hub_url`
3. **不覆盖** 程序 B `templates/7`

### 重建 hybrid

```bash
php /www/wwwroot/tiaozhuan/seo_site_system/client_t7/build_white.php
php /www/wwwroot/tiaozhuan/seo_site_system/client_t7/build.php
php /www/wwwroot/tiaozhuan/seo_site_system/client_t7/build_hybrid.php
# 然后把新 zip 覆盖本目录同名文件，并同步 pc-packs / 给客户传
```

---

## 镜像与软链

- `yidingchenggong.cc/client` → 本目录 `live`
- `yidingchenggong.cc/get/客户端交付` → 本目录
- `tiaozhuan/get/客户端交付` → 本目录
- `tiaozhuan/get_client.php` / `yiding…/get_client.php` → 同逻辑脚本
- 散落旧 zip → `/www/wwwroot/old-backups/client_scatter_20260716/`

---

## 禁止

- 再在 wwwroot 根乱丢 `客户端.zip` / `client-pack-latest.zip`
- 给 news 起 `news_v2.php` / `news_new.php` 等临时名
- 把马包（`assets/cdn`）和内容口袋、news 代理三类混成一个 zip