sophhub 0.4.43 → 0.4.45

package/package.json

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

package/skills/claw-agent-get-send/skill.json

@@ -1,10 +1,21 @@
 {
   "name": "claw-agent-get-send",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "types": ["store"],
   "displayName": "Claw Agent Get/Send",
   "description": "Appia（IM 即时通讯）侧 claw.agent.groups.get / claw.agent.message.send：查询机器人在哪些群聊、向群发纯文本或 Markdown；脚本封装 + HTTP/curl 参考（JWT、msg/md、错误码）",
   "changelog": [
+    {
+      "version": "1.1.0",
+      "date": "2026-06-16",
+      "changes": [
+        "appia_claw.py：新增 upload 子命令（POST agent.file.upload，multipart/form-data）",
+        "appia_claw.py：send 子命令新增 --file-ids 参数，支持上传后带附件发送",
+        "reference-http.md：新增 agent.file.upload、agent.message.send fileIds 章节",
+        "SKILL.md：新增 upload、send --file-ids 用法示例",
+        "design.md：新增 upload 子命令说明与测试用例 TC-032–TC-039"
+      ]
+    },
     {
       "version": "1.0.1",
       "date": "2026-05-09",
@@ -28,5 +39,5 @@
     }
   ],
   "createdAt": "2026-04-28",
-  "updatedAt": "2026-05-09"
+  "updatedAt": "2026-06-16"
 }

package/skills/claw-agent-get-send/src/SKILL.md

@@ -32,6 +32,12 @@ uv run {baseDir}/scripts/appia_claw.py --cred-file /path/to.cred.json send-md --
 
 # 7. 从 JSON 文件读 md 数组
 uv run {baseDir}/scripts/appia_claw.py --cred-file /path/to.cred.json send-md --md-file /tmp/md.json --rid "<rid>"
