INT-174 主路径合并后的 7 项审查边界（PR #162 第 1 轮）：

- BatchCloseInternalTx 把 state=open 写入 WHERE，事务内逐 id UPDATE 按
  RowsAffected 区分命中/未命中；只对命中行计成功并删推荐，未命中行逐条
  记入 failures（「该问题已在其他操作中被更新，已跳过关闭」）。
- 30s 整批截止移到 ListFiltered 成功之后创建，预算只管关闭阶段；parent
  仍是调用方 ctx，调用方取消照常生效。
- 在途 GitHub PATCH 与整批取消解耦：worker 在 PATCH 开始前判定整批取消
  （Acquire 成功不等于已调度），之后经 context.WithoutCancel + 单请求
  15s 上限继续走完并落库，缩小「远端已关、本地仍 open」窗口。
- 取消文案分两类：未开始=「请求已取消或超时，未继续关闭」；已发出但
  超时=「关闭结果未确认：GitHub 侧可能已关闭，请刷新查看」。前端识别
  ky TimeoutError 提示刷新确认，HTTPError 行为不变。
- upsertGitHubIssue 入口守卫 nil / GetID()==0，返回错误不 panic。
- 并发测试只断言并发度（started/release 通道确定性同步），删墙钟断言。
- UpdateIssue 识别 GitHub 限流（RateLimitError/AbuseRateLimitError/
  ErrorResponse 403/429 + rate limit/abuse detection 字样），统一限流
  文案，口径对齐 PR 域 pullRequestAccessHint。

验证：make lint / make test / pnpm api-types --check 全绿；BatchClose
子集 go test -race -count=15 通过；双实例无头端到端 + 真实并发 batch-close
API 响应证明未命中新文案。

@@ -197,0 +222,4 @@
+			// PATCH 自身超时/取消：远端可能已生效，结果未确认，与
+			// 「未开始」的取消区分开。
+			err = &batchClosePatchUnconfirmedError{err: err}
+		} else if isGitHubRateLimitError(err) {

@@ -51,0 +51,4 @@
+        // failures[].error 是服务端的分类文案（已跳过/结果未确认/限流/取消），
+        // 必须透传：首条原因直接进 toast，指引（刷新确认/稍后重试）随文案自带，
+        // 只报数量会让用户把部分成功当成整批失败再点一次（INT-185）。
+        const reason = result.failures[0]?.error;

@@ -51,0 +54,4 @@
+        //（刷新确认/稍后重试）随文案自带（INT-185）。
+        const reasons = [
+          ...new Set(result.failures.map((f) => f.error).filter(Boolean)),
+        ].slice(0, 3);

@@ -313,3 +424,4 @@
+
 func appendBatchCloseFailure(resp *BatchCloseDoneIssuesResponse, issue model.Issue, err error) {
 	resp.Failed++
 	if len(resp.Failures) >= batchCloseDoneMaxFailures {

@@ -54,0 +69,4 @@
+        const unlisted = result.failed - result.failures.length;
+        if (unlisted > 0) lines.push(`另有 ${unlisted} 条未列明细`);
+        toast.warning(`已关闭 ${result.succeeded} 个问题，${result.failed} 个失败`, {
+          description: lines.join("\n"),

@@ -132,2 +166,4 @@
+  if (error instanceof Error && error.name === "TimeoutError") {
+    return REQUEST_UNCONFIRMED_COPY;
   }
   return "批量关闭失败";

@@ -295,3 +392,3 @@
 	for res := range results {
 		if res.err != nil {
-			appendBatchCloseFailure(resp, res.issue, res.err)
+			appendBatchCloseFailure(resp, res.issue, classifyGitHubCloseFailure(res.err, &rateLimited))

@@ -70,0 +64,4 @@
+	closed := make([]string, 0, len(ids))
+	for _, id := range ids {
+		res := tx.Model(&model.Issue{}).
+			Where("id = ? AND source = ? AND state = ?", id, model.IssueSourceInternal, model.IssueStateOpen).

@@ -28,0 +41,4 @@
+  for (const f of result.failures) {
+    const label = f.error || "原因未说明";
+    const group = groups.get(label) ?? { count: 0 };
+    group.count += 1;

@@ -11484,3 +11484,3 @@
           items:
             $ref: '#/components/schemas/IssueBatchFailure'
-          description: 最多返回前 50 条失败明细
+          description: 按失败原因保留明细：通常最多前 50 条；达到上限后每类新文案各保留一条样例，总数可能略超 50

@@ -197,0 +224,4 @@
+	}
+	patchCtx, cancel := context.WithTimeout(context.WithoutCancel(batchCtx), batchCloseGitHubPatchTimeout)
+	defer cancel()
+	updated, err := client.UpdateIssue(patchCtx, issue.GitHubMeta.Number, updateReq)

@@ -70,0 +68,4 @@
+	closed := make([]string, 0, len(ids))
+	for _, id := range ids {
+		res := tx.Model(&model.Issue{}).
+			Where("id = ? AND source = ? AND state = ? AND id IN (SELECT issue_id FROM issue_internal_meta WHERE workflow_status = ?)",

@@ -70,0 +89,4 @@
+// IsOpenAndDone GitHub 批量关闭的行级守卫（INT-185 R7）：PATCH 前按 id 复核
+// 本地行仍为 state=open 且 meta.workflow_status=done——批量窗口内被拖回开发
+// 中的行不发 PATCH、按「已跳过关闭」计入 failures，避免远端/本地被误关。
+func (r *IssueRepository) IsOpenAndDone(id string) (bool, error) {

@@ -197,0 +227,4 @@
+	// 在事务 WHERE 里钉住同条件，GitHub 来源没有事务可依托，只能靠这里。
+	if guard != nil {
+		ok, gerr := guard(batchCtx, issue.ID)
+		if gerr != nil {

@@ -129,3 +173,4 @@
+export async function formatBatchCloseError(error: unknown): Promise<string> {
   if (error instanceof HTTPError) {
     const body = await error.response.json<ApiResponse<unknown>>().catch(() => null);
     if (body?.message) return body.message;

@@ -197,0 +235,4 @@
+				results <- githubCloseNetResult{issue: issue, err: batchCloseCancelErr(gerr, rateLimited)}
+				return
+			}
+			results <- githubCloseNetResult{issue: issue, err: errs.New(errs.ErrInternal.Code, "复核本地状态失败，未关闭该项")}

@@ -218,3 +334,4 @@
+		return s.recRepo.DeleteByIssueIDsTx(tx, closed)
 	})
 	if err != nil {
 		if !errors.Is(err, context.Canceled) && !errors.Is(err, context.DeadlineExceeded) {

@@ -323,0 +542,4 @@
+		return false
+	}
+	code := respErr.Response.StatusCode
+	if code != http.StatusForbidden && code != http.StatusTooManyRequests {

@@ -197,0 +265,4 @@
+	patchCtx, cancel := context.WithTimeout(context.WithoutCancel(batchCtx), batchCloseGitHubPatchTimeout)
+	defer cancel()
+	updated, err := client.UpdateIssue(patchCtx, issue.GitHubMeta.Number, updateReq)
+	if err != nil {

@@ -197,0 +247,4 @@
+				results <- githubCloseNetResult{issue: issue, err: batchCloseCancelErr(src, rateLimited)}
+				return
+			}
+			results <- githubCloseNetResult{issue: issue, err: errs.New(errs.ErrInternal.Code, "复核本地状态失败，未关闭该项")}