517 lines
22 KiB
TypeScript
517 lines
22 KiB
TypeScript
import type {Resource,SkillDocument} from "./catalog";
|
||
|
||
export const shadowPuppetResources:Resource[] = [
|
||
{
|
||
"id": "index",
|
||
"kind": "document",
|
||
"title": "入口文档 · SKILL.md",
|
||
"href": "/skills/shadow-puppet/SKILL.md",
|
||
"human": "/tools/skills/shadow-puppet"
|
||
},
|
||
{
|
||
"id": "workflow",
|
||
"kind": "document",
|
||
"title": "制作流程",
|
||
"href": "/skills/shadow-puppet/workflow.md",
|
||
"human": "/tools/skills/shadow-puppet/workflow"
|
||
},
|
||
{
|
||
"id": "visual-grammar",
|
||
"kind": "document",
|
||
"title": "画面与皮影语法",
|
||
"href": "/skills/shadow-puppet/visual-grammar.md",
|
||
"human": "/tools/skills/shadow-puppet/visual-grammar"
|
||
},
|
||
{
|
||
"id": "prompt",
|
||
"kind": "document",
|
||
"title": "完整提示词",
|
||
"href": "/skills/shadow-puppet/prompt.md",
|
||
"human": "/tools/skills/shadow-puppet/prompt"
|
||
},
|
||
{
|
||
"id": "delivery",
|
||
"kind": "document",
|
||
"title": "验收与上传",
|
||
"href": "/skills/shadow-puppet/delivery.md",
|
||
"human": "/tools/skills/shadow-puppet/delivery"
|
||
},
|
||
{
|
||
"id": "egret-example",
|
||
"kind": "image",
|
||
"title": "白鹭成品示例",
|
||
"href": "/skills/shadow-puppet/egret-example.png"
|
||
},
|
||
{
|
||
"id": "dancer-example",
|
||
"kind": "image",
|
||
"title": "舞者成品示例",
|
||
"href": "/skills/shadow-puppet/dancer-example.png"
|
||
},
|
||
{
|
||
"id": "upload-api",
|
||
"kind": "api",
|
||
"title": "上传独立海报",
|
||
"href": "/api/upload",
|
||
"method": "POST",
|
||
"description": "Agent 完成图片生成与视觉验收后，再使用此接口上传；接口本身不绘图。",
|
||
"detail": {
|
||
"encoding": "multipart/form-data",
|
||
"fields": {
|
||
"kind": "image",
|
||
"title": "必填，海报或系列标题",
|
||
"files": "1–16 个独立 PNG/JPG 成品",
|
||
"description": "原片与提示词记录（可选）",
|
||
"tags": "已有分类 UUID 数组 JSON（可选）",
|
||
"slug": "唯一网址标识（可选）"
|
||
},
|
||
"response": {
|
||
"status": 201,
|
||
"body": {
|
||
"id": "post UUID",
|
||
"slug": "稳定标识",
|
||
"url": "/p/<slug>",
|
||
"assets": [
|
||
"asset UUID"
|
||
]
|
||
}
|
||
},
|
||
"limits": {
|
||
"files": 16,
|
||
"bytesPerFile": 262144000,
|
||
"totalBytes": 1073741824
|
||
},
|
||
"validation": "API 检查上传格式；3:4、上下等分与视觉质量由 Agent 检查"
|
||
}
|
||
},
|
||
{
|
||
"id": "media-api",
|
||
"kind": "api",
|
||
"title": "读取成品原图",
|
||
"href": "/api/media/{asset-id}",
|
||
"method": "GET",
|
||
"template": true,
|
||
"description": "将 {asset-id} 替换为上传返回的素材 UUID，再请求此地址；模板不是可以直接请求的成品地址。",
|
||
"detail": {
|
||
"pathParameter": {
|
||
"asset-id": "上传返回的素材 UUID"
|
||
},
|
||
"response": "原始图片字节；保留原图格式",
|
||
"supports": [
|
||
"GET",
|
||
"HEAD",
|
||
"Range"
|
||
]
|
||
}
|
||
}
|
||
];
|
||
|
||
export const shadowPuppetDocuments:SkillDocument[] = [
|
||
{
|
||
"id": "index",
|
||
"title": "照片入皮影",
|
||
"blocks": [
|
||
{
|
||
"type": "paragraph",
|
||
"text": "把照片里的主角请上幕布，让它用一个姿态演完一整出戏。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "将每张原始照片分别制作成一张 3:4 竖版海报。上半张保留摄影，下半张把同一个主角转译成中国传统皮影戏偶；上下区域严格等高。每张照片独立输出，不将多张照片拼接。"
|
||
},
|
||
{
|
||
"type": "heading",
|
||
"text": "何时使用"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "用于人物、动物、建筑、植物、器物与风景照片的皮影转译。创作由 coding agent 自带的图像生成／编辑工具执行，网站提供文档、参考图与成品上传 API，不执行服务器端模型推理。"
|
||
},
|
||
{
|
||
"type": "heading",
|
||
"text": "输入与参考图"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "先区分原始照片与风格参考。只有原始照片决定主角的身份、结构、姿态和叙事关系。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "- 白鹭成品示例：参考弯颈、抬足与皮影关节的对应方式，以及暖灯透光效果。"
|
||
},
|
||
{
|
||
"type": "links",
|
||
"refs": [
|
||
"egret-example"
|
||
]
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "- 舞者成品示例：参考扬袖姿态如何转译成铆钉连接、镂刻纹样和操纵竹签。"
|
||
},
|
||
{
|
||
"type": "links",
|
||
"refs": [
|
||
"dancer-example"
|
||
]
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "这两张是完成海报，已经含有上下两个区域；不能当成新的原始照片套入上半区，也不能再把它们整张拼进海报。示例用于理解技法；构图比例、留白与主体占比以文字规范为准。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "如果用户只给了完成示例而没有原始照片，可以整理规范与提示词；需要正式生成时，请用户提供原始照片，不编造照片里的主角。只有明确获准时才从示例中截取上半区作为输入。"
|
||
},
|
||
{
|
||
"type": "heading",
|
||
"text": "执行顺序"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "1. 阅读制作流程，逐张识别主角、姿态与配色。"
|
||
},
|
||
{
|
||
"type": "links",
|
||
"refs": [
|
||
"workflow"
|
||
]
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "2. 阅读画面与皮影语法，锁定 3:4、上下 1:1 和一幕一偶。"
|
||
},
|
||
{
|
||
"type": "links",
|
||
"refs": [
|
||
"visual-grammar"
|
||
]
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "3. 使用完整提示词，为每张照片单独调用图像编辑工具。"
|
||
},
|
||
{
|
||
"type": "links",
|
||
"refs": [
|
||
"prompt"
|
||
]
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "4. 按验收与上传检查成品，再将独立图片发布到网站。"
|
||
},
|
||
{
|
||
"type": "links",
|
||
"refs": [
|
||
"delivery"
|
||
]
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "完整资源索引包含本技能的全部子文档、参考图片和 API。参考图片以链接提供，执行时先区分风格参考与原始照片。"
|
||
},
|
||
{
|
||
"type": "heading",
|
||
"text": "完整资源索引"
|
||
},
|
||
{
|
||
"type": "links",
|
||
"refs": [
|
||
"index",
|
||
"workflow",
|
||
"visual-grammar",
|
||
"prompt",
|
||
"delivery",
|
||
"egret-example",
|
||
"dancer-example",
|
||
"upload-api",
|
||
"media-api"
|
||
]
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"id": "workflow",
|
||
"title": "制作流程",
|
||
"blocks": [
|
||
{
|
||
"type": "heading",
|
||
"text": "1. 先建立逐张任务"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "把每张原始照片分配独立编号。多张原片可以连续处理，但每次图像工具调用只对应一张原片，最终每张输出一个独立海报文件。不生成九宫格、联系表或多照片拼贴。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "记录原片文件名、主体识别点、最具表情的姿态、主叙事关系及 2–3 个配色。将成品示例仅作为风格参考，明确区别 edit target 与 style reference。"
|
||
},
|
||
{
|
||
"type": "heading",
|
||
"text": "2. 锁定画板"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "选择工具支持的精确 3:4 尺寸，优先 1536 × 2048 或等比规格；中线严格为 H/2。若工具无法保证精确尺寸和等分，必须在验收时标出并修正，不能把“约 3:4”称为合格。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "先确定上半区如何容纳原始照片。仅在必要时自然扩展环境背景，保持主体身份、结构与姿态；避免以放大裁切牺牲脚、翅膀、手臂、建筑尖顶或重要物件。"
|
||
},
|
||
{
|
||
"type": "heading",
|
||
"text": "3. 为同一主角设计一具戏偶"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "不要机械复制照片纹理。先找最能辨认的轮廓和姿态，再简化成少量活动部件：例如白鹭的弯颈与抬足、舞者的扬袖与重心、建筑的檐线与层叠关系。关节、铆钉、雕纹与竹签都围绕这些特点组织。"
|
||
},
|
||
{
|
||
"type": "heading",
|
||
"text": "4. 独立调用图像工具"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "使用完整提示词，标明原片与示例的不同角色。选择不透明的完整海报背景；本技能不输出透明贴纸。每张原片独立调用并保存。"
|
||
},
|
||
{
|
||
"type": "links",
|
||
"refs": [
|
||
"prompt"
|
||
]
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "只对失败点做针对性修改：例如上半区身份偏移、分界偏离中线、戏偶过大、关节不合理、缺少竹签、灯光像聚光舞台或出现多余人物。修改时再次锁定其他正确内容。"
|
||
},
|
||
{
|
||
"type": "heading",
|
||
"text": "5. 验收并发布"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "按照验收与上传确认尺寸、等分、主体保真与皮影语法。先检查，再上传。记录实际使用的提示词、工具和原片映射，供以后复现与重做。"
|
||
},
|
||
{
|
||
"type": "links",
|
||
"refs": [
|
||
"delivery"
|
||
]
|
||
},
|
||
{
|
||
"type": "links",
|
||
"refs": [
|
||
"index"
|
||
]
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"id": "visual-grammar",
|
||
"title": "画面与皮影语法",
|
||
"blocks": [
|
||
{
|
||
"type": "heading",
|
||
"text": "尺寸是硬约束"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "完整海报宽高比为 3:4，竖版。上下区域高度严格 1:1，各占全图 50%。例如 1536 × 2048 像素，上半区 y=0–1023，下半区 y=1024–2047；分界线位于 y=1024。不得因为题字、边框或留白改变两区高度。两个区块横向铺满画幅，不在外层额外增加标题栏或页脚。"
|
||
},
|
||
{
|
||
"type": "heading",
|
||
"text": "上半区：原始照片"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "保留主体身份、结构、姿态、真实材质、自然光影与原有色彩氛围。仅进行轻微高级调色，呈现艺术摄影与东方展览图像质感。适配宽幅半区时，优先自然扩展周围环境，保持主体完整；不得拉伸、扭曲、改脸、改变肢体或裁掉最具识别度的动作。禁止把摄影区也做成皮影、插画或 3D。"
|
||
},
|
||
{
|
||
"type": "heading",
|
||
"text": "下半区：被老手艺人重新理解的角色"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "从照片提取最具识别性的主体、轮廓、姿态与叙事关系。无论原图是人物、动物、建筑、植物、器物还是风景，都理解为可被操纵的一个角色。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "- 用少量平面关节部件概括，以可见铆钉相连。关节服务于原图动作，不能任意拼接。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "- 侧面化、平面化；使用装饰性镂空、云纹与几何雕刻纹样，以及局部半透明彩染。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "- 一两根细长操纵竹签从下边缘伸入并合理连接。不要额外加入操偶人。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "- 一幕一偶与大量留白。主角约占幕布画面 25%–35%，其余空间保持安静；可偏心或靠黄金分割位置。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "- 对建筑、植物和风景，选择照片最具识别性的整体轮廓及关系，把它概括为一具能够活动的戏偶；不要加入无关的人物或堆满一套风景舞台。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "- 照片里有多个主体时，先确定主叙事；若无法在一偶中保留关键关系，先确认创作取舍，不擅自删掉关系核心。"
|
||
},
|
||
{
|
||
"type": "heading",
|
||
"text": "灯、纸与颜色"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "下半区是在暖光照亮的半透明宣纸幕布上演出，不是摆在台面上的皮影工艺品。幕布呈米黄或浅琥珀光场，四周自然暗下。后方一盏暖灯照透镂空处，形成温暖光点；皮影边缘具有柔和投影虚边和轻微光晕。允许极轻微双影或动态虚影，像缓慢移动中的一瞬间。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "从原照片提取 2–3 种最具情绪价值的颜色，转译成朱红、靛青、橄榄绿、琥珀黄体系内协调的半透明彩染；不必强行集齐全部颜色。阴影使用深褐与暖墨色，避免冷黑。"
|
||
},
|
||
{
|
||
"type": "heading",
|
||
"text": "文字可选"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "可在幕布一角用少量安静的竖排小字写戏名或短句，像手写节目单。文字不是必需。用户没有指定文案时，宁可无字，也不生成无意义书法、乱码或大标题。"
|
||
},
|
||
{
|
||
"type": "heading",
|
||
"text": "避免"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "完整写实的下半区、卡通化、廉价国潮、模板化海报、塑料质感、3D 渲染、满场景堆砌、观众、舞台全景、复杂道具。摄影与皮影都必须来自同一张原始照片，不混入另一张照片的主体。"
|
||
},
|
||
{
|
||
"type": "links",
|
||
"refs": [
|
||
"index"
|
||
]
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"id": "prompt",
|
||
"title": "完整提示词",
|
||
"blocks": [
|
||
{
|
||
"type": "paragraph",
|
||
"text": "以下提示词每次只对应一张原始照片。将方括号字段替换为当前照片信息，生成前删除不使用的可选题字。"
|
||
},
|
||
{
|
||
"type": "code",
|
||
"text": "任务：将本次提供的这一张原始照片制作成一张独立的高级设计海报，不多图拼接。输出 3:4 竖版，尺寸 [1536×2048 或工具支持的精确等比尺寸]。上下两个区域高度严格 1:1，各占全图 50%；水平分界位于画面高度的 50%。两个区域横向铺满，外层没有额外页眉、页脚或改变等分的边框。\n\n输入角色：\n- 原始照片（编辑目标）：[原片文件名或链接]。本海报中的所有主体与叙事来自这一张照片。\n- 风格参考（如提供）：[白鹭／舞者成品示例链接]。它们已经是完成的海报，只参考皮影技法和光感，不复制主体，不将示例整图放进上半区。\n\n原片观察：\n- 主体与不可改变的识别点：[身份、结构、轮廓与关键物件]\n- 最有表情的瞬间：[姿态、朝向、重心与动作]\n- 核心叙事关系：[主体之间或主体与环境的关系]\n- 2–3 种情绪色：[从本张照片中提取]\n\n上半部分：保留原始照片，保持主体身份、结构、姿态、真实质感、自然光影与原有色彩氛围。仅轻微高级调色，具有艺术摄影与东方展览图像质感。适配画幅时可自然扩展环境背景，禁止拉伸、扭曲、改脸、增减肢体或改变主体。保持关键动作完整；上半区仍然是照片。\n\n下半部分：提取同一原片最具识别性的主体、轮廓、姿态与叙事关系，重构为一具中国传统皮影戏偶（shadow puppet），正在一面暖光照亮的半透明宣纸幕布上演出。无论原图是人物、动物、建筑、植物、器物还是风景，都将它理解为可被操纵的一个角色。主体拆分为少量合理关节部件，以铆钉相连，姿态取自照片最有表情的瞬间；一两根细长的操纵竹签自画面下方伸入并连接戏偶。\n\n用皮影的造型语法重新概括，而非写实复制或卡通化：侧面化、平面化、装饰性镂空、云纹与几何雕刻纹样、局部半透明彩染。保留原物最具识别度的特征，使人一眼认出，同时像被老手艺人重新理解和雕刻过。\n\n光影：幕布后方一盏暖色灯光，镂空处透出温暖光点。照片中的情绪色转译为半透明的朱红、靛青、橄榄绿或琥珀黄，不必使用全部颜色。边缘带柔和投影虚边与轻微光晕，可有极轻微双影或动态虚影，像缓慢演出中的一瞬间。阴影用深褐与暖墨，不用冷黑。\n\n下半区构图：一幕一偶、大量留白。米黄或浅琥珀色暖光场，四周自然暗下。戏偶主体约占幕布画面的 25%–35%，可偏心或位于黄金分割位置，其余空间安静，如戏开场前的停顿。不出现观众、操偶人、舞台全景或复杂道具。\n\n文字：[可选：在幕布一角竖排少量小字“用户指定戏名或短句”]。未指定文案则无字，不添加主标题、广告文字、乱码或无意义书法。\n\n最终呈现：皮影镂刻、半透明彩染、暖灯幕布、柔和投影与东方留白共同构成光影视觉。核心原则：把照片里的主角请上幕布，让它用一个姿态演完一整出戏。\n\n禁止：多照片拼贴、上下比例偏移、主体身份改变、下半区完整写实、卡通、廉价国潮、塑料质感、3D 渲染、满场景堆砌、模板化海报。每张原始照片单独输出一个完整海报文件，画布背景不透明。"
|
||
},
|
||
{
|
||
"type": "links",
|
||
"refs": [
|
||
"index"
|
||
]
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"id": "delivery",
|
||
"title": "验收与上传",
|
||
"blocks": [
|
||
{
|
||
"type": "heading",
|
||
"text": "画面验收"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "- 文件为独立 3:4 竖版海报。可检查 width × 4 === height × 3，且 height 为偶数。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "- 摄影与皮影区的分界位于 height / 2。仅有正确文件尺寸不足以证明上下等分，仍需查看画面。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "- 上半区保留同一原片主体身份、结构、姿态、自然质感和配色；没有被重新画成插画。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "- 下半区是同一主角的一具皮影，轮廓与动作可辨，有合理的关节铆钉及一两根从下缘伸入的竹签。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "- 镂空透暖光、彩染半透明、纸幕材质明确、投影柔软，留白充足；没有观众、复杂舞台、3D 或卡通。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "- 每张原片对应一个独立成品，没有多照片拼贴。题字若有，必须可读且符合指定内容。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "本技能的整张海报背景不透明。不要使用「街头小人」的透明 PNG 专用接口；该接口针对另一种交付要求。"
|
||
},
|
||
{
|
||
"type": "heading",
|
||
"text": "上传 API"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "使用网站通用接口 POST /api/upload，编码为 multipart/form-data。请求字段："
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "- kind=image。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "- title：必填，当前海报或系列标题。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "- files：独立海报文件。PNG 或 JPG；一张照片输出一个文件。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "- description：可选，记录原片标识、提示词、生成工具与制作说明。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "- tags：可选，已有分类 UUID 数组的 JSON；没有分类时使用 [] 或不传。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "- slug：可选，唯一的小写英文、数字和连字符标识。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "默认每张照片一份独立海报；如果用户要求组成系列，可以把多个独立海报文件作为同一 post 的多图上传，文件仍必须逐张独立。不要为凑系列把它们拼在同一张图片里。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "单次最多 16 个文件，单个不超过 250 MB，总计不超过 1 GB。上传接口校验文件格式；3:4、上下等分与视觉质量由 Agent 在上传前验收，不宣称接口自动识别构图。"
|
||
},
|
||
{
|
||
"type": "code",
|
||
"text": "# BASE 为当前 PROMPT 网站的根地址\ncurl -X POST \"$BASE/api/upload\" \\\n -F 'kind=image' \\\n -F 'title=照片入皮影 · 戏名' \\\n -F 'description=原片：photo-01；每张单独制作；已检查3:4与上下等分。' \\\n -F 'files=@photo-01-shadow-puppet.png;type=image/png'"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "成功返回 201，包含 id、slug、url 和 assets。用返回的 url 打开 post；assets 为可复用素材 ID。引用或下载原图使用 GET /api/media/<asset-id>。"
|
||
},
|
||
{
|
||
"type": "paragraph",
|
||
"text": "400 表示表单或文件格式不符合要求，409 表示 slug 已存在，413 表示文件数量或大小超限，500 表示服务或存储异常。失败时不重复盲传；先检查错误。给用户回报真实的文件、post 地址与已完成的检查，不把推送成功当成生产上传成功。"
|
||
},
|
||
{
|
||
"type": "links",
|
||
"refs": [
|
||
"upload-api",
|
||
"media-api",
|
||
"index"
|
||
]
|
||
}
|
||
]
|
||
}
|
||
];
|