sophhub 0.4.19 → 0.4.21

package/skills/agent-install/skill.json

@@ -1,34 +1,34 @@
-{
-  "name": "agent-install",
-  "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 时的安装检测逻辑"
-      ],
-      "date": "2026-04-21",
-      "version": "0.1.4"
-    },
-    {
-      "changes": [
-        "初次提交"
-      ],
-      "date": "2026-04-21",
-      "version": "0.1.3"
-    }
-  ],
-  "createdAt": "2026-04-21",
-  "updatedAt": "2026-05-15"
-}
+{
+  "name": "agent-install",
+  "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 时的安装检测逻辑"
+      ],
+      "date": "2026-04-21",
+      "version": "0.1.4"
+    },
+    {
+      "changes": [
+        "初次提交"
+      ],
+      "date": "2026-04-21",
+      "version": "0.1.3"
+    }
+  ],
+  "createdAt": "2026-04-21",
+  "updatedAt": "2026-05-15"
+}

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

@@ -1,240 +1,240 @@
----
-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.5
----
-
-# Agent Install
-
-安装、升级或重置**单个** OpenClaw Agent。本 skill 只做**顺序编排 + 调用脚本**；细节见脚本与 `AGENT-CONFIG.md`。
-
-**串行**：一次只装一个 Agent，禁止并行。
-
-## 对话约束
-
-勿对用户念内部 **status** 枚举；展示安装状态以 **`user_prompt`** 为主。凡提示已备份，须给出 **`backup_dir` 完整路径**（`backup_agent.py` 输出）。密钥勿在公开渠道展示。
-
----
-
-## Step 1：选定 Agent 并获取安装包
-
-**A. 解析 `agent_id`**
-
-```bash
-uv run {baseDir}/scripts/list_agents.py
-```
-
-非精确 id 时：
-
-```bash
-uv run {baseDir}/scripts/list_agents.py --query "{user_input}" --limit 5
-```
-
-内部：`EXACT_MATCH` → 继续；`NEEDS_CONFIRMATION` → 展示 `confirmation_message`；`NO_MATCH` → 请用户重述。
-
-**B. 下载并校验**
-
-```bash
-npx -y sophhub@latest agent download {agent_id} --path=/home/node/.openclaw/workspace
-```
-
-```bash
-uv run {baseDir}/scripts/verify_download.py \
-  --agent-id "{agent_id}" \
-  --path "/home/node/.openclaw/workspace"
-```
-
-校验失败则**终止全流程**。成功则带同一 `agent_id` 进入 Step 2。
-
-**输入模版**
-
-```text
-🔹【请提供要安装的 Agent】
-- **agent_id**（例：`ai-cs-qa`）或 **自然语言描述**（例：「智能客服 QA」）；不确定可先模糊查再选。
-
-（需多选一）
-⚠️ <confirmation_message>；可选：<suggested_replies>
-
-（未找到）
-❌ 未找到匹配，请换说法或给精确 agent_id。
-```
-
-**输出模版**
-
-```text
-✅ 已确定目标 Agent：<resolved_agent_id>
-📦 下载与校验：<成功 ✅ / 失败 ❌>；失败则 🛑 终止，不继续。
-```
-
----
-
-## Step 2：参数、占位替换与安装状态检测
-
-依次执行，中间勿插入无关步骤。
-
-**1）解析安装参数**
-
-```bash
-uv run {baseDir}/scripts/resolve_install_params.py \
-  --agent-id "{agent_id}" \
-  --path "/home/node/.openclaw/workspace"
-```
-
-确认 `openclaw_id`、`workspace`、`agent_name`。`placeholder_catalog` / `placeholders_detail` 见 `AGENT-CONFIG.md`。用户可覆盖默认值。
-
-**2）按需替换 `.md` 中 `token`（有 `placeholders` 时）**
-
-```bash
-uv run {baseDir}/scripts/update_agent_md.py \
-  --agent-id "{agent_id}" \
-  --path "/home/node/.openclaw/workspace" \
-  --replace "{{客服助手}}=客服助手"
-```
-
-**3）检测当前安装状态**
-
-```bash
-uv run {baseDir}/scripts/check_installed.py \
-  --agent-id "{agent_id}" \
-  --source-path "/home/node/.openclaw/workspace" \
-  --openclaw-id "{openclaw_id}" \
-  --workspace "{workspace}" \
-  --name "{agent_name}"
-```
-
-对用户主状态含义（内部仍用 JSON `status` 分支，**勿对用户念枚举**）：
-
-- `DEPENDENCY_MISSING`：缺依赖 Agent → 提示先装依赖，**终止**
-- `UPDATABLE`：可升级 → 后续先备份再覆盖；本地若改过配置需自行同步
-- `SAME_VERSION_REINSTALL`：同版本 → 实为**重置**，须确认并先备份
-- `NOT_INSTALLED`：新装 → 可直接进入 Step 3 的拷贝/写配置
-
-兜底：`CONFIG_ERROR` → **终止**，人工核对 workspace / ID / 版本
-
-说明时优先复述 **`user_prompt`**。
-
-**输入模版**
-
-```text
-🔹【确认或覆盖】openclaw_id / workspace / agent_name（默认见脚本）
-⚠️ 若有占位：按 placeholder_catalog 的 label、description 确认每个 token 的替换文案
-```
-
-**输出模版**
-
-```text
-📌 参数已就绪（表格可列 openclaw_id、workspace、agent_name）
-✏️ 若已跑 update_agent_md：<简述>
-🧭 安装状态：用口语复述 user_prompt；CONFIG_ERROR 时 🛑 暂停
-```
-
----
-
-## Step 3：写入目标环境（条件备份 → 拷贝 → openclaw）
-
-仅在 Step 2 **不是** `DEPENDENCY_MISSING` / `CONFIG_ERROR` 时继续。
-
-**1）备份（仅 `UPDATABLE` 或 `SAME_VERSION_REINSTALL`）**  
-须先让用户回复「确认更新」或「确认重置」，再执行：
-
-```bash
-uv run {baseDir}/scripts/backup_agent.py \
-  --agent-id "{agent_id}" \
-  --openclaw-id "{current_openclaw_id}" \
-  --workspace "{workspace}" \
-  --status "{status}"
-```
-
-成功后必须把 **`backup_dir` 完整路径**告诉用户。其它 status **不要**调备份。
-
-**2）拷贝文件并更新 `openclaw.json`**
-
-```bash
-uv run {baseDir}/scripts/copy_agent_files.py \
-  --agent-id "{agent_id}" \
-  --path "/home/node/.openclaw/workspace" \
-  --workspace "{workspace}"
-```
-
-```bash
-uv run {baseDir}/scripts/update_openclaw.py \
-  --agent-id "{agent_id}" \
-  --source-path "/home/node/.openclaw/workspace" \
-  --openclaw-id "{openclaw_id}" \
-  --workspace "{workspace}" \
-  --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）。
-
-**输入模版（仅要备份时）**
-
-```text
-🔹 确认更新 → 回复：确认更新
-🔹 确认重置 → 回复：确认重置
-```
-
-**输出模版**
-
-```text
-✅ 已备份（如有）：backup_dir = <完整路径>；copied_md_files 可附
-🛠️ openclaw 已更新：摘要 agent_id、openclaw_id、workspace、version、bot-api、install_state（密钥走安全渠道）
-```
-
----
-
-## Step 4：Skill（auto_install）与完成表
-
-在 Step 3 成功、`openclaw.json` 已写入后执行。
-
-**Skill**：读 workspace 内 `.config.json` 的 `skills`，对 **`auto_install: true`** 的条目：
-
-```bash
-mkdir -p "{workspace}/skills"
-```
-
-```bash
-npx -y sophhub@latest download {skill_name} -o "{workspace}/skills"
-```
-
-`{workspace}` 为本 Agent 工作目录；多条**依次**下载。必要时加 `--type builtin` / `--type store`。
-
-**输出模版**
-
-```text
-📎 Skill：<列出本次 download 成功的 name>；失败须如实说明
-🎉 **Agent 安装流程结束**
-| 项目 | 内容 |
-|------|------|
-| agent_id | <…> |
-| 结果 | <新装 🆕 / 升级 ⬆️ / 重置 🔄> |
-| workspace | <路径> |
-| 备份目录 | <backup_dir 或「本次无备份」> |
-| skills | <已下载 name 列表或「未在本流程下载」> |
-| bot-api | <仅安全渠道> |
-🔐 密钥勿截图发群、勿写入公开工单。
-```
-
----
-
-## 错误与中止
-
-同版须先确认再备份；本地版本更高勿强退；无 `openclaw.json` 先初始化；`CONFIG_ERROR` 等见 Step 2。
-
-**输出模版**
-
-```text
-❌ 流程中止：<步骤简述> — <原因> — <建议>
-```
-
----
-
-## Forbidden
-
-- 不要直接手改 `openclaw.json`
-- 不要在未确认时覆盖同名 Agent；未确认参数前不要跑 `check_installed`
-- 不要并行多 Agent；不要删其它 Agent 配置
-- 勿把「下载成功」当成「已安装完成」
-- 勿在本 skill 展开脚本实现细节
+---
+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.5
+---
+
+# Agent Install
+
+安装、升级或重置**单个** OpenClaw Agent。本 skill 只做**顺序编排 + 调用脚本**；细节见脚本与 `AGENT-CONFIG.md`。
+
+**串行**：一次只装一个 Agent，禁止并行。
+
+## 对话约束
+
+勿对用户念内部 **status** 枚举；展示安装状态以 **`user_prompt`** 为主。凡提示已备份，须给出 **`backup_dir` 完整路径**（`backup_agent.py` 输出）。密钥勿在公开渠道展示。
+
+---
+
+## Step 1：选定 Agent 并获取安装包
+
+**A. 解析 `agent_id`**
+
+```bash
+uv run {baseDir}/scripts/list_agents.py
+```
+
+非精确 id 时：
+
+```bash
+uv run {baseDir}/scripts/list_agents.py --query "{user_input}" --limit 5
+```
+
+内部：`EXACT_MATCH` → 继续；`NEEDS_CONFIRMATION` → 展示 `confirmation_message`；`NO_MATCH` → 请用户重述。
+
+**B. 下载并校验**
+
+```bash
+npx -y sophhub@latest agent download {agent_id} --path=/home/node/.openclaw/workspace
+```
+
+```bash
+uv run {baseDir}/scripts/verify_download.py \
+  --agent-id "{agent_id}" \
+  --path "/home/node/.openclaw/workspace"
+```
+
+校验失败则**终止全流程**。成功则带同一 `agent_id` 进入 Step 2。
+
+**输入模版**
+
+```text
+🔹【请提供要安装的 Agent】
+- **agent_id**（例：`ai-cs-qa`）或 **自然语言描述**（例：「智能客服 QA」）；不确定可先模糊查再选。
+
+（需多选一）
+⚠️ <confirmation_message>；可选：<suggested_replies>
+
+（未找到）
+❌ 未找到匹配，请换说法或给精确 agent_id。
+```
+
+**输出模版**
+
+```text
+✅ 已确定目标 Agent：<resolved_agent_id>
+📦 下载与校验：<成功 ✅ / 失败 ❌>；失败则 🛑 终止，不继续。
+```
+
+---
+
+## Step 2：参数、占位替换与安装状态检测
+
+依次执行，中间勿插入无关步骤。
+
+**1）解析安装参数**
+
+```bash
+uv run {baseDir}/scripts/resolve_install_params.py \
+  --agent-id "{agent_id}" \
+  --path "/home/node/.openclaw/workspace"
+```
+
+确认 `openclaw_id`、`workspace`、`agent_name`。`placeholder_catalog` / `placeholders_detail` 见 `AGENT-CONFIG.md`。用户可覆盖默认值。
+
+**2）按需替换 `.md` 中 `token`（有 `placeholders` 时）**
+
+```bash
+uv run {baseDir}/scripts/update_agent_md.py \
+  --agent-id "{agent_id}" \
+  --path "/home/node/.openclaw/workspace" \
+  --replace "{{客服助手}}=客服助手"
+```
+
+**3）检测当前安装状态**
+
+```bash
+uv run {baseDir}/scripts/check_installed.py \
+  --agent-id "{agent_id}" \
+  --source-path "/home/node/.openclaw/workspace" \
+  --openclaw-id "{openclaw_id}" \
+  --workspace "{workspace}" \
+  --name "{agent_name}"
+```
+
+对用户主状态含义（内部仍用 JSON `status` 分支，**勿对用户念枚举**）：
+
+- `DEPENDENCY_MISSING`：缺依赖 Agent → 提示先装依赖，**终止**
+- `UPDATABLE`：可升级 → 后续先备份再覆盖；本地若改过配置需自行同步
+- `SAME_VERSION_REINSTALL`：同版本 → 实为**重置**，须确认并先备份
+- `NOT_INSTALLED`：新装 → 可直接进入 Step 3 的拷贝/写配置
+
+兜底：`CONFIG_ERROR` → **终止**，人工核对 workspace / ID / 版本
+
+说明时优先复述 **`user_prompt`**。
+
+**输入模版**
+
+```text
+🔹【确认或覆盖】openclaw_id / workspace / agent_name（默认见脚本）
+⚠️ 若有占位：按 placeholder_catalog 的 label、description 确认每个 token 的替换文案
+```
+
+**输出模版**
+
+```text
+📌 参数已就绪（表格可列 openclaw_id、workspace、agent_name）
+✏️ 若已跑 update_agent_md：<简述>
+🧭 安装状态：用口语复述 user_prompt；CONFIG_ERROR 时 🛑 暂停
+```
+
+---
+
+## Step 3：写入目标环境（条件备份 → 拷贝 → openclaw）
+
+仅在 Step 2 **不是** `DEPENDENCY_MISSING` / `CONFIG_ERROR` 时继续。
+
+**1）备份（仅 `UPDATABLE` 或 `SAME_VERSION_REINSTALL`）**  
+须先让用户回复「确认更新」或「确认重置」，再执行：
+
+```bash
+uv run {baseDir}/scripts/backup_agent.py \
+  --agent-id "{agent_id}" \
+  --openclaw-id "{current_openclaw_id}" \
+  --workspace "{workspace}" \
+  --status "{status}"
+```
+
+成功后必须把 **`backup_dir` 完整路径**告诉用户。其它 status **不要**调备份。
+
+**2）拷贝文件并更新 `openclaw.json`**
+
+```bash
+uv run {baseDir}/scripts/copy_agent_files.py \
+  --agent-id "{agent_id}" \
+  --path "/home/node/.openclaw/workspace" \
+  --workspace "{workspace}"
+```
+
+```bash
+uv run {baseDir}/scripts/update_openclaw.py \
+  --agent-id "{agent_id}" \
+  --source-path "/home/node/.openclaw/workspace" \
+  --openclaw-id "{openclaw_id}" \
+  --workspace "{workspace}" \
+  --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）。
+
+**输入模版（仅要备份时）**
+
+```text
+🔹 确认更新 → 回复：确认更新
+🔹 确认重置 → 回复：确认重置
+```
+
+**输出模版**
+
+```text
+✅ 已备份（如有）：backup_dir = <完整路径>；copied_md_files 可附
+🛠️ openclaw 已更新：摘要 agent_id、openclaw_id、workspace、version、bot-api、install_state（密钥走安全渠道）
+```
+
+---
+
+## Step 4：Skill（auto_install）与完成表
+
+在 Step 3 成功、`openclaw.json` 已写入后执行。
+
+**Skill**：读 workspace 内 `.config.json` 的 `skills`，对 **`auto_install: true`** 的条目：
+
+```bash
+mkdir -p "{workspace}/skills"
+```
+
+```bash
+npx -y sophhub@latest download {skill_name} -o "{workspace}/skills"
+```
+
+`{workspace}` 为本 Agent 工作目录；多条**依次**下载。必要时加 `--type builtin` / `--type store`。
+
+**输出模版**
+
+```text
+📎 Skill：<列出本次 download 成功的 name>；失败须如实说明
+🎉 **Agent 安装流程结束**
+| 项目 | 内容 |
+|------|------|
+| agent_id | <…> |
+| 结果 | <新装 🆕 / 升级 ⬆️ / 重置 🔄> |
+| workspace | <路径> |
+| 备份目录 | <backup_dir 或「本次无备份」> |
+| skills | <已下载 name 列表或「未在本流程下载」> |
+| bot-api | <仅安全渠道> |
+🔐 密钥勿截图发群、勿写入公开工单。
+```
+
+---
+
+## 错误与中止
+
+同版须先确认再备份；本地版本更高勿强退；无 `openclaw.json` 先初始化；`CONFIG_ERROR` 等见 Step 2。
+
+**输出模版**
+
+```text
+❌ 流程中止：<步骤简述> — <原因> — <建议>
+```
+
+---
+
+## Forbidden
+
+- 不要直接手改 `openclaw.json`
+- 不要在未确认时覆盖同名 Agent；未确认参数前不要跑 `check_installed`
+- 不要并行多 Agent；不要删其它 Agent 配置
+- 勿把「下载成功」当成「已安装完成」
+- 勿在本 skill 展开脚本实现细节

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

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