htmlgen-mcp 0.3.8__py3-none-any.whl → 0.4.0__py3-none-any.whl

htmlgen_mcp/web_agent_server.py

@@ -44,8 +44,8 @@ DEFAULT_PROJECT_ROOT = os.path.abspath(
 )
 # 是否自动生成项目子目录（可通过环境变量控制）
 AUTO_CREATE_PROJECT_DIR = os.environ.get("AUTO_CREATE_PROJECT_DIR", "true").lower() == "true"
-# 默认的文件上传URL（固定值）
-DEFAULT_UPLOAD_URL = "https://www.mcpcn.cc/api/fileUploadAndDownload/uploadMcpFile"
+# 默认的文件上传URL（可通过环境变量 UPLOAD_URL 覆盖）
+DEFAULT_UPLOAD_URL = os.environ.get("UPLOAD_URL", "https://www.mcpcn.cc/api/fileUploadAndDownload/uploadMcpFile")
 DEFAULT_MODEL = os.environ.get("WEB_AGENT_MODEL", "qwen3-coder-plus-2025-09-23")
 DEFAULT_BASE_URL = os.environ.get(
     "OPENAI_BASE_URL", "https://dashscope.aliyuncs.com/compatible-mode/v1"
@@ -464,7 +464,7 @@ async def execute_plan(
     # confirm_each_step: bool = False,  # 后台执行模式下用户无法交互确认
     # show_code: bool = False,  # 后台执行时用户看不到输出
     # verbose: bool = False,  # 后台执行时详细日志意义不大
-    save_output: bool = False,
+    # save_output: bool = True,  # 已固定为 True，始终创建进度日志
     progress_log: Optional[str] = None,
 ) -> Dict[str, Any]:
     """执行网页构建计划，始终以后台模式运行。
@@ -474,26 +474,23 @@ async def execute_plan(
         由 plan_site 工具返回的计划ID，用于从缓存或文件系统中查找对应的执行计划。
         例如："a1b2c3d4e5f6..." 这样的32位十六进制字符串。
 
-    - project_root: 网站文件生成的目标目录路径
+    - project_root: 网站文件生成的目标目录路径（可选）
         指定项目文件的输出位置，可以是绝对路径或相对路径。
         例如："/path/to/my/website" 或 "./my-project"
         如果目录不存在，系统会自动创建。
-
-    - save_output: 是否保存执行过程的详细输出到文件
-        True: 会自动创建进度日志文件，记录所有执行步骤和结果
-        False: 不创建进度日志文件，只保留基本的任务状态信息
-        建议在调试或需要详细追踪时设置为 True
+        如果未指定，将使用计划中保存的项目目录。
 
     - progress_log: 自定义进度日志文件的保存路径（可选）
         如果指定：使用该路径保存进度日志（JSONL格式）
-        如果未指定但 save_output=True：自动在 ~/.mcp/make_web/progress_logs 目录创建时间戳命名的日志文件（可通过环境变量覆盖）
-        如果都未指定：不记录进度日志
+        如果未指定：自动在 ~/.mcp/make_web/progress_logs 目录创建时间戳命名的日志文件（可通过环境变量覆盖）
         路径可以是绝对路径或相对于 project_root 的相对路径
 
+        注意：进度日志始终会被创建，以便使用 get_progress 工具查询任务进度。
+
     执行流程：
     - 任务始终在后台异步执行，立即返回 job_id 和 progress_log 路径
     - 使用 get_progress(job_id=..., limit=...) 可以实时查询执行状态和进度
-    - 支持通过进度日志文件追踪详细的执行步骤和结果
+    - 系统会自动记录详细的执行步骤和结果到进度日志文件
     - 执行完成后可以获取完整的执行报告、生成文件列表，以及自动上传结果
     """
     try:
@@ -532,21 +529,21 @@ async def execute_plan(
         
         project_dir = _resolve_project_directory(project_root, project_name)
 
-        # 移除 auto_plan 检查，因为参数已被移除
-
+        # 进度日志始终启用
         if progress_log:
+            # 用户指定了自定义日志路径
             progress_log_path = (
                 progress_log
                 if os.path.isabs(progress_log)
                 else os.path.join(project_dir, progress_log)
             )
-        elif save_output:
+        else:
+            # 自动生成日志文件
             progress_log_path = os.path.join(
                 PROGRESS_LOG_DIR, f"agent_progress_{int(time.time())}.jsonl"
             )
-        else:
-            progress_log_path = None
 
+        # 尝试创建日志文件
         if progress_log_path:
             try:
                 Path(progress_log_path).parent.mkdir(parents=True, exist_ok=True)
@@ -554,9 +551,10 @@ async def execute_plan(
             except Exception:
                 progress_log_path = None
 
+        # save_output 固定为 True
         agent = _build_agent(
             project_dir,
-            save_output=save_output,
+            save_output=True,
         )
 
         # 通过 plan_id 查询计划
@@ -761,21 +759,15 @@ async def create_simple_site(
 ) -> Dict[str, Any]:
     """使用AI分析需求，生成简单但美观的网站计划。
 
-    ⚠️ 重要参数说明：
+    参数说明：
     - description: 网站需求描述，例如"个人作品展示网站"、"小餐厅官网"、"博客网站"等
-    - site_title: 网站标题
-    - context_content: 🔥 核心参数！用于传递网页制作所需的所有原始数据内容
+    - site_title: 网站标题，默认为"我的网站"
+    - context_content: 可选，用于传递网页制作所需的所有原始数据内容
       * 例如：咖啡馆列表、产品介绍、菜单内容、地址信息、营业时间等
       * 这是AI获取具体业务信息的唯一渠道，请务必将查询到的详细信息完整传入
       * 如果有地图查询结果、API返回数据等，都应该放在这个参数中
       * 格式可以是文本、JSON字符串或结构化数据的字符串表示
 
-    图片配置参数（可选）：
-    - image_style: 图片风格 (professional|artistic|minimal|vibrant|luxury)
-    - image_topics: 用户自定义的图片主题列表，如 ["modern office", "team collaboration"]
-    - include_gallery: 是否在网站中包含图片画廊功能
-    - image_provider: 图片提供商 (pollinations|dicebear|robohash)
-
     返回值说明：
     - status: 操作状态 ("success" 或 "error")
     - plan_id: 生成的计划唯一标识符，用于后续执行

{htmlgen_mcp-0.3.8.dist-info → htmlgen_mcp-0.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: htmlgen-mcp
-Version: 0.3.8
+Version: 0.4.0
 Summary: AI-powered HTML website generator with auto-upload functionality via Model Context Protocol
 Author-email: HTML Generator Team <contact@htmlgen-mcp.com>
 License: MIT

{htmlgen_mcp-0.3.8.dist-info → htmlgen_mcp-0.4.0.dist-info}/RECORD

@@ -8,7 +8,7 @@ htmlgen_mcp/progress_tools.py,sha256=SOScPSr3hEv4rvGzqvwUcomEFiPhhNxJ7CbWURlFpBs
 htmlgen_mcp/progress_tracker.py,sha256=2TVduWNJJH08EQ7Vf9EpiwPjtp61JX7muSCdbGHZAfM,12210
 htmlgen_mcp/prompt_enhancer.py,sha256=8UIxt45vSNarS5uqfxC5thOfnGY7luDs2YjHZRx1GAM,7976
 htmlgen_mcp/sse_optimizations.py,sha256=_UTpgLtxgNAiiEkO5lPihOi1-eEQk6R4ejNParufrrc,6932
-htmlgen_mcp/web_agent_server.py,sha256=kw1ryQHZjcm1Rz99kZir8byylABvfOb0hkfUmnf54CQ,51145
+htmlgen_mcp/web_agent_server.py,sha256=HCOKIAG3Jr201nsxR53_hJG_5miJaKvrjR9KDm4HnI0,50787
 htmlgen_mcp/agents/__init__.py,sha256=Xydfjzw9s9O6I5Ixx6EmsTdXu26136NDPUAqt9B1hzE,121
 htmlgen_mcp/agents/ai_content_generator.py,sha256=tWGC9cY6Wp7MB1P9J7uCv8LUdiS02rgS6vxaNHD7KQk,10311
 htmlgen_mcp/agents/quick_generator.py,sha256=2wV4PCRugV0suTedLDV91_etHy_2Fiw4J0MraT7MQjw,34201
@@ -31,8 +31,8 @@ htmlgen_mcp/agents/web_tools/simple_css.py,sha256=kj9X3sHHhj1wGwBVL20j6w2qIHXRdx
 htmlgen_mcp/agents/web_tools/simple_js.py,sha256=xMiuF-u-h_IIkUONZIa4Xf8vKB5mcXxwQf5b_BIcpoE,12174
 htmlgen_mcp/agents/web_tools/simple_templates.py,sha256=-Rs-SsWpGZT2hiwa3jZNVDHOMZOo1vV2pWbmBdR30os,6471
 htmlgen_mcp/agents/web_tools/validation.py,sha256=bNA6aWXrCSi7sPqQw5bBR3XF69gRf85D5jSMi996CtI,2069
-htmlgen_mcp-0.3.8.dist-info/METADATA,sha256=RQNybh9_YO-SB8uwqVyYlkFVXgs4u6K086J_g5bJNzo,5161
-htmlgen_mcp-0.3.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-htmlgen_mcp-0.3.8.dist-info/entry_points.txt,sha256=w7ufTQJobIxT3FYI24yKsCEwEQvBOWhNjckUd9Amu_k,66
-htmlgen_mcp-0.3.8.dist-info/top_level.txt,sha256=KnglzX4ekV8SQkHTsJg2_nTBXz2TxaYLdvoMMovHLNk,12
-htmlgen_mcp-0.3.8.dist-info/RECORD,,
+htmlgen_mcp-0.4.0.dist-info/METADATA,sha256=CKfyLT9XvtOV8j1TSObj5S4beyhmOEWRAG5ke9Tl3vc,5161
+htmlgen_mcp-0.4.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+htmlgen_mcp-0.4.0.dist-info/entry_points.txt,sha256=w7ufTQJobIxT3FYI24yKsCEwEQvBOWhNjckUd9Amu_k,66
+htmlgen_mcp-0.4.0.dist-info/top_level.txt,sha256=KnglzX4ekV8SQkHTsJg2_nTBXz2TxaYLdvoMMovHLNk,12
+htmlgen_mcp-0.4.0.dist-info/RECORD,,