sophhub 0.4.1 → 0.4.2

package/agents/ai-cs-admin/AGENTS.md

@@ -10,7 +10,7 @@
 
 `workspace-qa/memory/` 为知识库内容的访问映射，供客服 Agent 查询使用；知识库的实际维护以 `knowledge/` 目录为准。
 
-可以通过调用 `sessions-analysis` skill 获取问答 Agent 的会话记录，问答 Agent 的会话记录存放在 `/home/node/.openclaw/agents/qa-agent/sessions/` 目录下。
+可以通过调用 `sessions-analysis` skill 获取问答 Agent 的会话记录，问答 Agent 的会话记录存放在 `/home/node/.openclaw/agents/ai-cs-qa/sessions/` 目录下。
 
 本会话面向管理员使用，默认依赖会话隔离进行访问控制，不额外要求口令认证；若部署环境发生变化，应由外层系统补充身份校验。
 

package/package.json

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

package/skills/bot-secret/skill.json

@@ -0,0 +1,27 @@
+{
+  "name": "bot-secret",
+  "version": "1.0.1",
+  "types": [
+    "store"
+  ],
+  "displayName": "客服秘钥管理",
+  "description": "管理客服秘钥",
+  "changelog": [
+    {
+      "changes": [
+        "pyproject.toml 版本与 skill 对齐"
+      ],
+      "date": "2026-04-21",
+      "version": "1.0.1"
+    },
+    {
+      "changes": [
+        "初次提交"
+      ],
+      "date": "2026-04-21",
+      "version": "1.0.0"
+    }
+  ],
+  "createdAt": "2026-04-21",
+  "updatedAt": "2026-04-21"
+}

package/skills/bot-secret/src/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: bot-secret
+description: Query and reset the customer service (qa-agent) API Secret. Use when the user asks to view, query, or reset API Secret, 查询客服 API Secret, 重置 API Secret.
+---
+
+# 客服子系统 API Secret 管理
+
+查询或重置 qa-agent 的 API Secret（读写 openclaw 配置文件）。
+
+## 用法
+
+```bash
+# 查询
+uv run {baseDir}/scripts/secret.py get
+
+# 重置
+uv run {baseDir}/scripts/secret.py reset
+```
+
+## 输出格式
+
+- 获取成功：`当前API Secret为：xxx`
+- 重置成功：`API Secret已重置为：yyy`
+
+## 注意事项
+
+- `reset` 会直接修改配置文件 `/home/node/.openclaw/openclaw.json`，执行前确认环境正确。
+- 配置中缺少 `channels.bot-api.accounts.qa-agent` 时，`get` 无输出，`reset` 不会自动创建缺失节点。

package/skills/bot-secret/src/pyproject.toml

@@ -0,0 +1,5 @@
+[project]
+name = "bot-secret"
+version = "1.0.1"
+description = "Query and reset qa-agent API Secret from openclaw config"
+requires-python = ">=3.10"

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

@@ -0,0 +1,68 @@
+import json
+import os
+import secrets
+import sys
+
+
+def get_api_secret(config_path: str = "/home/node/.openclaw/openclaw.json"):
+    if not os.path.exists(config_path):
+        raise FileNotFoundError(f"Config file not found: {config_path}")
+    try:
+        with open(config_path, "r", encoding="utf-8") as f:
+            config = json.load(f)
+    except json.JSONDecodeError:
+        raise ValueError(f"Invalid JSON in config file: {config_path}")
+    channels = config.get("channels", {})
+    bot_api_channel_config = channels.get("bot-api", {})
+    if not bot_api_channel_config:
+        return None
+    accounts_config = bot_api_channel_config.get("accounts", {})
+    if not accounts_config:
+        return None
+    qa_agent_config = accounts_config.get("qa-agent", {})
+    if not qa_agent_config:
+        return None
+    return qa_agent_config.get("apiSecret", None)
+
+
+def reset_api_secret(config_path: str = "/home/node/.openclaw/openclaw.json"):
+    if not os.path.exists(config_path):
+        raise FileNotFoundError(f"Config file not found: {config_path}")
+    try:
+        with open(config_path, "r", encoding="utf-8") as f:
+            config = json.load(f)
+    except json.JSONDecodeError:
+        raise ValueError(f"Invalid JSON in config file: {config_path}")
+    channels = config.get("channels", {})
+    bot_api_channel_config = channels.get("bot-api", {})
+    if not bot_api_channel_config:
+        return None
+    accounts_config = bot_api_channel_config.get("accounts", {})
+    if not accounts_config:
+        return None
+    qa_agent_config = accounts_config.get("qa-agent", {})
+    if not qa_agent_config:
+        return None
+    new_secret = secrets.token_hex(32)
+    qa_agent_config["apiSecret"] = new_secret
+    config["channels"]["bot-api"]["accounts"]["qa-agent"] = qa_agent_config
+    with open(config_path, "w", encoding="utf-8") as f:
+        json.dump(config, f, ensure_ascii=False, indent=4)
+    return new_secret
+
+
+if __name__ == "__main__":
+    if len(sys.argv) != 2:
+        print("Usage: python secret.py <reset|get>")
+        sys.exit(1)
+    if sys.argv[1] == "reset":
+        new_secret = reset_api_secret()
+        if new_secret is not None:
+            print(f"API Secret已重置为：{new_secret}")
+    elif sys.argv[1] == "get":
+        secret = get_api_secret()
+        if secret is not None:
+            print(f"当前API Secret为：{secret}")
+    else:
+        print("Usage: python secret.py <reset|get>")
+        sys.exit(1)

