feat: 增強環境感知與導航功能

- 新增精確地理位置資訊（門牌號、路口、郵遞區號）
- 優化 reverse_geocode 工具，提取完整地址組件
- 新增 forward_geocode 工具，支援地點名稱查詢
- 增強意圖檢測，自動處理導航需求
- 優化環境上下文格式化，顯示詳細位置資訊
- 修復 directions 工具錯誤處理
- 提升前端地理位置精度設定
- 優化 voice-transcript-wrapper 樣式，縮小寬度並改善視覺效果
- 新增測試腳本驗證功能

app.py

@@ -885,12 +885,60 @@ async def websocket_endpoint_with_jwt(websocket: WebSocket, token: str = Query(N
                                     geo_res = await reverse_tool.handler({"lat": lat, "lon": lon})
                                     if isinstance(geo_res, dict) and geo_res.get("success"):
                                         payload = geo_res.get("data") or geo_res
+                                        # 取得所有詳細欄位
                                         city = payload.get("city") or city
                                         admin = payload.get("admin") or admin
                                         country_code = payload.get("country_code") or country_code
                                         address_display = payload.get("label") or payload.get("display_name") or address_display
+                                        
+                                        # 新增：精確地址資訊
+                                        detailed_address = payload.get("detailed_address")
+                                        label = payload.get("label")
+                                        road = payload.get("road")
+                                        house_number = payload.get("house_number")
+                                        suburb = payload.get("suburb")
+                                        city_district = payload.get("city_district")
+                                        postcode = payload.get("postcode")
+                                        amenity = payload.get("amenity")
+                                        shop = payload.get("shop")
+                                        building = payload.get("building")
+                                        office = payload.get("office")
+                                        leisure = payload.get("leisure")
+                                        tourism = payload.get("tourism")
+                                        name = payload.get("name")
                             except Exception as ge:
                                 logger.debug(f"反地理查詢失敗: {ge}")
+                                # 如果 reverse_geocode 失敗，保持原有變數為 None
+                                detailed_address = None
+                                label = None
+                                road = None
+                                house_number = None
+                                suburb = None
+                                city_district = None
+                                postcode = None
+                                amenity = None
+                                shop = None
+                                building = None
+                                office = None
+                                leisure = None
+                                tourism = None
+                                name = None
+                        else:
+                            # 如果沒有執行 reverse_geocode，初始化為 None
+                            detailed_address = None
+                            label = None
+                            road = None
+                            house_number = None
+                            suburb = None
+                            city_district = None
+                            postcode = None
+                            amenity = None
+                            shop = None
+                            building = None
+                            office = None
+                            leisure = None
+                            tourism = None
+                            name = None
 
                         env_payload = {
                             "lat": lat,
@@ -906,6 +954,21 @@ async def websocket_endpoint_with_jwt(websocket: WebSocket, token: str = Query(N
                             "admin": admin,
                             "country_code": country_code,
                             "address_display": address_display,
+                            # 新增：精確地址欄位
+                            "detailed_address": detailed_address,
+                            "label": label,
+                            "road": road,
+                            "house_number": house_number,
+                            "suburb": suburb,
+                            "city_district": city_district,
+                            "postcode": postcode,
+                            "amenity": amenity,
+                            "shop": shop,
+                            "building": building,
+                            "office": office,
+                            "leisure": leisure,
+                            "tourism": tourism,
+                            "name": name,
                         }
 
                         # 更新會話暫存

features/mcp/agent_bridge.py

@@ -275,6 +275,74 @@ class MCPAgentBridge:
 
         return polite_message, sanitized_tool_data
 
+    @staticmethod
+    def _haversine_km(lat1: Optional[float], lon1: Optional[float], lat2: Optional[float], lon2: Optional[float]) -> Optional[float]:
+        """計算兩點之間的近似球面距離（公里）。"""
+        try:
+            from math import radians, sin, cos, sqrt, atan2
+
+            if None in (lat1, lon1, lat2, lon2):
+                return None
+
+            rlat1, rlon1, rlat2, rlon2 = map(radians, [lat1, lon1, lat2, lon2])
+            dlat = rlat2 - rlat1
+            dlon = rlon2 - rlon1
+            a = sin(dlat / 2) ** 2 + cos(rlat1) * cos(rlat2) * sin(dlon / 2) ** 2
+            c = 2 * atan2(sqrt(a), sqrt(1 - a))
+            earth_radius_km = 6371.0
+            return earth_radius_km * c
+        except Exception:
+            return None
+
+    def _build_directions_failure_response(
+        self,
+        arguments: Dict[str, Any],
+        labels: Dict[str, str],
+        error_message: str,
+    ) -> Dict[str, Any]:
+        """建立 directions 工具失敗時的替代回傳內容。"""
+        origin_label = labels.get("origin_label") or arguments.get("origin_label") or "起點"
+        dest_label = labels.get("dest_label") or arguments.get("dest_label") or "目的地"
+
+        o_lat = arguments.get("origin_lat")
+        o_lon = arguments.get("origin_lon")
+        d_lat = arguments.get("dest_lat")
+        d_lon = arguments.get("dest_lon")
+
+        distance_km = self._haversine_km(o_lat, o_lon, d_lat, d_lon)
+        distance_m = distance_km * 1000 if distance_km is not None else None
+        distance_str = self._format_distance(distance_m)
+
+        # 推估行駛時間：假設平均速率 35km/h
+        duration_seconds = None
+        if distance_km is not None:
+            duration_minutes = max(5, int(round((distance_km / 35) * 60)))
+            duration_seconds = duration_minutes * 60
+
+        duration_str = self._format_duration(duration_seconds)
+
+        message = (
+            f"目前無法向路線服務取得詳細路線，但從 {origin_label} 前往 {dest_label} 直線距離約 {distance_str}，"
+            f"若以車輛移動約需 {duration_str}。建議在 Google 地圖或 Apple 地圖輸入上述地點，以獲得即時的轉乘與路況。"
+        )
+
+        fallback_payload = {
+            "fallback": True,
+            "origin_label": origin_label,
+            "dest_label": dest_label,
+            "distance_estimated_m": distance_m,
+            "distance_readable": distance_str,
+            "duration_estimated_s": duration_seconds,
+            "duration_readable": duration_str,
+            "error": error_message,
+        }
+
+        return {
+            "message": message,
+            "tool_name": "directions",
+            "tool_data": fallback_payload,
+        }
+
     def get_current_time_data(self) -> Dict[str, Any]:
         """
         獲取當前時間數據，用於生成個性化歡迎詞
@@ -393,6 +461,21 @@ class MCPAgentBridge:
   * 參數：query（關鍵詞）、country（國家，預設 tw）、category（分類，預設 top）、language（語言，預設 zh）
   * 今日新聞、科技新聞、台灣新聞都應該調用此工具
 
+- 地點查詢與導航（重要！）：
+  * **導航需求判斷**：
+    - 問「怎麼去 X」「如何去 X」「去 X 怎麼走」「到 X 怎麼走」→ 使用 forward_geocode 查詢目的地座標
+    - 問「從 A 到 B 要多久」「A 到 B 怎麼走」→ 同時使用 forward_geocode 查詢起點與終點
+  * **不要猜測座標**：
+    - ❌ 錯誤：directions:origin_lat=25.1288,origin_lon=121.9234,dest_lat=24.9932,dest_lon=121.3261
+    - ✅ 正確：forward_geocode:query=銘傳大學桃園校區
+  * **工具使用順序**：
+    1. 先使用 forward_geocode 將地點名稱轉換為座標
+    2. 再使用 directions 規劃路線（系統會自動處理）
+  * **範例**：
+    - 「怎麼去桃園火車站」→ forward_geocode:query=桃園火車站
+    - 「從銘傳大學到桃園火車站」→ forward_geocode:query=銘傳大學桃園校區
+    - 「台北車站到淡水捷運站」→ forward_geocode:query=台北車站
+
 情緒判斷（emotion）：
 根據文字的語氣、用詞、標點符號判斷用戶情緒，選擇以下之一：
 - neutral: 平靜、中性（預設）
@@ -722,8 +805,8 @@ class MCPAgentBridge:
     async def _call_mcp_tool(self, tool_name: str, arguments: Dict[str, Any],
                            user_id: str = None, original_message: str = "") -> str:
         """
-        調用 MCP 工具（帶智慧重試機制 + 統一格式化）
-        2025年最佳實踐：指數退避重試 + 錯誤分類 + AI 格式化
+        調用 MCP 工具（帶智慧重試機制 + 統一格式化 + 智能地點查詢）
+        2025年最佳實踐：指數退避重試 + 錯誤分類 + AI 格式化 + 自動 geocoding
         """
         if tool_name not in self.mcp_server.tools:
             return self._generate_tool_not_found_error(tool_name)
@@ -732,6 +815,69 @@ class MCPAgentBridge:
         if not tool.handler:
             return f"⚠️ 工具 {tool_name} 尚未實作，請稍後再試"
 
+        # 智能地點查詢：如果是 forward_geocode，且用戶有位置導航需求，自動串接 directions
+        is_navigation_intent = False
+        geocode_result = None
+        
+        if tool_name == "forward_geocode":
+            # 判斷是否為導航意圖（「怎麼去」「如何去」「到 X」）
+            nav_keywords = ["怎麼去", "如何去", "怎麼走", "到哪", "去哪", "要多久", "多遠"]
+            is_navigation_intent = any(keyword in original_message for keyword in nav_keywords)
+            
+            if is_navigation_intent:
+                logger.info(f"🗺️ 檢測到導航意圖，先執行地點查詢: {arguments.get('query')}")
+                
+                # 執行 geocoding
+                geocode_tool = self.mcp_server.tools.get("forward_geocode")
+                if geocode_tool and geocode_tool.handler:
+                    try:
+                        geocode_result = await asyncio.wait_for(
+                            geocode_tool.handler(arguments),
+                            timeout=15.0
+                        )
+                        
+                        if geocode_result.get("success"):
+                            best_match = geocode_result.get("data", {}).get("best_match", {})
+                            dest_lat = best_match.get("lat")
+                            dest_lon = best_match.get("lon")
+                            dest_label = best_match.get("label", arguments.get("query"))
+                            
+                            # 取得用戶當前位置
+                            env_ctx = await self._fetch_env_context(user_id)
+                            origin_lat = env_ctx.get("lat")
+                            origin_lon = env_ctx.get("lon")
+                            origin_label = env_ctx.get("label") or env_ctx.get("address_display") or "您的位置"
+                            
+                            if origin_lat and origin_lon and dest_lat and dest_lon:
+                                logger.info(f"🚗 自動串接導航: {origin_label} → {dest_label}")
+                                
+                                # 自動調用 directions
+                                directions_tool = self.mcp_server.tools.get("directions")
+                                if directions_tool and directions_tool.handler:
+                                    directions_args = {
+                                        "origin_lat": float(origin_lat),
+                                        "origin_lon": float(origin_lon),
+                                        "dest_lat": float(dest_lat),
+                                        "dest_lon": float(dest_lon),
+                                        "origin_label": origin_label,
+                                        "dest_label": dest_label,
+                                        "mode": "foot-walking"  # 預設步行
+                                    }
+                                    
+                                    # 遞迴調用 directions（會走下面的正常流程）
+                                    return await self._call_mcp_tool(
+                                        "directions",
+                                        directions_args,
+                                        user_id,
+                                        original_message
+                                    )
+                            else:
+                                logger.warning("⚠️ 無法取得完整位置資訊，返回地點查詢結果")
+                        else:
+                            logger.warning(f"⚠️ 地點查詢失敗: {geocode_result.get('error')}")
+                    except Exception as e:
+                        logger.error(f"❌ 自動地點查詢失敗: {e}", exc_info=True)
+
         arguments = await self._enrich_arguments_with_env(tool_name, arguments, user_id)
         route_labels: Dict[str, str] = {}
         if tool_name == "directions":
@@ -861,7 +1007,12 @@ class MCPAgentBridge:
             except Exception as e:
                 error_msg = str(e)
                 error_lower = error_msg.lower()
-                
+
+                if tool_name == "directions":
+                    logger.error(f"❌ directions 工具失敗，啟用替代回覆: {error_msg}")
+                    fallback_result = self._build_directions_failure_response(arguments, route_labels, error_msg)
+                    return fallback_result
+
                 # 判斷是否值得重試
                 is_retryable = any(keyword in error_lower for keyword in ["timeout", "network", "connection"])
                 

features/mcp/tools/directions_tool.py

@@ -161,22 +161,65 @@ class DirectionsTool(MCPTool):
         async with aiohttp.ClientSession() as session:
             async with session.post(url, headers=headers, data=json.dumps(body), timeout=15) as resp:
                 if resp.status != 200:
-                    raise ExecutionError(f"ORS 失敗: HTTP {resp.status}")
+                    text = await resp.text()
+                    raise ExecutionError(f"OpenRouteService HTTP {resp.status}: {text[:200]}")
                 data = await resp.json()
 
         try:
+            # 檢查 API 回應是否包含錯誤訊息
+            if not isinstance(data, dict):
+                raise ExecutionError(f"OpenRouteService 回應格式錯誤: 非字典類型")
+            
+            # 優先處理 error 欄位（API 標準錯誤格式）
+            if "error" in data:
+                error_payload = data["error"]
+                if isinstance(error_payload, dict):
+                    code = error_payload.get("code", "unknown")
+                    message = error_payload.get("message", "未知錯誤")
+                    raise ExecutionError(f"路線規劃失敗: {message} (錯誤碼: {code})")
+                else:
+                    raise ExecutionError(f"路線規劃失敗: {error_payload}")
+            
+            # 檢查是否有 features（標準成功格式）
+            if "features" not in data or not data["features"]:
+                # 提供友善的錯誤訊息
+                if o_lat == d_lat and o_lon == d_lon:
+                    raise ExecutionError("起點與終點相同，無需導航")
+                else:
+                    raise ExecutionError("找不到可行的路線，請確認起點與終點是否在可達範圍內")
+
             feat = data["features"][0]
+            
+            # 檢查必要欄位
+            if "properties" not in feat or "summary" not in feat["properties"]:
+                raise ExecutionError("路線資料缺少必要欄位（summary）")
+            
+            if "geometry" not in feat or "coordinates" not in feat["geometry"]:
+                raise ExecutionError("路線資料缺少必要欄位（geometry）")
+            
             summary = feat["properties"]["summary"]
             distance_m = float(summary["distance"])  # meters
             duration_s = float(summary["duration"])  # seconds
             polyline = feat["geometry"]["coordinates"]  # LineString 座標
+            
             base_payload = {
                 "distance_m": distance_m,
                 "duration_s": duration_s,
                 "polyline": json.dumps(polyline),
             }
+        except ExecutionError:
+            # 重新拋出已知錯誤
+            raise
+        except KeyError as e:
+            # 捕捉欄位缺失錯誤，提供更友善的訊息
+            raise ExecutionError(f"路線資料格式錯誤: 缺少欄位 {e}")
+        except (ValueError, TypeError) as e:
+            # 捕捉資料型別轉換錯誤
+            raise ExecutionError(f"路線資料解析失敗: {e}")
         except Exception as e:
-            raise ExecutionError(f"解析 ORS 回應失敗: {e}")
+            # 捕捉所有其他未預期錯誤
+            logger.error(f"❌ ORS 回應解析異常: {e}", exc_info=True)
+            raise ExecutionError(f"路線資料處理失敗: {type(e).__name__}: {e}")
 
         # 回寫快取
         await db_cache.set_route_cache(key, base_payload)

features/mcp/tools/geocode_tool.py

@@ -76,8 +76,10 @@ class ReverseGeocodeTool(MCPTool):
             "format": "jsonv2",
             "lat": lat,
             "lon": lon,
-            "zoom": 10,
-            "addressdetails": 1
+            "zoom": 18,  # 提高 zoom 等級（18 = 建築物級別，可取得門牌號）
+            "addressdetails": 1,
+            "extratags": 1,  # 取得額外標籤（商店名稱、建築物類型等）
+            "namedetails": 1  # 取得多語言名稱
         }
         headers = {
             "User-Agent": "BloomWare/1.0 (contact@example.com)"
@@ -88,35 +90,109 @@ class ReverseGeocodeTool(MCPTool):
                 if resp.status != 200:
                     raise ExecutionError(f"Nominatim 失敗: {resp.status}")
                 data = await resp.json()
+                
                 addr = data.get("address", {})
-                city = addr.get("city") or addr.get("town") or addr.get("village") or addr.get("county")
+                extratags = data.get("extratags", {})
+                
+                # 基本地址組件
+                road = addr.get("road") or addr.get("pedestrian") or addr.get("footway") or addr.get("cycleway") or ""
+                house_number = addr.get("house_number") or ""
+                suburb = addr.get("suburb") or addr.get("neighbourhood") or addr.get("quarter") or ""
+                city_district = addr.get("city_district") or ""
+                city = addr.get("city") or addr.get("town") or addr.get("village") or addr.get("county") or ""
                 admin = addr.get("state") or addr.get("county") or ""
                 country_code = (addr.get("country_code") or "").upper()
+                postcode = addr.get("postcode") or ""
+                
+                # POI 資訊（商店、建築物、設施等）
+                amenity = addr.get("amenity") or extratags.get("amenity") or ""
+                shop = addr.get("shop") or extratags.get("shop") or ""
+                building = addr.get("building") or extratags.get("building") or ""
+                office = addr.get("office") or extratags.get("office") or ""
+                leisure = addr.get("leisure") or extratags.get("leisure") or ""
+                tourism = addr.get("tourism") or extratags.get("tourism") or ""
+                
+                # 地點名稱（優先使用繁中）
+                name = data.get("name") or ""
+                namedetails = data.get("namedetails", {})
+                name_zh = namedetails.get("name:zh") or namedetails.get("name:zh-TW") or name
+                
                 display_name = data.get("display_name") or ""
-                road = addr.get("road") or addr.get("pedestrian") or addr.get("footway") or ""
-                house_number = addr.get("house_number") or ""
-                suburb = addr.get("suburb") or addr.get("neighbourhood") or ""
+                
+                # 組裝精確標籤（優先顯示最精確的資訊）
                 label_parts = []
+                
+                # 1. POI 名稱（如「7-11 明倫門市」「台北101」）
+                if name_zh and name_zh != road:
+                    label_parts.append(name_zh)
+                
+                # 2. 門牌號碼 + 路名（如「中正路123號」）
                 if road and house_number:
-                    label_parts.append(f"{road}{house_number}")
+                    label_parts.append(f"{road}{house_number}號")
                 elif road:
-                    label_parts.append(road)
-                if suburb:
+                    # 如果沒有門牌，但有路口資訊
+                    if "路口" in road or "交叉口" in road or "intersection" in road.lower():
+                        label_parts.append(road)
+                    else:
+                        # 嘗試從附近找路口
+                        label_parts.append(road)
+                
+                # 3. 郵遞區號（如「100」）
+                if postcode and len(label_parts) > 0:
+                    label_parts[0] = f"〒{postcode} {label_parts[0]}"
+                
+                # 4. 區域（如「大安區」）
+                if city_district and city_district not in label_parts:
+                    label_parts.append(city_district)
+                elif suburb and suburb not in label_parts:
                     label_parts.append(suburb)
-                if city:
+                
+                # 5. 城市（如「台北市」）
+                if city and city not in label_parts:
                     label_parts.append(city)
-                if admin:
+                
+                # 6. 省份/州（如「台灣」）
+                if admin and admin not in city and admin not in label_parts:
                     label_parts.append(admin)
-                label = ", ".join(label_parts)
+                
+                label = ", ".join(filter(None, label_parts))
+                
+                # 組裝詳細地址（用於 AI 顯示）
+                detailed_address_parts = []
+                if name_zh:
+                    detailed_address_parts.append(f"地點: {name_zh}")
+                if road and house_number:
+                    detailed_address_parts.append(f"地址: {road}{house_number}號")
+                elif road:
+                    detailed_address_parts.append(f"路段: {road}")
+                if suburb:
+                    detailed_address_parts.append(f"區域: {suburb}")
+                if city:
+                    detailed_address_parts.append(f"城市: {city}")
+                if postcode:
+                    detailed_address_parts.append(f"郵遞區號: {postcode}")
+                
+                detailed_address = " | ".join(detailed_address_parts) if detailed_address_parts else label
+                
                 payload = {
                     "city": city or "",
                     "admin": admin or "",
                     "country_code": country_code,
                     "display_name": display_name,
                     "label": label or display_name,
+                    "detailed_address": detailed_address,
                     "road": road,
                     "house_number": house_number,
                     "suburb": suburb,
+                    "city_district": city_district,
+                    "postcode": postcode,
+                    "amenity": amenity,
+                    "shop": shop,
+                    "building": building,
+                    "office": office,
+                    "leisure": leisure,
+                    "tourism": tourism,
+                    "name": name_zh or name,
                 }
 
         # 回寫快取

features/mcp/tools/geocoding_tool.py

@@ -0,0 +1,245 @@
+"""
+地點名稱轉座標工具（Forward Geocoding）
+使用 Nominatim（OSM）將地點名稱轉換為經緯度座標
+"""
+
+import aiohttp
+import asyncio
+import logging
+from typing import Dict, Any, List
+
+from .base_tool import MCPTool, StandardToolSchemas, ExecutionError
+from core.database import get_geo_cache, set_geo_cache
+from core.database.cache import db_cache
+
+logger = logging.getLogger("mcp.tools.geocoding")
+
+
+class ForwardGeocodeTool(MCPTool):
+    NAME = "forward_geocode"
+    DESCRIPTION = "將地點名稱（如「銘傳大學」「桃園火車站」）轉換為經緯度座標"
+    CATEGORY = "地理"
+    TAGS = ["geocode", "forward", "地點", "座標"]
+    USAGE_TIPS = [
+        "提供地點名稱即可（如「台北101」「淡水捷運站」）",
+        "支援地標、車站、學校、商圈等",
+        "會返回最相關的座標與詳細地址"
+    ]
+
+    @classmethod
+    def get_input_schema(cls) -> Dict[str, Any]:
+        return StandardToolSchemas.create_input_schema({
+            "query": {
+                "type": "string",
+                "description": "地點名稱或地址（如「銘傳大學桃園校區」「桃園火車站」「台北101」）"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "返回結果數量（預設 1，最多 5）",
+                "default": 1
+            }
+        }, required=["query"])
+
+    @classmethod
+    def get_output_schema(cls) -> Dict[str, Any]:
+        schema = StandardToolSchemas.create_output_schema()
+        schema["properties"].update({
+            "results": {
+                "type": "array",
+                "description": "地點查詢結果列表",
+                "items": {
+                    "type": "object",
+                    "properties": {
+                        "lat": {"type": "number", "description": "緯度"},
+                        "lon": {"type": "number", "description": "經度"},
+                        "display_name": {"type": "string", "description": "完整地址"},
+                        "label": {"type": "string", "description": "簡短標籤"},
+                        "importance": {"type": "number", "description": "重要性評分（0-1）"}
+                    }
+                }
+            },
+            "best_match": {
+                "type": "object",
+                "description": "最佳匹配結果",
+                "properties": {
+                    "lat": {"type": "number"},
+                    "lon": {"type": "number"},
+                    "label": {"type": "string"}
+                }
+            }
+        })
+        return schema
+
+    @classmethod
+    async def execute(cls, arguments: Dict[str, Any]) -> Dict[str, Any]:
+        query = arguments.get("query", "").strip()
+        if not query:
+            raise ExecutionError("請提供地點名稱")
+
+        limit = min(int(arguments.get("limit", 1)), 5)
+
+        # 生成快取鍵（基於查詢文字）
+        import hashlib
+        cache_key = hashlib.md5(f"geocode:{query}".encode()).hexdigest()
+
+        # 記憶體快取
+        cached = await db_cache.get_geo_cached(cache_key)
+        if cached:
+            logger.info(f"📍 Geocoding 快取命中: {query}")
+            return cls.create_success_response(
+                content=f"找到地點：{cached['best_match']['label']}",
+                data=cached
+            )
+
+        # DB 快取
+        db_cached = await get_geo_cache(cache_key)
+        if db_cached:
+            await db_cache.set_geo_cache(cache_key, db_cached)
+            return cls.create_success_response(
+                content=f"找到地點：{db_cached['best_match']['label']}",
+                data=db_cached
+            )
+
+        # 外呼 Nominatim（公共端點，務必節流）
+        url = "https://nominatim.openstreetmap.org/search"
+        params = {
+            "format": "jsonv2",
+            "q": query,
+            "limit": limit,
+            "addressdetails": 1,
+            "extratags": 1,  # 取得額外標籤
+            "namedetails": 1,  # 取得多語言名稱
+            "accept-language": "zh-TW,zh"
+        }
+        headers = {
+            "User-Agent": "BloomWare/1.0 (contact@example.com)"
+        }
+
+        try:
+            async with aiohttp.ClientSession(headers=headers) as session:
+                async with session.get(url, params=params, timeout=aiohttp.ClientTimeout(total=10)) as resp:
+                    if resp.status != 200:
+                        raise ExecutionError(f"Nominatim 查詢失敗: HTTP {resp.status}")
+                    
+                    data = await resp.json()
+                    
+                    if not data or len(data) == 0:
+                        raise ExecutionError(f"找不到地點「{query}」，請確認地點名稱是否正確")
+
+        except asyncio.TimeoutError:
+            raise ExecutionError("地點查詢逾時，請稍後再試")
+        except aiohttp.ClientError as e:
+            raise ExecutionError(f"網路連接錯誤: {str(e)}")
+
+        # 解析結果
+        results = []
+        for item in data:
+            lat = float(item.get("lat", 0))
+            lon = float(item.get("lon", 0))
+            display_name = item.get("display_name", "")
+            importance = float(item.get("importance", 0))
+            
+            # 解析地址組件
+            addr = item.get("address", {})
+            extratags = item.get("extratags", {})
+            namedetails = item.get("namedetails", {})
+            
+            name = item.get("name", "")
+            name_zh = namedetails.get("name:zh") or namedetails.get("name:zh-TW") or name
+            
+            # 基本地址組件
+            road = addr.get("road") or addr.get("pedestrian") or addr.get("footway") or ""
+            house_number = addr.get("house_number") or ""
+            suburb = addr.get("suburb") or addr.get("neighbourhood") or ""
+            city_district = addr.get("city_district") or ""
+            city = addr.get("city") or addr.get("town") or addr.get("village") or addr.get("county") or ""
+            admin = addr.get("state") or addr.get("county") or ""
+            postcode = addr.get("postcode") or ""
+            
+            # POI 資訊
+            amenity = addr.get("amenity") or extratags.get("amenity") or ""
+            shop = addr.get("shop") or extratags.get("shop") or ""
+            building = addr.get("building") or extratags.get("building") or ""
+            
+            # 組裝簡短標籤
+            label_parts = []
+            if name_zh and name_zh != road:
+                label_parts.append(name_zh)
+            
+            if road and house_number:
+                label_parts.append(f"{road}{house_number}號")
+            elif road:
+                label_parts.append(road)
+            
+            if city_district and city_district not in str(label_parts):
+                label_parts.append(city_district)
+            elif suburb and suburb not in str(label_parts):
+                label_parts.append(suburb)
+            
+            # 添加城市/區域資訊
+            if city and city not in str(label_parts):
+                label_parts.append(city)
+            
+            label = ", ".join(filter(None, label_parts)) if label_parts else display_name
+            
+            # 組裝詳細地址
+            detailed_parts = []
+            if name_zh:
+                detailed_parts.append(f"地點: {name_zh}")
+            if road and house_number:
+                detailed_parts.append(f"地址: {road}{house_number}號")
+            elif road:
+                detailed_parts.append(f"路段: {road}")
+            if suburb:
+                detailed_parts.append(f"區域: {suburb}")
+            if city:
+                detailed_parts.append(f"城市: {city}")
+            if postcode:
+                detailed_parts.append(f"郵遞區號: {postcode}")
+            
+            detailed_address = " | ".join(detailed_parts) if detailed_parts else label
+
+            results.append({
+                "lat": lat,
+                "lon": lon,
+                "display_name": display_name,
+                "label": label,
+                "detailed_address": detailed_address,
+                "importance": importance,
+                # 額外欄位供後續使用
+                "name": name_zh or name,
+                "road": road,
+                "house_number": house_number,
+                "suburb": suburb,
+                "city_district": city_district,
+                "city": city,
+                "admin": admin,
+                "postcode": postcode,
+                "amenity": amenity,
+                "shop": shop,
+                "building": building,
+            })
+
+        # 最佳匹配（重要性最高）
+        best_match = max(results, key=lambda x: x["importance"])
+
+        payload = {
+            "results": results,
+            "best_match": best_match,
+            "query": query
+        }
+
+        # 回寫快取（雙層）
+        await db_cache.set_geo_cache(cache_key, payload)
+        await set_geo_cache(cache_key, payload)
+
+        logger.info(f"📍 Geocoding 成功: {query} → {best_match['label']} ({best_match['lat']:.4f}, {best_match['lon']:.4f})")
+
+        # 組裝友善回覆
+        content_parts = [f"找到地點：{best_match['label']}"]
+        if len(results) > 1:
+            content_parts.append(f"（共 {len(results)} 個結果，已選擇最相關的）")
+        
+        content = "\n".join(content_parts)
+
+        return cls.create_success_response(content=content, data=payload)

services/ai_service.py

@@ -145,20 +145,85 @@ def _format_history_for_prompt(history: List[Dict[str, str]]) -> str:
 
 
 def _format_env_context(ctx: Dict[str, Any]) -> str:
-    """將環境資訊整理成可讀文字，確保 AI 能掌握使用者所在位置。"""
+    """將環境資訊整理成可讀文字，確保 AI 能掌握使用者所在位置（精確到路口、門牌號）。"""
     if not ctx:
         return ""
 
     parts: List[str] = []
 
+    # 優先顯示詳細地址（最重要）
+    detailed_address = (ctx.get("detailed_address") or "").strip()
+    label = (ctx.get("label") or "").strip()
+    address_display = (ctx.get("address_display") or "").strip()
+    
+    if detailed_address:
+        parts.append(f"📍 精確位置:\n{detailed_address}")
+    elif label:
+        parts.append(f"📍 當前位置: {label}")
+    elif address_display:
+        parts.append(f"📍 當前位置: {address_display}")
+    
+    # 如果有門牌資訊，額外強調
+    road = (ctx.get("road") or "").strip()
+    house_number = (ctx.get("house_number") or "").strip()
+    postcode = (ctx.get("postcode") or "").strip()
+    
+    if road and house_number and not detailed_address:
+        address_line = f"{road}{house_number}號"
+        if postcode:
+            address_line = f"〒{postcode} {address_line}"
+        parts.append(f"門牌地址: {address_line}")
+    
+    # 區域資訊（如果沒有在 detailed_address 中顯示）
+    city_district = (ctx.get("city_district") or "").strip()
+    suburb = (ctx.get("suburb") or "").strip()
     city = (ctx.get("city") or "").strip()
     admin = (ctx.get("admin") or "").strip()
-    if city and admin:
-        parts.append(f"城市: {city}（{admin}）")
-    elif city:
-        parts.append(f"城市: {city}")
-    elif admin:
-        parts.append(f"行政區: {admin}")
+    
+    if not detailed_address:
+        if city_district:
+            parts.append(f"行政區: {city_district}")
+        elif suburb:
+            parts.append(f"區域: {suburb}")
+        
+        if city and admin:
+            parts.append(f"城市: {city}（{admin}）")
+        elif city:
+            parts.append(f"城市: {city}")
+        elif admin:
+            parts.append(f"省份: {admin}")
+
+    # 座標資訊（供工具使用）
+    lat = ctx.get("lat")
+    lon = ctx.get("lon")
+    try:
+        if lat is not None and lon is not None:
+            lat_f = float(lat)
+            lon_f = float(lon)
+            coord_text = f"緯度 {lat_f:.6f}, 經度 {lon_f:.6f}"
+            geohash = (ctx.get("geohash_7") or "").strip()
+            if geohash:
+                parts.append(f"座標: {coord_text}（Geohash {geohash}）")
+            else:
+                parts.append(f"座標: {coord_text}")
+    except (ValueError, TypeError):
+        pass
+
+    # POI 資訊（如果是特殊地點）
+    amenity = (ctx.get("amenity") or "").strip()
+    shop = (ctx.get("shop") or "").strip()
+    building = (ctx.get("building") or "").strip()
+    
+    poi_info = []
+    if amenity:
+        poi_info.append(f"設施: {amenity}")
+    if shop:
+        poi_info.append(f"商店: {shop}")
+    if building and building not in ["yes", "residential"]:
+        poi_info.append(f"建築: {building}")
+    
+    if poi_info:
+        parts.append(" | ".join(poi_info))
 
     tz = (ctx.get("tz") or "").strip()
     if tz:
@@ -175,21 +240,6 @@ def _format_env_context(ctx: Dict[str, Any]) -> str:
     except (ValueError, TypeError):
         pass
 
-    lat = ctx.get("lat")
-    lon = ctx.get("lon")
-    try:
-        if lat is not None and lon is not None:
-            lat_f = float(lat)
-            lon_f = float(lon)
-            coord_text = f"{lat_f:.5f}, {lon_f:.5f}"
-            geohash = (ctx.get("geohash_7") or "").strip()
-            if geohash:
-                parts.append(f"座標: {coord_text}（Geohash {geohash}）")
-            else:
-                parts.append(f"座標: {coord_text}")
-    except (ValueError, TypeError):
-        pass
-
     locale = (ctx.get("locale") or "").strip()
     if locale:
         parts.append(f"語系: {locale}")
@@ -198,10 +248,6 @@ def _format_env_context(ctx: Dict[str, Any]) -> str:
     if device:
         parts.append(f"裝置: {device}")
 
-    address_display = (ctx.get("address_display") or "").strip()
-    if address_display:
-        parts.append(f"地點: {address_display}")
-
     return "\n".join(parts)
 
 

static/frontend/index.html

@@ -979,85 +979,89 @@
     .voice-transcript-wrapper {
       position: relative;
       width: 100%;
+      max-width: 680px; /* 限制最大寬度（從 100% 改為固定上限）*/
+      margin: 0 auto; /* 置中對齊 */
+      padding: 0 20px; /* 左右留白 */
       display: flex;
       justify-content: center;
     }
 
     .voice-transcript {
-      width: min(100%, 560px);
+      width: 100%; /* 填滿 wrapper（受 max-width 限制）*/
       flex-shrink: 0;
-      padding: 24px 32px;
-      background: rgba(255, 255, 255, 0.95);
-      border: 1px solid rgba(0, 0, 0, 0.08);
-      border-radius: 16px;
-      backdrop-filter: blur(20px) saturate(180%);
-      font-size: 20px;
+      padding: 20px 28px; /* 減少內距（原 24px 32px）*/
+      background: rgba(255, 255, 255, 0.96);
+      border: 1.5px solid rgba(0, 0, 0, 0.06); /* 更細的邊框 */
+      border-radius: 14px; /* 稍微減少圓角（原 16px）*/
+      backdrop-filter: blur(24px) saturate(180%);
+      font-size: 18px; /* 減小字體（原 20px）*/
       font-weight: 400;
       color: #1A1A1A;
       text-align: center;
-      line-height: 1.6;
-      min-height: 80px;
-      max-height: 160px; /* 固定最大高度約 3-4 行文字 */
+      line-height: 1.5; /* 稍微緊湊（原 1.6）*/
+      min-height: 72px; /* 減少最小高度（原 80px）*/
+      max-height: 140px; /* 減少最大高度（原 160px）*/
       display: flex;
       align-items: center;
       justify-content: center;
-      transition: all 0.3s;
-      box-shadow: 0 4px 24px rgba(0, 0, 0, 0.08);
+      transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+      box-shadow: 0 3px 16px rgba(0, 0, 0, 0.06), 0 1px 4px rgba(0, 0, 0, 0.04); /* 更柔和的陰影 */
       outline: none;
       resize: none;
       overflow-y: auto;
     }
 
     .voice-transcript.provisional {
-      color: rgba(0, 0, 0, 0.4);
+      color: rgba(0, 0, 0, 0.35); /* 稍微降低對比（原 0.4）*/
       font-style: italic;
     }
 
     .voice-transcript.final {
       color: #1A1A1A;
-      border-color: rgba(0, 0, 0, 0.12);
-      box-shadow: 0 6px 32px rgba(0, 0, 0, 0.12);
+      border-color: rgba(0, 0, 0, 0.10); /* 稍微淡化（原 0.12）*/
+      box-shadow: 0 4px 20px rgba(0, 0, 0, 0.08), 0 2px 6px rgba(0, 0, 0, 0.04);
     }
 
     /* 文字輸入模式 */
     .voice-transcript.text-input-mode {
       cursor: text;
       text-align: left;
-      border-color: rgba(59, 130, 246, 0.5);
-      box-shadow: 0 0 0 3px rgba(59, 130, 246, 0.1), 0 6px 32px rgba(0, 0, 0, 0.12);
+      border-color: rgba(59, 130, 246, 0.4); /* 稍微淡化聚焦顏色 */
+      box-shadow: 0 0 0 2px rgba(59, 130, 246, 0.08), 0 4px 20px rgba(0, 0, 0, 0.08); /* 減少光暈範圍 */
       background: rgba(255, 255, 255, 0.98);
       white-space: pre-wrap;
       word-break: break-word;
-      max-height: 160px; /* 與基礎樣式保持一致 */
+      max-height: 140px; /* 與基礎樣式保持一致 */
     }
 
     .voice-transcript.text-input-mode:focus {
-      border-color: rgba(59, 130, 246, 0.8);
-      box-shadow: 0 0 0 4px rgba(59, 130, 246, 0.15), 0 8px 40px rgba(0, 0, 0, 0.15);
+      border-color: rgba(59, 130, 246, 0.7); /* 稍微降低強度（原 0.8）*/
+      box-shadow: 0 0 0 3px rgba(59, 130, 246, 0.12), 0 6px 28px rgba(0, 0, 0, 0.12); /* 調整光暈 */
     }
 
     .voice-transcript.text-input-mode:empty:before {
       content: attr(data-placeholder);
-      color: rgba(0, 0, 0, 0.3);
+      color: rgba(0, 0, 0, 0.28); /* 稍微淡化（原 0.3）*/
       font-style: italic;
     }
 
     /* 文字輸入模式下的提示文字 */
     .input-mode-hint {
       position: absolute;
-      bottom: -40px;
+      bottom: -36px; /* 調整位置（原 -40px）*/
       left: 50%;
       transform: translateX(-50%);
-      font-size: 13px;
-      color: rgba(0, 0, 0, 0.4);
-      background: rgba(255, 255, 255, 0.9);
-      padding: 8px 16px;
-      border-radius: 12px;
+      font-size: 12px; /* 減小字體（原 13px）*/
+      color: rgba(0, 0, 0, 0.38); /* 稍微提高對比（原 0.4）*/
+      background: rgba(255, 255, 255, 0.92);
+      padding: 6px 14px; /* 減少內距（原 8px 16px）*/
+      border-radius: 10px; /* 減少圓角（原 12px）*/
       backdrop-filter: blur(10px);
       opacity: 0;
-      transition: opacity 0.3s;
+      transition: opacity 0.3s cubic-bezier(0.4, 0, 0.2, 1);
       pointer-events: none;
       white-space: nowrap;
+      box-shadow: 0 2px 8px rgba(0, 0, 0, 0.04); /* 添加微陰影 */
     }
 
     .voice-transcript.text-input-mode + .input-mode-hint {
@@ -1069,6 +1073,28 @@
       opacity: 1 !important;
     }
 
+    /* 手機版優化 */
+    @media (max-width: 768px) {
+      .voice-transcript-wrapper {
+        max-width: 100%; /* 手機版全寬 */
+        padding: 0 16px; /* 減少左右留白 */
+      }
+
+      .voice-transcript {
+        font-size: 16px; /* 手機版縮小字體 */
+        padding: 16px 20px; /* 減少內距 */
+        min-height: 64px; /* 減少最小高度 */
+        max-height: 120px; /* 減少最大高度 */
+        border-radius: 12px; /* 減少圓角 */
+      }
+
+      .input-mode-hint {
+        font-size: 11px;
+        padding: 5px 12px;
+        bottom: -32px;
+      }
+    }
+
     /* === 工具卡片 === */
     .voice-tool-card {
       position: absolute;

static/frontend/js/websocket.js

@@ -107,7 +107,11 @@ class WebSocketManager {
           (_err) => {
             sendSnapshot(undefined, undefined, undefined, heading);
           },
-          { enableHighAccuracy: true, maximumAge: 60000, timeout: 5000 }
+          { 
+            enableHighAccuracy: true,  // 啟用高精度模式（GPS 優先於 WiFi/Cell）
+            maximumAge: 0,             // 不使用快取，強制取得最新位置
+            timeout: 15000             // 延長超時到 15 秒（GPS 冷啟動需要時間）
+          }
         );
       } else {
         sendSnapshot(undefined, undefined, undefined, heading);

tests/features/mcp/test_agent_bridge_route_labels.py

@@ -1,12 +1,14 @@
 import asyncio
 from pathlib import Path
 import sys
+import types
 
 ROOT_DIR = Path(__file__).resolve().parents[4]
 if str(ROOT_DIR) not in sys.path:
     sys.path.append(str(ROOT_DIR))
 
 from features.mcp.agent_bridge import MCPAgentBridge  # noqa: E402
+from features.mcp.tools.base_tool import ExecutionError  # noqa: E402
 
 
 def test_prepare_route_arguments_injects_labels():
@@ -51,3 +53,68 @@ def test_build_directions_message_returns_human_friendly_text():
     assert tool_data["duration_readable"].endswith("分") or tool_data["duration_readable"].endswith("分鐘")
     assert "origin_lat" not in tool_data
     assert "dest_lon" not in tool_data
+
+
+def test_build_directions_failure_response_generates_fallback_message():
+    bridge = MCPAgentBridge.__new__(MCPAgentBridge)
+
+    result = bridge._build_directions_failure_response(
+        {
+            "origin_lat": 25.045,
+            "origin_lon": 121.516,
+            "dest_lat": 24.993,
+            "dest_lon": 121.324,
+        },
+        {"origin_label": "測試起點 A", "dest_label": "測試目的地 B"},
+        "OpenRouteService 無法提供路線",
+    )
+
+    message = result["message"]
+    tool_data = result["tool_data"]
+
+    assert "測試起點 A" in message
+    assert "測試目的地 B" in message
+    assert tool_data["fallback"] is True
+    assert tool_data["distance_estimated_m"] is not None
+    assert "地圖" in message
+
+
+def test_call_mcp_tool_returns_fallback_when_directions_fails():
+    bridge = MCPAgentBridge.__new__(MCPAgentBridge)
+
+    async def fake_enrich(tool_name, arguments, user_id):
+        return arguments
+
+    async def fake_handler(_arguments):
+        raise ExecutionError("OpenRouteService 無法提供路線")
+
+    async def fake_resolve(_self, _lat, _lon):
+        return "測試地點"
+
+    bridge._enrich_arguments_with_env = fake_enrich  # type: ignore[attr-defined]
+    bridge._resolve_coordinate_label = fake_resolve.__get__(bridge, MCPAgentBridge)  # type: ignore[attr-defined]
+
+    bridge.mcp_server = types.SimpleNamespace(
+        tools={
+            "directions": types.SimpleNamespace(
+                handler=fake_handler,
+                description="Route",
+                metadata={"category": "地理"},
+                inputSchema={"properties": {}, "required": []},
+            )
+        }
+    )
+
+    result = asyncio.run(
+        bridge._call_mcp_tool(
+            "directions",
+            {"origin_lat": 25.045, "origin_lon": 121.516, "dest_lat": 24.993, "dest_lon": 121.324},
+            user_id="u123",
+            original_message="測試路線",
+        )
+    )
+
+    assert isinstance(result, dict)
+    assert result["tool_name"] == "directions"
+    assert result["tool_data"]["fallback"] is True
+    assert "目前無法向路線服務取得詳細路線" in result["message"]

tests/features/mcp/test_navigation_fix.py

@@ -0,0 +1,81 @@
+#!/usr/bin/env python3
+"""
+測試導航功能修復
+驗證地點查詢與導航是否正常工作
+"""
+
+import asyncio
+import logging
+from features.mcp.agent_bridge import MCPAgentBridge
+
+# 設置日誌
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+)
+
+async def test_navigation():
+    """測試導航功能"""
+    bridge = MCPAgentBridge()
+    await bridge.async_initialize()
+    
+    print("\n" + "="*60)
+    print("測試場景 1: 單純地點查詢")
+    print("="*60)
+    
+    test_messages_1 = [
+        "銘傳大學在哪裡",
+        "桃園火車站的位置",
+        "台北101地址"
+    ]
+    
+    for msg in test_messages_1:
+        print(f"\n用戶: {msg}")
+        has_intent, intent_data = await bridge.detect_intent(msg)
+        print(f"意圖檢測: has_intent={has_intent}")
+        if intent_data:
+            print(f"意圖資料: {intent_data}")
+    
+    print("\n" + "="*60)
+    print("測試場景 2: 導航需求（應自動串接 directions）")
+    print("="*60)
+    
+    test_messages_2 = [
+        "怎麼去桃園火車站",
+        "如何去銘傳大學",
+        "到台北101怎麼走"
+    ]
+    
+    # 模擬用戶位置（桃園）
+    test_user_id = "test_user_123"
+    
+    for msg in test_messages_2:
+        print(f"\n用戶: {msg}")
+        has_intent, intent_data = await bridge.detect_intent(msg)
+        print(f"意圖檢測: has_intent={has_intent}")
+        if intent_data:
+            print(f"意圖資料: {intent_data}")
+            
+            # 處理意圖
+            if intent_data.get("type") == "mcp_tool":
+                print(f"\n執行工具: {intent_data.get('tool_name')}")
+                print(f"參數: {intent_data.get('arguments')}")
+    
+    print("\n" + "="*60)
+    print("測試場景 3: 點到點查詢")
+    print("="*60)
+    
+    test_messages_3 = [
+        "從銘傳大學到桃園火車站要多久",
+        "台北車站到淡水捷運站怎麼走"
+    ]
+    
+    for msg in test_messages_3:
+        print(f"\n用戶: {msg}")
+        has_intent, intent_data = await bridge.detect_intent(msg)
+        print(f"意圖檢測: has_intent={has_intent}")
+        if intent_data:
+            print(f"意圖資料: {intent_data}")
+
+if __name__ == "__main__":
+    asyncio.run(test_navigation())

tests/features/mcp/test_precise_location.py

@@ -0,0 +1,146 @@
+#!/usr/bin/env python3
+"""
+測試精確地址功能
+驗證 reverse_geocode 與 forward_geocode 是否能正確提取門牌、路口資訊
+"""
+
+import asyncio
+import logging
+from features.mcp.tools.geocode_tool import ReverseGeocodeTool
+from features.mcp.tools.geocoding_tool import ForwardGeocodeTool
+
+# 設置日誌
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+)
+
+async def test_reverse_geocode():
+    """測試反向地理編碼（座標→地址）"""
+    print("\n" + "="*60)
+    print("測試場景 1: Reverse Geocode（座標 → 精確地址）")
+    print("="*60)
+    
+    test_cases = [
+        {"lat": 25.0330, "lon": 121.5654, "name": "台北101"},
+        {"lat": 25.0478, "lon": 121.5170, "name": "台北車站"},
+        {"lat": 24.9932, "lon": 121.3261, "name": "桃園火車站"},
+        {"lat": 25.0625, "lon": 121.1876, "name": "銘傳大學桃園校區"},
+        {"lat": 25.0853, "lon": 121.5603, "name": "台北市政府"},
+    ]
+    
+    for case in test_cases:
+        print(f"\n📍 測試地點: {case['name']}")
+        print(f"   座標: ({case['lat']}, {case['lon']})")
+        
+        try:
+            result = await ReverseGeocodeTool.execute({
+                "lat": case['lat'],
+                "lon": case['lon']
+            })
+            
+            if result.get("success"):
+                data = result.get("data", {})
+                print(f"   ✅ 成功取得地址:")
+                print(f"      標籤: {data.get('label')}")
+                print(f"      詳細地址: {data.get('detailed_address')}")
+                if data.get('road'):
+                    print(f"      路段: {data.get('road')}")
+                if data.get('house_number'):
+                    print(f"      門牌: {data.get('house_number')}")
+                if data.get('postcode'):
+                    print(f"      郵遞區號: {data.get('postcode')}")
+                if data.get('suburb'):
+                    print(f"      區域: {data.get('suburb')}")
+                if data.get('city'):
+                    print(f"      城市: {data.get('city')}")
+            else:
+                print(f"   ❌ 失敗: {result.get('error')}")
+        except Exception as e:
+            print(f"   ❌ 異常: {e}")
+
+async def test_forward_geocode():
+    """測試正向地理編碼（地名→座標）"""
+    print("\n" + "="*60)
+    print("測試場景 2: Forward Geocode（地名 → 座標 + 精確地址）")
+    print("="*60)
+    
+    test_queries = [
+        "台北101",
+        "桃園火車站",
+        "銘傳大學桃園校區",
+        "台北車站",
+        "淡水捷運站",
+        "台北市政府",
+        "中正紀念堂",
+    ]
+    
+    for query in test_queries:
+        print(f"\n🔍 查詢: {query}")
+        
+        try:
+            result = await ForwardGeocodeTool.execute({"query": query, "limit": 1})
+            
+            if result.get("success"):
+                data = result.get("data", {})
+                best = data.get("best_match", {})
+                print(f"   ✅ 找到地點:")
+                print(f"      標籤: {best.get('label')}")
+                print(f"      座標: ({best.get('lat')}, {best.get('lon')})")
+                print(f"      詳細地址: {best.get('detailed_address')}")
+                if best.get('road'):
+                    print(f"      路段: {best.get('road')}")
+                if best.get('house_number'):
+                    print(f"      門牌: {best.get('house_number')}")
+                if best.get('postcode'):
+                    print(f"      郵遞區號: {best.get('postcode')}")
+            else:
+                print(f"   ❌ 失敗: {result.get('error')}")
+        except Exception as e:
+            print(f"   ❌ 異常: {e}")
+
+async def test_precision_comparison():
+    """測試精度對比（舊 vs 新）"""
+    print("\n" + "="*60)
+    print("測試場景 3: 精度對比（展示改進效果）")
+    print("="*60)
+    
+    # 測試一個有明確門牌的地點
+    test_lat = 25.0330
+    test_lon = 121.5654
+    
+    print(f"\n測試座標: ({test_lat}, {test_lon}) - 台北101附近")
+    
+    result = await ReverseGeocodeTool.execute({"lat": test_lat, "lon": test_lon})
+    
+    if result.get("success"):
+        data = result.get("data", {})
+        
+        print("\n📊 解析結果對比:")
+        print(f"   舊版輸出（只有城市）: {data.get('city')}, {data.get('admin')}")
+        print(f"   新版標籤（精確地址）: {data.get('label')}")
+        print(f"   新版詳細地址: {data.get('detailed_address')}")
+        
+        print("\n🔍 詳細欄位:")
+        print(f"   名稱: {data.get('name')}")
+        print(f"   路段: {data.get('road')}")
+        print(f"   門牌: {data.get('house_number')}")
+        print(f"   區域: {data.get('suburb')}")
+        print(f"   行政區: {data.get('city_district')}")
+        print(f"   城市: {data.get('city')}")
+        print(f"   郵遞區號: {data.get('postcode')}")
+        print(f"   設施類型: {data.get('amenity')}")
+        print(f"   建築類型: {data.get('building')}")
+
+async def main():
+    """執行所有測試"""
+    await test_reverse_geocode()
+    await test_forward_geocode()
+    await test_precision_comparison()
+    
+    print("\n" + "="*60)
+    print("測試完成！")
+    print("="*60)
+
+if __name__ == "__main__":
+    asyncio.run(main())