sophhub 0.1.0

package/skills/builtin/sophnet-training-install/scripts/check_installed.py

@@ -0,0 +1,144 @@
+"""
+校验智能培训系统安装状态。
+
+三种状态（退出码）：
+  0 — INSTALLED：已安装，无需操作
+  1 — NOT_INSTALLED：未安装
+  2 — UPDATABLE：可更新
+
+同时输出配置状态（CONFIG_FOUND / CONFIG_NOT_FOUND）。
+当状态为 UPDATABLE 且配置存在时，额外输出已有的 ADMIN_NAME / QA_NAME。
+"""
+
+import argparse
+import json
+import os
+import sys
+
+
+def get_workspace_root(config_path: str) -> str:
+    """从 openclaw.json 所在目录推导 workspace 根目录（.openclaw）。"""
+    return os.path.dirname(os.path.abspath(config_path))
+
+
+def step2_artifacts_exist(workspace_root: str) -> bool:
+    """检查 Step 2 要创建的目录和软链接是否已存在。"""
+    base = os.path.join(workspace_root, "workspace-training")
+    workspace_qa = os.path.join(base, "workspace-qa")
+
+    if not os.path.isdir(workspace_qa):
+        return False
+
+    return True
+
+
+def agents_already_in_config(config_path: str) -> bool:
+    """检查 openclaw.json 中是否已包含 training-admin 和 training-qa。"""
+    if not os.path.exists(config_path):
+        return False
+    try:
+        with open(config_path, "r", encoding="utf-8") as f:
+            config = json.load(f)
+    except (json.JSONDecodeError, OSError):
+        return False
+    agents = config.get("agents", {}).get("list", [])
+    ids = {a.get("id") for a in agents if isinstance(a, dict) and a.get("id")}
+    return "training-admin" in ids and "training-qa" in ids
+
+
+def get_agent_names(config_path: str) -> tuple[str, str]:
+    """从 openclaw.json 读取 training-admin 和 training-qa 的显示名称。"""
+    admin_name, qa_name = "培训管理员", "培训助手"
+    try:
+        with open(config_path, "r", encoding="utf-8") as f:
+            config = json.load(f)
+        for agent in config.get("agents", {}).get("list", []):
+            if not isinstance(agent, dict):
+                continue
+            if agent.get("id") == "training-admin" and agent.get("name"):
+                admin_name = agent["name"]
+            elif agent.get("id") == "training-qa" and agent.get("name"):
+                qa_name = agent["name"]
+    except (json.JSONDecodeError, OSError):
+        pass
+    return admin_name, qa_name
+
+
+def parse_version(v: str) -> tuple:
+    """将版本号字符串解析为可比较的整数元组。"""
+    try:
+        return tuple(int(x) for x in v.strip().split("."))
+    except (ValueError, AttributeError):
+        return ()
+
+
+def get_installed_version(workspace_root: str) -> str | None:
+    """读取 workspace-training/git_version 中的版本号。"""
+    version_file = os.path.join(workspace_root, "workspace-training", "git_version")
+    if not os.path.isfile(version_file):
+        return None
+    try:
+        with open(version_file, "r", encoding="utf-8") as f:
+            return f.read().strip()
+    except OSError:
+        return None
+
+
+def check_installed(config_path: str, target_version: str) -> int:
+    """
+    判断安装状态。
+    返回: 0=已安装, 1=未安装, 2=可更新
+    """
+    workspace_root = get_workspace_root(config_path)
+
+    if not step2_artifacts_exist(workspace_root):
+        return 1
+
+    installed_version = get_installed_version(workspace_root)
+    if installed_version is None or parse_version(installed_version) < parse_version(target_version):
+        return 2
+
+    if not agents_already_in_config(config_path):
+        return 1
+
+    return 0
+
+
+def main():
+    parser = argparse.ArgumentParser(description="校验智能培训系统安装状态")
+    parser.add_argument(
+        "--config",
+        default="/home/node/.openclaw/openclaw.json",
+        help="openclaw.json 路径",
+    )
+    parser.add_argument(
+        "--version",
+        required=True,
+        help="目标版本号（例：1.0.1）",
+    )
+    args = parser.parse_args()
+
+    config_path = args.config
+    status = check_installed(config_path, args.version)
+    config_exists = agents_already_in_config(config_path)
+
+    if status == 0:
+        print("INSTALLED")
+        print("CONFIG_FOUND" if config_exists else "CONFIG_NOT_FOUND")
+        sys.exit(0)
+    elif status == 2:
+        print("UPDATABLE")
+        print("CONFIG_FOUND" if config_exists else "CONFIG_NOT_FOUND")
+        if config_exists:
+            admin_name, qa_name = get_agent_names(config_path)
+            print(f"ADMIN_NAME={admin_name}")
+            print(f"QA_NAME={qa_name}")
+        sys.exit(2)
+    else:
+        print("NOT_INSTALLED")
+        print("CONFIG_FOUND" if config_exists else "CONFIG_NOT_FOUND")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/skills/builtin/sophnet-training-install/scripts/update_config.py