package/skills/image-description/skill.json

@@ -0,0 +1,27 @@
+{
+  "name": "image-description",
+  "version": "1.0.1",
+  "types": [
+    "store"
+  ],
+  "displayName": "图片描述",
+  "description": "生成图片描述",
+  "changelog": [
+    {
+      "changes": [
+        "在 pyproject.toml 中声明 sophnet-tools 依赖，并与 skill 版本对齐"
+      ],
+      "date": "2026-04-21",
+      "version": "1.0.1"
+    },
+    {
+      "changes": [
+        "初次提交"
+      ],
+      "date": "2026-04-21",
+      "version": "1.0.0"
+    }
+  ],
+  "createdAt": "2026-04-21",
+  "updatedAt": "2026-04-21"
+}

package/skills/image-description/src/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: image-description
+description: Generate image descriptions with VLM. Use when the user asks to describe images, 图像描述, 看图说话, or extract visible content from an image URL/base64/local file.
+---
+
+## 用法
+
+```bash
+# 使用 URL
+uv run {baseDir}/scripts/ana_image.py "https://example.com/a.jpg"
+
+# 使用本地文件（会先上传 OSS 再调用模型）
+uv run {baseDir}/scripts/ana_image.py "/path/to/local.png"
+
+# 使用 base64（直接透传到接口）
+uv run {baseDir}/scripts/ana_image.py "data:image/iVBORw0KGgoAAAANSUhEUgAA..."
+
+```
+
+## 输出格式
+
+- 成功：直接输出图片描述文本。
+- 失败：抛出错误信息（HTTP 错误、网络错误、输入格式错误等）。

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

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

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

@@ -0,0 +1,107 @@
+import json
+import os
+import base64
+import argparse
+import urllib.error
+import urllib.request
+import sophnet_tools
+
+API_URL = "https://www.sophnet.com/api/open-apis/v1/chat/completions"
+MODEL = "Qwen2.5-VL-32B-Instruct"
+
+
+def _is_likely_base64(raw: str) -> bool:
+    text = raw.strip()
+    if not text or any(ch.isspace() for ch in text):
+        return False
+    try:
+        base64.b64decode(text, validate=True)
+        return True
+    except Exception:
+        return False
+
+
+def normalize_image_input(image_input: str, upload_timeout: int = 30) -> str:
+    text = image_input.strip()
+    if not text:
+        raise ValueError("图片输入不能为空")
+
+    if text.startswith(("http://", "https://")):
+        return text
+
+    if text.startswith("data:image/") and ";base64," in text:
+        return text
+
+    if os.path.exists(text):
+        return sophnet_tools.upload_oss(text, upload_timeout)
+
+    if _is_likely_base64(text):
+        return text
+
+    raise ValueError("无法识别图片输入：请传入 URL、base64 或本地文件路径")
+
+
+def call_vlm(image_input: str) -> str:
+    api_key = sophnet_tools.get_api_key()
+    image_url = normalize_image_input(image_input)
+   
+    payload = {
+        "messages": [
+            {
+                "role": "system",
+                "content": "详细描述图片中的所有内容，包括文字、物体、场景、人物等。直接描述，禁止废话",
+            },
+            {
+                "role": "user",
+                "content": [
+                    {
+                        "type": "image_url",
+                        "image_url": {"url": image_url},
+                    }
+                ],
+            },
+        ],
+        "model": MODEL,
+        "stream": False,
+    }
+
+    body = json.dumps(payload).encode("utf-8")
+    request = urllib.request.Request(
+        url=API_URL,
+        data=body,
+        method="POST",
+        headers={
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+            "Authorization": f"Bearer {api_key}",
+        },
+    )
+
+    try:
+        with urllib.request.urlopen(request, timeout=120) as response:
+            raw = response.read().decode("utf-8")
+            data = json.loads(raw)
+    except urllib.error.HTTPError as exc:
+        detail = exc.read().decode("utf-8", errors="ignore")
+        raise RuntimeError(f"HTTPError: {exc.code} {exc.reason} | {detail}") from exc
+    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)
+
+
+def build_parser():
+    parser = argparse.ArgumentParser(description="调用 VLM 生成图片描述")
+    parser.add_argument(
+        "image",
+        help="图片输入，支持 http(s) URL、base64、data URL 或本地文件路径",
+    )
+    return parser
+
+
+if __name__ == "__main__":
+    args = build_parser().parse_args()
+    print(call_vlm(args.image))

