{"id":"521ebea1-ec08-422b-90c2-a48dd4317ea5","entityType":"agent","slug":"clawhub-smyx-sunjinhui-smyx-livestock-individual-analysis","name":"Livestock Individual Identification | 畜禽个体识别与追踪","canonicalUrl":"https://www.xpersona.co/agent/clawhub-smyx-sunjinhui-smyx-livestock-individual-analysis","canonicalPath":"/agent/clawhub-smyx-sunjinhui-smyx-livestock-individual-analysis","generatedAt":"2026-10-11T05:36:32.117Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T03:12:53.335Z","emptyReason":null},"description":"Identifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking. | 通过面部/体纹识别畜禽个体，实现精准管理追踪。 Skill: Livestock Individual Identification | 畜禽个体识别与追踪 Owner: smyx-sunjinhui Summary: Identifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking. | 通过面部/体纹识别畜禽个体，实现精准管理追踪。 Tags: latest:1.0.12 Version history: v1.0.12 | 2026-09-29T00:17:28.267Z | auto smyx-livestock-individual-analysis v1.0.12 -","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s17cfv2h26b7hq5w47tgfy23xx83z9x6:smyx-livestock-individual-analysis","sourceUrl":"https://clawhub.ai/smyx-sunjinhui/smyx-livestock-individual-analysis","homepage":"https://clawhub.ai/smyx-sunjinhui/skills/smyx-livestock-individual-analysis","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/smyx-sunjinhui/smyx-livestock-individual-analysis","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/smyx-sunjinhui/skills/smyx-livestock-individual-analysis","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Identifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm m"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T03:12:53.335Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T03:12:53.335Z","emptyReason":null},"stars":null,"forks":null,"downloads":1176,"packageName":null,"latestVersion":"1.0.12","tractionLabel":"1.2K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T03:12:53.322Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T03:12:53.335Z","lastCrawledAt":"2026-10-11T03:12:53.322Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T03:12:53.322Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.12","createdAt":"2026-09-29T00:17:28.267Z","changelog":"smyx-livestock-individual-analysis v1.0.12 - Updated version number to 1.0.12. - Documentation refinements and cleanup in SKILL.md. - Removed redundant file: skill-card.md.","fileCount":31,"zipByteSize":39347},{"version":"1.0.11","createdAt":"2026-09-14T06:08:31.376Z","changelog":"- Updated version to 1.0.10 in SKILL.md for consistency. - Removed redundant file: skill-card.md. - No changes to core logic, features, or user-facing documentation content.","fileCount":31,"zipByteSize":39654},{"version":"1.0.10","createdAt":"2026-08-26T03:54:29.292Z","changelog":"- Removed the file: skill-card.md - No other functional or documentation changes in this version.","fileCount":31,"zipByteSize":39479},{"version":"1.0.9","createdAt":"2026-08-20T04:17:29.005Z","changelog":"- Version updated from 1.0.7 to 1.0.8. - Documentation changes in SKILL.md, including minor updates. - skill-card.md file removed. - No changes to core functionality or interfaces.","fileCount":31,"zipByteSize":39592},{"version":"1.0.8","createdAt":"2026-08-13T23:49:35.396Z","changelog":"- Updated documentation in SKILL.md; version bumped from 1.0.5 to 1.0.7. - Removed outdated skill-card.md file. - No functional changes; this release is documentation cleanup only.","fileCount":31,"zipByteSize":39529},{"version":"1.0.7","createdAt":"2026-08-05T08:52:33.484Z","changelog":"- Removed the file skill-card.md. - No changes to functionality or documentation were made in this version.","fileCount":31,"zipByteSize":39708},{"version":"1.0.6","createdAt":"2026-07-31T22:34:30.734Z","changelog":"- Updated version to 1.0.5 in documentation (was 1.0.3). - Removed the file: skill-card.md. - No core feature, command, or capability changes described; documentation content remains the same. - Housekeeping update focused on file and version metadata.","fileCount":31,"zipByteSize":39466},{"version":"1.0.5","createdAt":"2026-07-18T21:48:26.663Z","changelog":"- Updated version numbers in SKILL.md (from 1.0.1 to 1.0.3). - Minor revision to documentation in SKILL.md; content and workflow unchanged. - Removed the now-unused file skill-card.md. - Other minor internal/script changes in util.py; no user-facing changes documented.","fileCount":31,"zipByteSize":39536}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17cfv2h26b7hq5w47tgfy23xx83z9x6:smyx-livestock-individual-analysis","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-livestock-individual-analysis/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-livestock-individual-analysis/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-livestock-individual-analysis/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-livestock-individual-analysis/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-livestock-individual-analysis/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-livestock-individual-analysis/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T05:36:32.112Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-livestock-individual-analysis/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-livestock-individual-analysis/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-livestock-individual-analysis/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-livestock-individual-analysis/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T03:12:53.335Z","emptyReason":null},"readme":"Skill: Livestock Individual Identification | 畜禽个体识别与追踪\n\nOwner: smyx-sunjinhui\n\nSummary: Identifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking. | 通过面部/体纹识别畜禽个体，实现精准管理追踪。\n\nTags: latest:1.0.12\n\nVersion history:\n\nv1.0.12 | 2026-09-29T00:17:28.267Z | auto\n\nsmyx-livestock-individual-analysis v1.0.12\n\n- Updated version number to 1.0.12.\n- Documentation refinements and cleanup in SKILL.md.\n- Removed redundant file: skill-card.md.\n\nv1.0.11 | 2026-09-14T06:08:31.376Z | auto\n\n- Updated version to 1.0.10 in SKILL.md for consistency.\n- Removed redundant file: skill-card.md.\n- No changes to core logic, features, or user-facing documentation content.\n\nv1.0.10 | 2026-08-26T03:54:29.292Z | auto\n\n- Removed the file: skill-card.md\n- No other functional or documentation changes in this version.\n\nv1.0.9 | 2026-08-20T04:17:29.005Z | auto\n\n- Version updated from 1.0.7 to 1.0.8.\n- Documentation changes in SKILL.md, including minor updates.\n- skill-card.md file removed.\n- No changes to core functionality or interfaces.\n\nv1.0.8 | 2026-08-13T23:49:35.396Z | auto\n\n- Updated documentation in SKILL.md; version bumped from 1.0.5 to 1.0.7.\n- Removed outdated skill-card.md file.\n- No functional changes; this release is documentation cleanup only.\n\nv1.0.7 | 2026-08-05T08:52:33.484Z | auto\n\n- Removed the file skill-card.md.\n- No changes to functionality or documentation were made in this version.\n\nv1.0.6 | 2026-07-31T22:34:30.734Z | auto\n\n- Updated version to 1.0.5 in documentation (was 1.0.3).\n- Removed the file: skill-card.md.\n- No core feature, command, or capability changes described; documentation content remains the same.\n- Housekeeping update focused on file and version metadata.\n\nv1.0.5 | 2026-07-18T21:48:26.663Z | auto\n\n- Updated version numbers in SKILL.md (from 1.0.1 to 1.0.3).\n- Minor revision to documentation in SKILL.md; content and workflow unchanged.\n- Removed the now-unused file skill-card.md.\n- Other minor internal/script changes in util.py; no user-facing changes documented.\n\nv1.0.4 | 2026-07-06T17:12:25.945Z | auto\n\n- Version updated from 1.0.0 to 1.0.1 in the documentation.\n- No functionality or logic changes; only the version field in SKILL.md was edited.\n\nv1.0.3 | 2026-07-05T06:35:29.518Z | auto\n\n- Improved and expanded documentation in SKILL.md, including detailed usage instructions, workflow, standard flow, capture requirements, privacy statements, and output formatting examples.\n- Clarified skills, capabilities, constraints, and the precise behavior required for livestock individual identification and reporting functions.\n- Added explicit instructions for querying historical analysis reports, enforcing cloud API use, and outputting results as Markdown tables.\n- Included more examples and detailed parameter descriptions for command-line operations.\n- Clearly documented privacy and data security practices and outlined forbidden behaviors regarding user identity handling.\n\nArchive index:\n\nArchive v1.0.12: 31 files, 39347 bytes\n\nFiles: references/api_doc.md (661b), scripts/__init__.py (65b), scripts/config.py (676b), scripts/config.yaml (3b), scripts/skill.py (576b), scripts/smyx_livestock_individual_analysis.py (3578b), skill-card.md (2167b), SKILL.md (11831b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (473b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28776b), _meta.json (154b)\n\nFile v1.0.12:SKILL.md\n\n---\nname: \"smyx-livestock-individual-analysis\"\ndescription: \"Identifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking. | 通过面部/体纹识别畜禽个体，实现精准管理追踪。\"\nversion: \"1.0.12\"\nlicense: \"MIT-0\"\n---\n\n# 🐄 Livestock Individual Identification & Tracking | 畜禽个体识别与追踪\n\n> 通过面部/体纹识别畜禽个体，实现精准管理追踪。\n>\n> **精准养殖识别中枢** · 面部/体纹智能比对 · 个体身份识别 · 追踪管理 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **畜禽个体识别与追踪** |\n| 🎯 核心目标 | 基于畜禽面部/体表图像或视频，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度，辅助猪、牛、羊等畜种的精准养殖与全流程追踪 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、个体 ID、置信度、匹配特征区域、报告链接 |\n| 🏢 适用场景 | 猪/牛/羊等畜禽的个体健康追踪、生产记录、精准饲喂、种畜管理等场景中的身份识别环节 |\n| 🧩 场景码 | `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n## 🤖 AI 角色 | AI Role\n\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **你是一个专业的畜禽个体识别 AI。你的任务是分析畜禽面部或体表图像，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度。不要提供管理建议或生产建议，仅基于视觉特征输出个体身份识别结果。** |\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过畜禽面部/体表图像或视频进行个体身份识别，基于视觉特征输出稳定的个体 ID 与置信度，为精准饲喂、健康追踪、生产记录、种畜管理等提供最基础的身份关联依据。\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 畜禽个体检测与定位（面部/体表区域） |\n| 2 | 常见畜种识别（猪 / 牛 / 羊 等） |\n| 3 | 面部特征比对（口鼻、眼睛、耳形、面部轮廓） |\n| 4 | 体纹/花斑特征比对（花斑、条纹、色块） |\n| 5 | 耳标/号牌等辅助视觉特征提取 |\n| 6 | 个体 ID 匹配与置信度输出 |\n| 7 | 多个体同框识别与批量身份关联 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | 当用户提供畜禽面部/体表图像或视频 URL 或文件需要个体识别时，默认触发本技能进行个体识别与追踪 |\n| 🔎 明确分析意图 | 当用户明确提及畜禽个体识别、猪脸识别、牛脸识别、羊脸识别、体纹识别、个体追踪、个体档案、种畜识别等关键词，并且上传了图片或视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能**：查看历史个体识别报告、历史畜禽识别记录、个体识别报告清单、查询畜禽追踪记录、显示所有个体识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_livestock_individual_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n---\n\n## 📦 前置准备 | Requirements\n\n### 依赖说明\n\n`scripts` 脚本所需的依赖包及版本：\n\n```txt\nrequests>=2.28.0\n```\n\n---\n\n## 📷 采集要求 | Capture Requirements\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 优先正面/近正面拍摄畜禽面部，能清晰看到口鼻、眼睛、耳部及面部轮廓 |\n| 2 | 拍摄距离建议 30cm～150cm，画面中面部或目标体表区域占比不低于 1/4 |\n| 3 | 光照充足、均匀，避免强逆光、镜头眩光和大面积阴影覆盖面部/体表 |\n| 4 | 尽量保证目标个体处于相对静止或缓慢移动状态，减少大幅晃动导致的模糊 |\n| 5 | 支持单张图或短视频（≤10MB），视频建议 5~15 秒稳定拍摄 |\n| 6 | 支持格式：jpg/png/jpeg 图片，及 mp4/avi/mov 视频；单文件不超过 10MB |\n| 7 | 若通过体纹识别（如奶牛花斑、猪身花斑），应尽量正侧面拍摄，减少遮挡 |\n\n---\n\n## 🚀 操作步骤 | Workflow\n\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达\"查看历史报告/报告清单\"等意图 |\n\n---\n\n## 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备畜禽图像/视频输入 | 提供本地文件路径或网络 URL；确保目标个体面部/体表清晰、符合采集要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行畜禽个体识别 | 调用 `-m scripts.smyx_livestock_individual_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看个体 ID、置信度、匹配特征区域与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地畜禽面部/体表图像/视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络畜禽面部/体表图像/视频 URL 地址 | API 服务自动下载 |\n| `--pet-type` | 类别标识（畜禽场景保持 other） | 默认 `other`，按需填写 |\n| `--list` | 显示历史分析报告清单 | 可以输入起始日期参数过滤数据范围 |\n| `--api-url` | API 服务地址 | 可选，使用默认值 |\n| `--detail` | 输出详细程度 | `basic` / `standard` / `json`，默认 `json` |\n| `--output` | 结果输出文件路径 | 可选 |\n\n---\n\n## 🗂️ 资源索引 | Resource Index\n\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_livestock_individual_analysis.py`](scripts/smyx_livestock_individual_analysis.py) | 调用 API 进行畜禽个体识别或查询历史报告 | 执行分析或查询时使用 |\n| ⚙️ 配置文件 | [`scripts/config.py`](scripts/config.py) | 场景码 `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS`、默认参数配置 | 需要确认默认配置时读取 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n---\n\n## ⚠️ 注意事项 | Notes\n\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 图片支持 `jpg` / `png` / `jpeg`；视频支持 `mp4` / `avi` / `mov`；单文件最大 `10MB` |\n| 🧑‍⚖️ 结果性质 | 识别结果仅供个体身份关联参考，本技能不提供管理建议或生产建议 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能使用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数无需本地下载，默认为公网地址，API 服务会自动下载 |\n| 📜 报告输出 | 显示历史分析报告清单时，从接口返回 JSON 数据中提取字段作为超链接地址，并自动转化为 Markdown 表格输出 |\n\n---\n\n## 🔒 隐私与数据安全声明 | Privacy & Data Security\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 仅采集与畜禽个体识别直接相关的面部/体表图像/视频数据，不采集与识别无关的敏感信息 |\n| 2 | 内部身份参数由系统自动处理，不在任何输出、日志或报告中暴露 |\n| 3 | 分析请求通过服务端 API 完成，网络传输遵循平台既有安全策略 |\n| 4 | 历史报告仅当前身份可读，不做跨养殖场/跨用户汇总或共享 |\n| 5 | 识别结果仅供参考，正式生产档案与种畜谱系登记请结合养殖场既有台账与人工复核 |\n\n---\n\n## 📜 历史报告清单输出规范 | Report List Format\n\n当显示历史分析报告清单的时候，从接口返回 JSON 数据中提取字段作为超链接地址，且自动转化为如下 Markdown 表格格式输出。\n\n### 📌 固定输出列\n\n| 列名 | 生成规则 |\n|---|---|\n| 报告名称 | 使用 `畜禽个体识别报告-{记录id}` 形式拼接 |\n| 识别个体 ID | 从接口返回数据中提取（识别到的个体 ID，未识别可显示 `未匹配`） |\n| 分析时间 | 从接口返回数据中提取 |\n| 点击查看 | 使用 `[🔗 查看报告]()` 格式的超链接 |\n\n### 🧾 表格输出示例\n\n| 报告名称 | 识别个体 ID | 分析时间 | 点击查看 |\n|----------|-------------|----------|----------|\n| 畜禽个体识别报告-20260703160500001 | COW-000123 | 2026-07-03 16:05:00 | [🔗 查看报告](https://example.com/report?id=xxx) |\n\n---\n\n## 🧰 使用示例 | Examples\n\n### 🐷 分析本地生猪面部图像\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input /path/to/pig_face.jpg\n```\n\n### 🐄 分析本地奶牛体纹图像\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input /path/to/cow_body.jpg\n```\n\n### 🌐 分析网络畜禽图像/视频\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --url https://example.com/sheep_face.mp4\n```\n\n### 📚 显示历史分析报告 / 显示分析报告清单列表 / 显示历史个体识别报告\n\n> 自动触发关键词：查看历史个体识别报告、历史报告、畜禽识别清单等。\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n### 🪶 输出精简报告\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input pig_face.jpg --detail basic\n```\n\n### 💾 保存结果到文件\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input cow_body.jpg --output result.json\n```\n\nFile v1.0.12:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-livestock-individual-analysis\",\n  \"version\": \"1.0.12\",\n  \"publishedAt\": 1790641048267\n}\n\nFile v1.0.12:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放畜禽个体识别与追踪 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动畜禽个体识别与追踪分析任务\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` - 畜禽个体识别与追踪\n\nFile v1.0.12:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.12:scripts/config.yaml\n\n{}\n\nFile v1.0.12:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.12:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.12:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.12:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: prod\n\nFile v1.0.12:skill-card.md\n\n## Description:\n\nIdentifies individual pigs, cattle, and sheep from images or videos and returns identity matches and confidence information for livestock tracking.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nFarm operators and developers use this skill to associate livestock images or videos with individual animal IDs, review confidence information, and retrieve past identification reports.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Livestock images, videos, and identity-linked report requests are sent to remote services.\n\nMitigation: Use only with approved media and accounts; confirm the service's access and retention practices before uploading.\n\nRisk: Identity input and broad history-report triggers may expose reports beyond the intended request.\n\nMitigation: Restrict who can request report history, verify the selected identity and scope, and avoid broad report-list queries when unnecessary.\n\nRisk: Local account records and cached tokens may be accessible to other users of the device.\n\nMitigation: Limit access to local account data and prefer a release that does not store tokens in plaintext.\n\n## Reference(s):\n\n- [Livestock identification API documentation](references/api_doc.md)\n- [ClawHub skill release](https://clawhub.ai/smyx-sunjinhui/skills/smyx-livestock-individual-analysis)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, JSON]\n\n**Output Format:** [Text or JSON analysis results; Markdown tables with links for historical reports]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include matched animal IDs, confidence information, and report links; results can be saved to a file.]\n\n## Skill Version(s):\n\n1.0.12 (source: skill frontmatter and ClawHub release)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.12:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.12:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.11: 31 files, 39654 bytes\n\nFiles: references/api_doc.md (661b), scripts/__init__.py (65b), scripts/config.py (676b), scripts/config.yaml (3b), scripts/skill.py (576b), scripts/smyx_livestock_individual_analysis.py (3578b), skill-card.md (2749b), SKILL.md (11831b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (472b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28776b), _meta.json (154b)\n\nFile v1.0.11:SKILL.md\n\n---\nname: \"smyx-livestock-individual-analysis\"\ndescription: \"Identifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking. | 通过面部/体纹识别畜禽个体，实现精准管理追踪。\"\nversion: \"1.0.10\"\nlicense: \"MIT-0\"\n---\n\n# 🐄 Livestock Individual Identification & Tracking | 畜禽个体识别与追踪\n\n> 通过面部/体纹识别畜禽个体，实现精准管理追踪。\n>\n> **精准养殖识别中枢** · 面部/体纹智能比对 · 个体身份识别 · 追踪管理 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **畜禽个体识别与追踪** |\n| 🎯 核心目标 | 基于畜禽面部/体表图像或视频，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度，辅助猪、牛、羊等畜种的精准养殖与全流程追踪 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、个体 ID、置信度、匹配特征区域、报告链接 |\n| 🏢 适用场景 | 猪/牛/羊等畜禽的个体健康追踪、生产记录、精准饲喂、种畜管理等场景中的身份识别环节 |\n| 🧩 场景码 | `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n## 🤖 AI 角色 | AI Role\n\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **你是一个专业的畜禽个体识别 AI。你的任务是分析畜禽面部或体表图像，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度。不要提供管理建议或生产建议，仅基于视觉特征输出个体身份识别结果。** |\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过畜禽面部/体表图像或视频进行个体身份识别，基于视觉特征输出稳定的个体 ID 与置信度，为精准饲喂、健康追踪、生产记录、种畜管理等提供最基础的身份关联依据。\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 畜禽个体检测与定位（面部/体表区域） |\n| 2 | 常见畜种识别（猪 / 牛 / 羊 等） |\n| 3 | 面部特征比对（口鼻、眼睛、耳形、面部轮廓） |\n| 4 | 体纹/花斑特征比对（花斑、条纹、色块） |\n| 5 | 耳标/号牌等辅助视觉特征提取 |\n| 6 | 个体 ID 匹配与置信度输出 |\n| 7 | 多个体同框识别与批量身份关联 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | 当用户提供畜禽面部/体表图像或视频 URL 或文件需要个体识别时，默认触发本技能进行个体识别与追踪 |\n| 🔎 明确分析意图 | 当用户明确提及畜禽个体识别、猪脸识别、牛脸识别、羊脸识别、体纹识别、个体追踪、个体档案、种畜识别等关键词，并且上传了图片或视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能**：查看历史个体识别报告、历史畜禽识别记录、个体识别报告清单、查询畜禽追踪记录、显示所有个体识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_livestock_individual_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n---\n\n## 📦 前置准备 | Requirements\n\n### 依赖说明\n\n`scripts` 脚本所需的依赖包及版本：\n\n```txt\nrequests>=2.28.0\n```\n\n---\n\n## 📷 采集要求 | Capture Requirements\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 优先正面/近正面拍摄畜禽面部，能清晰看到口鼻、眼睛、耳部及面部轮廓 |\n| 2 | 拍摄距离建议 30cm～150cm，画面中面部或目标体表区域占比不低于 1/4 |\n| 3 | 光照充足、均匀，避免强逆光、镜头眩光和大面积阴影覆盖面部/体表 |\n| 4 | 尽量保证目标个体处于相对静止或缓慢移动状态，减少大幅晃动导致的模糊 |\n| 5 | 支持单张图或短视频（≤10MB），视频建议 5~15 秒稳定拍摄 |\n| 6 | 支持格式：jpg/png/jpeg 图片，及 mp4/avi/mov 视频；单文件不超过 10MB |\n| 7 | 若通过体纹识别（如奶牛花斑、猪身花斑），应尽量正侧面拍摄，减少遮挡 |\n\n---\n\n## 🚀 操作步骤 | Workflow\n\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达\"查看历史报告/报告清单\"等意图 |\n\n---\n\n## 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备畜禽图像/视频输入 | 提供本地文件路径或网络 URL；确保目标个体面部/体表清晰、符合采集要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行畜禽个体识别 | 调用 `-m scripts.smyx_livestock_individual_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看个体 ID、置信度、匹配特征区域与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地畜禽面部/体表图像/视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络畜禽面部/体表图像/视频 URL 地址 | API 服务自动下载 |\n| `--pet-type` | 类别标识（畜禽场景保持 other） | 默认 `other`，按需填写 |\n| `--list` | 显示历史分析报告清单 | 可以输入起始日期参数过滤数据范围 |\n| `--api-url` | API 服务地址 | 可选，使用默认值 |\n| `--detail` | 输出详细程度 | `basic` / `standard` / `json`，默认 `json` |\n| `--output` | 结果输出文件路径 | 可选 |\n\n---\n\n## 🗂️ 资源索引 | Resource Index\n\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_livestock_individual_analysis.py`](scripts/smyx_livestock_individual_analysis.py) | 调用 API 进行畜禽个体识别或查询历史报告 | 执行分析或查询时使用 |\n| ⚙️ 配置文件 | [`scripts/config.py`](scripts/config.py) | 场景码 `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS`、默认参数配置 | 需要确认默认配置时读取 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n---\n\n## ⚠️ 注意事项 | Notes\n\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 图片支持 `jpg` / `png` / `jpeg`；视频支持 `mp4` / `avi` / `mov`；单文件最大 `10MB` |\n| 🧑‍⚖️ 结果性质 | 识别结果仅供个体身份关联参考，本技能不提供管理建议或生产建议 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能使用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数无需本地下载，默认为公网地址，API 服务会自动下载 |\n| 📜 报告输出 | 显示历史分析报告清单时，从接口返回 JSON 数据中提取字段作为超链接地址，并自动转化为 Markdown 表格输出 |\n\n---\n\n## 🔒 隐私与数据安全声明 | Privacy & Data Security\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 仅采集与畜禽个体识别直接相关的面部/体表图像/视频数据，不采集与识别无关的敏感信息 |\n| 2 | 内部身份参数由系统自动处理，不在任何输出、日志或报告中暴露 |\n| 3 | 分析请求通过服务端 API 完成，网络传输遵循平台既有安全策略 |\n| 4 | 历史报告仅当前身份可读，不做跨养殖场/跨用户汇总或共享 |\n| 5 | 识别结果仅供参考，正式生产档案与种畜谱系登记请结合养殖场既有台账与人工复核 |\n\n---\n\n## 📜 历史报告清单输出规范 | Report List Format\n\n当显示历史分析报告清单的时候，从接口返回 JSON 数据中提取字段作为超链接地址，且自动转化为如下 Markdown 表格格式输出。\n\n### 📌 固定输出列\n\n| 列名 | 生成规则 |\n|---|---|\n| 报告名称 | 使用 `畜禽个体识别报告-{记录id}` 形式拼接 |\n| 识别个体 ID | 从接口返回数据中提取（识别到的个体 ID，未识别可显示 `未匹配`） |\n| 分析时间 | 从接口返回数据中提取 |\n| 点击查看 | 使用 `[🔗 查看报告]()` 格式的超链接 |\n\n### 🧾 表格输出示例\n\n| 报告名称 | 识别个体 ID | 分析时间 | 点击查看 |\n|----------|-------------|----------|----------|\n| 畜禽个体识别报告-20260703160500001 | COW-000123 | 2026-07-03 16:05:00 | [🔗 查看报告](https://example.com/report?id=xxx) |\n\n---\n\n## 🧰 使用示例 | Examples\n\n### 🐷 分析本地生猪面部图像\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input /path/to/pig_face.jpg\n```\n\n### 🐄 分析本地奶牛体纹图像\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input /path/to/cow_body.jpg\n```\n\n### 🌐 分析网络畜禽图像/视频\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --url https://example.com/sheep_face.mp4\n```\n\n### 📚 显示历史分析报告 / 显示分析报告清单列表 / 显示历史个体识别报告\n\n> 自动触发关键词：查看历史个体识别报告、历史报告、畜禽识别清单等。\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n### 🪶 输出精简报告\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input pig_face.jpg --detail basic\n```\n\n### 💾 保存结果到文件\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input cow_body.jpg --output result.json\n```\n\nFile v1.0.11:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-livestock-individual-analysis\",\n  \"version\": \"1.0.11\",\n  \"publishedAt\": 1789366111376\n}\n\nFile v1.0.11:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放畜禽个体识别与追踪 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动畜禽个体识别与追踪分析任务\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` - 畜禽个体识别与追踪\n\nFile v1.0.11:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.11:scripts/config.yaml\n\n{}\n\nFile v1.0.11:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.11:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.11:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.11:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: dev\n\nFile v1.0.11:skill-card.md\n\n## Description:\n\nIdentifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking. | 通过面部/体纹识别畜禽个体，实现精准管理追踪。\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and farm operations teams use this skill to identify pigs, cattle, and sheep from livestock face or body-pattern images and videos. It returns individual IDs, confidence values, matched visual regions, and report links to support identity association for precision feeding, health tracking, production records, and breeding management.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Uploaded livestock media and report history may be sent to a remote service and associated with account identity.\n\nMitigation: Treat uploaded media and reports as account-linked data; deploy only after the publisher documents remote service behavior and data handling.\n\nRisk: Security evidence reports hidden identity handling, persistent local tokens, and active plaintext HTTP development endpoints for sensitive media and authentication data.\n\nMitigation: Install only after development HTTP endpoints are replaced with verified HTTPS production hosts and credential storage behavior is fixed or accepted by the deployment owner.\n\nRisk: Automatic history-query triggers can retrieve account-linked report history.\n\nMitigation: Narrow history-query triggers and require clear user intent before retrieving historical reports.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-livestock-individual-analysis)\n- [Skill demo](https://lifeemergence.com/sample.html)\n- [API documentation](references/api_doc.md)\n- [Common analysis API documentation](skills/smyx_analysis/references/api_doc.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, JSON, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown and JSON structured analysis reports]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include individual livestock IDs, confidence values, matched feature regions, historical report rows, and report export links.]\n\n## Skill Version(s):\n\n1.0.11 (source: server release metadata; artifact frontmatter reports 1.0.10)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.11:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.11:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.10: 31 files, 39479 bytes\n\nFiles: references/api_doc.md (661b), scripts/__init__.py (65b), scripts/config.py (676b), scripts/config.yaml (3b), scripts/skill.py (576b), scripts/smyx_livestock_individual_analysis.py (3578b), skill-card.md (2492b), SKILL.md (11830b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (472b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28776b), _meta.json (154b)\n\nFile v1.0.10:SKILL.md\n\n---\nname: \"smyx-livestock-individual-analysis\"\ndescription: \"Identifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking. | 通过面部/体纹识别畜禽个体，实现精准管理追踪。\"\nversion: \"1.0.8\"\nlicense: \"MIT-0\"\n---\n\n# 🐄 Livestock Individual Identification & Tracking | 畜禽个体识别与追踪\n\n> 通过面部/体纹识别畜禽个体，实现精准管理追踪。\n>\n> **精准养殖识别中枢** · 面部/体纹智能比对 · 个体身份识别 · 追踪管理 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **畜禽个体识别与追踪** |\n| 🎯 核心目标 | 基于畜禽面部/体表图像或视频，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度，辅助猪、牛、羊等畜种的精准养殖与全流程追踪 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、个体 ID、置信度、匹配特征区域、报告链接 |\n| 🏢 适用场景 | 猪/牛/羊等畜禽的个体健康追踪、生产记录、精准饲喂、种畜管理等场景中的身份识别环节 |\n| 🧩 场景码 | `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n## 🤖 AI 角色 | AI Role\n\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **你是一个专业的畜禽个体识别 AI。你的任务是分析畜禽面部或体表图像，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度。不要提供管理建议或生产建议，仅基于视觉特征输出个体身份识别结果。** |\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过畜禽面部/体表图像或视频进行个体身份识别，基于视觉特征输出稳定的个体 ID 与置信度，为精准饲喂、健康追踪、生产记录、种畜管理等提供最基础的身份关联依据。\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 畜禽个体检测与定位（面部/体表区域） |\n| 2 | 常见畜种识别（猪 / 牛 / 羊 等） |\n| 3 | 面部特征比对（口鼻、眼睛、耳形、面部轮廓） |\n| 4 | 体纹/花斑特征比对（花斑、条纹、色块） |\n| 5 | 耳标/号牌等辅助视觉特征提取 |\n| 6 | 个体 ID 匹配与置信度输出 |\n| 7 | 多个体同框识别与批量身份关联 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | 当用户提供畜禽面部/体表图像或视频 URL 或文件需要个体识别时，默认触发本技能进行个体识别与追踪 |\n| 🔎 明确分析意图 | 当用户明确提及畜禽个体识别、猪脸识别、牛脸识别、羊脸识别、体纹识别、个体追踪、个体档案、种畜识别等关键词，并且上传了图片或视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能**：查看历史个体识别报告、历史畜禽识别记录、个体识别报告清单、查询畜禽追踪记录、显示所有个体识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_livestock_individual_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n---\n\n## 📦 前置准备 | Requirements\n\n### 依赖说明\n\n`scripts` 脚本所需的依赖包及版本：\n\n```txt\nrequests>=2.28.0\n```\n\n---\n\n## 📷 采集要求 | Capture Requirements\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 优先正面/近正面拍摄畜禽面部，能清晰看到口鼻、眼睛、耳部及面部轮廓 |\n| 2 | 拍摄距离建议 30cm～150cm，画面中面部或目标体表区域占比不低于 1/4 |\n| 3 | 光照充足、均匀，避免强逆光、镜头眩光和大面积阴影覆盖面部/体表 |\n| 4 | 尽量保证目标个体处于相对静止或缓慢移动状态，减少大幅晃动导致的模糊 |\n| 5 | 支持单张图或短视频（≤10MB），视频建议 5~15 秒稳定拍摄 |\n| 6 | 支持格式：jpg/png/jpeg 图片，及 mp4/avi/mov 视频；单文件不超过 10MB |\n| 7 | 若通过体纹识别（如奶牛花斑、猪身花斑），应尽量正侧面拍摄，减少遮挡 |\n\n---\n\n## 🚀 操作步骤 | Workflow\n\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达\"查看历史报告/报告清单\"等意图 |\n\n---\n\n## 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备畜禽图像/视频输入 | 提供本地文件路径或网络 URL；确保目标个体面部/体表清晰、符合采集要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行畜禽个体识别 | 调用 `-m scripts.smyx_livestock_individual_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看个体 ID、置信度、匹配特征区域与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地畜禽面部/体表图像/视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络畜禽面部/体表图像/视频 URL 地址 | API 服务自动下载 |\n| `--pet-type` | 类别标识（畜禽场景保持 other） | 默认 `other`，按需填写 |\n| `--list` | 显示历史分析报告清单 | 可以输入起始日期参数过滤数据范围 |\n| `--api-url` | API 服务地址 | 可选，使用默认值 |\n| `--detail` | 输出详细程度 | `basic` / `standard` / `json`，默认 `json` |\n| `--output` | 结果输出文件路径 | 可选 |\n\n---\n\n## 🗂️ 资源索引 | Resource Index\n\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_livestock_individual_analysis.py`](scripts/smyx_livestock_individual_analysis.py) | 调用 API 进行畜禽个体识别或查询历史报告 | 执行分析或查询时使用 |\n| ⚙️ 配置文件 | [`scripts/config.py`](scripts/config.py) | 场景码 `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS`、默认参数配置 | 需要确认默认配置时读取 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n---\n\n## ⚠️ 注意事项 | Notes\n\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 图片支持 `jpg` / `png` / `jpeg`；视频支持 `mp4` / `avi` / `mov`；单文件最大 `10MB` |\n| 🧑‍⚖️ 结果性质 | 识别结果仅供个体身份关联参考，本技能不提供管理建议或生产建议 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能使用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数无需本地下载，默认为公网地址，API 服务会自动下载 |\n| 📜 报告输出 | 显示历史分析报告清单时，从接口返回 JSON 数据中提取字段作为超链接地址，并自动转化为 Markdown 表格输出 |\n\n---\n\n## 🔒 隐私与数据安全声明 | Privacy & Data Security\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 仅采集与畜禽个体识别直接相关的面部/体表图像/视频数据，不采集与识别无关的敏感信息 |\n| 2 | 内部身份参数由系统自动处理，不在任何输出、日志或报告中暴露 |\n| 3 | 分析请求通过服务端 API 完成，网络传输遵循平台既有安全策略 |\n| 4 | 历史报告仅当前身份可读，不做跨养殖场/跨用户汇总或共享 |\n| 5 | 识别结果仅供参考，正式生产档案与种畜谱系登记请结合养殖场既有台账与人工复核 |\n\n---\n\n## 📜 历史报告清单输出规范 | Report List Format\n\n当显示历史分析报告清单的时候，从接口返回 JSON 数据中提取字段作为超链接地址，且自动转化为如下 Markdown 表格格式输出。\n\n### 📌 固定输出列\n\n| 列名 | 生成规则 |\n|---|---|\n| 报告名称 | 使用 `畜禽个体识别报告-{记录id}` 形式拼接 |\n| 识别个体 ID | 从接口返回数据中提取（识别到的个体 ID，未识别可显示 `未匹配`） |\n| 分析时间 | 从接口返回数据中提取 |\n| 点击查看 | 使用 `[🔗 查看报告]()` 格式的超链接 |\n\n### 🧾 表格输出示例\n\n| 报告名称 | 识别个体 ID | 分析时间 | 点击查看 |\n|----------|-------------|----------|----------|\n| 畜禽个体识别报告-20260703160500001 | COW-000123 | 2026-07-03 16:05:00 | [🔗 查看报告](https://example.com/report?id=xxx) |\n\n---\n\n## 🧰 使用示例 | Examples\n\n### 🐷 分析本地生猪面部图像\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input /path/to/pig_face.jpg\n```\n\n### 🐄 分析本地奶牛体纹图像\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input /path/to/cow_body.jpg\n```\n\n### 🌐 分析网络畜禽图像/视频\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --url https://example.com/sheep_face.mp4\n```\n\n### 📚 显示历史分析报告 / 显示分析报告清单列表 / 显示历史个体识别报告\n\n> 自动触发关键词：查看历史个体识别报告、历史报告、畜禽识别清单等。\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n### 🪶 输出精简报告\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input pig_face.jpg --detail basic\n```\n\n### 💾 保存结果到文件\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input cow_body.jpg --output result.json\n```\n\nFile v1.0.10:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-livestock-individual-analysis\",\n  \"version\": \"1.0.10\",\n  \"publishedAt\": 1787716469292\n}\n\nFile v1.0.10:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放畜禽个体识别与追踪 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动畜禽个体识别与追踪分析任务\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` - 畜禽个体识别与追踪\n\nFile v1.0.10:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.10:scripts/config.yaml\n\n{}\n\nFile v1.0.10:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.10:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.10:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.10:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: dev\n\nFile v1.0.10:skill-card.md\n\n## Description:\n\nIdentifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nFarm operators, livestock management teams, and developers use this skill to identify pigs, cattle, and sheep from images, videos, or URLs and receive a structured report with individual IDs, confidence, matched visual features, and report links.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Farm images, videos, URLs, and identity data may be sent to external analysis services.\n\nMitigation: Install only after verifying the configured API endpoints and confirming that uploaded media is appropriate for the service and publisher.\n\nRisk: The skill can create or reuse a local identity and store tokens in a workspace SQLite database.\n\nMitigation: Use a dedicated workspace, review local identity and token storage expectations before use, and avoid sharing the workspace with untrusted users.\n\nRisk: Historical cloud report queries can expose prior report metadata for the resolved identity.\n\nMitigation: Run history queries only when report tracking for the current identity is intended and acceptable.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-livestock-individual-analysis)\n- [Skill Demo](https://lifeemergence.com/sample.html)\n- [Livestock Individual Identification API Documentation](references/api_doc.md)\n- [SMYX Analysis API Documentation](skills/smyx_analysis/references/api_doc.md)\n\n## Skill Output:\n\n**Output Type(s):** [Analysis, Markdown, JSON, Files]\n\n**Output Format:** [Markdown or JSON structured livestock identification report]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include individual IDs, confidence scores, matched feature areas, historical report entries, export links, and optional saved output files.]\n\n## Skill Version(s):\n\n1.0.10 (source: ClawHub release metadata; artifact frontmatter says 1.0.8)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.10:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.10:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.9: 31 files, 39592 bytes\n\nFiles: references/api_doc.md (661b), scripts/__init__.py (65b), scripts/config.py (676b), scripts/config.yaml (3b), scripts/skill.py (576b), scripts/smyx_livestock_individual_analysis.py (3578b), skill-card.md (2662b), SKILL.md (11830b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (472b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28776b), _meta.json (153b)\n\nFile v1.0.9:SKILL.md\n\n---\nname: \"smyx-livestock-individual-analysis\"\ndescription: \"Identifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking. | 通过面部/体纹识别畜禽个体，实现精准管理追踪。\"\nversion: \"1.0.8\"\nlicense: \"MIT-0\"\n---\n\n# 🐄 Livestock Individual Identification & Tracking | 畜禽个体识别与追踪\n\n> 通过面部/体纹识别畜禽个体，实现精准管理追踪。\n>\n> **精准养殖识别中枢** · 面部/体纹智能比对 · 个体身份识别 · 追踪管理 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **畜禽个体识别与追踪** |\n| 🎯 核心目标 | 基于畜禽面部/体表图像或视频，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度，辅助猪、牛、羊等畜种的精准养殖与全流程追踪 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、个体 ID、置信度、匹配特征区域、报告链接 |\n| 🏢 适用场景 | 猪/牛/羊等畜禽的个体健康追踪、生产记录、精准饲喂、种畜管理等场景中的身份识别环节 |\n| 🧩 场景码 | `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n## 🤖 AI 角色 | AI Role\n\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **你是一个专业的畜禽个体识别 AI。你的任务是分析畜禽面部或体表图像，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度。不要提供管理建议或生产建议，仅基于视觉特征输出个体身份识别结果。** |\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过畜禽面部/体表图像或视频进行个体身份识别，基于视觉特征输出稳定的个体 ID 与置信度，为精准饲喂、健康追踪、生产记录、种畜管理等提供最基础的身份关联依据。\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 畜禽个体检测与定位（面部/体表区域） |\n| 2 | 常见畜种识别（猪 / 牛 / 羊 等） |\n| 3 | 面部特征比对（口鼻、眼睛、耳形、面部轮廓） |\n| 4 | 体纹/花斑特征比对（花斑、条纹、色块） |\n| 5 | 耳标/号牌等辅助视觉特征提取 |\n| 6 | 个体 ID 匹配与置信度输出 |\n| 7 | 多个体同框识别与批量身份关联 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | 当用户提供畜禽面部/体表图像或视频 URL 或文件需要个体识别时，默认触发本技能进行个体识别与追踪 |\n| 🔎 明确分析意图 | 当用户明确提及畜禽个体识别、猪脸识别、牛脸识别、羊脸识别、体纹识别、个体追踪、个体档案、种畜识别等关键词，并且上传了图片或视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能**：查看历史个体识别报告、历史畜禽识别记录、个体识别报告清单、查询畜禽追踪记录、显示所有个体识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_livestock_individual_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n---\n\n## 📦 前置准备 | Requirements\n\n### 依赖说明\n\n`scripts` 脚本所需的依赖包及版本：\n\n```txt\nrequests>=2.28.0\n```\n\n---\n\n## 📷 采集要求 | Capture Requirements\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 优先正面/近正面拍摄畜禽面部，能清晰看到口鼻、眼睛、耳部及面部轮廓 |\n| 2 | 拍摄距离建议 30cm～150cm，画面中面部或目标体表区域占比不低于 1/4 |\n| 3 | 光照充足、均匀，避免强逆光、镜头眩光和大面积阴影覆盖面部/体表 |\n| 4 | 尽量保证目标个体处于相对静止或缓慢移动状态，减少大幅晃动导致的模糊 |\n| 5 | 支持单张图或短视频（≤10MB），视频建议 5~15 秒稳定拍摄 |\n| 6 | 支持格式：jpg/png/jpeg 图片，及 mp4/avi/mov 视频；单文件不超过 10MB |\n| 7 | 若通过体纹识别（如奶牛花斑、猪身花斑），应尽量正侧面拍摄，减少遮挡 |\n\n---\n\n## 🚀 操作步骤 | Workflow\n\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达\"查看历史报告/报告清单\"等意图 |\n\n---\n\n## 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备畜禽图像/视频输入 | 提供本地文件路径或网络 URL；确保目标个体面部/体表清晰、符合采集要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行畜禽个体识别 | 调用 `-m scripts.smyx_livestock_individual_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看个体 ID、置信度、匹配特征区域与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地畜禽面部/体表图像/视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络畜禽面部/体表图像/视频 URL 地址 | API 服务自动下载 |\n| `--pet-type` | 类别标识（畜禽场景保持 other） | 默认 `other`，按需填写 |\n| `--list` | 显示历史分析报告清单 | 可以输入起始日期参数过滤数据范围 |\n| `--api-url` | API 服务地址 | 可选，使用默认值 |\n| `--detail` | 输出详细程度 | `basic` / `standard` / `json`，默认 `json` |\n| `--output` | 结果输出文件路径 | 可选 |\n\n---\n\n## 🗂️ 资源索引 | Resource Index\n\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_livestock_individual_analysis.py`](scripts/smyx_livestock_individual_analysis.py) | 调用 API 进行畜禽个体识别或查询历史报告 | 执行分析或查询时使用 |\n| ⚙️ 配置文件 | [`scripts/config.py`](scripts/config.py) | 场景码 `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS`、默认参数配置 | 需要确认默认配置时读取 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n---\n\n## ⚠️ 注意事项 | Notes\n\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 图片支持 `jpg` / `png` / `jpeg`；视频支持 `mp4` / `avi` / `mov`；单文件最大 `10MB` |\n| 🧑‍⚖️ 结果性质 | 识别结果仅供个体身份关联参考，本技能不提供管理建议或生产建议 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能使用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数无需本地下载，默认为公网地址，API 服务会自动下载 |\n| 📜 报告输出 | 显示历史分析报告清单时，从接口返回 JSON 数据中提取字段作为超链接地址，并自动转化为 Markdown 表格输出 |\n\n---\n\n## 🔒 隐私与数据安全声明 | Privacy & Data Security\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 仅采集与畜禽个体识别直接相关的面部/体表图像/视频数据，不采集与识别无关的敏感信息 |\n| 2 | 内部身份参数由系统自动处理，不在任何输出、日志或报告中暴露 |\n| 3 | 分析请求通过服务端 API 完成，网络传输遵循平台既有安全策略 |\n| 4 | 历史报告仅当前身份可读，不做跨养殖场/跨用户汇总或共享 |\n| 5 | 识别结果仅供参考，正式生产档案与种畜谱系登记请结合养殖场既有台账与人工复核 |\n\n---\n\n## 📜 历史报告清单输出规范 | Report List Format\n\n当显示历史分析报告清单的时候，从接口返回 JSON 数据中提取字段作为超链接地址，且自动转化为如下 Markdown 表格格式输出。\n\n### 📌 固定输出列\n\n| 列名 | 生成规则 |\n|---|---|\n| 报告名称 | 使用 `畜禽个体识别报告-{记录id}` 形式拼接 |\n| 识别个体 ID | 从接口返回数据中提取（识别到的个体 ID，未识别可显示 `未匹配`） |\n| 分析时间 | 从接口返回数据中提取 |\n| 点击查看 | 使用 `[🔗 查看报告]()` 格式的超链接 |\n\n### 🧾 表格输出示例\n\n| 报告名称 | 识别个体 ID | 分析时间 | 点击查看 |\n|----------|-------------|----------|----------|\n| 畜禽个体识别报告-20260703160500001 | COW-000123 | 2026-07-03 16:05:00 | [🔗 查看报告](https://example.com/report?id=xxx) |\n\n---\n\n## 🧰 使用示例 | Examples\n\n### 🐷 分析本地生猪面部图像\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input /path/to/pig_face.jpg\n```\n\n### 🐄 分析本地奶牛体纹图像\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input /path/to/cow_body.jpg\n```\n\n### 🌐 分析网络畜禽图像/视频\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --url https://example.com/sheep_face.mp4\n```\n\n### 📚 显示历史分析报告 / 显示分析报告清单列表 / 显示历史个体识别报告\n\n> 自动触发关键词：查看历史个体识别报告、历史报告、畜禽识别清单等。\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n### 🪶 输出精简报告\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input pig_face.jpg --detail basic\n```\n\n### 💾 保存结果到文件\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input cow_body.jpg --output result.json\n```\n\nFile v1.0.9:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-livestock-individual-analysis\",\n  \"version\": \"1.0.9\",\n  \"publishedAt\": 1787199449005\n}\n\nFile v1.0.9:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放畜禽个体识别与追踪 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动畜禽个体识别与追踪分析任务\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` - 畜禽个体识别与追踪\n\nFile v1.0.9:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.9:scripts/config.yaml\n\n{}\n\nFile v1.0.9:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.9:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.9:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.9:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: dev\n\nFile v1.0.9:skill-card.md\n\n## Description:\n\nIdentifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal developers and farm operations users use this skill to submit livestock images, videos, or media URLs for individual animal identification, confidence scoring, and report lookup. The skill supports identity-linked workflows for precision feeding, health tracking, production records, and breeding-stock management.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Livestock media or media URLs are sent to remote analysis services.\n\nMitigation: Use only media that the operator is authorized to process, review the service destination before use, and avoid sending sensitive farm data until endpoint and data-handling requirements are confirmed.\n\nRisk: The skill can silently create or reuse a local account identity and store authentication tokens in workspace data.\n\nMitigation: Run the skill in an isolated workspace, restrict access to local data files, and clear or rotate stored credentials after evaluation or tenant changes.\n\nRisk: Bundled configuration includes development HTTP endpoints on 192.168.1.234.\n\nMitigation: Verify and replace development endpoints with approved production HTTPS endpoints before processing sensitive media.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-livestock-individual-analysis)\n- [Skill demo](https://lifeemergence.com/sample.html)\n- [API documentation](references/api_doc.md)\n- [Shared analysis API documentation](skills/smyx_analysis/references/api_doc.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, json, shell commands]\n\n**Output Format:** [Markdown or JSON analysis output, including individual IDs, confidence values, matched feature details, report links, and optional history tables.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May process local media files or media URLs and can write results to a file when an output path is provided.]\n\n## Skill Version(s):\n\n1.0.9 (source: server release metadata; artifact frontmatter reports 1.0.8)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.9:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.9:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.8: 31 files, 39529 bytes\n\nFiles: references/api_doc.md (661b), scripts/__init__.py (65b), scripts/config.py (676b), scripts/config.yaml (3b), scripts/skill.py (576b), scripts/smyx_livestock_individual_analysis.py (3578b), skill-card.md (2609b), SKILL.md (11830b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (473b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28776b), _meta.json (153b)\n\nFile v1.0.8:SKILL.md\n\n---\nname: \"smyx-livestock-individual-analysis\"\ndescription: \"Identifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking. | 通过面部/体纹识别畜禽个体，实现精准管理追踪。\"\nversion: \"1.0.7\"\nlicense: \"MIT-0\"\n---\n\n# 🐄 Livestock Individual Identification & Tracking | 畜禽个体识别与追踪\n\n> 通过面部/体纹识别畜禽个体，实现精准管理追踪。\n>\n> **精准养殖识别中枢** · 面部/体纹智能比对 · 个体身份识别 · 追踪管理 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **畜禽个体识别与追踪** |\n| 🎯 核心目标 | 基于畜禽面部/体表图像或视频，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度，辅助猪、牛、羊等畜种的精准养殖与全流程追踪 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、个体 ID、置信度、匹配特征区域、报告链接 |\n| 🏢 适用场景 | 猪/牛/羊等畜禽的个体健康追踪、生产记录、精准饲喂、种畜管理等场景中的身份识别环节 |\n| 🧩 场景码 | `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n## 🤖 AI 角色 | AI Role\n\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **你是一个专业的畜禽个体识别 AI。你的任务是分析畜禽面部或体表图像，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度。不要提供管理建议或生产建议，仅基于视觉特征输出个体身份识别结果。** |\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过畜禽面部/体表图像或视频进行个体身份识别，基于视觉特征输出稳定的个体 ID 与置信度，为精准饲喂、健康追踪、生产记录、种畜管理等提供最基础的身份关联依据。\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 畜禽个体检测与定位（面部/体表区域） |\n| 2 | 常见畜种识别（猪 / 牛 / 羊 等） |\n| 3 | 面部特征比对（口鼻、眼睛、耳形、面部轮廓） |\n| 4 | 体纹/花斑特征比对（花斑、条纹、色块） |\n| 5 | 耳标/号牌等辅助视觉特征提取 |\n| 6 | 个体 ID 匹配与置信度输出 |\n| 7 | 多个体同框识别与批量身份关联 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | 当用户提供畜禽面部/体表图像或视频 URL 或文件需要个体识别时，默认触发本技能进行个体识别与追踪 |\n| 🔎 明确分析意图 | 当用户明确提及畜禽个体识别、猪脸识别、牛脸识别、羊脸识别、体纹识别、个体追踪、个体档案、种畜识别等关键词，并且上传了图片或视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能**：查看历史个体识别报告、历史畜禽识别记录、个体识别报告清单、查询畜禽追踪记录、显示所有个体识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_livestock_individual_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n---\n\n## 📦 前置准备 | Requirements\n\n### 依赖说明\n\n`scripts` 脚本所需的依赖包及版本：\n\n```txt\nrequests>=2.28.0\n```\n\n---\n\n## 📷 采集要求 | Capture Requirements\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 优先正面/近正面拍摄畜禽面部，能清晰看到口鼻、眼睛、耳部及面部轮廓 |\n| 2 | 拍摄距离建议 30cm～150cm，画面中面部或目标体表区域占比不低于 1/4 |\n| 3 | 光照充足、均匀，避免强逆光、镜头眩光和大面积阴影覆盖面部/体表 |\n| 4 | 尽量保证目标个体处于相对静止或缓慢移动状态，减少大幅晃动导致的模糊 |\n| 5 | 支持单张图或短视频（≤10MB），视频建议 5~15 秒稳定拍摄 |\n| 6 | 支持格式：jpg/png/jpeg 图片，及 mp4/avi/mov 视频；单文件不超过 10MB |\n| 7 | 若通过体纹识别（如奶牛花斑、猪身花斑），应尽量正侧面拍摄，减少遮挡 |\n\n---\n\n## 🚀 操作步骤 | Workflow\n\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达\"查看历史报告/报告清单\"等意图 |\n\n---\n\n## 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备畜禽图像/视频输入 | 提供本地文件路径或网络 URL；确保目标个体面部/体表清晰、符合采集要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行畜禽个体识别 | 调用 `-m scripts.smyx_livestock_individual_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看个体 ID、置信度、匹配特征区域与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地畜禽面部/体表图像/视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络畜禽面部/体表图像/视频 URL 地址 | API 服务自动下载 |\n| `--pet-type` | 类别标识（畜禽场景保持 other） | 默认 `other`，按需填写 |\n| `--list` | 显示历史分析报告清单 | 可以输入起始日期参数过滤数据范围 |\n| `--api-url` | API 服务地址 | 可选，使用默认值 |\n| `--detail` | 输出详细程度 | `basic` / `standard` / `json`，默认 `json` |\n| `--output` | 结果输出文件路径 | 可选 |\n\n---\n\n## 🗂️ 资源索引 | Resource Index\n\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_livestock_individual_analysis.py`](scripts/smyx_livestock_individual_analysis.py) | 调用 API 进行畜禽个体识别或查询历史报告 | 执行分析或查询时使用 |\n| ⚙️ 配置文件 | [`scripts/config.py`](scripts/config.py) | 场景码 `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS`、默认参数配置 | 需要确认默认配置时读取 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n---\n\n## ⚠️ 注意事项 | Notes\n\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 图片支持 `jpg` / `png` / `jpeg`；视频支持 `mp4` / `avi` / `mov`；单文件最大 `10MB` |\n| 🧑‍⚖️ 结果性质 | 识别结果仅供个体身份关联参考，本技能不提供管理建议或生产建议 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能使用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数无需本地下载，默认为公网地址，API 服务会自动下载 |\n| 📜 报告输出 | 显示历史分析报告清单时，从接口返回 JSON 数据中提取字段作为超链接地址，并自动转化为 Markdown 表格输出 |\n\n---\n\n## 🔒 隐私与数据安全声明 | Privacy & Data Security\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 仅采集与畜禽个体识别直接相关的面部/体表图像/视频数据，不采集与识别无关的敏感信息 |\n| 2 | 内部身份参数由系统自动处理，不在任何输出、日志或报告中暴露 |\n| 3 | 分析请求通过服务端 API 完成，网络传输遵循平台既有安全策略 |\n| 4 | 历史报告仅当前身份可读，不做跨养殖场/跨用户汇总或共享 |\n| 5 | 识别结果仅供参考，正式生产档案与种畜谱系登记请结合养殖场既有台账与人工复核 |\n\n---\n\n## 📜 历史报告清单输出规范 | Report List Format\n\n当显示历史分析报告清单的时候，从接口返回 JSON 数据中提取字段作为超链接地址，且自动转化为如下 Markdown 表格格式输出。\n\n### 📌 固定输出列\n\n| 列名 | 生成规则 |\n|---|---|\n| 报告名称 | 使用 `畜禽个体识别报告-{记录id}` 形式拼接 |\n| 识别个体 ID | 从接口返回数据中提取（识别到的个体 ID，未识别可显示 `未匹配`） |\n| 分析时间 | 从接口返回数据中提取 |\n| 点击查看 | 使用 `[🔗 查看报告]()` 格式的超链接 |\n\n### 🧾 表格输出示例\n\n| 报告名称 | 识别个体 ID | 分析时间 | 点击查看 |\n|----------|-------------|----------|----------|\n| 畜禽个体识别报告-20260703160500001 | COW-000123 | 2026-07-03 16:05:00 | [🔗 查看报告](https://example.com/report?id=xxx) |\n\n---\n\n## 🧰 使用示例 | Examples\n\n### 🐷 分析本地生猪面部图像\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input /path/to/pig_face.jpg\n```\n\n### 🐄 分析本地奶牛体纹图像\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input /path/to/cow_body.jpg\n```\n\n### 🌐 分析网络畜禽图像/视频\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --url https://example.com/sheep_face.mp4\n```\n\n### 📚 显示历史分析报告 / 显示分析报告清单列表 / 显示历史个体识别报告\n\n> 自动触发关键词：查看历史个体识别报告、历史报告、畜禽识别清单等。\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n### 🪶 输出精简报告\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input pig_face.jpg --detail basic\n```\n\n### 💾 保存结果到文件\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input cow_body.jpg --output result.json\n```\n\nFile v1.0.8:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-livestock-individual-analysis\",\n  \"version\": \"1.0.8\",\n  \"publishedAt\": 1786664975396\n}\n\nFile v1.0.8:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放畜禽个体识别与追踪 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动畜禽个体识别与追踪分析任务\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` - 畜禽个体识别与追踪\n\nFile v1.0.8:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.8:scripts/config.yaml\n\n{}\n\nFile v1.0.8:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.8:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.8:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.8:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: prod\n\nFile v1.0.8:skill-card.md\n\n## Description:\n\nIdentifies individual pigs, cattle, and sheep from face or body-pattern media and returns a stable individual ID, confidence, matched feature areas, and report links.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal farm operators and developers use this skill to send livestock images, short videos, or media URLs to a cloud analysis service for individual identification, tracking records, and historical report lookup.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Cloud processing of livestock images, videos, and report history may expose operational farm media or records outside the local workspace.\n\nMitigation: Use the skill only when cloud processing is acceptable for the media and report history involved; avoid submitting unrelated sensitive content.\n\nRisk: The skill silently creates or reuses an identity and stores auth tokens locally under the workspace data directory.\n\nMitigation: Review local data and token handling before deployment, restrict workspace access, and rotate or clear stored credentials when identities should no longer be reused.\n\nRisk: Individual identification results are confidence-based and may not be sufficient for formal production, health, or breeding records without review.\n\nMitigation: Treat results as identity-association support and confirm important records against farm systems and human review.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-livestock-individual-analysis)\n- [Skill demo](https://lifeemergence.com/sample.html)\n- [API documentation](references/api_doc.md)\n- [Shared analysis API documentation](skills/smyx_analysis/references/api_doc.md)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, JSON, Files]\n\n**Output Format:** [Structured analysis report with individual ID, confidence, matched feature areas, report links, optional JSON detail, and optional saved output file]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Can also return historical report listings as a Markdown table from the cloud report API.]\n\n## Skill Version(s):\n\n1.0.8 (source: server release metadata; artifact frontmatter reports 1.0.7)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.8:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.8:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.7: 31 files, 39708 bytes\n\nFiles: references/api_doc.md (661b), scripts/__init__.py (65b), scripts/config.py (676b), scripts/config.yaml (3b), scripts/skill.py (576b), scripts/smyx_livestock_individual_analysis.py (3578b), skill-card.md (2832b), SKILL.md (11830b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (473b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28776b), _meta.json (153b)\n\nFile v1.0.7:SKILL.md\n\n---\nname: \"smyx-livestock-individual-analysis\"\ndescription: \"Identifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking. | 通过面部/体纹识别畜禽个体，实现精准管理追踪。\"\nversion: \"1.0.5\"\nlicense: \"MIT-0\"\n---\n\n# 🐄 Livestock Individual Identification & Tracking | 畜禽个体识别与追踪\n\n> 通过面部/体纹识别畜禽个体，实现精准管理追踪。\n>\n> **精准养殖识别中枢** · 面部/体纹智能比对 · 个体身份识别 · 追踪管理 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **畜禽个体识别与追踪** |\n| 🎯 核心目标 | 基于畜禽面部/体表图像或视频，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度，辅助猪、牛、羊等畜种的精准养殖与全流程追踪 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、个体 ID、置信度、匹配特征区域、报告链接 |\n| 🏢 适用场景 | 猪/牛/羊等畜禽的个体健康追踪、生产记录、精准饲喂、种畜管理等场景中的身份识别环节 |\n| 🧩 场景码 | `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n## 🤖 AI 角色 | AI Role\n\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **你是一个专业的畜禽个体识别 AI。你的任务是分析畜禽面部或体表图像，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度。不要提供管理建议或生产建议，仅基于视觉特征输出个体身份识别结果。** |\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过畜禽面部/体表图像或视频进行个体身份识别，基于视觉特征输出稳定的个体 ID 与置信度，为精准饲喂、健康追踪、生产记录、种畜管理等提供最基础的身份关联依据。\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 畜禽个体检测与定位（面部/体表区域） |\n| 2 | 常见畜种识别（猪 / 牛 / 羊 等） |\n| 3 | 面部特征比对（口鼻、眼睛、耳形、面部轮廓） |\n| 4 | 体纹/花斑特征比对（花斑、条纹、色块） |\n| 5 | 耳标/号牌等辅助视觉特征提取 |\n| 6 | 个体 ID 匹配与置信度输出 |\n| 7 | 多个体同框识别与批量身份关联 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | 当用户提供畜禽面部/体表图像或视频 URL 或文件需要个体识别时，默认触发本技能进行个体识别与追踪 |\n| 🔎 明确分析意图 | 当用户明确提及畜禽个体识别、猪脸识别、牛脸识别、羊脸识别、体纹识别、个体追踪、个体档案、种畜识别等关键词，并且上传了图片或视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能**：查看历史个体识别报告、历史畜禽识别记录、个体识别报告清单、查询畜禽追踪记录、显示所有个体识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_livestock_individual_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n---\n\n## 📦 前置准备 | Requirements\n\n### 依赖说明\n\n`scripts` 脚本所需的依赖包及版本：\n\n```txt\nrequests>=2.28.0\n```\n\n---\n\n## 📷 采集要求 | Capture Requirements\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 优先正面/近正面拍摄畜禽面部，能清晰看到口鼻、眼睛、耳部及面部轮廓 |\n| 2 | 拍摄距离建议 30cm～150cm，画面中面部或目标体表区域占比不低于 1/4 |\n| 3 | 光照充足、均匀，避免强逆光、镜头眩光和大面积阴影覆盖面部/体表 |\n| 4 | 尽量保证目标个体处于相对静止或缓慢移动状态，减少大幅晃动导致的模糊 |\n| 5 | 支持单张图或短视频（≤10MB），视频建议 5~15 秒稳定拍摄 |\n| 6 | 支持格式：jpg/png/jpeg 图片，及 mp4/avi/mov 视频；单文件不超过 10MB |\n| 7 | 若通过体纹识别（如奶牛花斑、猪身花斑），应尽量正侧面拍摄，减少遮挡 |\n\n---\n\n## 🚀 操作步骤 | Workflow\n\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达\"查看历史报告/报告清单\"等意图 |\n\n---\n\n## 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备畜禽图像/视频输入 | 提供本地文件路径或网络 URL；确保目标个体面部/体表清晰、符合采集要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行畜禽个体识别 | 调用 `-m scripts.smyx_livestock_individual_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看个体 ID、置信度、匹配特征区域与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地畜禽面部/体表图像/视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络畜禽面部/体表图像/视频 URL 地址 | API 服务自动下载 |\n| `--pet-type` | 类别标识（畜禽场景保持 other） | 默认 `other`，按需填写 |\n| `--list` | 显示历史分析报告清单 | 可以输入起始日期参数过滤数据范围 |\n| `--api-url` | API 服务地址 | 可选，使用默认值 |\n| `--detail` | 输出详细程度 | `basic` / `standard` / `json`，默认 `json` |\n| `--output` | 结果输出文件路径 | 可选 |\n\n---\n\n## 🗂️ 资源索引 | Resource Index\n\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_livestock_individual_analysis.py`](scripts/smyx_livestock_individual_analysis.py) | 调用 API 进行畜禽个体识别或查询历史报告 | 执行分析或查询时使用 |\n| ⚙️ 配置文件 | [`scripts/config.py`](scripts/config.py) | 场景码 `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS`、默认参数配置 | 需要确认默认配置时读取 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n---\n\n## ⚠️ 注意事项 | Notes\n\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 图片支持 `jpg` / `png` / `jpeg`；视频支持 `mp4` / `avi` / `mov`；单文件最大 `10MB` |\n| 🧑‍⚖️ 结果性质 | 识别结果仅供个体身份关联参考，本技能不提供管理建议或生产建议 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能使用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数无需本地下载，默认为公网地址，API 服务会自动下载 |\n| 📜 报告输出 | 显示历史分析报告清单时，从接口返回 JSON 数据中提取字段作为超链接地址，并自动转化为 Markdown 表格输出 |\n\n---\n\n## 🔒 隐私与数据安全声明 | Privacy & Data Security\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 仅采集与畜禽个体识别直接相关的面部/体表图像/视频数据，不采集与识别无关的敏感信息 |\n| 2 | 内部身份参数由系统自动处理，不在任何输出、日志或报告中暴露 |\n| 3 | 分析请求通过服务端 API 完成，网络传输遵循平台既有安全策略 |\n| 4 | 历史报告仅当前身份可读，不做跨养殖场/跨用户汇总或共享 |\n| 5 | 识别结果仅供参考，正式生产档案与种畜谱系登记请结合养殖场既有台账与人工复核 |\n\n---\n\n## 📜 历史报告清单输出规范 | Report List Format\n\n当显示历史分析报告清单的时候，从接口返回 JSON 数据中提取字段作为超链接地址，且自动转化为如下 Markdown 表格格式输出。\n\n### 📌 固定输出列\n\n| 列名 | 生成规则 |\n|---|---|\n| 报告名称 | 使用 `畜禽个体识别报告-{记录id}` 形式拼接 |\n| 识别个体 ID | 从接口返回数据中提取（识别到的个体 ID，未识别可显示 `未匹配`） |\n| 分析时间 | 从接口返回数据中提取 |\n| 点击查看 | 使用 `[🔗 查看报告]()` 格式的超链接 |\n\n### 🧾 表格输出示例\n\n| 报告名称 | 识别个体 ID | 分析时间 | 点击查看 |\n|----------|-------------|----------|----------|\n| 畜禽个体识别报告-20260703160500001 | COW-000123 | 2026-07-03 16:05:00 | [🔗 查看报告](https://example.com/report?id=xxx) |\n\n---\n\n## 🧰 使用示例 | Examples\n\n### 🐷 分析本地生猪面部图像\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input /path/to/pig_face.jpg\n```\n\n### 🐄 分析本地奶牛体纹图像\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input /path/to/cow_body.jpg\n```\n\n### 🌐 分析网络畜禽图像/视频\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --url https://example.com/sheep_face.mp4\n```\n\n### 📚 显示历史分析报告 / 显示分析报告清单列表 / 显示历史个体识别报告\n\n> 自动触发关键词：查看历史个体识别报告、历史报告、畜禽识别清单等。\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n### 🪶 输出精简报告\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input pig_face.jpg --detail basic\n```\n\n### 💾 保存结果到文件\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input cow_body.jpg --output result.json\n```\n\nFile v1.0.7:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-livestock-individual-analysis\",\n  \"version\": \"1.0.7\",\n  \"publishedAt\": 1785919953484\n}\n\nFile v1.0.7:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放畜禽个体识别与追踪 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动畜禽个体识别与追踪分析任务\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` - 畜禽个体识别与追踪\n\nFile v1.0.7:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.7:scripts/config.yaml\n\n{}\n\nFile v1.0.7:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.7:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.7:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.7:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: prod\n\nFile v1.0.7:skill-card.md\n\n## Description:\n\nIdentifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking. | 通过面部/体纹识别畜禽个体，实现精准管理追踪。\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nFarm operators, livestock technology teams, and agents use this skill to identify pigs, cattle, and sheep from face or body-pattern images or videos, then return identity IDs, confidence, matched feature areas, report links, or history tables for tracking workflows.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Livestock media, media URLs, identity tokens, and identifiers are processed by lifeemergence.com services and may be linked to locally stored workspace data.\n\nMitigation: Use a dedicated workspace, begin with non-sensitive test media, and install only when this cloud processing and local token storage are acceptable.\n\nRisk: The skill silently creates or reuses an account identity and retrieves identity-linked history.\n\nMitigation: Review account and history behavior before deployment, avoid shared workspaces for sensitive use, and clear workspace data files during uninstall or rotation.\n\nRisk: Identification results are reference outputs for livestock identity association and may be wrong or incomplete under poor capture conditions.\n\nMitigation: Use clear face or body-pattern media that meets the documented capture requirements and verify important records against farm systems or human review.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-livestock-individual-analysis)\n- [Skill demo](https://lifeemergence.com/sample.html)\n- [Livestock individual analysis API documentation](references/api_doc.md)\n- [Common analysis API documentation](skills/smyx_analysis/references/api_doc.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown or JSON text returned by Python command-line scripts, with optional saved output files]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Analysis output may include individual IDs, confidence, matched feature regions, report links, and Markdown tables for historical reports.]\n\n## Skill Version(s):\n\n1.0.7 (source: server release metadata; artifact frontmatter lists 1.0.5)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.7:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.7:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.6: 31 files, 39466 bytes\n\nFiles: references/api_doc.md (661b), scripts/__init__.py (65b), scripts/config.py (676b), scripts/config.yaml (3b), scripts/skill.py (576b), scripts/smyx_livestock_individual_analysis.py (3578b), skill-card.md (2564b), SKILL.md (11830b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (473b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28776b), _meta.json (153b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: \"smyx-livestock-individual-analysis\"\ndescription: \"Identifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking. | 通过面部/体纹识别畜禽个体，实现精准管理追踪。\"\nversion: \"1.0.5\"\nlicense: \"MIT-0\"\n---\n\n# 🐄 Livestock Individual Identification & Tracking | 畜禽个体识别与追踪\n\n> 通过面部/体纹识别畜禽个体，实现精准管理追踪。\n>\n> **精准养殖识别中枢** · 面部/体纹智能比对 · 个体身份识别 · 追踪管理 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **畜禽个体识别与追踪** |\n| 🎯 核心目标 | 基于畜禽面部/体表图像或视频，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度，辅助猪、牛、羊等畜种的精准养殖与全流程追踪 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、个体 ID、置信度、匹配特征区域、报告链接 |\n| 🏢 适用场景 | 猪/牛/羊等畜禽的个体健康追踪、生产记录、精准饲喂、种畜管理等场景中的身份识别环节 |\n| 🧩 场景码 | `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n## 🤖 AI 角色 | AI Role\n\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **你是一个专业的畜禽个体识别 AI。你的任务是分析畜禽面部或体表图像，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度。不要提供管理建议或生产建议，仅基于视觉特征输出个体身份识别结果。** |\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过畜禽面部/体表图像或视频进行个体身份识别，基于视觉特征输出稳定的个体 ID 与置信度，为精准饲喂、健康追踪、生产记录、种畜管理等提供最基础的身份关联依据。\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 畜禽个体检测与定位（面部/体表区域） |\n| 2 | 常见畜种识别（猪 / 牛 / 羊 等） |\n| 3 | 面部特征比对（口鼻、眼睛、耳形、面部轮廓） |\n| 4 | 体纹/花斑特征比对（花斑、条纹、色块） |\n| 5 | 耳标/号牌等辅助视觉特征提取 |\n| 6 | 个体 ID 匹配与置信度输出 |\n| 7 | 多个体同框识别与批量身份关联 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | 当用户提供畜禽面部/体表图像或视频 URL 或文件需要个体识别时，默认触发本技能进行个体识别与追踪 |\n| 🔎 明确分析意图 | 当用户明确提及畜禽个体识别、猪脸识别、牛脸识别、羊脸识别、体纹识别、个体追踪、个体档案、种畜识别等关键词，并且上传了图片或视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能**：查看历史个体识别报告、历史畜禽识别记录、个体识别报告清单、查询畜禽追踪记录、显示所有个体识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_livestock_individual_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n---\n\n## 📦 前置准备 | Requirements\n\n### 依赖说明\n\n`scripts` 脚本所需的依赖包及版本：\n\n```txt\nrequests>=2.28.0\n```\n\n---\n\n## 📷 采集要求 | Capture Requirements\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 优先正面/近正面拍摄畜禽面部，能清晰看到口鼻、眼睛、耳部及面部轮廓 |\n| 2 | 拍摄距离建议 30cm～150cm，画面中面部或目标体表区域占比不低于 1/4 |\n| 3 | 光照充足、均匀，避免强逆光、镜头眩光和大面积阴影覆盖面部/体表 |\n| 4 | 尽量保证目标个体处于相对静止或缓慢移动状态，减少大幅晃动导致的模糊 |\n| 5 | 支持单张图或短视频（≤10MB），视频建议 5~15 秒稳定拍摄 |\n| 6 | 支持格式：jpg/png/jpeg 图片，及 mp4/avi/mov 视频；单文件不超过 10MB |\n| 7 | 若通过体纹识别（如奶牛花斑、猪身花斑），应尽量正侧面拍摄，减少遮挡 |\n\n---\n\n## 🚀 操作步骤 | Workflow\n\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达\"查看历史报告/报告清单\"等意图 |\n\n---\n\n## 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备畜禽图像/视频输入 | 提供本地文件路径或网络 URL；确保目标个体面部/体表清晰、符合采集要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行畜禽个体识别 | 调用 `-m scripts.smyx_livestock_individual_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看个体 ID、置信度、匹配特征区域与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地畜禽面部/体表图像/视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络畜禽面部/体表图像/视频 URL 地址 | API 服务自动下载 |\n| `--pet-type` | 类别标识（畜禽场景保持 other） | 默认 `other`，按需填写 |\n| `--list` | 显示历史分析报告清单 | 可以输入起始日期参数过滤数据范围 |\n| `--api-url` | API 服务地址 | 可选，使用默认值 |\n| `--detail` | 输出详细程度 | `basic` / `standard` / `json`，默认 `json` |\n| `--output` | 结果输出文件路径 | 可选 |\n\n---\n\n## 🗂️ 资源索引 | Resource Index\n\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_livestock_individual_analysis.py`](scripts/smyx_livestock_individual_analysis.py) | 调用 API 进行畜禽个体识别或查询历史报告 | 执行分析或查询时使用 |\n| ⚙️ 配置文件 | [`scripts/config.py`](scripts/config.py) | 场景码 `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS`、默认参数配置 | 需要确认默认配置时读取 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n---\n\n## ⚠️ 注意事项 | Notes\n\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 图片支持 `jpg` / `png` / `jpeg`；视频支持 `mp4` / `avi` / `mov`；单文件最大 `10MB` |\n| 🧑‍⚖️ 结果性质 | 识别结果仅供个体身份关联参考，本技能不提供管理建议或生产建议 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能使用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数无需本地下载，默认为公网地址，API 服务会自动下载 |\n| 📜 报告输出 | 显示历史分析报告清单时，从接口返回 JSON 数据中提取字段作为超链接地址，并自动转化为 Markdown 表格输出 |\n\n---\n\n## 🔒 隐私与数据安全声明 | Privacy & Data Security\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 仅采集与畜禽个体识别直接相关的面部/体表图像/视频数据，不采集与识别无关的敏感信息 |\n| 2 | 内部身份参数由系统自动处理，不在任何输出、日志或报告中暴露 |\n| 3 | 分析请求通过服务端 API 完成，网络传输遵循平台既有安全策略 |\n| 4 | 历史报告仅当前身份可读，不做跨养殖场/跨用户汇总或共享 |\n| 5 | 识别结果仅供参考，正式生产档案与种畜谱系登记请结合养殖场既有台账与人工复核 |\n\n---\n\n## 📜 历史报告清单输出规范 | Report List Format\n\n当显示历史分析报告清单的时候，从接口返回 JSON 数据中提取字段作为超链接地址，且自动转化为如下 Markdown 表格格式输出。\n\n### 📌 固定输出列\n\n| 列名 | 生成规则 |\n|---|---|\n| 报告名称 | 使用 `畜禽个体识别报告-{记录id}` 形式拼接 |\n| 识别个体 ID | 从接口返回数据中提取（识别到的个体 ID，未识别可显示 `未匹配`） |\n| 分析时间 | 从接口返回数据中提取 |\n| 点击查看 | 使用 `[🔗 查看报告]()` 格式的超链接 |\n\n### 🧾 表格输出示例\n\n| 报告名称 | 识别个体 ID | 分析时间 | 点击查看 |\n|----------|-------------|----------|----------|\n| 畜禽个体识别报告-20260703160500001 | COW-000123 | 2026-07-03 16:05:00 | [🔗 查看报告](https://example.com/report?id=xxx) |\n\n---\n\n## 🧰 使用示例 | Examples\n\n### 🐷 分析本地生猪面部图像\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input /path/to/pig_face.jpg\n```\n\n### 🐄 分析本地奶牛体纹图像\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input /path/to/cow_body.jpg\n```\n\n### 🌐 分析网络畜禽图像/视频\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --url https://example.com/sheep_face.mp4\n```\n\n### 📚 显示历史分析报告 / 显示分析报告清单列表 / 显示历史个体识别报告\n\n> 自动触发关键词：查看历史个体识别报告、历史报告、畜禽识别清单等。\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n### 🪶 输出精简报告\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input pig_face.jpg --detail basic\n```\n\n### 💾 保存结果到文件\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input cow_body.jpg --output result.json\n```\n\nFile v1.0.6:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-livestock-individual-analysis\",\n  \"version\": \"1.0.6\",\n  \"publishedAt\": 1785537270734\n}\n\nFile v1.0.6:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放畜禽个体识别与追踪 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动畜禽个体识别与追踪分析任务\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` - 畜禽个体识别与追踪\n\nFile v1.0.6:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.6:scripts/config.yaml\n\n{}\n\nFile v1.0.6:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.6:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.6:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.6:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: prod\n\nFile v1.0.6:skill-card.md\n\n## Description: <br>\nIdentifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users and developers use this skill to submit livestock images, videos, or URLs for individual animal identification, history report lookup, and precision farm tracking workflows. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Livestock images, videos, or submitted URLs may be sent to the Life Emergence service for analysis. <br>\nMitigation: Obtain explicit user confirmation before upload and avoid submitting media that should not leave the user's environment. <br>\nRisk: The skill can create or reuse a local identity, authenticate with the service, and store returned tokens in the workspace data database. <br>\nMitigation: Review token storage before installation and limit use to workspaces where local identity and service-token persistence are acceptable. <br>\nRisk: The skill can query cloud history reports without clear user confirmation. <br>\nMitigation: Ask for explicit confirmation before listing history reports and review returned report links before sharing them. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-livestock-individual-analysis) <br>\n- [Skill demo](https://lifeemergence.com/sample.html) <br>\n- [API interface documentation](references/api_doc.md) <br>\n- [Shared analysis API documentation](skills/smyx_analysis/references/api_doc.md) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Analysis, Markdown, JSON, Shell commands, Files] <br>\n**Output Format:** [Markdown or JSON text, with optional file output] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Results may include individual IDs, confidence values, feature regions, analysis status, report links, and history tables.] <br>\n\n## Skill Version(s): <br>\n1.0.6 (source: server release metadata; SKILL.md frontmatter reports 1.0.5) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nFile v1.0.6:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.6:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.5: 31 files, 39536 bytes\n\nFiles: references/api_doc.md (661b), scripts/__init__.py (65b), scripts/config.py (676b), scripts/config.yaml (3b), scripts/skill.py (576b), scripts/smyx_livestock_individual_analysis.py (3578b), skill-card.md (2625b), SKILL.md (11830b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (473b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28776b), _meta.json (153b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: \"smyx-livestock-individual-analysis\"\ndescription: \"Identifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking. | 通过面部/体纹识别畜禽个体，实现精准管理追踪。\"\nversion: \"1.0.3\"\nlicense: \"MIT-0\"\n---\n\n# 🐄 Livestock Individual Identification & Tracking | 畜禽个体识别与追踪\n\n> 通过面部/体纹识别畜禽个体，实现精准管理追踪。\n>\n> **精准养殖识别中枢** · 面部/体纹智能比对 · 个体身份识别 · 追踪管理 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **畜禽个体识别与追踪** |\n| 🎯 核心目标 | 基于畜禽面部/体表图像或视频，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度，辅助猪、牛、羊等畜种的精准养殖与全流程追踪 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、个体 ID、置信度、匹配特征区域、报告链接 |\n| 🏢 适用场景 | 猪/牛/羊等畜禽的个体健康追踪、生产记录、精准饲喂、种畜管理等场景中的身份识别环节 |\n| 🧩 场景码 | `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n## 🤖 AI 角色 | AI Role\n\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **你是一个专业的畜禽个体识别 AI。你的任务是分析畜禽面部或体表图像，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度。不要提供管理建议或生产建议，仅基于视觉特征输出个体身份识别结果。** |\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过畜禽面部/体表图像或视频进行个体身份识别，基于视觉特征输出稳定的个体 ID 与置信度，为精准饲喂、健康追踪、生产记录、种畜管理等提供最基础的身份关联依据。\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 畜禽个体检测与定位（面部/体表区域） |\n| 2 | 常见畜种识别（猪 / 牛 / 羊 等） |\n| 3 | 面部特征比对（口鼻、眼睛、耳形、面部轮廓） |\n| 4 | 体纹/花斑特征比对（花斑、条纹、色块） |\n| 5 | 耳标/号牌等辅助视觉特征提取 |\n| 6 | 个体 ID 匹配与置信度输出 |\n| 7 | 多个体同框识别与批量身份关联 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | 当用户提供畜禽面部/体表图像或视频 URL 或文件需要个体识别时，默认触发本技能进行个体识别与追踪 |\n| 🔎 明确分析意图 | 当用户明确提及畜禽个体识别、猪脸识别、牛脸识别、羊脸识别、体纹识别、个体追踪、个体档案、种畜识别等关键词，并且上传了图片或视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能**：查看历史个体识别报告、历史畜禽识别记录、个体识别报告清单、查询畜禽追踪记录、显示所有个体识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_livestock_individual_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n---\n\n## 📦 前置准备 | Requirements\n\n### 依赖说明\n\n`scripts` 脚本所需的依赖包及版本：\n\n```txt\nrequests>=2.28.0\n```\n\n---\n\n## 📷 采集要求 | Capture Requirements\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 优先正面/近正面拍摄畜禽面部，能清晰看到口鼻、眼睛、耳部及面部轮廓 |\n| 2 | 拍摄距离建议 30cm～150cm，画面中面部或目标体表区域占比不低于 1/4 |\n| 3 | 光照充足、均匀，避免强逆光、镜头眩光和大面积阴影覆盖面部/体表 |\n| 4 | 尽量保证目标个体处于相对静止或缓慢移动状态，减少大幅晃动导致的模糊 |\n| 5 | 支持单张图或短视频（≤10MB），视频建议 5~15 秒稳定拍摄 |\n| 6 | 支持格式：jpg/png/jpeg 图片，及 mp4/avi/mov 视频；单文件不超过 10MB |\n| 7 | 若通过体纹识别（如奶牛花斑、猪身花斑），应尽量正侧面拍摄，减少遮挡 |\n\n---\n\n## 🚀 操作步骤 | Workflow\n\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达\"查看历史报告/报告清单\"等意图 |\n\n---\n\n## 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备畜禽图像/视频输入 | 提供本地文件路径或网络 URL；确保目标个体面部/体表清晰、符合采集要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行畜禽个体识别 | 调用 `-m scripts.smyx_livestock_individual_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看个体 ID、置信度、匹配特征区域与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地畜禽面部/体表图像/视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络畜禽面部/体表图像/视频 URL 地址 | API 服务自动下载 |\n| `--pet-type` | 类别标识（畜禽场景保持 other） | 默认 `other`，按需填写 |\n| `--list` | 显示历史分析报告清单 | 可以输入起始日期参数过滤数据范围 |\n| `--api-url` | API 服务地址 | 可选，使用默认值 |\n| `--detail` | 输出详细程度 | `basic` / `standard` / `json`，默认 `json` |\n| `--output` | 结果输出文件路径 | 可选 |\n\n---\n\n## 🗂️ 资源索引 | Resource Index\n\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_livestock_individual_analysis.py`](scripts/smyx_livestock_individual_analysis.py) | 调用 API 进行畜禽个体识别或查询历史报告 | 执行分析或查询时使用 |\n| ⚙️ 配置文件 | [`scripts/config.py`](scripts/config.py) | 场景码 `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS`、默认参数配置 | 需要确认默认配置时读取 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n---\n\n## ⚠️ 注意事项 | Notes\n\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 图片支持 `jpg` / `png` / `jpeg`；视频支持 `mp4` / `avi` / `mov`；单文件最大 `10MB` |\n| 🧑‍⚖️ 结果性质 | 识别结果仅供个体身份关联参考，本技能不提供管理建议或生产建议 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能使用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数无需本地下载，默认为公网地址，API 服务会自动下载 |\n| 📜 报告输出 | 显示历史分析报告清单时，从接口返回 JSON 数据中提取字段作为超链接地址，并自动转化为 Markdown 表格输出 |\n\n---\n\n## 🔒 隐私与数据安全声明 | Privacy & Data Security\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 仅采集与畜禽个体识别直接相关的面部/体表图像/视频数据，不采集与识别无关的敏感信息 |\n| 2 | 内部身份参数由系统自动处理，不在任何输出、日志或报告中暴露 |\n| 3 | 分析请求通过服务端 API 完成，网络传输遵循平台既有安全策略 |\n| 4 | 历史报告仅当前身份可读，不做跨养殖场/跨用户汇总或共享 |\n| 5 | 识别结果仅供参考，正式生产档案与种畜谱系登记请结合养殖场既有台账与人工复核 |\n\n---\n\n## 📜 历史报告清单输出规范 | Report List Format\n\n当显示历史分析报告清单的时候，从接口返回 JSON 数据中提取字段作为超链接地址，且自动转化为如下 Markdown 表格格式输出。\n\n### 📌 固定输出列\n\n| 列名 | 生成规则 |\n|---|---|\n| 报告名称 | 使用 `畜禽个体识别报告-{记录id}` 形式拼接 |\n| 识别个体 ID | 从接口返回数据中提取（识别到的个体 ID，未识别可显示 `未匹配`） |\n| 分析时间 | 从接口返回数据中提取 |\n| 点击查看 | 使用 `[🔗 查看报告]()` 格式的超链接 |\n\n### 🧾 表格输出示例\n\n| 报告名称 | 识别个体 ID | 分析时间 | 点击查看 |\n|----------|-------------|----------|----------|\n| 畜禽个体识别报告-20260703160500001 | COW-000123 | 2026-07-03 16:05:00 | [🔗 查看报告](https://example.com/report?id=xxx) |\n\n---\n\n## 🧰 使用示例 | Examples\n\n### 🐷 分析本地生猪面部图像\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input /path/to/pig_face.jpg\n```\n\n### 🐄 分析本地奶牛体纹图像\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input /path/to/cow_body.jpg\n```\n\n### 🌐 分析网络畜禽图像/视频\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --url https://example.com/sheep_face.mp4\n```\n\n### 📚 显示历史分析报告 / 显示分析报告清单列表 / 显示历史个体识别报告\n\n> 自动触发关键词：查看历史个体识别报告、历史报告、畜禽识别清单等。\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n### 🪶 输出精简报告\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input pig_face.jpg --detail basic\n```\n\n### 💾 保存结果到文件\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input cow_body.jpg --output result.json\n```\n\nFile v1.0.5:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-livestock-individual-analysis\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1784411306663\n}\n\nFile v1.0.5:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放畜禽个体识别与追踪 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动畜禽个体识别与追踪分析任务\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` - 畜禽个体识别与追踪\n\nFile v1.0.5:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.5:scripts/config.yaml\n\n{}\n\nFile v1.0.5:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.5:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.5:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.5:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: prod\n\nFile v1.0.5:skill-card.md\n\n## Description: <br>\nIdentifies individual livestock, including pigs, cattle, and sheep, from facial or body-pattern images or videos and returns a stable individual ID with confidence for precision farm management and tracking. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nFarm operators, livestock-management teams, and external users use this skill to identify pigs, cattle, or sheep from images, videos, local files, or URLs. It links visual observations to an individual ID, confidence score, matched feature regions, and report link for tracking workflows. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill sends livestock media, remote media URLs, and identity or session metadata to cloud services. <br>\nMitigation: Use it only where that transfer is approved, avoid unnecessary sensitive media, and disclose cloud processing to affected operators before deployment. <br>\nRisk: The skill may silently create or reuse a local account record and store tokens in a workspace SQLite database. <br>\nMitigation: Review local identity and token storage before installation, isolate workspaces that run the skill, and prefer a version that requires explicit consent for account creation and history lookup. <br>\n\n\n## Reference(s): <br>\n- [ClawHub Skill Page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-livestock-individual-analysis) <br>\n- [Skill Demo](https://lifeemergence.com/sample.html) <br>\n- [API Interface Documentation](references/api_doc.md) <br>\n- [SMYX Analysis API Documentation](skills/smyx_analysis/references/api_doc.md) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, json, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown or JSON text containing livestock identification results, confidence values, matched feature regions, and report links.] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Can list historical reports as a Markdown table through the cloud API; analysis may also be saved to a local output file.] <br>\n\n## Skill Version(s): <br>\n1.0.5 (source: ClawHub release metadata; SKILL.md frontmatter lists 1.0.3) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nFile v1.0.5:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.5:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.4: 31 files, 39575 bytes\n\nFiles: references/api_doc.md (661b), scripts/__init__.py (65b), scripts/config.py (676b), scripts/config.yaml (3b), scripts/skill.py (576b), scripts/smyx_livestock_individual_analysis.py (3578b), skill-card.md (2926b), SKILL.md (11830b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (473b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28605b), _meta.json (153b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: \"smyx-livestock-individual-analysis\"\ndescription: \"Identifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking. | 通过面部/体纹识别畜禽个体，实现精准管理追踪。\"\nversion: \"1.0.1\"\nlicense: \"MIT-0\"\n---\n\n# 🐄 Livestock Individual Identification & Tracking | 畜禽个体识别与追踪\n\n> 通过面部/体纹识别畜禽个体，实现精准管理追踪。\n>\n> **精准养殖识别中枢** · 面部/体纹智能比对 · 个体身份识别 · 追踪管理 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **畜禽个体识别与追踪** |\n| 🎯 核心目标 | 基于畜禽面部/体表图像或视频，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度，辅助猪、牛、羊等畜种的精准养殖与全流程追踪 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、个体 ID、置信度、匹配特征区域、报告链接 |\n| 🏢 适用场景 | 猪/牛/羊等畜禽的个体健康追踪、生产记录、精准饲喂、种畜管理等场景中的身份识别环节 |\n| 🧩 场景码 | `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n## 🤖 AI 角色 | AI Role\n\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **你是一个专业的畜禽个体识别 AI。你的任务是分析畜禽面部或体表图像，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度。不要提供管理建议或生产建议，仅基于视觉特征输出个体身份识别结果。** |\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过畜禽面部/体表图像或视频进行个体身份识别，基于视觉特征输出稳定的个体 ID 与置信度，为精准饲喂、健康追踪、生产记录、种畜管理等提供最基础的身份关联依据。\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 畜禽个体检测与定位（面部/体表区域） |\n| 2 | 常见畜种识别（猪 / 牛 / 羊 等） |\n| 3 | 面部特征比对（口鼻、眼睛、耳形、面部轮廓） |\n| 4 | 体纹/花斑特征比对（花斑、条纹、色块） |\n| 5 | 耳标/号牌等辅助视觉特征提取 |\n| 6 | 个体 ID 匹配与置信度输出 |\n| 7 | 多个体同框识别与批量身份关联 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | 当用户提供畜禽面部/体表图像或视频 URL 或文件需要个体识别时，默认触发本技能进行个体识别与追踪 |\n| 🔎 明确分析意图 | 当用户明确提及畜禽个体识别、猪脸识别、牛脸识别、羊脸识别、体纹识别、个体追踪、个体档案、种畜识别等关键词，并且上传了图片或视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能**：查看历史个体识别报告、历史畜禽识别记录、个体识别报告清单、查询畜禽追踪记录、显示所有个体识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_livestock_individual_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n---\n\n## 📦 前置准备 | Requirements\n\n### 依赖说明\n\n`scripts` 脚本所需的依赖包及版本：\n\n```txt\nrequests>=2.28.0\n```\n\n---\n\n## 📷 采集要求 | Capture Requirements\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 优先正面/近正面拍摄畜禽面部，能清晰看到口鼻、眼睛、耳部及面部轮廓 |\n| 2 | 拍摄距离建议 30cm～150cm，画面中面部或目标体表区域占比不低于 1/4 |\n| 3 | 光照充足、均匀，避免强逆光、镜头眩光和大面积阴影覆盖面部/体表 |\n| 4 | 尽量保证目标个体处于相对静止或缓慢移动状态，减少大幅晃动导致的模糊 |\n| 5 | 支持单张图或短视频（≤10MB），视频建议 5~15 秒稳定拍摄 |\n| 6 | 支持格式：jpg/png/jpeg 图片，及 mp4/avi/mov 视频；单文件不超过 10MB |\n| 7 | 若通过体纹识别（如奶牛花斑、猪身花斑），应尽量正侧面拍摄，减少遮挡 |\n\n---\n\n## 🚀 操作步骤 | Workflow\n\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达\"查看历史报告/报告清单\"等意图 |\n\n---\n\n## 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备畜禽图像/视频输入 | 提供本地文件路径或网络 URL；确保目标个体面部/体表清晰、符合采集要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行畜禽个体识别 | 调用 `-m scripts.smyx_livestock_individual_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看个体 ID、置信度、匹配特征区域与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地畜禽面部/体表图像/视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络畜禽面部/体表图像/视频 URL 地址 | API 服务自动下载 |\n| `--pet-type` | 类别标识（畜禽场景保持 other） | 默认 `other`，按需填写 |\n| `--list` | 显示历史分析报告清单 | 可以输入起始日期参数过滤数据范围 |\n| `--api-url` | API 服务地址 | 可选，使用默认值 |\n| `--detail` | 输出详细程度 | `basic` / `standard` / `json`，默认 `json` |\n| `--output` | 结果输出文件路径 | 可选 |\n\n---\n\n## 🗂️ 资源索引 | Resource Index\n\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_livestock_individual_analysis.py`](scripts/smyx_livestock_individual_analysis.py) | 调用 API 进行畜禽个体识别或查询历史报告 | 执行分析或查询时使用 |\n| ⚙️ 配置文件 | [`scripts/config.py`](scripts/config.py) | 场景码 `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS`、默认参数配置 | 需要确认默认配置时读取 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n---\n\n## ⚠️ 注意事项 | Notes\n\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 图片支持 `jpg` / `png` / `jpeg`；视频支持 `mp4` / `avi` / `mov`；单文件最大 `10MB` |\n| 🧑‍⚖️ 结果性质 | 识别结果仅供个体身份关联参考，本技能不提供管理建议或生产建议 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能使用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数无需本地下载，默认为公网地址，API 服务会自动下载 |\n| 📜 报告输出 | 显示历史分析报告清单时，从接口返回 JSON 数据中提取字段作为超链接地址，并自动转化为 Markdown 表格输出 |\n\n---\n\n## 🔒 隐私与数据安全声明 | Privacy & Data Security\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 仅采集与畜禽个体识别直接相关的面部/体表图像/视频数据，不采集与识别无关的敏感信息 |\n| 2 | 内部身份参数由系统自动处理，不在任何输出、日志或报告中暴露 |\n| 3 | 分析请求通过服务端 API 完成，网络传输遵循平台既有安全策略 |\n| 4 | 历史报告仅当前身份可读，不做跨养殖场/跨用户汇总或共享 |\n| 5 | 识别结果仅供参考，正式生产档案与种畜谱系登记请结合养殖场既有台账与人工复核 |\n\n---\n\n## 📜 历史报告清单输出规范 | Report List Format\n\n当显示历史分析报告清单的时候，从接口返回 JSON 数据中提取字段作为超链接地址，且自动转化为如下 Markdown 表格格式输出。\n\n### 📌 固定输出列\n\n| 列名 | 生成规则 |\n|---|---|\n| 报告名称 | 使用 `畜禽个体识别报告-{记录id}` 形式拼接 |\n| 识别个体 ID | 从接口返回数据中提取（识别到的个体 ID，未识别可显示 `未匹配`） |\n| 分析时间 | 从接口返回数据中提取 |\n| 点击查看 | 使用 `[🔗 查看报告]()` 格式的超链接 |\n\n### 🧾 表格输出示例\n\n| 报告名称 | 识别个体 ID | 分析时间 | 点击查看 |\n|----------|-------------|----------|----------|\n| 畜禽个体识别报告-20260703160500001 | COW-000123 | 2026-07-03 16:05:00 | [🔗 查看报告](https://example.com/report?id=xxx) |\n\n---\n\n## 🧰 使用示例 | Examples\n\n### 🐷 分析本地生猪面部图像\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input /path/to/pig_face.jpg\n```\n\n### 🐄 分析本地奶牛体纹图像\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input /path/to/cow_body.jpg\n```\n\n### 🌐 分析网络畜禽图像/视频\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --url https://example.com/sheep_face.mp4\n```\n\n### 📚 显示历史分析报告 / 显示分析报告清单列表 / 显示历史个体识别报告\n\n> 自动触发关键词：查看历史个体识别报告、历史报告、畜禽识别清单等。\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n### 🪶 输出精简报告\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input pig_face.jpg --detail basic\n```\n\n### 💾 保存结果到文件\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input cow_body.jpg --output result.json\n```\n\nFile v1.0.4:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-livestock-individual-analysis\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1783357945945\n}\n\nFile v1.0.4:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放畜禽个体识别与追踪 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动畜禽个体识别与追踪分析任务\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` - 畜禽个体识别与追踪\n\nFile v1.0.4:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.4:scripts/config.yaml\n\n{}\n\nFile v1.0.4:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.4:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.4:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.4:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: prod\n\nFile v1.0.4:skill-card.md\n\n## Description: <br>\nIdentifies individual livestock such as pigs, cattle, and sheep from facial or body-pattern imagery and returns an individual ID, confidence score, matched visual features, and report link. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal farm teams and developers use this skill to connect livestock images or videos to individual animal identities for health tracking, production records, feeding workflows, and breeding-stock records. It is intended to support identity association only, not production or management recommendations. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Livestock media, media URLs, account identifiers, and generated reports are sent to an external Life Emergence service. <br>\nMitigation: Use only media that is approved for external processing, avoid private or internal URLs, and confirm the publisher's retention and access-control practices before deployment. <br>\nRisk: The skill silently creates or reuses local account identity and token state. <br>\nMitigation: Review token and account persistence before installation, run in an isolated environment when evaluating, and clear local state between users or tenants. <br>\nRisk: Identity matches and confidence scores may be unsuitable as the sole basis for official animal records. <br>\nMitigation: Treat outputs as identity-association support and require human review or existing farm records for formal production, pedigree, or health workflows. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-livestock-individual-analysis) <br>\n- [Skill demo](https://lifeemergence.com/sample.html) <br>\n- [Livestock individual identification API documentation](references/api_doc.md) <br>\n- [Shared analysis API documentation](skills/smyx_analysis/references/api_doc.md) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, json, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown and JSON analysis reports with individual IDs, confidence values, matched feature descriptions, history tables, and report links.] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Accepts local image/video paths or media URLs; documented limits include jpg/png/jpeg images, mp4/avi/mov videos, and files up to 10 MB.] <br>\n\n## Skill Version(s): <br>\n1.0.4 (source: server release evidence; artifact frontmatter lists 1.0.1) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nFile v1.0.4:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.4:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.3: 31 files, 39474 bytes\n\nFiles: references/api_doc.md (661b), scripts/__init__.py (65b), scripts/config.py (676b), scripts/config.yaml (3b), scripts/skill.py (576b), scripts/smyx_livestock_individual_analysis.py (3578b), skill-card.md (2646b), SKILL.md (11830b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (473b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28605b), _meta.json (153b)\n\nFile v1.0.3:SKILL.md\n\n---\nname: \"smyx-livestock-individual-analysis\"\ndescription: \"Identifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking. | 通过面部/体纹识别畜禽个体，实现精准管理追踪。\"\nversion: \"1.0.0\"\nlicense: \"MIT-0\"\n---\n\n# 🐄 Livestock Individual Identification & Tracking | 畜禽个体识别与追踪\n\n> 通过面部/体纹识别畜禽个体，实现精准管理追踪。\n>\n> **精准养殖识别中枢** · 面部/体纹智能比对 · 个体身份识别 · 追踪管理 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **畜禽个体识别与追踪** |\n| 🎯 核心目标 | 基于畜禽面部/体表图像或视频，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度，辅助猪、牛、羊等畜种的精准养殖与全流程追踪 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、个体 ID、置信度、匹配特征区域、报告链接 |\n| 🏢 适用场景 | 猪/牛/羊等畜禽的个体健康追踪、生产记录、精准饲喂、种畜管理等场景中的身份识别环节 |\n| 🧩 场景码 | `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n## 🤖 AI 角色 | AI Role\n\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **你是一个专业的畜禽个体识别 AI。你的任务是分析畜禽面部或体表图像，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度。不要提供管理建议或生产建议，仅基于视觉特征输出个体身份识别结果。** |\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过畜禽面部/体表图像或视频进行个体身份识别，基于视觉特征输出稳定的个体 ID 与置信度，为精准饲喂、健康追踪、生产记录、种畜管理等提供最基础的身份关联依据。\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 畜禽个体检测与定位（面部/体表区域） |\n| 2 | 常见畜种识别（猪 / 牛 / 羊 等） |\n| 3 | 面部特征比对（口鼻、眼睛、耳形、面部轮廓） |\n| 4 | 体纹/花斑特征比对（花斑、条纹、色块） |\n| 5 | 耳标/号牌等辅助视觉特征提取 |\n| 6 | 个体 ID 匹配与置信度输出 |\n| 7 | 多个体同框识别与批量身份关联 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | 当用户提供畜禽面部/体表图像或视频 URL 或文件需要个体识别时，默认触发本技能进行个体识别与追踪 |\n| 🔎 明确分析意图 | 当用户明确提及畜禽个体识别、猪脸识别、牛脸识别、羊脸识别、体纹识别、个体追踪、个体档案、种畜识别等关键词，并且上传了图片或视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能**：查看历史个体识别报告、历史畜禽识别记录、个体识别报告清单、查询畜禽追踪记录、显示所有个体识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_livestock_individual_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n---\n\n## 📦 前置准备 | Requirements\n\n### 依赖说明\n\n`scripts` 脚本所需的依赖包及版本：\n\n```txt\nrequests>=2.28.0\n```\n\n---\n\n## 📷 采集要求 | Capture Requirements\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 优先正面/近正面拍摄畜禽面部，能清晰看到口鼻、眼睛、耳部及面部轮廓 |\n| 2 | 拍摄距离建议 30cm～150cm，画面中面部或目标体表区域占比不低于 1/4 |\n| 3 | 光照充足、均匀，避免强逆光、镜头眩光和大面积阴影覆盖面部/体表 |\n| 4 | 尽量保证目标个体处于相对静止或缓慢移动状态，减少大幅晃动导致的模糊 |\n| 5 | 支持单张图或短视频（≤10MB），视频建议 5~15 秒稳定拍摄 |\n| 6 | 支持格式：jpg/png/jpeg 图片，及 mp4/avi/mov 视频；单文件不超过 10MB |\n| 7 | 若通过体纹识别（如奶牛花斑、猪身花斑），应尽量正侧面拍摄，减少遮挡 |\n\n---\n\n## 🚀 操作步骤 | Workflow\n\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达\"查看历史报告/报告清单\"等意图 |\n\n---\n\n## 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备畜禽图像/视频输入 | 提供本地文件路径或网络 URL；确保目标个体面部/体表清晰、符合采集要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行畜禽个体识别 | 调用 `-m scripts.smyx_livestock_individual_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看个体 ID、置信度、匹配特征区域与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地畜禽面部/体表图像/视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络畜禽面部/体表图像/视频 URL 地址 | API 服务自动下载 |\n| `--pet-type` | 类别标识（畜禽场景保持 other） | 默认 `other`，按需填写 |\n| `--list` | 显示历史分析报告清单 | 可以输入起始日期参数过滤数据范围 |\n| `--api-url` | API 服务地址 | 可选，使用默认值 |\n| `--detail` | 输出详细程度 | `basic` / `standard` / `json`，默认 `json` |\n| `--output` | 结果输出文件路径 | 可选 |\n\n---\n\n## 🗂️ 资源索引 | Resource Index\n\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_livestock_individual_analysis.py`](scripts/smyx_livestock_individual_analysis.py) | 调用 API 进行畜禽个体识别或查询历史报告 | 执行分析或查询时使用 |\n| ⚙️ 配置文件 | [`scripts/config.py`](scripts/config.py) | 场景码 `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS`、默认参数配置 | 需要确认默认配置时读取 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n---\n\n## ⚠️ 注意事项 | Notes\n\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 图片支持 `jpg` / `png` / `jpeg`；视频支持 `mp4` / `avi` / `mov`；单文件最大 `10MB` |\n| 🧑‍⚖️ 结果性质 | 识别结果仅供个体身份关联参考，本技能不提供管理建议或生产建议 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能使用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数无需本地下载，默认为公网地址，API 服务会自动下载 |\n| 📜 报告输出 | 显示历史分析报告清单时，从接口返回 JSON 数据中提取字段作为超链接地址，并自动转化为 Markdown 表格输出 |\n\n---\n\n## 🔒 隐私与数据安全声明 | Privacy & Data Security\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 仅采集与畜禽个体识别直接相关的面部/体表图像/视频数据，不采集与识别无关的敏感信息 |\n| 2 | 内部身份参数由系统自动处理，不在任何输出、日志或报告中暴露 |\n| 3 | 分析请求通过服务端 API 完成，网络传输遵循平台既有安全策略 |\n| 4 | 历史报告仅当前身份可读，不做跨养殖场/跨用户汇总或共享 |\n| 5 | 识别结果仅供参考，正式生产档案与种畜谱系登记请结合养殖场既有台账与人工复核 |\n\n---\n\n## 📜 历史报告清单输出规范 | Report List Format\n\n当显示历史分析报告清单的时候，从接口返回 JSON 数据中提取字段作为超链接地址，且自动转化为如下 Markdown 表格格式输出。\n\n### 📌 固定输出列\n\n| 列名 | 生成规则 |\n|---|---|\n| 报告名称 | 使用 `畜禽个体识别报告-{记录id}` 形式拼接 |\n| 识别个体 ID | 从接口返回数据中提取（识别到的个体 ID，未识别可显示 `未匹配`） |\n| 分析时间 | 从接口返回数据中提取 |\n| 点击查看 | 使用 `[🔗 查看报告]()` 格式的超链接 |\n\n### 🧾 表格输出示例\n\n| 报告名称 | 识别个体 ID | 分析时间 | 点击查看 |\n|----------|-------------|----------|----------|\n| 畜禽个体识别报告-20260703160500001 | COW-000123 | 2026-07-03 16:05:00 | [🔗 查看报告](https://example.com/report?id=xxx) |\n\n---\n\n## 🧰 使用示例 | Examples\n\n### 🐷 分析本地生猪面部图像\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input /path/to/pig_face.jpg\n```\n\n### 🐄 分析本地奶牛体纹图像\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input /path/to/cow_body.jpg\n```\n\n### 🌐 分析网络畜禽图像/视频\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --url https://example.com/sheep_face.mp4\n```\n\n### 📚 显示历史分析报告 / 显示分析报告清单列表 / 显示历史个体识别报告\n\n> 自动触发关键词：查看历史个体识别报告、历史报告、畜禽识别清单等。\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n### 🪶 输出精简报告\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input pig_face.jpg --detail basic\n```\n\n### 💾 保存结果到文件\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --input cow_body.jpg --output result.json\n```\n\nFile v1.0.3:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-livestock-individual-analysis\",\n  \"version\": \"1.0.3\",\n  \"publishedAt\": 1783233329518\n}\n\nFile v1.0.3:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放畜禽个体识别与追踪 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动畜禽个体识别与追踪分析任务\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` - 畜禽个体识别与追踪\n\nFile v1.0.3:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.3:scripts/config.yaml\n\n{}\n\nFile v1.0.3:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.3:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.3:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.3:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: prod\n\nFile v1.0.3:skill-card.md\n\n## Description: <br>\nIdentifies individual livestock, including pigs, cattle, and sheep, from facial or body-pattern images or video and returns an individual ID with confidence for tracking workflows. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users and agents use this skill to send livestock images or video to a cloud API for individual ID matching, confidence reporting, and historical report lookup. It is intended for identity association in precision farming workflows, not for production or animal-management advice. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The security evidence flags suspicious handling of livestock media, report history, and hidden account or session state for remote cloud services. <br>\nMitigation: Install only if the workspace trusts the LifeEmergence/SMYX backend and accepts automatic identity creation or reuse, local token storage, and cloud history lookup. <br>\nRisk: Recognition results may be incomplete or misleading if media quality, species, body area, or report history context is unsuitable. <br>\nMitigation: Use the generated IDs and confidence values as identity-association support and keep human review or existing farm records as the authority for operational decisions. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-livestock-individual-analysis) <br>\n- [Skill demo](https://lifeemergence.com/sample.html) <br>\n- [API interface documentation](references/api_doc.md) <br>\n- [SMYX analysis API documentation](skills/smyx_analysis/references/api_doc.md) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown guidance with shell command examples; analysis outputs are text or JSON-derived Markdown reports.] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Supports local file paths, public media URLs, report-list queries, and optional file output; analysis is performed through a remote cloud service.] <br>\n\n## Skill Version(s): <br>\n1.0.3 (source: ClawHub release evidence; artifact frontmatter says 1.0.0) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nFile v1.0.3:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.3:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3","readmeExcerpt":"Skill: Livestock Individual Identification | 畜禽个体识别与追踪 Owner: smyx-sunjinhui Summary: Identifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking. | 通过面部/体纹识别畜禽个体，实现精准管理追踪。 Tags: latest:1.0.12 Version history: v1.0.12 | 2026-09-29T00:17:28.267Z | auto smyx-livestock-individual-analysis v1.0.12 - ","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"python -m scripts.smyx_livestock_individual_analysis --list"},{"language":"txt","snippet":"requests>=2.28.0"},{"language":"bash","snippet":"python -m scripts.smyx_livestock_individual_analysis --input /path/to/pig_face.jpg"},{"language":"bash","snippet":"python -m scripts.smyx_livestock_individual_analysis --input /path/to/cow_body.jpg"},{"language":"bash","snippet":"python -m scripts.smyx_livestock_individual_analysis --url https://example.com/sheep_face.mp4"},{"language":"bash","snippet":"python -m scripts.smyx_livestock_individual_analysis --list"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: \"smyx-livestock-individual-analysis\"\ndescription: \"Identifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking. | 通过面部/体纹识别畜禽个体，实现精准管理追踪。\"\nversion: \"1.0.12\"\nlicense: \"MIT-0\"\n---\n\n# 🐄 Livestock Individual Identification & Tracking | 畜禽个体识别与追踪\n\n> 通过面部/体纹识别畜禽个体，实现精准管理追踪。\n>\n> **精准养殖识别中枢** · 面部/体纹智能比对 · 个体身份识别 · 追踪管理 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **畜禽个体识别与追踪** |\n| 🎯 核心目标 | 基于畜禽面部/体表图像或视频，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度，辅助猪、牛、羊等畜种的精准养殖与全流程追踪 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、个体 ID、置信度、匹配特征区域、报告链接 |\n| 🏢 适用场景 | 猪/牛/羊等畜禽的个体健康追踪、生产记录、精准饲喂、种畜管理等场景中的身份识别环节 |\n| 🧩 场景码 | `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n## 🤖 AI 角色 | AI Role\n\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **你是一个专业的畜禽个体识别 AI。你的任务是分析畜禽面部或体表图像，通过个体特征比对识别特定个体的身份，输出个体 ID 及置信度。不要提供管理建议或生产建议，仅基于视觉特征输出个体身份识别结果。** |\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过畜禽面部/体表图像或视频进行个体身份识别，基于视觉特征输出稳定的个体 ID 与置信度，为精准饲喂、健康追踪、生产记录、种畜管理等提供最基础的身份关联依据。\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 畜禽个体检测与定位（面部/体表区域） |\n| 2 | 常见畜种识别（猪 / 牛 / 羊 等） |\n| 3 | 面部特征比对（口鼻、眼睛、耳形、面部轮廓） |\n| 4 | 体纹/花斑特征比对（花斑、条纹、色块） |\n| 5 | 耳标/号牌等辅助视觉特征提取 |\n| 6 | 个体 ID 匹配与置信度输出 |\n| 7 | 多个体同框识别与批量身份关联 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | 当用户提供畜禽面部/体表图像或视频 URL 或文件需要个体识别时，默认触发本技能进行个体识别与追踪 |\n| 🔎 明确分析意图 | 当用户明确提及畜禽个体识别、猪脸识别、牛脸识别、羊脸识别、体纹识别、个体追踪、个体档案、种畜识别等关键词，并且上传了图片或视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能**：查看历史个体识别报告、历史畜禽识别记录、个体识别报告清单、查询畜禽追踪记录、显示所有个体识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_livestock_individual_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_livestock_individual_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n---\n\n## 📦 前置准备 | Requirements\n\n### 依赖说明\n\n`scripts` 脚本所需的依赖包及版本：\n\n```txt\nrequests>=2.28.0\n```\n\n---\n\n## 📷 采集要求 | Capture Requirements\n\n| 序号 | 说明 |\n|---:|---|\n| 1 | 优先正面/近正面拍摄畜禽面部，能清晰看到口鼻、眼睛、耳部及面部轮廓 |\n| 2 | 拍摄距离建议 30cm～150cm，画面中面部或目标体表区域占比不低于 1/4 |\n| 3 | 光照充足、均匀，避免强逆光、镜头眩光和大面积阴影覆盖面部/体表 |\n| 4 | 尽量保证目标个体处于相对静止或缓慢移动状态，减少大幅晃动导致的模糊 |\n| 5 | 支持单张图或短视频（≤10MB），视频建议 5~15 秒稳定拍摄 |\n| 6 | 支持格式：jpg/png/jpeg 图片，及 mp4/avi/mov 视频；单文件不超过 10MB |\n| 7 | 若通过体纹识别（如奶牛花斑、猪身花斑），应尽量正侧面拍摄，减少遮挡 |\n\n---\n\n## 🚀 操作步骤 | Workflow\n\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-livestock-individual-analysis\",\n  \"version\": \"1.0.12\",\n  \"publishedAt\": 1790641048267\n}"},{"path":"references/api_doc.md","content":"# API 接口文档\n\n此处用于存放畜禽个体识别与追踪 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动畜禽个体识别与追踪分析任务\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_LIVESTOCK_INDIVIDUAL_ANALYSIS` - 畜禽个体识别与追踪"},{"path":"skills/smyx_analysis/references/api_doc.md","content":"# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |"},{"path":"scripts/config.yaml","content":"{}"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Identifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking. | 通过面部/体纹识别畜禽个体，实现精准管理追踪。 Skill: Livestock Individual Identification | 畜禽个体识别与追踪 Owner: smyx-sunjinhui Summary: Identifies individual livestock (pigs, cattle, sheep) by facial or body-pattern features and outputs a stable individual ID with confidence for precision farm management and tracking. | 通过面部/体纹识别畜禽个体，实现精准管理追踪。 Tags: latest:1.0.12 Version history: v1.0.12 | 2026-09-29T00:17:28.267Z | auto smyx-livestock-individual-analysis v1.0.12 -","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":757,"uniquenessScore":49,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T03:12:53.335Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T03:12:53.335Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T05:36:32.117Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}