Add street people skill API and two transparent character packs
PROMPT Docker CI and deployment / verify-and-deploy (push) Successful in 13m3s
PROMPT Docker CI and deployment / verify-and-deploy (push) Successful in 13m3s
This commit is contained in:
@@ -6,7 +6,7 @@ const groups=[
|
||||
{label:'',items:[{href:'/',label:'首页',icon:Grid2X2}]},
|
||||
{label:'素材',items:[{href:'/images',label:'图片',icon:Image},{href:'/videos',label:'视频',icon:Film},{href:'/audio',label:'声音',icon:AudioLines}]},
|
||||
{label:'作品',items:[{href:'/articles',label:'图文',icon:BookOpen},{href:'/motion',label:'动态',icon:Clapperboard}]},
|
||||
{label:'工具',items:[{href:'/library/assets',label:'素材库',icon:Layers},{href:'/library/tags',label:'分类管理',icon:Tags},{href:'/tools/doodle',label:'线条工具',icon:Sparkles}]},
|
||||
{label:'工具',items:[{href:'/library/assets',label:'素材库',icon:Layers},{href:'/library/tags',label:'分类管理',icon:Tags},{href:'/tools/doodle',label:'线条工具',icon:Sparkles},{href:'/tools/skills',label:'技能',icon:BookOpen}]},
|
||||
];
|
||||
export function Shell({children}:{children:ReactNode}){
|
||||
const router=useRouter();const [open,setOpen]=useState(false);const [query,setQuery]=useState(String(router.query.q||''));
|
||||
|
||||
@@ -8,6 +8,7 @@ export function apiError(res: NextApiResponse,error: unknown) {
|
||||
if(error instanceof ZodError) return res.status(400).json({error:"请检查输入内容",issues:error.issues});
|
||||
const message=error instanceof Error?error.message:"";
|
||||
const clientMessages:Record<string,string>={
|
||||
'Character PNG must have transparency':'请上传带真实透明背景的 PNG,透明区域 alpha 为 0,人物内部 alpha 至少为 250',
|
||||
'Register the coded page before creating its post':'请先在代码中注册对应的作品页面',
|
||||
'Referenced asset does not exist':'引用的素材不存在',
|
||||
'A media post needs matching content':'素材包需要包含对应类型的素材',
|
||||
|
||||
@@ -0,0 +1,11 @@
|
||||
import sharp from "sharp";
|
||||
import {streetPeople} from "./street-people";
|
||||
export async function validateCharacter(path:string) {
|
||||
try {
|
||||
const input=sharp(path,{limitInputPixels:streetPeople.limits.pixels});
|
||||
const meta=await input.metadata();
|
||||
if(meta.format!=="png"||!meta.hasAlpha)throw new Error("Character PNG must have transparency");
|
||||
const stats=await input.stats();const alpha=stats.channels.at(-1)!;
|
||||
if(alpha.min!==0||alpha.max<250)throw new Error("Character PNG must have transparency");
|
||||
}catch{throw new Error("Character PNG must have transparency");}
|
||||
}
|
||||
@@ -0,0 +1,33 @@
|
||||
export const streetPeople = {
|
||||
id: "street-people", version: "1.0.0", name: "街头小人", description: "松散笔触、冬日衣着与奶油色剪纸边的街头人物。",
|
||||
prompt: "Draw ONE original full-body street person: {{subject}}. Naive observational felt-tip pen sketch; loose irregular dark plum, cobalt blue OR coral red lines; sparse facial features; adult proportions; simple winter clothes; scribbled hatching on hair and trousers. Ivory cream paper inside the silhouette and a narrow uneven cut-paper border. Center the entire figure and accessories, with transparent padding. True RGBA transparency outside the cutout. Hard die-cut edge, zero glow, zero feathering. No cast shadow, no background, no text, no other people, no polished vector, no anime.",
|
||||
workflow: ["读取本接口的风格规范,将 {{subject}} 替换为人物动作与衣着。", "使用 agent 自己的图片生成工具,明确启用 transparent background;每张只生成一个人物。", "检查人物完整、画风和 alpha 通道;最多 16 张 PNG 通过同一 POST 请求上传,组成一个素材包。", "使用返回的 url 查看 post,assets 为可复用的素材 ID。"],
|
||||
generation: { executor: "coding-agent", serverSideModel: false, reference: "/skills/street-people/reference.png", transparentBackground: true },
|
||||
upload: { method: "POST", endpoint: "/api/skills/street-people", encoding: "multipart/form-data", fields: { files: "1–16 张真实透明 PNG,每张一个完整人物;外部 alpha=0,内部 alpha≥250", title: "素材包标题(可选)", description: "提示词、生成来源和补充说明(可选)", tags: "分类 UUID 数组的 JSON(可选)", slug: "唯一小写英文网址标识(可选)" }, response: { id:"post UUID", slug:"稳定标识", url:"/p/<slug>", assets:["asset UUID"] } },
|
||||
limits: { files:16, bytesPerFile:262144000, totalBytes:1073741824, pixels:40000000 },
|
||||
errors: { 400:"PNG 格式、透明通道或表单不符合规范", 409:"slug 已存在,请查看已有 post 或更换 slug", 413:"文件数或体积超过限制", 500:"存储或服务器暂不可用" }
|
||||
} as const;
|
||||
export function skillMarkdown(){return `# ${streetPeople.name}
|
||||
|
||||
${streetPeople.description}
|
||||
|
||||
由 coding agent 使用自己的绘图工具生成,网站负责校验、存储与发布。服务器不执行模型调用。
|
||||
|
||||
## 提示词
|
||||
|
||||
${streetPeople.prompt}
|
||||
|
||||
## 流程
|
||||
|
||||
${streetPeople.workflow.map((s,i)=>`${i+1}. ${s}`).join("\n")}
|
||||
|
||||
## 上传
|
||||
|
||||
POST /api/skills/street-people(multipart/form-data)
|
||||
|
||||
${Object.entries(streetPeople.upload.fields).map(([k,v])=>`- ${k}: ${v}`).join("\n")}
|
||||
|
||||
GET /api/skills/street-people 返回完整 JSON 规范。参考图:${streetPeople.generation.reference}
|
||||
|
||||
成功返回 201:id、slug、url、assets。原图提取与新生成作品必须分成两个 post,不混入同一包。
|
||||
`;}
|
||||
@@ -0,0 +1,15 @@
|
||||
import type {NextApiRequest,NextApiResponse} from "next";
|
||||
import {upload} from "../upload";
|
||||
import {streetPeople,skillMarkdown} from "@/lib/street-people";
|
||||
import {validateCharacter} from "@/lib/character-image";
|
||||
export const config={api:{bodyParser:false}};
|
||||
export default async function handler(req:NextApiRequest,res:NextApiResponse){
|
||||
res.setHeader("Allow","GET, POST");
|
||||
if(req.method==="GET"){
|
||||
res.setHeader("Cache-Control","public, max-age=300");
|
||||
if(req.query.format==="md")return res.setHeader("Content-Type","text/markdown; charset=utf-8").status(200).send(skillMarkdown());
|
||||
return res.status(200).json(streetPeople);
|
||||
}
|
||||
if(req.method==="POST")return upload(req,res,{validateImage:validateCharacter,defaultTitle:"街头小人 · 新生成"});
|
||||
return res.status(405).json({error:"使用 GET 读取规范,POST 上传 PNG 素材包"});
|
||||
}
|
||||
+10
-5
@@ -10,7 +10,8 @@ import { putFile,removeObject } from "@/lib/storage";
|
||||
import { probe } from "@/lib/probe";
|
||||
import { sameOrigin,apiError } from "@/lib/api";
|
||||
export const config={api:{bodyParser:false}};
|
||||
export default async function handler(req:NextApiRequest,res:NextApiResponse){
|
||||
export type UploadPolicy = { validateImage?: (path:string) => Promise<void>; defaultTitle?:string };
|
||||
export async function upload(req:NextApiRequest,res:NextApiResponse,policy:UploadPolicy={}){
|
||||
if(req.method!=='POST')return res.status(405).end();
|
||||
const temporary:string[]=[];const uploaded:string[]=[];
|
||||
try{
|
||||
@@ -18,8 +19,9 @@ export default async function handler(req:NextApiRequest,res:NextApiResponse){
|
||||
const form=formidable({maxFileSize:250*1024*1024,maxTotalFileSize:1024*1024*1024,maxFiles:16,allowEmptyFiles:false});
|
||||
form.on('fileBegin',(_name,file)=>temporary.push(file.filepath));
|
||||
const [fields,files]=await form.parse(req);
|
||||
const kind=z.enum(['image','video','audio']).parse(fields.kind?.[0]);
|
||||
const title=z.string().trim().min(1).max(200).parse(fields.title?.[0]);
|
||||
const kind=z.enum(['image','video','audio']).parse(policy.validateImage?'image':fields.kind?.[0]);
|
||||
const title=z.string().trim().min(1).max(200).parse(fields.title?.[0]||policy.defaultTitle);
|
||||
const slug=z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/).max(120).optional().parse(fields.slug?.[0]);
|
||||
const description=z.string().trim().max(100000).parse(fields.description?.[0]||'');
|
||||
const tagIds=z.array(z.uuid()).max(50).parse(JSON.parse(fields.tags?.[0]||'[]'));
|
||||
const items=Object.values(files).flat().filter(Boolean) as File[];
|
||||
@@ -28,6 +30,7 @@ export default async function handler(req:NextApiRequest,res:NextApiResponse){
|
||||
for(const file of items){
|
||||
let mime='';let width:number|undefined,height:number|undefined,duration:number|undefined,hasAudio:boolean|null=null;
|
||||
if(kind==='image'){
|
||||
if(policy.validateImage)await policy.validateImage(file.filepath);
|
||||
const meta=await sharp(file.filepath,{limitInputPixels:100000000}).metadata();
|
||||
const formats:Record<string,string>={jpeg:'image/jpeg',png:'image/png',webp:'image/webp',gif:'image/gif',avif:'image/avif'};
|
||||
mime=formats[meta.format||''];if(!mime)throw new Error('Unsupported image format');width=meta.width;height=meta.height;
|
||||
@@ -43,7 +46,7 @@ export default async function handler(req:NextApiRequest,res:NextApiResponse){
|
||||
}
|
||||
const postId=randomUUID();
|
||||
await transaction(async client=>{
|
||||
await client.query('INSERT INTO posts(id,slug,kind,title) VALUES($1,$2,$3,$4)',[postId,postId,kind,title]);
|
||||
await client.query('INSERT INTO posts(id,slug,kind,title) VALUES($1,$2,$3,$4)',[postId,slug||postId,kind,title]);
|
||||
for(const [position,a] of records.entries()){
|
||||
await client.query('INSERT INTO assets(id,kind,filename,storage_key,mime_type,byte_size,sha256,width,height,duration,has_audio,processing_status) VALUES($1,$2,$3,$4,$5,$6,$7,$8,$9,$10,$11,$12)',[a.id,kind,a.filename,a.key,a.mime,a.size,a.hash,a.width,a.height,a.duration,a.hasAudio,kind==='video'?'pending':'ready']);
|
||||
await client.query('INSERT INTO post_assets(post_id,asset_id,position) VALUES($1,$2,$3)',[postId,a.id,position]);
|
||||
@@ -53,7 +56,9 @@ export default async function handler(req:NextApiRequest,res:NextApiResponse){
|
||||
if(description){const id=randomUUID();await client.query("INSERT INTO assets(id,kind,body) VALUES($1,'text',$2)",[id,description]);await client.query("INSERT INTO post_assets(post_id,asset_id,position,role) VALUES($1,$2,$3,'caption')",[postId,id,records.length]);}
|
||||
for(const tag of new Set(tagIds))await client.query('INSERT INTO post_tags(post_id,tag_id) VALUES($1,$2)',[postId,tag]);
|
||||
});
|
||||
uploaded.length=0;return res.status(201).json({id:postId,slug:postId,assets:records.map(a=>a.id)});
|
||||
uploaded.length=0;return res.status(201).json({id:postId,slug:slug||postId,url:`/p/${slug||postId}`,assets:records.map(a=>a.id)});
|
||||
}catch(e){if(e instanceof Error && (/maxFileSize|maxTotalFileSize|maxFiles/.test(e.message)))return res.status(413).json({error:'最多 16 个文件,单个不超过 250 MB,总计不超过 1 GB'});return apiError(res,e);}
|
||||
finally{await Promise.allSettled(temporary.map(p=>rm(p,{force:true})));await Promise.allSettled(uploaded.map(removeObject));}
|
||||
}
|
||||
|
||||
export default upload;
|
||||
|
||||
@@ -0,0 +1,5 @@
|
||||
import Head from "next/head";
|
||||
import Link from "next/link";
|
||||
import {ArrowUpRight} from "lucide-react";
|
||||
import {Shell} from "@/components/Shell";
|
||||
export default function Skills(){return <Shell><Head><title>技能 · PROMPT</title></Head><header className="page-header"><div><h1>技能</h1><p>把一种喜欢的画风,变成可以反复调用的创作方法。</p></div></header><Link className="skill-card" href="/tools/skills/street-people"><div className="skill-art"><img src="/skills/street-people/sample.png" alt="手绘街头小人,透明剪纸素材"/></div><div><span className="pill">图片生成 · 透明 PNG</span><h2>街头小人 <ArrowUpRight size={22}/></h2><p>松散的线条,冬天的衣着。把街上的一个瞬间,剪成一张小贴纸。</p><span>查看文档与 Agent API →</span></div></Link></Shell>}
|
||||
@@ -0,0 +1,14 @@
|
||||
import Head from "next/head";
|
||||
import Link from "next/link";
|
||||
import {useState} from "react";
|
||||
import {Shell} from "@/components/Shell";
|
||||
import {streetPeople} from "@/lib/street-people";
|
||||
export default function StreetPeople(){const[copied,setCopied]=useState(false);return <Shell><Head><title>街头小人 · 技能 · PROMPT</title></Head><div className="detail-top"><Link href="/tools/skills">← 全部技能</Link><span>v{streetPeople.version}</span></div><div className="skill-doc"><header className="skill-hero"><div><span className="pill">STREET PEOPLE / 01</span><h1>街头,一个小小的瞬间。</h1><p>用不太规整的线条,画一个正在生活的人。<br/>奶油色剪纸边,深紫、钴蓝或珊瑚红的笔触,外部背景透明。</p><button className="primary-button" onClick={async()=>{await navigator.clipboard.writeText(`${location.origin}/api/skills/street-people`);setCopied(true)}}>{copied?'已复制 API 地址':'复制 API 给 coding agent'}</button></div><div className="skill-art"><img src="/skills/street-people/sample.png" alt="新生成的街头小人示例"/></div></header><div className="skill-doc-grid"><article><h2>01 / 画风约定</h2><p>完整单人、成人比例、稀疏五官;不规则毡头笔线条,头发与裤子用涂抹排线。保留纸片内部的奶油色,纸片以外是真实透明通道。人物动作和随身物件可以变化。</p><h2>02 / 提示词</h2><p>把下方的 {'{{subject}}'} 替换成衣着与动作。每张单独生成,使用绘图工具的透明背景选项。</p><pre>{streetPeople.prompt}</pre><h2>03 / 从生成到图包</h2><ol>{streetPeople.workflow.map(s=><li key={s}>{s}</li>)}</ol><p>参考图提取与新生成作品分开提交,各对应一个 post。建议在说明中记录来源、提示词与工具。</p><h2>04 / 调用示例</h2><pre>{`# BASE 为你正在访问的 PROMPT 网站地址
|
||||
curl "$BASE/api/skills/street-people"
|
||||
|
||||
# agent 完成图片生成后上传,支持多个 files
|
||||
curl -X POST "$BASE/api/skills/street-people" \
|
||||
-F 'title=街头小人 · 新生成' \
|
||||
-F 'description=原创人物;使用街头小人 v1.0.0 提示词' \
|
||||
-F 'files=@florist.png;type=image/png' \
|
||||
-F 'files=@reader.png;type=image/png'`}</pre><p>成功返回 201,包含 post 的 id、slug、url 与素材 assets ID。400 表示文件或表单不符合规范,409 表示 slug 已占用,413 表示超出上传限制。每次最多 16 张 PNG,单个 250 MB、总计 1 GB;人物 PNG 最多 4000 万像素。</p></article><aside className="surface skill-sidebar"><h2>交给 Agent</h2><p>把接口地址发给有绘图能力的 coding agent,它读取规范、生成 PNG,再上传到同一接口。</p><code>GET /api/skills/street-people</code><code>POST /api/skills/street-people</code><p>绘图由 agent 的工具执行;网站提供规范、透明校验和存储发布,无需在网站配置模型密钥。</p><a className="secondary-button" href="/api/skills/street-people?format=md">读取 Markdown 文档</a><a className="secondary-button" href="/api/skills/street-people">读取 JSON 规范</a><Link href="/p/street-people-reference" className="secondary-button">参考图提取包 ↗</Link><Link href="/p/street-people-original" className="secondary-button">新生成测试包 ↗</Link></aside></div></div></Shell>}
|
||||
@@ -6,3 +6,5 @@
|
||||
@media(max-width:950px){.sidebar{width:88px;padding:26px 14px}.brand{padding:0;margin:0 auto 30px}.brand strong,.nav-item span,.nav-group>p,.import-link span,.import-link svg:last-child{display:none}.nav-item{justify-content:center;padding:16px 10px;min-height:56px;gap:0}.nav-group{margin-bottom:10px}.import-link{justify-content:center;padding:15px 10px}.main-content{margin-left:88px;padding:0 22px 25px}.detail-layout,.management-grid{grid-template-columns:1fr}.media-stage{height:65vh;min-height:400px}.doodle-layout{grid-template-columns:1fr 260px;gap:20px}.doodle-catalog{gap:16px}.activity-card{padding:20px}.asset-grid{grid-template-columns:repeat(2,minmax(0,1fr))}.page-header p{font-size:13px}.sort-label{display:none}.feed-tabs{gap:3px}.feed-tabs a{font-size:14px;padding:11px 14px}}
|
||||
@media(max-width:650px){.sidebar{transform:translateX(-100%);width:210px;padding:25px 15px;transition:transform .2s}.sidebar.is-open{transform:translateX(0)}.sidebar .brand{margin:0 10px 25px}.sidebar .brand strong,.sidebar .nav-item span,.sidebar .nav-group>p,.sidebar .import-link span{display:block}.sidebar .nav-item,.sidebar .import-link{justify-content:flex-start;gap:15px;padding:13px 18px}.main-content{margin-left:0;padding:0 16px 25px}.global-topbar{height:83px;padding-left:45px;gap:12px;margin-bottom:18px}.global-search{height:46px;padding:0 13px;gap:8px}.global-search>svg{width:20px;flex-shrink:0}.global-search input{font-size:14px}.profile-mark{width:34px;height:34px;font-size:16px}.mobile-menu{display:flex;position:fixed;top:22px;left:12px;z-index:40;border:0;background:white}.nav-scrim{position:fixed;inset:0;background:#0005;z-index:25}.page-header{margin:0 0 24px;align-items:flex-start;flex-direction:column;gap:16px}.page-header h1{font-size:25px}.page-header p{font-size:13px}.activity-card{padding:18px 14px;border-radius:18px;margin-bottom:24px}.activity-top h2{font-size:15px}.activity-top h2>span{font-size:12px;margin-left:10px}.activity-year{display:none}.activity-bottom{font-size:10px}.feed-tabs a{font-size:14px;padding:10px 14px}.feed-toolbar{margin-bottom:19px}.post-cover{border-radius:14px}.masonry{gap:14px}.post-card h3{font-size:14px;margin:9px 4px 7px}.post-meta{font-size:11px;padding:0 4px}.card-tags{font-size:10px;margin:7px 4px}.empty-state p{font-size:13px}.empty-state>small{font-size:11px}.detail-top{margin-top:0;font-size:13px}.detail-layout{border-radius:18px}.media-stage{height:58vh;min-height:300px}.detail-info{padding:23px}.detail-info h1{font-size:21px}.editor-panel{padding:20px;border-radius:20px}.drop-zone{min-height:210px}.drop-zone strong{font-size:15px}.drop-zone>span:last-child{font-size:11px}.form-actions{align-items:flex-start;flex-direction:column}.form-actions button{width:100%}.kind-picker button{padding:11px 18px;font-size:14px}.asset-grid{gap:16px}.asset-preview{height:200px}.asset-tile-info{padding:11px 3px}.asset-tile-info>span{font-size:11px}.asset-tile h3{font-size:13px}.management-grid .surface{padding:23px 18px}.taxonomy-row code{font-size:11px;max-width:45%}.doodle-layout{grid-template-columns:1fr}.doodle-catalog{grid-template-columns:repeat(2,minmax(0,1fr));gap:16px}.doodle-inspector{position:static}.doodle-card strong{font-size:15px}.doodle-card small{font-size:11px}}
|
||||
.media-stage{max-height:760px}
|
||||
|
||||
.skill-card{display:grid;grid-template-columns:minmax(220px,380px) 1fr;max-width:1000px;border:1px solid #e9e5df;border-radius:24px;overflow:hidden}.skill-card>div:last-child{padding:42px}.skill-card h2{display:flex;align-items:center;gap:20px;font-size:30px;margin:22px 0 16px}.skill-card p,.skill-doc p,.skill-doc li{color:#736c63;line-height:1.9}.skill-card span:last-child{font-size:14px}.skill-art{background-color:#ede8df;background-image:linear-gradient(45deg,#e3ddd3 25%,transparent 25%),linear-gradient(-45deg,#e3ddd3 25%,transparent 25%),linear-gradient(45deg,transparent 75%,#e3ddd3 75%),linear-gradient(-45deg,transparent 75%,#e3ddd3 75%);background-size:24px 24px;background-position:0 0,0 12px,12px -12px,-12px 0;display:grid;place-items:center;padding:28px}.skill-art img{height:340px;object-fit:contain}.skill-doc{max-width:1200px;margin:auto}.skill-hero{display:grid;grid-template-columns:1.5fr 1fr;background:#f7f3eb;border-radius:26px;overflow:hidden}.skill-hero>div:first-child{padding:45px}.skill-hero h1{font-size:clamp(28px,3vw,44px);line-height:1.4;letter-spacing:-1px;margin:24px 0}.skill-hero p{margin-bottom:25px}.skill-doc-grid{display:grid;grid-template-columns:minmax(0,1fr) 300px;gap:45px;margin:40px 0}.skill-doc h2{font-size:21px;margin:32px 0 16px}.skill-doc pre{white-space:pre-wrap;overflow-wrap:anywhere;background:#f6f5f2;border:1px solid #e9e5dd;padding:24px;border-radius:16px;line-height:1.8;font-size:13px;color:#51483e}.skill-doc li{padding-left:8px;margin:12px 0}.skill-sidebar{align-self:start;position:sticky;top:112px}.skill-sidebar h2{margin-top:0}.skill-sidebar p{font-size:13px}.skill-sidebar code{display:block;font-size:12px;overflow-wrap:anywhere;margin:16px 0}.skill-sidebar .secondary-button{display:flex;margin:12px 0;padding:12px;font-size:13px}@media(max-width:800px){.skill-doc-grid{grid-template-columns:1fr;gap:10px}.skill-sidebar{position:static}.skill-hero{grid-template-columns:1fr}.skill-hero>div:first-child{padding:28px}.skill-hero .skill-art img{height:260px}.skill-card{grid-template-columns:1fr}.skill-card>div:last-child{padding:26px}}
|
||||
|
||||
Reference in New Issue
Block a user