sophhub 0.4.28 → 0.4.30

package/package.json

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

package/skills/agent-install/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "agent-install",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "types": [
     "store"
   ],
   "displayName": "Agent安装",
   "description": "安装或升级 Sophclaw Agent（含占位替换、备份、post_install 脚本与自动安装 skill）。",
   "changelog": [
+    {
+      "changes": [
+        "新增 _ensure_main_agent_in_list：单 Agent 模式下安装 Agent 时自动迁移 main Agent 至 agents.list，防止 session 丢失"
+      ],
+      "date": "2026-05-27",
+      "version": "0.1.8"
+    },
     {
       "changes": [
         "新增 run_post_install.py：安装时执行 .config.json 中 post_install 脚本",
@@ -47,5 +54,5 @@
     }
   ],
   "createdAt": "2026-04-21",
-  "updatedAt": "2026-05-20"
+  "updatedAt": "2026-05-27"
 }

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

@@ -6,6 +6,8 @@ import json
 import sys
 from pathlib import Path
 
+from copy import deepcopy
+
 from common import (
     build_agent_entry,
     build_bot_api_account,
@@ -33,6 +35,64 @@ def normalized_override(value: str | None) -> str | None:
     return None
 
 
+def _ensure_main_agent_in_list(config: dict, config_path: Path) -> dict | None:
+    """如果 openclaw.json 处于单 Agent 模式（agents.list 为空但默认 workspace 存在），
+    将 main Agent 迁移至 list 中，防止 install 后 session 丢失。
+
+    返回迁移信息 dict（含 migrated/agent_id/workspace），无需迁移时返回 None。
+    """
+    agents = config.setdefault("agents", {})
+    agents_list = agents.setdefault("list", [])
+
+    # 已有 Agent 列表条目 → 已是多 Agent 模式，无需迁移
+    if agents_list:
+        return None
+
+    root_dir = config_path.parent
+    # 默认 workspace 路径为 openclaw.json 同级目录下的 workspace
+    default_workspace = root_dir / "workspace"
+    if not default_workspace.is_dir():
+        return None
+
+    main_id = config.get("id", "main")
+    if not isinstance(main_id, str) or not main_id.strip():
+        main_id = "main"
+    main_id = main_id.strip()
+
+    # workspace：优先顶层 config.workspace，否则用默认路径
+    top_workspace = config.get("workspace")
+    workspace = str(top_workspace) if isinstance(top_workspace, str) and top_workspace.strip() else str(default_workspace)
+    entry: dict = {"id": main_id, "workspace": workspace}
+
+    # model：顶层 config.model 优先于 defaults.model（单 Agent 模式顶层可能含 fallbacks 等）
+    defaults = agents.get("defaults", {})
+    top_model = config.get("model")
+    if isinstance(top_model, dict):
+        entry["model"] = deepcopy(top_model)
+    elif isinstance(defaults.get("model"), dict):
+        entry["model"] = deepcopy(defaults["model"])
+    if isinstance(defaults.get("heartbeat"), dict):
+        entry["heartbeat"] = deepcopy(defaults["heartbeat"])
+
+    # identity：优先从顶层 config 取，否则用 main_id 构造默认值
+    if isinstance(config.get("identity"), dict):
+        entry["identity"] = deepcopy(config["identity"])
+    else:
+        entry["identity"] = {"name": main_id, "theme": main_id, "emoji": "🤖"}
+
+    if isinstance(config.get("name"), str) and config["name"].strip():
+        entry["name"] = config["name"].strip()
+    if isinstance(config.get("agentDir"), str) and config["agentDir"].strip():
+        entry["agentDir"] = config["agentDir"].strip()
+    if isinstance(config.get("tools"), dict):
+        entry["tools"] = deepcopy(config["tools"])
+    if isinstance(config.get("skills"), list):
+        entry["skills"] = deepcopy(config["skills"])
+
+    agents_list.insert(0, entry)
+    return {"migrated": True, "agent_id": main_id, "workspace": workspace}
+
+
 def upsert_agent(config: dict, entry: dict) -> str:
     config.setdefault("agents", {})
     agents = config["agents"].setdefault("list", [])
@@ -103,6 +163,7 @@ def update_openclaw(
     resolved_name = normalized_override(name_override)
     agent_def = load_agent_definition(agent_id, source_path)
     config = load_openclaw_config(config_path)
+    main_migration = _ensure_main_agent_in_list(config, config_path)
     desired_workspace = resolved_workspace or agent_def.get("install", {}).get("workspace") or agent_def.get("workspace")
     previous = resolve_existing_agent_entry(config_path, config, agent_id, desired_workspace)
     if previous is None and resolved_openclaw_id:
@@ -164,6 +225,7 @@ def update_openclaw(
         "auto_generate_image_description": auto_img_desc,
         "heartbeat_configured": heartbeat_cfg is not None,
         "heartbeat": heartbeat_cfg,
+        "main_migration": main_migration,
     }
 
 

package/skills/online-bug-report/skill.json

@@ -1,12 +1,36 @@
 {
   "name": "online-bug-report",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "types": [
     "store"
   ],
   "displayName": "在线提Bug",
-  "description": "用户说「在线提交bug」时收集 Bug 并经由虾友 DM 发送工单（含 session 附件）",
+  "description": "当用户说「在线提交bug」时，收集问题描述并通过虾友 DM 提交工单。",
   "changelog": [
+    {
+      "changes": [
+        "新增 ensure-friend 子命令，add_friend.py 删除逻辑内置",
+        "新增 --agent-id 参数，sessions 路径改为 /agents/{agentId}/sessions/",
+        "消息格式重构为 flat ▎结构",
+        "支持 JWT 自动解析 sender（userId/name）",
+        "错误消息改为显示实际失败原因",
+        "pyproject.toml 对齐 sophnet-image-ocr（aliyun mirror、依赖声明）",
+        "SKILL.md 精简至 55 行",
+        "清理死代码、提取 resolve_api_base 去重"
+      ],
+      "date": "2026-05-28",
+      "version": "1.0.7"
+    },
+    {
+      "changes": [
+        "移除对 sophnet-oss skill 的引用，上传脚本自包含",
+        "路径改为运行时格式（{baseDir}/scripts/），去除 src/ 和 workspace",
+        "新增模板变量说明节，定义 sender_id、sender_name 等变量",
+        "Python 版本要求从 3.10+ 降为 3.8+"
+      ],
+      "date": "2026-05-27",
+      "version": "1.0.6"
+    },
     {
       "changes": [
         "凭证移至 src/secrets/bug-report.json，与 npm 打包仅含 src/ 对齐"
@@ -51,5 +75,5 @@
     }
   ],
   "createdAt": "2026-05-18",
-  "updatedAt": "2026-05-19"
+  "updatedAt": "2026-05-28"
 }

package/skills/online-bug-report/src/SKILL.md

@@ -1,131 +1,55 @@
 ---
 name: online-bug-report
-description: |
-  仅当用户说「在线提交bug」（大小写不敏感）时触发。收集 Bug 描述、上传 session .jsonl 到 OSS，
-  通过虾友 DM 发送工单。勿因「提 Bug」「报障」「系统坏了」等其它说法触发。
+description: 当用户说「在线提交bug」时，收集问题描述并通过虾友 DM 提交工单。
 ---
 
 # 在线提 Bug
 
-用户说「**在线提交 Bug**」后，收集 Bug 描述并提交工单。
+用户说「**在线提交 Bug**」（`bug` 不区分大小写，允许中间空格）后执行。
 
-## Processing Mode
+## Step 1：校验好友
 
-**STRICT SERIAL PROCESSING ONLY** — 单次顺序执行。
-
-## Prerequisites
-
-- Python 3.10+、`uv`
-- 有效 JWT：`/home/node/.openclaw/jwt.json`（字段 `web_jwt`）
-- `exec` 工具可用
-
-## 凭证文件
-
-**内置凭证（随 skill 下发）：** `{baseDir}/secrets/bug-report.json`，下载后可直接使用。修改收件人请直接编辑该文件，或使用 `--cred-file` 指定其它路径。
-
-## 触发词
-
-**唯一触发词**：「在线提交bug」（`bug` 不区分大小写；允许 `在线提交 bug` 中间有空格）
-
-| 用户说的话 | 是否触发 |
-|-----------|----------|
-| 「在线提交bug」/「在线提交 Bug」 | ✅ 触发 |
-| 「提 Bug」 | ❌ 不触发，正常回答 |
-| 「报 Bug」 | ❌ 不触发，正常回答 |
-| 「系统坏了」 | ❌ 不触发，正常回答 |
-| 「有个 Bug」 | ❌ 不触发，正常回答 |
-
-## Agent 角色定位
-
-**Agent 是 Bug 信息收集者，不是问题解决者。**
-
-| Agent 行为 | 正确/错误 |
-|-----------|----------|
-| 收集用户描述 → 提交工单 | ✅ 正确 |
-| 尝试自己分析/修复 Bug | ❌ 错误 |
-| 询问技术细节、API、配置 | ❌ 错误 |
-| 让用户补充现象描述 | ✅ 正确 |
+```bash
+uv run {baseDir}/scripts/report_bug.py ensure-friend --json
+```
 
-## 执行流程
+| 退出码 | Agent 行为 |
+|--------|-----------|
+| 0 | 进入 Step 2 |
+| 2 | 回复「研发值班还不是您的好友，已自动发送申请。通过后请重新提交 Bug」→ 结束 |
+| 其他 | 回复「提交 Bug 失败，失败原因为：{stderr}」→ 结束 |
 
-### Step 1：用户说「在线提交 Bug」
+## Step 2：收集描述
 
-Agent **立即停止任何尝试解决问题的行为**，回复：
+回复以下内容让用户补充：
 
 ```
 好的，我来帮您提交 Bug 工单。
 
-请补充一下问题描述：
-- 具体是什么问题/现象？
-- 大概什么时候发生的？
-- 有复现步骤吗？（可选）
-
-补充完之后告诉我，我会提交处理。
-```
-
-**关键点**：
-- **不尝试**：不分析原因、不尝试修复、不给解决方案
-- **只收集**：等待用户补充描述
-- **不询问技术细节**
-
-### Step 2：等待用户补充描述
-
-用户补充描述后，记录用户原话作为 Bug 描述。
-
-若描述不足，追问：「请问具体现象是什么？」
-不追问技术细节。
-
-### Step 3：获取完整 session 文件
-
-```bash
-SESSION_KEY="{当前sessionKey}"
-SESSION_ID=$(cat {agentDir}/sessions/sessions.json | jq -r '."${SESSION_KEY}".sessionId')
-SESSION_FILE="{agentDir}/sessions/${SESSION_ID}.jsonl"
+请补充一下您的具体问题/现象，如果能提供复现步骤，那更好。
 ```
 
-**上传完整的 `.jsonl` 文件**（包含整个对话历史）。
+记录用户原话。若描述不足追问「请问具体现象是什么？」
 
-### Step 4：上传到 OSS
+## Step 3：提交工单
 
-```bash
-cd {workspace}/skills/sophnet-oss
-uv run --with sophnet-tools python scripts/upload_file.py \
-  --file "${SESSION_FILE}" --timeout 60
-```
-
-### Step 5：发送工单
+获取当前 session 的 sessionKey 和 agentId（sessionKey 形如 `agent:<AgentID>:...`，取第二段即为 agentId），然后执行：
 
 ```bash
-cd {workspace}/skills/online-bug-report/src
-uv run scripts/report_bug.py send \
-  --sender-id "{sender_id}" \
-  --sender-name "{sender_name}" \
+uv run {baseDir}/scripts/report_bug.py send \
   --description "{用户完整描述}" \
-  --session-key "${SESSION_KEY}" \
-  --oss-url "${OSS_URL}" \
+  --session-key "{sessionKey}" \
+  --agent-id "{agentId}" \
   --json
 ```
 
-### Step 6：回复用户
-
-- 成功：「已提交 Bug 工单，会跟进处理。」
-- 失败：「已记录问题，稍后将补发工单。」
-
-## 与「知识库反馈」分流
-
-| 用户意图 | 处理 |
-|---------|------|
-| 「文档错了」「知识库内容有误」 | `memory/feedback-*.md` 流程 |
-| 「在线提交 Bug」 | **本 Skill** → 收集并提交 |
-
-## 安全约束
+## Step 4：回复用户
 
-- **不暴露**：JWT、凭证路径、friendId、API 地址
-- **不询问**：技术细节、配置参数
-- **不尝试**：分析或修复 Bug
+- 退出码 0 → 「已提交 Bug 工单，会跟进处理。」
+- 退出码非 0 → 「提交 Bug 失败，失败原因为：{stderr}」
 
 ## Forbidden
 
-- 不要尝试解决用户的问题
-- 不要向用户暴露 JWT、凭证
-- 不要询问技术细节
+- 不要分析/修复 Bug，只收集信息
+- 不要询问技术细节、API、配置
+- 不要暴露 JWT、凭证、friendId、API 地址

package/skills/online-bug-report/src/pyproject.toml

@@ -1,5 +1,13 @@
 [project]
 name = "online-bug-report"
-version = "1.0.5"
+version = "1.0.7"
 description = "Send VIP online bug reports to a Sophclaw friend via IM"
-requires-python = ">=3.10"
+requires-python = ">=3.8"
+dependencies = [
+    "requests>=2.28.0",
+    "sophnet-tools>=0.0.1",
+]
+
+[[tool.uv.index]]
+url = "https://mirrors.aliyun.com/pypi/simple/"
+default = true

package/skills/online-bug-report/src/references/config.example.json

@@ -1,11 +1,8 @@
 {
   "_comment": "字段说明参考；实际凭证见 secrets/bug-report.json（与 SKILL.md 同级的 src/secrets/）",
   "dev_friend_id": 0,
-  "dev_friend_name": "收件人名称",
-  "terminal_label": "虾友 DM",
   "terminal_url": "",
   "session_url_template": "{base_url}/chat?session={session_key}",
   "api_base_url": "https://yagent.sophnet.com/api",
-  "openclaw_base_url": "",
-  "default_model": "Qwen3.5-122B-A10B"
+  "openclaw_base_url": ""
 }