酷潮AI情绪戒指

要解决的问题

佩戴一枚能采集生理信号的 AI 情绪戒指后，设备端产生的情绪与压力数据需要一条可靠通路才能被应用消费。开发者面临的挑战是：数据托管在远程服务器，每次查询都要经过认证、建立会话、发起请求、解析流式响应——这些步骤各自实现时，很容易在令牌管理、会话复用和跨平台兼容性上踩坑。

这个技能把上述流程封装为一次调用。它通过 MCP（Model Context Protocol）的 Streamable HTTP 传输协议与远程服务器通信，底层仅依赖 curl 和 WorkBuddy 内置的 Read/Write/Bash 工具，不需要 Python、Node.js 或任何外部脚本。

核心能力与工作流程

技能暴露的唯一 MCP 工具是 get_current_emotion_stress。调用时可传入可选的 timezone 参数（IANA 时区格式，如 Asia/Shanghai），返回当前情绪状态、压力状态、个性化摘要和状态说明。

工作流程分为几个关键步骤：

1. 令牌检查与持久化：首次使用时向用户索取 JWT 令牌，写入 ~/.workbuddy/skills/kcring-emotion/.token（macOS/Linux）或 %USERPROFILE%\.workbuddy\skills\kcring-emotion\.token（Windows）。后续调用直接读取本地文件，无需重复输入。

1. MCP 会话初始化：通过 curl 向 https://clientapi.lunabeing.cn/mcp/ 发送 initialize 请求，服务器在响应头中返回 Mcp-Session-Id，后续请求必须携带该标识。

1. 工具调用与响应解析：发送 tools/call 方法请求，服务器以 SSE（text/event-stream）格式返回数据。解析时优先读取 result.structuredContent，若不可用则回退到 result.content[0].text 并手动解析 JSON。

适用边界与注意点

端点陷阱：URL 末尾的斜杠不是可选的。缺少 / 会导致服务器返回 301 重定向，POST 请求体丢失，最终得到 400 错误。

令牌安全：令牌以明文存储在本地文件中，macOS/Linux 上设置为 chmod 600 权限，Windows 上由 NTFS ACL 管理。调用过程中不应将令牌值输出到对话或文件中。

令牌过期：当服务器返回 HTTP 401 时，需要提示用户提供新令牌，更新本地存储后重新发起请求。

Windows 兼容性：PowerShell 中 curl 是 Invoke-WebRequest 的别名，必须显式使用 curl.exe。

协议版本：使用 MCP 协议版本 2024-11-05，服务器名称为 mindrest v1.0.0。