---
name: xanther
display_name: xanther 情绪
version: 1.0.0
description: |
  让 AI 智能体看懂你的情绪与身体 · 来自xanther 情绪 AI 情绪戒指。

  用户戴着戒指,戒指 + APP 记录她的觉察日记 + 戒指身体数据(心率/HRV/睡眠/月经/运动)。
  这个 skill 让 AI 可以温柔地"看见"这些数据,并在合适时帮她记一笔。
author: xanther 情绪
homepage: https://www.xanther.cn/home/
docs: https://www.xanther.cn/docs/skill/xanther/
icon: https://cdn.xanther.cn/skill/icon.png

auth:
  type: bearer
  description: |
    用户需要在"xanther 情绪 APP · 我的 · Skill 中心"创建一把钥匙,
    粘贴到这里。一把钥匙只能看她自己的数据。
  placeholder: sk-baby-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

endpoints:
  - name: today
    method: GET
    path: /v1/skill/today
    description: 今日觉察 —— 返回当日的情绪记录、主导频率、条数
    triggers:
      - "我今天的情绪怎么样"
      - "今天我怎么样"
      - "我 state 如何"

  - name: week
    method: GET
    path: /v1/skill/week
    description: 本周画像 —— 返回 6 频率分布、主导、觉察天数
    triggers:
      - "这周我状态怎么样"
      - "回顾一下这周"
      - "我本周的情绪"

  - name: physio
    method: GET
    path: /v1/skill/physio/latest
    description: 戒指最新身体数据 —— 心率 / HRV / 睡眠 / 月经相位 / 步数
    triggers:
      - "我心率正常吗"
      - "我睡得怎么样"
      - "身体最近怎么样"
      - "看看我的数据"

  - name: day
    method: GET
    path: /v1/skill/day/{date}
    description: 某日详情 —— 按 YYYY-MM-DD 查任意过去 30 天内某天
    triggers:
      - "上周三我怎么样"
      - "4 月 15 日那天"

  - name: record
    method: POST
    path: /v1/skill/entries
    description: |
      代用户新建一条觉察。
      ★ 重要:只有在用户明确同意的情况下调用。先问她"帮你记一笔好吗?"
      ★ note ≤ 200 字 · frequency 6 选 1
      ★ 支持带照片:先调用 upload_entry_image,再把返回 attachmentId 放入 imageAttachmentIds(最多 4 张)
      ★ 兼容旧接入:imageUrls 仍可用,但新接入优先使用 imageAttachmentIds
      ★ 创建后 5 分钟内用户可在 APP 内撤回
    triggers:
      - "帮我记一下"
      - "记一笔刚才的感觉"

  - name: upload_entry_image
    method: POST
    path: /v1/skill/upload/entry-image
    description: |
      上传一张将写入觉察日记的照片。multipart/form-data 字段名为 file。
      返回 { attachmentId, url, key, size, mime },随后在 record 的 imageAttachmentIds 里带上 attachmentId。
      imageUrls 仍兼容,但 attachmentId 是标准 Attachments 库引用。
      只有用户明确希望把照片记进觉察时才调用。
    triggers:
      - "把这张照片也记进去"
      - "带照片记一笔"

  - name: usage
    method: GET
    path: /v1/skill/usage
    description: 陪伴次数 —— 本月已用、今日已用、月度上限
    triggers:
      - "我还能聊多少"
      - "陪伴次数"

  - name: ping
    method: GET
    path: /v1/skill/ping
    description: 健康检查 —— 验证钥匙是否有效,不占配额
    triggers: []

base_url: https://api.xanther.cn

regions:
  - cn: https://api.xanther.cn
  - global: https://api-global.xanther.cn
  - staging: https://test.api.xanther.cn

