docs: Z35 意见强调宇恒勿改、生产须 pull(婷婷管理员库名 400)

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
whm
2026-08-07 01:56:47 +08:00
parent a80559d353
commit 7290f91d3a

View File

@@ -30,7 +30,7 @@
| **Z23 表单推送失败禁止空等** | **宇恒已改完;智建无需** | `ask_fields_via_chat` 推送失败立即抛错;进行中再选中会话给出提示;对齐 ty_host≥1.2.35§5.21 |
| **Z24 已绑定勿 force 清落点** | **宇恒已改完;智建无需** | 启动自动引导绑定时禁止 `force_rebind` 清 CHANNEL仅用户点「换绑」才清§5.22 |
| **Z34 / Z34b 换机恢复** | **宇恒半程 + 智建已落实** | 有手机静默恢复Z34无手机 `POST …/restore-by-host`Z34b · §5.32 |
| **Z35 库名非法中文** | **智建已改完** | 绑定 DisplayName 不再作 PG 库名publish 纠正脏数据§5.33 |
| **Z35 库名非法中文** | **智建 · 意见已写清 · 生产须 pull** | DisplayName PG 库名 → 400「婷婷管理员」§5.33**宇恒勿改** |
| **仍关注** | 用法 | 通道断了靠智建自愈;表数据靠宇恒双向指纹 / 数据恢复;不是「再点启动」 |
### 0.0 修改流程(冻结)
@@ -1086,25 +1086,41 @@ POST /api/v1/agent/sync/channels/{id}/pull
### 5.33 【Z35 · 2026-08-07】绑定勿用中文 DisplayName 作 Postgres 库名
**状态****智建已改完;宇恒无需**(报错来自平台 publish EnsureDatabase
**状态****智建负责(须生产 pull· 宇恒勿改代码**。
联调复现仍指向生产 `aisite…``HTTP 400: ensure database: invalid database name: 婷婷管理员` —— **在生产未 pull 前会继续报错**,不是宇恒终端问题。
#### 现象
模块发布 `HTTP 400: ensure database: invalid database name: 婷婷管理员`
模块发布 / 新建模块失败:
`HTTP 400: ensure database: invalid database name: 婷婷管理员`
`婷婷管理员` 为智建成员 DisplayName / 昵称。)
#### 根因
`bindUserHostSync` 把成员 `DisplayName` 写入智能体 `database_name`publish Z8c 用该字段 `CREATE DATABASE`,而物理库名须匹配 `^[a-z][a-z0-9_]{1,47}$`
1. 绑定路径 `bindUserHostSync` 把成员 **DisplayName(可中文)** 写入智能体 `database_name`
2. 发布 Z8c智能体带 `database_name` 时走 `database_per_app``EnsureDatabase` → Postgres `CREATE DATABASE`
3. 物理库名校验:`^[a-z][a-z0-9_]{1,47}$` —— 中文昵称非法 → 400。
#### 智建改
#### 分工(冻结)
1. 绑定:`DatabaseName=user_{userID}``Binding.DisplayName` 仍用昵称。
2. publish仅当 `ValidDBName` 才采用智能体库名;非法则 `SanitizeDBName` 并回写纠正。
3. 已存在非法 `existing.DatabaseName` 不再沿用。
| 方 | 做什么 | 不做什么 |
|----|--------|----------|
| **智建** | 改绑定落点库名规则 + publish 遇非法名纠正;**生产 `bash ./restart.sh --pull`** | — |
| **宇恒** | **不改**;意见对齐与复测 | 不在终端侧绕过/改写智建 `database_name` |
#### 智建改法(意见约定 · 实现要点)
1. **绑定**`Agents.DatabaseName` / Binding 物理名用 `user_{userID}`(或同等合法 ASCII`Binding.DisplayName` 仍用昵称「婷婷管理员」。
2. **publish**:仅当 `ValidDBName(acc.DatabaseName)` 才用于 Ensure否则回落 `AssignDatabaseName` / `SanitizeDBName`,并**回写纠正**智能体脏 `database_name`,避免反复 400。
3. 已存在 app 的非法 `existing.DatabaseName` **不得**继续沿用。
#### 验收
昵称含中文的账号发布模块 → 2xx智能体 `database_name` 为合法英文/数字下划线。
1. 生产 pull 后,昵称含中文的已绑账号 → 新建/发布模块 **不再** 400。
2. 智能体 `database_name` 为合法 `a-z0-9_`;控制台展示名仍可为中文。
3. 宇恒侧无需发版即可复测通过。
## 6. 联系与附件