sophhub 0.4.19 → 0.4.21

package/skills/sophnet-infinite-talk/src/scripts/gen.py

@@ -1,172 +1,172 @@
-#!/usr/bin/env python3
-"""
-Sophnet Infinite Talk (Digital Human) Script
-
-Two-phase workflow:
-  create: submit a task, return task_id
-  query:  poll task status by task_id
-
-Usage:
-  python gen.py create --image-url <url> --audio-url <url> [--prompt <text>]
-  python gen.py query  --task-id <id>
-"""
-import os
-import sys
-import argparse
-import json
-import requests
-from typing import Optional, Any, Dict
-import sophnet_tools
-
-TASK_URL = "https://www.sophnet.com/api/open-apis/projects/easyllms/videogenerator/task"
-DEFAULT_PROMPT = "自信的面对镜头"
-
-
-def _is_url(path: str) -> bool:
-    return path.startswith(("http://", "https://"))
-
-
-def _resolve_to_url(path: str, label: str) -> str:
-    """本地文件上传 OSS 转为 URL；已经是 URL 则直接返回。失败时抛出 ValueError。"""
-    if _is_url(path):
-        return path
-    if not os.path.isfile(path):
-        raise ValueError(f"{label}文件不存在: {path}")
-    url = sophnet_tools.upload_oss(path)
-    if not url:
-        raise ValueError(f"{label}文件上传 OSS 失败: {path}")
-    return url
-
-
-def _headers(api_key: str) -> dict:
-    return {
-        "Authorization": f"Bearer {api_key}",
-        "Content-Type": "application/json",
-    }
-
-
-def create_task(
-    api_key: str, image_url: str, audio_url: str, prompt: str = DEFAULT_PROMPT
-) -> Dict[str, Any]:
-    """提交数字人视频任务，返回 {"task_id": "..."} 或 {"error": "..."}。"""
-    payload = {
-        "model": "InfiniteTalk",
-        "content": [
-            {"type": "text", "text": prompt},
-            {
-                "type": "image_url",
-                "image_url": {"url": image_url},
-                "role": "first_frame",
-            },
-            {"type": "audio_url", "audio_url": audio_url},
-        ],
-    }
-    try:
-        resp = requests.post(
-            TASK_URL, headers=_headers(api_key), json=payload, timeout=60
-        )
-        resp.raise_for_status()
-        task_id = resp.text.strip()
-        if task_id:
-            return {"task_id": task_id}
-        return {"error": f"未能从响应中解析 task_id: {task_id}"}
-    except requests.exceptions.RequestException as e:
-        return {"error": f"HTTP 请求失败: {e}"}
-
-
-def _normalize_video_url(raw: Any) -> Optional[str]:
-    """API 在排队时可能返回字符串 'None'，视为无效。"""
-    if raw is None:
-        return None
-    s = str(raw).strip()
-    return None if s in ("", "None", "none") else s
-
-
-def get_task(api_key: str, task_id: str) -> Dict[str, Any]:
-    """
-    查询任务状态。
-
-    返回:
-      进行中: {"status": "processing", "video_url": null}
-      成功:   {"status": "succeeded", "video_url": "<url>"}
-      失败:   {"status": "failed", "error": "<reason>"}
-    """
-    try:
-        resp = requests.get(
-            f"{TASK_URL}/{task_id}", headers=_headers(api_key), timeout=30
-        )
-        resp.raise_for_status()
-        data = resp.json()
-    except requests.exceptions.RequestException as e:
-        return {"error": f"HTTP 请求失败: {e}"}
-
-    status = (data.get("status") or "").strip()
-    video_url = _normalize_video_url((data.get("content") or {}).get("video_url"))
-
-    if status == "succeeded":
-        if video_url:
-            return {"status": "succeeded", "video_url": video_url}
-        return {"status": "failed", "error": "任务标记为成功但未返回有效视频地址"}
-
-    if "failed" in status.lower():
-        err = (
-            data.get("message")
-            or data.get("error")
-            or (data.get("content") or {}).get("error")
-            or status
-        )
-        return {"status": "failed", "error": str(err)}
-
-    return {"status": status, "video_url": video_url}
-
-
-def _json_out(obj: Dict[str, Any]) -> None:
-    print(json.dumps(obj, ensure_ascii=False))
-
-
-if __name__ == "__main__":
-    api_key = sophnet_tools.get_api_key()
-    if api_key is None:
-        _json_out(
-            {"error": "未找到 Sophnet API Key，请联系客户支持"}
-        )
-        sys.exit(1)
-
-    parser = argparse.ArgumentParser(description="Sophnet Infinite Talk (数字人)")
-    sub = parser.add_subparsers(dest="command", required=True)
-
-    p_create = sub.add_parser("create", help="创建数字人视频任务")
-    p_create.add_argument(
-        "--image-url", required=True, help="人物形象图片 URL 或本地路径"
-    )
-    p_create.add_argument(
-        "--audio-url", required=True, help="驱动音频 URL 或本地路径"
-    )
-    p_create.add_argument(
-        "--prompt",
-        default=DEFAULT_PROMPT,
-        help=f"动作/表情提示词（默认: {DEFAULT_PROMPT}）",
-    )
-
-    p_query = sub.add_parser("query", help="查询数字人任务状态")
-    p_query.add_argument("--task-id", required=True, help="任务 ID")
-
-    args = parser.parse_args()
-
-    if args.command == "create":
-        try:
-            image_url = _resolve_to_url(args.image_url, "图片")
-            audio_url = _resolve_to_url(args.audio_url, "音频")
-        except ValueError as e:
-            _json_out({"error": str(e)})
-            sys.exit(1)
-        result = create_task(api_key, image_url, audio_url, args.prompt)
-        _json_out(result)
-        if "error" in result:
-            sys.exit(1)
-
-    elif args.command == "query":
-        result = get_task(api_key, args.task_id)
-        _json_out(result)
-        if "error" in result:
-            sys.exit(1)
+#!/usr/bin/env python3
+"""
+Sophnet Infinite Talk (Digital Human) Script
+
+Two-phase workflow:
+  create: submit a task, return task_id
+  query:  poll task status by task_id
+
+Usage:
+  python gen.py create --image-url <url> --audio-url <url> [--prompt <text>]
+  python gen.py query  --task-id <id>
+"""
+import os
+import sys
+import argparse
+import json
+import requests
+from typing import Optional, Any, Dict
+import sophnet_tools
+
+TASK_URL = "https://www.sophnet.com/api/open-apis/projects/easyllms/videogenerator/task"
+DEFAULT_PROMPT = "自信的面对镜头"
+
+
+def _is_url(path: str) -> bool:
+    return path.startswith(("http://", "https://"))
+
+
+def _resolve_to_url(path: str, label: str) -> str:
+    """本地文件上传 OSS 转为 URL；已经是 URL 则直接返回。失败时抛出 ValueError。"""
+    if _is_url(path):
+        return path
+    if not os.path.isfile(path):
+        raise ValueError(f"{label}文件不存在: {path}")
+    url = sophnet_tools.upload_oss(path)
+    if not url:
+        raise ValueError(f"{label}文件上传 OSS 失败: {path}")
+    return url
+
+
+def _headers(api_key: str) -> dict:
+    return {
+        "Authorization": f"Bearer {api_key}",
+        "Content-Type": "application/json",
+    }
+
+
+def create_task(
+    api_key: str, image_url: str, audio_url: str, prompt: str = DEFAULT_PROMPT
+) -> Dict[str, Any]:
+    """提交数字人视频任务，返回 {"task_id": "..."} 或 {"error": "..."}。"""
+    payload = {
+        "model": "InfiniteTalk",
+        "content": [
+            {"type": "text", "text": prompt},
+            {
+                "type": "image_url",
+                "image_url": {"url": image_url},
+                "role": "first_frame",
+            },
+            {"type": "audio_url", "audio_url": audio_url},
+        ],
+    }
+    try:
+        resp = requests.post(
+            TASK_URL, headers=_headers(api_key), json=payload, timeout=60
+        )
+        resp.raise_for_status()
+        task_id = resp.text.strip()
+        if task_id:
+            return {"task_id": task_id}
+        return {"error": f"未能从响应中解析 task_id: {task_id}"}
+    except requests.exceptions.RequestException as e:
+        return {"error": f"HTTP 请求失败: {e}"}
+
+
+def _normalize_video_url(raw: Any) -> Optional[str]:
+    """API 在排队时可能返回字符串 'None'，视为无效。"""
+    if raw is None:
+        return None
+    s = str(raw).strip()
+    return None if s in ("", "None", "none") else s
+
+
+def get_task(api_key: str, task_id: str) -> Dict[str, Any]:
+    """
+    查询任务状态。
+
+    返回:
+      进行中: {"status": "processing", "video_url": null}
+      成功:   {"status": "succeeded", "video_url": "<url>"}
+      失败:   {"status": "failed", "error": "<reason>"}
+    """
+    try:
+        resp = requests.get(
+            f"{TASK_URL}/{task_id}", headers=_headers(api_key), timeout=30
+        )
+        resp.raise_for_status()
+        data = resp.json()
+    except requests.exceptions.RequestException as e:
+        return {"error": f"HTTP 请求失败: {e}"}
+
+    status = (data.get("status") or "").strip()
+    video_url = _normalize_video_url((data.get("content") or {}).get("video_url"))
+
+    if status == "succeeded":
+        if video_url:
+            return {"status": "succeeded", "video_url": video_url}
+        return {"status": "failed", "error": "任务标记为成功但未返回有效视频地址"}
+
+    if "failed" in status.lower():
+        err = (
+            data.get("message")
+            or data.get("error")
+            or (data.get("content") or {}).get("error")
+            or status
+        )
+        return {"status": "failed", "error": str(err)}
+
+    return {"status": status, "video_url": video_url}
+
+
+def _json_out(obj: Dict[str, Any]) -> None:
+    print(json.dumps(obj, ensure_ascii=False))
+
+
+if __name__ == "__main__":
+    api_key = sophnet_tools.get_api_key()
+    if api_key is None:
+        _json_out(
+            {"error": "未找到 Sophnet API Key，请联系客户支持"}
+        )
+        sys.exit(1)
+
+    parser = argparse.ArgumentParser(description="Sophnet Infinite Talk (数字人)")
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    p_create = sub.add_parser("create", help="创建数字人视频任务")
+    p_create.add_argument(
+        "--image-url", required=True, help="人物形象图片 URL 或本地路径"
+    )
+    p_create.add_argument(
+        "--audio-url", required=True, help="驱动音频 URL 或本地路径"
+    )
+    p_create.add_argument(
+        "--prompt",
+        default=DEFAULT_PROMPT,
+        help=f"动作/表情提示词（默认: {DEFAULT_PROMPT}）",
+    )
+
+    p_query = sub.add_parser("query", help="查询数字人任务状态")
+    p_query.add_argument("--task-id", required=True, help="任务 ID")
+
+    args = parser.parse_args()
+
+    if args.command == "create":
+        try:
+            image_url = _resolve_to_url(args.image_url, "图片")
+            audio_url = _resolve_to_url(args.audio_url, "音频")
+        except ValueError as e:
+            _json_out({"error": str(e)})
+            sys.exit(1)
+        result = create_task(api_key, image_url, audio_url, args.prompt)
+        _json_out(result)
+        if "error" in result:
+            sys.exit(1)
+
+    elif args.command == "query":
+        result = get_task(api_key, args.task_id)
+        _json_out(result)
+        if "error" in result:
+            sys.exit(1)

