travel-agent-tools 1.0.0__tar.gz

travel_agent_tools-1.0.0/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: travel-agent-tools
+Version: 1.0.0
+Summary: 旅行特工队 - 工具层：面向智能旅行规划的 MCP 工具集（华为ICT创新赛）
+Author: Travel Agent Team
+License: MIT
+Keywords: mcp,travel,agent,huawei,agentarts
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+Requires-Dist: Jinja2>=3.1.2
+Requires-Dist: reportlab>=4.0.4
+Requires-Dist: beautifulsoup4>=4.12.3
+Requires-Dist: loguru>=0.7.2
+Requires-Dist: python-dotenv>=1.0.1
+
+# 旅行特工队 - 工具层（travel-agent-tools）
+
+> 华为 ICT 创新赛参赛作品 · 智果(AgentArts)平台 MCP 工具集
+
+面向年轻群体的智能旅行规划系统 **工具层**，通过 MCP（Model Context Protocol）协议对外提供
+7 大类共 **30 个工具**，可直接接入智果(AgentArts)智能体平台。
+
+## 工具清单
+
+| 模块 | 工具 |
+|---|---|
+| 地图 MCP | `search_poi` `planning_route` `geocode_address` `reverse_geocode` `search_around` |
+| 空间计算 MCP | `calculate_distance` `estimate_commute_time` `optimize_route_order` `find_enroute_attractions` `get_pois_center` `split_pois_by_day` |
+| 数据采集 | `fetch_reviews` `clean_reviews` `analyze_rating` `prioritize_pois` `summarize_reviews` |
+| HTML 生成 | `generate_travel_guide_html` `generate_checklist_html` `generate_photo_spots_html` `generate_share_card_html` |
+| PDF 生成 | `generate_checklist_pdf` `generate_itinerary_pdf` `generate_photo_guide_pdf` |
+| 接口跳转 | `generate_booking_links` `generate_countdown` `aggregate_booking_status` `generate_calendar_reminder` |
+| 抢票步骤 | `generate_ticket_steps` `generate_recommended_platform` `generate_ticket_tips` |
+
+> 未配置 `AMAP_API_KEY` 时，地图类工具自动降级为示例数据，服务仍可启动与联调。
+
+## 本地部署
+
+```bash
+# 1. 安装依赖（Python 3.10+）
+pip install -r requirements.txt
+
+# 2. 配置环境变量
+copy .env.example .env
+# 编辑 .env，填入高德地图 API Key（https://lbs.amap.com/ 申请）
+
+# 3. 验证
+python server.py --list
+python server.py --test "search_poi:keyword=故宫,city=北京"
+
+# 4. 启动
+python server.py --http --port 8000   # HTTP 模式（测试）
+python server.py                      # stdio 模式（MCP 标准，智果平台用）
+```
+
+HTTP 模式端点：`GET /`（健康检查）、`GET /tools`（工具列表）、`POST /tools/call`（调用工具）。
+
+## 智果(AgentArts)平台部署
+
+1. 登录 https://www.huaweicloud.com/product/agentarts.html 智果平台控制台（需完成认证）
+2. 「连接器管理」→「新建连接器」：类型 MCP Server，运行环境 Python 3.10+
+3. 上传 `travel-agent-tools.zip` 代码包，启动命令：`python server.py`
+4. 环境变量：`AMAP_API_KEY`（必填）、`MCP_SERVER_NAME=travel-agent-tools`、`LOG_LEVEL=INFO`
+5. 资源规格：开发测试 0.5核1GB 即可（本项目为轻量 CPU 应用）
+6. 部署 → 测试连接 → 在智能体中绑定连接器并勾选工具
+
+## 扩展开发
+
+1. 在 `tools/<模块>/` 实现新函数
+2. 在 `tools/__init__.py` 的 `HANDLERS` 与 `TOOLS` 中注册
+3. 重新打包部署到智果平台
+
+## 技术栈
+
+Python 3.10+ · MCP(JSON-RPC over stdio) · 高德地图 API · Jinja2 · ReportLab · BeautifulSoup4 · Haversine · Loguru
+
+---
+版本 v1.0.0 · 华为 ICT 创新赛 - 旅行特工队

travel_agent_tools-1.0.0/README.md

