facephys生理检测

概述

FacePhys 视频生理检测

FacePhys 是微面科技研发的无接触生理与情绪感知模型。上传一段正脸自拍视频，即可了解心率、HRV、呼吸率、情绪状态和视频信号质量，无需佩戴手环或其他设备。

第一次使用：三步完成

本 Skill 默认使用官方 FacePhys CLI，不要求 WorkBuddy 连接器里存在 FacePhys，也不要求用户下载或配置 MCP。只有当 WorkBuddy 将 FacePhys 发布到 MCP Hub 并且已经显示在连接器列表中时，才可以把 MCP 作为可选加速路径。

1. 配置自己的 FacePhys Agent Key

打开 FacePhys Agent Connect 控制台，创建或选择一个 Agent Key。一个 Agent Key 包含 Key ID 和 Secret，两者都需要配置。

• 将 Secret 只填入 WorkBuddy 为本 Skill 提供的安全凭证设置 FACEPHYS_SECRET_KEY，不要发送到聊天中。
• Key ID 不是 Secret。优先填入安全凭证设置中的 FACEPHYS_KEY_ID；如果页面只提供 Secret 输入框，可以把 Key ID 告诉 WorkBuddy，由它运行 bash ./setup.sh fp_set_key_id "<Key ID>" 保存在本机。
• 不要把 Secret 粘贴到聊天、命令参数、连接器配置、代码仓库或报告。Skill 不读取浏览器密码、系统凭证库或其他应用的配置文件。
• Skill 本身免费；每次分析会消耗 FacePhys 账户中的 Token。
• FacePhys Agent Key 是使用检测服务的凭证，不是 SkillHub 组织密钥。

配置后，在当前任务中继续即可；Skill 会通过官方 CLI 执行鉴权测试。

2. 准备官方 FacePhys CLI

Skill 会先检查 CLI。若尚未安装，运行：

bash ./setup.sh fp_install

该命令只下载并校验 FacePhys 官方 CLI，不下载 MCP、不修改 WorkBuddy 连接器配置。安装完成后运行 bash ./setup.sh fp_auth_test，鉴权成功才进入视频检测。

3. 上传视频开始检测

上传一段 10～30 秒的自拍视频，然后说：“用 FacePhys 分析这段视频。”

录制时请保持：

• 正脸面对镜头，面部无遮挡；
• 光线均匀，避免背光或过暗；
• 身体和手机尽量稳定；
• 推荐使用 MP4 或 MOV，文件尽量小于 50 MB。

WorkBuddy 会在获得你的上传和 Token 消耗确认后进行分析，并生成可阅读的检测报告。

调用顺序

1. 首先运行 bash ./setup.sh fp_status。如果返回 CLI_MISSING，先运行 bash ./setup.sh fp_install；然后运行 bash ./setup.sh fp_auth_test。
2. 如果当前 WorkBuddy 已经提供并启用了 FacePhys MCP，可以使用其健康检查、鉴权测试、字段目录和视频处理工具；否则始终使用本包的官方 CLI，不要要求用户寻找或安装自定义 MCP。
3. 缺少凭证时，展示控制台链接，并引导用户在 WorkBuddy 安全凭证中配置。绝不要求用户发送、展示或口述 Secret；只允许接收非敏感的 Key ID。
4. 处理视频前说明视频将上传至 FacePhys，并等待用户明确同意上传和 Token 消耗。
5. 对同一视频的临时上传失败自动重试，避免重复扣费。
6. 优先生成 HTML 报告和中文摘要，不直接把原始 JSON 丢给用户。
7. 先展示信号质量 SQI。SQI <0.4 时建议重新录制；缺失指标不得解释为 0。
8. 血压或血氧置信度 <0.3 时，只能标记为低置信度趋势参考，不能放入主要结论。
9. LF=0 或 LF/HF=0 时，说明频域自主神经平衡无法可靠估计。
10. 远程 MCP 目前只提供查询能力，不能处理本地视频；没有可用的 FacePhys MCP 时，视频检测统一使用官方 CLI。

执行检测时，先运行 bash ./setup.sh fp_status 和 bash ./setup.sh fp_auth_test；用户确认后运行：

bash ./setup.sh fp_analyze "/absolute/path/to/video.mp4" --user-confirmed

报告生成后，在 WorkBuddy 中展示 HTML 文件，并同时给出简短中文摘要。需要处理报错时读取 [使用与常见问题](references/usage.md)。

使用边界

只处理用户本人或已经取得明确授权的视频。不得用于偷拍分析、测谎、身份识别、疾病诊断、用药决策或紧急分诊。

检测结果会受到光线、动作、姿态和视频质量影响，仅供一般健康与状态参考，不构成医疗诊断或治疗建议。如有明显不适，请及时联系医疗专业人员。