sophhub 0.4.18 → 0.4.19

package/agents/intern-admin/.config.json

@@ -1,7 +1,8 @@
 {
-  "version": "1.1.0",
+  "version": "1.2.0",
   "agent_id": "intern-admin",
   "description": "实习事务管理员：维护实习相关 knowledge/、workspace-intern-qa/records/（日报按日、请假 leave.md），并配合配对实习生答疑实例",
+  "auto_generate_image_description": false,
   "bot_api_enabled": false,
   "workspace": "/home/node/.openclaw/workspace-intern",
   "agent_dependencies": [],

package/agents/intern-qa/.config.json

@@ -1,7 +1,8 @@
 {
-  "version": "1.1.0",
+  "version": "1.2.0",
   "agent_id": "intern-qa",
   "description": "实习生助手 bot：只读 knowledge/ 答疑；日报按日追加 records/，请假单独 records/leave.md（解析公历日期）；归档查询；memory/ 备忘；预装 image-description",
+  "auto_generate_image_description": false,
   "bot_api_enabled": true,
   "workspace": "/home/node/.openclaw/workspace-intern/workspace-intern-qa",
   "agent_dependencies": ["intern-admin"],

package/agents/parent-toddler/.config.json

@@ -1,7 +1,9 @@
 {
-  "version": "1.0.0",
+  "version": "1.1.0",
   "agent_id": "parent-toddler",
+  "agent_label": "幼儿家长助手",
   "description": "面向幼儿家长的成长陪伴助手：亲子互动、图片与多媒体创作、日常记录与轻量咨询",
+  "auto_generate_image_description": false,
   "bot_api_enabled": false,
   "workspace": "/home/node/.openclaw/workspace-parent-toddler",
   "agent_dependencies": [],

package/package.json

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

package/skills/agent-install/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "agent-install",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "types": [
     "store"
   ],
   "displayName": "Agent安装",
   "description": "通用 Agent 安装与升级。",
   "changelog": [
+    {
+      "changes": [
+        "update_openclaw 根据 .config.json 的 auto_generate_image_description 同步自动生成图片描述开关（默认开启）"
+      ],
+      "date": "2026-05-15",
+      "version": "0.1.5"
+    },
     {
       "changes": [
         "修复依赖 Agent 使用自定义 openclaw_id 时的安装检测逻辑"
@@ -23,5 +30,5 @@
     }
   ],
   "createdAt": "2026-04-21",
-  "updatedAt": "2026-04-21"
+  "updatedAt": "2026-05-15"
 }

package/skills/agent-install/src/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-install
 description: 安装或升级通用 OpenClaw Agent（含按 .config.json 自动下载 skill）。Use when the user asks to install an agent, upgrade an agent, download agent config, back up an existing agent, update openclaw.json, or install skills listed with auto_install.
-version: 0.1.0
+version: 0.1.5
 ---
 
 # Agent Install
@@ -165,6 +165,8 @@ uv run {baseDir}/scripts/update_openclaw.py \
   --name "{agent_name}"
 ```
 
+**自动生成图片描述**：Agent 包 `.config.json` 顶层可选 **`auto_generate_image_description`**（布尔）；不写或与 `true` 为开启，`false` 为关闭。与 **`update_openclaw.py`** 一并生效；具体写入 **`openclaw.json`** 的规则以实现为准，脚本标准输出中含 **`auto_generate_image_description`** 字段便于核对。
+
 `NOT_INSTALLED` 无备份，直接 2）。`UPDATABLE` / `SAME_VERSION_REINSTALL` 须已完成 1）。
 
 **输入模版（仅要备份时）**

package/skills/agent-install/src/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agent-install"
-version = "0.1.4"
+version = "0.1.5"
 description = "通用 Agent 安装与升级"
 requires-python = ">=3.10"
 dependencies = []

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

@@ -231,16 +231,25 @@ def build_agent_entry(
 ) -> dict[str, Any]:
     source_agent_id = agent_def["agent_id"]
     agent_id = target_id_override.strip() if isinstance(target_id_override, str) and target_id_override.strip() else source_agent_id
-    install = agent_def.get("install", {})
-    identity = install.get("identity", {})
+    install = agent_def.get("install", {}) if isinstance(agent_def.get("install"), dict) else {}
+    identity = install.get("identity", {}) if isinstance(install.get("identity"), dict) else {}
     resolved_name = name_override.strip() if isinstance(name_override, str) and name_override.strip() else None
 
-    display_name = resolved_name or install.get("name") or identity.get("name") or source_agent_id
+    install_name_raw = install.get("name")
+    install_name_str = install_name_raw.strip() if isinstance(install_name_raw, str) and install_name_raw.strip() else None
+
+    identity_name_raw = identity.get("name")
+    identity_name_str = identity_name_raw.strip() if isinstance(identity_name_raw, str) and identity_name_raw.strip() else None
+
+    agent_label_raw = agent_def.get("agent_label")
+    agent_label_str = agent_label_raw.strip() if isinstance(agent_label_raw, str) and agent_label_raw.strip() else None
+
+    display_name = resolved_name or install_name_str or identity_name_str or agent_label_str or source_agent_id
     entry: dict[str, Any] = {
         "id": agent_id,
         "workspace": desired_workspace(agent_def, workspace_override),
         "identity": {
-            "name": resolved_name or identity.get("name", display_name),
+            "name": resolved_name or identity_name_str or agent_label_str or display_name,
             "theme": identity.get("theme", display_name),
             "emoji": identity.get("emoji", "🤖"),
         },
@@ -248,8 +257,8 @@ def build_agent_entry(
 
     if resolved_name:
         entry["name"] = resolved_name
-    elif install.get("name"):
-        entry["name"] = install["name"]
+    elif install_name_str:
+        entry["name"] = install_name_str
 
     if install.get("agent_dir"):
         entry["agentDir"] = install["agent_dir"]
@@ -285,15 +294,20 @@ def build_bot_api_account(
     if not agent_def.get("bot_api_enabled"):
         return None
 
-    install = agent_def.get("install", {})
-    identity = install.get("identity", {})
-    bot_api = install.get("bot_api", {})
+    install = agent_def.get("install", {}) if isinstance(agent_def.get("install"), dict) else {}
+    identity = install.get("identity", {}) if isinstance(install.get("identity"), dict) else {}
+    bot_api = install.get("bot_api", {}) if isinstance(install.get("bot_api"), dict) else {}
     resolved_name = name_override.strip() if isinstance(name_override, str) and name_override.strip() else None
 
+    identity_name_raw = identity.get("name")
+    identity_name_str = identity_name_raw.strip() if isinstance(identity_name_raw, str) and identity_name_raw.strip() else None
+    agent_label_raw = agent_def.get("agent_label")
+    agent_label_str = agent_label_raw.strip() if isinstance(agent_label_raw, str) and agent_label_raw.strip() else None
+
     source_agent_id = agent_def["agent_id"]
     agent_id = agent_id_override.strip() if isinstance(agent_id_override, str) and agent_id_override.strip() else source_agent_id
     account_id = bot_api.get("account_id", agent_id)
-    account_name = bot_api.get("account_name") or resolved_name or identity.get("name", source_agent_id)
+    account_name = bot_api.get("account_name") or resolved_name or identity_name_str or agent_label_str or source_agent_id
     enabled = bot_api.get("enabled", True)
 
     return account_id, {
@@ -485,3 +499,70 @@ def deep_merge_dict(base: dict[str, Any], override: dict[str, Any]) -> dict[str,
         else:
             result[key] = deepcopy(value)
     return result
+
+
+def auto_generate_image_description_prefix(openclaw_agent_id: str) -> str:
+    """与 openclaw.json 中 tools.media.image.scope.rules.match.keyPrefix 对齐。"""
+    aid = openclaw_agent_id.strip() if isinstance(openclaw_agent_id, str) else ""
+    return f"agent:{aid}:" if aid else ""
+
+
+def is_auto_generate_image_description_enabled(agent_def: dict[str, Any]) -> bool:
+    """未设置或为真时启用自动生成图片描述；仅当显式为 false 时关闭。"""
+    raw = agent_def.get("auto_generate_image_description")
+    if raw is None:
+        return True
+    if isinstance(raw, bool):
+        return raw
+    return bool(raw)
+
+
+def _rule_is_auto_image_description_deny(rule: Any, key_prefix: str) -> bool:
+    if not isinstance(rule, dict):
+        return False
+    if rule.get("action") != "deny":
+        return False
+    match = rule.get("match")
+    if not isinstance(match, dict):
+        return False
+    return match.get("keyPrefix") == key_prefix
+
+
+def sync_openclaw_auto_image_description_rules(
+    config: dict[str, Any],
+    openclaw_agent_id: str,
+    *,
+    enabled: bool,
+) -> None:
+    """
+    同步根级 tools.media.image.scope.rules：
+    - enabled=True：移除本安装流程写入的 deny（keyPrefix agent:<id>:）
+    - enabled=False：确保存在对应 deny 规则（与产品侧「关闭自动生成图片描述」一致）
+    """
+    key_prefix = auto_generate_image_description_prefix(openclaw_agent_id)
+    if not key_prefix:
+        return
+
+    tools = config.setdefault("tools", {})
+    media = tools.setdefault("media", {})
+    image = media.setdefault("image", {})
+    scope = image.setdefault("scope", {})
+    scope.setdefault("default", "allow")
+    rules_any = scope.setdefault("rules", [])
+    if not isinstance(rules_any, list):
+        scope["rules"] = []
+        rules_any = scope["rules"]
+
+    if enabled:
+        scope["rules"] = [r for r in rules_any if not _rule_is_auto_image_description_deny(r, key_prefix)]
+        return
+
+    if any(_rule_is_auto_image_description_deny(r, key_prefix) for r in rules_any):
+        return
+
+    rules_any.append(
+        {
+            "action": "deny",
+            "match": {"keyPrefix": key_prefix},
+        }
+    )

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

@@ -15,9 +15,11 @@ from common import (
     find_agent_entry,
     find_bot_api_accounts_by_agent_id,
     find_agent_by_workspace,
+    is_auto_generate_image_description_enabled,
     load_agent_definition,
     load_openclaw_config,
     resolve_existing_agent_entry,
+    sync_openclaw_auto_image_description_rules,
     write_install_state,
 )
 
@@ -125,6 +127,13 @@ def update_openclaw(
         name_override=resolved_name,
     )
 
+    auto_img_desc = is_auto_generate_image_description_enabled(agent_def)
+    sync_openclaw_auto_image_description_rules(
+        config,
+        target_agent_id,
+        enabled=auto_img_desc,
+    )
+
     dump_json(config_path, config)
     state_path = write_install_state(
         config_path,
@@ -149,6 +158,7 @@ def update_openclaw(
         "previous_workspace": previous.get("workspace") if previous else None,
         "version": agent_def["version"],
         "install_state": str(state_path),
+        "auto_generate_image_description": auto_img_desc,
     }