docs: 为全部代码补充中文注释并加入 AGENTS 注释规范

tests/fixtures/bad_node.py

@@ -1,3 +1,8 @@
+"""失败健康检查节点夹具。
+
+打印就绪端口但 /health 返回 500，用于验证 NodeManager 的启动失败处理。
+"""
+
 import http.server
 import threading
 
@@ -12,6 +17,8 @@ class Handler(http.server.BaseHTTPRequestHandler):
 
 
 server = http.server.ThreadingHTTPServer(("127.0.0.1", 0), Handler)
+# 打印就绪行让 NodeManager 认为进程已启动。
 print(f"WOV_NODE_READY port={server.server_address[1]}", flush=True)
 threading.Thread(target=server.serve_forever, daemon=True).start()
+# 主线程挂起，保持服务进程存活。
 threading.Event().wait()

tests/fixtures/bad_ready_node.py

@@ -1,3 +1,8 @@
+"""错误就绪输出节点夹具。
+
+打印不带端口的 WOV_NODE_READY 行，用于验证 NodeManager 对格式异常的处理。
+"""
+
 import time
 
 print("WOV_NODE_READY", flush=True)

tests/fixtures/bad_status_node.py

@@ -1,3 +1,8 @@
+"""异常状态码健康检查节点夹具。
+
+/health 返回 201，用于验证 NodeManager 只接受 200 状态码。
+"""
+
 import http.server
 import threading
 

tests/fixtures/failing_node.py

@@ -1,3 +1,9 @@
+"""失败调用节点夹具。
+
+健康检查成功但 /invoke 始终返回 500，支持通过 WOV_FAIL_INVALID_JSON 环境变量
+切换为非法 JSON，用于验证 NodeManager 的错误响应解析分支。
+"""
+
 import http.server
 import json
 import os
@@ -19,6 +25,7 @@ class Handler(http.server.BaseHTTPRequestHandler):
         if os.environ.get("WOV_FAIL_INVALID_JSON") == "1":
             body = b"not-json"
         else:
+            # 默认返回协议格式的失败 JSON，验证错误信息透传。
             body = json.dumps({"status": "failed", "error": "boom"}).encode("utf-8")
         self.send_header("Content-Length", str(len(body)))
         self.end_headers()

tests/fixtures/stderr_node.py

@@ -1,3 +1,8 @@
+"""stderr 捕获节点夹具。
+
+启动时向标准错误输出一行警告，用于验证 NodeManager 的 stderr_tail 缓存。
+"""
+
 import http.server
 import sys
 import threading