+
+# 8. 上传文件到群聊（不发消息，返回 file._id）
+uv run {baseDir}/scripts/appia_claw.py --cred-file /path/to.cred.json upload report.pdf --rid "<rid>"
+
+# 9. 上传后带附件发消息（两步：先 upload 拿 _id，再 send 带 --file-ids）
+uv run {baseDir}/scripts/appia_claw.py --cred-file /path/to.cred.json send --text "请查收附件" --rid "<rid>" --file-ids "<file._id>"
 ```
 
 不用凭证文件时，可在环境中设置 `CLAW_JWT`、`APP_AGENT_ID`、`CLAW_USER_ID`（及场景需要的 `TARGET_RID` 等），命令相同，省略 `--cred-file …` 即可。

package/skills/claw-agent-get-send/src/scripts/appia_claw.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Appia Claw HTTP API: agent.groups.get, agent.message.send (plaintext + md + chunking)."""
+"""Appia Claw HTTP API: agent.groups.get, agent.message.send (plaintext + md + chunking), agent.file.upload."""
 
 from __future__ import annotations
 
@@ -217,8 +217,8 @@ def _send_request(body_obj: dict[str, Any], timeout: float) -> dict[str, Any]:
     return data
 
 
-def _send_plain(rid: str, msg: str, timeout: float) -> dict[str, Any]:
-    """发送纯文本消息。"""
+def _send_plain(rid: str, msg: str, timeout: float, file_ids: list[str] | None = None) -> dict[str, Any]:
+    """发送纯文本消息，可选附带已上传的文件（fileIds）。"""
     aid = _agent_id()
     body_obj: dict[str, Any] = {
         "rid": rid,
@@ -226,6 +226,8 @@ def _send_plain(rid: str, msg: str, timeout: float) -> dict[str, Any]:
         "userId": _user_id(),
         "msg": msg,
     }
+    if file_ids:
+        body_obj["fileIds"] = file_ids
     return _send_request(body_obj, timeout)
 
 
@@ -241,6 +243,63 @@ def _send_md(rid: str, md: list[dict[str, Any]], timeout: float) -> dict[str, An
     return _send_request(body_obj, timeout)
 
 
+def _file_upload(rid: str, file_path: str, timeout: float) -> dict[str, Any]:
+    """上传文件到 Appia 群聊（不发消息），返回 file._id。"""
+    import mimetypes as _mimetypes
+
+    base = _base_url()
+    url = f"{base}/api/v1/claw/agent.file.upload"
+    fpath = os.path.expanduser(file_path)
+    fname = os.path.basename(fpath)
+    mime_type, _ = _mimetypes.guess_type(fpath)
+    if not mime_type:
+        mime_type = "application/octet-stream"
+
+    boundary = "----ClawUploadBoundary" + os.urandom(16).hex()
+    body_parts: list[bytes] = []
+    for field_name, value in (
+        ("userId", _user_id()),
+        ("agentId", _agent_id()),
+        ("rid", rid),
+    ):
+        body_parts.append(f"--{boundary}\r\n".encode())
+        body_parts.append(
+            f'Content-Disposition: form-data; name="{field_name}"\r\n\r\n'.encode()
+        )
+        body_parts.append(f"{value}\r\n".encode())
+
+    body_parts.append(f"--{boundary}\r\n".encode())
+    body_parts.append(
+        f'Content-Disposition: form-data; name="file"; filename="{fname}"\r\n'.encode()
+    )
+    body_parts.append(f"Content-Type: {mime_type}\r\n\r\n".encode())
+    with open(fpath, "rb") as fh:
+        body_parts.append(fh.read())
+    body_parts.append(f"\r\n--{boundary}--\r\n".encode())
+    body = b"".join(body_parts)
+
+    req = request.Request(
+        url,
+        data=body,
+        headers={
+            "Authorization": f"Bearer {_jwt()}",
+            "Content-Type": f"multipart/form-data; boundary={boundary}",
+            "Accept": "application/json",
+        },
+        method="POST",
+    )
+    try:
+        with request.urlopen(req, timeout=timeout) as resp:
+            out = resp.read().decode("utf-8")
+    except error.HTTPError as exc:
+        out = exc.read().decode("utf-8", errors="replace")
+        raise RuntimeError(f"HTTP {exc.code}: {out}") from exc
+    data = json.loads(out)
+    if not data.get("success"):
+        raise RuntimeError(json.dumps(data, ensure_ascii=False))
+    return data
+
+
 def _chunk_text(text: str, size: int) -> list[str]:
     if size <= 0:
         return [text]
@@ -265,11 +324,15 @@ def cmd_send(args: argparse.Namespace) -> int:
     else:
         print("⚠️ 需要 --file 或 --text", file=sys.stderr)
         return 1
+    file_ids: list[str] = []
+    if args.file_ids:
+        for item in args.file_ids:
+            file_ids.extend(fid.strip() for fid in item.split(",") if fid.strip())
     chunk_raw = _cfg("APPIA_MSG_CHUNK_SIZE")
     chunk_size = int(chunk_raw) if chunk_raw else DEFAULT_CHUNK_SIZE
     parts = _chunk_text(text, chunk_size)
     for idx, part in enumerate(parts):
-        data = _send_plain(rid, part, args.timeout)
+        data = _send_plain(rid, part, args.timeout, file_ids=file_ids if file_ids else None)
         if args.json:
             print(json.dumps(data, ensure_ascii=False, indent=2))
         elif len(parts) > 1:
@@ -328,6 +391,21 @@ def cmd_send_md(args: argparse.Namespace) -> int:
     return 0
 
 
+def cmd_upload(args: argparse.Namespace) -> int:
+    """上传文件到群聊（不发消息），返回 file._id 供 send 的 --file-ids 使用。"""
+    rid = args.rid or _cfg("TARGET_RID")
+    if not rid:
+        print("⚠️ upload 需要 TARGET_RID 或 --rid", file=sys.stderr)
+        return 1
+    data = _file_upload(rid, args.file, args.timeout)
+    if args.json:
+        print(json.dumps(data, ensure_ascii=False, indent=2))
+    else:
+        finfo = data.get("data", {}).get("file", {})
+        print(f"file._id={finfo.get('_id')}  name={finfo.get('name')}  size={finfo.get('size')}  type={finfo.get('type')}")
+    return 0
+
+
 def main() -> int:
     global _CRED
     p = argparse.ArgumentParser(description="Appia Claw (groups.get / message.send)")
@@ -347,10 +425,11 @@ def main() -> int:
     vp = sub.add_parser("verify-target", help="校验 TARGET_RID + TARGET_GROUP_NAME")
     vp.set_defaults(_run=cmd_verify_target)
 
-    sp = sub.add_parser("send", help="POST agent.message.send（纯文本 msg；超出 APPIA_MSG_CHUNK_SIZE 则分多条）")
+    sp = sub.add_parser("send", help="POST agent.message.send（纯文本 msg；超出 APPIA_MSG_CHUNK_SIZE 则分多条；可带 --file-ids 附件）")
     sp.add_argument("--file", "-f", help="长文本文件")
     sp.add_argument("--text", "-t", help="短文本")
     sp.add_argument("--rid", help="覆盖 TARGET_RID")
+    sp.add_argument("--file-ids", nargs="*", help="已上传文件的 _id，多个可用逗号分隔或重复传参")
     sp.add_argument("--json", action="store_true")
     sp.set_defaults(_run=cmd_send)
 
@@ -362,6 +441,12 @@ def main() -> int:
     smp.add_argument("--json", action="store_true")
     smp.set_defaults(_run=cmd_send_md)
 
+    up = sub.add_parser("upload", help="POST agent.file.upload（上传附件到群聊，返回 file._id）")
+    up.add_argument("file", help="待上传的文件路径")
+    up.add_argument("--rid", help="覆盖 TARGET_RID")
+    up.add_argument("--json", action="store_true")
+    up.set_defaults(_run=cmd_upload)
+
     args = p.parse_args()
     if args.cred_file:
         _CRED = load_cred_file(args.cred_file)

package/skills/image-classify/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "image-classify",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "types": [
     "store"
   ],
   "displayName": "照片分类器",
   "description": "照片分类器：注册人脸、按人搜索/一键分类相册。当用户说用照片分类器查找或搜索某人、对文件夹分类、添加/删除照片分类器用户时使用。",
   "changelog": [
+    {
+      "version": "1.0.7",
+      "date": "2026-06-17",
+      "changes": [
+        "升级 sophnet-tools 依赖版本 >=0.0.1 → >=0.0.2"
+      ]
+    },
     {
       "version": "1.0.6",
       "date": "2026-05-20",
@@ -59,5 +66,5 @@
     }
   ],
   "createdAt": "2026-04-10",
-  "updatedAt": "2026-05-19"
+  "updatedAt": "2026-06-17"
 }

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

@@ -1,11 +1,11 @@
 [project]
 name = "image-classify"
-version = "1.0.6"
+version = "1.0.7"
 description = "Photo classifier by face embedding similarity"
 requires-python = ">=3.10"
 dependencies = [
     "opencv-python-headless>=4.8.0",
     "numpy>=1.24.0",
     "requests>=2.28.0",
-    "sophnet-tools>=0.0.1",
+    "sophnet-tools>=0.0.2",
 ]

package/skills/image-description/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "image-description",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "types": [
     "store"
   ],
   "displayName": "图片描述",
   "description": "生成图片描述",
   "changelog": [
+    {
+      "version": "1.0.4",
+      "date": "2026-06-17",
+      "changes": [
+        "升级 sophnet-tools 依赖版本 >=0.0.1 → >=0.0.2"
+      ]
+    },
     {
       "changes": [
         "ana_image.py：HTTP 200 但无法提取非空 content 时 stderr 报错并 exit 1，移除 json.dumps fallback"
@@ -37,5 +44,5 @@
     }
   ],
   "createdAt": "2026-04-21",
-  "updatedAt": "2026-06-10"
+  "updatedAt": "2026-06-17"
 }

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

@@ -1,8 +1,8 @@
 [project]
 name = "image-description"
-version = "1.0.3"
+version = "1.0.4"
 description = "Generate image descriptions with Sophnet via chat/completions"
 requires-python = ">=3.10"
 dependencies = [
-    "sophnet-tools>=0.0.1",
+    "sophnet-tools>=0.0.2",
 ]

package/skills/image-identify-world/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "image-identify-world",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "types": [
     "store"
   ],
   "displayName": "识万物",
   "description": "图像主体识别与科普说明，专业审慎地描述可能名称、特征、分布习性、安全提醒和不确定性。",
   "changelog": [
+    {
+      "version": "1.0.1",
+      "date": "2026-06-17",
+      "changes": [
+        "升级 sophnet-tools 依赖版本 >=0.0.1 → >=0.0.2"
+      ]
+    },
     {
       "changes": [
         "初次提交：VLM 识图 + 结构化百科输出"
@@ -16,5 +23,5 @@
     }
   ],
   "createdAt": "2026-05-13",
-  "updatedAt": "2026-05-13"
+  "updatedAt": "2026-06-17"
 }

package/skills/image-identify-world/src/pyproject.toml

@@ -1,8 +1,8 @@
 [project]
 name = "image-identify-world"
-version = "1.0.0"
+version = "1.0.1"
 description = "Identify image subjects with cautious explanatory detail via Sophnet VLM"
 requires-python = ">=3.10"
 dependencies = [
-    "sophnet-tools>=0.0.1",
+    "sophnet-tools>=0.0.2",
 ]

package/skills/online-bug-report/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "online-bug-report",
-  "version": "1.0.10",
+  "version": "1.0.11",
   "types": [
     "store"
   ],
   "displayName": "在线提Bug",
   "description": "当用户说「在线提交bug」时，收集问题描述并通过虾友 DM 提交工单。",
   "changelog": [
+    {
+      "version": "1.0.11",
+      "date": "2026-06-17",
+      "changes": [
+        "升级 sophnet-tools 依赖版本 >=0.0.1 → >=0.0.2"
+      ]
+    },
     {
       "changes": [
         "evals 断言改为引擎可识别的 contains/不包含 规则",
@@ -98,5 +105,5 @@
     }
   ],
   "createdAt": "2026-05-18",
-  "updatedAt": "2026-06-01"
+  "updatedAt": "2026-06-17"
 }

package/skills/online-bug-report/src/pyproject.toml

@@ -5,7 +5,7 @@ description = "Send VIP online bug reports to a Sophclaw friend via IM"
 requires-python = ">=3.8"
 dependencies = [
     "requests>=2.28.0",
-    "sophnet-tools>=0.0.1",
+    "sophnet-tools>=0.0.2",
 ]
 
 [[tool.uv.index]]

package/skills/sophnet-age-appearance/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "sophnet-age-appearance",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "types": [
     "store"
   ],
   "displayName": "年龄相貌模拟",
   "description": "仅支持单张人物图：用 AI 模拟指定年龄的长相（幼年、青少年或成年以后等推演）。用户问「10 岁 / 20 岁长什么样」「变老变年轻」「年龄推演」「小时候或以后样子」并希望出图时使用；多图需分次调用。",
   "changelog": [
+    {
+      "version": "1.0.1",
+      "date": "2026-06-17",
+      "changes": [
+        "升级 sophnet-tools 依赖版本 >=0.0.1 → >=0.0.2"
+      ]
+    },
     {
       "changes": [
         "初版：单人参考图；支持单个或多个目标年龄；输出 IMAGE_URL"
@@ -16,5 +23,5 @@
     }
   ],
   "createdAt": "2026-05-13",
-  "updatedAt": "2026-05-13"
+  "updatedAt": "2026-06-17"
 }

package/skills/sophnet-age-appearance/src/pyproject.toml

@@ -1,10 +1,10 @@
 [project]
 name = "sophnet-age-appearance"
-version = "1.0.0"
+version = "1.0.1"
 description = "Sophnet portrait age-appearance simulation via image-edit"
 requires-python = ">=3.10"
 dependencies = [
     "requests>=2.28.0",
-    "sophnet-tools>=0.0.1",
+    "sophnet-tools>=0.0.2",
     "pillow>=9.5.0",
 ]

package/skills/sophnet-customized-marketing/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "sophnet-customized-marketing",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "types": [
     "builtin"
   ],
   "displayName": "个性化营销助手",
   "description": "个性化营销助手：为中小商户策划营销活动，生成贴合业务的营销文案、宣传图片、海报、卡片和其他营销视觉物料，支持多渠道分发与老板风格定制。",
   "changelog": [
+    {
+      "version": "1.0.2",
+      "date": "2026-06-17",
+      "changes": [
+        "升级 sophnet-tools 依赖版本 >=0.0.1 → >=0.0.2"
+      ]
+    },
     {
       "version": "1.0.1",
       "date": "2026-04-10",
@@ -24,5 +31,5 @@
     }
   ],
   "createdAt": "2026-04-09",
-  "updatedAt": "2026-04-10"
+  "updatedAt": "2026-06-17"
 }

package/skills/sophnet-customized-marketing/src/pyproject.toml

@@ -5,5 +5,5 @@ description = "Personalized marketing content generation for small business owne
 requires-python = ">=3.10"
 dependencies = [
     "requests>=2.28.0",
-    "sophnet-tools>=0.0.1",
+    "sophnet-tools>=0.0.2",
 ]

package/skills/sophnet-docx/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "sophnet-docx",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "types": [
     "builtin"
   ],
   "displayName": "",
   "description": "",
   "changelog": [
+    {
+      "version": "1.1.1",
+      "date": "2026-06-17",
+      "changes": [
+        "升级 sophnet-tools 依赖版本 >=0.0.1 → >=0.0.2"
+      ]
+    },
     {
       "version": "1.1.0",
       "date": "2026-06-08",
@@ -29,5 +36,5 @@
     }
   ],
   "createdAt": "2026-04-14",
-  "updatedAt": "2026-06-08"
+  "updatedAt": "2026-06-17"
 }

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

@@ -7,7 +7,7 @@ dependencies = [
   "defusedxml>=0.7.1",
   "lxml>=5.2.0",
   "python-docx>=1.1.0",
-  "sophnet-tools>=0.0.1",
+  "sophnet-tools>=0.0.2",
 ]
 
 [[tool.uv.index]]

package/skills/sophnet-face-search/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "sophnet-face-search",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "types": [
     "builtin"
   ],
   "displayName": "",
   "description": "",
   "changelog": [
+    {
+      "version": "1.0.1",
+      "date": "2026-06-17",
+      "changes": [
+        "升级 sophnet-tools 依赖版本 >=0.0.1 → >=0.0.2"
+      ]
+    },
     {
       "version": "1.0.0",
       "date": "2026-04-09",
@@ -16,5 +23,5 @@
     }
   ],
   "createdAt": "2026-04-09",
-  "updatedAt": "2026-04-09"
+  "updatedAt": "2026-06-17"
 }

package/skills/sophnet-face-search/src/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "sophnet-face-search"
-version = "1.0.0"
+version = "1.0.1"
 description = "Face search using Sophnet face detection and embedding API"
 requires-python = ">=3.8"
 dependencies = [
     "opencv-python-headless>=4.8.0",
     "numpy>=1.24.0",
     "requests>=2.28.0",
-    "sophnet-tools>=0.0.1",
+    "sophnet-tools>=0.0.2",
 ]

package/skills/sophnet-id-photo/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "sophnet-id-photo",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "types": [
     "store"
   ],
   "displayName": "一键证件照",
   "description": "Sophnet 证件照：人脸检测后在多张达标脸中取面积最大者裁切头肩，VL 预审后换纯色底（白/蓝/红）并微调体态与角度。用户要证件照、换证件照底色、一寸/二寸/报名或电子证照底色时使用。",
   "changelog": [
+    {
+      "version": "1.0.1",
+      "date": "2026-06-17",
+      "changes": [
+        "升级 sophnet-tools 依赖版本 >=0.0.1 → >=0.0.2"
+      ]
+    },
     {
       "changes": [
         "初版：白/蓝/红底，默认白底；输出 ALL_BG_TIP"
@@ -16,5 +23,5 @@
     }
   ],
   "createdAt": "2026-05-13",
-  "updatedAt": "2026-05-13"
+  "updatedAt": "2026-06-17"
 }

package/skills/sophnet-id-photo/src/pyproject.toml

@@ -1,10 +1,10 @@
 [project]
 name = "sophnet-id-photo"
-version = "1.0.0"
+version = "1.0.1"
 description = "Sophnet ID photo: solid background + corrections; optional compliance gate; preserve identity"
 requires-python = ">=3.10"
 dependencies = [
     "requests>=2.28.0",
-    "sophnet-tools>=0.0.1",
+    "sophnet-tools>=0.0.2",
     "opencv-python-headless>=4.8.0",
 ]

package/skills/sophnet-image-edit/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "sophnet-image-edit",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "types": [
     "builtin"
   ],
   "displayName": "",
   "description": "",
   "changelog": [
+    {
+      "version": "1.0.2",
+      "date": "2026-06-17",
+      "changes": [
+        "升级 sophnet-tools 依赖版本 >=0.0.1 → >=0.0.2"
+      ]
+    },
     {
       "version": "1.0.1",
       "date": "2026-06-09",
@@ -23,5 +30,5 @@
     }
   ],
   "createdAt": "2026-04-09",
-  "updatedAt": "2026-06-09"
+  "updatedAt": "2026-06-17"
 }

package/skills/sophnet-image-edit/src/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "sophnet-image-edit"
-version = "1.0.1"
+version = "1.0.2"
 description = "Sophnet image editing (image-to-image) with task polling"
 requires-python = ">=3.8"
 dependencies = [
     "requests>=2.28.0",
-    "sophnet-tools>=0.0.1",
+    "sophnet-tools>=0.0.2",
 ]
 
 [[tool.uv.index]]

package/skills/sophnet-image-generate/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "sophnet-image-generate",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "types": [
     "builtin"
   ],
   "displayName": "",
   "description": "",
   "changelog": [
+    {
+      "version": "1.0.2",
+      "date": "2026-06-17",
+      "changes": [
+        "升级 sophnet-tools 依赖版本 >=0.0.1 → >=0.0.2"
+      ]
+    },
     {
       "version": "1.0.1",
       "date": "2026-06-09",
@@ -23,5 +30,5 @@
     }
   ],
   "createdAt": "2026-04-09",
-  "updatedAt": "2026-06-09"
+  "updatedAt": "2026-06-17"
 }

package/skills/sophnet-image-generate/src/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "sophnet-image-generate"
-version = "1.0.1"
+version = "1.0.2"
 description = "Sophnet text-to-image generation with task polling"
 requires-python = ">=3.8"
 dependencies = [
     "requests>=2.28.0",
-    "sophnet-tools>=0.0.1",
+    "sophnet-tools>=0.0.2",
 ]
 
 [[tool.uv.index]]

package/skills/sophnet-image-ocr/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "sophnet-image-ocr",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "types": [
     "builtin"
   ],
   "displayName": "",
   "description": "Use when the user needs to extract text, tables, or structured content from images or PDF files. Supports local files and URLs via Sophnet OCR API.",
   "changelog": [
+    {
+      "version": "1.1.1",
+      "date": "2026-06-17",
+      "changes": [
+        "升级 sophnet-tools 依赖版本 >=0.0.1 → >=0.0.2"
+      ]
+    },
     {
       "version": "1.1.0",
       "date": "2026-05-26",
@@ -28,5 +35,5 @@
     }
   ],
   "createdAt": "2026-04-09",
-  "updatedAt": "2026-05-26"
+  "updatedAt": "2026-06-17"
 }

package/skills/sophnet-image-ocr/src/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "image-ocr"
-version = "1.1.0"
+version = "1.1.1"
 description = "OCR text and table extraction using Sophnet PaddleOCR API"
 requires-python = ">=3.8"
 dependencies = [
     "requests>=2.28.0",
-    "sophnet-tools>=0.0.1",
+    "sophnet-tools>=0.0.2",
 ]
 
 [project.optional-dependencies]

package/skills/sophnet-image-ocr/src/references/api-details.md

@@ -14,7 +14,7 @@
 ## Dependencies
 
 - `requests>=2.28.0` — HTTP client (always installed)
-- `sophnet-tools>=0.0.1` — Sophnet API helpers (always installed)
+- `sophnet-tools>=0.0.2` — Sophnet API helpers (always installed)
 - `pymupdf>=1.24.0` — PDF page rendering (auto-installed from Aliyun mirror on first PDF use)
 
 ## Workflow

package/skills/sophnet-infinite-talk/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "sophnet-infinite-talk",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "types": [
     "builtin"
   ],
   "displayName": "",
   "description": "",
   "changelog": [
+    {
+      "version": "1.0.1",
+      "date": "2026-06-17",
+      "changes": [
+        "升级 sophnet-tools 依赖版本 >=0.0.1 → >=0.0.2"
+      ]
+    },
     {
       "version": "1.0.0",
       "date": "2026-04-09",
@@ -16,5 +23,5 @@
     }
   ],
   "createdAt": "2026-04-09",
-  "updatedAt": "2026-04-09"
+  "updatedAt": "2026-06-17"
 }

package/skills/sophnet-infinite-talk/src/pyproject.toml

@@ -5,5 +5,5 @@ description = "Digital human video generation using Sophnet InfiniteTalk API"
 requires-python = ">=3.10"
 dependencies = [
   "requests>=2.28.0",
-  "sophnet-tools>=0.0.1",
+  "sophnet-tools>=0.0.2",
 ]

package/skills/sophnet-oss/skill.json

@@ -1,12 +1,21 @@
 {
   "name": "sophnet-oss",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "types": [
     "builtin"
   ],
   "displayName": "OSS链接生成",
   "description": "将文件转换为一个可供下载的文件链接",
   "changelog": [
+    {
+      "changes": [
+        "适配 sophnet-tools 0.0.2：返回链接改为短链接，移除签名参数相关约束",
+        "删除 SKILL.md 中「Signed URL 完整性」章节",
+        "更新前置条件要求 sophnet-tools>=0.0.2"
+      ],
+      "date": "2026-06-17",
+      "version": "1.2.0"
+    },
     {
       "changes": [
         "SKILL.md 全文中文化，精简 description 为中文「功能+触发场景」格式",
@@ -34,5 +43,5 @@
     }
   ],
   "createdAt": "2026-04-09",
-  "updatedAt": "2026-06-09"
+  "updatedAt": "2026-06-17"
 }

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

@@ -7,19 +7,9 @@ description: 将本地文件路径转换为可下载链接（24小时有效）
 
 将本地文件路径转换为可访问的下载 URL，链接有效期为 24 小时。
 
-## Signed URL（签名链接）完整性
-
-`DOWNLOAD_URL` 由 OSS **预签名**生成，**查询串（`?` 及之后的参数）即访问凭证**。在本次 skill 的全流程中：
-
-- **必须**使用脚本输出的 `DOWNLOAD_URL` **完整字符串**（一字不改）填入下文展示模板中的下载链接，或原样写入下游。
-- **禁止**去掉 `?` 及后续查询参数、禁止截取签名片段、禁止尝试「换成更短的裸 URL」或做任何 URL「美化」。
-- 签名 URL 的参数中，**`x-oss-signature-version` 和 `x-oss-credential` 不可省略**，分别为签名算法的版本标识和访问凭证标识，缺失任一参数均会导致签名校验失败。**`x-oss-credential` 内嵌的日期不可修改**，禁止插入重复的 credential 参数。
-- 若裸域名路径在无签名时可访问，那是偶然行为；本 skill **不以裸链为准**，仅以脚本输出的带签名 URL 为准。
-- 向用户展示时沿用下文「转换成功后」的固定格式即可；**不要改模板结构**，只保证链接内容为完整签名 URL。
-
 ## 前置条件
 
-- Python 包：`sophnet-tools`（需预先安装在系统 Python 环境中）
+- Python 包：`sophnet-tools>=0.0.2`（需预先安装在系统 Python 环境中）
 
 ## Usage
 
@@ -63,7 +53,7 @@ ERROR=错误描述
 文件路径已转换为可访问链接：
 
 文件路径：/absolute/path/to/file
-下载链接：<完整 DOWNLOAD_URL，一字不改>
+下载链接：<完整 DOWNLOAD_URL>
 
 ⏰ 链接有效期：24小时
 ```
