Cat Therapy

跨平台治愈系撸猫技能。当用户说"休息一下"、"累了"、"tired"、"need a break"等触发词时，自动发送可爱猫咪图片 + 猫叫声（TTS 音频 + 文字双保险）+ 治愈语录。支持用户上传自定义猫咪图片和叫声，支持 QQ/微信/钉钉/飞书/Discord/Telegram/WhatsApp 等多平台，...

Security Scan

The skill's code, instructions, and resource requests are consistent with a cross‑platform 'cat therapy' feature; it reads/writes a local user preferences file and fetches images from public cat APIs but does not request unrelated credentials or unusual system access.

Purpose & Capability

Name/description (send cat images + TTS + quotes, support custom uploads, multi-platform) align with the code and files: scripts implement intent detection, image/audio selection/generation, and per-user preference storage. No unrelated credentials, binaries, or config paths are requested.

Instruction Scope

Runtime instructions and scripts operate within the skill: detect triggers, consult user_cats.json, pick image/audio (user-provided or from public APIs), and return/send media + text. Attention: the skill reads/writes user_cats.json in the skill directory and may reference local file paths (sample user_cats.json contains absolute paths). This is expected for user-uploaded media, but review how uploads are handled in your environment to avoid unintentionally exposing local files.

Install Mechanism

No install spec (instruction-only install) and included scripts only. Nothing downloads or executes third‑party installers; risk from install mechanism is low.

Credentials

Skill requires no environment variables or external credentials. Network usage is limited to public cat image APIs (thecatapi, cataas, placekitten) and normal HTTPS requests. No unrelated secrets or cloud credentials are requested.

Persistence & Privilege

always:false and standard autonomous invocation. The skill persists only its own user_cats.json in the skill directory (read/write), which is proportional to its stated custom-user feature and does not modify other skills or global agent config.

Assessment

This skill appears coherent and does what it says: sends images, TTS text/audio, and stores simple per-user preferences in user_cats.json inside the skill directory. Before installing, review the following: 1) Examine user_cats.json (and remove any sensitive absolute paths) — the sample shows local file paths which could point to files in the agent workspace; ensure uploaded media are stored only where you intend. 2) Confirm how your host environment handles user uploads (are files saved under a global workspace directory?) to avoid accidental disclosure of other local files. 3) Be aware the skill fetches images from public endpoints (thecatapi, cataas, placekitten); if network egress is a concern, block or restrict those URLs. 4) If you need stronger privacy, replace network sources with vetted local assets and audit file‑write behavior. No additional environment variables or cloud credentials are required, which reduces risk.

🐱 Cat Therapy - 跨平台治愈系撸猫技能

触发场景

主要触发词

中文： "休息一下"、"累了"、"想撸猫"、"看看猫"、"压力大"、"放松一下"、"治愈我"、"喵" 英文： "tired"、"need a break"、"show me cats"、"cat pics"、"stress"、"relax"、"meow"

设置触发词（需要明确意图）

保存自定义猫咪（需满足以下条件）：

1. 包含关键词 + 图片：

   • "这是我的猫" + [图片]
   • "保存这只猫" + [图片]
   • "以后用这只猫治愈我" + [图片]
   • "设置这只猫为治愈猫" + [图片]
   • "这是我家主子" + [图片]

2. 或在技能上下文中：

   • 刚触发"休息一下"等治愈词
   • 随后发送图片并说"用这只"

保存自定义声音：

• "这是我家猫的声音：喵～咪～"
• "保存这个猫叫：[音频]"

重置：

• "重置猫咪" → 清除自定义，恢复随机
• "恢复默认猫咪" → 同上

核心功能

1. 跨平台图片发送

图片源优先级：

1. 用户上传的自定义猫咪图片（最高优先级）
2. TheCatAPI 随机猫咪
3. 备用图床（cataas.com 等）

平台适配：

平台	发送方式
QQ	<qqimg>URL</qqimg>
微信/钉钉/飞书	MEDIA:URL
Discord/Telegram	message 工具 media 参数

2. 音频 + 文字双保险

同时发送：

1. TTS 音频 - 调用 tts 工具生成真实声音
2. 文字模拟 - "喵～咕噜咕噜～" 🐱（立即可见）

优点：

• ✅ 文字立即可见，无需等待
• ✅ 音频可选播放，增强体验
• ✅ 双重保障，确保送达

3. 用户自定义猫咪

保存用户猫咪：

{
  "image": "https://user-cat-photo.jpg",
  "sound": "喵～咪～",
  "updatedAt": "2026-03-04"
}

