sophhub 0.4.2 → 0.4.4

package/skills/agent-install/src/scripts/verify_download.py

@@ -0,0 +1,148 @@
+#!/usr/bin/env python3
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from pathlib import Path
+
+from common import load_json
+
+
+REQUIRED_FILES = [
+    ".config.json",
+    "AGENTS.md",
+    "BOOTSTRAP.md",
+    "IDENTITY.md",
+    "SOUL.md",
+    "TOOLS.md",
+    "USER.md",
+]
+
+
+def inspect_candidate(agent_id: str, directory: Path) -> dict[str, object]:
+    config_path = directory / ".config.json"
+    if not config_path.is_file():
+        return {
+            "directory": str(directory),
+            "ok": False,
+            "reason": "config_missing",
+        }
+
+    try:
+        config = load_json(config_path)
+    except Exception as exc:  # noqa: BLE001
+        return {
+            "directory": str(directory),
+            "ok": False,
+            "reason": "config_invalid",
+            "error": str(exc),
+        }
+
+    config_agent_id = config.get("agent_id")
+    missing_files = [name for name in REQUIRED_FILES if not (directory / name).is_file()]
+    missing_fields = [name for name in ("agent_id", "version", "workspace", "agent_dependencies") if name not in config]
+
+    if config_agent_id != agent_id:
+        return {
+            "directory": str(directory),
+            "ok": False,
+            "reason": "agent_id_mismatch",
+            "config_agent_id": config_agent_id,
+            "missing_files": missing_files,
+            "missing_fields": missing_fields,
+        }
+
+    if missing_fields:
+        return {
+            "directory": str(directory),
+            "ok": False,
+            "reason": "config_fields_missing",
+            "config_agent_id": config_agent_id,
+            "missing_files": missing_files,
+            "missing_fields": missing_fields,
+        }
+
+    if missing_files:
+        return {
+            "directory": str(directory),
+            "ok": False,
+            "reason": "required_files_missing",
+            "config_agent_id": config_agent_id,
+            "missing_files": missing_files,
+            "missing_fields": missing_fields,
+        }
+
+    return {
+        "directory": str(directory),
+        "ok": True,
+        "reason": "valid",
+        "config_agent_id": config_agent_id,
+        "version": config.get("version"),
+        "workspace": config.get("workspace"),
+        "agent_dependencies": config.get("agent_dependencies", []),
+        "missing_files": [],
+        "missing_fields": [],
+    }
+
+
+def candidate_directories(download_path: Path, agent_id: str) -> list[Path]:
+    candidates = [download_path / agent_id, download_path]
+    unique: list[Path] = []
+    seen: set[str] = set()
+    for candidate in candidates:
+        resolved = str(candidate)
+        if resolved not in seen:
+            unique.append(candidate)
+            seen.add(resolved)
+    return unique
+
+
+def verify_download(agent_id: str, download_path: Path) -> dict[str, object]:
+    inspections = []
+    for directory in candidate_directories(download_path, agent_id):
+        inspections.append(inspect_candidate(agent_id, directory))
+
+    valid = next((item for item in inspections if item["ok"]), None)
+    if valid:
+        return {
+            "ok": True,
+            "agent_id": agent_id,
+            "download_path": str(download_path),
+            "agent_directory": valid["directory"],
+            "version": valid["version"],
+            "workspace": valid["workspace"],
+            "agent_dependencies": valid["agent_dependencies"],
+            "message": "Agent 下载成功，关键配置文件校验通过。",
+            "inspections": inspections,
+        }
+
+    first_error = inspections[0] if inspections else {"reason": "unknown"}
+    return {
+        "ok": False,
+        "agent_id": agent_id,
+        "download_path": str(download_path),
+        "message": "Agent 下载结果校验失败，请检查下载目录和 Agent 包内容。",
+        "reason": first_error.get("reason"),
+        "inspections": inspections,
+    }
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="校验 Agent 下载结果")
+    parser.add_argument("--agent-id", required=True, help="Agent ID")
+    parser.add_argument(
+        "--path",
+        required=True,
+        help="sophhub agent download 使用的目标目录",
+    )
+    args = parser.parse_args()
+
+    result = verify_download(args.agent_id, Path(args.path).expanduser().resolve())
+    json.dump(result, sys.stdout, indent=2, ensure_ascii=False)
+    sys.stdout.write("\n")
+    return 0 if result["ok"] else 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

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

