# product-history-poster

> 基于用户提供的产品名称，自动生成产品发展历史的博物馆级3D信息图海报（16:9）。使用Gemini Image生成API创建包含完整时间线、技术规格、材质演变的高密度视觉设计。支持任意产品类型，从消费电子到潮流玩具。触发词：调用产品历史海报、生成产品历史海报、创建产品发展史 当用户需要生成展示产品历史发展的视觉海报、信息图或时间线图表时激活

- Author: will
- Repository: jetsons-zz/karma_public_skills
- Version: 20260129124922
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/jetsons-zz/karma_public_skills
- Web: https://mule.run/skillshub/@@jetsons-zz/karma_public_skills~product-history-poster:20260129124922

---

---
name: product-history-poster
description: "基于用户提供的产品名称，自动生成产品发展历史的博物馆级3D信息图海报（16:9）。使用Gemini Image生成API创建包含完整时间线、技术规格、材质演变的高密度视觉设计。支持任意产品类型，从消费电子到潮流玩具。触发词：调用产品历史海报、生成产品历史海报、创建产品发展史 当用户需要生成展示产品历史发展的视觉海报、信息图或时间线图表时激活"
license: MIT
compatibility: 需要访问Google Gemini Image API (Gemini 2.0 Flash Image或更高版本)。建议使用支持高分辨率图像生成的环境。
metadata:
  homepage: "https://ai.google.dev/gemini-api"
  repository: 
  tags:
    - 图像生成
    - 信息图
    - 3D渲染
    - 时间线
    - 产品设计
    - Gemini
  language: JavaScript
allowed-tools:
  - Read
  - Write
  - Bash
  - WebSearch
  - WebFetch
  - AskUserQuestion
---

# 产品历史海报

基于用户提供的产品名称，自动生成产品发展历史的博物馆级3D信息图海报（16:9）。使用Gemini Image生成API创建包含完整时间线、技术规格、材质演变的高密度视觉设计。支持任意产品类型，从消费电子到潮流玩具。触发词：调用产品历史海报、生成产品历史海报、创建产品发展史

## 使用场景

当用户需要生成展示产品历史发展的视觉海报、信息图或时间线图表时激活

**触发关键词:** 产品历史海报, 产品发展史, 产品时间线海报, 历史海报, 生成产品历史海报, 创建产品发展史, 使用产品历史海报, 运行产品历史海报, 执行产品历史海报, 调用产品历史海报

**激活模式:**
- `生成.*产品.*历史.*海报`
- `创建.*发展史.*海报`
- `.*产品.*时间线`

## 使用说明

=== 产品历史海报技能参考文档 ===

[核心技术]
本技能基于Google Gemini Image Generation API实现，使用Gemini 2.0 Flash Image模型生成高质量产品历史海报。

[提示词结构]
生成的提示词包含以下核心模块：
1. 角色与主题定义：16:9 3D信息图海报，博物馆级产品摄影风格
2. 英雄系列（时间线）：8-12个历史版本的产品，按时间顺序排列
3. 品牌氛围：深邃的品牌色背景，水印专利图纸和历史元素
4. 超密集信息层（PUNCH风格）：包含注释网络、情境区、放大镜头、技术规格条
5. 技术参数：Octane渲染、虚幻引擎5美学、体积光照

[API调用流程]
1. 接收用户输入的产品名称
2. 询问用户品牌色彩偏好和材质风格（可选）
3. 构建结构化提示词，替换[产品名称]、[品牌色彩]、[Material Vibe]等变量
4. 调用Gemini Image API生成16:9比例的高分辨率海报
5. 返回生成的图像并提供下载选项

[提示词优化技巧]
- 使用'museum-grade product photography'确保质感
- 强调'timeline'、'chronological order'保证时间顺序
- 添加'hyper-realistic 3D'、'8K resolution'提升细节
- 使用'PUNCH style'、'data aesthetics'创建信息密集效果
- 指定'volumetric lighting'、'sharp focus'增强视觉冲击力

[变量说明]
- [产品名称]：用户输入的核心产品（如'泡泡玛特'、'iPhone'、'特斯拉'）
- [品牌色彩]：品牌主色调（如'teal'、'space gray'、'red'）
- [Material Vibe]：早期材质风格（如'plastic'、'metal'、'wood'）
- [关键组件]：产品特征部件（如'curves'、'buttons'、'engine'）

## 功能概述

产品历史海报是一个智能化的AI助手技能。基于用户提供的产品名称，自动生成产品发展历史的博物馆级3D信息图海报（16:9）。使用Gemini Image生成API创建包含完整时间线、技术规格、材质演变的高密度视觉设计。支持任意产品类型，从消费电子到潮流玩具。触发词：调用产品历史海报、生成产品历史海报、创建产品发展史

该技能通过自然语言理解技术，能够准确识别用户意图并提供专业的处理结果。无论是简单的查询还是复杂的分析任务，都能提供高质量的输出。


## 详细使用指南

### 基本用法

1. **激活技能**: 通过相关关键词或直接描述您的需求来激活此技能
2. **提供输入**: 清晰地描述您的任务或问题，提供必要的上下文信息
3. **获取结果**: AI 将处理您的请求并返回详细的结果

### 进阶用法

- 对于复杂任务，可以分步骤描述需求
- 可以指定输出格式和详细程度
- 支持追问和结果优化


## 最佳实践

### 输入建议

- **清晰具体**: 描述需求时尽量清晰具体，避免模糊表述
- **提供上下文**: 包含必要的背景信息，帮助 AI 更好地理解需求
- **明确期望**: 如需特定格式输出，请在请求中说明