@@ -0,0 +1,63 @@
+# 旅行特工队 - 工具层（travel-agent-tools）
+
+> 华为 ICT 创新赛参赛作品 · 智果(AgentArts)平台 MCP 工具集
+
+面向年轻群体的智能旅行规划系统 **工具层**，通过 MCP（Model Context Protocol）协议对外提供
+7 大类共 **30 个工具**，可直接接入智果(AgentArts)智能体平台。
+
+## 工具清单
+
+| 模块 | 工具 |
+|---|---|
+| 地图 MCP | `search_poi` `planning_route` `geocode_address` `reverse_geocode` `search_around` |
+| 空间计算 MCP | `calculate_distance` `estimate_commute_time` `optimize_route_order` `find_enroute_attractions` `get_pois_center` `split_pois_by_day` |
+| 数据采集 | `fetch_reviews` `clean_reviews` `analyze_rating` `prioritize_pois` `summarize_reviews` |
+| HTML 生成 | `generate_travel_guide_html` `generate_checklist_html` `generate_photo_spots_html` `generate_share_card_html` |
+| PDF 生成 | `generate_checklist_pdf` `generate_itinerary_pdf` `generate_photo_guide_pdf` |
+| 接口跳转 | `generate_booking_links` `generate_countdown` `aggregate_booking_status` `generate_calendar_reminder` |
+| 抢票步骤 | `generate_ticket_steps` `generate_recommended_platform` `generate_ticket_tips` |
+
+> 未配置 `AMAP_API_KEY` 时，地图类工具自动降级为示例数据，服务仍可启动与联调。
+
+## 本地部署
+
+```bash
+# 1. 安装依赖（Python 3.10+）
+pip install -r requirements.txt
+
+# 2. 配置环境变量
+copy .env.example .env
+# 编辑 .env，填入高德地图 API Key（https://lbs.amap.com/ 申请）
+
+# 3. 验证
+python server.py --list
+python server.py --test "search_poi:keyword=故宫,city=北京"
+
+# 4. 启动
+python server.py --http --port 8000   # HTTP 模式（测试）
+python server.py                      # stdio 模式（MCP 标准，智果平台用）
+```
+
+HTTP 模式端点：`GET /`（健康检查）、`GET /tools`（工具列表）、`POST /tools/call`（调用工具）。
+
+## 智果(AgentArts)平台部署
+
+1. 登录 https://www.huaweicloud.com/product/agentarts.html 智果平台控制台（需完成认证）
+2. 「连接器管理」→「新建连接器」：类型 MCP Server，运行环境 Python 3.10+
+3. 上传 `travel-agent-tools.zip` 代码包，启动命令：`python server.py`
+4. 环境变量：`AMAP_API_KEY`（必填）、`MCP_SERVER_NAME=travel-agent-tools`、`LOG_LEVEL=INFO`
+5. 资源规格：开发测试 0.5核1GB 即可（本项目为轻量 CPU 应用）
+6. 部署 → 测试连接 → 在智能体中绑定连接器并勾选工具
+
+## 扩展开发
+
+1. 在 `tools/<模块>/` 实现新函数
+2. 在 `tools/__init__.py` 的 `HANDLERS` 与 `TOOLS` 中注册
+3. 重新打包部署到智果平台
+
+## 技术栈
+
+Python 3.10+ · MCP(JSON-RPC over stdio) · 高德地图 API · Jinja2 · ReportLab · BeautifulSoup4 · Haversine · Loguru
+
+---
+版本 v1.0.0 · 华为 ICT 创新赛 - 旅行特工队

travel_agent_tools-1.0.0/config/__init__.py

@@ -0,0 +1,14 @@
+from .settings import (  # noqa: F401
+    AMAP_API_KEY,
+    BASE_DIR,
+    HTML_DIR,
+    LOG_LEVEL,
+    MCP_SERVER_NAME,
+    OUTPUT_DIR,
+    PDF_DIR,
+    SERVER_NAME,
+    SERVER_VERSION,
+    TEMPLATES_DIR,
+    ensure_output_dirs,
+    has_amap_key,
+)

travel_agent_tools-1.0.0/config/settings.py