@@ -0,0 +1,142 @@
+"""
+OpenClaw 配置更新脚本
+
+向 openclaw.json 中追加 training-admin、training-qa 以及 main 三个 agent 的配置。
+"""
+
+import argparse
+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("training-qa", {})
+    if not qa_agent_config:
+        return None
+    return qa_agent_config.get("apiSecret", None)
+
+
+def update_config(admin_name: str, qa_name: str, config_path: str = "/home/node/.openclaw/openclaw.json"):
+    if not os.path.exists(config_path):
+        raise FileNotFoundError(f"Config file not found: {config_path}")
+
+    with open(config_path, "r", encoding="utf-8") as f:
+        config = json.load(f)
+
+    admin_agent_config = {
+        "id": "training-admin",
+        "workspace": "/home/node/.openclaw/workspace-training",
+        "identity": {
+            "name": admin_name,
+            "theme": admin_name,
+            "emoji": "🤖"
+        },
+        "subagents": {
+            "allowAgents": ["training-qa"]
+        }
+    }
+    qa_agent_config = {
+        "id": "training-qa",
+        "workspace": "/home/node/.openclaw/workspace-training/workspace-qa",
+        "identity": {
+            "name": qa_name,
+            "theme": qa_name,
+            "emoji": "💁"
+        },
+        "tools": {
+            "deny": ["exec", "web_search", "web_fetch"]
+        }
+    }
+    main_agent_config = {
+        "id": "main",
+        "workspace": "/home/node/.openclaw/workspace",
+        "identity": {
+            "name": "main",
+            "theme": "main",
+            "emoji": "🦞"
+        }
+    }
+
+    qa_agent_account_config = {
+        "agentId": "training-qa",
+        "name": qa_name,
+        "apiSecret": secrets.token_hex(32),
+        "enabled": True
+    }
+    config.setdefault("agents", {})
+    agents = config.get("agents", {}).get("list", [])
+    has_main = False
+    for agent in agents:
+        aid = agent.get("id") if isinstance(agent, dict) else None
+        if aid == "main":
+            has_main = True
+        elif aid == "training-admin":
+            raise ValueError("培训管理员 agent 已存在")
+        elif aid == "training-qa":
+            raise ValueError("培训助手 agent 已存在")
+
+    if not has_main:
+        agents.append(main_agent_config)
+    agents.append(admin_agent_config)
+    agents.append(qa_agent_config)
+    config["agents"]["list"] = agents
+
+    # 启用 bot-api 插件（用 setdefault 保证 plugins.entries 与 bot-api 存在，避免 KeyError）
+    plugins = config.get("plugins", {})
+    entries = plugins.setdefault("entries", {})
+    entries.setdefault("bot-api", {})["enabled"] = True
+    config["plugins"] = plugins
+
+    # 添加培训子系统的channel配置
+    channels = config.get("channels", {})
+    bot_api_channel_config = channels.get("bot-api", {})
+    if bot_api_channel_config:
+        accounts_config = bot_api_channel_config.get("accounts", {})
+        accounts_config["training-qa"] = qa_agent_account_config
+        bot_api_channel_config["accounts"] = accounts_config
+    else:
+        bot_api_channel_config = {
+            "accounts": {
+                "training-qa": qa_agent_account_config
+            }
+        }
+    channels["bot-api"] = bot_api_channel_config
+    config["channels"] = channels
+
+    with open(config_path, "w", encoding="utf-8") as f:
+        json.dump(config, f, indent=4, ensure_ascii=False)
+    return True
+
+
+def main():
+    parser = argparse.ArgumentParser(description="向 openclaw.json 注入培训 agent 配置")
+    parser.add_argument("--admin-name", default="培训管理员", help="培训管理员显示名称")
+    parser.add_argument("--qa-name", default="培训助手", help="培训助手显示名称")
+    parser.add_argument("--config", default="/home/node/.openclaw/openclaw.json", help="openclaw.json 路径")
+    args = parser.parse_args()
+    try:
+        update_config(args.admin_name, args.qa_name, args.config)
+        print(f"✅ 配置更新成功：管理员={args.admin_name}, 培训={args.qa_name}")
+        print(f"培训助手 API Secret: {get_api_secret(args.config)}")
+    except Exception as e:
+        print(f"❌ 配置更新失败：{e}")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/skills/builtin/sophnet-training-install/scripts/update_md.py

