手抄报线稿模板生成

技能文档

---
name: handwritten-newspaper-template-generator-showapi
title: 手抄报线稿模板生成
category: 内容创作
description: "根据主题、年级和画面比例，自动生成符合 A4 打印标准的手抄报黑白线稿模板；支持意图分析、合规校验（如国庆节禁用国旗国徽）、排版策略生成、高清线稿生图与 A4 尺寸适配，交付可直接打印的模板图与预览页。当用户需要完成学校手抄报作业、设计主题黑板报线稿、生成儿童涂色填字模板时触发。触发词：手抄报、线稿模板、涂色模板、黑板报、填字模板、小学生手抄报。"
---

# 手抄报线稿模板生成

根据用户输入的主题、年级和画面比例，快速生成符合 A4 打印标准的手抄报黑白线稿模板。孩子只需涂色和填字即可完成手抄报作业。

## 前置准备

- 凭证：配置数据服务 AppKey（凭证名 `showapi_appkey`）。访问 [https://www.showapi.com](https://www.showapi.com) 注册账号，登录后进入[控制台](https://www.showapi.com/console#/myApp)获取 appKey
- 模拟体验：无 appKey 时自动触发模拟调用，直接返回完整结果，快速预览生成效果
- 依赖：仅使用 Python 标准库，无需安装第三方包

## 技能工作流

### 步骤1：需求收集与合规校验

梳理用户需求，确认三项输入：

- **主题**（必填）：如国庆节、中秋节、植树节、消防日
- **年级段**（必填）：低年级 / 中年级 / 高年级（影响留白比例与插画大小）
- **画面宽高比**（选填）：默认 4:3

对主题自动执行合规性审查，识别并过滤敏感或不适宜元素（如国庆节主题禁用国旗国徽，自动给出红灯笼、祥云纹样、和平鸽等替换建议）。

### 步骤2：选择执行模式

**模拟体验流程（无 appKey）**：

1. 系统检测到未配置 appKey 时，自动触发模拟调用，一次性返回完整模拟生成结果（不执行 execute_task.py 和 query_task.py）
2. 将返回的 JSON 结果以 HTML 形式可视化展示，重点呈现图片内容
3. 提示用户当前为无 appKey 的模拟运行结果，仅作效果预览；如需真实生成，请按「前置准备」获取并配置 appKey

**标准流程（有 appKey，强制异步执行）**：按步骤3-5 执行。

### 步骤3：异步提交生成任务

调用脚本异步执行手抄报线稿生成任务，**仅返回唯一 task_id**，不阻塞等待：

```bash
python scripts/execute_task.py --theme "国庆节" --grade "低年级" --ratio "4:3" --async
```

### 步骤4：轮询查询任务结果（必选）

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

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

必须轮询直到任务完成。

### 步骤5：结果解析与交付

1. 提取标题文字信息、排版策略、合规约束及最终的 A4 适配模板图 URL
2. 生成一个简单的 HTML 页面融合返回的主要信息（特别是图片），便于预览
3. 模板图可直接打印，或用于后续涂色填字

## 使用示例

### 示例1：低年级国庆节手抄报

- 输入：为低年级学生生成一份国庆节主题的手抄报线稿
- 流程：异步提交任务 → 获取 task_id → 轮询查询（每轮反馈进度/数据）
- 产出：符合 A4 打印尺寸的国庆节黑白线稿模板，包含合规约束建议
- 配置要点：theme="国庆节", grade="低年级", ratio="4:3"

### 示例2：高年级中秋节手抄报

- 输入：为高年级学生生成一份中秋节主题的手抄报线稿
- 产出：排版较复杂、留白较少的高清中秋节线稿模板
- 配置要点：theme="中秋节", grade="高年级", ratio="3:4"

### 示例3：中年级植树节手抄报

- 输入：为中年级学生生成一份植树节主题的手抄报线稿
- 产出：适配 A4 打印的植树节线稿模板及排版策略说明
- 配置要点：theme="植树节", grade="中年级", ratio="1:1"

## 生成效果说明

技能运行后，输出一个符合 A4 打印标准的手抄报黑白线稿模板图，同时返回结构化文本信息：

```json
{
  "showapi_res_body": {
    "title_text": {
      "content": "欢度国庆",
      "language": "简体中文",
      "style": "艺术字风格"
    },
    "layout_strategy": {
      "grade_segment": "低年级",
      "overall_description": "整体排版留白较多，插画比例大，包含2个文字区",
      "text_area_count": 2
    },
    "compliance_constraints": {
      "theme": "国庆节",
      "prohibited_elements": ["国旗", "国徽"],
      "replacement_suggestions": ["红灯笼", "祥云纹样", "和平鸽"]
    },
    "template_image_url": "https://oss.showapi.com/path/to/generated/template_image.jpg"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}
```

## 资源索引

- [scripts/execute_task.py](scripts/execute_task.py)：异步提交手抄报线稿生成任务（真实调用时使用）
- [scripts/query_task.py](scripts/query_task.py)：轮询查询异步任务结果（真实调用时使用）

## 响应数据结构

**1. 异步任务提交响应**

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

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

```json
{
  "showapi_res_body": {
    "title_text": {
      "content": "标题内容",
      "language": "简体中文",
      "style": "字体风格"
    },
    "layout_strategy": {
      "grade_segment": "年级段",
      "overall_description": "整体排版描述",
      "text_area_count": 2
    },
    "compliance_constraints": {
      "theme": "主题",
      "prohibited_elements": ["禁用元素列表"],
      "replacement_suggestions": ["替换建议列表"]
    },
    "template_image_url": "A4打印适配手抄报黑白线稿模板图URL"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}
```

## 注意事项

1. theme 和 grade 为必填项，需清晰描述手抄报主题与年级段。
2. 所有任务**强制异步执行**，不支持同步模式。
3. 轮询查询过程中，**每次获取接口返回数据后，立即将主要内容反馈给用户**。
4. 合规约束信息（如国庆节禁用国旗国徽）由系统自动解析并应用于生图过程，替换建议仅供参考。
5. **模拟运行说明**：无 appKey 时系统自动触发模拟调用，一次性返回完整 JSON 结果，结果仅作效果预览，非真实生成内容。

使用说明

# 手抄报线稿模板生成

根据主题、年级和画面比例，一键生成符合 A4 打印标准的手抄报黑白线稿模板，含合规校验与排版策略，孩子涂色填字即可完成作业。

## 使用

```text
为低年级学生生成一份国庆节主题的手抄报线稿模板。
```

```text
生成一份高年级中秋节手抄报，竖版 3:4，排版复杂一点。
```

```text
植树节手抄报模板，中年级，正方形构图。
```

## 工作原理

- **合规校验前置**：自动识别主题敏感元素（如国庆节禁用国旗国徽）并给出替换建议
- **排版策略生成**：按年级段决定留白比例、文字区数量与插画大小
- **异步生图**：提交任务后轮询获取高清黑白线稿，按 A4 打印标准等比适配
- **两种模式**：无 appKey 走模拟体验快速预览；配置 appKey 后走真实生成

## 目录说明

- `SKILL.md` — 主工作流说明与响应结构
- `scripts/execute_task.py` — 异步提交生成任务
- `scripts/query_task.py` — 轮询查询任务结果

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。