设置方式：

• 用户发送猫咪图片 → 自动保存图片 URL
• 用户发送"这是我家猫" → 标记为偏好
• 用户发送猫叫文字 → 保存自定义声音

清除自定义：

• 用户说"重置猫咪" → 删除偏好，恢复随机

4. 多语言支持

自动检测：

• 中文消息 → 中文回复
• 英文消息 → 英文回复

i18n 文件：

• i18n/zh.json - 中文语录
• i18n/en.json - 英文语录

完整工作流程

1. 检测触发词 → 识别用户意图
2. 检查用户偏好 → 是否有自定义猫咪/声音
3. 检测平台 → 选择发送方式
4. 检测语言 → 选择回复语言
5. 获取猫咪图片 → 用户自定义 或 随机 API
6. 获取猫叫声 → 用户自定义 或 默认 TTS
7. 选择治愈语录 → 根据语言随机
8. 组合回复 → TTS 音频 + 文字声音 + 图片 + 语录
9. 发送 → 使用平台对应方式
10. 降级处理 → 失败时用文字 + emoji

示例回复

标准场景（随机猫咪）

喵～咕噜咕噜～ 🐱💕

[TTS 音频：喵～]

[猫咪图片]

工作再忙也要记得休息哦～✨

用户自定义猫咪

喵～咪～ 🐱💕 (这是你家的小可爱！)

[TTS 音频：喵～咪～]

[用户猫咪图片]

你家主子来治愈你啦～✨

英文场景

Meow~ Purr purr~ 🐱

[TTS audio: Meow~]

[Cat image]

Take a break and relax! ✨

降级方案（图片失败）

喵～咕噜咕噜～ 🐱💕

虽然图片加载失败了，但想象有只小猫咪在你腿上～

深呼吸，所有的疲惫都会消失的！✨

脚本说明

cat_therapy.py（主逻辑）

# 完整技能逻辑
# - 检查用户偏好
# - 获取猫咪图片（自定义或随机）
# - 获取猫叫声（自定义或默认）
# - 选择治愈语录
# - 返回完整响应数据

get_cat_image.py

# 获取猫咪图片（多源 fallback）
# 返回：{"url": "...", "source": "thecatapi|user|fallback"}

cat_sound.py

# 获取猫叫声（TTS 文本或本地音频）
# 返回：{"text": "喵～", "source": "default|user"}

generate_cat_sound.py

# 生成猫叫声效（.wav 文件）
# 生成：meow.wav, purr.wav

用户偏好存储

user_cats.json

{
  "userId": "8E8893DDD10A138203887E503C535A33",
  "image": "https://user-cat-photo.jpg",
  "sound": "喵～咪～",
  "updatedAt": "2026-03-04T12:00:00Z",
  "language": "zh"
}

存储位置： 技能目录下的 user_cats.json

管理命令：

• 查看：cat user_cats.json
• 删除：rm user_cats.json
• 编辑：手动修改 JSON

配置示例

config.json

{
  "defaultLanguage": "zh",
  "supportedLanguages": ["zh", "en"],
  "imageSources": [
    "https://api.thecatapi.com/v1/images/search",
    "https://cataas.com/cat"
  ],
  "fallbackToText": true,
  "enableUserCustomization": true,
  "sendBothAudioAndText": true
}

注意事项

1. 音频 + 文字双发 - 确保用户无论哪种方式都能收到
2. 用户隐私 - 自定义猫咪仅存储在本地
3. 图片源稳定性 - 多源 fallback 确保可用性
4. 平台兼容 - 不同平台媒体发送方式不同
5. 语言检测 - 根据用户消息自动切换
6. 回复简洁 - 控制在 2-4 句话，避免冗长

扩展建议

1. 更多动物

• 🐶 Dog Therapy - 治愈狗狗
• 🐰 Bunny Therapy - 小兔子
• 🦊 Fox Therapy - 小狐狸

2. 猫咪品种

• 橘猫模式
• 布偶猫模式
• 黑猫模式

3. 定时提醒

• 工作 1 小时后提醒撸猫
• 下午 3 点固定治愈时间

4. 互动功能

• 猫咪心情选择
• 用户上传多张猫图轮播
• 猫咪百科知识

测试清单

• 随机猫咪图片发送
• 用户自定义猫咪保存
• 用户自定义猫咪使用
• TTS 音频发送
• 文字声音显示
• 中英文切换
• 图片失败降级
• 重置功能
• 多平台兼容