# 联调后修改意见 · 宇恒松离线（形态 B）· 现行摘要

> 修订至 **2026-08-06**（Z28 智建已落实；**全文已归档**）  
> **归档全文（§1–§5.26 历史增量与验收）**：[docs/archive/联调后修改意见-宇恒松离线-2026-08-06.md](docs/archive/联调后修改意见-宇恒松离线-2026-08-06.md)  
> 焦点：**§0.2**；**改代码前须先写入本意见或归档续篇**（见 §0.0）  
> 来源：宇恒 `yuhengyihao_client` ↔ 智建（生产 `aisite.yuxindazhineng.com`）

---

## 0. 当前结论

| 级别 | 状态 | 说明 |
|------|------|------|
| **硬改（阻塞接口）** | **无** | 契约不变；剩生产 pull + 配号/Secret |
| **Z1–Z27** | **已落实 / 宇恒已改完** | 详见[归档](docs/archive/联调后修改意见-宇恒松离线-2026-08-06.md) §5 |
| **Z12h / 数据恢复** | **智建已落实** | 通道自愈；SyncPage「数据恢复」 |
| **Z28** | **双方已落实** | 绑定回传密钥；register 复用 active+sync_bound |
| **仍关注** | 运维 | 生产 `bash ./restart.sh --pull`；成员 `13531041944`；凭票 Secret；通道勿测表白名单 |

### 0.0 修改流程（冻结）

1. **先写意见**（本摘要 §0.2 或归档续篇 §5）→ 双方对齐。  
2. **再改代码**：宇恒只改 `yuhengyihao_client`；智建只改 `ai建站`；**互不代改**。  
3. 接口/产品有变 → 回写契约与验收；禁止口头改完再补意见。  
4. 一轮联调闭环后 → **归档**到 `docs/archive/`，本文件只保留现行摘要。

### 0.1 绑定产品冻结（Z13 · 试运行）

| 约定 | 内容 |
|------|------|
| 联调号 | **`13531041944`**（宇信达）；**禁止**超管 `13531041945`（验收样例，禁止写进产品默认值） |
| 换票 | 凭票 Secret + `YXD_HOST_KEY` + 手机；绑定成功用回传的 `client_id`/`client_secret` |
| 短信 | `RequireForBind=false`；`Provider: "off"`（**YAML 必须加引号**） |
| 同号 | 命中成员 → 必须弹窗；`confirm=true` 才绑 |
| 通道 | 默认同步通道 **默认运行中** |

### 0.2 待改清单（按负责方）

#### 开发 · 双方

| 方 | 状态 |
|----|------|
| 宇恒 | **无阻塞新开发**（Z10c–Z28 已改完，见归档） |
| 智建 | **无阻塞新开发**（Z12h / 数据恢复 / Z28 已合入） |

#### 智建 · 仅运维

| 优先级 | 项 |
|--------|----|
| **P0** | 生产 `bash ./restart.sh --pull`（含 Z28） |
| **P0** | 宇信达成员绑 **`13531041944`**；通道表白名单勿「填入测试默认」 |
| **P1** | `YuhengTicket.Secret` ≡ 宇恒；`DefaultRemoteDSN` 生产 Postgres |

### 0.3 开通 → 看到线上表（摘要）

```text
智建运维：pull → 绑 13531041944 → 启用智能体（通道运行中）→ 可选绑定码
宇恒：policy / redeem / phone-confirm / ticket-exchange（保存回传密钥）
     → 库选「同步」→ Binding + pull + ensure + drain
智建验收：查看线上表；误删通道自愈；误删数据「数据恢复」
```

---

## 1. 契约入口（勿破坏）

完整已验证契约与 API 表见归档 §1–§4。常用：

- `POST /api/v1/auth/bind-code/redeem`、`…/phone/confirm`、`…/yuheng/ticket-exchange` → 含 `client_id`/`client_secret`（Z28）  
- `POST /api/v1/auth/agent/register` → 已 sync_bound 则复用并轮换密钥  
- `GET/POST …/admin/sync/channels/{id}/checkpoint|restore` → 数据恢复  

---

## 6. 联系与附件

- **归档全文**：[docs/archive/联调后修改意见-宇恒松离线-2026-08-06.md](docs/archive/联调后修改意见-宇恒松离线-2026-08-06.md)  
- 方案：`松离线-dbsync方案-最终版.md`  
- 宇恒使用说明：`宇恒-松离线数据同步使用文档.md`  
- 开通说明：`docs/数据同步-开通说明.md`  
- **分工**：宇恒只改宇恒仓；智建只改智建仓；互不代改。