package/skills/sophnet-oss/skill.json

@@ -1,27 +1,27 @@
-{
-  "name": "sophnet-oss",
-  "version": "1.1.0",
-  "types": [
-    "builtin"
-  ],
-  "displayName": "OSS链接生成",
-  "description": "将文件转换为一个可供下载的文件链接",
-  "changelog": [
-    {
-      "changes": [
-        "补充签名下载链接必须完整保留查询参数的使用约束"
-      ],
-      "date": "2026-05-13",
-      "version": "1.1.0"
-    },
-    {
-      "changes": [
-        "初次提交"
-      ],
-      "date": "2026-04-09",
-      "version": "1.0.0"
-    }
-  ],
-  "createdAt": "2026-04-09",
-  "updatedAt": "2026-05-13"
-}
+{
+  "name": "sophnet-oss",
+  "version": "1.1.0",
+  "types": [
+    "builtin"
+  ],
+  "displayName": "OSS链接生成",
+  "description": "将文件转换为一个可供下载的文件链接",
+  "changelog": [
+    {
+      "changes": [
+        "补充签名下载链接必须完整保留查询参数的使用约束"
+      ],
+      "date": "2026-05-13",
+      "version": "1.1.0"
+    },
+    {
+      "changes": [
+        "初次提交"
+      ],
+      "date": "2026-04-09",
+      "version": "1.0.0"
+    }
+  ],
+  "createdAt": "2026-04-09",
+  "updatedAt": "2026-05-13"
+}

