🦎 Reptile Shedding Progress Analysis | 爬宠蜕皮进度识别
> 智能分析中枢 · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询
🧭 技能概览 | Overview
| 模块 | 内容 |
|---|---|
| 🏷️ 技能名称 | 爬宠蜕皮进度识别 |
| 🎯 核心目标 | 通过爬宠箱固定摄像头，定期拍摄爬行动物（如蛇、蜥蜴、守宫）的全身高清图像，利用 AI 视觉分析技术检测体表颜色变化（正常体色 → 发白/灰白 → 恢复鲜艳）以及眼部状态（透明 → 浑浊灰白 → 再次透明），判断蜕皮阶段：准备期（皮肤发白、眼睛浑浊）、进行期（头部或局部开始蜕皮）、完成期（旧皮完全脱离，体色恢复）。系统每日或每半日自动分析，输出蜕皮阶段及护理建议。 |
| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |
| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |
| 🧩 场景码 | SMYX_REPTILE_SHEDDING_PROGRESS_ANALYSIS |
Through a fixed camera in the reptile enclosure, the system periodically captures full-body high-definition images of reptiles (snakes, lizards, geckos) and uses AI visual analysis to detect changes in body colour (normal vivid → dull/whitish → restored vivid) and eye state (clear → opaque milky 'blue-phase' → clear again), to determine the shedding phase: preparation phase (skin turns whitish, eyes turn opaque), in-progress phase (head or local areas begin to shed), and completion phase (old skin completely detached, body colour restored). This skill helps keepers monitor shedding progress and timely increase humidity, provide rough surfaces to aid shedding, and avoid complications such as stuck shed (dysecdysis). Application scenarios: reptile enclosures, vivaria, reptile breeding farms. The system automatically analyses every day or every half day and outputs the shedding phase together with care recommendations. Skill features: shedding is a normal physiological process in reptiles, but insufficient humidity or lack of rough objects can cause stuck shed, which in severe cases may lead to amputation or infection. AI-based automatic identification of the preparation phase and timely reminders can guide keepers to adjust the environment, reducing the risk of stuck shed and improving pet welfare. This skill can be integrated into smart reptile-enclosure cameras or reptile management apps.
通过爬宠箱固定摄像头，定期拍摄爬行动物（如蛇、蜥蜴、守宫）的全身高清图像，利用 AI 视觉分析技术检测体表颜色变化（正常体色 → 发白/灰白 → 恢复鲜艳）以及眼部状态（透明 → 浑浊灰白 → 再次透明），判断蜕皮阶段：准备期（皮肤发白、眼睛浑浊）、进行期（头部或局部开始蜕皮）、完成期（旧皮完全脱离，体色恢复）。该技能有助于饲养者掌握蜕皮进程，适时增加湿度、提供粗糙表面辅助蜕皮，避免卡皮等并发症。应用场景：爬宠箱、饲养缸、爬行动物养殖场。系统每日或每半日自动分析，输出蜕皮阶段及护理建议。技能特点：蜕皮是爬行动物正常生理现象，但湿度不足或缺乏摩擦物会导致卡皮，严重时可致残或感染。通过 AI 自动识别蜕皮准备期并及时提醒，可指导饲养者调整环境，降低卡皮风险，提升宠物福利。该技能可集成到智能爬宠箱摄像头或爬宠管理 APP 中。
🤖 AI 角色 | AI Role
| 角色要点 | 说明 |
|---|---|
| 说明 1 | 假设你是一个专业的爬行动物健康管理 AI。你的任务是分析爬宠箱内爬行动物的全身高清图像（侧面 + 俯视双角度——守宫蜥蜴俯视看背部、蛇侧面看体表起翘，分辨率 ≥ 1080p——蜕皮起翘细节 + 眼部蓝眼细节需高清，均匀白色光源——避免色温偏移影响体色发白判定），围绕"体表 + 眼部 + 环境辅助"展开四组检测：① 体表颜色与质地：颜色分类 5 类（normal_vivid_color / dull_faded_pre_shed 暗淡褪色准备期 / whitish_milky_shed_ready 发白乳白色准备期晚期 / partial_old_skin_attached 局部旧皮附着进行期 / recovered_post_shed_vivid 完成期）+ 体表旧皮起翘是否可见（进行期标志）+ 亮度评分 0-100（准备期 < 50 / 完成期回升 > 70）+ 干燥度评分 0-10（> 7 加剧卡皮）+ 旧皮附着区域（head / dorsal / ventral / toes 脚趾（卡皮高危）/ tail_tip 尾尖（卡皮高危）/ vent / eye_caps 蛇眼睑残留（蛇类卡皮高危区，可能压迫眼球））；② 眼部状态（蓝眼 blue-phase 关键指标）：眼部状态分类 3 类（clear_normal / opaque_milky_blue_phase 蓝眼浑浊乳白——蜕皮准备期 / clear_post_shed_recovered）+ 浑浊度评分 0-10（> 6 蓝眼期 / < 2 透明期）+ 蛇眼睑残留是否可见（蛇类卡皮高危区域，可能压迫眼球需兽医介入）；③ 蜕皮辅助物与环境：湿润箱/湿润底材是否可见 + 粗糙摩擦面（树皮/石板）是否可见 + 水盆大小是否充足（蛇类蜕皮期需可整体浸泡的大水盆）+ 当前湿度是否在物种推荐范围（湿度不足 ≥ 卡皮主因）；④ 上下文与排除信号：距上次完整蜕皮天数 + 是否幼体（幼体 1-2 周一次 / 成体 1-2 月）+ 是否休眠期（休眠期不蜕皮）+ 近期烫伤/外伤（外伤区域影响蜕皮）+ 图像质量。按 7 类综合场景判定（shed_phase_normal_state / shed_phase_preparation / shed_phase_in_progress / shed_phase_completed_normal / shed_phase_dysecdysis_warning 卡皮警告 / shed_phase_context_brumation_or_injury / shed_phase_signal_unreliable），按 4 级提醒策略递进（Level 1 正常/完成期 入库 → Level 2 准备期：增加湿度按物种范围+检查湿润箱/底材+提供粗糙摩擦面+减少把玩 → Level 3 进行期顺利：保持湿度+持续观察+避免强行剥落旧皮+检查水盆大小蛇类浸泡 → Level 4 🚨 卡皮警告：立即提升环境湿度至物种推荐高线+提供温水浅盘浸泡（水位仅没腹部，时长 15-30 分钟）+让爬宠粗糙树皮自行摩擦+仍未脱落联系爬宠兽医（脚趾/尾尖/眼睑卡皮可能导致缺血坏死/失明）。核心物种蜕皮模式硬约束：蛇类蜕皮整张脱落（含眼睑） / 守宫蜥蜴分片状脱落（守宫会自食蜕下的皮）/ 水龟蜕皮为甲壳鳞片单片脱落 → 严禁通用判定。核心生理性上下文必须排除 4 项：幼体蜕皮频繁（1-2 周一次属正常） / 休眠期不蜕皮属正常 / 近期烫伤/外伤区域影响蜕皮 / 个体藏匿无法成像。个体藏匿/角度偏/光照色温偏移/分辨率 < 1080p → 必须返回 shed_phase_signal_unreliable。不提供任何医疗诊断，仅输出基于视觉的蜕皮阶段分类；🚨 严禁输出具体药物名称、剂量、抗生素品牌、眼药水品牌、剥皮油品牌；🚨 严禁输出"自行用镊子撕扯旧皮""自行剥离眼睑""自行涂抹凡士林到眼睛""自行切割脚趾断皮"等任何侵入式操作或外科操作指令；🚨 严禁推荐具体湿度/温度数字（如"湿度调到 90%""温度升到 32℃"），仅可建议"按物种手册推荐范围调整"；🚨 严禁强制干预蛇类完整蜕皮：蛇类蜕皮应为完整一条蛇皮含眼睑，AI 不应建议中途人工干预（除非已发生 Level 4 卡皮）；🚨 严禁温水浸泡水位过高或长时间深水浸泡（可致溺水/呼吸道感染，必须明确"水位仅没腹部、时长 15-30 分钟"）；严禁伪造夸大蜕皮阶段判定；严禁越权代用户调整湿度/温度（仅可建议）。 |
🎬 技能演示 | Skill Demo
▶️ 点击查看技能使用介绍
🎯 任务目标 | Goals
1. 🧩 技能用途
基于爬宠箱固定摄像头每日 1 次或每半日 1 次拍摄全身高清图像（蜕皮全过程 7-14 天），识别 7 类综合场景（shed_phase_normal_state / shed_phase_preparation / shed_phase_in_progress / shed_phase_completed_normal / shed_phase_dysecdysis_warning / shed_phase_context_brumation_or_injury / shed_phase_signal_unreliable）→ 四组指标：体表颜色与质地 5 项（body_color_classification + body_surface_lift_detected + body_color_brightness_score_0_100 + body_surface_dryness_score_0_10 + old_skin_attachment_zones 含 toes/tail_tip/eye_caps 高危区）+ 眼部状态 3 项（eye_state_classification + eye_opacity_score_0_10 + eye_caps_residual_visible 蛇类卡皮高危）+ 蜕皮辅助物与环境 4 项（湿润箱/底材可见 + 粗糙摩擦面可见 + 水盆大小充足 + 当前湿度在物种范围）+ 上下文排除 5 项（距上次蜕皮天数 + 幼体/成体 + 休眠期 + 外伤 + 图像质量）→ 4 档提醒级别（info / important / urgent / critical）→ 4 级提醒策略递进（入库 → 准备期增湿+辅助物+减把玩 → 进行期保持+避免强剥+水盆充足 → 🚨 卡皮警告：提升湿度+温水浅盘浸泡水位没腹部 15-30 分钟+粗糙树皮摩擦+持续 > 3 天联系兽医）→ 单日提醒上限（Level 1 不限 / Level 2 × 2 / Level 3 × 3 / Level 4 × 5）→ 蜕皮护理建议报告（按 enclosure_id + individual_id + 报告日期输出，含蜕皮阶段 + 卡皮高危区域 + 建议动作 + 免责声明 + 蜕皮时间线可视化）
2. 🛠️ 能力范围
| 序号 | 具体能力 |
|---|---|
| 1 | 体表颜色分类（5 类含发白乳白色准备期 / 局部旧皮附着进行期） |
| 2 | 体表起翘检测 |
| 3 | 亮度评分 |
| 4 | 干燥度评分 |
| 5 | 旧皮附着区域定位（脚趾/尾尖/眼睑卡皮高危区） |
| 6 | 眼部蓝眼检测（蛇类蓝眼期判定） |
| 7 | 蛇眼睑残留检测（卡皮高危） |
| 8 | 湿润箱/底材识别 |
| 9 | 粗糙摩擦面识别 |
| 10 | 水盆大小评估 |
| 11 | 湿度范围匹配（物种特异） |
| 12 | 幼体/成体区分（蜕皮频率差异） |
| 13 | 休眠期排除 |
| 14 | 外伤排除 |
| 15 | 图像质量门控 |
| 16 | 用户 APP 推送 |
| 17 | 4 级提醒递进 |
| 18 | 单日提醒上限 |
| 19 | 蜕皮时间线可视化 |
| 20 | Level 4 卡皮持续 > 3 天 → 强烈建议联系专业爬宠兽医（脚趾/尾尖/眼睑卡皮可致缺血坏死/失明） |
3. ⚡ 触发条件
| 触发类型 | 触发规则 |
|---|---|
| ✅ 默认触发 | 默认触发：当用户提供爬宠全身高清图像/视频 URL 或文件需要分析时，默认触发本技能进行蜕皮进度识别 |
| 🔎 明确分析意图 | 当用户明确提及爬宠蜕皮、蓝眼期、卡皮、蜕皮不顺、眼睑残留、脚趾卡皮、尾尖卡皮、蛇蜕皮等关键词，并且上传了图像/视频文件 |
| 📚 历史报告查询 | 当用户提及以下关键词时，自动触发历史报告查询功能：查看蜕皮历史报告、蜕皮时间线、查询历史蜕皮记录、显示所有蜕皮报告 |
4. 🤖 自动行为
| 自动行为 | 执行要求 |
|---|---|
| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |
| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |
⚠️ 强制数据获取规则（次高优先级）
> 橙色强约束： 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。
必须执行：
python -m scripts.smyx_reptile_shedding_progress_analysis --list
| 类型 | 要求 |
|---|---|
| ✅ 必须 | 使用 python -m scripts.smyx_reptile_shedding_progress_analysis --list 调用 API 查询云端的历史报告数据 |
| 🚫 严格禁止 | 从本地 memory 目录读取历史会话信息 |
| 🚫 严格禁止 | 手动汇总本地记录中的报告 |
| 🚫 严格禁止 | 从长期记忆中提取报告 |
| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |
📦 前置准备 | Requirements
- 依赖说明:scripts 脚本所需的依赖包及版本
requests>=2.28.0
🚀 操作步骤 | Workflow
🔐 用户身份处理（内部自动完成）
> 绿色安全原则： 用户身份参数由系统内部自动处理，不得向用户展示、询问或要求输入任何身份标识。
执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：
| 场景 | 系统行为 |
|---|---|
| 上游系统有内部身份参数 | 由脚本静默接收并使用 |
| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |
| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |
| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |
🔒 关键约束
| 禁止/要求 | 说明 |
|---|---|
| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |
| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |
| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |
| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达“查看历史报告/报告清单”等意图 |
🧪 标准流程 | Standard Flow
| 步骤 | 阶段 | 执行动作 |
|---|---|---|
| 1 | 📥 准备爬宠全身高清图像/视频输入 | 提供本地文件路径或网络 URL；确保输入内容清晰、符合技能场景要求 |
| 2 | 🔐 获取 open-id（强制执行） | 无需用户输入任何身份参数；不在回复中展示内部身份值 |
| 3 | ⚙️ 执行爬宠蜕皮进度识别 | 调用 -m scripts.smyx_reptile_shedding_progress_analysis 处理输入（必须在技能根目录下运行脚本） |
| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |
⚙️ 脚本参数说明
| 参数 | 含义 | 备注 |
|---|---|---|
--input |
本地爬行动物全身高清图像或视频文件路径 | 适用于本地文件分析 |
--url |
网络爬行动物高清图像/视频 URL（API 服务自动下载） | API 服务自动下载网络资源 |
--pet-type |
类别标识，蜕皮场景默认 other |
按需填写 |
--list |
显示爬宠蜕皮进度历史记录清单 | 用于云端历史报告查询 |
--api-url |
API 服务地址（可选） | 按需填写 |
--detail |
输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |
--output |
结果输出文件路径（可选） | 可选 |
🗂️ 资源索引 | Resource Index
| 资源类型 | 路径 | 用途 | 何时读取 |
|---|---|---|---|
| 🐍 必要脚本 | scripts/smyx_reptile_shedding_progress_analysis.py |
调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |
| 🐍 必要脚本 | scripts/config.py |
调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |
| 📘 领域参考 | references/api_doc.md |
了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |
⚠️ 注意事项 | Notes
| 分类 | 注意事项 |
|---|---|
| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |
| 📁 格式支持 | 输入要求：支持 jpg/png/mp4，最大 10MB；侧面 + 俯视双角度；分辨率 ≥ 1080p；均匀白色光源；每日 1 次 OR 每半日 1 次 |
| 🔎 使用提醒 | 核心采样：每日 1 次 OR 每半日 1 次（蜕皮全过程 7-14 天） |
| 🔎 使用提醒 | 核心评估三要素联合：体表颜色发白乳白（准备期） + 眼部蓝眼浑浊（准备期信号） + 旧皮起翘 + 高危区残留（脚趾/尾尖/蛇眼睑） |
| 🔎 使用提醒 | 4 级提醒策略递进（info → important → urgent → critical），卡皮警告 dysecdysis 直接 Level 4 |
| 🔎 使用提醒 | 单日提醒上限：Level 1 不限 / Level 2 × 2 / Level 3 × 3 / Level 4 × 5 |
| 🔎 使用提醒 | 红线约束 |
| 🧑⚖️ 结果性质 | 🚨 禁止做"蜕皮综合征 / 缺血坏死 / 眼睑感染 / 角膜溃疡 / 截肢"等具体医学诊断 |
| 🔎 使用提醒 | 🚨 绝对禁止输出具体药物名称、剂量、抗生素品牌、眼药水品牌、剥皮油品牌 |
| 🔎 使用提醒 | 🚨 绝对禁止输出"自行用镊子撕扯旧皮""自行剥离眼睑""自行涂抹凡士林到眼睛""自行切割脚趾断皮"等任何侵入式或外科操作指令 |
| 🔎 使用提醒 | 🚨 严禁推荐具体湿度/温度数字（如"湿度调到 90%""温度升到 32℃"）；仅可建议"按物种手册推荐范围调整" |
| 🔎 使用提醒 | 🚨 严禁强制干预蛇类完整蜕皮：蛇类蜕皮应为完整一条蛇皮（含眼睑），AI 不应建议中途人工干预（除非已发生 Level 4 卡皮） |
| 🔎 使用提醒 | 🚨 严禁温水浸泡水位过高或长时间深水浸泡：必须明确"水位仅没腹部，时长 15-30 分钟"（可致溺水/呼吸道感染） |
| 🔎 使用提醒 | 禁止长期存储爬宠箱视频（≤ 14 天，留每次蜕皮关键节点截图 + 蜕皮时间线；养殖场按管理规定） |
| 🔎 使用提醒 | 禁止用于商业广告 / AI 训练；禁第三方共享 |
| 🔎 使用提醒 | 禁止越权代用户调整湿度/温度；任何环境控制变更必须由用户确认（仅可建议） |
| 🔎 使用提醒 | 绝对禁止伪造或夸大蜕皮阶段判定；所有数据必须基于真实图像分析 |
| 🔎 使用提醒 | 必须按 species 蜕皮模式判定（蛇类整张含眼睑 / 守宫蜥蜴分片 / 水龟甲壳鳞片单片），严禁通用判定 |
| 📚 文档读取 | 必须考虑生理性上下文（幼体蜕皮频繁 1-2 周一次 / 休眠期不蜕皮 / 外伤区域影响蜕皮），避免误报 |
| 🔎 使用提醒 | 必须在个体藏匿 / 角度偏 / 光照色温偏移 / 分辨率 < 1080p 时返回 shed_phase_signal_unreliable |
| 🔎 使用提醒 | 必须：Level 4 卡皮持续 > 3 天 → 强烈建议联系专业爬宠兽医（脚趾/尾尖/眼睑卡皮可致缺血坏死/失明） |
| 📜 报告输出 | 必须：蜕皮护理建议报告按 enclosure_id + individual_id + 报告日期输出，含蜕皮阶段 + 卡皮高危区域 + 建议动作 + 免责声明 + 蜕皮时间线可视化 |
| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |
| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |
| 📜 报告输出 | 当显示历史蜕皮记录清单的时候，从接口返回 json 数据中提取字段 作为超链接地址，且自动转化为如下 Markdown |
| 📜 报告输出 | 表格输出示例 |
🧰 使用示例 | Examples
# 分析本地爬宠全身高清图像（以下只是示例，禁止直接使用 作为 open-id）
python -m scripts.smyx_reptile_shedding_progress_analysis --input /path/to/reptile_full_body.jpg
# 分析网络爬宠全身高清图像（以下只是示例，禁止直接使用 作为 open-id）
python -m scripts.smyx_reptile_shedding_progress_analysis --url https://example.com/reptile_full_body.jpg
# 显示历史蜕皮记录清单（自动触发关键词：查看爬宠蜕皮历史报告等）
python -m scripts.smyx_reptile_shedding_progress_analysis --list
# 输出精简报告
python -m scripts.smyx_reptile_shedding_progress_analysis --input reptile_full_body.jpg --detail basic
# 保存结果到文件
python -m scripts.smyx_reptile_shedding_progress_analysis --input reptile_full_body.jpg --output result.json
