CherryStudio Skill 新手入门指南：从零搭建你的第一个技能项目

1次阅读

共计 2107 个字符，预计需要花费 6 分钟才能阅读完成。

CherryStudio Skill 是一个用于快速开发和部署智能技能的框架。它让开发者可以轻松构建语音交互、自动化任务处理等能力，并集成到各种平台和应用中。简单来说，你可以把它想象成一个 ” 技能开发工具箱 ”，里面提供了各种现成的工具和接口，帮助你专注于业务逻辑的实现。

技能 (Skill)：完成特定任务的功能单元，比如天气预报查询、待办事项管理等
意图 (Intent)：用户想要执行的操作或获取的信息
槽位 (Slot)：执行意图所需的参数，比如查询天气时的城市、日期
话术 (Utterance)：用户表达意图的自然语言方式

智能家居控制（灯光、温度调节）
企业业务流程自动化（数据查询、报告生成）
教育领域的智能问答系统
电商场景的个性化推荐

任何现代计算机（Windows/macOS/Linux）
推荐配置：4GB 以上内存，20GB 可用存储空间

安装 Node.js (v14+)：

# 使用 nvm 管理 Node 版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
nvm install 16

安装 CherryStudio CLI 工具：
```
npm install -g cherrystudio-cli
```
验证安装：
```
cherry --version
```

mkdir my-first-skill && cd my-first-skill
cherry init

这个命令会创建一个包含以下结构的项目：

my-first-skill/
├── skills/          # 技能实现代码
├── models/          # 数据模型定义
├── tests/           # 测试用例
└── cherry.config.js # 项目配置文件

让我们创建一个简单的 ” 时间查询 ” 技能，当用户询问当前时间时，系统会返回准确的时间信息。

在 models/intents.json 中添加：

{
  "intents": [
    {
      "name": "GetCurrentTime",
      "utterances": [
        "现在几点",
        "当前时间",
        "告诉我现在的时间"
      ]
    }
  ]
}

创建 skills/TimeSkill.js：

/**
 * 时间查询技能实现
 */
module.exports = {
  // 技能元数据
  metadata: {
    name: 'TimeSkill',
    description: '提供当前时间查询功能'
  },

  // 处理函数
  handlers: {GetCurrentTime: async function(input) {
      // 获取当前时间
      const now = new Date();

      // 格式化时间输出
      const hours = now.getHours().toString().padStart(2, '0');
      const minutes = now.getMinutes().toString().padStart(2, '0');

      // 返回响应
      return {text: ` 现在时间是 ${hours} 点 ${minutes} 分 `,
        card: {
          title: '当前时间',
          content: `${hours}:${minutes}`
        }
      };
    }
  }
};

在 cherry.config.js 中添加：

module.exports = {
  skills: [require('./skills/TimeSkill')
  ]
};

启动开发服务器：

cherry serve

使用测试工具访问 http://localhost:3000/test，输入 ” 现在几点 ” 即可看到效果。

现象：用户说 ” 几点钟了 ” 但系统没有触发时间查询

解决：
1. 在意图模型中添加更多样例句式
2. 使用同义词扩展功能增强识别能力

优化建议 ：
1. 减少技能初始化时的资源加载
2. 对耗时操作使用缓存
3. 检查网络请求是否必要

排查步骤 ：
1. 检查 cherry.config.js 配置是否正确
2. 查看日志 cherry logs --tail=100
3. 确保有足够的权限

懒加载 ：只在需要时加载资源

// 在 handler 中动态加载
const heavyModule = await import('./heavy-module');

缓存策略 ：对频繁访问的数据添加缓存

const cache = new Map();

async function getData(key) {if (cache.has(key)) return cache.get(key);
  const data = await fetchData(key);
  cache.set(key, data);
  return data;
}