@@ -93,7 +83,7 @@ Resolved relative path: "media/inbound/images/xxx.pdf" -> "/absolute/path/to/wor
 - 大文件可增大 `--timeout`（默认 120 秒）
 - 始终使用绝对路径以保证可靠
 - **严格串行执行**：禁止并发、禁止拆分子任务、禁止后台运行，一次只转换一个文件
-- **不修改签名 URL**：`DOWNLOAD_URL` 必须原样使用，不截取、不"美化"、不修改任何参数
+- **不修改下载链接**：`DOWNLOAD_URL` 必须原样使用，不截取、不"美化"、不修改任何字符
 
 ## ⚠️ 禁止操作
 
@@ -101,4 +91,4 @@ Resolved relative path: "media/inbound/images/xxx.pdf" -> "/absolute/path/to/wor
 - 禁止并发转换多个文件
 - 禁止将任务拆分为多个步骤
 - 禁止使用后台进程
-- 禁止修改 `DOWNLOAD_URL` 中的任何字符（含查询参数）
+- 禁止修改 `DOWNLOAD_URL` 中的任何字符

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

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

package/skills/sophnet-pdf/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "sophnet-pdf",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "types": [
     "store"
   ],
   "displayName": "PDF处理",
   "description": "PDF文档处理工具，支持创建、编辑和分析 PDF 文档",
   "changelog": [
+    {
+      "version": "1.0.1",
+      "date": "2026-06-17",
+      "changes": [
+        "升级 sophnet-tools 依赖版本 >=0.0.1 → >=0.0.2"
+      ]
+    },
     {
       "version": "1.0.0",
       "date": "2026-04-14",
@@ -16,5 +23,5 @@
     }
   ],
   "createdAt": "2026-04-14",