@@ -0,0 +1,45 @@
+"""配置管理：统一读取环境变量与项目路径。"""
+import os
+from pathlib import Path
+
+from dotenv import load_dotenv
+
+BASE_DIR = Path(__file__).resolve().parent.parent
+
+# 加载项目根目录下的 .env（若存在）
+load_dotenv(BASE_DIR / ".env")
+
+# ========== 环境变量 ==========
+# 高德地图 API Key（必填）申请地址: https://lbs.amap.com/
+AMAP_API_KEY = os.getenv("AMAP_API_KEY", "").strip()
+# 服务名称（智果平台连接器标识）
+MCP_SERVER_NAME = os.getenv("MCP_SERVER_NAME", "travel-agent-tools")
+# 日志级别: DEBUG / INFO / WARNING / ERROR
+LOG_LEVEL = os.getenv("LOG_LEVEL", "INFO").upper()
+
+# ========== 目录 ==========
+TEMPLATES_DIR = BASE_DIR / "templates"
+OUTPUT_DIR = BASE_DIR / "output"
+HTML_DIR = OUTPUT_DIR / "html"
+PDF_DIR = OUTPUT_DIR / "pdf"
+
+
+def ensure_output_dirs() -> None:
+    """确保输出目录存在；站点目录只读时（如 uvx 安装运行）回退到当前工作目录。"""
+    global OUTPUT_DIR, HTML_DIR, PDF_DIR
+    try:
+        for d in (HTML_DIR, PDF_DIR):
+            d.mkdir(parents=True, exist_ok=True)
+    except OSError:
+        base = Path.cwd() / "output"
+        OUTPUT_DIR, HTML_DIR, PDF_DIR = base, base / "html", base / "pdf"
+        for d in (HTML_DIR, PDF_DIR):
+            d.mkdir(parents=True, exist_ok=True)
+
+
+def has_amap_key() -> bool:
+    return bool(AMAP_API_KEY)
+
+
+SERVER_NAME = MCP_SERVER_NAME
+SERVER_VERSION = "1.0.0"

travel_agent_tools-1.0.0/mcp_server/__init__.py

@@ -0,0 +1,69 @@
+from __future__ import annotations
+
+"""MCP 服务核心：JSON-RPC 2.0 请求分发（stdio / HTTP 共用）。"""
+import json
+
+from config.settings import SERVER_NAME, SERVER_VERSION
+from tools import call_tool, list_tools
+
+PROTOCOL_VERSION = "2024-11-05"
+
+
+def handle_request(request: dict) -> dict | None:
+    """处理一条 JSON-RPC 2.0 请求，返回响应；通知类请求返回 None。"""
+    method = request.get("method", "")
+    req_id = request.get("id")
+
+    # 通知（无 id）不需要响应
+    if req_id is None:
+        return None
+
+    if method == "initialize":
+        return {"jsonrpc": "2.0", "id": req_id, "result": {
+            "protocolVersion": PROTOCOL_VERSION,
+            "capabilities": {"tools": {}},
+            "serverInfo": {"name": SERVER_NAME, "version": SERVER_VERSION},
+        }}
+
+    if method == "ping":
+        return {"jsonrpc": "2.0", "id": req_id, "result": {}}
+
+    if method == "tools/list":
+        return {"jsonrpc": "2.0", "id": req_id, "result": {"tools": list_tools()}}
+
+    if method == "tools/call":
+        params = request.get("params") or {}
+        name = params.get("name", "")
+        arguments = params.get("arguments") or {}
+        try:
+            result_text = _call(name, arguments)
+            return {"jsonrpc": "2.0", "id": req_id, "result": {
+                "content": [{"type": "text", "text": result_text}],
+                "isError": False,
+            }}
+        except Exception as e:  # noqa: BLE001
+            return {"jsonrpc": "2.0", "id": req_id, "result": {
+                "content": [{"type": "text", "text": f"工具调用失败: {e}"}],
+                "isError": True,
+            }}
+
+    return {"jsonrpc": "2.0", "id": req_id,
+            "error": {"code": -32601, "message": f"Method not found: {method}"}} if req_id is not None else None
+
+
+def _call(name: str, arguments: dict) -> str:
+    from tools import call_tool as _ct
+    result = _ct(name, arguments)
+    return json.dumps(result, ensure_ascii=False, default=str, indent=2)
+
+
+def handle_raw(raw: str) -> str | None:
+    """处理一行原始 JSON 文本，返回响应文本或 None。"""
+    try:
+        request = json.loads(raw)
+    except json.JSONDecodeError:
+        req_id = None
+        return json.dumps({"jsonrpc": "2.0", "id": req_id,
+                           "error": {"code": -32700, "message": "Parse error"}})
+    resp = handle_request(request)
+    return json.dumps(resp, ensure_ascii=False) if resp is not None else None

