十字绣图纸生成器-万维易源

概述

十字绣图纸生成器

任务目标

• 接收任意照片（全家福、宠物、风景等），一键生成可直接照做的专业十字绣格子图纸
• 具备原图视觉构图分析、画面比例推荐、色彩降维与DMC色号映射、物理用量计算、简体中文标注、格子图纸图像生成、交付物融合能力
• 触发场景：手工十字绣制作、个性化照片礼物定制、家庭装饰画设计、十字绣爱好者图纸辅助设计

能力组成

能力流程描述

本技能以「一张照片 + 绣布目数」为输入，由8个阶段按依赖关系串并联合成，最终输出「图纸图像 + 色号对照表 + 用量统计 + 绣布规格说明 + 构图信息」的完整十字绣交付包，完整链路如下：

1. 合规校验优化（step_0）：对用户提交的图片与参数进行合规校验与安全优化，拦截违规内容，保障后续流程稳定执行。
2. 原图视觉构图分析（step_1）：分析照片内容与构图，识别主体位置与画面重心，基于十字绣制作特点推荐最合适的画面比例（如1:1正方形、3:4竖向、4:3横向等），避免关键内容被裁切或留白过多，给出裁切建议与主体区域描述，并输出色彩基调与细节密度。该步骤是色彩映射、用量计算与生图任务的共同上游。
3. 色彩降维与DMC色号映射（step_2）：将原图色彩降维为不超过25种绣线色（max_colors=25），结合色彩基调与细节密度映射到标准DMC色号体系，输出可直接采购的DMC色号调色板。
4. 物理用量计算（step_3）：基于推荐画面比例、DMC色号调色板与用户指定的绣布目数（grid_density，以10英寸为基础宽度），计算绣布尺寸、总针数、各色针数与用线量。
5. 简体中文标注生成（step_4）：生成简体中文标注的色号对照表（含DMC色号、中文名称、针数、用线量、色彩分类）、绣布规格说明与用量摘要。
6. 启动十字绣图纸生图任务（step_5）：以原图为参考图、按推荐画面比例，生成专业十字绣格子图纸风格图像——呈现清晰网格底纹，主体内容以色块方式填充网格，色彩降维为有限的绣线色号，边缘保留标注边距，整体工整、方正、色彩分明、具有工程图纸的严谨感。
7. 轮询图纸图像生成状态（step_6）：以5秒间隔轮询生图任务状态（超时上限1200秒），直至 task_status 为 SUCCEEDED，取回图纸图像URL。
8. 最终图纸交付物融合（step_7）：将图纸图像、构图分析、色号对照表、用量统计、规格说明按 structural 策略融合（优先规则：图像色号与表格严格对应优先），输出完整交付包 final_chart_package。

数据流转方式：各步骤通过上游结果引用（upstream_content）按 semantic（语义）、logical（逻辑）、stylistic（风格）、structural（结构）四种策略逐级融合传递；人机协作节点集中在输入侧——用户提供照片与绣布目数规格，其余过程全自动执行，无需人工干预。

技能能力组成流程图

官方流程图快照：

文本可渲染流程图（Mermaid）：

flowchart TD
    A["用户输入：img_url 照片 + grid_density 绣布目数"] --> B["step_0 合规校验优化"]
    B --> C["step_1 原图视觉构图分析<br/>主体识别 / 画面重心 / 推荐比例 / 色彩基调 / 细节密度"]
    C --> D["step_2 色彩降维与DMC色号映射<br/>上限25色，输出DMC调色板"]
    D --> E["step_3 物理用量计算<br/>绣布尺寸 / 总针数 / 各色针数 / 用线量"]
    E --> F["step_4 简体中文标注生成<br/>色号对照表 / 规格说明 / 用量摘要"]
    C --> G["step_5 启动十字绣图纸生图任务<br/>参考图 + 推荐比例"]
    G --> H["step_6 轮询图纸图像生成状态<br/>间隔5秒 / 超时1200秒"]
    H --> I{"task_status 为 SUCCEEDED ?"}
    I -- "否" --> H
    I -- "是" --> J["step_7 最终图纸交付物融合<br/>图像色号与表格严格对应优先"]
    F --> J
    E --> J
    C --> J
    J --> K["输出 final_chart_package<br/>图纸图像 / 标题 / 比例 / 色号对照表 / 用量统计 / 规格 / 构图信息"]

API 信息

接口概览

入参说明

出参说明（final_chart_package）

异常说明

前置准备

• 凭证：配置 ShowAPI AppKey，凭证名称：showapi_appkey
• 鉴权配置：

本 Skill 调用需要 AppKey 鉴权。所有 API 请求的 URL 查询参数中需携带 appKey={你的AppKey}。