package/skills/sessions-analysis/skill.json

@@ -0,0 +1,34 @@
+{
+  "name": "sessions-analysis",
+  "version": "1.0.2",
+  "types": [
+    "store"
+  ],
+  "displayName": "日志分析",
+  "description": "分析客服日志",
+  "changelog": [
+    {
+      "changes": [
+        "默认会话日志目录从 qa-agent 改为 ai-cs-qa；与 pyproject 版本对齐"
+      ],
+      "date": "2026-04-21",
+      "version": "1.0.2"
+    },
+    {
+      "changes": [
+        "日志目录不存在或不可读时返回空结果；新增 pyproject.toml"
+      ],
+      "date": "2026-04-21",
+      "version": "1.0.1"
+    },
+    {
+      "changes": [
+        "初次提交"
+      ],
+      "date": "2026-04-21",
+      "version": "1.0.0"
+    }
+  ],
+  "createdAt": "2026-04-21",
+  "updatedAt": "2026-04-21"
+}

package/skills/sessions-analysis/src/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: sessions-analysis
+description: 查询指定日期的 QA 客服问答记录。当用户询问「昨天/今天客户问了哪些问题」「某天的问答记录」「QA 记录查询」时使用。默认从 ai-cs-qa 会话日志目录读取。
+---
+
+# QA 记录查询
+
+从 ai-cs-qa 会话日志中按日期汇总用户提问与助手回答，用于查看某天的客服问答记录。
+
+## Processing Mode
+
+**STRICT SERIAL PROCESSING ONLY** — 单次顺序执行，不拆分子任务、不并行。
+
+## Prerequisites
+
+- Python 3.10+
+- 日志目录可读（默认 `/home/node/.openclaw/agents/ai-cs-qa/sessions/`）
+
+## 默认日志目录
+
+- **默认路径**：`/home/node/.openclaw/agents/ai-cs-qa/sessions/`
+- 支持当前日志（`*.jsonl`）与轮转日志（`*.jsonl.reset.YYYY-MM-DDTHH-MM-SS.*`）
+- 若需使用其他目录，通过 `--log-dir` / `-d` 指定
+
+## Usage
+
+当用户要查看某天的 QA 记录时：
+
+1. **解析日期**：从用户表述推断查询日期（如「昨天」「今天」「2026-03-05」），格式统一为 `YYYY-MM-DD`。
+2. **执行脚本**（在 workspace 或 skill 目录下用 uv 运行）：
+
+```bash
+uv run {baseDir}/scripts/ana_logs.py [YYYY-MM-DD] [--log-dir /path/to/sessions] [--json]
+```
+
+## Parameters
+
+| 参数 | 说明 | 默认值 |
+|------|------|--------|
+| `date` | 查询日期，格式 `YYYY-MM-DD` | 当天 |
+| `--log-dir` / `-d` | 会话日志所在目录 | `/home/node/.openclaw/agents/ai-cs-qa/sessions/` |
+| `--json` | 以 JSON 数组输出 | 否（人类可读文本） |
+
+## Output
+
+**不加 `--json` 时**（默认）：
+
+```
+[YYYY-MM-DD HH:MM:SS] Q: 用户问题内容
+  A: 助手回答内容
+
+[YYYY-MM-DD HH:MM:SS] Q: 下一个问题
+  A: 对应回答
+```
+
+**加 `--json` 时**：输出 JSON 数组，每项形如 `{"Q": "问题", "DATE": "YYYY-MM-DD HH:MM:SS", "A": "回答"}`。
+
+**向用户展示时建议**：先说明查询日期与记录条数，再按时间顺序列出「时间 - 问题 - 回答」摘要；若记录较多可只展示前 N 条并注明「共 N 条，仅展示前若干条」。
+
+## Example Workflow
+
+- 用户：「昨天客户都问了哪些问题」
+  1. 计算昨天日期，如 `2026-03-05`
+  2. 执行：`uv run {baseDir}/scripts/ana_logs.py 2026-03-05`
+  3. 解析输出，向用户汇总展示
+
+- 用户：「查一下 3 月 4 号的 QA 记录」
+  1. 日期：`2026-03-04`
+  2. 执行：`uv run {baseDir}/scripts/ana_logs.py 2026-03-04`
+  3. 展示结果
+
+- 用户：「从 /data/qa-logs 查今天的问答」
+  1. 日期：当天
+  2. 执行：`uv run {baseDir}/scripts/ana_logs.py --log-dir /data/qa-logs`
+  3. 展示结果
+
+## Notes
+
+- 脚本仅读取可能包含该日期的日志文件（当前日志视为含「今天+昨天」，轮转日志按文件名日期判断），再按记录内时间戳过滤到指定日期。
+- 若目录不存在或无可读日志，脚本不会报错但结果为空；此时可提示用户检查日志目录或日期。
+- `{baseDir}` 指本 skill 根目录（如 `skills/sessions-analysis`），调用时替换为实际路径。

