sophhub 0.4.7 → 0.4.8

package/package.json

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

package/skills/bot-api-status/skill.json

@@ -1,12 +1,20 @@
 {
   "name": "bot-api-status",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "types": [
     "store"
   ],
   "displayName": "BOT-API",
   "description": "查看当前 Agent 的 bot api 状态，同时也支持开启、关闭、重置密钥",
   "changelog": [
+    {
+      "changes": [
+        "非 --json 输出补充 Agent 名字与 source_agent_id，与 SKILL 输出模板一致",
+        "修正 SKILL 页眉为合法 YAML frontmatter"
+      ],
+      "date": "2026-04-28",
+      "version": "1.0.3"
+    },
     {
       "changes": [
         "修正 SKILL 中 bot-api 链接路径说明（account_id 占位，与脚本一致）",
@@ -32,5 +40,5 @@
     }
   ],
   "createdAt": "2026-04-22",
-  "updatedAt": "2026-04-22"
+  "updatedAt": "2026-04-28"
 }

package/skills/bot-api-status/src/SKILL.md

@@ -45,6 +45,9 @@ uv run {baseDir}/scripts/secret.py reset --json
 ```text
 📋 🤖 bot-api 状态：<🟢 开启 / ⚪ 关闭>
 
+📛 Agent 名字：<display_name>
+🆔 Agent ID：<source_agent_id>
+
 🔗 非流式链接：{{BASEURL}}/bot-api/v2/<account_id>/chat
 🔗 流式链接：{{BASEURL}}/bot-api/v2/<account_id>/chat-stream
 🔑 密钥：<api_secret 或 📭 暂无>
@@ -55,6 +58,9 @@ uv run {baseDir}/scripts/secret.py reset --json
 ```text
 ✨ 🤖 bot-api 已创建
 
+📛 Agent 名字：<display_name>
+🆔 Agent ID：<source_agent_id>
+
 🔗 非流式链接：{{BASEURL}}/bot-api/v2/<account_id>/chat
 🔗 流式链接：{{BASEURL}}/bot-api/v2/<account_id>/chat-stream
 🔑 密钥：<api_secret>
@@ -75,9 +81,12 @@ uv run {baseDir}/scripts/secret.py reset --json
 ```text
 🔄 🤖 bot-api 密钥已更新
 
-🔑 新密钥：<new_secret>
+📛 Agent 名字：<display_name>
+🆔 Agent ID：<source_agent_id>
+
 🔗 非流式链接：{{BASEURL}}/bot-api/v2/<account_id>/chat
 🔗 流式链接：{{BASEURL}}/bot-api/v2/<account_id>/chat-stream
+🔑 新密钥：<new_secret>
 
 🔒 请妥善保管，勿对外转发或截图。
 ```
@@ -87,3 +96,4 @@ uv run {baseDir}/scripts/secret.py reset --json
 ```text
 ⚠️ 获取BASEURL失败，刷新页面或者重新登录后重试。
 ```
+

package/skills/bot-api-status/src/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
 name = "bot-api-status"
-version = "1.0.2"
+version = "1.0.3"
 description = "Manage bot-api lifecycle and secret for the current Agent"
 requires-python = ">=3.10"

package/skills/bot-api-status/src/scripts/secret.py

@@ -365,6 +365,17 @@ def _fmt_url(value: object) -> str:
     return "📭 暂无"
 
 
+def _fmt_identity(value: object) -> str:
+    if isinstance(value, str) and value.strip():
+        return value.strip()
+    return "📭 暂无"
+
+
+def _print_agent_identity(display_name: object, source_agent_id: object) -> None:
+    print(f"📛 名字：{_fmt_identity(display_name)}")
+    print(f"🆔 source_agent_id：{_fmt_identity(source_agent_id)}")
+
+
 def _print_link_block(url: str, stream_url: str, baseurl_note: str) -> None:
     if url != "📭 暂无":
         print(f"🔗 非流式链接：{url}")
@@ -384,6 +395,8 @@ def print_human_response(command: str, payload: dict[str, Any]) -> int:
         state = "🟢 开启" if enabled else "⚪ 关闭"
         print(f"📋 🤖 bot-api 状态：{state}")
         print()
+        _print_agent_identity(payload.get("display_name"), payload.get("source_agent_id"))
+        print()
         _print_link_block(url, stream_url, "")
         print(f"🔑 密钥：{secret}")
         return 0
@@ -393,6 +406,8 @@ def print_human_response(command: str, payload: dict[str, Any]) -> int:
         prefix = "📝" if action == "updated" else "✨"
         print(f"{prefix} 🤖 bot-api {title}")
         print()
+        _print_agent_identity(payload.get("display_name"), payload.get("source_agent_id"))
+        print()
         _print_link_block(url, stream_url, "")
         print(f"🔑 密钥：{secret}")
         print()
@@ -411,9 +426,10 @@ def print_human_response(command: str, payload: dict[str, Any]) -> int:
             return 1
         print("🔄 🤖 bot-api 密钥已更新")
         print()
-        print(f"🔑 新密钥：{secret}")
+        _print_agent_identity(payload.get("display_name"), payload.get("source_agent_id"))
         print()
         _print_link_block(url, stream_url, "")
+        print(f"🔑 新密钥：{secret}")
         print()
         print("🔒 请妥善保管，勿对外转发或截图。")
         return 0

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

@@ -0,0 +1,21 @@
+{
+  "name": "claw-agent-get-send",
+  "version": "1.0.0",
+  "types": ["store"],
+  "displayName": "Claw Agent Get/Send",
+  "description": "Appia claw.agent.groups.get / claw.agent.message.send：脚本封装 + HTTP/curl 参考（JWT、msg/md 负载、错误码）",
+  "changelog": [
+    {
+      "version": "1.0.0",
+      "date": "2026-04-28",
+      "changes": [
+        "groups / verify-target / send 分片子命令",
+        "reference-http.md：合并 claw.agent.groups.get / message.send curl 文档",
+        "skill 标识 claw-agent-get-send（原 appia-claw）",
+        "send-md 命令支持 Markdown AST 发送"
+      ]
+    }
+  ],
+  "createdAt": "2026-04-28",
+  "updatedAt": "2026-04-28"
+}

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

@@ -0,0 +1,72 @@
+---
+name: claw-agent-get-send
+description: >-
+  Call Appia Claw HTTP APIs (agent.groups.get, agent.message.send) using env vars or curl.
+  Use when querying bot group memberships, verifying rid+group name, sending plaintext or Markdown AST to Appia rooms,
+  or when the user needs JWT auth rules, curl examples, or md payload shape for agent.message.send.
+---
+
+# Claw Agent（groups.get / message.send）
+
+使用 **环境变量** 鉴权，**不向仓库提交** JWT、`APP_AGENT_ID` 等明文。
+
+## 环境变量
+
+| 变量 | 必填 | 说明 |
+|------|------|------|
+| `APPIA_BASE_URL` | 是 | 根地址，例如 `https://sophgo.appia.cn` |
+| `CLAW_JWT` | 是 | `Authorization: Bearer` 的值 |
+| `APP_AGENT_ID` | 是 | SophClaw 机器人 Agent ID（与 `AGENT_ID` 二选一） |
+| `TARGET_RID` | send / verify | 目标群 `rid` |
+| `TARGET_GROUP_NAME` | verify | 群展示名，`verify-target` 双因子校验用 |
+| `TARGET_GROUP_MATCH` | 否 | `exact`（默认）或 `contains` |
+
+| 可选 | 说明 |
+|------|------|
+| `APPIA_MSG_CHUNK_SIZE` | 单条 `msg` 最大字符数，超出则拆分多次发送（默认 3500） |
+
+## 用法
+
+`{baseDir}` 为与本 `SKILL.md` 同级的安装根（通常含 `scripts/`）。
+
+### 查询群列表
+
+```bash
+uv run {baseDir}/scripts/appia_claw.py groups --json
+```
+
+### 校验目标群
+
+```bash
+uv run {baseDir}/scripts/appia_claw.py verify-target
+```
+
+### 发送纯文本（支持分段）
+
+```bash
+uv run {baseDir}/scripts/appia_claw.py send --file /tmp/brief.txt
+uv run {baseDir}/scripts/appia_claw.py send --text "hello" --rid <rid>
+```
+
+### 发送 Markdown AST
+
+```bash
+# 从 JSON 字符串
+uv run {baseDir}/scripts/appia_claw.py send-md --md-json '[{"type":"PARAGRAPH","value":[{"type":"PLAIN_TEXT","value":"**粗体** 文本"}]}]'
+
+# 从 JSON 文件
+uv run {baseDir}/scripts/appia_claw.py send-md --md-file /tmp/md.json
+
+# 纯文本自动转 md 结构
+uv run {baseDir}/scripts/appia_claw.py send-md --text "简单文本"
+```
+
+## 说明
+
+- `send` 命令使用 **`msg` 纯文本**；极长正文按 `APPIA_MSG_CHUNK_SIZE` **分多条**发送。
+- `send-md` 命令使用 **`md` Markdown AST** 结构，支持 Rocket.Chat 富文本格式。
+- 请避免与业务侧「同 Sender 并发冲突」同时使用（串行调用本脚本即可）。
+
+## HTTP / curl 参考
+
+仓库根目录的 `claw.agent.groups.get.curl.md` 与 `claw.agent.message.send.curl.md` 已并入本 skill 的 [reference-http.md](reference-http.md)（鉴权说明、完整 curl、`md` 示例、常见错误码）。需要手写请求或排查 401 / 参数错误时优先读该文件。

package/skills/claw-agent-get-send/src/pyproject.toml

@@ -0,0 +1,5 @@
+[project]
+name = "claw-agent-get-send"
+version = "1.0.0"
+description = "Appia Claw groups.get / message.send helper"
+requires-python = ">=3.10"

package/skills/claw-agent-get-send/src/reference-http.md

@@ -0,0 +1,149 @@
+# Claw HTTP API（curl 参考）
+
+与仓库根目录 `claw.agent.groups.get.curl.md`、`claw.agent.message.send.curl.md` 同源；集成在 skill 内便于离线查阅。
+
+---
+
+## `GET /api/v1/claw/agent.groups.get`
+
+用于按 `agentId` 查询该机器人所在的所有群聊，返回 `rid` 和群名称。
+
+### 鉴权方式
+
+与 `mcpToDos` 一致：
+
+- `authRequired: false`
+- 通过请求头 `Authorization: Bearer <JWT>` 校验
+- 校验规则受以下设置控制：
+  - `Appia_Antagent_JWT_Enable`
+  - `APPIA_JWT_SECRET`
+
+### 请求示例
+
+```bash
+curl -sS -G 'https://YOUR_ROCKETCHAT_HOST/api/v1/claw/agent.groups.get' \
+  -H 'Authorization: Bearer YOUR_MCP_JWT_TOKEN' \
+  --data-urlencode 'agentId=AGENT_BOT_USER_ID'
+```
+
+### 参数
+
+- `agentId`（query，必填）：OpenClaw 侧 Agent ID（会映射到机器人用户）
+
+### 成功返回示例
+
+```json
+{
+  "success": true,
+  "data": {
+    "agentId": "AGENT_BOT_USER_ID",
+    "groups": [
+      {
+        "rid": "ROOM_ID_1",
+        "name": "群聊A"
+      },
+      {
+        "rid": "ROOM_ID_2",
+        "name": "群聊B"
+      }
+    ],
+    "total": 2
+  }
+}
+```
+
+### 常见失败
+
+- `{"success":false,"message":"401"}`：JWT 无效或过期
+- `{"success":false,"message":"agentId is required"}`：缺少 `agentId`
+- `{"success":false,"message":"agent not found by agentId"}`：找不到对应 agentId 的机器人
+
+---
+
+## `POST /api/v1/claw/agent.message.send`
+
+用于根据 `rid + agentId` 向指定群聊发送消息。
+
+接口会校验：
+
+1. `rid` 对应房间存在
+2. `agentId` 对应用户存在、为 bot、且 active
+3. 该 `agentId` 确实在该 `rid` 的订阅列表里
+
+满足后，走后端正常发消息逻辑（`executeSendMessage`）。
+
+### 鉴权方式
+
+与 `mcpToDos` 一致：
+
+- `authRequired: false`
+- 通过请求头 `Authorization: Bearer <JWT>` 校验
+- 校验规则受以下设置控制：
+  - `Appia_Antagent_JWT_Enable`
+  - `APPIA_JWT_SECRET`
+
+### 请求示例
+
+#### 示例一：发送纯文本
+
+```bash
+curl -sS -X POST 'https://YOUR_ROCKETCHAT_HOST/api/v1/claw/agent.message.send' \
+  -H 'Content-Type: application/json' \
+  -H 'Authorization: Bearer YOUR_MCP_JWT_TOKEN' \
+  -d '{
+    "rid": "TARGET_ROOM_RID",
+    "agentId": "AGENT_BOT_USER_ID",
+    "msg": "这是一条由 Claw 机器人发送的消息"
+  }'
+```
+
+#### 示例二：发送 Markdown（`md`）
+
+```bash
+curl -sS -X POST 'https://YOUR_ROCKETCHAT_HOST/api/v1/claw/agent.message.send' \
+  -H 'Content-Type: application/json' \
+  -H 'Authorization: Bearer YOUR_MCP_JWT_TOKEN' \
+  -d '{
+    "rid": "TARGET_ROOM_RID",
+    "agentId": "OPENCLAW_AGENT_ID",
+    "md": [
+      {
+        "type": "PARAGRAPH",
+        "value": [
+          { "type": "PLAIN_TEXT", "value": "这是一条 *Markdown* 消息" }
+        ]
+      }
+    ]
+  }'
+```
+
+### 参数
+
+- `rid`（body，必填）：目标群聊房间 ID
+- `agentId`（body，必填）：OpenClaw 侧 Agent ID（会映射到机器人用户）
+- `msg`（body，可选）：消息文本
+- `md`（body，可选）：Markdown AST（Rocket.Chat `md` 结构）
+- 约束：`msg` 和 `md` 至少提供一个
+
+### 成功返回示例
+
+```json
+{
+  "success": true,
+  "data": {
+    "rid": "TARGET_ROOM_RID",
+    "agentId": "AGENT_BOT_USER_ID",
+    "status": "sent"
+  }
+}
+```
+
+### 常见失败
+
+- `{"success":false,"message":"401"}`：JWT 无效或过期
+- `{"success":false,"message":"rid and agentId are required, and either msg or md must be provided"}`：参数缺失
+- `{"success":false,"message":"room not found"}`：房间不存在
+- `{"success":false,"message":"agent not found by agentId"}`：找不到对应 agentId 的机器人
+- `{"success":false,"message":"agent must be a bot user"}`：agent 不是 bot
+- `{"success":false,"message":"agent is inactive"}`：机器人未激活
+- `{"success":false,"message":"agent is not in this room"}`：机器人不在该群里

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

@@ -0,0 +1,287 @@
+#!/usr/bin/env python3
+"""Appia Claw HTTP API: agent.groups.get, agent.message.send (plaintext + md + chunking)."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+from typing import Any
+from urllib import error, parse, request
+
+DEFAULT_CHUNK_SIZE = 3500
+
+
+def _env(name: str, *fallbacks: str) -> str:
+    for key in (name,) + fallbacks:
+        v = os.environ.get(key, "").strip()
+        if v:
+            return v
+    return ""
+
+
+def _base_url() -> str:
+    base = _env("APPIA_BASE_URL", "APPIA_HOST").rstrip("/")
+    if not base:
+        sys.exit("缺少环境变量 APPIA_BASE_URL")
+    return base
+
+
+def _jwt() -> str:
+    tok = _env("CLAW_JWT", "APPIA_CLAW_JWT")
+    if not tok:
+        sys.exit("缺少环境变量 CLAW_JWT")
+    return tok
+
+
+def _agent_id() -> str:
+    aid = _env("APP_AGENT_ID", "AGENT_ID")
+    if not aid:
+        sys.exit("缺少环境变量 APP_AGENT_ID（或 AGENT_ID）")
+    return aid
+
+
+def _groups_get(timeout: float) -> dict[str, Any]:
+    base = _base_url()
+    uid = _agent_id()
+    q = parse.urlencode({"agentId": uid})
+    url = f"{base}/api/v1/claw/agent.groups.get?{q}"
+    req = request.Request(
+        url,
+        headers={
+            "Authorization": f"Bearer {_jwt()}",
+            "Accept": "application/json",
+        },
+        method="GET",
+    )
+    try:
+        with request.urlopen(req, timeout=timeout) as resp:
+            body = resp.read().decode("utf-8")
+    except error.HTTPError as exc:
+        body = exc.read().decode("utf-8", errors="replace")
+        raise RuntimeError(f"HTTP {exc.code}: {body}") from exc
+    data = json.loads(body)
+    if not data.get("success"):
+        raise RuntimeError(json.dumps(data, ensure_ascii=False))
+    return data
+
+
+def cmd_groups(args: argparse.Namespace) -> int:
+    data = _groups_get(args.timeout)
+    if args.json:
+        print(json.dumps(data, ensure_ascii=False, indent=2))
+        return 0
+    payload = data.get("data") or {}
+    groups = payload.get("groups") or []
+    print(f"agentId={payload.get('agentId')} total={payload.get('total', len(groups))}")
+    for g in groups:
+        if isinstance(g, dict):
+            print(f"- rid={g.get('rid')} name={g.get('name')}")
+    return 0
+
+
+def cmd_verify_target(args: argparse.Namespace) -> int:
+    rid = _env("TARGET_RID")
+    name = _env("TARGET_GROUP_NAME")
+    if not rid or not name:
+        print("⚠️ verify-target 需要环境变量 TARGET_RID 与 TARGET_GROUP_NAME", file=sys.stderr)
+        return 1
+    mode = (_env("TARGET_GROUP_MATCH") or "exact").lower()
+    if mode not in ("exact", "contains"):
+        mode = "exact"
+    data = _groups_get(args.timeout)
+    payload = data.get("data") or {}
+    groups = payload.get("groups") or []
+    hit: dict[str, Any] | None = None
+    for g in groups:
+        if isinstance(g, dict) and g.get("rid") == rid:
+            hit = g
+            break
+    if not hit:
+        print("⚠️ 校验失败：TARGET_RID 不在当前机器人已加入的群列表中。", file=sys.stderr)
+        return 1
+    gname = (hit.get("name") or "").strip()
+    name = name.strip()
+    if mode == "contains":
+        ok = name.lower() in gname.lower()
+    else:
+        ok = gname == name
+    if not ok:
+        print(
+            f"⚠️ 校验失败：群名与 TARGET_GROUP_NAME 不一致。期望匹配模式={mode} 配置名=[{name}] 实际=[{gname}]",
+            file=sys.stderr,
+        )
+        return 1
+    print("✅ TARGET_RID 与 TARGET_GROUP_NAME 双因子校验通过。")
+    return 0
+
+
+def _send_request(body_obj: dict[str, Any], timeout: float) -> dict[str, Any]:
+    """通用发送请求，支持 msg 或 md。"""
+    base = _base_url()
+    url = f"{base}/api/v1/claw/agent.message.send"
+    raw = json.dumps(body_obj, ensure_ascii=False).encode("utf-8")
+    req = request.Request(
+        url,
+        data=raw,
+        headers={
+            "Authorization": f"Bearer {_jwt()}",
+            "Content-Type": "application/json; charset=utf-8",
+            "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 _send_plain(rid: str, msg: str, timeout: float) -> dict[str, Any]:
+    """发送纯文本消息。"""
+    uid = _agent_id()
+    body_obj: dict[str, Any] = {"rid": rid, "agentId": uid, "msg": msg}
+    return _send_request(body_obj, timeout)
+
+
+def _send_md(rid: str, md: list[dict[str, Any]], timeout: float) -> dict[str, Any]:
+    """发送 Markdown AST 消息。"""
+    uid = _agent_id()
+    body_obj: dict[str, Any] = {"rid": rid, "agentId": uid, "md": md}
+    return _send_request(body_obj, timeout)
+
+
+def _chunk_text(text: str, size: int) -> list[str]:
+    if size <= 0:
+        return [text]
+    if len(text) <= size:
+        return [text]
+    return [text[i : i + size] for i in range(0, len(text), size)]
+
+
+def cmd_send(args: argparse.Namespace) -> int:
+    """发送纯文本消息（支持分段）。"""
+    rid = args.rid or _env("TARGET_RID")
+    if not rid:
+        print("⚠️ send 需要 TARGET_RID 或 --rid", file=sys.stderr)
+        return 1
+    text = ""
+    if args.file:
+        path = os.path.expanduser(args.file)
+        with open(path, encoding="utf-8") as f:
+            text = f.read()
+    elif args.text is not None:
+        text = args.text
+    else:
+        print("⚠️ 需要 --file 或 --text", file=sys.stderr)
+        return 1
+    chunk_raw = _env("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)
+        if args.json:
+            print(json.dumps(data, ensure_ascii=False, indent=2))
+        elif len(parts) > 1:
+            print(f"[{idx + 1}/{len(parts)}] ok: {data.get('data', data)!r}")
+        else:
+            print(json.dumps(data, ensure_ascii=False, indent=2))
+    return 0
+
+
+def cmd_send_md(args: argparse.Namespace) -> int:
+    """发送 Markdown AST 消息。"""
+    rid = args.rid or _env("TARGET_RID")
+    if not rid:
+        print("⚠️ send-md 需要 TARGET_RID 或 --rid", file=sys.stderr)
+        return 1
+
+    md: list[dict[str, Any]] = []
+
+    if args.md_json:
+        # 从 JSON 字符串解析
+        try:
+            md = json.loads(args.md_json)
+        except json.JSONDecodeError as exc:
+            print(f"⚠️ --md-json 解析失败: {exc}", file=sys.stderr)
+            return 1
+    elif args.md_file:
+        # 从 JSON 文件读取
+        path = os.path.expanduser(args.md_file)
+        try:
+            with open(path, encoding="utf-8") as f:
+                md = json.load(f)
+        except (OSError, json.JSONDecodeError) as exc:
+            print(f"⚠️ 读取 --md-file 失败: {exc}", file=sys.stderr)
+            return 1
+    elif args.text:
+        # 从纯文本自动构造简单 md 结构
+        md = [
+            {
+                "type": "PARAGRAPH",
+                "value": [{"type": "PLAIN_TEXT", "value": args.text}]
+            }
+        ]
+    else:
+        print("⚠️ 需要 --md-json, --md-file 或 --text", file=sys.stderr)
+        return 1
+
+    if not isinstance(md, list):
+        print("⚠️ md 必须是数组格式", file=sys.stderr)
+        return 1
+
+    data = _send_md(rid, md, args.timeout)
+    if args.json:
+        print(json.dumps(data, ensure_ascii=False, indent=2))
+    else:
+        print(json.dumps(data, ensure_ascii=False, indent=2))
+    return 0
+
+
+def main() -> int:
+    p = argparse.ArgumentParser(description="Appia Claw (groups.get / message.send)")
+    p.add_argument("--timeout", type=float, default=60.0)
+    sub = p.add_subparsers(dest="cmd", required=True)
+
+    gp = sub.add_parser("groups", help="GET agent.groups.get")
+    gp.add_argument("--json", action="store_true")
+    gp.set_defaults(_run=cmd_groups)
+
+    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.add_argument("--file", "-f", help="长文本文件")
+    sp.add_argument("--text", "-t", help="短文本")
+    sp.add_argument("--rid", help="覆盖 TARGET_RID")
+    sp.add_argument("--json", action="store_true")
+    sp.set_defaults(_run=cmd_send)
+
+    smp = sub.add_parser("send-md", help="POST agent.message.send（Markdown AST md）")
+    smp.add_argument("--md-json", "-j", help="md JSON 字符串")
+    smp.add_argument("--md-file", "-f", help="md JSON 文件路径")
+    smp.add_argument("--text", "-t", help="纯文本（自动转为简单 md 结构）")
+    smp.add_argument("--rid", help="覆盖 TARGET_RID")
+    smp.add_argument("--json", action="store_true")
+    smp.set_defaults(_run=cmd_send_md)
+
+    args = p.parse_args()
+    runner = getattr(args, "_run", None)
+    if runner is None:
+        return 1
+    return int(runner(args))
+
+
+if __name__ == "__main__":
+    try:
+        raise SystemExit(main())
+    except Exception as exc:  # pragma: no cover - CLI
+        print(f"⚠️ {exc}", file=sys.stderr)
+        raise SystemExit(1)

package/skills/sophnet-qa-install/skill.json

@@ -1,20 +1,27 @@
 {
   "name": "sophnet-qa-install",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "types": [
-    "builtin"
+    "tmp"
   ],
   "displayName": "",
   "description": "",
   "changelog": [
     {
-      "version": "2.0.0",
-      "date": "2026-04-09",
+      "version": "2.0.1",
+      "date": "2026-04-28",
       "changes": [
-        "初次提交"
+        "目前有更有的方案，所有从内置skill中下架删除"
       ]
+    },
+    {
+      "changes": [
+        "初次提交"
+      ],
+      "date": "2026-04-09",
+      "version": "2.0.0"
     }
   ],
   "createdAt": "2026-04-09",
-  "updatedAt": "2026-04-09"
+  "updatedAt": "2026-04-28"
 }

package/skills/sophnet-training-install/skill.json

@@ -1,20 +1,27 @@
 {
   "name": "sophnet-training-install",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "types": [
-    "builtin"
+    "tmp"
   ],
   "displayName": "",
   "description": "",
   "changelog": [
     {
-      "version": "2.0.0",
-      "date": "2026-04-09",
+      "version": "2.0.1",
+      "date": "2026-04-28",
       "changes": [
-        "初次提交"
+        "有更好的方案，所有取消内置，并下架删除"
       ]
+    },
+    {
+      "changes": [
+        "初次提交"
+      ],
+      "date": "2026-04-09",
+      "version": "2.0.0"
     }
   ],
   "createdAt": "2026-04-09",
-  "updatedAt": "2026-04-09"
+  "updatedAt": "2026-04-28"
 }