@@ -0,0 +1,73 @@
+#!/usr/bin/env python3
+"""
+修改指定目录下所有 .md 文件中的占位符：
+- {{培训助手}} -> qa_name
+- {{知识库管理员}} -> admin_name
+仅处理目标目录本身，不递归子文件夹。
+"""
+
+import argparse
+from pathlib import Path
+
+
+def update_md_in_dir(
+    dir_path: str | Path,
+    qa_name: str = "培训助手",
+    admin_name: str = "培训管理员",
+) -> int:
+    """
+    修改指定目录下所有 .md 文件中的占位符（仅该目录，不含子文件夹）。
+    返回 0 成功，1 目录不存在，2 读写文件失败。
+    """
+    root = Path(dir_path)
+    if not root.is_dir():
+        print(f"错误：目录不存在 {root}")
+        return 1
+
+    md_files = [f for f in root.iterdir() if f.is_file() and f.suffix == ".md"]
+    if not md_files:
+        print(f"在 {root} 下未找到 .md 文件")
+        return 0
+
+    replacements = [
+        ("{{培训助手}}", qa_name),
+        ("{{知识库管理员}}", admin_name),
+    ]
+
+    for path in md_files:
+        try:
+            text = path.read_text(encoding="utf-8")
+        except OSError as e:
+            print(f"错误：无法读取 {path}：{e}")
+            return 2
+        original = text
+        for old, new in replacements:
+            text = text.replace(old, new)
+        if text != original:
+            try:
+                path.write_text(text, encoding="utf-8")
+            except OSError as e:
+                print(f"错误：无法写入 {path}：{e}")
+                return 2
+            print(f"已更新: {path}")
+        else:
+            print(f"无需修改: {path}")
+
+    return 0
+
+
+def main():
+    parser = argparse.ArgumentParser(description="替换 .md 文件中的占位符")
+    parser.add_argument("--qa-name", default="培训助手", help="替换 {{培训助手}} 的值")
+    parser.add_argument("--admin-name", default="培训管理员", help="替换 {{知识库管理员}} 的值")
+    parser.add_argument(
+        "--dir",
+        default="/home/node/.openclaw/workspace-training",
+        help="要处理的目录路径（仅该目录下的 .md，不含子目录）",
+    )
+    args = parser.parse_args()
+    return update_md_in_dir(args.dir, qa_name=args.qa_name, admin_name=args.admin_name)
+
+
+if __name__ == "__main__":
+    exit(main())