travel_agent_tools-1.0.0/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "travel-agent-tools"
+version = "1.0.0"
+description = "旅行特工队 - 工具层：面向智能旅行规划的 MCP 工具集（华为ICT创新赛）"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Travel Agent Team" }]
+keywords = ["mcp", "travel", "agent", "huawei", "agentarts"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "requests>=2.31.0",
+    "Jinja2>=3.1.2",
+    "reportlab>=4.0.4",
+    "beautifulsoup4>=4.12.3",
+    "loguru>=0.7.2",
+    "python-dotenv>=1.0.1",
+]
+
+[project.scripts]
+travel-agent-tools = "server:main"
+
+[tool.setuptools]
+py-modules = ["server"]
+packages = [
+    "config",
+    "mcp_server",
+    "templates",
+    "tools",
+    "tools.map_mcp",
+    "tools.spatial_mcp",
+    "tools.data_collector",
+    "tools.html_generator",
+    "tools.pdf_generator",
+    "tools.booking_link",
+    "tools.ticket_steps",
+]
+
+[tool.setuptools.package-data]
+templates = ["*.html"]

travel_agent_tools-1.0.0/server.py

@@ -0,0 +1,130 @@
+"""旅行特工队 - 工具层 MCP 服务入口。
+
+用法:
+  python server.py                     # stdio 模式（MCP 标准模式，智果平台默认）
+  python server.py --http --port 8000  # HTTP 模式（推荐用于本地测试）
+  python server.py --list              # 列出所有可用工具
+  python server.py --test "search_poi:keyword=故宫,city=北京"   # 测试某个工具
+"""
+import argparse
+import json
+import sys
+from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
+
+# 确保中文输出不乱码（Windows / 部分容器默认非 UTF-8）
+for stream in (sys.stdout, sys.stderr):
+    try:
+        stream.reconfigure(encoding="utf-8")
+    except Exception:  # noqa: BLE001
+        pass
+
+from loguru import logger
+
+from config.settings import LOG_LEVEL, SERVER_NAME, SERVER_VERSION
+from mcp_server import handle_raw
+from tools import call_tool_json, list_tools
+
+logger.remove()
+logger.add(sys.stderr, level=LOG_LEVEL)
+
+
+def run_list() -> None:
+    tools = list_tools()
+    print(f"共 {len(tools)} 个可用工具:\n")
+    for t in tools:
+        print(f"  - {t['name']}: {t['description']}")
+
+
+def run_test(spec: str) -> None:
+    """spec 格式: 工具名:参数1=值1,参数2=值2"""
+    if ":" not in spec:
+        name, raw_args = spec, ""
+    else:
+        name, raw_args = spec.split(":", 1)
+    arguments: dict = {}
+    for kv in filter(None, raw_args.split(",")):
+        if "=" in kv:
+            k, v = kv.split("=", 1)
+            try:
+                v = int(v)
+            except ValueError:
+                try:
+                    v = float(v)
+                except ValueError:
+                    pass
+            arguments[k.strip()] = v
+    print(f"调用工具 {name}，参数: {arguments}\n")
+    print(call_tool_json(name, arguments))
+
+
+def run_stdio() -> None:
+    """MCP 标准模式：stdin 读取 JSON-RPC 请求，stdout 输出响应（日志全部走 stderr）。"""
+    logger.info(f"{SERVER_NAME} v{SERVER_VERSION} 已启动（stdio 模式）")
+    for line in sys.stdin:
+        line = line.strip()
+        if not line:
+            continue
+        resp = handle_raw(line)
+        if resp is not None:
+            sys.stdout.write(resp + "\n")
+            sys.stdout.flush()
+
+
+def run_http(port: int) -> None:
+    class Handler(BaseHTTPRequestHandler):
+        def _send(self, code: int, obj) -> None:
+            body = json.dumps(obj, ensure_ascii=False, default=str).encode("utf-8")
+            self.send_response(code)
+            self.send_header("Content-Type", "application/json; charset=utf-8")
+            self.send_header("Content-Length", str(len(body)))
+            self.end_headers()
+            self.wfile.write(body)
+
+        def do_GET(self) -> None:  # noqa: N802
+            if self.path == "/":
+                self._send(200, {"status": "ok", "server": SERVER_NAME,
+                                 "version": SERVER_VERSION, "tools": len(list_tools())})
+            elif self.path == "/tools":
+                self._send(200, {"tools": list_tools()})
+            else:
+                self._send(404, {"error": "not found, try / or /tools"})
+
+        def do_POST(self) -> None:  # noqa: N802
+            if self.path != "/tools/call":
+                self._send(404, {"error": "not found, use POST /tools/call"})
+                return
+            try:
+                length = int(self.headers.get("Content-Length", 0))
+                payload = json.loads(self.rfile.read(length) or b"{}")
+                result = call_tool_json(payload.get("name", ""), payload.get("arguments") or {})
+                self._send(200, json.loads(result))
+            except Exception as e:  # noqa: BLE001
+                self._send(400, {"success": False, "error": str(e)})
+
+        def log_message(self, *args) -> None:  # 静默默认访问日志
+            logger.debug(args)
+
+    logger.info(f"{SERVER_NAME} v{SERVER_VERSION} HTTP 模式启动，端口 {port}")
+    ThreadingHTTPServer(("0.0.0.0", port), Handler).serve_forever()
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="旅行特工队 - 工具层 MCP 服务")
+    parser.add_argument("--http", action="store_true", help="以 HTTP 模式启动（默认 stdio）")
+    parser.add_argument("--port", type=int, default=8000, help="HTTP 端口，默认 8000")
+    parser.add_argument("--list", action="store_true", help="列出所有可用工具")
+    parser.add_argument("--test", type=str, metavar="SPEC", help='测试工具，如 "search_poi:keyword=故宫,city=北京"')
+    args = parser.parse_args()
+
+    if args.list:
+        run_list()
+    elif args.test:
+        run_test(args.test)
+    elif args.http:
+        run_http(args.port)
+    else:
+        run_stdio()
+
+
+if __name__ == "__main__":
+    main()

