From 5bde11f7686c02caf8b7f1a446c7b954c37a2042 Mon Sep 17 00:00:00 2001 From: yi-ge Date: Tue, 16 Jun 2026 22:54:37 +0800 Subject: [PATCH] =?UTF-8?q?feat(skill):=20=E6=96=B0=E5=A2=9E=20app-install?= =?UTF-8?q?-manager=20=E5=BA=94=E7=94=A8=E5=AE=89=E8=A3=85=E7=AE=A1?= =?UTF-8?q?=E7=90=86=E6=8A=80=E8=83=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 补齐委派式安装的执行半环：核心 Agent 收到安装/卸载/启停指令后，读 registry install.md、跑 docker compose、健康校验，并把真实结果回写 installed-entries.json 状态（installing 转 installed/failed），后端 watcher 据此自动派生/清理服务。 - skills/app-install-manager/SKILL.md（procedural / risk:high，含安装/卸载/启停 SOP） - agent.json: default_enabled.skills 加该技能；version 1.6.2 转 1.7.0 - skills/_index.md 补索引 --- agent.json | 5 +- skills/_index.md | 1 + skills/app-install-manager/SKILL.md | 104 ++++++++++++++++++++++++++++ 3 files changed, 108 insertions(+), 2 deletions(-) create mode 100644 skills/app-install-manager/SKILL.md diff --git a/agent.json b/agent.json index fa8ed0f..c7e565a 100644 --- a/agent.json +++ b/agent.json @@ -2,7 +2,7 @@ "name": "DesireCore", "$schema": "http://desirecore/schemas/agent.json", "id": "7da73b7f-bb08-4e7b-a3cf-5d4af6e22c7f", - "version": "1.6.2", + "version": "1.7.0", "description": "系统中枢调度器，负责任务分发、Agent 编排与全局状态监控", "author": "DesireCore Team", "repository": { @@ -19,7 +19,8 @@ "delete-agent", "self-evolve", "task-management", - "discover-agent" + "discover-agent", + "app-install-manager" ], "tools": [] }, diff --git a/skills/_index.md b/skills/_index.md index eb83f5d..2299342 100644 --- a/skills/_index.md +++ b/skills/_index.md @@ -14,6 +14,7 @@ | 技能 ID | 描述 | 风险 | |---------|------|------| | [task-management](./task-management/SKILL.md) | 任务创建、分配、跟踪与多 Agent 编排 | low | +| [app-install-manager](./app-install-manager/SKILL.md) | 应用与服务目录的 docker-app 安装/卸载/启停 + 安装状态回写 | high | ## 技能协作关系 diff --git a/skills/app-install-manager/SKILL.md b/skills/app-install-manager/SKILL.md new file mode 100644 index 0000000..ca9aec7 --- /dev/null +++ b/skills/app-install-manager/SKILL.md @@ -0,0 +1,104 @@ +--- +name: 应用安装管理 +description: 从应用与服务目录安装/卸载/启停 docker-app（读 install.md → 跑 docker compose → 健康校验 → 回写安装状态）。Use when 用户要求"安装 Dify/n8n 等应用"、"卸载某应用"、"启动/停止/重启某应用"，或安装请求以"请安装 {应用} 到 {设备}"形式到达。 +version: "1.0.0" +type: procedural +risk_level: high +status: enabled +disable-model-invocation: true +tags: [installation, docker, registry, app-management] +metadata: + author: desirecore + updated_at: "2026-06-16" +--- + +# app-install-manager 技能 + +## L0：一句话摘要 + +应用生命周期执行者：把目录里的 docker-app 真正装起来/卸下去，并把真实结果回写到安装记录，让"应用与服务"界面反映真实状态。 + +## L1：概述与使用场景 + +DesireCore 的应用安装是**委派式**的——界面只发出"请安装 {应用} 到 {设备}"这类自然语言指令并乐观记下一条 `installing` 状态；**真正的 docker 执行与状态回写由本技能（你）完成**。后端会监听安装记录文件，在状态变为 `installed` 后自动派生该应用暴露的服务。 + +使用场景： +- 用户说"安装 Dify""把 n8n 装到本机" +- 用户说"卸载 RagFlow""停止/启动/重启 Open WebUI" +- 收到形如"请安装 {name} 到{device}"的指令 + +## L2：详细规范（SOP） + +### 关键路径与数据 + +- 应用元数据：`/registry/official/entries//manifest.json` +- 安装指南：`<同目录>/install.md`（含端口、docker compose 步骤、验证地址） +- 安装记录：`/config/installed-entries.json` + （`<根目录>` 为你的 AgentFS 根，生产为 `~/.desirecore`，开发隔离为 `~/.desirecore-dev`，以自我感知里的实际根目录为准） + +安装记录条目结构（写回时必须完整保留全部字段）： + +```json +{ + "entryId": "dify", + "type": "docker-app", + "deviceId": "<设备ID>", + "deviceName": "<设备名>", + "version": "<版本>", + "installedAt": 1730000000000, + "installedBy": "agent", + "status": "installing | installed | failed | uninstalled", + "conversationId": "<对话ID>", + "messageId": "<消息ID>" +} +``` + +`status` 含义：`installing`=界面乐观态（待你回写）；`installed`=已装好且容器在跑；`failed`=安装失败；`uninstalled`=已卸载。**后端只在 `installed` 时派生服务、在非 installed 时清理派生**——所以你回写的状态直接决定目录是否出现该应用的派生服务。 + +### 安装流程 + +1. **解析意图**：从指令提取 `action`（install/uninstall/start/stop/restart）、应用名 → 映射到 `appId`（查 registry entries 目录名 / manifest.id），以及目标设备（缺省=本机）。 +2. **读目录数据**：`read` manifest.json 拿到 `install.requirements`（docker/内存/磁盘/ports）与 `exposes`；`read` install.md 拿到部署步骤与验证地址。 +3. **环境校验**（`bash`）：`docker version` / `docker compose version` 确认 docker 就绪；用 manifest.ports 检查端口占用（`lsof -i :` 或 `docker ps`）；磁盘空间。任一不满足→停下，向用户说明并给出修复建议，**不要**继续。 +4. **高风险确认**：安装/卸载会改动本机容器，属高风险。执行前用一句话向用户确认（应用名 + 目标设备 + 端口）。用户取消则中止。 +5. **执行**（`bash`，严格按 install.md）： + - docker-compose 类：在应用工作目录 `docker compose up -d`；docker 类：`docker run ...`。 + - 失败立即捕获输出，进入"失败处理"。 +6. **健康校验**：按 install.md 的验证地址或 manifest.exposes 的 `http://localhost:`，`bash` 用 `curl` 轮询（最多 ~2 分钟）确认服务可达。 +7. **回写安装记录**（**本技能的核心职责**）： + - 读 `installed-entries.json` → 按 `entryId`+`deviceId` 定位那条 `installing` 记录 → 把 `status` 改为 `installed`（成功）或 `failed`（失败）→ 写回整个文件。 + - **read-modify-write，只改目标条目的 status，保留其余所有字段与其它条目**（界面也会写此文件，勿覆盖丢失）。 + - 成功后无需手动派生服务——后端文件 watcher 会在检测到 `installed` 后自动派生。 +8. **回报用户**：一句话总结结果 + 访问地址（成功）或失败原因 + 排查建议（失败）。 + +### 卸载流程 + +1. 确认（高风险）。 +2. `bash`：进应用工作目录 `docker compose down -v`（或 `docker rm -f <容器>`），按需清理卷/镜像。 +3. 回写安装记录：把该条目 `status` 改为 `uninstalled`（或移除该条目）。后端 watcher 会据此自动清理派生服务与 per-service Skill。 +4. 回报用户。 + +### 启动 / 停止 / 重启 + +收到"启动/停止/重启 {应用}"：定位应用工作目录，`bash` 执行 `docker compose start|stop|restart`（或 `docker start|stop|restart <容器>`），回报结果。这类运行态切换不改变安装记录的 install 状态。 + +### 失败处理 + +| 场景 | 处理 | +|------|------| +| docker 未运行 | 提示用户启动 Docker，安装记录回写 `failed` 或保留 `installing` 并说明 | +| 端口被占用 | 列出占用进程，建议换端口或停占用，征求用户意见 | +| compose 启动失败 | `docker compose logs` 取错误，回写 `failed`，附日志摘要 | +| 健康校验超时 | 提示"可能仍在启动"，给出查看日志的命令；如确认失败回写 `failed` | + +### 边界与安全 + +- 只装 registry 目录中存在的应用；找不到 appId 就明确告知，不要臆造安装命令。 +- 所有破坏性 docker 操作前必须有用户确认（risk_level: high）。 +- 写 installed-entries.json 必须保结构合法（status 仅限四枚举值），否则界面加载会过滤掉脏条目。 + +## 与其他技能/系统的协作 + +- **后端 installed-entries watcher**：消费你回写的 status，自动派生/清理服务，无需你手动调派生接口。 +- **task-management**：长安装可登记为任务跟踪进度。 +- **service-health**：派生出的服务由后端周期探活，你无需自行维护其健康。