-  "updatedAt": "2026-04-14"
+  "updatedAt": "2026-06-17"
 }

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

@@ -10,5 +10,5 @@ dependencies = [
   "pdf2image>=1.17.0",
   "reportlab>=4.2.0",
   "pymupdf>=1.26.7",
-  "sophnet-tools>=0.0.1",
+  "sophnet-tools>=0.0.2",
 ]

package/skills/sophnet-sticker-edit/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "sophnet-sticker-edit",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "types": [
     "store"
   ],
   "displayName": "表情包生成",
   "description": "根据输入的图片生成表情包",
   "changelog": [
+    {
+      "version": "1.0.2",
+      "date": "2026-06-17",
+      "changes": [
+        "升级 sophnet-tools 依赖版本 >=0.0.1 → >=0.0.2"
+      ]
+    },
     {
       "changes": [
         "pyproject：requires-python 提升至 >=3.10；SKILL 文档删减冗余 `{baseDir}` 说明"
@@ -23,5 +30,5 @@
     }
   ],
   "createdAt": "2026-05-13",
-  "updatedAt": "2026-05-14"
+  "updatedAt": "2026-06-17"
 }

package/skills/sophnet-sticker-edit/src/pyproject.toml

@@ -1,9 +1,9 @@
 [project]
 name = "sophnet-sticker-edit"