如何获取 AppKey

如果你还没有 AppKey，请按以下步骤通过手机验证获取：

1. 请用户提供手机号（中国大陆手机号）
2. 调用发送验证码接口：

“` POST https://www.showapi.com/auth/agent_sendCode Content-Type: application/x-www-form-urlencoded

phone={手机号} “ 成功响应：{"flag":true,"remark":"发送成功"}`

1. 请用户查看手机收到的6位验证码并告诉你
2. 调用验证接口获取 AppKey：

“` POST https://www.showapi.com/auth/agent_verify Content-Type: application/x-www-form-urlencoded

phone={手机号}&code={验证码} “ 成功响应：{"flag":true,"app_key":"你的AppKey"}`

1. 将获取到的 app_key 保存，后续所有 API 调用 URL 中携带 appKey={app_key} 参数

注意事项

• 验证码5分钟有效，每分钟只能发送1次
• 如果手机号已注册过易源数据平台账户，会直接返回该账户的 AppKey，不会重复注册
• AppKey 获取后请妥善保存，避免重复验证
• 模拟体验：无 appKey 时，系统自动触发模拟调用，直接返回完整结果，快速预览生成效果
• 依赖：仅使用 Python 标准库，无需安装第三方包

操作步骤

模拟体验流程（无 appKey）

1. 自动触发模拟调用

系统检测到未配置 appKey 时，自动向 https://www.showapi.com/_nuxt3/api/2405-105 发送 POST 请求（body: {"flow_id":"6a5722803c51f27b2a00e921"}），直接获取完整模拟生成结果。此过程为一次性返回，不执行 execute_task.py 和 query_task.py。

1. 可视化预览

将返回的 JSON 结果以 HTML 形式可视化展示，重点呈现十字绣格子图纸图像内容。

1. 引导真实调用

提示用户当前为无 appKey 的模拟运行结果。如需真实调用，请通过手机验证获取 AppKey（步骤见「前置准备-鉴权配置」），并在后续所有 API 调用 URL 中携带 appKey={app_key} 参数。

标准流程（有 appKey，强制异步执行）

1. 收集用户需求

请用户提供需要转化的照片（img_url，必填，支持图片URL或Base64编码字符串），并确认绣布目数规格 grid_density（选填，默认14ct，常见可选11ct、16ct、18ct等）。

1. 异步提交生成任务

调用脚本异步执行十字绣图纸生成任务，仅返回唯一 task_id，不阻塞等待。调用示例：

   python scripts/execute_task.py --img-url "https://example.com/family_photo.png" --grid-density "14ct" --async

1. 轮询查询任务结果（必选）

使用 task_id 循环查询任务状态，每一轮轮询后，即时将当前返回的核心资料同步反馈给用户，直至获取完整结果。调用示例：

   python scripts/query_task.py --task-id "返回的task_id值"

1. 等待结果完成

必须轮询直到完成（图纸图像生成阶段通常需1-2分钟，轮询超时上限1200秒）。

1. 结果解析与落地应用

从 final_chart_package 中提取图纸图像URL、画面比例、DMC色号对照表（色号/中文名/针数/线长/分类）、总针数与总用线量、绣布规格与制作提示，按对照表采购DMC绣线即可开始制作。

1. 生成HTML页面

生成一个简单的HTML页面来融合返回的主要信息，特别是十字绣格子图纸图像与色号对照表。

使用示例

示例1：全家福照片转十字绣

• 输入：一张全家福照片，绣布目数14ct
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：全家福格子图纸+DMC色号对照表+总针数/用线量+绣布规格
• 配置要点：img_url 必填；人多细节多时保持默认25色上限，14ct可平衡难度与精细度

示例2：宠物照片个性化挂画

• 输入：一张宠物特写照片，希望做成竖向挂画
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：推荐竖向比例的宠物十字绣图纸+色号采购清单
• 配置要点：由构图分析自动推荐1:1或3:4比例，避免宠物主体被裁切

示例3：风景照片装饰画

• 输入：一张风景照片，希望成品更大更细腻
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：横向比例风景图纸+完整色号对照表与用量统计
• 配置要点：grid_density 可选11ct降低难度，或18ct提升细腻度（针数会相应增加）

生成效果示例

描述

技能运行成功后，以 final_chart_package 结构化交付包呈现结果，包含：

• 图纸图像URL：专业十字绣格子图纸风格图像，呈现清晰网格底纹，主体以色块填充网格，工整方正、色彩分明，具有工程图纸的严谨感
• 图纸标题与画面比例：如"3:4"竖向等，与构图分析推荐一致
• 色号对照表：简体中文标注的DMC色号列表，每行含DMC色号、中文名称、针数、用线量、色彩分类，图像色号与表格严格对应
• 用量统计：总针数、总用线量及绣线准备建议
• 绣布规格说明：绣布规格、绣布尺寸、总网格数及制作提示
• 构图信息：原图内容类型、主体描述及推荐比例

