下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-4tw601c9--codex-photo-checkup.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-4tw601c9/codex-photo-checkup。上传老照片,AI 视觉大模型从清晰度、色彩保真、划痕损伤、污渍斑点、撕裂破损、褪色程度 6 个维度全面评分,输出综合评分(0-100)、A/B/C/D 等级评定、修复建议和预估年代。免费使用,适合作为照片修复前的前置评估,帮助选择最佳处理方案。
阅读全文 (展开查看完整说明)
概述
功能说明
使用 AI 视觉大模型对老照片进行全面体检,从清晰度、色彩保真、划痕损伤、污渍斑点、撕裂破损、褪色程度 6 个维度评分,输出综合评分、等级评定(A/B/C/D)、修复建议和预估年代。支持判断照片是否为黑白照片。
⚠️ 默认行为:调用结果请直接在会话中以 Markdown 卡片形式内联展示(渲染
display.markdown字段),不要生成 HTML 文件。详见下文「Agent 展示指引」。
调用方式
POST https://restore-api.codex123.com/skill/checkup
Content-Type: application/json
{
"image_url": "https://example.com/old-photo.jpg",
"source": "skillhub",
"user_id": "user123"
}输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| image_url | string | 是 | 图片 URL(支持 jpg/png/webp,≤5MB) |
| source | string | 否 | 调用来源标识(如 skillhub / workbuddy / qwen-office),用于运营统计 |
| user_id | string | 否 | 调用者标识(各平台传入的用户 ID),用于运营统计 |
输出格式
统一响应结构
所有 Skill API 返回统一 JSON 结构:
| 字段 | 类型 | 说明 |
|---|---|---|
| success | boolean | 请求是否成功 |
| skill | string | 技能标识 |
| call_id | string | 本次调用唯一 ID(排查问题请提供) |
| duration_ms | number | 服务端处理耗时(毫秒) |
| result | object | 结果数据(见下表) |
| display.title | string | 建议展示标题 |
| display.markdown | string | 建议直接向用户展示的 Markdown 报告 |
输出示例
{
"success": true,
"skill": "photo-checkup",
"call_id": "skill_1727600000_ab12cd34",
"duration_ms": 3200,
"result": {
"overall_score": 42,
"grade": "C",
"grade_label": "受损较严重,建议修复",
"scores": {
"clarity": 30,
"color": 55,
"scratch": 40,
"stain": 60,
"tear": 80,
"fade": 35
},
"summary": "照片受损较严重,建议进行高清还原和上色修复",
"is_black_white": true,
"estimated_era": "1980年代",
"damages": ["轻微划痕", "色彩褪色严重", "分辨率较低"],
"recommendations": [
{ "skill": "photo-restore", "label": "高清还原", "reason": "照片存在模糊、划痕或破损等问题,可 AI 修复还原" },
{ "skill": "photo-colorize", "label": "黑白上色", "reason": "检测到黑白照片,可智能上色还原真实色彩" }
]
},
"display": {
"title": "📋 照片体检报告",
"markdown": "## 📋 照片体检报告nn**综合评分:42/100**(C 级 · 受损较严重,建议修复)nn| 维度 | 得分 | 状态 |n|------|------|------|n| 清晰度 | 30 | ❌ 较差 |n| 色彩保真 | 55 | ⚠️ 一般 |n...nn## 💡 修复建议n1. **高清还原** — 照片存在模糊、划痕或破损等问题,可 AI 修复还原n2. **黑白上色** — 检测到黑白照片,可智能上色还原真实色彩"
}
}result 字段说明
| 字段 | 说明 |
|---|---|
| overall_score | 综合评分(0-100,按 6 维度加权计算) |
| grade | 等级:A(≥80 状态良好)/ B(≥60 轻度老化)/ C(≥40 受损较严重)/ D(<40 严重受损) |
| grade_label | 等级中文描述 |
| scores | 6 维度评分(见「评分说明」) |
| summary | AI 总体评价 |
| is_black_white | 是否为黑白照片 |
| estimated_era | 预估拍摄年代 |
| damages | 检测到的具体问题列表 |
| recommendations | 修复建议列表,skill 字段为可后续调用的技能标识 |
💡
display.markdown为排版好的体检报告(评分表 + 状态图标 + 修复建议),Agent 可直接向用户展示,无需自行拼装。
Agent 展示指引
调用成功后,请将响应中的 display.markdown 内容直接在会话中渲染展示为格式化卡片,无需生成 HTML 文件。
展示效果应类似一张体检报告卡片:
- 标题:📋 照片体检报告
- 综合评分:醒目展示分数和等级(如 42/100 · C 级)
- 评分表格:6 维度得分 + 状态图标(✅ 良好 / ⚠️ 一般 / ❌ 较差)
- 修复建议:按优先级列出推荐技能
- 预估年代:如 "1980 年代"
如果 result.recommendations 中有推荐技能,可在报告下方附上推荐技能的安装名称(如 codex-photo-restore),引导用户去技能市场安装。
评分说明
| 维度 | 说明 | 评分范围 |
|---|---|---|
| clarity | 清晰度:分辨率与锐度评估 | 0-100,越低越模糊 |
| color | 色彩保真:褪色与偏色程度 | 0-100,越低褪色越严重 |
| scratch | 划痕损伤:表面物理划痕 | 0-100,越低损伤越多 |
| stain | 污渍斑点:霉斑与水渍 | 0-100,越低污渍越多 |
| tear | 撕裂破损:物理破损程度 | 0-100,越低破损越严重 |
| fade | 褪色程度:整体褪色评估 | 0-100,越低褪色越严重 |
相关技能推荐
体检完成后,可根据评估结果选择后续处理方案:
| 推荐技能 | 安装名称 | 调用路径 | 适用场景 | 价格 |
|---|---|---|---|---|
| 高清还原 | codex-photo-restore | POST /skill/repair | 照片模糊、划痕、破损 — AI 全幅修复为高清图片 | ¥3.90/次 |
| 黑白上色 | codex-photo-colorize | POST /skill/colorize | 检测到黑白照片 — AI 智能上色,还原真实色彩 | ¥2.90/次 |
| 动态回忆 | codex-photo-animate | POST /skill/animate | 照片保存较好 — 将静态照片转化为 5 秒动态视频 | ¥6.90/次 |
| 跨时空合影 | codex-face-swap | POST /skill/face-swap | 想与现代人合影 — 合成跨时空合影,色调统一为老照片质感 | ¥4.90/次 |
💡 体检报告的
result.recommendations字段也会根据照片状况自动推荐适合的技能。如需使用上述技能,请在技能市场搜索对应「安装名称」进行安装。
错误响应
失败时返回统一错误结构:
{
"success": false,
"error": { "code": "INVALID_IMAGE", "message": "不支持的图片格式,仅支持 JPG/PNG/WebP" }
}| 错误码 | HTTP 状态码 | 说明 |
|---|---|---|
| INVALID_PARAMS | 400 | 缺少必填参数 |
| INVALID_IMAGE | 400 | 图片下载失败或格式不支持(jpg/png/webp) |
| UNSAFE_CONTENT | 400 | 内容安全检测未通过 |
| RATE_LIMITED | 429 | 调用过于频繁(每 IP 每分钟 10 次) |
| SKILL_DISABLED | 503 | 该 Skill 已被运营关闭 |
| INTERNAL_ERROR | 500 | 服务内部错误 |
付费说明
本服务为免费服务,无需付费即可使用。