travel_agent_tools-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

travel_agent_tools-1.0.0/templates/__init__.py

@@ -0,0 +1 @@
+# 模板资源包（随 PyPI 包分发，供 HTML 生成工具使用）

travel_agent_tools-1.0.0/templates/checklist.html

@@ -0,0 +1,36 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>{{ title }}</title>
+<style>
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body { font-family: "PingFang SC", "Microsoft YaHei", sans-serif; background: #f5f6fa; color: #2f3542; padding: 24px; }
+  .wrap { max-width: 680px; margin: 0 auto; }
+  h1 { text-align: center; margin: 16px 0 4px; }
+  .sub { text-align: center; color: #888; margin-bottom: 24px; }
+  .cat { background: #fff; border-radius: 12px; padding: 20px; margin-bottom: 14px; box-shadow: 0 2px 8px rgba(0,0,0,.06); }
+  .cat h2 { font-size: 18px; margin-bottom: 12px; color: #ff5e57; }
+  .item { display: flex; align-items: flex-start; gap: 10px; padding: 6px 0; line-height: 1.5; }
+  .box { width: 18px; height: 18px; border: 2px solid #b0b3ba; border-radius: 4px; flex: none; margin-top: 2px; }
+  .item .note { color: #888; font-size: 13px; }
+  footer { text-align: center; color: #999; font-size: 13px; padding: 24px 0; }
+</style>
+</head>
+<body>
+  <div class="wrap">
+    <h1>☑ {{ title }}</h1>
+    {% if destination %}<p class="sub">目的地：{{ destination }}</p>{% endif %}
+    {% for c in categories %}
+    <div class="cat">
+      <h2>{{ c.get('name', '') }}</h2>
+      {% for it in c.get('items', []) %}
+      <div class="item"><span class="box"></span><div>{{ it.get('name', it) if it is mapping else it }}{% if it is mapping and it.get('note') %}<br><span class="note">{{ it['note'] }}</span>{% endif %}</div></div>
+      {% endfor %}
+    </div>
+    {% endfor %}
+    <footer>旅行特工队 · 打印或截图打卡 {{ generated_at }}</footer>
+  </div>
+</body>
+</html>

travel_agent_tools-1.0.0/templates/photo_spots.html

@@ -0,0 +1,36 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>{{ destination }} 拍照指南</title>
+<style>
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body { font-family: "PingFang SC", "Microsoft YaHei", sans-serif; background: #1e272e; color: #f5f6fa; padding: 24px; }
+  .wrap { max-width: 720px; margin: 0 auto; }
+  h1 { text-align: center; margin: 16px 0; }
+  .card { background: #2f3640; border-radius: 14px; padding: 20px; margin-bottom: 16px; border-left: 4px solid #ff9f43; }
+  .card h2 { font-size: 19px; margin-bottom: 10px; }
+  .tag { display: inline-block; background: #ff9f43; color: #1e272e; border-radius: 999px; padding: 3px 12px; font-size: 13px; margin-right: 8px; margin-bottom: 8px; }
+  .card p { line-height: 1.7; color: #d2dae2; font-size: 14px; }
+  .card p b { color: #ffb27a; }
+  footer { text-align: center; color: #777; font-size: 13px; padding: 24px 0; }
+</style>
+</head>
+<body>
+  <div class="wrap">
+    <h1>📷 {{ destination or '旅行' }} 拍照指南</h1>
+    {% for s in spots %}
+    <div class="card">
+      <h2>{{ s.get('name', s) if s is mapping else s }}</h2>
+      {% if s is mapping %}
+        {% if s.get('best_time') %}<span class="tag">⏰ {{ s['best_time'] }}</span>{% endif %}
+        {% if s.get('angle') %}<p><b>机位建议：</b>{{ s['angle'] }}</p>{% endif %}
+        {% if s.get('tip') %}<p><b>小贴士：</b>{{ s['tip'] }}</p>{% endif %}
+      {% endif %}
+    </div>
+    {% endfor %}
+    <footer>旅行特工队 · 出片率拉满 {{ generated_at }}</footer>
+  </div>
+</body>
+</html>

travel_agent_tools-1.0.0/templates/share_card.html

@@ -0,0 +1,45 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>{{ destination }} 旅行分享卡片</title>
+<style>
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body { background: #2f3542; display: flex; justify-content: center; padding: 32px 16px; font-family: "PingFang SC", "Microsoft YaHei", sans-serif; }
+  .card { width: 420px; max-width: 100%; background: linear-gradient(160deg, #ff5e57 0%, #ff9f43 60%, #ffd32a 100%); border-radius: 24px; padding: 36px 28px; color: #fff; box-shadow: 0 16px 48px rgba(0,0,0,.35); }
+  .brand { font-size: 13px; opacity: .85; letter-spacing: 2px; }
+  h1 { font-size: 34px; margin: 10px 0 4px; }
+  .sub { font-size: 15px; opacity: .92; margin-bottom: 20px; }
+  .stats { display: flex; gap: 10px; margin-bottom: 20px; }
+  .stat { flex: 1; background: rgba(255,255,255,.2); backdrop-filter: blur(4px); border-radius: 12px; padding: 12px 8px; text-align: center; }
+  .stat b { display: block; font-size: 18px; }
+  .stat span { font-size: 12px; opacity: .9; }
+  .quote { background: rgba(255,255,255,.16); border-radius: 12px; padding: 14px 16px; font-size: 15px; line-height: 1.6; margin-bottom: 20px; }
+  .routes { font-size: 13.5px; line-height: 1.9; margin-bottom: 8px; }
+  .routes li { margin-left: 18px; }
+  .author { text-align: right; font-size: 14px; opacity: .9; margin-top: 18px; }
+</style>
+</head>
+<body>
+  <div class="card">
+    <div class="brand">TRAVEL AGENT · 旅行特工队</div>
+    <h1>{{ destination }}</h1>
+    <div class="sub">{{ days }} 天 {{ travelers }} 人的美好旅程</div>
+    <div class="stats">
+      <div class="stat"><b>{{ days }}</b><span>天数</span></div>
+      <div class="stat"><b>{{ travelers }}</b><span>同行人数</span></div>
+      <div class="stat"><b>¥{{ budget }}</b><span>预算</span></div>
+    </div>
+    {% if highlight_text %}<div class="quote">“{{ highlight_text }}”</div>{% endif %}
+    {% if daily_routes %}
+    <ul class="routes">
+      {% for d in daily_routes %}
+      <li>Day {{ d.get('day', loop.index) }}：{% if d.get('title') %}{{ d['title'] }}{% elif d.get('pois') %}{{ d['pois'] | join(' → ') }}{% endif %}</li>
+      {% endfor %}
+    </ul>
+    {% endif %}
+    <div class="author">—— {{ author }}</div>
+  </div>
+</body>
+</html>

travel_agent_tools-1.0.0/templates/travel_guide.html

@@ -0,0 +1,66 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>{{ destination }} · {{ days }} 日旅行攻略</title>
+<style>
+  :root { --primary: #ff5e57; --dark: #2f3542; --light: #f5f6fa; }
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body { font-family: "PingFang SC", "Microsoft YaHei", sans-serif; background: var(--light); color: var(--dark); }
+  .hero { background: linear-gradient(135deg, #ff5e57 0%, #ff9f43 100%); color: #fff; padding: 48px 24px; text-align: center; }
+  .hero h1 { font-size: 32px; margin-bottom: 12px; }
+  .meta { display: flex; gap: 16px; justify-content: center; flex-wrap: wrap; margin-top: 16px; }
+  .meta span { background: rgba(255,255,255,.22); padding: 6px 14px; border-radius: 999px; font-size: 14px; }
+  .container { max-width: 860px; margin: 0 auto; padding: 24px; }
+  h2 { margin: 32px 0 16px; padding-left: 12px; border-left: 4px solid var(--primary); font-size: 22px; }
+  .highlights li, .tips li { margin: 8px 0 8px 20px; line-height: 1.6; }
+  .day-card { background: #fff; border-radius: 12px; padding: 20px; margin-bottom: 16px; box-shadow: 0 2px 10px rgba(0,0,0,.06); }
+  .day-card h3 { color: var(--primary); margin-bottom: 8px; }
+  .day-card ul { margin-left: 20px; line-height: 1.8; }
+  .note { color: #57606f; font-size: 14px; margin-top: 8px; }
+  footer { text-align: center; color: #999; font-size: 13px; padding: 32px 0; }
+</style>
+</head>
+<body>
+  <div class="hero">
+    <h1>{{ destination }} · {{ days }} 日游攻略</h1>
+    <div class="meta">
+      <span>📅 出发：{{ start_date or '待定' }}</span>
+      <span>👥 {{ travelers }} 人</span>
+      <span>💰 预算 ¥{{ budget }}</span>
+    </div>
+  </div>
+  <div class="container">
+    {% if highlights %}
+    <h2>✨ 行程亮点</h2>
+    <ul class="highlights">{% for h in highlights %}<li>{{ h }}</li>{% endfor %}</ul>
+    {% endif %}
+
+    {% if daily_routes %}
+    <h2>🗺 每日路线</h2>
+    {% for d in daily_routes %}
+    <div class="day-card">
+      <h3>Day {{ d.get('day', loop.index) }}{% if d.get('title') %} · {{ d['title'] }}{% endif %}</h3>
+      <ul>
+        {% for p in d.get('pois', []) %}
+          {% if p is mapping %}
+          <li>{% if p.get('time') %}{{ p['time'] }} {% endif %}{{ p.get('name', '') }}{% if p.get('note') %} —— {{ p['note'] }}{% endif %}</li>
+          {% else %}
+          <li>{{ p }}</li>
+          {% endif %}
+        {% endfor %}
+      </ul>
+      {% if d.get('note') %}<p class="note">💡 {{ d['note'] }}</p>{% endif %}
+    </div>
+    {% endfor %}
+    {% endif %}
+
+    {% if tips %}
+    <h2>💡 实用贴士</h2>
+    <ul class="tips">{% for t in tips %}<li>{{ t }}</li>{% endfor %}</ul>
+    {% endif %}
+  </div>
+  <footer>由 旅行特工队 · 工具层 生成 · {{ generated_at }}</footer>
+</body>
+</html>