PROGRESS.md

@@ -2,7 +2,7 @@
 
 > 配合 `DESIGN.md`。本文件只记 phase 状态、决策偏差、文件量、下一步。每条 1-2 句:做了啥 + 关键判断;细节查 `git log` / `git diff` / `DESIGN §7.9`。
 
-最后更新:2026-06-30(look_at_image 超时透明重试 + 超时 60→120s + bump 0.33.2)
+最后更新:2026-06-29(ppt skill 重构为 SVG-first,移植 ppt-master + bump 0.33.0)
 
 ---
 
@@ -21,12 +21,6 @@
 
 ## 已完成关键能力
 
-### 2026-06-30 / look_at_image 偶发超时:tool 内透明重试 + 超时上限提到 120s(bump 0.33.2)
-Seed 2.0 Lite 非流式,长 OCR 首字节可能逼近 60s read timeout → 偶发超时,且返 `[Error]` 会触发主模型重发整个 tool call(图 base64 重传、输入 token 再付一次,正中"报错重试烧 token"根因)。修法:`ark_client` 新增 `ArkTimeoutError(ArkError)` 子类(仅超时/网络抖动抛它,HTTP 4xx/5xx 业务错误仍抛普通 `ArkError` 不重试);`look_at_image` 对该子类退避重试(`timeout_retries` 默认 1 次,退避 2^n s),在 tool 内消化掉不抛给主模型;`doubao.yaml` vision `request_timeout_s` 60→120。子类仍是 `ArkError`,seedream 等现有 `except ArkError` 不受影响。
-
-### 2026-06-30 / 修复 web 端 SVG 无法预览(bump 0.33.1)
-SVG 在 `<img>` 里必须 Content-Type=`image/svg+xml` 才渲染。前端 `preview.js` 的 `_showImage` / mini 图片分支据扩展名强制 blob mime(与服务端响应头无关);后端 `download` 接口对 `.svg` 显式回 `image/svg+xml`(部分部署环境 mimetypes 未注册 svg → 会被 FileResponse 猜成 octet-stream)。双保险。
-
 ### 2026-06-29 / ppt skill 清空重构为 SVG-first(移植 ppt-master,bump 0.33.0)
 
 - 背景:旧 ppt skill 用 python-pptx + 固定组合版式件(`add_card_grid` 等),版面被 helper 框死 → 单调、AI 味重,是架构天花板,调参救不了。用户要求"清空重做,参考 github ppt-master"。

config/media/doubao.yaml

@@ -40,8 +40,7 @@ vision:
     price_cny_per_mtoken_output: 3.6
     price_cny_per_mtoken_cache_hit: 0.12
     max_image_mb: 10               # 单图上限(超出 tool 侧直接报错,不发请求)
-    request_timeout_s: 120         # 读图慢于此判超时(非流式,长 OCR 首字节可能逼近上限)
+    request_timeout_s: 60          # 读图慢于此判超时
-    timeout_retries: 1             # 超时/网络抖动 tool 内透明重试次数(退避 2^n s);不含业务错误
 
 video:
   # fast 放第一个 → 默认 variant(成本敏感场景优先);开通了 Pro 的用户从顶栏下拉切。

core/__init__.py

@@ -1,3 +1,3 @@
 # zcbot 版本号单一事实源:web/app.py 的 FastAPI version、/healthz 返回、前端展示都引这里。
 # 改版本只动这一行。
-__version__ = "0.33.2"
+__version__ = "0.33.0"

core/ark_client.py

@@ -23,14 +23,6 @@ class ArkError(RuntimeError):
     """ark API 调用失败的统一异常。"""
 
 
-class ArkTimeoutError(ArkError):
-    """可重试的瞬时失败:请求超时 / 网络抖动(非业务错误)。
-
-    HTTP 4xx/5xx 业务错误仍抛普通 ArkError(不该重试,重试也是同样的错)。
-    caller 可单独 catch 本子类做退避重试;catch ArkError 仍能兜住(isinstance)。
-    """
-
-
 @dataclass
 class ArkConfig:
     api_key: str
@@ -81,18 +73,18 @@ class ArkClient:
         try:
             resp = self._client.post(path, json=body, timeout=timeout_s or self.timeout_s)
         except httpx.TimeoutException as e:
-            raise ArkTimeoutError(f"timeout calling POST {path}: {e}") from e
+            raise ArkError(f"timeout calling POST {path}: {e}") from e
         except httpx.HTTPError as e:
