sophhub 0.4.69 → 0.4.70

package/package.json

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

package/skills/share-skill/skill.json

@@ -1,12 +1,21 @@
 {
   "name": "share-skill",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "types": [
     "builtin"
   ],
   "displayName": "Skill分享",
-  "description": "分享自己的skill给虾友",
+  "description": "分享自己的 skill 给虾友或虾友群",
   "changelog": [
+    {
+      "version": "1.1.0",
+      "date": "2026-09-07",
+      "changes": [
+        "新增 list-groups 子命令与 send/preview 的 --group-id 目标，支持把 Skill 分享到虾友群",
+        "web_jwt 过期或临近过期时自动用 web_refresh_token 续期（逻辑适配自 claw-friend-message-capture）",
+        "SKILL.md 新增群目标回显确认流程与 Processing Mode 双轨规则"
+      ]
+    },
     {
       "changes": [
         "初次提交"
@@ -16,7 +25,7 @@
     }
   ],
   "createdAt": "2026-05-05",
-  "updatedAt": "2026-05-05",
+  "updatedAt": "2026-09-07",
   "emoji": "🔗",
   "tags": [
     "开发"

package/skills/share-skill/src/SKILL.md

@@ -1,15 +1,18 @@
 ---
 name: share-skill
-description: 列出当前用户容器中实际安装的 Skill，按 openclaw skills list 返回的 source 字段分组，引导用户选择 Skill、选择虾友后直接发送 web 格式 Skill 分享卡片。Use when the user asks to share or introduce an installed Skill to a Sophclaw friend / 虾友.
+description: 列出当前用户容器中实际安装的 Skill，按 openclaw skills list 返回的 source 字段分组，引导用户选择 Skill、选择虾友或虾友群后发送 web 格式 Skill 分享卡片（发群必须先回显确认）。Use when the user asks to share or introduce an installed Skill to a Sophclaw friend / 虾友 or a group / 虾友群.
 ---
 
 # 向虾友介绍 Skill
 
-用于把当前容器里实际安装的某个 Skill 按 web 前端一致的 Skill 分享卡片格式发送给虾友。必须按顺序执行：**选择 Skill → 选择虾友 → 直接发送**。
+用于把当前容器里实际安装的某个 Skill 按 web 前端一致的 Skill 分享卡片格式发送给虾友或虾友群。必须按顺序执行：**选择 Skill → 选择目标（虾友 / 群聊）→ 发送（群目标必须先回显确认）**。
 
 ## Processing Mode
 
-**STRICT SERIAL PROCESSING ONLY** — 不并行发送；用户选定 Skill 和虾友后直接发送，不再追加确认步骤。
+**STRICT SERIAL PROCESSING ONLY** — 不并行发送；各步骤严格按顺序执行，目标类型不同规则不同：
+
+- **虾友目标**：用户选定 Skill 和虾友后直接发送，不再追加确认步骤。
+- **群聊目标**：用户选定 Skill 和群后，必须先回显目标群名、成员数与内容摘要，得到用户明确确认后才能发送；未确认前不得调用 send。
 
 ## Prerequisites
 
@@ -33,7 +36,9 @@ uv run {baseDir}/scripts/share_skill_to_friend.py <command> [args...]
 ```bash
 uv run {baseDir}/scripts/share_skill_to_friend.py list-skills
 uv run {baseDir}/scripts/share_skill_to_friend.py list-friends
+uv run {baseDir}/scripts/share_skill_to_friend.py list-groups
 uv run {baseDir}/scripts/share_skill_to_friend.py send --skill "<skill-name>" --friend-id <id> --friend-name "<name>"
+uv run {baseDir}/scripts/share_skill_to_friend.py send --skill "<skill-name>" --group-id <id>
 ```
 
 脚本会优先解析 JSON；如果 OpenClaw 命令输出包含 banner/config warnings，会自动从噪声中提取 JSON；如果实际拿到的是 `openclaw skills list` 的表格输出，也会尽量解析表格中的 Skill 名称、描述、状态和 Source。展示标签直接使用返回的 `source` 字段。
@@ -94,7 +99,11 @@ uv run {baseDir}/scripts/share_skill_to_friend.py list-skills
 4. 标签（如 `[openclaw-workspace]`）**不显示**，保持界面简洁
 5. 排序：openclaw-workspace → openclaw-managed → 其他内置 skill
 
-## Step 2：选择虾友
+## Step 2：选择目标（虾友或群聊）
+
+默认目标为虾友；仅当用户明确要求发送到群（如"发到 XX 群"、"分享到群里"）时走群分支，不要替用户猜测目标类型。
+
+### 分支 A：选择虾友（默认）
 
 用户选定 Skill 后执行：
 
@@ -133,19 +142,99 @@ uv run {baseDir}/scripts/share_skill_to_friend.py list-friends
 
 `displayName` 的生成规则：优先使用虾友备注名 `remark`，没有备注时使用昵称 `nickname`，都没有时显示「未命名虾友」。内部保留 `friendId` 供脚本调用，但**不要向用户展示虾友号**。如果昵称重复，只用列表序号区分，并可提示用户按序号选择。
 
-## Step 3：发送（含敏感信息确认）
+### 分支 B：选择群聊
+
+用户选定 Skill 后执行：
+
+```bash
+uv run {baseDir}/scripts/share_skill_to_friend.py list-groups
+```
+
+输出 JSON（**内部使用，勿向用户展示 `groupId` / 群 rid**）：
+
+```json
+{
+  "groups": [
+    {
+      "index": 1,
+      "groupId": 123,
+      "name": "产品交流群",
+      "memberCount": 8,
+      "myRole": "member",
+      "rid": "room-abc123"
+    }
+  ]
+}
+```
+
+使用以下格式向用户展示：
+
+```text
+👥 **请选择要发送到哪个群聊**
+
+1️⃣ **产品交流群**（8 人）
+
+2️⃣ **测试群**（3 人）
+
+💬 请回复 **序号** 或 **群名称**。
+```
+
+规则与虾友分支一致：不替用户猜测群聊；群名称重复时只用列表序号区分。内部保留 `groupId` / `rid` 供脚本调用，但**不要向用户展示**。
+
+## Step 3：发送（群目标先确认；自定义 Skill 含敏感信息确认）
+
+### 群目标：先回显确认，再发送
+
+群消息会广播给全体群成员且无法撤回。用户选定群后，**必须**先回显以下确认信息，得到用户明确同意（如回复「确认发送」）后才可执行发送；虾友目标无需此步骤。
+
+```text
+📤 **即将发送到群聊（请确认）**
+
+• 目标群：**产品交流群**（8 人）
+• 内容：`operations-dashboard` 的 Skill 分享卡片
+   📝 <中文功能介绍>
+
+💬 请回复 **「确认发送」** 执行，或回复 **「取消」** 返回。
+```
+
+用户确认后执行：
+
+```bash
+uv run {baseDir}/scripts/share_skill_to_friend.py send \
+  --skill "<skill-name>" \
+  --group-id <groupId> \
+  --description-zh "<中文功能介绍>"
+```
+
+发送成功返回（群目标为 `"group"` 字段，虾友目标为 `"friend"` 字段）：
+
+```json
+{
+  "success": true,
+  "skill": "operations-dashboard",
+  "group": { "groupId": 123, "name": "产品交流群", "memberCount": 8 },
+  "messageId": "<message-id>",
+  "message": "📝 功能介绍：...\n[claw-skill-share]\n{\"v\":1,...}\n[/claw-skill-share]"
+}
+```
+
+成功提示：
+
+```text
+✅已发送 `operations-dashboard` skill 到群聊「产品交流群」
+```
 
-用户选定虾友后，发送自定义 Skill 前，脚本会先扫描 Skill 目录是否包含私钥、token、`.env`、凭据文件等秘钥相关敏感信息。
+群目标解析失败（如账号不在目标群）时脚本会报错提示，此时向用户说明其可能不在该群，请先核对群聊选择，不要重试其他群。
 
 ### 敏感信息检测
 
-脚本会检测以下敏感信息：
+用户选定目标后，发送自定义 Skill 前，脚本会先扫描 Skill 目录是否包含私钥、token、`.env`、凭据文件等秘钥相关敏感信息（对虾友与群目标一视同仁）。脚本会检测以下敏感信息：
 - 敏感文件名：`.env`、`.env.local`、`credentials.json`、`id_rsa` 等
 - 敏感文件后缀：`.pem`、`.key`、`.p12`、`.pfx` 等
 - 敏感文件名关键词：`token`、`secret`、`password`、`credential`、`private_key` 等
 - 文件内容：私钥块、AWS Access Key、GitHub Token、Slack Token、JWT 等
 
-### 发送流程
+### 虾友目标发送流程
 
 首次发送（不带 `--allow-sensitive`）：
 
@@ -259,3 +348,6 @@ Agent 应向用户提示：
 - 敏感信息检测到的文件路径和原因可向用户展示，但**不要展示文件内容或密钥值**。
 - 不要替用户猜测虾友；必须让用户从列表中选择，或在用户主动提供时内部使用 `friendId`。
 - 用户侧输出中不要展示虾友号 / `friendId`。
+- 群目标同样不替用户猜测；必须让用户从 `list-groups` 结果中选择，或在用户明确指定群名时内部使用 `groupId`。
+- 用户侧输出中不要展示 `groupId` / 群 rid。
+- 群消息会广播给全部群成员且无法撤回：群发送前必须完成回显确认（群名 + 成员数 + 内容摘要），未经确认不得调用 send。

package/skills/share-skill/src/scripts/share_skill_to_friend.py

@@ -26,6 +26,8 @@ from typing import Any, Dict, Iterable, List, Optional, Pattern, Set, Tuple
 DEFAULT_BASE_URL = "https://yagent.sophnet.com/api"
 DEFAULT_TIMEOUT = 30
 JWT_PATH = "/home/node/.openclaw/jwt.json"
+REFRESH_URL = "https://sophnet.com/api/sys/login/refresh"
+REFRESH_MARGIN_SECONDS = 300
 DEFAULT_SKILLS_COMMAND = "openclaw skills list --json"
 DEFAULT_SKILL_INFO_COMMAND_TEMPLATE = "openclaw skills info {skill} --json"
 STORE_SKILLS_PATH = "/open-apis/skill-store/skills"
@@ -159,17 +161,93 @@ def jwt_exp_unix(token: str) -> Optional[int]:
         return None
 
 
-def ensure_jwt_valid_for_use(
-    token: str,
-    jwt_path: str,
-    clock_skew_sec: int = 60,
-) -> None:
+def refresh_web_jwt(jwt_path: str, timeout: int) -> str:
+    """用 web_refresh_token 换新 web_jwt 并写回 jwt.json。
+
+    逻辑适配自 claw-friend-message-capture 的 sophclaw_auth.py
+    （各 skill 安装目录相互独立，不做跨 skill import）。
+    """
+    try:
+        with open(jwt_path, "r", encoding="utf-8") as fp:
+            data = json.load(fp)
+    except OSError as exc:
+        raise AppError(f"无法读取 JWT 文件 {jwt_path}: {exc}") from exc
+    except json.JSONDecodeError as exc:
+        raise AppError(f"JWT 文件不是有效 JSON: {jwt_path}: {exc}") from exc
+
+    refresh_token = (
+        str(data.get("web_refresh_token") or "").strip() if isinstance(data, dict) else ""
+    )
+    if not refresh_token:
+        raise AppError(
+            f"{jwt_path} 缺少 web_refresh_token，无法自动续期；请重新登录后刷新"
+        )
+    body = json.dumps({"refreshToken": refresh_token}, ensure_ascii=False).encode("utf-8")
+    # refresh 接口只认 sophnet.com 域名，不认 yagent.sophnet.com
+    req = urllib.request.Request(
+        url=REFRESH_URL,
+        data=body,
+        headers={"Content-Type": "application/json", "Accept": "application/json"},
+        method="POST",
+    )
+    try:
+        with urllib.request.urlopen(req, timeout=timeout) as resp:
+            raw = resp.read().decode("utf-8", errors="replace")
+    except urllib.error.HTTPError as exc:
+        if exc.code == 401:
+            raise AppError("refresh token 已失效，请重新登录获取新的 JWT") from exc
+        detail = exc.read().decode("utf-8", errors="replace")[:300]
+        raise AppError(f"刷新 JWT 失败: HTTP {exc.code}: {detail}") from exc
+    except urllib.error.URLError as exc:
+        raise AppError(f"刷新 JWT 请求失败: {exc}") from exc
+    try:
+        res = json.loads(raw)
+    except json.JSONDecodeError as exc:
+        raise AppError(f"刷新 JWT 返回不是有效 JSON: {exc}") from exc
+    if isinstance(res, dict) and res.get("status") not in (None, 0):
+        raise AppError(
+            f"刷新 JWT 接口错误: status={res.get('status')} message={res.get('message')!r}"
+        )
+    result = unwrap_result(res) if isinstance(res, dict) else {}
+    if not isinstance(result, dict):
+        result = {}
+    new_token = result.get("token") or result.get("accessToken")
+    new_refresh = result.get("refreshToken")
+    if not isinstance(new_token, str) or not new_token.strip():
+        raise AppError(f"刷新 JWT 接口未返回 token: {raw[:300]}")
+    new_token = new_token.strip()
+    if new_token.lower().startswith("bearer "):
+        new_token = new_token[7:].strip()
+    data["web_jwt"] = new_token
+    if isinstance(new_refresh, str) and new_refresh.strip():
+        data["web_refresh_token"] = new_refresh.strip()
+    try:
+        with open(jwt_path, "w", encoding="utf-8") as fp:
+            json.dump(data, fp, ensure_ascii=False, indent=2)
+    except OSError as exc:
+        print(f"WARN: 续期成功但写回 {jwt_path} 失败: {exc}", file=sys.stderr)
+    return new_token
+
+
+def get_web_token(args: argparse.Namespace) -> str:
+    """读取 web_jwt；已过期或临近过期时自动用 web_refresh_token 续期。"""
+    token = read_bearer_token(args.jwt_path)
+    if getattr(args, "allow_expired_jwt", False):
+        return token
     exp = jwt_exp_unix(token)
-    if exp is None:
-        return
     now = int(time.time())
-    if now >= exp + clock_skew_sec:
-        raise AppError(f"JWT 已过期，请重新登录后刷新 {jwt_path}")
+    if exp is None or now < exp - REFRESH_MARGIN_SECONDS:
+        return token
+    try:
+        return refresh_web_jwt(args.jwt_path, args.timeout)
+    except AppError as exc:
+        if exp is not None and now >= exp:
+            raise AppError(
+                f"JWT 已过期且自动续期失败（{exc}）。请重新登录后刷新 {args.jwt_path}"
+            ) from exc
+        # 尚未真正过期：续期失败不阻断，沿用当前 token
+        print(f"WARN: JWT 自动续期失败（{exc}），使用当前 token 继续", file=sys.stderr)
+        return token
 
 
 def make_headers(token: str, content_type: Optional[str] = None) -> StringDict:
@@ -555,9 +633,7 @@ def merge_skill_detail(args: argparse.Namespace, skill: JsonDict) -> JsonDict:
 
 
 def load_friends(args: argparse.Namespace) -> List[JsonDict]:
-    token = read_bearer_token(args.jwt_path)
-    if not args.allow_expired_jwt:
-        ensure_jwt_valid_for_use(token, args.jwt_path)
+    token = get_web_token(args)
     url = f"{normalize_base_url(args.base_url)}/sys/openclaw/friend/list"
     data = request_json("GET", url, token, args.timeout)
     result = unwrap_result(data) or {}
@@ -589,6 +665,47 @@ def load_friends(args: argparse.Namespace) -> List[JsonDict]:
     return out
 
 
+def load_groups(args: argparse.Namespace) -> List[JsonDict]:
+    """列出当前账号所在的虾友群（含 groupId / 群 rid，仅内部使用，不向用户展示）。"""
+    token = get_web_token(args)
+    url = f"{normalize_base_url(args.base_url)}/sys/openclaw/group/list"
+    data = request_json("GET", url, token, args.timeout)
+    result = unwrap_result(data) or {}
+    groups = result.get("groups") if isinstance(result, dict) else None
+    if not isinstance(groups, list):
+        raise AppError("群列表接口缺少 groups 数组")
+
+    out: List[JsonDict] = []
+    for item in groups:
+        if not isinstance(item, dict):
+            continue
+        raw_id = item.get("id") if item.get("id") is not None else item.get("groupId")
+        try:
+            group_id = int(raw_id)
+        except (TypeError, ValueError):
+            continue
+        out.append({
+            "groupId": group_id,
+            "name": str(item.get("name") or "未命名群聊").strip(),
+            "memberCount": item.get("memberCount"),
+            "myRole": item.get("myRole"),
+            "rid": str(item.get("rid") or "").strip(),
+        })
+    out.sort(key=lambda g: str(g["name"]))
+    for idx, group in enumerate(out, start=1):
+        group["index"] = idx
+    return out
+
+
+def resolve_group(args: argparse.Namespace, group_id: int) -> JsonDict:
+    for group in load_groups(args):
+        if group["groupId"] == group_id:
+            return group
+    raise AppError(
+        f"未找到群聊 groupId={group_id}，当前账号可能不在该群或该群不存在；请用 list-groups 核对"
+    )
+
+
 def encode_skill_share_message(payload: JsonDict, prefix: str = "") -> str:
     head = f"{prefix.strip()}\n" if prefix and prefix.strip() else ""
     body = json.dumps(payload, ensure_ascii=False, separators=(",", ":"))
@@ -931,12 +1048,27 @@ def build_parser() -> argparse.ArgumentParser:
     p = sub.add_parser("list-friends", help="列出当前账号虾友")
     add_common_args(p)
 
+    p = sub.add_parser("list-groups", help="列出当前账号所在的虾友群")
+    add_common_args(p)
+
     for name in ("preview", "send"):
         p = sub.add_parser(name, help="预览或发送 Skill 功能介绍")
         add_common_args(p)
         p.add_argument("--skill", required=True, help="Skill 名称或 list-skills 返回的序号")
-        p.add_argument("--friend-id", type=int, required=True, help="目标虾友 friendId")
+        p.add_argument(
+            "--friend-id",
+            type=int,
+            default=0,
+            help="目标虾友 friendId（与 --group-id 二选一）",
+        )
         p.add_argument("--friend-name", default="", help="目标虾友展示名")
+        p.add_argument(
+            "--group-id",
+            type=int,
+            default=0,
+            help="目标群聊 groupId（与 --friend-id 二选一；群 rid 由脚本内部经 group/list 解析）",
+        )
+        p.add_argument("--group-name", default="", help="目标群聊展示名（仅 preview 展示用）")
         p.add_argument("--description-zh", default="", help="可选：由 Agent 改写的中文功能介绍")
         p.add_argument(
             "--allow-sensitive",
@@ -960,9 +1092,14 @@ def main(argv: Optional[List[str]] = None) -> int:
         if args.command == "list-friends":
             print_json({"friends": load_friends(args)})
             return 0
+        if args.command == "list-groups":
+            print_json({"groups": load_groups(args)})
+            return 0
 
-        if args.friend_id <= 0:
-            raise AppError("friend-id 必须为正整数")
+        if args.friend_id < 0 or args.group_id < 0:
+            raise AppError("friend-id / group-id 必须为正整数")
+        if (args.friend_id > 0) == (args.group_id > 0):
+            raise AppError("必须且只能指定 --friend-id 或 --group-id 之一")
         skill = merge_skill_detail(args, find_skill(args, args.skill))
         friend_name = (args.friend_name or "未命名虾友").strip()
         sensitive_findings: List[StringDict] = []
@@ -973,19 +1110,35 @@ def main(argv: Optional[List[str]] = None) -> int:
             )
         if args.command == "preview":
             message = build_preview_message(skill, args.description_zh)
+            target: JsonDict
+            if args.group_id > 0:
+                target = {
+                    "group": {"groupId": args.group_id, "name": args.group_name.strip()}
+                }
+            else:
+                target = {
+                    "friend": {"friendId": args.friend_id, "displayName": friend_name}
+                }
             print_json({
                 "skill": skill,
-                "friend": {"friendId": args.friend_id, "displayName": friend_name},
+                **target,
                 "message": message,
                 "sensitiveFindings": sensitive_findings if sensitive_findings else None,
             })
             return 0
 
-        token = read_bearer_token(args.jwt_path)
-        if not args.allow_expired_jwt:
-            ensure_jwt_valid_for_use(token, args.jwt_path)
+        token = get_web_token(args)
         base_url = normalize_base_url(args.base_url)
-        rid = get_or_create_dm(base_url, token, args.friend_id, args.timeout)
+        group: Optional[JsonDict] = None
+        if args.group_id > 0:
+            group = resolve_group(args, args.group_id)
+            rid = str(group.get("rid") or "")
+            if not rid:
+                raise AppError(
+                    f"群「{group.get('name')}」缺少 rid，无法发送；请联系管理员检查群数据"
+                )
+        else:
+            rid = get_or_create_dm(base_url, token, args.friend_id, args.timeout)
         prefix = build_intro_prefix(skill, args.description_zh)
         if skill.get("storeSlug"):
             payload = build_store_payload(skill, prefix)
@@ -1009,14 +1162,21 @@ def main(argv: Optional[List[str]] = None) -> int:
             )
             message = encode_skill_share_message(payload, prefix)
         sent = send_message(base_url, token, rid, message, args.timeout)
-        result = {
+        result: JsonDict = {
             "success": True,
             "skill": skill["name"],
-            "friend": {"friendId": args.friend_id, "displayName": friend_name},
             "rid": rid,
             "messageId": sent.get("_id"),
             "message": message,
         }
+        if group is not None:
+            result["group"] = {
+                "groupId": group["groupId"],
+                "name": group["name"],
+                "memberCount": group.get("memberCount"),
+            }
+        else:
+            result["friend"] = {"friendId": args.friend_id, "displayName": friend_name}
         if sensitive_findings:
             result["sensitiveFindings"] = sensitive_findings
             result["sensitiveWarning"] = "已发送包含敏感信息的 Skill，请确认接收方可信"