docs(ticket-management): §6 补一条实测坑 —— 批量改首行须保持空格-竖线-空格，否则闸门= 解析失败（断言 4 全线 FAIL）

2026-09-22 16:30:05 +08:00
parent 85ca328690
commit 47226f78be
1 changed files with 1 additions and 0 deletions
@@ -89,6 +89,7 @@ node bin/ticket.mjs rename 142 --repo xbc/xbc --domain=平台 [--gate=等口径]
 - **HTTP 分块解码**：`let d = ''; res.on('data', c => d += c)` 会把**跨块的多字节字符**打成 `U+FFFD`（中文标签名就被打坏过）⇒ 必须 `res.setEncoding('utf8')`，或用 `fetch` 的 `text()`。
 - **建单前必须查重**：按标题查，否则会重复建单。
 - **标签传 id**：`POST /issues` 的 `labels` 是**标签 id 数组**，不是名字。
+- **批量改首行时必须保持 ` | ` 形态**（空格 + 竖线 + 空格）：把 `域=…` 换成新值时若顺手吃掉它后面的空格，`闸门=` 会与 `域` 黏成一段 ⇒ **断言 4 全线 FAIL**（实测 14/14 中招，工具拦住了）。
 - **改标题与正文**：都是 `PATCH /repos/{owner}/{repo}/issues/{n}`。
 - **令牌 scope**：只读 `read:issue,read:repository` 建不了单（403，报错会写 required scope）；建 / 改需 `write:issue`；`GET /user` 另需 `read:user`。
 - **里程碑可能已被当「状态桶」用**（如「记录工单 / 领取工单 / 完结工单」）⇒ 不要再用它承载闸门，否则两套状态打架；用前先 `milestones` 看语义与 `due_on`。