前言¶
在人机交互或心理健康相关产品中，若需要 Agent 根据画面判断用户情绪，常见做法是自行对接视觉模型、整理情绪标签与强度输出，再在提示词里约束调用方式。SkillHub 上的 Visual Emotion Recognition Skill（人体视觉情绪识别技能） 把「正面人脸 + 多维度情绪 + 强度与异常标记」封装成 Agent Skill，安装后由 Agent 按 SKILL.md 约定使用，减少重复集成工作。
这是什么¶
Visual Emotion Recognition Skill 是社区发布者 user_bb47e3e3 在 SkillHub 上架的 ai-agent 类 Skill，坐标为 @user_bb47e3e3/human-emotion-recognition-analysis，当前页面版本为 1.0.8，来源标注为 community。
官方简介说明：基于正面人脸的视觉 AI，可实时识别快乐、悲伤、抑郁、平静、愤怒、惊讶、恐惧等多维度情绪状态，并支持情绪强度量化与异常情绪标记，面向人机交互、心理健康监测等场景。页面标签标明 requires_api_key=false，即按 SkillHub 展示无需额外配置 API Key。
SkillHub 展示页：https://www.skillhub.cn/skills/user_bb47e3e3/human-emotion-recognition-analysis
技能 API 入口（与商店条目对应）：https://api.skillhub.cn/user_bb47e3e3/human-emotion-recognition-analysis
核心功能¶
以下能力均来自 SkillHub 条目简介与标签，未在页面展开的接口细节不在本文臆造。
- 正面人脸情绪识别：针对正面人脸画面，用视觉 AI 做实时或近实时分析。
- 多维度情绪标签：覆盖快乐、悲伤、抑郁、平静、愤怒、惊讶、恐惧等维度。
- 情绪强度量化：在识别类别之外，对情绪强度做量化表达（具体字段以安装后的
SKILL.md为准）。 - 异常情绪标记：支持对异常情绪状态做标记，便于监测类流程跟进。
- 场景定位：官方描述适配人机交互与心理健康监测；实际合规与医疗用途需由业务方自行评估。
安装与启用¶
SkillHub 推荐两种方式：用 CLI 安装，或把安装提示词交给当前 AI Client 的 Agent 执行。
1、准备 SkillHub CLI¶
若本机尚未安装，可先检查版本：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill 到当前 Agent 的 skills 目录¶
SkillHub 要求安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。
skillhub install user_bb47e3e3/human-emotion-recognition-analysis --dir <你的 skills 目录>
常见 Client 的 skills 路径（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
在 Cursor 中示例：
skillhub install user_bb47e3e3/human-emotion-recognition-analysis --dir ~/.cursor/skills/
3、通过 Agent 提示词安装¶
SkillHub 页面提供的提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_bb47e3e3/human-emotion-recognition-analysis`。
将上述内容发给当前环境的 Agent，由其按安装文档完成拉取与目录放置。经过上面的步骤后，重启或刷新 Agent 对 skills 的加载策略（以你所用 Client 文档为准），即可在对话中触发该 Skill。
典型用法¶
公开商店页未附带独立的 REST 调用示例或样例代码；本 Skill 遵循通用 SKILL.md 格式，能力说明与调用约定在安装包内。
可复现的使用路径如下：
- 按上一节完成安装，确认
@user_bb47e3e3/human-emotion-recognition-analysis出现在 Agent 的 skills 列表或目录中。 - 在任务中提供正面人脸相关的图像或视频输入（或明确描述需要基于当前视觉上下文做情绪分析），并说明关注点，例如需要哪些情绪维度、是否要强度与异常标记。
- 由 Agent 根据
SKILL.md调用技能逻辑，返回多维度情绪、强度及异常标记结果；具体输出结构以技能包文档为准，本文不编造字段名或示例 JSON。
若需确认行为边界，安装后可直接打开该 Skill 目录下的 SKILL.md 阅读官方维护的说明。
适用场景与注意¶
适合谁
- 需要在 Agent 工作流里做正面人脸情绪感知的开发者或产品团队。
- 做人机交互原型、客服辅助、心理健康监测类产品时，希望减少自研视觉情绪管线的前期集成。
限制与注意
- 识别对象强调正面人脸；侧脸、遮挡、低光照等情况下的效果页面未承诺，上线前需自测。
- 情绪与「抑郁」等标签属于敏感领域，监测类场景需符合当地法规与伦理要求，本文不构成医疗建议。
- 版本、下载量、评分以 SkillHub 页面实时数据为准；撰写时条目为 v1.0.8，社区来源，标签为无需 API Key。
- 技能 API 地址
https://api.skillhub.cn/user_bb47e3e3/human-emotion-recognition-analysis在抓取时返回 HTTP 405，日常安装与使用以 SkillHub CLI 或 Agent 安装流程为主。
结尾¶
Visual Emotion Recognition Skill 把正面人脸的多维度情绪识别、强度量化与异常标记收敛为一个可安装的 Agent Skill，适合希望快速在 Agent 侧接入视觉情绪能力的团队。安装与优先源配置见 https://skillhub.cn/install/skillhub.md ，技能详情与安装入口见 https://www.skillhub.cn/skills/user_bb47e3e3/human-emotion-recognition-analysis 。
