sophhub 0.4.52 → 0.4.53

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sophhub",
-  "version": "0.4.52",
+  "version": "0.4.53",
   "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,20 @@
 {
   "name": "claw-agent-get-send",
-  "version": "1.1.0",
+  "version": "1.2.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、错误码）",
+  "description": "Appia（IM 即时通讯）侧 claw.agent.groups.get / claw.agent.message.send：查询机器人在哪些群聊、向群发纯文本或 Markdown、发送文件附件；脚本封装 + HTTP/curl 参考（JWT、msg/md、错误码）",
   "changelog": [
+    {
+      "version": "1.2.0",
+      "date": "2026-07-06",
+      "changes": [
+        "appia_claw.py：新增 send-file 子命令（内部 upload × N → send，一步发送文件附件，支持多文件）",
+        "appia_claw.py：删除 upload 子命令与 send --file-ids 参数，从源头杜绝『只上传不发消息』的失败模式",
+        "SKILL.md：用法 #8/#9 合并为单条 send-file 示例，注意事项更新",
+        "design.md：命令表、脚本职责、注意事项、TC-032–TC-039 同步改为 send-file"
+      ]
+    },
     {
       "version": "1.1.0",
       "date": "2026-06-16",
@@ -39,5 +49,5 @@
     }
   ],
   "createdAt": "2026-04-28",
-  "updatedAt": "2026-06-16"
+  "updatedAt": "2026-07-06"
 }

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

@@ -33,11 +33,10 @@ 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>"
+# 8. 发送文件到群聊（一步到位：内部自动 upload + send，支持一个或多个文件）
+uv run {baseDir}/scripts/appia_claw.py --cred-file /path/to.cred.json send-file report.pdf --rid "<rid>" --text "请查收附件"
+# 多文件 + 无正文：
+uv run {baseDir}/scripts/appia_claw.py --cred-file /path/to.cred.json send-file a.pdf b.pdf --rid "<rid>"
 ```
 
 不用凭证文件时，可在环境中设置 `CLAW_JWT`、`APP_AGENT_ID`、`CLAW_USER_ID`（及场景需要的 `TARGET_RID` 等），命令相同，省略 `--cred-file …` 即可。
@@ -47,3 +46,4 @@ uv run {baseDir}/scripts/appia_claw.py --cred-file /path/to.cred.json send --tex
 - 最小凭证字段（JSON 或环境变量）：JWT、机器人 `agentId`、创建者 `userId`；勿将填好真实值的文件提交 Git。
 - 未设置 `APPIA_BASE_URL` 时，脚本默认 `https://sophgo.appia.cn`。
 - HTTP / curl / 错误码：技能根目录 **`../reference-http.md`**（相对本文件）。
+- 发送文件用 `send-file` 一步完成（内部自动 upload + send）；不存在单独的 `upload` 子命令，避免"只上传不发消息"的失败。

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), agent.file.upload."""
+"""Appia Claw HTTP API: agent.groups.get, agent.message.send (plaintext + md + chunking), agent.file.upload + send-file."""
 
 from __future__ import annotations
 
@@ -324,15 +324,11 @@ 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, file_ids=file_ids if file_ids else None)
+        data = _send_plain(rid, part, args.timeout)
         if args.json:
             print(json.dumps(data, ensure_ascii=False, indent=2))
         elif len(parts) > 1:
@@ -391,18 +387,31 @@ def cmd_send_md(args: argparse.Namespace) -> int:
     return 0
 
 
-def cmd_upload(args: argparse.Namespace) -> int:
-    """上传文件到群聊（不发消息），返回 file._id 供 send 的 --file-ids 使用。"""
+def cmd_send_file(args: argparse.Namespace) -> int:
+    """发送文件到群聊：内部逐个 upload 收集 file._id，再一次性 send 带附件。"""
     rid = args.rid or _cfg("TARGET_RID")
     if not rid:
-        print("⚠️ upload 需要 TARGET_RID 或 --rid", file=sys.stderr)
+        print("⚠️ send-file 需要 TARGET_RID 或 --rid", file=sys.stderr)
         return 1
-    data = _file_upload(rid, args.file, args.timeout)
+    file_ids: list[str] = []
+    for fpath in args.files:
+        data = _file_upload(rid, fpath, args.timeout)
+        finfo = data.get("data", {}).get("file", {})
+        fid = finfo.get("_id")
+        if not fid:
+            print(f"⚠️ 上传失败：未返回 file._id（{fpath}），已中止，不发送消息", file=sys.stderr)
+            return 1
+        file_ids.append(fid)
+        if args.json:
+            print(json.dumps(data, ensure_ascii=False, indent=2))
+        else:
+            print(f"uploaded: file._id={fid}  name={finfo.get('name')}  size={finfo.get('size')}  type={finfo.get('type')}")
+    text = args.text if args.text is not None else ""
+    data = _send_plain(rid, text, args.timeout, file_ids=file_ids)
     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')}")
+        print(f"sent: fileIds={file_ids}  msg={text!r}")
     return 0
 
 
@@ -425,11 +434,10 @@ 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 则分多条；可带 --file-ids 附件）")
+    sp = sub.add_parser("send", help="POST agent.message.send（纯文本 msg；超出 APPIA_MSG_CHUNK_SIZE 则分多条）")
     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)
 
@@ -441,11 +449,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)
+    sfp = sub.add_parser("send-file", help="上传文件并作为附件发送到群聊（一步到位：内部 upload × N → send）")
+    sfp.add_argument("files", nargs="+", help="待发送的文件路径（一个或多个）")
+    sfp.add_argument("--text", "-t", help="消息正文（可选，默认空）")
+    sfp.add_argument("--rid", help="覆盖 TARGET_RID")
+    sfp.add_argument("--json", action="store_true")
+    sfp.set_defaults(_run=cmd_send_file)
 
     args = p.parse_args()
     if args.cred_file: