← 返回展厅
YOUR FIRST PULL REQUEST

给想法,
一个地址。

不需要先做完项目。准备一个文件夹、一份草稿,就可以加入展厅。

01 复制仓库02 创建空间03 写下想法04 提交 PR

你会得到什么?

一个独立地址 /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
---

正文写:目标用户、问题、首版范围、前后端怎么配合、数据模型、草图和下一步。暂时没有答案可以标注「待讨论」。看看完整的示例 →

放入自己的图片

将 wireframe.png 放到你的文件夹,正文用 ![首页草图](./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 的检查清单

接下来怎么更新?

在自己的文件夹里更新正文、阶段和日期,再提一个 PR。做出能运行的版本后补上仓库和 Demo 链接。你的 Node 全栈应用放在自己的项目仓库,这里负责展示和交流。

先把范围缩小到:一个用户,解决一个问题,跑通一条前端 → API → 数据库的路径。