安装与激活技能

技能创建完成后，需要在 CeeCore 设备上安装和激活才能运行。本文介绍三种安装方式。

三种安装方式

方式适用场景
技能市场安装普通用户从技能市场浏览并安装
本地手动安装开发者在开发测试阶段
CLI 命令行安装高级用户和自动化部署

方式一：技能市场安装

用户视角

  1. 打开 CeeCore App，进入「技能市场」
  2. 浏览或搜索技能
  3. 点击技能卡片查看详情
  4. 点击「安装」按钮
  5. 填写配置参数（如 API Key、城市等）
  6. 点击「激活」启用技能

安装流程

浏览技能市场 → 点击安装 → 填写配置 → 激活 → 技能开始运行

管理已安装技能

在 App 的「我的技能」页面可以：

  • 查看所有已安装技能
  • 修改配置参数
  • 暂停/启用技能
  • 卸载技能
  • 查看技能运行日志

方式二：本地手动安装

作为开发者，在开发阶段需要频繁测试技能。本地安装是最快的方式。

步骤

1. 打包技能目录

确保技能包目录结构完整：

ls your-skill/
# 输出：
# manifest.json  config.schema.json  prompt.md  tools.json  icon.png  README.md

2. 拷贝到设备

将技能包目录拷贝到 CeeCore 设备的 skills 目录：

# 通过 SCP 或设备文件管理器
scp -r your-skill/ root@<device-ip>:/data/ceecore/skills/

3. 在 App 中激活

拷贝完成后，在 App 的「我的技能」→「本地技能」中可以看到新技能，点击激活。

4. 快速验证

激活后，向 Agent 发送一条测试消息，确认技能是否正常工作：

"帮我查一下今天的天气"

本地安装的注意事项

  • 本地安装的技能不会出现在技能市场（仅你可见）
  • 修改技能文件后需重新激活才能生效
  • 本地技能优先级高于市场技能（同名时覆盖）

方式三：CLI 命令行安装

最低版本要求：CeeCore CLI ≥ 1.0.0

CeeCore CLI 提供了命令行安装方式，适合自动化脚本。

# 安装技能
ceecore skill install ./your-skill/

# 查看已安装技能
ceecore skill list

# 激活技能
ceecore skill activate your-skill-id

# 暂停技能
ceecore skill deactivate your-skill-id

# 卸载技能
ceecore skill uninstall your-skill-id

# 查看技能日志
ceecore skill logs your-skill-id

安装后的验证

技能激活后，用以下方式确认一切正常：

1. 检查技能状态

在 App 中查看技能状态是否为「运行中」。

2. 发送测试消息

向 Agent 发送一条触发技能的消息，观察回复是否符合预期。

3. 查看运行日志

ceecore skill logs your-skill-id --tail 20

4. 检查配置

确认配置参数是否正确写入：

ceecore skill config your-skill-id

常见问题

Q: 安装后技能没有反应？

  • 检查技能是否已激活（状态为「运行中」）
  • 查看运行日志，确认是否有错误信息
  • 确认配置参数填写正确（尤其是 API Key 类参数）
  • 尝试重新激活技能

Q: 本地安装的技能和市场安装的技能冲突？

本地技能同名时优先于市场技能。如果不需要本地版本，卸载即可。

Q: 修改了 prompt.md 后需要重新安装吗？

不需要。修改技能文件后，在 App 中点击「重新激活」即可，无需重新安装。

Q: 技能可以在多台设备上使用吗？

可以。市场安装的技能与账号绑定，登录同一账号的其他设备也可以安装使用。

下一步

技能安装和激活完成后，可以深入学习：

← 技能包结构 | Prompt 编写最佳实践 →

返回文档中心