@remixmate/cli 0.9.71 → 0.9.73

package/skills/template-registry/scripts/doc_extract.py

@@ -1,28 +1,28 @@
 #!/usr/bin/env python3
-"""Shared document extraction client — ab-render ``/extract`` submit + poll.
 
-为什么这段逻辑住在共享目录而不是 doc-parse skill 里：**有两个消费方，而且它们要的
-形态相反**。
 
-  doc-parse（给模型看）      → 摘要进 stdout，全量落盘。layout 层一页带内嵌图标可达
-                              几百 KB，进对话正文会撑爆上下文。
-  payload_hydrator（给机器用）→ 要的就是全量 layout，直接填进 DSL 的 customPayload。
 
-第二个消费方以前不存在，于是 ppt-to-video 是这样断的：抽取结果只有落盘一条出路，而
-模型在 ab-agent 里**没有任何文件读取工具**（``mcp-tools.ts`` 的 ALLOWED_TOOL_NAMES 刻意
-只放行 MCP skill，内置 Read/Bash 全部排除，那是对的——bypassPermissions 下放开读写等于
-把 .env 里的 PRIV_TOKEN 交出去）。模型能看到「完整结果已写入 ./source.pptx.layout.json」，
-然后无论如何也读不到它。2026-09-23 线上那条会话在这里试了 ``web_read file://``，被
-「--url 只接受 http/https」打回，接着整条链路就没有第二条路了。
 
-结论：**layout 数据不该过模型**。它从 ab-render 出来，直接进 DSL，中间不经过上下文。
-这个模块就是那条直连的通道。
 
-环境变量（由 ab-agent 注入，与 doc-parse skill 同一套）：
-  RENDER_API_URL / REMOTION_RENDER_API_URL   ab-render 地址
-  PRIV_TOKEN                                 ab-api 私有 token（端点拒绝匿名调用）
-  CONVERSATION_ID                            留痕用，可选
-"""
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 
 from __future__ import annotations
 
@@ -36,7 +36,7 @@ from typing import Callable, Optional
 
 DEFAULT_RENDER_API_URL = "https://api-render.remixmate.ai"
 
-# 端点是异步任务制：submit 拿 taskId，再轮询 extractStatus。
+
 DEFAULT_MAX_WAIT_SEC = 600
 DEFAULT_POLL_INTERVAL_SEC = 2
 
@@ -44,11 +44,11 @@ SUPPORTED_KINDS = ("pptx",)
 
 
 class DocExtractError(RuntimeError):
-    """抽取失败。
+    pass
+
+
+
 
-    message 直接面向调用方的 stderr —— ab-render 的抽取错误本来就是人话
-    （「不是 zip」「超页数上限」「.ppt 需另存为 .pptx」），再包一层只会让它更远。
-    """
 
 
 def render_api_url() -> str:
@@ -73,7 +73,7 @@ def _api_post(path: str, body: dict, timeout: int = 30) -> dict:
         url, data=json.dumps(body).encode(), headers=headers, method="POST"
     )
     try:
-        with urllib.request.urlopen(req, timeout=timeout) as resp:  # nosec B310 - fixed https base
+        with urllib.request.urlopen(req, timeout=timeout) as resp:
             return json.loads(resp.read())
     except urllib.error.HTTPError as exc:
         detail = exc.read().decode(errors="replace")
@@ -92,11 +92,11 @@ def extract_document(
     poll_interval_sec: int = DEFAULT_POLL_INTERVAL_SEC,
     log: Optional[Callable[[str], None]] = None,
 ) -> dict:
-    """Submit + poll one extraction; return the endpoint's ``result`` dict.
 
-    ``log`` 收到的是进度行，调用方自己决定丢到 stderr 还是丢掉。这里**不直接写
-    stdout** —— doc-parse 的 ``--json-output`` 管道模式要求 stdout 只有那一份 JSON。
-    """
+
+
+
+
     emit = log or (lambda _msg: None)
 
     if not os.environ.get("PRIV_TOKEN"):
@@ -141,7 +141,7 @@ def extract_document(
         try:
             status_resp = _api_post("/extractStatus", {"taskId": task_id})
         except DocExtractError as exc:
-            # 网络抖动不是任务失败：任务还在服务端跑着，重试轮询。
+
             emit(f"[doc-extract] polling error (will retry): {exc}")
             continue
 
@@ -163,11 +163,11 @@ def extract_document(
 
 
 def slides_by_index(result: dict) -> dict[int, dict]:
-    """``slides[]`` 按 1-based ``slideIndex`` 建索引。
 
-    不用列表位置当页号：``--slide N`` 单页抽取时列表只有一项，而它的 slideIndex 是 N。
-    按位置取会把第 7 页当第 1 页用，而且画面看起来"有内容"，没人会发现。
-    """
+
+
+
+
     index: dict[int, dict] = {}
     for position, slide in enumerate(result.get("slides") or [], start=1):
         if not isinstance(slide, dict):
@@ -178,12 +178,12 @@ def slides_by_index(result: dict) -> dict[int, dict]:
 
 
 def summarize(result: dict, out_path: Optional[str] = None) -> str:
-    """人能读的一页纸。
 
-    **这是 doc-parse 存在的一半价值** —— 端点给的是全量结构，决定"喂多少进上下文"
-    是入口层的责任（设计文档 §4.4）。每页一行：页码、档位、拍数、标题、讲稿来源。
-    档位与拍数决定后面怎么写旁白，讲稿来源决定走严格改写还是扩写。
-    """
+
+
+
+
+
     src = result.get("source", {})
     lines = [
         f"共 {src.get('slideCount', '?')} 页，本次抽到 {len(result.get('slides', []))} 页"
@@ -214,7 +214,7 @@ def summarize(result: dict, out_path: Optional[str] = None) -> str:
             lines.append(f"      判定：{s['modeReason']}")
         flags = s.get("flags") or []
         if flags:
-            # flag 是显式的降级记录，不是日志 —— 画面上少一块，这里不说就没人知道为什么。
+
             lines.append(f"      ⚠ 降级：{'; '.join(flags[:3])}")
 
     if out_path: