最佳实践
[TOC]
# QoderWork CN Skills 技能包操作指南
## 一、准备工作
### 1. 下载并安装 QoderWork CN 桌面应用
**软件下载地址：** [https://qoder.com.cn/qoderwork](https://qoder.com.cn/qoderwork)
点击「Windows Windows 10+」，根据当前系统选择相应版本下载：
**版本选择说明：**
| 操作系统 | 版本类型 | 说明 |
|----------|----------|------|
| **Windows** | 系统版 | 为电脑上所有用户安装，需要管理员权限 |
| **Windows** | 用户版 | 仅为当前用户安装，无需管理员权限 |
| **macOS** | Apple Silicon / Intel | 下载页会自动匹配您的 Mac 芯片型号 |
> **说明：** 本教程基于 Windows 11 环境，以 X64（System）版作为功能演示，软件版本为 0.9.11。若您的操作系统或软件版本与演示差异较大，请参考 [官方帮助手册](https://help.aliyun.com/zh/lingma/qoderwork-cn/product-overview/what-is-qoderwork-cn)。
下载完成后，双击安装包并按提示完成安装，随后注册并登录软件。注册、登录等基础步骤此处不再赘述。
---
### 2. 注册 ShowAPI 平台账号
**注册地址：** [https://www.showapi.com/auth/reg](https://www.showapi.com/auth/reg)
> 若您已注册，可跳过此步骤。
---
### 3. 获取 AppKey
**登录地址：** [https://www.showapi.com/auth/login](https://www.showapi.com/auth/login)
登录成功后，按以下路径操作：
**右上角「控制台」 → 左侧菜单「接口使用者」 → 「appKey 管理」**
如下图所示：
您可以根据需要创建独立的应用和 appKey，并设置访问 IP 或接口权限。
点击「查看」按钮，输入注册密码后即可查看并复制 appKey。**该密钥将在后续调用 Skills 时使用，请妥善保存。**
---
## 二、下载技能包
### 1. 进入 Skills 市场
访问 [万维易源平台首页](https://www.showapi.com/)，登录后点击导航栏 **「AI Skills」 → 「Skills 市场」**：
或直接访问：[https://www.showapi.com/ai/skills/market](https://www.showapi.com/ai/skills/market)
Skills 市场界面如下：
---
### 2. 下载 Skill（技能）
在 Skills 市场中浏览并查找您需要的技能：
> **提示：** Skills 市场的内容会动态更新，您看到的界面可能与示例略有不同。
本示例以 **「文创设计」** 技能包为例进行演示（其他技能包的安装步骤相同）。在搜索框中输入「文创设计」，找到对应的 Skill 卡片：
点击卡片后，依次选择：
1. **「Agent 使用与开发集成」**
2. **「Agent 接入」**
3. **「选择客户端下载技能包」**
技能包提供中英文两个版本，部分工具仅支持英文版，请根据实际需求选择。本示例使用英文版，点击 **「QoderWork CN」** 旁的下载图标进行下载。
> **注意：** 请留意技能包的保存路径，后续安装步骤中需要选择该文件。
---
## 三、安装技能包
### 1. 打开软件
---
### 2. 导入技能包
在 QoderWork CN 中，依次点击：
**「技能」 → 「添加」**
然后通过文件上传的方式，选择此前下载好的技能包：
选择下载好的技能 ZIP 压缩包后，点击「安装」按钮开始安装。若出现错误提示，说明技能包存在问题。
**常见错误提示（技能包有误）：**
**正确提示（安装成功）：**
安装成功后，依次点击 **「技能」 → 「已安装」**，即可查看刚安装的技能包。列表中会出现一个以 `creative-disign-` 开头的技能，即此前下载的「文创设计」技能：
---
## 四、使用技能
### 1. 查阅技能参数
以「文创设计」Skill 为例，在线测试地址：
[https://www.showapi.com/ai/skills/6a4c58393c51f2d32d00c4fc?tab=run](https://www.showapi.com/ai/skills/6a4c58393c51f2d32d00c4fc?tab=run)
在线测试界面如下：
该技能包含以下四个参数：
| 参数 | 说明 | 是否必填 |
|------|------|----------|
| **产品图排版** | 生成图片的宫格数量（1~4 宫格） | ✅ 必填 |
| **参考图** | 图片 URL 或 Base64 字符串 | 可选 |
| **产品描述** | 提示词（Prompt） | 可选 |
| **长宽比** | 生成图片的比例，默认 1:1 | 可选 |
> **建议：** 为获得最佳生成效果，提示词中尽量包含以上所有参数，并详细描述各参数对应的内容。
---
### 2. 调用技能的提示词
点击左侧菜单中的 **「新任务」**，在输入框中输入 `/creativ`，然后选择如图所示的技能包：
输入您的需求（即提示词），建议尽量涵盖测试界面中的所有参数。
**参考示例：**
```
生成一个文化创意的产品宣传图，图片主要描述江浙一带的绸缎文化，图片为四宫格，长宽比为 16:9 横版，产品参考图：https://oss.showapi.com/doc/4826/5/ae919726ce38_1780382555943.jpg
```
该提示词包含以下四个参数信息：
| 序号 | 参数 | 值 |
|------|------|-----|
| 1 | `grid_num` | `4` |
| 2 | `image` | `https://oss.showapi.com/...82555943.jpg` |
| 3 | `prompt` | `生成一个文化创意的产品宣传图，图片主要描述江浙一带的绸缎文化` |
| 4 | `aspect_ratio` | `16:9` |
如上图，填写好提示词后，按 **Enter** 或点击右下角 **发送按钮**，即可开始调用 Skill。
---
### 3. 调用过程及结果
> **重要提示：**
> - 首次调用 Skill 时，需要配置 AppKey。后续调用同一 Skill 时无需重复配置。
> - AppKey 获取地址：[https://www.showapi.com/console#/myApp](https://www.showapi.com/console#/myApp)
> - 调用过程中，系统可能会不定时在提示词输入框或整个窗口界面弹出交互窗口，请根据实际情况进行确认和操作（如网络请求权限确认、文件操作确认、密钥调整、环境变量修改等）。不同 Skill 的交互提示内容各不相同，此处不再逐一展示，请依据提示操作即可。
**AppKey 设置交互：**
> **说明：** 由于初次使用未配置 AppKey，软件运行过程中会尝试从多个位置获取 AppKey，导致执行时间较长。若未等到 AppKey 设置提示，可手动停止运行并直接配置 AppKey，然后重新提交。同时，为保证服务质量，建议将模型由默认的 Auto 切换为 Qwen3.7-Plus。
**完整的交互过程（步骤较多，分多张截图展示）：**
**最终生成的结果图：**
