cloudplus
# CloudPlus Skill
## 环境准备
在执行任何操作前,按以下顺序检查:
**第一步:检查 Node.js 是否安装**
```bash
node --version
```
如果命令不存在,告知用户先安装 Node.js(https://nodejs.org),安装完成后再继续。
**第二步:检查 mcp-cloudplus 是否安装**
```bash
which mcp-cloudplus
```
如果命令不存在,执行安装:
```bash
npm install -g cloudplus-mcp-server
```
安装完成后继续执行用户请求。
## 命令列表
所有命令输出 JSON,格式为 `{"success":true,"data":{...}}` 或 `{"success":false,"error":"..."}`。
### 发送消息
```bash
mcp-cloudplus send-text --to <用户名或群名> --message <内容>
```
### 发送文件
```bash
mcp-cloudplus send-file --to <用户名或群名> --file <文件路径>
```
发送之前先确认完整路径,并检查文件是否存在
### 搜索联系人
```bash
mcp-cloudplus search-user <关键词>
```
支持姓名、手机号模糊搜索,最多返回 50 条。
### 搜索群聊
```bash
mcp-cloudplus search-group-chat <关键词>
```
### 搜索聊天文件
```bash
mcp-cloudplus search-file <关键词>
```
### 搜索聊天消息
```bash
mcp-cloudplus search-message <关键词>
```
### 搜索轻应用
```bash
mcp-cloudplus search-light-apps <关键词>
```
### 获取聊天记录
```bash
mcp-cloudplus get-chat-history --username <用户名或群名> --start <YYYY-MM-DD> [--end <YYYY-MM-DD>]
```
`--end` 不填默认为当前时间。
### 获取收藏内容
```bash
mcp-cloudplus get-collect-content
```
### 在云加中打开链接
```bash
mcp-cloudplus open-url <url>
```
### 在云加中打开轻应用
```bash
mcp-cloudplus open-app <应用名>
```
### 启动云加
```bash
mcp-cloudplus open-cloudplus
```
## 错误处理
- `找不到管道路径文件` → 提示用户确认云加桌面客户端是否已启动
- `success: false` 且其他错误 → 将 `error` 字段内容告知用户
- 命令不存在 → 重新执行安装步骤
## 操作流程
1. 检查 `mcp-cloudplus` 是否安装,未安装则安装
2. 执行对应命令
3. 解析 JSON 结果
4. 用自然语言向用户反馈结果,不要把原始 JSON 直接展示给用户
标签
skill
ai