package/skills/sessions-analysis/src/pyproject.toml

@@ -0,0 +1,5 @@
+[project]
+name = "sessions-analysis"
+version = "1.0.2"
+description = "Query QA session logs by date from ai-cs-qa jsonl"
+requires-python = ">=3.10"

package/skills/sessions-analysis/src/scripts/ana_logs.py

@@ -0,0 +1,206 @@
+import os
+from datetime import datetime, timedelta
+import json
+from typing import List
+
+# 列出文件夹中所有的日志文件（当前日志 + 轮转日志）
+def list_logs(folder):
+    if not os.path.isdir(folder):
+        return []
+    try:
+        names = os.listdir(folder)
+    except OSError:
+        return []
+    logs = []
+    for file in names:
+        # 当前日志：xxx.jsonl
+        if file.endswith(".jsonl") and ".jsonl.reset." not in file:
+            logs.append(os.path.join(folder, file))
+        # 轮转日志：xxx.jsonl.reset.YYYY-MM-DDTHH-MM-SS.ZZZZ
+        elif ".jsonl.reset." in file:
+            logs.append(os.path.join(folder, file))
+    return logs
+
+# 获取日志保存的时间戳，返回该文件覆盖的日期 (当天, 前一天)
+def get_log_save_time(file_path: str):
+    """返回 (date1, date2)，表示该日志文件最多只包含 date1 和 date2 两天的数据。"""
+    name = os.path.basename(file_path)
+    # 当前日志：xxx.jsonl → 今天 + 昨天
+    if name.endswith(".jsonl") and ".jsonl.reset." not in name:
+        today = datetime.now().strftime("%Y-%m-%d")
+        prev = (datetime.now() - timedelta(days=1)).strftime("%Y-%m-%d")
+        return today, prev
+    # 轮转日志：xxx.jsonl.reset.YYYY-MM-DDTHH-MM-SS.703Z → 轮转日 + 轮转前一日
+    if ".jsonl.reset." in name:
+        part = name.split("reset.")[-1]
+        save_date = part.split("T")[0]  # YYYY-MM-DD
+        try:
+            dt = datetime.strptime(save_date, "%Y-%m-%d")
+            prev = (dt - timedelta(days=1)).strftime("%Y-%m-%d")
+            return save_date, prev
+        except ValueError:
+            return None, None
+    return None, None
+
+def extract_user_questions(path: str) -> List[dict]:
+    """
+    从日志 jsonl 中提取用户提问及对应的回答。
+    返回格式: [{"Q": "问题", "DATE": "Y-M-D H:M:S", "A": "回答"}, ...]
+    只保留包含 message_id 的用户消息。
+    """
+    records = []
+    with open(path, "r", encoding="utf-8") as f:
+        for line in f:
+            line = line.strip()
+            if not line:
+                continue
+            try:
+                records.append(json.loads(line))
+            except json.JSONDecodeError:
+                continue
+
+    results: List[dict] = []
+
+    for i, record in enumerate(records):
+        if record.get("type") != "message":
+            continue
+        message = record.get("message", {})
+        if message.get("role") != "user":
+            continue
+
+        question = None
+        date_str = None
+
+        for item in (message.get("content") or []):
+            if item.get("type") != "text":
+                continue
+            text = item.get("text", "")
+            if '"message_id"' not in text:
+                continue
+
+            lines = [l.strip() for l in text.splitlines() if l.strip()]
+            last_line = lines[-1] if lines else ""
+            question = None
+
+            # 格式一：末行形如 [Fri 2026-03-06 16:09 GMT+8] 算能有哪些产品
+            if last_line.startswith("[") and "]" in last_line:
+                time_part, question = last_line.split("]", 1)
+                question = question.strip()
+                ts = record.get("timestamp", "")
+                try:
+                    dt = datetime.fromisoformat(ts.replace("Z", "+00:00"))
+                    dt_local = dt.astimezone()
+                    date_str = dt_local.strftime("%Y-%m-%d %H:%M:%S")
+                except Exception:
+                    date_str = time_part.strip("[] ").strip()
+            else:
+                # 格式二：Conversation info + 元数据 JSON 块 + 空行 + 问题（无方括号时间戳）
+                # 取最后一行作为问题，跳过纯 JSON/代码块行
+                for candidate in reversed(lines):
+                    if candidate.startswith("```") or candidate.startswith("{") or candidate.startswith("}"):
+                        continue
+                    if "message_id" in candidate and "sender" in candidate:
+                        continue
+                    question = candidate.strip()
+                    break
+                ts = record.get("timestamp", "")
+                try:
+                    dt = datetime.fromisoformat(ts.replace("Z", "+00:00"))
+                    dt_local = dt.astimezone()
+                    date_str = dt_local.strftime("%Y-%m-%d %H:%M:%S")
+                except Exception:
+                    date_str = ""
+            if question:
+                break
+
+        if question is None:
+            continue
+
+        # 向后收集 assistant 的文本回答，直到遇到下一个 user 消息
+        answer_parts = []
+        for j in range(i + 1, len(records)):
+            r = records[j]
+            if r.get("type") != "message":
+                continue
+            msg = r.get("message", {})
+            if msg.get("role") == "user":
+                break
+            if msg.get("role") == "assistant":
+                for item in (msg.get("content") or []):
+                    if item.get("type") == "text" and item.get("text", "").strip():
+                        answer_parts.append(item["text"].strip())
+
+        results.append({
+            "Q": question,
+            "DATE": date_str,
+            "A": "\n".join(answer_parts),
+        })
+
+    return results
+
+
+def get_daily_qa(date: str, log_folder: str="/home/node/.openclaw/agents/ai-cs-qa/sessions/") -> List[dict]:
+    """
+    按日期汇总当天的 QA 结果。仅根据 get_log_save_time 读取可能包含该日期的日志文件。
+
+    参数:
+        date: 查询日期，格式 'YYYY-MM-DD'
+        log_folder: 日志文件所在目录
+
+    返回:
+        [{"Q": "问题", "DATE": "YYYY-MM-DD HH:MM:SS", "A": "回答"}, ...]
+    """
+    daily_results: List[dict] = []
+
+    for log_path in list_logs(log_folder):
+        d1, d2 = get_log_save_time(log_path)
+        if d1 is None or date not in (d1, d2):
+            continue
+
+        try:
+            qas = extract_user_questions(log_path)
+        except FileNotFoundError:
+            continue
+
+        for item in qas:
+            dt_str = (item.get("DATE") or "").strip()
+            if dt_str.startswith(date):
+                daily_results.append(item)
+
+    return daily_results
+
+
+# 默认 QA 会话日志目录（可被 skill/CLI 覆盖）
+DEFAULT_LOG_FOLDER = "/home/node/.openclaw/agents/ai-cs-qa/sessions/"
+
+
+if __name__ == "__main__":
+    import argparse
+    parser = argparse.ArgumentParser(description="查询指定日期的 QA 记录")
+    parser.add_argument(
+        "date",
+        nargs="?",
+        default=datetime.now().strftime("%Y-%m-%d"),
+        help="查询日期，格式 YYYY-MM-DD，默认今天",
+    )
+    parser.add_argument(
+        "--log-dir",
+        "-d",
+        default=DEFAULT_LOG_FOLDER,
+        help="日志目录，默认 %(default)s",
+    )
+    parser.add_argument(
+        "--json",
+        action="store_true",
+        help="以 JSON 数组输出",
+    )
+    args = parser.parse_args()
+
+    daily_qa = get_daily_qa(args.date, args.log_dir)
+    if args.json:
+        print(json.dumps(daily_qa, ensure_ascii=False, indent=2))
+    else:
+        for qa in daily_qa:
+            print(f"[{qa.get('DATE', '')}] Q: {qa.get('Q', '')}")
+            print(f"  A: {qa.get('A', '')}")
+            print()