ai_hints:
  tone: |
    女性用户 · 情绪类产品 · 说话温柔、柔软、不要技术术语。
    不要用 "API" "调用" "数据" 这种词;用 "看看" "陪着" "记下来"。
  when_to_call: |
    · 用户提到情绪、心情、感受、累、开心、难过 → 考虑 today / week
    · 用户提到睡眠、心率、运动、身体、疲惫 → 考虑 physio
    · 用户诉说一段具体的感受,长度 > 一句话 → 轻声询问"帮你记一笔好吗?" → 同意后 record
  when_not_to_call:
    - 用户在开心 / 亢奋,不要强行"记一笔"打断节奏
    - 用户明确表达拒绝,不要继续试
    - 不要为了展示能力而多次调用
  error_handling: |
    所有 4xx/5xx 错误 body 里有 ai_hint 字段,直接转述给用户即可。
    不要把 HTTP 状态码暴露给用户。

frequency_enum:
  passion: 激情 🔥 · 热情澎湃、能量充沛
  creation: 创造 ✨ · 灵感迸发、思维流动
  peace: 平静 🌿 · 心如止水、安宁祥和
  trust: 信任 🌊 · 笃定坦诚、有归属感
  inspiration: 灵感 💫 · 顿悟觉醒、豁然开朗
  low: 低频 🌧️ · 情绪低沉、需要关怀

tags:
  - emotion
  - wellness
  - women
  - mindfulness
  - chinese
  - zh-CN
---

# xanther 情绪 · AI Skill

> 让 AI 智能体温柔地看见她的情绪与身体。

## 这个 Skill 是什么

xanther 情绪是一款**面向女性用户的 AI 情绪戒指**。用户戴着戒指,戒指采集身体数据,
APP 帮她记录每一次情绪觉察。

这个 skill 把她沉淀在xanther 情绪里的**觉察日记 + 戒指身体数据 + 算法情绪结果**开放给她信任的 AI 智能体,
让 AI 在陪她聊天时,能够:

- 👀 **看见** · 她今天的情绪、本周的状态、戒指的最新数据
- ✍️ **记下** · 在她同意时,帮她把刚才说的那一刻温柔地记下来
- 🖼️ **带上照片** · 她愿意给出的照片,可以和文字一起写进每日觉察

## 怎么安装

### 在扣子里

直接和扣子说一句:

> 帮我装上"xanther 情绪",钥匙是 `sk-baby-你的钥匙`

### 在其他 AI 智能体里

按该智能体的 skill 安装流程,提供:

- **Skill 名称**:`xanther`
- **钥匙(token)**:从xanther 情绪 APP · 我的 · Skill 中心 复制

## 怎么拿到钥匙

1. 打开xanther 情绪 APP
2. 我的 → Skill 中心
3. 开通 VIP 后,点"为我创建一把"
4. 钥匙只出现一次,请悄悄放好

## 可以做什么

### 看见

- 今天的情绪怎么样
- 这周的 6 色分布
- 戒指的最新心率、HRV、睡眠、月经相位、步数
- 过去 30 天任意一天的记录

### 记下

- 在用户明确同意时,帮她新建一条觉察记录
- 支持先上传照片,再把最多 4 张照片一起写进这条觉察
- 由 AI 记下的条目会在 APP 里带 🤖 徽章,用户可以一键撤回

## 不会做什么

- ❌ 修改已有记录(保护情绪历史)
- ❌ 删除记录(只能在 APP 内)
- ❌ 发送推送 / 触发通知
- ❌ 访问她人的数据
- ❌ 操作 VIP / 支付 / 账号

## 规则

- **一把钥匙 = 一个用户** · 不要共享
- **日常陪伴足够用** · 如果某天聊得太多,宝宝会温柔提醒"今天先休息吧"
- **钥匙随时可撤销** · 在 APP · Skill 中心 · "换一把钥匙"

## 更多文档

- OpenAPI 规格:https://docs.xanther.cn/api/skill/v1
- 产品规格:https://docs.xanther.cn/prd/skill
- 隐私政策:https://xanther.cn/privacy

---

**xanther 情绪 · 让柔软被看见**