mirror of
https://github.com/zhayujie/chatgpt-on-wechat.git
synced 2026-07-20 13:47:15 +08:00
docs: add CLI system docs
This commit is contained in:
zhayujie
58
docs/skills/create.mdx
Normal file
58
docs/skills/create.mdx
Normal file
@@ -0,0 +1,58 @@
|
||||
---
|
||||
title: 创建技能
|
||||
description: 通过对话创建自定义技能
|
||||
---
|
||||
|
||||
CowAgent 内置了 Skill Creator，可以通过自然语言对话快速创建、安装或更新技能。
|
||||
|
||||
## 使用方式
|
||||
|
||||
直接在对话中描述你想要的技能，Agent 会自动完成创建：
|
||||
|
||||
- 将工作流程固化为技能："帮我把这个部署流程创建为一个技能"
|
||||
- 对接第三方 API："根据这个接口文档创建一个技能"
|
||||
- 安装远程技能："帮我安装 xxx 技能"
|
||||
|
||||
## 创建流程
|
||||
|
||||
1. 告诉 Agent 你想创建的技能功能
|
||||
2. Agent 自动生成 `SKILL.md` 说明文件和运行脚本
|
||||
3. 技能保存到工作空间的 `~/cow/skills/` 目录
|
||||
4. 后续对话中 Agent 会自动识别并使用该技能
|
||||
|
||||
<Frame>
|
||||
<img src="https://cdn.link-ai.tech/doc/20260202202247.png" width="800" />
|
||||
</Frame>
|
||||
|
||||
## SKILL.md 格式
|
||||
|
||||
创建的技能遵循标准的 SKILL.md 格式：
|
||||
|
||||
```markdown
|
||||
---
|
||||
name: my-skill
|
||||
description: Brief description of the skill
|
||||
metadata:
|
||||
emoji: 🔧
|
||||
requires:
|
||||
bins: ["curl"]
|
||||
env: ["MY_API_KEY"]
|
||||
primaryEnv: "MY_API_KEY"
|
||||
---
|
||||
|
||||
# My Skill
|
||||
|
||||
Detailed instructions...
|
||||
```
|
||||
|
||||
| 字段 | 说明 |
|
||||
| --- | --- |
|
||||
| `name` | 技能名称，需与目录名一致 |
|
||||
| `description` | 技能描述，Agent 据此决定是否调用 |
|
||||
| `metadata.requires.bins` | 依赖的系统命令 |
|
||||
| `metadata.requires.env` | 依赖的环境变量 |
|
||||
| `metadata.always` | 是否始终加载（默认 false） |
|
||||
|
||||
<Tip>
|
||||
详细开发文档可参考 [Skill Creator 说明](https://github.com/zhayujie/chatgpt-on-wechat/blob/master/skills/skill-creator/SKILL.md)。
|
||||
</Tip>
|
||||
@@ -1,31 +0,0 @@
|
||||
---
|
||||
title: 图像识别
|
||||
description: 使用 OpenAI 视觉模型识别图片
|
||||
---
|
||||
|
||||
使用 OpenAI 的 GPT-4 Vision API 分析图片内容，理解图像中的物体、文字、颜色等元素。
|
||||
|
||||
## 依赖
|
||||
|
||||
| 依赖 | 说明 |
|
||||
| --- | --- |
|
||||
| `OPENAI_API_KEY` | OpenAI API 密钥 |
|
||||
| `curl`、`base64` | 系统命令（通常已预装） |
|
||||
|
||||
配置方式：
|
||||
|
||||
- 通过 `env_config` 工具配置 `OPENAI_API_KEY`
|
||||
- 或在 `config.json` 中填写 `open_ai_api_key`
|
||||
|
||||
## 支持的模型
|
||||
|
||||
- `gpt-4.1-mini`（推荐，性价比高）
|
||||
- `gpt-4.1`
|
||||
|
||||
## 使用方式
|
||||
|
||||
配置完成后，向 Agent 发送图片即可自动触发图像识别。
|
||||
|
||||
<Frame>
|
||||
<img src="https://cdn.link-ai.tech/doc/20260202213219.png" width="800" />
|
||||
</Frame>
|
||||
@@ -7,20 +7,17 @@ description: CowAgent 技能系统介绍
|
||||
|
||||
Skill 与 Tool 的区别：Tool 是由代码实现的原子操作（如读写文件、执行命令），Skill 则是基于说明文件的高级工作流，可以组合调用多个 Tool 来完成复杂任务。
|
||||
|
||||
## 内置技能
|
||||
## 获取技能
|
||||
|
||||
位于项目 `skills/` 目录下，根据依赖条件自动判断是否启用：
|
||||
CowAgent 提供多种方式获取技能：
|
||||
|
||||
| 技能 | 说明 | 依赖 |
|
||||
| --- | --- | --- |
|
||||
| [`skill-creator`](/skills/skill-creator) | 通过对话创建自定义技能 | 无 |
|
||||
| [`openai-image-vision`](/skills/image-vision) | 使用 OpenAI 视觉模型识别图片 | `OPENAI_API_KEY` |
|
||||
| [`linkai-agent`](/skills/linkai-agent) | 对接 LinkAI 平台智能体 | `LINKAI_API_KEY` |
|
||||
| [`web-fetch`](/skills/web-fetch) | 抓取网页文本内容 | `curl`（默认启用） |
|
||||
- **Cow 技能广场** — 通过 `/skill list --remote` 浏览和安装社区技能
|
||||
- **GitHub** — 直接从 GitHub 仓库安装，支持批量安装
|
||||
- **ClawHub** — 通过 `/skill install clawhub:名称` 安装 ClawHub 上的技能
|
||||
- **URL** — 从 zip 压缩包或 SKILL.md 链接安装
|
||||
- **对话创建** — 通过自然语言对话让 Agent 自动创建技能
|
||||
|
||||
## 自定义技能
|
||||
|
||||
由用户通过对话创建，存放在工作空间中（`~/cow/skills/`），可实现任何复杂的业务流程和第三方系统对接。
|
||||
详细安装方式参考 [安装技能](/skills/install) 和 [技能管理命令](/commands/skill)。也可以通过对话 [创建技能](/skills/create)。
|
||||
|
||||
## 技能加载优先级
|
||||
|
||||
|
||||
53
docs/skills/install.mdx
Normal file
53
docs/skills/install.mdx
Normal file
@@ -0,0 +1,53 @@
|
||||
---
|
||||
title: 安装技能
|
||||
description: 通过命令一键安装来自多种来源的技能
|
||||
---
|
||||
|
||||
CowAgent 支持通过统一的 `install` 命令安装来自 **Cow 技能广场、GitHub、ClawHub** 以及任意 URL 上的技能。在对话中使用 `/skill install`，在终端中使用 `cow skill install`。
|
||||
|
||||
## 从Cow技能广场安装
|
||||
|
||||
浏览技能广场，找到想要的技能后直接安装：
|
||||
|
||||
```text
|
||||
/skill list --remote
|
||||
/skill install pptx
|
||||
```
|
||||
|
||||
## 从 GitHub 安装
|
||||
|
||||
支持仓库级批量安装和指定子目录安装：
|
||||
|
||||
```text
|
||||
/skill install larksuite/cli
|
||||
/skill install https://github.com/larksuite/cli/tree/main/skills/lark-im
|
||||
```
|
||||
|
||||
## 从 ClawHub 安装
|
||||
|
||||
```text
|
||||
/skill install clawhub:baidu-search
|
||||
```
|
||||
|
||||
## 从 URL 安装
|
||||
|
||||
支持 zip 压缩包和 SKILL.md 文件链接：
|
||||
|
||||
```text
|
||||
/skill install https://cdn.link-ai.tech/skills/pptx.zip
|
||||
/skill install https://example.com/path/to/SKILL.md
|
||||
```
|
||||
|
||||
## 管理技能
|
||||
|
||||
```text
|
||||
/skill list # 查看已安装技能
|
||||
/skill info pptx # 查看技能详情
|
||||
/skill enable pptx # 启用技能
|
||||
/skill disable pptx # 禁用技能
|
||||
/skill uninstall pptx # 卸载技能
|
||||
```
|
||||
|
||||
<Tip>
|
||||
以上所有命令在终端中使用时，将 `/skill` 替换为 `cow skill` 即可。完整命令说明参考 [技能管理命令](/commands/skill)。
|
||||
</Tip>
|
||||
@@ -1,47 +0,0 @@
|
||||
---
|
||||
title: LinkAI 智能体
|
||||
description: 对接 LinkAI 平台的多智能体技能
|
||||
---
|
||||
|
||||
将 [LinkAI](https://link-ai.tech/) 平台上的智能体作为 Skill 使用，实现多智能体决策。Agent 根据智能体的名称和描述智能选择，通过 `app_code` 调用对应的应用或工作流。
|
||||
|
||||
## 依赖
|
||||
|
||||
| 依赖 | 说明 |
|
||||
| --- | --- |
|
||||
| `LINKAI_API_KEY` | LinkAI 平台 API 密钥，在 [控制台](https://link-ai.tech/console/interface) 创建 |
|
||||
| `curl` | 系统命令（通常已预装） |
|
||||
|
||||
配置方式：
|
||||
|
||||
- 通过 `env_config` 工具配置 `LINKAI_API_KEY`
|
||||
- 或在 `config.json` 中填写 `linkai_api_key`
|
||||
|
||||
## 配置智能体
|
||||
|
||||
在 `skills/linkai-agent/config.json` 中添加可用的智能体：
|
||||
|
||||
```json
|
||||
{
|
||||
"apps": [
|
||||
{
|
||||
"app_code": "G7z6vKwp",
|
||||
"app_name": "LinkAI客服助手",
|
||||
"app_description": "当用户需要了解LinkAI平台相关问题时才选择该助手"
|
||||
},
|
||||
{
|
||||
"app_code": "SFY5x7JR",
|
||||
"app_name": "内容创作助手",
|
||||
"app_description": "当用户需要创作图片或视频时才使用该助手"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
## 使用方式
|
||||
|
||||
配置完成后，Agent 会根据用户的问题自动选择合适的 LinkAI 智能体进行回答。
|
||||
|
||||
<Frame>
|
||||
<img src="https://cdn.link-ai.tech/doc/20260202234350.png" width="750" />
|
||||
</Frame>
|
||||
@@ -1,31 +0,0 @@
|
||||
---
|
||||
title: 创建技能
|
||||
description: 通过对话创建自定义技能
|
||||
---
|
||||
|
||||
通过自然语言对话快速创建、安装或更新技能。
|
||||
|
||||
## 依赖
|
||||
|
||||
无额外依赖，始终可用。
|
||||
|
||||
## 使用方式
|
||||
|
||||
- 将工作流程固化为技能："帮我把这个部署流程创建为一个技能"
|
||||
- 对接第三方 API："根据这个接口文档创建一个技能"
|
||||
- 安装远程技能："帮我安装 xxx 技能"
|
||||
|
||||
## 创建流程
|
||||
|
||||
1. 告诉 Agent 你想创建的技能功能
|
||||
2. Agent 自动生成 `SKILL.md` 说明文件和运行脚本
|
||||
3. 技能保存到工作空间的 `~/cow/skills/` 目录
|
||||
4. 后续对话中 Agent 会自动识别并使用该技能
|
||||
|
||||
<Frame>
|
||||
<img src="https://cdn.link-ai.tech/doc/20260202202247.png" width="800" />
|
||||
</Frame>
|
||||
|
||||
<Tip>
|
||||
详细开发文档可参考 [Skill 创造器说明](https://github.com/zhayujie/chatgpt-on-wechat/blob/master/skills/skill-creator/SKILL.md)。
|
||||
</Tip>
|
||||
@@ -1,31 +0,0 @@
|
||||
---
|
||||
title: 网页抓取
|
||||
description: 抓取网页文本内容
|
||||
---
|
||||
|
||||
使用 curl 抓取网页并提取可读文本内容，轻量级的网页访问方式，无需浏览器自动化。
|
||||
|
||||
## 依赖
|
||||
|
||||
| 依赖 | 说明 |
|
||||
| --- | --- |
|
||||
| `curl` | 系统命令（通常已预装） |
|
||||
|
||||
该技能设置了 `always: true`，只要系统有 `curl` 命令即默认启用。
|
||||
|
||||
## 使用方式
|
||||
|
||||
当 Agent 需要获取某个 URL 的网页内容时会自动调用，无需额外配置。
|
||||
|
||||
## 与 browser 工具的区别
|
||||
|
||||
| 特性 | web-fetch（技能） | browser（工具） |
|
||||
| --- | --- | --- |
|
||||
| 依赖 | 仅 curl | browser-use + playwright |
|
||||
| JS 渲染 | 不支持 | 支持 |
|
||||
| 页面交互 | 不支持 | 支持点击、输入等 |
|
||||
| 适用场景 | 获取静态页面文本 | 操作动态网页 |
|
||||
|
||||
<Tip>
|
||||
对于大多数网页内容获取场景，web-fetch 就够用了。只有需要 JS 渲染或页面交互时才需要 browser 工具。
|
||||
</Tip>
|
||||
Reference in New Issue
Block a user