docs: add the missing imports to the plan's key interfaces

Codex review: the code blocks reference httpx and PolyGatewayError, but
neither module imports them today. A zero-context implementer copying
them verbatim would stall on F821.

research-wiki/plans/2026-08-16-issue10-error-body-retention.md

@@ -26,6 +26,10 @@
 
 ```python
 # src/polygateway/transports/_http_errors.py
+from __future__ import annotations
+
+import httpx                      # response_body 的类型与 ResponseNotRead 都来自它
+
 _ERROR_BODY_CAP = 2048   # 字符(非字节),含省略标记在内的最终总长上限
 _HEAD_CHARS = 1400
 _TAIL_CHARS = 600
@@ -69,6 +73,18 @@ class PolyGatewayError(Exception):
 
 ```python
 # src/polygateway/transports/openai_compat.py
+# 既有 errors 导入(:18-23)须补入 PolyGatewayError —— 当前只导了四个子类,
+# 直接写 _classify 的返回注解会让 ruff 报 F821 未定义名。
+from polygateway.errors import (
+    PolyGatewayError,          # ← 新增
+    RequestRejectedError,
+    ResultInvalidError,
+    SourceDeadError,
+    TransientError,
+)
+from polygateway.transports._http_errors import compose_message, summarize_body
+
+
 def _classify(status: int) -> tuple[type[PolyGatewayError], str]:
     """状态码 → (错误类, message 标签);映射与 1.1.2 逐条相同。"""
     if status in (401, 403):
@@ -117,7 +133,7 @@ def _status_to_error(
 
 ### - [ ] Task 2: 共享摘要单元
 
-**新建**: `src/polygateway/transports/_http_errors.py`(按上文"关键接口"逐字实现,含中文模块/函数 docstring 解释**为什么**折叠空白、为什么头尾保留、为什么 `response_body` 必须降级)
+**新建**: `src/polygateway/transports/_http_errors.py`(按上文"关键接口"逐字实现,**含其中的 `import httpx`**,加中文模块/函数 docstring 解释**为什么**折叠空白、为什么头尾保留、为什么 `response_body` 必须降级)
 
 **新建测试**: `tests/unit/test_http_error_body.py`
 
@@ -155,6 +171,7 @@ resp = httpx.Response(400, stream=_Unread())   # 未 read → .text 抛 Response
 - `_translate_429` 签名改为 `(source, body_text, headers, ctx)`,两支 message 各自追加 `compose_message` 后缀,构造改用 `**ctx`;**`json.loads` 仍读原文 `body_text`**。
 - message 主体逐字保持 1.1.2 原样(`凭据失效/欠费: {status}` / `请求被拒: 400` / `瞬时错误: {status}` / `客户端错误: {status}` / `配额耗尽(insufficient_quota)` / `限速: 429`),只在末尾追加 ` | {摘要}`。
 - 三个调用点(`:402` embed、`:417` stream、`:509` 非流式)签名不变,**不改动**。
+- **补 import**:`PolyGatewayError`(errors)与 `compose_message` / `summarize_body`(`._http_errors`),见上文关键接口——漏补则 `make lint` 报 F821(Codex 审查 2026-08-16 提出)。
 - **不改** `operation` 硬编码 `"chat"`(设计 §5.4 有意留给独立 issue)。
 
 **测试**(`tests/unit/test_openai_compat.py`,沿用既有 `_transport_for(handler)` + `httpx.MockTransport`):