-version = "1.0.1"
+version = "1.0.2"
 description = "Sophnet sticker/emoji image-to-image with random or custom styles (Qwen-Image-Edit-2509)"
 requires-python = ">=3.10"
 dependencies = [
     "requests>=2.28.0",
-    "sophnet-tools>=0.0.1",
+    "sophnet-tools>=0.0.2",
 ]

package/skills/sophnet-tts/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "sophnet-tts",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "types": [
     "builtin"
   ],
   "displayName": "",
   "description": "",
   "changelog": [
+    {
+      "version": "1.0.1",
+      "date": "2026-06-17",
+      "changes": [
+        "升级 sophnet-tools 依赖版本 >=0.0.1 → >=0.0.2"
+      ]
+    },
     {
       "version": "1.0.0",
       "date": "2026-04-09",
@@ -16,5 +23,5 @@
     }
   ],
   "createdAt": "2026-04-09",
-  "updatedAt": "2026-04-09"
+  "updatedAt": "2026-06-17"
 }

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

@@ -5,5 +5,5 @@ description = "Skill-local runtime dependencies for sophnet-tts"
 requires-python = ">=3.10"
 dependencies = [
   "requests>=2.28.0",
-  "sophnet-tools>=0.0.1",
+  "sophnet-tools>=0.0.2",
 ]

