sophhub 0.4.19 → 0.4.21

package/skills/sessions-analysis/skill.json

@@ -1,34 +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"
-}
+{
+  "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

@@ -1,81 +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`），调用时替换为实际路径。
+---
+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

@@ -1,5 +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"
+[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

@@ -1,206 +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', '')}")
+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()