Restore PROMPT branding, rename waterfall-wiki, and add system tag workflows
waterfall-wiki CI and deployment / verify-and-deploy (push) Has been cancelled
studio CI and deployment / verify-and-deploy (push) Successful in 9m15s

This commit is contained in:
2026-10-27 00:35:59 +08:00
parent 0c1ed2d292
commit ad398db781
178 changed files with 585 additions and 365 deletions
@@ -0,0 +1,37 @@
import Link from "next/link";
import { coverSvg } from "./cover";
import { useState, type CSSProperties, type ReactNode } from "react";
import { ArrowUpRight, ChevronLeft, ChevronRight, List, BookOpen, Check, ArrowDown } from "lucide-react";
import { chapters, seriesCover, sourceChecked, type Chapter, type Skill } from "./data";
function Footer({chapter,page}:{chapter:Chapter;page:number}) {
return <footer className="learning-sheet-footer"><span>PROMPT / 学习资料自己做</span><span>第 {chapter.number} 辑 <b>{String(page+1).padStart(2,"0")} / 08</b></span></footer>;
}
function Sheet({chapter,page,children,className=""}:{chapter:Chapter;page:number;children:ReactNode;className?:string}) {
return <section className={`learning-sheet ${className}`} aria-label={`第 ${page+1} 页`}><div className="learning-sheet-top"><span>学习资料自己做 / VOL. {chapter.number}</span><span>THE LEARNING EDIT</span></div>{children}<Footer chapter={chapter} page={page}/></section>;
}
function Sample({skill,index}:{skill:Skill;index:number}) {
return <div className={`learning-sample sample-${index%3}`} aria-label="排版示意,不是工具实测结果"><span className="sample-label">成品形态 · 排版示意</span>{skill.sample.map((line,i)=><div key={line}><span>{String(i+1).padStart(2,"0")}</span><p>{line}</p>{i===0&&<Check size={15}/>}</div>)}</div>;
}
function SkillCard({skill,index}:{skill:Skill;index:number}) {
return <article className="learning-skill"><div className="learning-skill-heading"><span className="learning-number">{String(index+1).padStart(2,"0")}</span><div><span className="learning-category">{skill.category}</span><h3>{skill.title}</h3></div></div><a className="learning-skill-name" href={skill.source} target="_blank" rel="noreferrer">{skill.name}<ArrowUpRight size={13}/></a><div className="learning-io"><p><b>给它</b><span>{skill.input}</span></p><p><b>得到</b><span>{skill.output}</span></p></div><Sample skill={skill} index={index}/><div className="learning-prompt"><span>可以这样问</span><p>“{skill.prompt}”</p></div><p className="learning-caveat">{skill.note}</p></article>;
}
const labels=["系列封面","本篇索引","01—02","03—04","05—06","07—08","09—10","使用路线"];
export function LearningSeries({chapterKey,pageNumber,standalone=false}:{chapterKey:string;pageNumber?:number;standalone?:boolean}) {
const chapter=chapters.find(c=>c.key===chapterKey)!;
const [current,setCurrent]=useState(0);const page=pageNumber??current;const setPage=(value:number|((p:number)=>number))=>{const next=typeof value==='function'?value(page):value;if(standalone)location.href=`/p/${chapter.slug}/pages/${next+1}`;else setCurrent(next);};const [continuous,setContinuous]=useState(false);
const boards:ReactNode[]=[
<div className="learning-cover learning-html-cover" key="cover" dangerouslySetInnerHTML={{__html:coverSvg}}/>,
<Sheet chapter={chapter} page={1} key="index"><div className="learning-intro"><span className="learning-chapter">第 {chapter.number} 辑 · 10 个 Skills</span><h2>{chapter.headline[0]}<br/><mark>{chapter.headline[1]}</mark></h2><p>{chapter.subtitle}</p><span className="learning-audience">{chapter.audience}</span></div><div className="learning-index">{chapter.skills.map((skill,i)=><button key={skill.name} onClick={()=>{setContinuous(false);setPage(2+Math.floor(i/2));}}><span>{String(i+1).padStart(2,"0")}</span><div><strong>{skill.title}</strong><small>{skill.name}</small></div><ArrowUpRight size={18}/></button>)}</div><p className="learning-index-note"><BookOpen size={16}/>按需求挑选,不必一次装完。点击条目查看介绍。</p></Sheet>,
...Array.from({length:5},(_,i)=><Sheet chapter={chapter} page={i+2} key={`skills-${i}`} className="learning-pair"><header className="learning-pair-title"><span>把工具用在具体的事情上</span><h2>{["先整理,再开始。","把资料做成自己的。","让学习多一条路径。","把看过变成理解。","留下一份能复用的资料。"][i]}</h2></header>{chapter.skills.slice(i*2,i*2+2).map((skill,j)=><SkillCard key={skill.name} skill={skill} index={i*2+j}/>)}</Sheet>),
<Sheet chapter={chapter} page={7} key="workflow"><div className="learning-ending"><span className="learning-chapter">收藏之后,试着做一份。</span><h2>先选一个需求,<br/><mark>再串成工作流。</mark></h2><p>不求用遍所有工具,先完成一份自己的资料。</p></div><ol className="learning-workflow">{chapter.workflow.map((line,i)=><li key={line}><b>{i+1}</b><span>{line}</span>{i<2&&<ArrowDown size={19}/>}</li>)}</ol><div className="learning-source-box"><h3>10 个来源,放在这里了。<ArrowUpRight size={20}/></h3><div>{chapter.skills.map((skill,i)=><a key={skill.name} href={skill.source} target="_blank" rel="noreferrer"><span>{String(i+1).padStart(2,"0")}</span>{skill.name}<ArrowUpRight size={12}/></a>)}</div><p>依据 GitHub 项目说明整理 · 核对于 {sourceChecked}<br/>尚未逐项安装实测;文中小样为排版示意。</p></div><div className="learning-series-reminder"><b>同系列还有</b>{chapters.filter(c=>c.key!==chapter.key).map(c=><Link key={c.key} href={`/p/${c.slug}`}>{c.number} / {c.subtitle}<ArrowUpRight size={14}/></Link>)}</div></Sheet>,
];
if(standalone)return <main className="learning-standalone w-[1080px] h-[1440px] overflow-hidden" style={{"--learning-accent":chapter.color} as CSSProperties}><div className="learning-boards" data-render-page>{boards[page]}</div></main>;
return <div className="learning-reader" style={{"--learning-accent":chapter.color} as CSSProperties}>
<div className="learning-reader-bar"><div><span className="learning-reader-badge">系列 {chapter.number} / 03</span><strong>{chapter.subtitle}</strong></div><button onClick={()=>setContinuous(v=>!v)} aria-pressed={continuous}><List size={16}/>{continuous?"分页阅读":"连续阅读"}</button></div>
<div className={`learning-boards ${continuous?"is-continuous":""}`} onKeyDown={e=>{if(e.target!==e.currentTarget||continuous)return;if(e.key==="ArrowRight"){e.preventDefault();setPage(p=>Math.min(7,p+1));}if(e.key==="ArrowLeft"){e.preventDefault();setPage(p=>Math.max(0,p-1));}}} tabIndex={0} aria-label="图文画板,可使用左右方向键翻页">{continuous?boards:boards[page]}</div>
{!continuous&&<nav className="learning-pagination" aria-label="图文翻页"><button aria-label="上一页" disabled={page===0} onClick={()=>setPage(p=>p-1)}><ChevronLeft size={20}/></button><span aria-live="polite">{page+1} / 8 <small>{labels[page]}</small></span><button aria-label="下一页" disabled={page===7} onClick={()=>setPage(p=>p+1)}><ChevronRight size={20}/></button></nav>}
<div className="learning-page-tabs" aria-label="选择图文页">{labels.map((label,i)=><button key={label} className={!continuous&&page===i?"selected":""} aria-current={!continuous&&page===i?"page":undefined} onClick={()=>{setContinuous(false);setPage(i);}}><span>{String(i+1).padStart(2,"0")}</span>{label}</button>)}</div>
<div className="learning-related"><span>学习资料自己做 · 系列三篇</span><div>{chapters.map(c=><Link className={c.key===chapter.key?"selected":""} key={c.key} href={`/p/${c.slug}`}><b>{c.number}</b>{c.key===chapter.key?"正在阅读 · ":""}{c.subtitle}<ArrowUpRight size={15}/></Link>)}</div></div>
</div>;
}
File diff suppressed because one or more lines are too long
@@ -0,0 +1,70 @@
export type Skill = {
name: string; title: string; category: string; input: string; output: string;
prompt: string; note: string; source: string; sample: [string, string, string];
};
export type Chapter = {
key: string; slug: string; number: string; title: string; headline: [string,string];
subtitle: string; color: string; audience: string; workflow: [string,string,string]; skills: Skill[];
};
const github = (path: string) => `https://github.com/${path}`;
export const seriesCover = "/learning-skills/cover.png";
export const sourceChecked = "2026-10-23";
export const chapters: Chapter[] = [
{
key: "learning-skills-notes", slug: "learning-skills-notes", number: "01",
title: "课件太厚?这 10 个 Skills 帮你整理复习资料",
headline: ["课件太厚,", "复习有方法。"], subtitle: "10 个整理笔记、网课与记忆卡的 Skills",
color: "#c3dc81", audience: "学生党 / 自学者 / 考前复习",
workflow: ["整理原始课件与网课", "搭框架,再做详细笔记", "用速记页与卡片检查理解"],
skills: [
{name:"study-notes",title:"厚课件,拆成章节笔记",category:"课件整理",input:"PDF、PPT、教材或技术文档",output:"Obsidian 笔记、图解、例题与练习",prompt:"把这章课件整理成复习笔记,保留例题,最后给我一组自测题。",note:"输出以 Markdown 笔记库为主。",source:github("siluy/obsidian-study-notes-skill/blob/main/SKILL.md"),sample:["01 章节知识框架","02 关键概念与例题","03 自测与易错点"]},
{name:"exam-cheatsheet",title:"考前,把重点收成几页",category:"速记清单",input:"备考工作区里的笔记、错题与知识库",output:"可溯源的速记资料;按需生成打印 PDF",prompt:"从已掌握的笔记和错题里,编译两页公式与例题速查表。",note:"依赖原项目的备考工作区,上游资料需先准备。",source:github("ZeKaiNie/universal-examprep-skill/blob/main/full/skills/exam-cheatsheet/SKILL.md"),sample:["必背结论 / 公式","典型例题 / 解题过程","来源锚点 / 方法提醒"]},
{name:"学霸笔记",title:"知识点,也能有笔记感",category:"视觉笔记",input:"需要重新组织的知识与说明文字",output:"手写笔记本风格的单文件 HTML",prompt:"把这些知识点排成横线纸笔记,用高亮标出三个易混概念。",note:"负责内容与视觉编排,不代替知识核对。",source:github("Unclecheng-li/note-skill/blob/main/SKILL.md"),sample:["CHAPTER 01 学习笔记","重点概念 → 高亮标记","我的理解 / 旁注留白"]},
{name:"video2knowledge",title:"一段网课,留下可复习的笔记",category:"视频学习",input:"本地课程视频或录屏",output:"时间戳转写、学习笔记、HTML 与记忆卡",prompt:"整理这段课程视频,给出时间戳笔记,再提炼可复习的知识卡。",note:"需要本地视频处理与识别依赖;云服务可选。",source:github("CacinieP/video2knowledge/blob/main/SKILL.md"),sample:["00:42 本节核心问题","03:18 概念与演示","08:06 总结 / 复习卡"]},
{name:"bili-content-organizer",title:"收藏的系列课,终于整理了",category:"系列课程",input:"B 站链接、分 P、合集或已有字幕",output:"按主题组织的结构化课程笔记",prompt:"按知识模块整理这个系列课,保留各节对应的来源。",note:"需能取得字幕;平台访问与登录按原项目要求。",source:github("Mocooa/bili-content-organizer/blob/main/SKILL.md"),sample:["课程目录 / 知识模块","每节课的核心观点","来源视频 / 对应笔记"]},
{name:"learning-pack",title:"想学一个主题,先有路线",category:"学习路线",input:"想系统学习的主题与当前基础",output:"学习路径、资料、视频清单与学习笔记",prompt:"我想从零学摄影,帮我整理循序渐进的学习路径与资料。",note:"资料检索与部分视觉产物依赖联网及配套能力。",source:github("irenerachel/learning-pack-skill/blob/main/SKILL.md"),sample:["入门 → 理解 → 实践","按阶段选择资料","边学边整理一本笔记"]},
{name:"flashcard-generator",title:"看过的笔记,变成会答的卡片",category:"主动回忆",input:"笔记、文章或一个知识主题",output:"问答卡、挖空卡与 Anki CSV",prompt:"把这章笔记做成 20 张单知识点记忆卡,不要把答案写得太长。",note:"导入 Anki 后的复习排程由 Anki 管理。",source:github("JayRHa/agent-skills/blob/main/flashcard-generator/SKILL.md"),sample:["Q 这个概念的核心是什么?","A 用一句话解释","CLOZE 关键术语填空"]},
{name:"processon-mindmap-generator",title:"零散内容,画出知识骨架",category:"知识脑图",input:"文字、文档、网页或已有提纲",output:"可在 ProcessOn 编辑的结构化脑图",prompt:"把这章内容整理成三层脑图,区分核心概念、例子与易错点。",note:"集成 ProcessOn 在线服务,需按项目配置访问凭据。",source:github("processonai/processon-skills/blob/main/skills/processon-mindmap-generator/SKILL.md"),sample:["章节主题","├ 核心概念 / 关联","└ 例题 / 常见误区"]},
{name:"learn-anything",title:"卡住的概念,拆开再学",category:"概念理解",input:"主题、文档、URL 或不理解的概念",output:"模块化学习内容、概念卡与复习安排",prompt:"我总分不清相关和因果,请拆开讲,再用问题检查我是否理解。",note:"仓库名为 learn-anything,技能声明名称为 learn。",source:github("d-wwei/learn-anything/blob/main/SKILL.md"),sample:["概念是什么 / 为什么","常见误区 / 反例","用自己的话重新解释"]},
{name:"revision-tutor",title:"复习结束,再检查一次盲点",category:"理解检查",input:"讲义、笔记与自己的回答",output:"概念解释、理解检查与复习记录卡",prompt:"围绕这份讲义提问,记录我答不清楚的地方,最后给我复习卡。",note:"原项目面向 Claude;跨会话需携带复习记录。",source:github("yangcodingmaster/Revision-Tutor/blob/main/SKILL.md"),sample:["已经讲清楚的概念","仍然卡住的推导","下一轮需要复习的点"]},
],
},
{
key:"learning-skills-teaching",slug:"learning-skills-teaching",number:"02",
title:"老师家长收藏|10 个出题、组卷与教学资料 Skills",
headline:["从一道错题,","到一套资料。"],subtitle:"10 个出题、排卷与制作课件的 Skills",
color:"#f2b994",audience:"教师 / 家长 / 教学内容创作者",
workflow:["收集题目,找到学习难点","生成练习,整理可打印试卷","检查命题,再准备讲评与课件"],
skills:[
{name:"k12-smart-teacher",title:"一道错题,多练几个角度",category:"错题巩固",input:"作业、错题与学段信息",output:"错因解释和基础、提高、挑战三层练习",prompt:"分析这道错题,先讲清楚错因,再给三档举一反三练习。",note:"Word 输出需要 python-docx;题目与答案需教师复核。",source:github("shellery1988/k12-smart-teacher/blob/main/SKILL.md"),sample:["① 找出错因","② 基础 / 提高 / 挑战","③ 讲解与巩固练习"]},
{name:"exam-paper",title:"从一份资料,整理一套练习",category:"练习生成",input:"教材、文档、图像或知识点材料",output:"试题、复习讲义与 Markdown / PDF",prompt:"围绕这一单元生成练习与讲义,附答案和解析,保持题目可追溯。",note:"排版与 PDF 生成依赖项目配套运行环境。",source:github("haitanghuaweimianTom/exam-paper-skill/blob/main/SKILL.md"),sample:["单元知识要点","基础练习 / 迁移练习","参考答案 / 解题提示"]},
{name:"wps-exam-paper",title:"题目有了,卷面也要清楚",category:"Word 试卷",input:"已有题目、分值与试卷要求",output:"带评分栏、题号、答题空间的 Word 试卷",prompt:"把这些题排成一份单元检测卷,留足答题空间并检查总分。",note:"来自 Bwkyd/wps-skills;运行依赖见原项目。",source:github("Bwkyd/wps-skills/blob/main/skills/wps-exam-paper/SKILL.md"),sample:["单元检测 / 姓名 / 班级","题号 一 二 三","得分 __ __ __"]},
{name:"video-exam-extractor",title:"散落在截图里的题,收成文档",category:"题目提取",input:"视频、题目截图或 PDF",output:"提取并组织好的 Word 题目文档",prompt:"把这些截图中的题目提取到 Word,保留题号并检查公式。",note:"识别结果中的公式、图形和选项需要人工核对。",source:github("delancy827/video-exam-extractor/blob/main/SKILL.md"),sample:["题目截图 / 视频画面","识别题干 / 选项 / 图示","结构化题目文档"]},
{name:"exam-paper-formater",title:"试卷、答案、答题卡,一起排",category:"打印排版",input:"已经准备好的题目与答案",output:"打印 PDF、独立答案卷与答题卡",prompt:"把题目排成 A4 试卷,答案单独成卷,再生成配套答题卡。",note:"仓库原名 formater;不把排版工具当作命题工具。",source:github("flyboat403/exam-paper-formater/blob/main/SKILL.md"),sample:["试卷 / 清楚的题目层级","答案 / 独立保存","答题卡 / 对应题号"]},
{name:"exam-evaluator",title:"印卷之前,先看命题结构",category:"命题评估",input:"试卷与相应教学或考试要求",output:"覆盖、结构和难度等分析的 HTML 报告",prompt:"检查这份试卷的知识覆盖和难度结构,指出需要调整的题目。",note:"分析属于辅助建议,不能代替教师审题。",source:github("flyboat403/exam-evaluator/blob/main/SKILL.md"),sample:["知识点是否覆盖?","题型与难度是否合理?","哪些题目需要调整?"]},
{name:"english-exam-studio",title:"英语试卷,变成讲评课件",category:"互动讲评",input:"英语试卷、答案与听力音频",output:"离线互动讲评页面与听力精听内容",prompt:"根据试卷和答案制作讲评页,把听力材料整理成精听环节。",note:"需准备对应试卷与音频,非通用题库。",source:github("hututu-ai/english-exam-studio/blob/main/SKILL.md"),sample:["阅读题 / 对应解析","听力片段 / 精听练习","课堂讲评 / 离线打开"]},
{name:"scriptorium",title:"一节课,配齐讲义和随堂测",category:"课程讲义",input:"计算机课程主题或课程仓库",output:"讲义、康奈尔学习单、测验与题库",prompt:"为这节 Python 循环课制作学生讲义、随堂测验和教师答案。",note:"主要面向计算机课程,内容需结合教学目标。",source:github("agiacalone/scriptorium/blob/main/SKILL.md"),sample:["课前 / 课程目标","课中 / 笔记与填空","课后 / 随堂测验"]},
{name:"ai-study-hero",title:"把每日学习,做成闯关任务",category:"学习任务卡",input:"小学生的主题、基础与学习安排",output:"学习计划、RPG 任务卡与交互知识库",prompt:"把一周的分数复习做成每日任务卡,每天安排少量练习。",note:"面向小学学习场景;计划需家长或教师调整。",source:github("mangoyc/ai-study-hero/blob/main/skill/SKILL.md"),sample:["今日任务 / 小目标","完成练习 / 检查理解","记录进度 / 下次复习"]},
{name:"wps-courseware",title:"课件也要顺着教学思路走",category:"教学 PPT",input:"学科、课题、年级与教学目标",output:"按教学结构组织的 PPT 课件",prompt:"为这节课准备导入、新授、练习和总结四个环节的课件。",note:"与 wps-exam-paper 同仓库,属于不同技能。",source:github("Bwkyd/wps-skills/blob/main/skills/wps-courseware/SKILL.md"),sample:["导入 → 建立问题","新授 → 解释与互动","练习 → 总结与迁移"]},
],
},
{
key:"learning-skills-english",slug:"learning-skills-english",number:"03",
title:"英语资料自己做|10 个词汇、精读、口语与写作 Skills",
headline:["英语资料,","按自己来。"],subtitle:"10 个词汇、精读、口语与写作 Skills",
color:"#afcbe9",audience:"英语自学 / 四六级 / 雅思备考",
workflow:["从文章或主题收集表达","练阅读、口语与写作输出","根据反馈修改,安排下一轮练习"],
skills:[
{name:"ielts-vocabulary-builder",title:"背单词,也把搭配一起带上",category:"主题词汇",input:"雅思主题、已有表达与练习需求",output:"词汇、搭配、词族与应用练习",prompt:"按教育主题整理常用表达,每个词给出搭配和一条使用练习。",note:"与本篇第 2—6 项同属 jurgendn/agent-skills。",source:github("jurgendn/agent-skills/blob/main/skills/test-prep/ielts-vocabulary-builder/SKILL.md"),sample:["education / lifelong learning","搭配 → 语境 → 自己造句","近义表达 / 语域差别"]},
{name:"ielts-reading-strategies",title:"阅读错了,先看错在哪里",category:"阅读方法",input:"阅读文章、题目与自己的答案",output:"题型分析、解题策略与错因反馈",prompt:"分析这组判断题,解释 False 和 Not Given 的区别并定位依据。",note:"训练方法与反馈,不是当季真题库。",source:github("jurgendn/agent-skills/blob/main/skills/test-prep/ielts-reading-strategies/SKILL.md"),sample:["题干关键词 / 文中定位","True / False / Not Given","证据在哪里?"]},
{name:"ielts-speaking-coach",title:"口语练习,不只背一份答案",category:"口语反馈",input:"Part 1—3 题目与文字或转写回答",output:"模拟练习、示例与预估评分反馈",prompt:"用 Part 2 方式陪我练习,回答后从结构和表达给出具体建议。",note:"文字回答无法充分判断发音;评分仅为练习参考。",source:github("jurgendn/agent-skills/blob/main/skills/test-prep/ielts-speaking-coach/SKILL.md"),sample:["Cue card / 一个话题","先说经历,再补充细节","修改重复与含混表达"]},
{name:"ielts-writing-task1",title:"图表作文,先读懂再落笔",category:"图表写作",input:"学术类 Task 1 图表与作文",output:"图表分析、概述、示例与修改建议",prompt:"先找这张图的主要趋势和对比,再帮我检查概述段。",note:"需提供清晰图表或数据;预估分数非官方评分。",source:github("jurgendn/agent-skills/blob/main/skills/test-prep/ielts-writing-task1/SKILL.md"),sample:["主要趋势 / 显著对比","Overview / 先概括","Details / 再给数据"]},
{name:"ielts-writing-task2",title:"大作文,先把论证搭稳",category:"议论文写作",input:"Task 2 题目、提纲或已有作文",output:"审题、论证结构、范文与修改反馈",prompt:"检查这道题的立场和论证链,指出例子没有支撑观点的地方。",note:"示例用于学习,不能替代自己的练习。",source:github("jurgendn/agent-skills/blob/main/skills/test-prep/ielts-writing-task2/SKILL.md"),sample:["观点 → 为什么成立","例子 → 如何支撑","回应题目 → 收束论证"]},
{name:"ielts-learning-planner",title:"备考计划,从自己的时间出发",category:"学习规划",input:"目前基础、目标与每周可用时间",output:"每周安排、专项练习和阶段检查点",prompt:"我每周能学五小时,请按当前薄弱项制定可调整的四周计划。",note:"计划需要按实际进展更新,不保证提分。",source:github("jurgendn/agent-skills/blob/main/skills/test-prep/ielts-learning-planner/SKILL.md"),sample:["本周重点 / 时间分配","专项练习 / 回顾反馈","检查点 / 下一周调整"]},
{name:"english-intensive-reader",title:"一篇文章,左右对照着精读",category:"双栏精读",input:"英文文章、URL、PDF 或 Word",output:"原文与分析双栏笔记、生词和句型",prompt:"逐句精读这篇文章,解释长难句,把值得复用的表达单独列出。",note:"可按原项目保存词汇与导出 Anki CSV。",source:github("infometa/workbuddyskills/blob/main/skills/english-intensive-reader/SKILL.md"),sample:["Original text │ 句子结构","Key phrases │ 生词与搭配","Summary │ 我的复述"]},
{name:"cet-english-learner",title:"四六级,把读懂变成会用",category:"四六级学习",input:"英文文章或视频字幕",output:"词汇、逐段精读、复述引导与墨墨卡片",prompt:"用这篇文章练四六级,拆解重点句式,最后引导我自己复述。",note:"训练需要主动输出,生成资料不等于掌握。",source:github("moyu12-ae/cet-english-learner/blob/main/SKILL.md"),sample:["读懂段落 / 提取表达","拆解句式 / 联系语境","合上原文 / 自己复述"]},
{name:"shadowing-practice",title:"跟读,从一句话开始",category:"影子跟读",input:"适合自己水平的音频与文本",output:"分段、逐句到脱稿的跟读训练流程",prompt:"根据我的水平安排跟读步骤,先逐句练,再过渡到不看字幕。",note:"提供训练指导,不自带语音识别或自动发音评分。",source:github("nexaforgelab/english-skill/blob/main/shadowing-practice/SKILL.md"),sample:["听一句 → 停顿跟读","延长片段 → 接近同步","去掉字幕 → 记录卡点"]},
{name:"IELTS 写作批改助手",title:"作文改完,还要知道怎么改",category:"作文批改",input:"大小作文题目、图表与自己的作文",output:"分项反馈、修改建议与 Word 批改报告",prompt:"逐条解释这篇作文的问题,给出可执行的改法并生成 Word 报告。",note:"该项目包含两个批改 Skills;评分为辅助预估。",source:github("NiceGuo2000/ielts-writing-assistant"),sample:["原句 / 问题位置","影响 / 具体改法","修改示例 / 下次练习"]},
],
},
];
@@ -0,0 +1,13 @@
// Each key describes one independent note. Tags and links connect notes without ownership.
export const noteDescriptions:Record<string,string>={
'street-people':'生成冬日街头人物的透明剪纸素材:画风、参考图片和交付要求。',
'street-people/style':'松散线条、冬日衣着与奶油色纸边的画风说明及人物生成提示词。',
'street-people/upload':'透明 PNG 图包的上传字段、接口示例、返回结果与文件限制。',
'street-people/checks':'检查人物轮廓、真实透明背景、纸片内部和生成来源的交付清单。',
'shadow-puppet':'把照片主体转译成暖灯宣纸上的皮影形象,制作上下对照海报。',
'shadow-puppet/workflow':'照片转皮影海报的逐张制作步骤,包括原片整理、画板、绘制和验收。',
'shadow-puppet/visual-grammar':'皮影海报的造型、配色、镂空、光影和上下等分构图规则。',
'shadow-puppet/prompt':'照片转皮影海报的可替换提示词与原片、风格参考的使用方式。',
'shadow-puppet/delivery':'皮影海报的尺寸、画面质量、来源记录和文件上传要求。',
'image-delivery':'图像尺寸、格式、透明通道、生成来源与交付协议的通用检查说明。',
};
@@ -0,0 +1,16 @@
{
"guidance:street-people": "4ce3283fd98bb03a8fb39a19",
"guidance:street-people/style": "a1207913bf7a7907488d3e69",
"guidance:street-people/upload": "42c414e58ff3b5f80919c2e2",
"guidance:street-people/checks": "7e80ad25076db9178fd6cff7",
"guidance:shadow-puppet": "3c98946754c33309d73d5284",
"guidance:shadow-puppet/workflow": "00837d41ae6b42abbdb62d58",
"guidance:shadow-puppet/visual-grammar": "d64c533a694331948f09b0a2",
"guidance:shadow-puppet/prompt": "9eb8a684f3356d66c0d9162c",
"guidance:shadow-puppet/delivery": "f64332ee01b13e28062f624c",
"guidance:image-delivery": "c8cf8ffbb1c4d4807ae82258",
"wiki:Main:welcome": "54d12ae51429f66fa7991ef5",
"wiki:Help:namespaces": "1a33340838520492b2e095c0",
"wiki:Template:idea": "40e0e456e2f5943610fef538",
"wiki:Draft:inbox": "a599a5734d13ec81fed1ffd1"
}
@@ -0,0 +1,6 @@
import ids from './page-ids.json';
// IDs are persisted, never derive them from titles or positions. Keep IDs when renaming a page.
export function pageId(key:string):string{return (ids as Record<string,string>)[key]||'';}
export const exploreUrl=(id:string)=>'/explore/'+encodeURIComponent(id);
export const guidanceUrl=(path:string)=>exploreUrl(pageId('guidance:'+path));
export function previewUrl(source:string,width=480){return '/api/preview?'+new URLSearchParams({source,width:String(width)});}
@@ -0,0 +1,44 @@
import {shadowPuppetResources,shadowPuppetDocuments} from "./shadow-puppet";
import {streetPeople} from "@/lib/street-people";
export type Resource={id:string;kind:'document'|'image'|'api';title:string;href:string;human?:string;method?:string;description?:string;detail?:unknown;template?:boolean};
export type Block={type:'paragraph'|'heading'|'code'|'links';text?:string;refs?:string[]};
export type SkillDocument={id:string;title:string;blocks:Block[]};
export const skillResources:Resource[]=[
{id:'index',kind:'document',title:'入口文档 · SKILL.md',href:'/skills/street-people/SKILL.md',human:'/tools/skills/street-people'},
{id:'style',kind:'document',title:'画风与生成提示词',href:'/skills/street-people/style.md',human:'/tools/skills/street-people/style'},
{id:'upload',kind:'document',title:'上传与返回结果',href:'/skills/street-people/upload.md',human:'/tools/skills/street-people/upload'},
{id:'checks',kind:'document',title:'交付检查清单',href:'/skills/street-people/checks.md',human:'/tools/skills/street-people/checks'},
{id:'reference',kind:'image',title:'画风参考图',href:'/skills/street-people/reference.png'},
{id:'sample',kind:'image',title:'透明人物示意图',href:'/skills/street-people/sample.png'},
{id:'spec',kind:'api',title:'机器可读接口规范',href:'/api/skills/street-people',method:'GET'},
{id:'submit',kind:'api',title:'提交透明 PNG 图包',href:'/api/skills/street-people',method:'POST'},
];
export const skillDocuments:SkillDocument[]=[
{id:'index',title:'街头小人',blocks:[
{type:'paragraph',text:'用松散的线条、冬天的衣着与奶油色剪纸边,留住街上的一个瞬间。此文档是交给 coding agent 的入口;先阅读说明,再按链接选择需要的子文档与接口。'},
{type:'heading',text:'从这里开始'},
{type:'paragraph',text:'绘图由 agent 自己的图像工具执行。网站负责提供风格规范、检查透明 PNG,并存储发布素材包;不在网站配置模型密钥。'},
{type:'links',refs:['style','reference','sample']},
{type:'heading',text:'生成与交付'},
{type:'paragraph',text:'每张图只包含一个完整人物及其随身物件。明确启用透明背景,检查外部透明、内部纸张与完整轮廓,再按上传文档提交。多个文件组成一篇素材笔记,同一图片仍可被其他笔记引用。'},
{type:'links',refs:['upload','checks']},
{type:'paragraph',text:'所有文档、图片与 API 的完整索引见下方。入口与子文档均为纯文本 Markdown,图片始终以链接提供。'},
{type:'links',refs:skillResources.map(r=>r.id)},
]},
{id:'style',title:'画风与生成提示词',blocks:[{type:'paragraph',text:'完整单人、成人比例、稀疏五官;不规则毡头笔线条,头发与裤子用涂抹排线。保留纸片内部的奶油色,纸片以外是真实透明通道。'}, {type:'links',refs:['reference','sample']},{type:'heading',text:'生成提示词'},{type:'paragraph',text:'将 {{subject}} 替换成衣着与动作。每张单独生成,使用绘图工具的透明背景选项。'},{type:'code',text:streetPeople.prompt},{type:'links',refs:['checks','upload','index']}]},
{id:'upload',title:'上传与返回结果',blocks:[{type:'paragraph',text:'先由 agent 生成 PNG,再以 multipart/form-data 提交。API 不负责绘图。'}, {type:'links',refs:['submit','spec']},{type:'code',text:`POST /api/skills/street-people\nContent-Type: multipart/form-data\n\n${Object.entries(streetPeople.upload.fields).map(([k,v])=>k+': '+v).join('\n')}\n\n201: { id, slug, url, assets }\n400: 文件或表单不符合规范\n409: slug 已存在\n413: 超出上传限制\n500: 服务器或存储错误`},{type:'heading',text:'调用示例'},{type:'code',text:`curl -X POST "$BASE/api/skills/street-people" \\\n -F 'title=街头小人 · 冬日片段' \\\n -F 'slug=winter-street-people' \\\n -F 'description=人物动作、提示词与生成来源' \\\n -F 'files=@person.png;type=image/png'`},{type:'paragraph',text:'最多 16 张,单文件 250 MB,总计 1 GB,每张最多 4000 万像素。重复 slug 返回 409,不会覆盖已有笔记。使用返回的 url 查看结果。'},{type:'links',refs:['checks','index']}]},
{id:'checks',title:'交付检查清单',blocks:[{type:'paragraph',text:'逐张检查完整人物、纸片边缘、衣着与动作。外部需要真实透明像素 alpha=0,内部需要接近不透明像素 alpha≥250。仅增加 alpha 通道而没有透明背景的 PNG 会被拒绝。'}, {type:'paragraph',text:'检查无截肢、无额外人物、无文字、无背景和外部阴影。记录生成来源与提示词;来源不同的图包分开提交。服务器的像素检查不能代替 agent 对画风和内容的检查。'}, {type:'links',refs:['style','sample','upload','index']}]},
];
export const skillCatalog=[{id:'street-people',title:'街头小人',category:'图片生成 · 透明 PNG',description:'松散的线条,冬天的衣着。把街上的一个瞬间,剪成一张小贴纸。',image:'/skills/street-people/sample.png',alt:'手绘街头小人,透明剪纸素材',href:'/skills/street-people',created_at:'2026-10-22T17:29:47Z'},{id:'shadow-puppet',title:'照片入皮影',category:'照片转译 · 3:4 海报',description:'把照片里的主角请上幕布,让它用一个姿态演完一整出戏。',image:'/skills/shadow-puppet/egret-example.png',alt:'白鹭照片与暖灯宣纸皮影的上下等分海报示例',href:'/skills/shadow-puppet',created_at:'2026-10-23T03:45:00Z'}];
export type SkillDefinition={id:string;title:string;documents:SkillDocument[];resources:Resource[]};
const definitions:Record<string,SkillDefinition>={
'street-people':{id:'street-people',title:'街头小人',documents:skillDocuments,resources:skillResources.map(r=>r.kind==='api'?{...r,detail:r.method==='POST'?streetPeople.upload:streetPeople,description:r.method==='POST'?'上传接口。阅读上传文档后,由 Agent 使用 multipart/form-data 提交文件。此处仅展示说明,不会发送请求。':'返回 JSON 规范。入口文档负责引导流程,JSON 用于查阅接口结构。'}:r)},
'shadow-puppet':{id:'shadow-puppet',title:'照片入皮影',documents:shadowPuppetDocuments,resources:shadowPuppetResources},
};
export function getSkill(id:string):SkillDefinition|undefined{return Object.hasOwn(definitions,id)?definitions[id]:undefined;}
export function skillDocumentMarkdown(skillId:string,id:string,origin='http://8.211.154.134:18131'){
const skill=getSkill(skillId);const doc=skill?.documents.find(d=>d.id===id);if(!skill||!doc)return null;
return `# ${doc.title}\n\n`+doc.blocks.map(b=>b.type==='heading'?`## ${b.text}`:b.type==='code'?`\x60\x60\x60\n${b.text}\n\x60\x60\x60`:b.type==='links'?b.refs!.map(id=>{const r=skill.resources.find(r=>r.id===id)!;return `- [${r.title}](${new URL(r.href,origin).href})${r.method?' — '+r.method:''}`}).join('\n'):b.text).join('\n\n')+'\n';
}
// Preserve the existing street-people document API.
export function documentMarkdown(id:string,origin?:string){return skillDocumentMarkdown('street-people',id,origin);}
@@ -0,0 +1,63 @@
import {guidanceUrl} from '../page-links';
import {getSkill,skillCatalog,type Block,type Resource} from './catalog';
export type GuidanceResource=Resource&{documentPath?:string};
export type GuidanceDocument={path:string;title:string;collection:string;blocks:Block[];resources:GuidanceResource[]};
const origin='http://8.211.154.134:18131';
export const humanDocumentUrl=(path:string)=>guidanceUrl(path);
export const markdownDocumentUrl=(path:string)=>`${humanDocumentUrl(path)}?agent_mode=True`;
export const legacyDocumentPath=(skill:string,doc:string)=>skill+(['index','SKILL'].includes(doc)?'':`/${doc}`);
export const documentResource=(path:string,title:string,id=`doc:${path}`):GuidanceResource=>({id,kind:'document',title,documentPath:path,href:markdownDocumentUrl(path),human:humanDocumentUrl(path)});
const shared=documentResource('image-delivery','图像交付与来源记录');
// A flat document registry. Collection names organize browsing, never restrict references.
export const guidanceDocuments:GuidanceDocument[]=skillCatalog.flatMap(card=>{
const skill=getSkill(card.id)!;
const resources:GuidanceResource[]=skill.resources.map(r=>{
if(r.kind!=='document')return {...r,id:`${card.id}:${r.id}`};
const legacy=r.href.match(/^\/skills\/([^/]+)\/([^/]+)\.md$/);
const path=r.href.startsWith('/skills/')&&r.href.endsWith('/index.md')?r.href.slice(8,-9)
:legacy?legacyDocumentPath(legacy[1],legacy[2])
:r.human?.startsWith('/skills/')?r.human.slice(8):legacyDocumentPath(card.id,r.id);
const title=skill.documents.find(d=>legacyDocumentPath(card.id,d.id)===path)?.title??r.title;
return documentResource(path,title,`${card.id}:${r.id}`);
});
return skill.documents.map(doc=>({
path:legacyDocumentPath(card.id,doc.id),title:doc.title,collection:skill.title,
resources:[...resources,shared],
blocks:[...doc.blocks.map(b=>b.type==='links'?{...b,refs:b.refs!.map(id=>`${card.id}:${id}`)}:{...b}),
...(['checks','delivery'].includes(doc.id)?[{type:'heading' as const,text:'共用指导文档'},{type:'links' as const,refs:[shared.id]}]:[])],
}));
});
guidanceDocuments.push({
path:'image-delivery',title:'图像交付与来源记录',collection:'共用指导',
resources:[documentResource('street-people/checks','透明人物验收'),documentResource('shadow-puppet/delivery','皮影海报验收与上传')],
blocks:[
{type:'paragraph',text:'这是一份可被不同创作方法共同引用的指导文档。每篇文档都有独立网址,引用不会复制或隔离内容。'},
{type:'heading',text:'交付前确认'},
{type:'paragraph',text:'按照具体任务确认尺寸、比例、格式、透明背景与成品数量。保留原始生成文件;透明 PNG 与有背景的海报使用各自的验收规则。'},
{type:'heading',text:'记录来源'},
{type:'paragraph',text:'记录原片或参考图、使用的提示词、生成工具及必要的修改说明。来源不同的作品分开说明,便于复用时追溯。'},
{type:'heading',text:'选择对应的交付协议'},
{type:'paragraph',text:'阅读目标文档的上传说明再提交。不同接口的字段和校验条件可能不同,以被引用文档为准。'},
{type:'links',refs:['doc:street-people/checks','doc:shadow-puppet/delivery']},
],
});
const registry=new Map(guidanceDocuments.map(doc=>[doc.path,doc]));
export function getGuidance(path:string){return registry.get(path);}
export function guidanceBacklinks(path:string){return guidanceDocuments.filter(doc=>doc.path!==path&&doc.blocks.some(b=>b.type==='links'&&b.refs!.some(id=>doc.resources.find(r=>r.id===id)?.documentPath===path)));}
export function guidanceMarkdown(path:string,base=origin){
const doc=getGuidance(path);if(!doc)return null;
const url=(href:string)=>new URL(href,base).href;
const blocks=doc.blocks.map(b=>b.type==='heading'?`## ${b.text}`:b.type==='code'?`\x60\x60\x60\n${b.text}\n\x60\x60\x60`:b.type==='links'?b.refs!.map(id=>{
const r=doc.resources.find(r=>r.id===id)!;return `- [${r.title}](${url(r.href)})${r.method?' — '+r.method:''}`;
}).join('\n'):b.text).join('\n\n');
const incoming=guidanceBacklinks(path);
return `# ${doc.title}\n\n[网页版本](${url(humanDocumentUrl(path))}) · [全部指导文档](${url('/skills/index.md')})\n\n${blocks}\n`+
(incoming.length?`\n## 引用本文的文档\n\n${incoming.map(d=>`- [${d.title}](${url(markdownDocumentUrl(d.path))})`).join('\n')}\n`:'');
}
export function guidanceIndexMarkdown(root=false,base=origin){
const url=(href:string)=>new URL(href,base).href;
return `# ${root?'PROMPT':'指导文档'}\n\n[网页版本](${url(root?'/':'/skills')}) · [指导文档目录](${url('/skills/index.md')})\n\n每篇指导文档都有独立网址,网页地址加 /index.md 即为对应的 Markdown。文档可以相互引用,不要求从某个技能入口逐级进入。\n\n## 全部指导文档\n\n`+
guidanceDocuments.map(d=>`- [${d.title}](${url(markdownDocumentUrl(d.path))}) — ${d.collection}`).join('\n')+'\n';
}
@@ -0,0 +1,516 @@
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"
]
}
]
}
];
+11
View File
@@ -0,0 +1,11 @@
export const namespaces=['Main','File','Category','Template','Draft','Help'] as const;
export type Namespace=typeof namespaces[number];
export type WikiPage={namespace:Namespace;slug:string;title:string;summary:string;body:string;categories:string[];color:string};
export const wikiPages:WikiPage[]=[
{namespace:'Main',slug:'welcome',title:'让灵感有处可寻',summary:'像翻阅笔记一样,发现和连接知识。',body:'这里是 PROMPT Wiki。每个条目都有一个稳定的页面地址,以及对应的 Markdown 正文。\n\n名字空间决定页面的用途,分类把不同用途的内容连接起来。素材可以被多篇条目引用,草稿也可以在成熟后成为正式条目。',categories:['创作方法'],color:'#f5ddd2'},
{namespace:'Help',slug:'namespaces',title:'名字空间,内容的不同房间',summary:'条目、文件、分类、模板与草稿,各有自己的位置。',body:'Main:正式知识条目。\nFile:图片、视频、音频的说明页,现有素材包位于 /wiki/File:slug,同时保留 /p/ 兼容地址。\nCategory:跨名字空间的分类索引。\nTemplate:可复用的内容结构说明。\nDraft:待完善的草稿(当前内容公开,不用于私密信息)。\nHelp:使用指南。\n\n在 src/content/wiki.ts 添加内容,即可生成网页与 AI 正文。现有素材包也提供 /api/wiki-post/slug 的 Markdown。',categories:['使用指南'],color:'#dde8df'},
{namespace:'Template',slug:'idea',title:'一个想法的骨架',summary:'从问题、观察到表达,让创作有迹可循。',body:'## 问题\n你想回答什么?\n\n## 观察\n收集具体场景与可信来源。\n\n## 表达\n把结论写成独立的页面,再交给创作站制作。',categories:['创作方法'],color:'#e6def0'},
{namespace:'Draft',slug:'inbox',title:'还没成形,也值得留下',summary:'给正在生长的想法留一个位置。',body:'草稿用于公开孵化内容。补充来源、结构和分类后,可以迁移到 Main 名字空间。',categories:['创作方法'],color:'#f0e7ca'}];
export function wikiPath(p:Pick<WikiPage,'namespace'|'slug'>){return '/wiki/'+encodeURIComponent(p.namespace+':'+p.slug);}
export function wikiMarkdown(p:WikiPage){return '# '+p.title+'\n\nNamespace: '+p.namespace+'\nCategories: '+p.categories.join(', ')+'\n\n'+p.summary+'\n\n'+p.body+'\n';}
export function findWikiPage(key:string):WikiPage|undefined{if(key.startsWith('Category:')){const name=key.slice(9);const members=wikiPages.filter(p=>p.categories.includes(name));if(!members.length)return;return {namespace:'Category',slug:name,title:name,summary:'分类中的相关页面',body:members.map(p=>'['+p.namespace+':'+p.title+']('+wikiPath(p)+')').join('\n\n'),categories:[],color:'#e6e9ef'};}return wikiPages.find(p=>p.namespace+':'+p.slug===key);}