package/skills/sophnet-video-generate/skill.json

@@ -1,6 +1,6 @@
 {
   "name": "sophnet-video-generate",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "types": [
     "builtin",
     "store"
@@ -8,6 +8,13 @@
   "displayName": "视频生成",
   "description": "通过 Sophnet API 生成视频，支持文生视频和图生视频",
   "changelog": [
+    {
+      "version": "1.0.4",
+      "date": "2026-06-17",
+      "changes": [
+        "升级 sophnet-tools 依赖版本 >=0.0.1 → >=0.0.2"
+      ]
+    },
     {
       "version": "1.0.3",
       "date": "2026-06-09",
@@ -41,5 +48,5 @@
     }
   ],
   "createdAt": "2026-04-09",
-  "updatedAt": "2026-05-11"
+  "updatedAt": "2026-06-17"
 }

package/skills/sophnet-video-generate/src/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "sophnet-video-generate"
-version = "1.0.3"
+version = "1.0.4"
 description = "Sophnet video generation with task polling"
 requires-python = ">=3.8"
 dependencies = [
     "requests>=2.28.0",
-    "sophnet-tools>=0.0.1",
+    "sophnet-tools>=0.0.2",
 ]
 
 [[tool.uv.index]]

package/skills/sophnet-xlsx/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "sophnet-xlsx",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "types": [
     "store"
   ],
   "displayName": "Excel表格处理",
   "description": "",
   "changelog": [
+    {
+      "version": "1.0.1",
+      "date": "2026-06-17",
+      "changes": [
+        "升级 sophnet-tools 依赖版本 >=0.0.1 → >=0.0.2"
+      ]
+    },
     {
       "version": "1.0.0",
       "date": "2026-04-14",
@@ -16,5 +23,5 @@
     }
   ],
   "createdAt": "2026-04-14",
-  "updatedAt": "2026-04-14"
+  "updatedAt": "2026-06-17"
 }

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

