你会得到什么?
一个独立地址 /spaces/你的文件夹名/,一个自动出现在首页的项目小窗。你的文字、图片都保存在同一个文件夹里。只需要写 Markdown,不用修改首页代码。
01 / 把仓库拿到本地
先安装 Node.js 24 LTS 和 Git。打开项目的 GitHub 仓库,点击 Fork,复制你自己 Fork 的地址。将下面的地址换成你的真实地址:
git clone <你的-Fork-仓库地址>
cd thinkspirit-launchpad
npm ci
git switch -c feat/my-space如果你有仓库写权限,也可以直接从原仓库创建分支,无需 Fork。
02 / 领取一个文件夹
用英文小写、数字和连字符命名,例如 lin-study-kit。不要使用空格或中文。一个人先维护一个空间,项目名可以随时改。
npm run new -- lin-study-kit脚本会创建以下文件。也可以手动复制 templates/space/ 到相同位置:
src/content/spaces/lin-study-kit/
├── index.md # 卡片信息 + proposal 正文
└── sketch.svg # 示例封面,可以换成自己的图片03 / 写下你的想法
打开 index.md。文件顶部两条 --- 之间叫做 frontmatter,用来描述首页卡片:
---
title: "我的项目"
author: "你的名字"
tagline: "一句话:帮谁解决什么问题?"
stage: idea
tags: [Node.js, TypeScript]
accent: lime
updated: "2026-09-30"
example: false
cover: ./sketch.svg
---stage:idea灵感、draft草稿、building开发中、shipped已上线。accent:lime、blue或coral,控制空间的强调色。updated:本次更新日期,用引号包住,格式为 YYYY-MM-DD。cover:相对于这个文件的封面路径。可删除此行,使用自动生成的封面。repo/demo:可选的 HTTPS 仓库和演示链接。没有就不写,不要用假地址占位。
正文写:目标用户、问题、首版范围、前后端怎么配合、数据模型、草图和下一步。暂时没有答案可以标注「待讨论」。看看完整的示例 →
放入自己的图片
将 wireframe.png 放到你的文件夹,正文用  引用。封面可以写 cover: ./wireframe.png。尽量压缩图片,避免提交大视频或设计源文件。
04 / 预览、检查、提交
npm run dev
# 在浏览器打开终端显示的本地地址
# 检查首页卡片和 /spaces/你的文件夹名/
npm test
npm run build
git add src/content/spaces/lin-study-kit
git commit -m "feat: add lin study kit proposal"
git push -u origin feat/my-space在 GitHub 打开你的 Fork,点击 Compare & pull request,目标选择原仓库的主分支。标题写清项目名,描述里说明想做什么、想得到什么反馈。合并后,配置好的 Cloudflare Pages 会自动更新展厅。
一个好 PR 的检查清单
- 主要只修改自己的空间文件夹。
- 标题、作者、一句话介绍都已填写,保留
example: false。 - 首页和详情页都预览过,图片能够打开。
npm test和npm run build通过。- 没有 API Key、密码、手机号等私密信息。这个站点是公开的。
- 标注了尚未实现的功能,没有把想法写成已上线成果。
接下来怎么更新?
在自己的文件夹里更新正文、阶段和日期,再提一个 PR。做出能运行的版本后补上仓库和 Demo 链接。你的 Node 全栈应用放在自己的项目仓库,这里负责展示和交流。
先把范围缩小到:一个用户,解决一个问题,跑通一条前端 → API → 数据库的路径。