@@ -0,0 +1,36 @@
+{
+  "name": "bot-api-status",
+  "version": "1.0.2",
+  "types": [
+    "store"
+  ],
+  "displayName": "BOT-API",
+  "description": "查看当前 Agent 的 bot api 状态，同时也支持开启、关闭、重置密钥",
+  "changelog": [
+    {
+      "changes": [
+        "修正 SKILL 中 bot-api 链接路径说明（account_id 占位，与脚本一致）",
+        "pyproject.toml 中 [project].version 与 skill 版本对齐",
+        "统一中文「密钥」用词"
+      ],
+      "date": "2026-04-22",
+      "version": "1.0.2"
+    },
+    {
+      "changes": [
+        "pyproject.toml 中 [project].name 更正为 bot-api-status"
+      ],
+      "date": "2026-04-22",
+      "version": "1.0.1"
+    },
+    {
+      "changes": [
+        "初次提交"
+      ],
+      "date": "2026-04-22",
+      "version": "1.0.0"
+    }
+  ],
+  "createdAt": "2026-04-22",
+  "updatedAt": "2026-04-22"
+}

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

@@ -0,0 +1,89 @@
+---
+name: bot-api-status
+description: 管理当前 Agent 的 bot-api。Use when the user asks to create, delete, query bot-api status or API Secret, or reset bot-api secret for the current Agent.
+---
+
+# 当前 Agent 的 Bot API 管理
+
+## 用法
+
+### 查询
+
+```bash
+uv run {baseDir}/scripts/secret.py status --json
+```
+
+### 开启
+
+```bash
+uv run {baseDir}/scripts/secret.py create --json
+```
+
+### 关闭
+
+```bash
+uv run {baseDir}/scripts/secret.py delete --json
+```
+
+### 重置
+
+```bash
+uv run {baseDir}/scripts/secret.py reset --json
+```
+
+## 输出模板
+
+链接形态包含两种：
+
+- 非流式：`{{BASEURL}}/bot-api/v2/<account_id>/chat`
+- 流式：`{{BASEURL}}/bot-api/v2/<account_id>/chat-stream`
+
+其中 `<account_id>` 与 openclaw 配置里 `channels.bot-api.accounts` 的账号 id 一致。
+
+### 查询
+
+```text
+📋 🤖 bot-api 状态：<🟢 开启 / ⚪ 关闭>
+
+🔗 非流式链接：{{BASEURL}}/bot-api/v2/<account_id>/chat
+🔗 流式链接：{{BASEURL}}/bot-api/v2/<account_id>/chat-stream
+🔑 密钥：<api_secret 或 📭 暂无>
+```
+
+### 开启
+
+```text
+✨ 🤖 bot-api 已创建
+
+🔗 非流式链接：{{BASEURL}}/bot-api/v2/<account_id>/chat
+🔗 流式链接：{{BASEURL}}/bot-api/v2/<account_id>/chat-stream
+🔑 密钥：<api_secret>
+
+🔒 请妥善保管，勿对外转发或截图。
+```
+
+### 关闭
+
+```text
+🛑 🤖 bot-api 已关闭
+
+📴 当前 Agent 不再通过 bot-api 对外提供服务。
+```
+
+### 重置
+
+```text
+🔄 🤖 bot-api 密钥已更新
+
+🔑 新密钥：<new_secret>
+🔗 非流式链接：{{BASEURL}}/bot-api/v2/<account_id>/chat
+🔗 流式链接：{{BASEURL}}/bot-api/v2/<account_id>/chat-stream
+
+🔒 请妥善保管，勿对外转发或截图。
+```
+
+### 失败
+
+```text
+⚠️ 获取BASEURL失败，刷新页面或者重新登录后重试。
+```

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

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