package/skills/sophnet-oss/src/SKILL.md

@@ -1,118 +1,118 @@
----
-name: sophnet-oss
-description: Convert a local file path to a downloadable URL (valid for 24 hours). Use when users want to turn a file path into a shareable link, get a URL for a file, or need a temporary URL to access a local file.
----
-
-# File Path to URL
-
-将本地文件路径转换为可访问的下载 URL，链接有效期为 24 小时。
-
-## Signed URL（签名链接）完整性
-
-`DOWNLOAD_URL` 由 OSS **预签名**生成，**查询串（`?` 及之后的参数）即访问凭证**。在本次 skill 的全流程中：
-
-- **必须**使用脚本输出的 `DOWNLOAD_URL` **完整字符串**（一字不改）填入下文展示模板中的下载链接，或原样写入下游。
-- **禁止**去掉 `?` 及后续查询参数、禁止截取签名片段、禁止尝试「换成更短的裸 URL」或做任何 URL「美化」。
-- 若裸域名路径在无签名时可访问，那是偶然行为；本 skill **不以裸链为准**，仅以脚本输出的带签名 URL 为准。
-- 向用户展示时沿用下文「转换成功后」的固定格式即可；**不要改模板结构**，只保证链接内容为完整签名 URL。
-
-## Processing Mode
-
-**STRICT SERIAL PROCESSING ONLY** - This skill must execute in a single, sequential operation:
-
-- **NO sub-tasks** - Never spawn background sessions or use sessions_spawn
-- **NO task splitting** - Complete the conversion in one continuous run
-- **NO parallel execution** - Convert one file at a time
-
-## Prerequisites
-
-- Python packages: sophnet-tools
-
-## Usage
-
-When a user wants to convert a file path to a URL:
-
-1. **Extract file path** from user input or recent logs (see Path Extraction below).
-2. **Run the script** using uv from workspace or skill directory:
-
-```bash
-uv run --with sophnet-tools \
-  python {baseDir}/scripts/upload_file.py \
-  --file /absolute/path/to/file \
-  --timeout 120
-```
-
-## Parameters
-
-- `--file`: 要转换为 URL 的本地文件路径（必填）
-- `--timeout`: 请求超时秒数（默认 120，大文件可适当增大）
-
-## Output
-
-The script outputs structured key-value pairs:
-
-```
-FILE_PATH=/absolute/path/to/file
-UPLOAD_STATUS=uploaded
-DOWNLOAD_URL=https://...signed-url...
-```
-
-On failure:
-
-```
-FILE_PATH=/absolute/path/to/file
-UPLOAD_STATUS=failed
-ERROR=error description
-```
-
-**转换成功后，向用户展示为：**
-
-```
-文件路径已转换为可访问链接：
-
-文件路径：/absolute/path/to/file
-下载链接：https://...signed-url...
-
-⏰ 链接有效期：24小时
-```
-
-## Path Extraction
-
-When users provide files through chat, look for log patterns like:
-
-```
-Resolved relative path: "media/inbound/images/xxx.pdf" -> "/absolute/path/to/workspace/media/inbound/images/xxx.pdf"
-```
-
-Extract the absolute path (right side of `->`) for use with the script.
-
-对于用户提供或引用的文件，优先从上述日志中取解析后的绝对路径，再传入脚本做路径转 URL。
-
-## Example Workflow
-
-User: "把这个文件转成链接" / "给我这个文件的 URL"
-
-1. Extract file path from logs (pattern: `Resolved relative path: "..." -> "/absolute/..."`) or user input
-2. Run: `uv run --with sophnet-tools python {baseDir}/scripts/upload_file.py --file /absolute/path/to/file --timeout 120`
-3. Parse the output and display the URL to the user
-
-## Notes
-
-- 返回的 URL 有效期为 **24 小时**
-- 任意类型文件均可转换（无扩展名限制）
-- 大文件可增大 `--timeout`（默认 120 秒）
-- 始终使用绝对路径以保证可靠
-
-## ⚠️ FORBIDDEN OPERATIONS
-
-**Do NOT:**
-
-- Spawn sub-agent sessions (sessions_spawn)
-- Run multiple parallel conversions
-- Split the task into separate operations
-- Use background processes
-
-**ONLY:**
-
-- Run the script once with the file path
-- Return the URL to the user in a single response
+---
+name: sophnet-oss
+description: Convert a local file path to a downloadable URL (valid for 24 hours). Use when users want to turn a file path into a shareable link, get a URL for a file, or need a temporary URL to access a local file.
+---
+
+# File Path to URL
+
+将本地文件路径转换为可访问的下载 URL，链接有效期为 24 小时。
+
+## Signed URL（签名链接）完整性
+
+`DOWNLOAD_URL` 由 OSS **预签名**生成，**查询串（`?` 及之后的参数）即访问凭证**。在本次 skill 的全流程中：
+
+- **必须**使用脚本输出的 `DOWNLOAD_URL` **完整字符串**（一字不改）填入下文展示模板中的下载链接，或原样写入下游。
+- **禁止**去掉 `?` 及后续查询参数、禁止截取签名片段、禁止尝试「换成更短的裸 URL」或做任何 URL「美化」。
+- 若裸域名路径在无签名时可访问，那是偶然行为；本 skill **不以裸链为准**，仅以脚本输出的带签名 URL 为准。
+- 向用户展示时沿用下文「转换成功后」的固定格式即可；**不要改模板结构**，只保证链接内容为完整签名 URL。
+
+## Processing Mode
+
+**STRICT SERIAL PROCESSING ONLY** - This skill must execute in a single, sequential operation:
+
+- **NO sub-tasks** - Never spawn background sessions or use sessions_spawn
+- **NO task splitting** - Complete the conversion in one continuous run
+- **NO parallel execution** - Convert one file at a time
+
+## Prerequisites
+
+- Python packages: sophnet-tools
+
+## Usage
+
+When a user wants to convert a file path to a URL:
+
+1. **Extract file path** from user input or recent logs (see Path Extraction below).
+2. **Run the script** using uv from workspace or skill directory:
+
+```bash
+uv run --with sophnet-tools \
+  python {baseDir}/scripts/upload_file.py \
+  --file /absolute/path/to/file \
+  --timeout 120
+```
+
+## Parameters
+
+- `--file`: 要转换为 URL 的本地文件路径（必填）
+- `--timeout`: 请求超时秒数（默认 120，大文件可适当增大）
+
+## Output
+
+The script outputs structured key-value pairs:
+
+```
+FILE_PATH=/absolute/path/to/file
+UPLOAD_STATUS=uploaded
+DOWNLOAD_URL=https://...signed-url...
+```
+
+On failure:
+
+```
+FILE_PATH=/absolute/path/to/file
+UPLOAD_STATUS=failed
+ERROR=error description
+```
+
+**转换成功后，向用户展示为：**
+
+```
+文件路径已转换为可访问链接：
+
+文件路径：/absolute/path/to/file
+下载链接：https://...signed-url...
+
+⏰ 链接有效期：24小时
+```
+
+## Path Extraction
+
+When users provide files through chat, look for log patterns like:
+
+```
+Resolved relative path: "media/inbound/images/xxx.pdf" -> "/absolute/path/to/workspace/media/inbound/images/xxx.pdf"
+```
+
+Extract the absolute path (right side of `->`) for use with the script.
+
+对于用户提供或引用的文件，优先从上述日志中取解析后的绝对路径，再传入脚本做路径转 URL。
+
+## Example Workflow
+
+User: "把这个文件转成链接" / "给我这个文件的 URL"
+
+1. Extract file path from logs (pattern: `Resolved relative path: "..." -> "/absolute/..."`) or user input
+2. Run: `uv run --with sophnet-tools python {baseDir}/scripts/upload_file.py --file /absolute/path/to/file --timeout 120`
+3. Parse the output and display the URL to the user
+
+## Notes
+
+- 返回的 URL 有效期为 **24 小时**
+- 任意类型文件均可转换（无扩展名限制）
+- 大文件可增大 `--timeout`（默认 120 秒）
+- 始终使用绝对路径以保证可靠
+
+## ⚠️ FORBIDDEN OPERATIONS
+
+**Do NOT:**
+
+- Spawn sub-agent sessions (sessions_spawn)
+- Run multiple parallel conversions
+- Split the task into separate operations
+- Use background processes
+
+**ONLY:**
+
+- Run the script once with the file path
+- Return the URL to the user in a single response

package/skills/sophnet-oss/src/pyproject.toml

@@ -1,8 +1,8 @@
-[project]
-name = "sophnet-oss"
-version = "0.1.0"
-description = "Skill-local runtime dependencies for sophnet-oss"
-requires-python = ">=3.10"
-dependencies = [
-  "sophnet-tools>=0.0.1",
-]
+[project]
+name = "sophnet-oss"
+version = "0.1.0"
+description = "Skill-local runtime dependencies for sophnet-oss"
+requires-python = ">=3.10"
+dependencies = [
+  "sophnet-tools>=0.0.1",
+]