360 Secure SkillHub
360 安全技能中心

ai-capabilities

将人设档案、AIRI情感分析、InstantID照片生成、TTS语音合成与Kolors图像生成五大引擎封装为19个标准化MCP工具,接收统一JSON请求(tool+params),完成需求识别、参数校验、能力调用与结果结构化返回,并给出错误码与多层降级说明。

thcjp
thcjp
热度 37.97
最近更新 2026-09-22 02:56:51
分类:创作依赖:MCP 服务 / 第三方 API / 读写文件应用场景:图像生成 / API 集成

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add ai-capabilities
Metadata
name
ai-capabilities
description
AI能力聚合器,聚合5大引擎(人设档案/AIRI情感/InstantID照片/TTS语音/Kolors图像),提供19个标准化MCP工具。v4.0已合并cosyvoice统一TTS能力(15种情感控制+8种音色+三层降级SiliconFlow/KittenTTS/Edge-TTS+PPS人物一致性+预处理管道+场景组合prompt+智能分块)。触发:AI能力/人设管理/情感分析/语音合成/TTS/图像生成/照片生成/cosyvoice/情感控制/音色选择
version
1.0.0
tools
["read","write"]
dependencies
["airi","flux"]
metadata
{"category":"default","openclaw":{"emoji":"⚙️","os":["win32","linux","darwin"],"requires":{"bins":[],"config":["mcp.servers.ai-capabilities-mcp","mcp.servers.tts-adapter-mcp"],"env":["SILICONFLOW_API_KEY"]}}}

ai-capabilities 技能

AI能力聚合器,统一封装5大引擎(人设档案/AIRI情感/InstantID照片/TTS语音/Kolors图像)的19个MCP工具。通过MCP协议对外暴露标准化工具接口,其他Skill可按需调用,无需各自对接底层API。

使用场景

  • 人设档案管理:创建/查询/更新/验证人设档案,列出所有人设
  • AIRI情感引擎:获取人设信息、分析8维情感向量、检查人设一致性、获取情感状态、更新人设、注入上下文
  • InstantID照片生成:基于人设描述生成场景适配照片,检查模型状态
  • TTS语音合成:多引擎语音合成(SiliconFlow/KittenTTS/Edge-TTS),获取音色和引擎列表
  • Kolors图像生成:5种场景模板图像生成,查看场景列表和引擎状态

工作流

  1. 需求识别: 解析用户输入,判断所需AI能力类型(人设管理/情感分析/照片生成/语音合成/图像生成)
  2. 参数校验: 检查必填参数是否完整,API Key是否已配置,不完整则返回错误提示
  3. 能力调用: 根据识别结果调用 ai-capabilities MCP对应工具,传入格式化参数
  4. 结果处理: 解析MCP返回结果,提取有效内容,过滤冗余信息
  5. 结果返回: 将处理后的结果以结构化格式返回给调用方

工具列表

人设档案引擎 (persona_profile_engine)

工具名 描述 参数
create_persona 创建新的人设档案(含voice/text_style/photos配置) agent_id(必填), name, age, gender, profile_overrides
get_persona_profile 获取完整人设档案(含voice/text_style/photos) agent_id(必填)
aicap_update_persona 更新人设档案字段(支持嵌套字段如voice.voice_id) agent_id(必填), updates(必填)
validate_persona 验证人设档案完整性和一致性(评分+问题列表) agent_id(必填)
aicap_list_personas 列出所有人设档案(摘要信息) 无

AIRI情感引擎 (airi_engine)

工具名 描述 参数
aicap_get_persona 获取指定Agent的人设信息(从SOUL.md读取) persona_id(必填)
aicap_analyze_emotion 分析消息的8维情感向量 text(必填)
check_persona_consistency 检查内容是否符合人设定义(属性一致性/历史冲突/风格匹配) persona_id(必填), content(必填)
get_emotion 获取用户当前情感状态(从MEMORY.md缓存读取) user_id(必填)
update_persona_airi 更新人设字段值(Airi引擎,写入SOUL.md) persona_id(必填), updates(必填)
inject_context 融合AirI context-prompt逻辑,将人设/记忆/情感格式化为LLM可读的System Prompt persona_id(必填), message(必填), target_emotion

InstantID照片引擎 (instantid_engine)

工具名 描述 参数
aicap_generate_photo 基于基础照片+人设描述生成符合身份的照片(场景适配: daily/travel/work/holiday) agent_id(必填), scene, description
check_model_status 检查InstantID模型和InsightFace库是否就绪 无

TTS语音引擎 (tts_engine)

工具名 描述 参数
synthesize 语音合成v2.0(SiliconFlow CosyVoice2主力+KittenTTS降级+Edge-TTS兜底) text(必填), voice_id, engine, speed, pitch
get_voices 获取可用音色列表(8种预设) 无
get_engines 获取TTS v2.0引擎列表及状态 无

Kolors图像引擎 (kolors_engine)

优先级标注: 【P1备选】kolors_engine是ai-capabilities-mcp内置的Kolors图像生成引擎(5种场景模板:product/lifestyle/avatar/banner/social_card)。kolors-mcp已删除(BUG-V6-002),Kolors真人照片场景(8种场景+地标打卡)请使用flux-mcp.generate_photo,通用Kolors生图可使用本引擎。

工具名 描述 参数
generate_image 使用Kolors模型生成图像(5种场景模板: product/lifestyle/avatar/banner/social_card) prompt(必填), scene, width, height
list_scenes 列出可用的图像生成场景模板 无
check_kolors_status 检查Kolors引擎状态和配置 无

输入格式

{
  "tool": "create_persona|aicap_analyze_emotion|aicap_generate_photo|synthesize|generate_image|...",
  "params": {
    "agent_id": "agent_001",
    "name": "Luna"
  }
}

输出格式

{
  "success": true,
  "data": {
    "content": "工具返回的具体数据",
    "tool": "create_persona"
  }
}

异常处理

错误代码 异常场景 处理方式
AI_E001 API Key未配置或无效 返回错误提示,引导用户检查SILICONFLOW_API_KEY环境变量
AI_E002 API调用超时(>30秒) 提示服务繁忙,建议稍后重试,记录超时日志
AI_E003 API返回非200状态码 解析错误信息,返回具体原因(余额不足/限流/模型不可用)
AI_E004 工具不存在 返回参数校验错误,列出可用工具名
AI_E005 输入参数为空 返回参数校验错误,要求提供有效输入
AI_E006 MCP服务不可用 降级提示AI服务暂时不可用,记录告警日志

示例

示例1: 创建人设档案

# 创建新员工人设
调用 create_persona 工具,agent_id="agent_001", name="Luna", age=22, gender="female"
→ 返回创建成功的人设档案

示例2: 情感分析

# 分析用户消息情感
调用 aicap_analyze_emotion 工具,text="最近好累啊不想上班"
→ 返回8维情感向量(sadness=0.7, trust=0.5, ...)

示例3: 语音合成

# 合成语音
调用 synthesize 工具,text="欢迎关注我的公众号", voice_id="female_gentle"
→ 返回音频文件路径

示例4: 图像生成

# 生成产品展示图
调用 generate_image 工具,prompt="AI绘画工具界面截图", scene="product"
→ 返回生成的图片路径