@@ -7,5 +7,5 @@ dependencies = [
   "defusedxml>=0.7.1",
   "lxml>=5.2.0",
   "openpyxl>=3.1.0",
-  "sophnet-tools>=0.0.1",
+  "sophnet-tools>=0.0.2",
 ]

package/skills/store-marketing/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "store-marketing",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "types": [
     "store"
   ],
   "displayName": "门店营销辅助",
   "description": "门店营销助手：为通用门店策划活动、分群触达、生成多渠道文案与海报。结合会员分群、目录价格、节日热点与老板风格。触发：营销/推广/促销/文案/海报/沉睡客户/活动方案/朋友圈/小红书/营销日历。",
   "changelog": [
+    {
+      "version": "1.1.4",
+      "date": "2026-06-17",
+      "changes": [
+        "升级 sophnet-tools 依赖版本 >=0.0.1 → >=0.0.2"
+      ]
+    },
     {
       "version": "1.1.3",
       "date": "2026-06-03",
@@ -63,7 +70,7 @@
     }
   ],
   "createdAt": "2026-05-29",
-  "updatedAt": "2026-05-29",
+  "updatedAt": "2026-06-17",
   "resources": [
     "references",
     "playbooks"

package/skills/store-marketing/src/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "store-marketing"
-version = "1.1.3"
+version = "1.1.4"
 requires-python = ">=3.8"
 dependencies = [
   "store-suite>=1.1.0",
   "requests>=2.28.0",
-  "sophnet-tools>=0.0.1",
+  "sophnet-tools>=0.0.2",
 ]
 
 [project.scripts]