package/skills/builtin/sophnet-tts/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: sophnet-tts
+description: 当用户需要将文本转语音（TTS）时使用。支持自动识别输入中的音色；若未指定音色则先提供可选声音风格让用户选择，指定后直接生成音频并返回 24 小时有效下载链接。
+---
+
+# Sophnet TTS
+
+## 概述
+
+使用 `scripts/gen_tts.py` 调用 Sophnet TTS 接口，把文本转换为音频并返回下载链接。
+
+脚本路径：`{baseDir}/scripts/gen_tts.py`
+
+## 何时使用
+
+- 用户要求“生成语音 / 文本转语音 / 配音”
+- 用户给出一段文本希望合成音频
+- 用户指定了音色，或希望先选择音色
+
+## 声音风格（可选项）
+
+- 清甜推销女
+- 呆萌机器人
+- 经典猴哥
+- 毒舌心机女
+- 欢脱粤语男
+- 原味陕北男
+- 甜美闽南女
+- 娇率才女音
+- 得道高僧
+- 利落从容女
+- 清爽利落男
+- 优雅知性女
+- 居家暖男
+- 正经青年女
+- 知性积极女
+- 沉稳权威女声
+- 沉稳青年男
+- 精准干练女
+- 博才干练男
+- 沉稳播报女
+- 典型播音女
+
+## 处理流程（必须遵循）
+
+1. 从用户输入中提取待合成文本。
+2. 判断输入中是否已经明确包含上述某个声音风格名称。
+3. 若**未包含音色**：
+   - 先回复用户可选声音风格列表，让用户选择其一。
+   - 不要立即调用脚本生成。
+4. 若**已包含音色**（或用户补充了音色）：
+   - 调用脚本执行语音生成。
+   - 命令示例：
+
+   ```bash
+   uv run {baseDir}/scripts/gen_tts.py \
+   --text "要生成的文本" \
+   --voice "优雅知性女" \
+   --speech-rate 1.0
+   ```
+
+5. 输出格式
+
+   ```
+   🎙️ **声音风格**： XXX
+   📝 **播报内容**：XXX
+   🎵 **生成音频**：<audio controls src="http:xxxx"></audio>
+   ⚠️ **提示**: 本内容有AI生成，音频保存24小时，请及时下载保存！
+   ```
+
+## 失败处理
+
+- 若脚本失败或未返回可用链接，明确告知失败原因（若可提取到）。
+- 引导用户重试（可建议缩短文本或更换音色）。
+
+## 注意事项
+
+- `--text` 必填且不能为空。
+- 优先使用用户明确指定的音色；未指定时必须先让用户选择。

package/skills/builtin/sophnet-tts/pyproject.toml

@@ -0,0 +1,9 @@
+[project]
+name = "sophnet-tts"
+version = "0.1.0"
+description = "Skill-local runtime dependencies for sophnet-tts"
+requires-python = ">=3.10"
+dependencies = [
+  "requests>=2.28.0",
+  "sophnet-tools>=0.0.1",
+]

package/skills/builtin/sophnet-tts/scripts/gen_tts.py