### 效率优化

- 一次性提供完整信息可以减少交互次数
- 复杂任务可以拆分为多个小任务
- 善用示例来说明期望的输出格式


## 功能特点

- **智能识别**: 自动识别用户意图，匹配最合适的处理方式
- **灵活适应**: 支持多种输入格式和表述方式
- **专业输出**: 提供结构化、专业化的处理结果
- **持续学习**: 基于用户反馈不断优化表现


## 常见应用场景

### 场景一：快速查询
当您需要快速获取信息或解答疑问时，可以直接向技能提问。

### 场景二：内容处理
当您需要处理、转换或分析内容时，提供原始内容和期望的处理方式。

### 场景三：创意生成
当您需要创意支持或内容创作时，描述您的需求和偏好。


## 注意事项

- 确保输入内容符合技能的处理范围
- 复杂任务可能需要更长的处理时间
- 如结果不满意，可以提供更多细节重新尝试
- 对于敏感信息，请注意隐私保护


## 技术说明

此技能基于先进的自然语言处理技术，结合领域知识库，能够提供专业、准确的处理结果。系统会根据输入内容自动选择最优的处理策略，确保输出质量。

## 示例

### 基础使用

**用户输入:**
```
请使用产品历史海报帮我完成任务
```

**预期输出:**
```
AI 识别到用户需要产品历史海报的功能，激活相应技能并执行任务
```

### 带参数调用

**用户输入:**
```
帮我基于用户提供的产品名称，自动生成产品发展，要求输出详细结果
```

**预期输出:**
```
AI 根据用户的详细要求，提供完整的执行结果和必要的说明
```

### 实际场景应用

**用户输入:**
```
我需要产品历史海报来处理我的工作内容
```

**预期输出:**
```
AI 理解用户的工作场景，提供针对性的解决方案和建议
```

## 资源文件

### 参考文档

- `resources/gemini-image-guide.md`: Google AI官方的图像生成API使用文档，包含最佳实践和提示词工程技巧
- `resources/prompt-engineering.md`: 信息图和技术海报的提示词设计最佳实践
- `resources/api-reference.md`: 完整的API端点、参数和响应格式说明

### 脚本

- `undefined`: 核心海报生成脚本，调用Gemini API并处理图像输出

### 模板

- `undefined`: 可自定义的提示词模板，支持变量替换

## 常见问题

**问: 生成的海报中产品版本数量不够怎么办？**

答: 可以在提示词中明确指定数量，如'precisely 12 versions spanning from 2008 to 2024'。如果产品历史较短，可以包含概念设计或未来预测版本来填充时间线。

**问: 如何确保生成的海报符合品牌视觉规范？**

答: 在调用时明确指定品牌色（使用具体色彩名称或hex值），并在提示词中添加品牌关键词，如'Apple minimalist aesthetic'或'Tesla futuristic design language'。可以在negativePrompt中排除不符合品牌调性的元素。

**问: 生成的图像信息密度不够或过于拥挤？**

答: 调整提示词中的'ULTRA-DENSE'描述强度。信息过少时，增加'hundreds of annotations'、'complex data layers'等描述；过于拥挤时，使用'organized information hierarchy'、'clean margins'来平衡。

**问: 如何处理没有明确历史版本的新产品？**

答: 可以调整为'产品线海报'模式，展示同一品牌下的不同产品型号，或者创建'概念演变'海报，展示从草图到成品的设计过程。

**问: 生成的海报语言不是中文怎么办？**

答: Gemini Image主要基于视觉生成，文字部分可能显示英文。如需中文标题和注释，可以在后期使用图像编辑工具添加，或在提示词中明确要求'Chinese text labels and annotations'。

**问: API调用失败或返回错误？**

答: 常见原因：1) API密钥未配置或过期；2) 提示词包含违禁内容触发安全过滤；3) 超出配额限制。检查环境变量GEMINI_API_KEY，查看API响应中的error字段获取详细错误信息。

## 调试指南

[调试指南]

1. API连接问题
   - 检查环境变量：echo $GEMINI_API_KEY
   - 验证API访问：curl -H 'x-goog-api-key: YOUR_KEY' https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash-exp
   - 确认网络连接和代理设置

2. 提示词优化
   - 使用--verbose标志查看完整提示词
   - 如果结果不理想，尝试调整关键词强度（增加描述性形容词）
   - 使用negativePrompt排除不想要的元素
   - 参考examples中的成功案例

3. 图像质量问题
   - 确保使用gemini-2.0-flash-exp或更高版本模型
   - 检查aspectRatio是否设置为16:9
   - 如果分辨率不足，在提示词中强调'8K resolution'、'ultra high definition'

4. 内容安全过滤
   - 如果触发安全过滤，检查产品名称是否包含敏感词
   - 调整safetySettings参数（谨慎使用）
   - 使用更中性的描述替换可能引发过滤的词汇

5. 性能优化
   - 单次生成建议设置numberOfImages为1
   - 使用缓存机制避免重复生成相同产品
   - 异步处理多个生成请求

---

## 元数据

| 字段 | 值 |
|------|----|
| 版本 | 1.0.0 |
| 作者 | Anonymous |
| 分类 | 创意设计, 图像生成 |
| 技能类型 | 图像生成, 创意工具 |

## 更新日志

- **v1.0.0** (2026-01-22): added - 初始版本发布，支持基于产品名称生成16:9历史海报，集成Gemini Image API