sophhub 0.4.40 → 0.4.42

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sophhub",
-  "version": "0.4.40",
+  "version": "0.4.42",
   "description": "SophHub CLI - Manage and download AI Agent skills and agents",
   "type": "module",
   "bin": {

package/skills/image-description/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "image-description",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "types": [
     "store"
   ],
   "displayName": "图片描述",
   "description": "生成图片描述",
   "changelog": [
+    {
+      "changes": [
+        "ana_image.py：HTTP 200 但无法提取非空 content 时 stderr 报错并 exit 1，移除 json.dumps fallback"
+      ],
+      "date": "2026-06-10",
+      "version": "1.0.3"
+    },
     {
       "changes": [
         "SKILL：补充何时使用、输出契约与注意事项；脚本：异常输出至 stderr、非零退出，错误文案补充 data URL"
@@ -30,5 +37,5 @@
     }
   ],
   "createdAt": "2026-04-21",
-  "updatedAt": "2026-05-14"
+  "updatedAt": "2026-06-10"
 }

package/skills/image-description/src/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "image-description"
-version = "1.0.2"
+version = "1.0.3"
 description = "Generate image descriptions with Sophnet via chat/completions"
 requires-python = ">=3.10"
 dependencies = [

package/skills/image-description/src/scripts/ana_image.py

@@ -88,10 +88,36 @@ def call_vlm(image_input: str) -> str:
     except urllib.error.URLError as exc:
         raise RuntimeError(f"URLError: {exc.reason}") from exc
 
-    try:
-        return data["choices"][0]["message"]["content"]
-    except (KeyError, IndexError, TypeError):
-        return json.dumps(data, ensure_ascii=False, indent=2)
+    return _extract_description(data)
+
+
+def _extract_description(data: dict) -> str:
+    error = data.get("error")
+    if isinstance(error, dict):
+        message = error.get("message")
+        if isinstance(message, str) and message.strip():
+            raise RuntimeError(f"图片描述失败：API 返回错误：{message.strip()}")
+        raise RuntimeError(
+            f"图片描述失败：API 返回错误：{json.dumps(error, ensure_ascii=False)}"
+        )
+
+    choices = data.get("choices")
+    if not isinstance(choices, list) or not choices:
+        raise RuntimeError("图片描述失败：模型未返回 choices")
+
+    first = choices[0]
+    if not isinstance(first, dict):
+        raise RuntimeError("图片描述失败：choices[0] 格式异常")
+
+    message = first.get("message")
+    if not isinstance(message, dict):
+        raise RuntimeError("图片描述失败：响应中缺少 message")
+
+    content = message.get("content")
+    if not isinstance(content, str) or not content.strip():
+        raise RuntimeError("图片描述失败：模型返回空描述")
+
+    return content.strip()
 
 
 def build_parser():

package/skills/sophnet-oss/skill.json

@@ -1,12 +1,23 @@
 {
   "name": "sophnet-oss",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "types": [
     "builtin"
   ],
   "displayName": "OSS链接生成",
   "description": "将文件转换为一个可供下载的文件链接",
   "changelog": [
+    {
+      "changes": [
+        "SKILL.md 全文中文化，精简 description 为中文「功能+触发场景」格式",
+        "Signed URL 章节新增 credential 日期不可修改、禁止重复参数约束",
+        "合并 Processing Mode 与禁止操作章节，输出模板固定化防止 LLM 篡改链接",
+        "新增 design.md 设计文档，含架构流程图和职责划分表",
+        "修复 pyproject.toml 版本号与 skill.json 同步"
+      ],
+      "date": "2026-06-09",
+      "version": "1.1.1"
+    },
     {
       "changes": [
         "补充签名下载链接必须完整保留查询参数的使用约束"
@@ -23,5 +34,5 @@
     }
   ],
   "createdAt": "2026-04-09",
-  "updatedAt": "2026-05-13"
+  "updatedAt": "2026-06-09"
 }

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

@@ -1,6 +1,6 @@
 ---
 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.
+description: 将本地文件路径转换为可下载链接（24小时有效）。当用户要求把文件转成链接、获取文件URL、分享文件时使用。
 ---
 
 # File Path to URL
@@ -13,32 +13,23 @@ description: Convert a local file path to a downloadable URL (valid for 24 hours
 
 - **必须**使用脚本输出的 `DOWNLOAD_URL` **完整字符串**（一字不改）填入下文展示模板中的下载链接，或原样写入下游。
 - **禁止**去掉 `?` 及后续查询参数、禁止截取签名片段、禁止尝试「换成更短的裸 URL」或做任何 URL「美化」。
-- 签名 URL 的参数中，**`x-oss-signature-version` 和 `x-oss-credential` 不可省略**，分别为签名算法的版本标识和访问凭证标识，缺失任一参数均会导致签名校验失败。
+- 签名 URL 的参数中，**`x-oss-signature-version` 和 `x-oss-credential` 不可省略**，分别为签名算法的版本标识和访问凭证标识，缺失任一参数均会导致签名校验失败。**`x-oss-credential` 内嵌的日期不可修改**，禁止插入重复的 credential 参数。
 - 若裸域名路径在无签名时可访问，那是偶然行为；本 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
+- Python 包：`sophnet-tools`（需预先安装在系统 Python 环境中）
 
 ## Usage
 
-When a user wants to convert a file path to a URL:
+当用户要求将文件路径转换为 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:
+1. **提取文件路径**：从用户输入或日志中提取（见下文「路径提取」）。
+2. **运行脚本**：
 
 ```bash
-uv run --with sophnet-tools \
-  python {baseDir}/scripts/upload_file.py \
+python3 {baseDir}/scripts/upload_file.py \
   --file /absolute/path/to/file \
   --timeout 120
 ```
@@ -48,72 +39,66 @@ uv run --with sophnet-tools \
 - `--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
+ERROR=错误描述
 ```
 
-**转换成功后，向用户展示为：**
+**转换成功后，向用户展示为（固定模板，不可修改结构）：**
 
 ```
 文件路径已转换为可访问链接：
 
 文件路径：/absolute/path/to/file
-下载链接：https://...signed-url...
+下载链接：<完整 DOWNLOAD_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
+用户："把这个文件转成链接" / "给我这个文件的 URL"
 
-User: "把这个文件转成链接" / "给我这个文件的 URL"
+1. 从日志 pattern（`Resolved relative path: "..." -> "/absolute/..."`）或用户输入提取文件路径
+2. 执行：`python3 {baseDir}/scripts/upload_file.py --file /absolute/path/to/file --timeout 120`
+3. 解析输出，按固定模板向用户展示下载链接
 
-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 秒）
 - 始终使用绝对路径以保证可靠
+- **严格串行执行**：禁止并发、禁止拆分子任务、禁止后台运行，一次只转换一个文件
+- **不修改签名 URL**：`DOWNLOAD_URL` 必须原样使用，不截取、不"美化"、不修改任何参数
 
-## ⚠️ 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
+- 禁止派生子会话（sessions_spawn）
+- 禁止并发转换多个文件
+- 禁止将任务拆分为多个步骤
+- 禁止使用后台进程
+- 禁止修改 `DOWNLOAD_URL` 中的任何字符（含查询参数）

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

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