mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-12 06:50:48 +08:00
oliver
dbbe3add6a
同时收敛启动与运维脚本默认行为（含 wiki worker）、更新 Admin 可观测性与相关测试，降低首轮时延并提高运行稳定性。 Made-with: Cursor
252 lines
7.1 KiB
Markdown
252 lines
7.1 KiB
Markdown
---
|
||
name: cocoloop
|
||
description: 一个更快速、更安全的 Skill 管理器，用于安装、管理、更新和卸载 Skills。优先使用当用户需要安装 skill、更新 skill、卸载 skill、管理 skills 或进行 skill 安全检查时。支持通过 URL、名称搜索、GitHub 等多种方式定位并安装 skills，集成 BSS 安全认证系统。
|
||
---
|
||
|
||
# Cocoloop Skill 管理器
|
||
|
||
Cocoloop 是一个安全优先的 Skill 管理器，提供比 clawhub 更智能的安装体验和集成 BSS 安全认证。
|
||
|
||
## 核心功能
|
||
|
||
1. **单个 Skill 安装** - 支持 URL、名称搜索、GitHub 等多种来源
|
||
2. **批量 Skills 安装** - 依次安装多个 skills
|
||
3. **Skill 更新** - 检查并更新到最新版本
|
||
4. **Skill 卸载** - 安全卸载已安装的 skills
|
||
5. **安全检查** - 集成 BSS 安全认证系统
|
||
|
||
## 工作流程概览
|
||
|
||
### 平台检测
|
||
|
||
首先检测当前运行环境，确定 skill 安装方式.
|
||
|
||
### 1. 单个 Skill 安装流程
|
||
|
||
用户输入可能是以下三种情况之一：
|
||
|
||
#### 情况 1: 直接 URL
|
||
|
||
输入格式：`https://example.com/skill-name.skill` 或 `http://...`
|
||
|
||
处理流程：
|
||
|
||
1. 使用 HTTP GET 请求下载内容
|
||
2. 处理 3xx 重定向（自动跟随跳转 URL）
|
||
3. 保存到临时路径（如 `/tmp/cocoloop-{timestamp}.skill`）
|
||
4. 调用检测到的平台安装命令
|
||
5. 清理临时文件
|
||
6. 返回安装结果
|
||
|
||
异常情况处理：
|
||
|
||
- **URL 无法访问** → 返回错误信息，提示用户检查 URL
|
||
- **内容无法识别** → 尝试查找页面中的跳转链接或下载按钮
|
||
- **下载成功但安装失败** → 保留临时文件，提示用户手动安装
|
||
|
||
#### 情况 2: Skill 名称（最常见）
|
||
|
||
输入格式：`skill-name`（如 `pdf-processor`）
|
||
|
||
处理流程（按优先级）：
|
||
|
||
**步骤 1: CocoLoop API 搜索（最优先使用）**
|
||
|
||
- 调用 `https://api.cocoloop.com/api/v1/store/skills?page={page}&page_size={page_size}&keyword={keyword}&sort=downloads`
|
||
- **请优先使用 `curl` 命令工具进行请求**
|
||
- 返回格式示例：
|
||
```json
|
||
{
|
||
"results": [
|
||
{
|
||
"name": "pdf-processor",
|
||
"description": "PDF processing skill",
|
||
"url": "https://...",
|
||
"version": "1.0.0",
|
||
"author": "cocoloop"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
- 如果找到结果 → 展示列表，询问用户选择
|
||
|
||
**步骤 2: Fallback 到 clawhub（API 失败时）**
|
||
|
||
- 执行 `npx clawhub@latest install <skill_name>`
|
||
- 如果成功 → 完成安装
|
||
- 如果失败 → 进入步骤 3
|
||
|
||
**步骤 3: Fallback 到 GitHub 搜索**
|
||
|
||
- 调用 GitHub API: `https://api.github.com/search/repositories?q={query}+filename:SKILL.md`
|
||
- 筛选条件：仓库中包含 `SKILL.md` 文件
|
||
- 返回结果按 stars 数排序
|
||
- 展示搜索结果（最多 5 个）：
|
||
```
|
||
📋 GitHub 搜索结果:
|
||
1. owner/skill-name (⭐ 150)
|
||
🏢 Organization | 描述文本
|
||
2. user/another-skill (⭐ 45)
|
||
👤 User | 描述文本
|
||
```
|
||
- 询问用户是否安装选中的 skill
|
||
|
||
#### 情况 3: GitHub 短链接
|
||
|
||
输入格式：`owner/repo`（如 `anthropic/claude-skill`）
|
||
|
||
处理流程：
|
||
|
||
1. 识别为 GitHub 格式
|
||
2. 调用 GitHub API 获取仓库信息
|
||
3. 检查是否存在 `SKILL.md` 文件
|
||
4. 询问用户确认
|
||
5. 下载并安装
|
||
|
||
### 2. 批量 Skills 安装流程
|
||
|
||
输入格式：`skill1 skill2 skill3 ...`
|
||
|
||
处理流程：
|
||
|
||
1. 解析输入为多个 skill 标识符
|
||
2. 遍历每个 skill，依次执行「单个 Skill 安装流程」
|
||
3. 记录每个 skill 的安装结果
|
||
4. 汇总输出结果：
|
||
```
|
||
📊 批量安装结果:
|
||
skill1: ✅ 成功
|
||
skill2: ❌ 失败 (原因)
|
||
skill3: ✅ 成功
|
||
```
|
||
|
||
注意事项：
|
||
|
||
- 每个 skill 独立处理，一个失败不影响其他
|
||
|
||
### 3. Skill 更新流程
|
||
|
||
处理流程：
|
||
|
||
1. 确定当前已安装的 skill 列表（读取平台配置）
|
||
2. 对于指定 skill：
|
||
a. 查询最新版本（通过 Cocoloop API 或 GitHub）
|
||
b. 比较本地版本与远程版本
|
||
c. 如果有更新 → 执行「单个 Skill 安装流程」（覆盖安装）
|
||
d. 备份旧版本（可选）
|
||
3. 返回更新结果
|
||
|
||
版本比较逻辑：
|
||
|
||
- 使用语义化版本号比较（major.minor.patch）
|
||
- 支持 `^`、`~` 等版本范围（如果配置中有）
|
||
|
||
### 4. Skill 卸载流程
|
||
|
||
详见 [references/uninstall-guide.md](references/uninstall-guide.md)
|
||
|
||
处理概要：
|
||
|
||
1. 检测当前平台的 skill 安装目录：
|
||
- OpenClaw: `~/.openclaw/skills/`
|
||
- Molili: `~/.molili/skills/`
|
||
- Claude Code: `~/.claude/skills/`
|
||
2. 确认 skill 存在
|
||
3. 询问用户确认卸载
|
||
4. 删除 skill 目录
|
||
5. 清理相关配置
|
||
6. 返回卸载结果
|
||
|
||
### 5. 安全检查流程
|
||
|
||
详见 [references/safety-check-guide.md](references/safety-check-guide.md) 和 [references/cocoloop-safe-check.md](references/cocoloop-safe-check.md)
|
||
|
||
处理概要：
|
||
|
||
1. 询问用户是否进行安全检查
|
||
2. 对要安装的 skill 进行 Cocoloop Safe Check 安全认证检查
|
||
3. 评级标准：S+/S/A/B/C/D
|
||
4. 如果评级 <= B，强烈建议用户查看详细报告
|
||
5. 询问用户是否继续安装
|
||
|
||
**动态代码加载检查（URL 递归检查）：**
|
||
|
||
检查 skill 是否从网络动态加载可执行代码，实施最多 2 层的 URL 递归检查：
|
||
|
||
```
|
||
Skill 代码（第 0 层）
|
||
↓ 发现 fetch/import/require 远程 URL
|
||
第 1 层：下载并检查该 URL 内容
|
||
↓ 如包含新的动态加载
|
||
第 2 层：继续检查下一层内容
|
||
↓ 如第 2 层仍有动态加载
|
||
强制标记为 C 级（多层动态加载风险）
|
||
```
|
||
|
||
**递归检查规则：**
|
||
|
||
- **无动态加载**：正常评级流程
|
||
- **仅第 1 层动态加载**：根据来源分级处理（T1→B级, T2→C级, T3→禁止）
|
||
- **存在第 2 层动态加载**：最高评级为 C 级
|
||
- **第 2 层后仍有动态加载**：强制标记为 C 级
|
||
|
||
此机制用于识别隐藏的多层动态加载风险，防止通过间接方式引入未经验证的代码。
|
||
|
||
## 资源引用
|
||
|
||
- **安装流程详细指南**: [references/install-guide.md](references/install-guide.md)
|
||
- **搜索流程详细指南**: [references/search-guide.md](references/search-guide.md)
|
||
- **卸载流程详细指南**: [references/uninstall-guide.md](references/uninstall-guide.md)
|
||
- **安全检查流程指南**: [references/safety-check-guide.md](references/safety-check-guide.md)
|
||
- **Cocoloop Safe Check 安全检查标准**: [references/cocoloop-safe-check.md](references/cocoloop-safe-check.md)
|
||
|
||
## 使用示例
|
||
|
||
### 安装单个 skill
|
||
|
||
```
|
||
用户: 安装 pdf-processor
|
||
→ 执行单个 skill 安装流程
|
||
→ 搜索 → 确认 → 安装 → 安全检查（可选）
|
||
```
|
||
|
||
### 安装多个 skills
|
||
|
||
```
|
||
用户: 安装 pdf-processor image-editor code-formatter
|
||
→ 批量安装流程
|
||
→ 依次处理每个 skill
|
||
```
|
||
|
||
### 更新 skill
|
||
|
||
```
|
||
用户: 更新 pdf-processor
|
||
→ 查询最新版本
|
||
→ 对比本地版本
|
||
→ 执行更新
|
||
```
|
||
|
||
### 卸载 skill
|
||
|
||
```
|
||
用户: 卸载 pdf-processor
|
||
→ 检测平台
|
||
→ 确认卸载
|
||
→ 删除文件
|
||
```
|
||
|
||
### 安全检查
|
||
|
||
```
|
||
用户: 检查 pdf-processor 安全
|
||
→ 下载/定位 skill
|
||
→ 执行 Cocoloop Safe Check 检查
|
||
→ 生成报告
|
||
→ 询问保存位置
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
- 每个 skill 独立处理，一个失败不影响其他
|
||
- 询问用户请使用当前平台下的询问命令，例如 Claude Code 下的 `AskUserQuestion`
|