-            raise ArkTimeoutError(f"network error calling POST {path}: {e}") from e
+            raise ArkError(f"network error calling POST {path}: {e}") from e
         return self._parse(resp, f"POST {path}")
 
     def get_json(self, path: str, *, timeout_s: Optional[float] = None) -> dict:
         try:
             resp = self._client.get(path, timeout=timeout_s or self.timeout_s)
         except httpx.TimeoutException as e:
-            raise ArkTimeoutError(f"timeout calling GET {path}: {e}") from e
+            raise ArkError(f"timeout calling GET {path}: {e}") from e
         except httpx.HTTPError as e:
-            raise ArkTimeoutError(f"network error calling GET {path}: {e}") from e
+            raise ArkError(f"network error calling GET {path}: {e}") from e
         return self._parse(resp, f"GET {path}")
 
     @staticmethod

tools/look_at_image.py

@@ -13,9 +13,7 @@ from pathlib import Path
 from typing import Any, Optional
 from uuid import UUID
 
-import time
+from core.ark_client import ArkClient, ArkConfig, ArkError
-
-from core.ark_client import ArkClient, ArkConfig, ArkError, ArkTimeoutError
 from core.storage.usage import record_vision_usage
 
 from .base import Tool, compact_tool_output
@@ -115,24 +113,9 @@ class LookAtImageTool(Tool):
             ],
         }
 
-        # 透明重试:Seed 2.0 Lite 非流式,长 OCR 偶发超时/网络抖动。tool 内消化掉,
-        # 不把 [Error] 抛给主模型 —— 否则主模型会重发整个 tool call(图 base64 重传、
-        # 输入 token 再付一次)。仅 ArkTimeoutError(超时/网络)重试;HTTP 业务错误不重试。
-        max_attempts = int(cfg.get("timeout_retries", 1)) + 1
-        resp = None
-        for attempt in range(max_attempts):
         try:
             with ArkClient(self.ark_cfg, timeout_s=timeout_s) as client:
                 resp = client.post_json(endpoint, body, timeout_s=timeout_s)
-                break
-            except ArkTimeoutError as e:
-                if attempt == max_attempts - 1:
-                    return f"[Error] look_at_image API: {e}(已重试 {attempt} 次仍超时)"
-                print(
-                    f"[look_at_image] timeout, retrying ({attempt + 1}/{max_attempts - 1}): {e}",
-                    flush=True,
-                )
-                time.sleep(2 ** attempt)
         except ArkError as e:
             return f"[Error] look_at_image API: {e}"
 

web/app.py

@@ -2755,15 +2755,9 @@ def create_app() -> FastAPI:
         # workspace 文件可变, 禁浏览器启发式缓存 (RFC 7234 默认能缓数小时)
         # 否则文件改了 SPA 预览还是旧内容
         # (Starlette FileResponse 不实现 304, 总是 200 全量; workspace 文件小, 可接受)
-        # .svg 显式给 image/svg+xml: 部分部署环境 mimetypes 未注册 svg, FileResponse
-        # 会猜成 octet-stream, 前端 <img> 就渲染不出 SVG 预览
-        media_type = None
-        if target.suffix.lower() == ".svg":
-            media_type = "image/svg+xml"
         return FileResponse(
             path=str(target),
             filename=target.name,
-            media_type=media_type,
             headers={"Cache-Control": "no-cache"},
         )
 

web/static/js/preview.js

@@ -228,11 +228,7 @@ export async function openFilePreview(rel) {
 }
 
 function _showImage(blob) {
-  // SVG 在 <img> 里必须 Content-Type=image/svg+xml 才渲染;下载接口靠服务端
+  const url = _trackBlobUrl(blob);
-  // mimetypes 猜类型,部分部署环境(Linux)未注册 .svg → octet-stream → 不显示。
-  // 这里据扩展名强制纠正,与服务端响应头无关。
-  const mime = /\.svg$/i.test(_fpCurrentRel || "") ? "image/svg+xml" : "";
-  const url = _trackBlobUrl(blob, mime);
   const body = $("fp-body");
   body.className = "body center";
   body.innerHTML = "";
@@ -474,8 +470,7 @@ async function openMiniFilePreview(rel) {
       body.className = "body center";
       const img = document.createElement("img");
       img.className = "preview-img";
-      const _mime = /\.svg$/i.test(_mpCurrentRel || "") ? "image/svg+xml" : "";
+      img.src = _trackMiniBlobUrl(blob);
-      img.src = _trackMiniBlobUrl(blob, _mime);
       body.appendChild(img);
       _makeImageZoomable(body, img);
     } else if (cat === "video") {