feat: add req/resp history endpoint, fix player_id dynamic binding, remove coordinate info from select_plots

app.py

@@ -1,10 +1,86 @@
 import os
 
 from agent_build_sdk.builder import AgentBuilder
+from agent_build_sdk.server.server import EndpointServer
 from chinatown.chinatown_agent import ChinatownLLMAgent
+from fastapi.responses import HTMLResponse
+import html as html_lib
+
+
+def register_debug_endpoints(server: EndpointServer):
+    agent = server.agent
+
+    @server.app.get("/debug/requests")
+    def get_requests():
+        history = agent.get_req_resp_history()
+        return {
+            "success": True,
+            "total": len(history),
+            "history": history,
+        }
+
+    @server.app.get("/debug/requests/view")
+    def view_requests():
+        history = agent.get_req_resp_history()
+        html_items = ""
+        for i, item in enumerate(reversed(history)):
+            req_data = item.get("req", {})
+            resp_data = item.get("resp", {})
+            req_type = item.get("type", "?")
+            status = req_data.get("status", "?")
+            round_num = req_data.get("round", "?")
+            action = resp_data.get("action", "-") if resp_data else "-"
+
+            html_items += f"""
+                    <div class='req-item'>
+                        <div class='header'>
+                            <span class='type'>{req_type}</span>
+                            <span class='meta'>{html_lib.escape(str(status))} | Round {html_lib.escape(str(round_num))} | Action: {html_lib.escape(str(action))}</span>
+                        </div>
+                        <details>
+                            <summary>Request</summary>
+                            <pre>{html_lib.escape(str(req_data))}</pre>
+                        </details>
+                        <details>
+                            <summary>Response</summary>
+                            <pre>{html_lib.escape(str(resp_data))}</pre>
+                        </details>
+                    </div>
+                    """
+
+        return HTMLResponse(content=f"""
+                <!DOCTYPE html>
+                <html>
+                <head>
+                    <meta charset='UTF-8'>
+                    <title>Request/Response History</title>
+                    <style>
+                        body {{ font-family: monospace; margin: 20px; background: #f5f5f5; }}
+                        .req-item {{ background: white; margin: 10px 0; padding: 15px; border-radius: 5px; }}
+                        .header {{ display: flex; justify-content: space-between; margin-bottom: 10px; }}
+                        .type {{ font-weight: bold; color: #333; }}
+                        .meta {{ color: #666; font-size: 0.9em; }}
+                        details {{ margin: 5px 0; }}
+                        summary {{ cursor: pointer; color: #0066cc; font-weight: bold; }}
+                        pre {{ background: #f0f0f0; padding: 10px; overflow-x: auto; white-space: pre-wrap; font-size: 0.85em; }}
+                    </style>
+                </head>
+                <body>
+                    <h2>Request/Response History ({len(history)} items)</h2>
+                    {html_items}
+                </body>
+                </html>
+                """)
+
+    @server.app.post("/debug/requests/clear")
+    def clear_requests():
+        agent.clear_req_resp_history()
+        return {"success": True, "message": "请求历史已清空"}
+
 
 if __name__ == '__main__':
     name = 'chinatown'
     agent = ChinatownLLMAgent(player_id="")
-    agent_builder = AgentBuilder(name, agent=agent)
-    agent_builder.start()
+    server = EndpointServer(agent)
+    register_debug_endpoints(server)
+    server.start()

chinatown/chinatown_agent.py

@@ -29,6 +29,7 @@ class ChinatownLLMAgent(ChinatownAgent):
         self.player_id = player_id
         self._board_stale: bool = False
         self._snapshot_version: int = 0
+        self._req_resp_history: list = []
 
     # ================================================================
     # Perceive: 接收感知事件, 更新记忆
@@ -38,6 +39,14 @@ class ChinatownLLMAgent(ChinatownAgent):
         status_val = req.status.value if hasattr(req.status, "value") else str(req.status)
         logger.info(f"[perceive] player={self.player_id}, status={status_val}, round={req.round}")
 
+        self._req_resp_history.append({
+            "type": "perceive",
+            "req": req.model_dump(),
+            "resp": None,
+        })
+        if len(self._req_resp_history) > 100:
+            self._req_resp_history = self._req_resp_history[-100:]
+
         # snapshot 非空代表地图有更新, 标记棋盘脏
         if req.snapshot:
             self._board_stale = True
@@ -106,10 +115,23 @@ class ChinatownLLMAgent(ChinatownAgent):
     }
 
     def interact(self, req: AgentReq) -> AgentResp:
-        """基于 LLM 生成交互决策"""
         status_val = req.status.value if hasattr(req.status, "value") else str(req.status)
         logger.info(f"[interact] player={self.player_id}, status={status_val}, round={req.round}")
 
+        resp = self._do_interact(req)
+
+        self._req_resp_history.append({
+            "type": "interact",
+            "req": req.model_dump(),
+            "resp": resp.model_dump(),
+        })
+        if len(self._req_resp_history) > 100:
+            self._req_resp_history = self._req_resp_history[-100:]
+
+        return resp
+
+    def _do_interact(self, req: AgentReq) -> AgentResp:
+
         # MAP_SYNC: 解析 snapshot 后返回 ACK
         if req.status == GamePhase.PHASE_MAP_SYNC:
             if req.snapshot:
@@ -138,3 +160,9 @@ class ChinatownLLMAgent(ChinatownAgent):
         except Exception as e:
             logger.error(f"[interact] EXCEPTION: {e}", exc_info=True)
             return AgentResp.failure(str(e))
+
+    def get_req_resp_history(self) -> list:
+        return self._req_resp_history
+
+    def clear_req_resp_history(self):
+        self._req_resp_history.clear()