@@ -0,0 +1,130 @@
+#!/usr/bin/env python3
+"""
+Sophnet TTS Script
+Supports text-to-speech generation using Sophnet TTS API.
+"""
+import os
+import sys
+import argparse
+import json
+import tempfile
+import requests
+from typing import Optional, Dict, Any
+import sophnet_tools
+
+GENERATE_URL = "https://www.sophnet.com/api/open-apis/projects/easyllms/voice/synthesize-audio"
+
+def create_request(
+    text: Optional[str],
+    voice: Optional[str] = "longyumi_v2",
+    speech_rate: Optional[float] = 1.0
+) -> dict:
+    """Build request body for TTS generation."""
+    payload = {
+        "text": [
+            text,
+        ],
+        "synthesis_param": {
+            "model": "cosyvoice-v2",
+            "voice": voice,
+            "format": "MP3_16000HZ_MONO_128KBPS",
+            "volume": 80,
+            "speechRate": speech_rate,
+            "pitchRate": 1
+        }
+    }
+    return payload
+
+def gen_tts(
+    api_key: str, text: str, voice: str = "longyingxiao", speech_rate: float = 1.0
+) -> Dict[str, Any]:
+    """Make HTTP request with authentication."""
+    clean_text = (text or "").strip()
+    if not clean_text:
+        return {"error": "文本不能为空"}
+
+    headers = {
+        "Authorization": f"Bearer {api_key}",
+        "Content-Type": "application/json"
+    }
+    temp_file_path: Optional[str] = None
+    try:
+        response = requests.post(
+            GENERATE_URL,
+            headers=headers,
+            json=create_request(clean_text, voice, speech_rate),
+            timeout=60
+        )
+        if response.status_code != 200:
+            return {
+                "error": (
+                    f"HTTP请求失败，状态码: {response.status_code}, 响应内容: {response.text}"
+                )
+            }
+
+        with tempfile.NamedTemporaryFile(suffix=".mp3", delete=False) as tmp:
+            temp_file_path = tmp.name
+            f = tmp
+            f.write(response.content)
+
+        result = sophnet_tools.upload_oss(temp_file_path, timeout=120)
+        if result:
+            return {"audio_url": result}
+
+        return {"error": "音频上传失败"}
+    except requests.exceptions.RequestException as e:
+        return {"error": f"HTTP请求失败: {e}"}
+    finally:
+        if temp_file_path and os.path.exists(temp_file_path):
+            os.remove(temp_file_path)
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="Sophnet TTS Script")
+    parser.add_argument("--text", required=True, help="Text to generate audio")
+    parser.add_argument("--voice", type=str, default="优雅知性女", help="Voice name. Defaults to 优雅知性女")
+    parser.add_argument("--speech-rate", type=float, default=1.0, help="Speech rate. Defaults to 1.0")
+    args = parser.parse_args()
+    voice_dict = {
+                    "清甜推销女": "longyingxiao",
+                    "呆萌机器人": "longjiqi", 
+                    "经典猴哥":"longhouge", 
+                    "毒舌心机女":"longjixin", 
+                    "欢脱粤语男":"longanyue", 
+                    "原味陕北男":"longshange", 
+                    "甜美闽南女":"longanmin", 
+                    "娇率才女音":"longdaiyu", 
+                    "得道高僧":"longgaoseng", 
+                    "利落从容女":"longanli", 
+                    "清爽利落男": "longanlang", 
+                    "优雅知性女":"longanwen", 
+                    "居家暖男":"longanyun", 
+                    "正经青年女":"longyumi_v2", 
+                    "知性积极女": "longxiaochun_v2", 
+                    "沉稳权威女声":"longxiaoxia_v2",
+                    "沉稳青年男": "longshu_v2", 
+                    "精准干练女": "loongbella_v2", 
+                    "博才干练男":"longshuo_v2", 
+                    "沉稳播报女":"longxiaobai_v2", 
+                    "典型播音女":"longjing_v2",
+                }
+    api_key = sophnet_tools.get_api_key()
+    if api_key is None:
+       print(f"❌ 未找到 Sophnet API Key，请联系客户支持")
+       sys.exit(1)
+    
+    selected_voice = voice_dict.get(args.voice, voice_dict["优雅知性女"])
+    result = gen_tts(
+        api_key,
+        args.text,
+        voice_dict.get(selected_voice, voice_dict["优雅知性女"]),
+        args.speech_rate,
+    )
+
+    if "audio_url" in result:
+        print(f"🎙️ 声音风格: {selected_voice}")
+        print(f"📝 播报内容: {args.text}")
+        print(f"🎵 生成音频: ![audio]({result['audio_url']})")
+    else:
+        print(f"❌ 音频生成失败: {result.get('error', '音频生成失败')}")
+        sys.exit(1)