可视化展示时优先呈现图纸图像，再以表格形式呈现色号对照表与用量/规格信息。

输出案例

说明：若输出结果包含图片，优先插入对应图片资源，之后再输出 JSON / Markdown 格式的文本内容。

以下为真实运行生成的十字绣格子图纸效果：

接口返回的核心交付包结构（示意，实际内容随输入照片动态生成）：

{
  "final_chart_package": {
    "chart_title": "全家福十字绣图纸（3:4竖版）",
    "chart_image_url": "https://oss.showapi.com/.../cross_stitch_chart_xxx.png",
    "chart_ratio": "3:4",
    "composition_info": {
      "content_type": "人物合影",
      "subject_description": "画面主体为居中站立的三口之家，背景为暖色黄昏天空，主体集中于画面中下部",
      "recommended_ratio": "3:4"
    },
    "color_legend_table": [
      {"dmc_code": "DMC-310", "chinese_name": "黑色", "stitch_count": "1520", "thread_length": "8.4米", "category": "无彩色系"},
      {"dmc_code": "DMC-739", "chinese_name": "浅驼黄", "stitch_count": "980", "thread_length": "5.4米", "category": "暖色系"},
      {"dmc_code": "DMC-3750", "chinese_name": "灰蓝绿", "stitch_count": "640", "thread_length": "3.5米", "category": "冷色系"}
    ],
    "material_summary": {
      "total_stitches": "12800针",
      "total_thread": "约86米（含10%冗余）",
      "fabric_note": "建议按色号分卡绕线，先绣深色后绣浅色"
    },
    "specification": {
      "fabric_spec": "14ct白色绣布",
      "fabric_size": "约25cm × 33cm（含边距）",
      "grid_total": "140格 × 186格",
      "tips": "从中心起针，每完成一个色区对照图纸核对一次色号"
    }
  }
}

注：以上JSON为字段结构示意，实际色号、针数与用线量以接口真实返回为准。

资源索引

• [scripts/execute_task.py](scripts/execute_task.py)：异步提交十字绣图纸生成任务（真实调用时使用）
• [scripts/query_task.py](scripts/query_task.py)：轮询查询异步任务结果（真实调用时使用）

响应数据结构

1. 异步任务提交响应

{
  "showapi_res_body": {
    "task_id": "唯一任务ID",
    "status": "pending",
    "msg": "任务已提交，正在异步处理中"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

2. 任务查询响应（单轮轮询返回数据，需实时同步给用户）

{
  "showapi_res_body": {
    "final_chart_package": {
      "chart_title": "图纸标题",
      "chart_image_url": "生成的十字绣格子图纸图像访问地址",
      "chart_ratio": "图纸画面的宽高比例（如3:4）",
      "composition_info": {
        "content_type": "原图内容类型",
        "subject_description": "主体描述",
        "recommended_ratio": "推荐比例"
      },
      "color_legend_table": [
        {
          "dmc_code": "DMC色号",
          "chinese_name": "色彩中文名称",
          "stitch_count": "针数",
          "thread_length": "用线量",
          "category": "色彩分类"
        }
      ],
      "material_summary": {
        "total_stitches": "总针数",
        "total_thread": "总用线量",
        "fabric_note": "绣线准备建议"
      },
      "specification": {
        "fabric_spec": "绣布规格",
        "fabric_size": "绣布尺寸",
        "grid_total": "总网格数",
        "tips": "制作提示"
      }
    }
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

注：任务未完成时，返回体中暂无 final_chart_package（可能仅含任务状态信息），需继续轮询直至任务状态为 SUCCEEDED。

注意事项

1. img_url 为必填项，支持图片URL或Base64编码字符串；grid_density 为选填项，默认14ct。
2. 所有任务强制异步执行，不支持同步模式。
3. 轮询查询过程中，每次获取接口返回数据后，立即将主要内容反馈给用户。
4. 图纸图像生成阶段耗时较长（通常1-2分钟，超时上限1200秒），请耐心轮询直至任务完成。
5. 针数与用线量按10英寸基础宽度估算，实际裁剪请保留边距；DMC绣线请严格按色号对照表采购。
6. 本技能单次调用预估费用约0.23元（含模型推理价格），实际以平台计费为准。
7. 模拟运行说明：无 appKey 时系统自动触发模拟调用，一次性返回完整 JSON 结果，不经过 execute_task.py 和 query_task.py，结果仅作效果预览，非真实生成内容。如需真实调用，请通过手机验证获取 AppKey 并配置。