Pair every guidance page with Markdown and enable shared document references
PROMPT Docker CI and deployment / verify-and-deploy (push) Successful in 16m58s

This commit is contained in:
2026-10-23 21:20:53 +08:00
parent 8c9fc31ee0
commit 46cd53a2a1
20 changed files with 229 additions and 64 deletions
+4 -28
View File
@@ -1,28 +1,4 @@
import type { NextApiRequest, NextApiResponse } from "next";
import { skillCatalog } from "@/content/skills/catalog";
export default function handler(req: NextApiRequest, res: NextApiResponse) {
if (req.method !== "GET" && req.method !== "HEAD") {
res.setHeader("Allow", "GET, HEAD");
return res.status(405).end();
}
const markdown = [
"# PROMPT — Agent 入口",
"",
"人类入口:[/](/)。Agent 默认入口:[/agent/index.md](/agent/index.md)。",
"",
"按任务选择技能,先阅读 SKILL.md,再按其中链接读取子文档、参考图片与上传协议。所有相对链接均以当前网站根地址解析。",
"不要从 HTML 页面猜测上传协议;生成由你自己的工具完成,网站提供文档、校验与素材存储。执行上传前遵循用户授权和对应技能的要求。",
"",
"## 技能目录",
...skillCatalog.map(skill => `- [${skill.title}](/skills/${skill.id}/SKILL.md) — ${skill.description}`),
"",
"## 网站导航",
"- [人类首页](/)",
"- [技能浏览](/tools/skills)",
"",
].join("\n");
res.setHeader("Content-Type", "text/markdown; charset=utf-8");
res.setHeader("Cache-Control", "no-cache");
return req.method === "HEAD" ? res.status(200).end() : res.status(200).send(markdown);
}
import type {NextApiRequest,NextApiResponse} from 'next';
import {guidanceIndexMarkdown} from '@/content/skills/guidance';
import {sendMarkdown} from '@/lib/markdown-response';
export default function handler(req:NextApiRequest,res:NextApiResponse){return sendMarkdown(req,res,guidanceIndexMarkdown(true));}
+8
View File
@@ -0,0 +1,8 @@
import type {NextApiRequest,NextApiResponse} from 'next';
import {guidanceIndexMarkdown,guidanceMarkdown} from '@/content/skills/guidance';
import {sendMarkdown} from '@/lib/markdown-response';
export default function handler(req:NextApiRequest,res:NextApiResponse){
const parts=Array.isArray(req.query.path)?req.query.path:[];
const text=parts.length===0?guidanceIndexMarkdown(true):parts[0]!=='skills'?null:parts.length===1?guidanceIndexMarkdown():guidanceMarkdown(parts.slice(1).join('/'));
return sendMarkdown(req,res,text);
}
+3 -7
View File
@@ -1,11 +1,7 @@
import type {NextApiRequest,NextApiResponse} from 'next';
import {skillDocumentMarkdown} from '@/content/skills/catalog';
import {guidanceMarkdown,legacyDocumentPath} from '@/content/skills/guidance';
import {sendMarkdown} from '@/lib/markdown-response';
export default function handler(req:NextApiRequest,res:NextApiResponse){
res.setHeader('Allow','GET, HEAD');
if(!['GET','HEAD'].includes(req.method||''))return res.status(405).end();
const name=String(req.query.doc).replace(/\.md$/,'');
const text=skillDocumentMarkdown(String(req.query.skill),name==='SKILL'?'index':name);
if(!text)return res.status(404).end();
res.setHeader('Content-Type','text/markdown; charset=utf-8');res.setHeader('Cache-Control','no-cache');
return req.method==='HEAD'?res.status(200).end():res.status(200).send(text);
return sendMarkdown(req,res,guidanceMarkdown(legacyDocumentPath(String(req.query.skill),name)));
}
@@ -1,3 +1,4 @@
import type {NextApiRequest,NextApiResponse} from 'next';
import {documentMarkdown} from '@/content/skills/catalog';
export default function handler(req:NextApiRequest,res:NextApiResponse){if(!['GET','HEAD'].includes(req.method||''))return res.status(405).end();const name=String(req.query.doc).replace(/\.md$/,'');const text=documentMarkdown(name==='SKILL'?'index':name);if(!text)return res.status(404).end();res.setHeader('Content-Type','text/markdown; charset=utf-8');res.setHeader('Cache-Control','no-cache');return req.method==='HEAD'?res.end():res.send(text)}
import {guidanceMarkdown,legacyDocumentPath} from '@/content/skills/guidance';
import {sendMarkdown} from '@/lib/markdown-response';
export default function handler(req:NextApiRequest,res:NextApiResponse){return sendMarkdown(req,res,guidanceMarkdown(legacyDocumentPath('street-people',String(req.query.doc).replace(/\.md$/,''))));}
+2 -2
View File
@@ -1,14 +1,14 @@
import type {NextApiRequest,NextApiResponse} from "next";
import {upload} from "../upload";
import {streetPeople} from "@/lib/street-people";
import {documentMarkdown} from "@/content/skills/catalog";
import {guidanceMarkdown} from "@/content/skills/guidance";
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(documentMarkdown("index"));
if(req.query.format==="md")return res.setHeader("Content-Type","text/markdown; charset=utf-8").status(200).send(guidanceMarkdown("street-people"));
return res.status(200).json(streetPeople);
}
if(req.method==="POST")return upload(req,res,{validateImage:validateCharacter,defaultTitle:"街头小人 · 新生成"});
+10
View File
@@ -0,0 +1,10 @@
import type {GetServerSideProps} from 'next';
import {SkillDocs} from '@/components/SkillDocs';
import {GuidanceIndex} from '@/components/GuidanceIndex';
import {getGuidance} from '@/content/skills/guidance';
export default function GuidancePage({documentPath}:{documentPath:string|null}){return documentPath===null?<GuidanceIndex/>:<SkillDocs documentPath={documentPath}/>;}
export const getServerSideProps:GetServerSideProps=async({params})=>{
const parts=params?.path;if(parts===undefined)return {props:{documentPath:null}};
if(!Array.isArray(parts))return {notFound:true};
const documentPath=parts.join('/');return getGuidance(documentPath)?{props:{documentPath}}:{notFound:true};
};
+1 -5
View File
@@ -1,5 +1 @@
import Head from 'next/head';
import {Shell} from '@/components/Shell';
import {SkillCard} from '@/components/SkillCard';
import {skillCatalog} from '@/content/skills/catalog';
export default function Skills(){return <Shell><Head><title>技能 · PROMPT</title></Head><header className="page-header"><div><h1>技能</h1><p>把一种喜欢的画风,变成可以反复调用的创作方法。</p></div></header><div className="skills-masonry">{skillCatalog.map(skill=><SkillCard key={skill.id} skill={skill}/>)}</div></Shell>}
export {GuidanceIndex as default} from '@/components/GuidanceIndex';