package/skills/builtin/sophnet-video-generate/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: sophnet-video-generate
+description: "Generate videos from text prompts or images using Sophnet API. Supports text-to-video (T2V) and image-to-video (I2V) generation with models including Wan2.6-T2V, Wan2.6-I2V, ViduQ2-pro, and Seedance-1.5-Pro. Use when users request video generation, ask to create videos from descriptions, convert images to videos, or specify video generation models. "
+---
+
+# Video Generator
+
+Generate videos using Sophnet's video generation API with support for both text-to-video and image-to-video workflows.
+
+## Supported Models
+
+- **Wan2.6-T2V**: Text-to-video (default for text-only prompts)
+- **Wan2.6-I2V**: Image-to-video (default when image is provided)
+- **ViduQ2-pro**: Supports both T2V and I2V
+- **Seedance-1.5-Pro**: Supports both T2V and I2V
+
+## Prerequisites
+
+- **Python Environment**: Use `uv` to run Python scripts
+
+## Workflow
+
+### 1. Extract Image Path from Logs (if applicable)
+
+When users upload images in chat channels, files are usually saved under `media/inbound/images/` in the workspace. Use Media Understanding logs to get exact resolved paths.
+
+Typical log pattern:
+
+```
+[Media Understanding] Resolved relative path: "media/inbound/images/xxx.jpg" -> "/absolute/path/to/workspace/media/inbound/images/xxx.jpg"
+```
+
+Use the absolute path for the `--first-frame` argument.
+
+### 2. Select Model
+
+- If image provided + user didn't specify model → use Wan2.6-I2V
+- If no image + user didn't specify model → use Wan2.6-T2V
+- If user specifies model → use their choice
+
+### 3. Run Generation Script
+
+```bash
+uv run python {baseDir}/scripts/gen_video.py \
+  --prompt "Your video description" \
+  --model "Wan2.6-T2V" \
+  --size "1280*720" \
+  --duration 5 \
+  --first-frame "/absolute/path/to/image.jpg"
+```
+
+**Parameters:**
+
+- `--prompt`: Video description (required)
+- `--model`: Model name (optional, auto-selected based on input)
+- `--size`: Resolution, default "1280\*720"
+- `--duration`: Duration in seconds, default 5
+- `--first-frame`: Path to image file or URL (optional, for I2V)
+
+### 4. Output
+
+The script will:
+
+1. Upload local images to OSS if needed
+2. Submit the video generation request
+3. Poll the API until completion
+4. Display the final video URL and local save path
+5. Prompt the user to download the video
+6. Other models: ViduQ2-pro, Seedance-1.5-Pro
+
+Example output:
+
+```
+📹 **您的视频提示词为**: [prompt]
+✅ **视频生成成功**: <video controls width="100%" src="https://www.sophnet.com/api/open-apis/projects/download/xyz789"></video>
+📥 **视频本地保存路径**: /path/to/xyz789.mp4
+💬 **提示**:
+    ⚠️ 本内容有AI生成，视频保存24小时，请及时下载保存！
+    🤖 当前使用的模型为 [model]，还支持 [other models]
+    🧠 如果想要指定模型，可以直接对我说：使用 [模型名称] 模型，生成 [视频描述]
+```
+
+Present this information to the user in a clear format.
+
+## Examples
+
+**Text-to-video:**
+
+```bash
+uv run python {baseDir}/scripts/gen_video.py \
+  --prompt "A serene lake at sunset with swans swimming"
+```
+
+**Image-to-video:**
+
+```bash
+uv run python {baseDir}/scripts/gen_video.py \
+  --prompt "Camera slowly zooms in" \
+  --first-frame "/workspace/media/inbound/images/photo.jpg"
+```
+
+**Specify model:**
+
+```bash
+uv run python {baseDir}/scripts/gen_video.py \
+  --prompt "A cat playing with yarn" \
+  --model "ViduQ2-pro"
+```
+
+## Notes
+
+- Video generation typically takes 1-3 minutes
+- Videos are stored for 24 hours on Sophnet servers
+- Local copies saved to `~/.openclaw/workspace/media/inbound/videos/`
+- Generation typically takes 1-5 minutes depending on model and duration
+- Script automatically polls for completion with 5-minute timeout