Add street people skill API and two transparent character packs
PROMPT Docker CI and deployment / verify-and-deploy (push) Successful in 13m3s

This commit is contained in:
2026-10-23 01:29:47 +08:00
parent 68b2bcab1f
commit 72623b75f7
38 changed files with 293 additions and 7 deletions
+15
View File
@@ -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
View File
@@ -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;
+5
View File
@@ -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>}
+14
View File
@@ -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>}