feat: complete T-530 cmhub URL normalization

docs/troubleshooting.md

@@ -144,7 +144,7 @@ python -c "import json; from urllib.parse import urlsplit,urlunsplit; p='config/
 
 先明确：**cmshopee 的请求本身是达标的**——`GET {Base URL}/api/v1/models`，头 `Authorization: Bearer <key>`，与对接文档《cmhub-接口对接文档-桌面端生文生图》§4.4 和 cmhub 服务端路由 `path("v1/models", ModelsView)` 完全一致。404 表示服务端已响应但该路径不存在，原因在请求之外，通常是两类：
 
-1. **Base URL 填了多余路径（手动填入最常见）**：Base URL 只能填**网关根**，例如 `https://cmhub.example.com`。当前 `appconfig.cmhub_request_url()` 是 `base_url.rstrip("/") + "/api/v1/models"`，**不会**替你去掉结尾的 `/api` 或 `/api/v1`；若你填成 `https://host/api/v1`，会拼成 `.../api/v1/api/v1/models` → 404。
+1. **Base URL 填了多余路径（手动填入最常见）**：Base URL 只能填**网关根**，例如 `https://cmhub.example.com`。T-530 后程序会在保存和请求前规整 Base URL，填成 `https://host/api/v1` 也会按 `https://host` 拼出 `https://host/api/v1/models`；仍建议只填网关根，便于人工排查。
 2. **连的那台 cmhub 实例没有该路由**：`ModelsView` 在 cmhub 仓库代码里有，但**运行中的实例**若未重新部署/重启，`/api/v1/models`（较新接口）会 404，而 `/api/v1/balance`（较老接口）可能正常。
 
 ### 隔离方法（一条 curl 定位）
@@ -160,9 +160,9 @@ curl -i "https://<你的BaseURL>/api/v1/balance" -H "Authorization: Bearer sk_cm
 
 > 不要把 API Key 贴进日志、文档或聊天；curl 里的 `sk_cmhub_xxx` 是占位。
 
-### 待改进（T-530）
+### 当前处理（T-530 后）
 
-`cmhub_request_url()` 目前不规整带 `/api`/`/api/v1` 的 Base URL，且 404 落到 `unknown` 后透传生涩英文原文。跟进任务 T-530 将：保存/请求前规整 Base URL 去掉多余 `/api(/v1)` 尾部；给 404 一个明确中文提示（“cmhub 接口不存在，检查 Base URL 或该实例是否已部署 /api/v1/models”）。
+T-530 已实现：保存和请求前都会把 Base URL 规整为网关根，去掉多余路径、查询串和片段；HTTP 404 会映射为 `not_found`，显示“cmhub 接口不存在，请检查 Base URL 或该实例是否已部署 /api/v1/models”，不再透传 `notfound` 这类生涩原文。
 
 ## AI生成：标题成功但图片生成失败，且看不到原因