📌 非技术岗专属指南

🚀 Genspark 部署 Git 项目攻略

无需安装任何开发环境,跟着步骤走,轻松完成项目预览和测试!

📋 目录

  1. 背景说明
  2. 整体流程 Overview
  3. 各个通项目在哪里找
  4. 第一步:打开 Genspark AI 开发者
  5. 第二步:将 GitHub 账号授权给 Genspark
  6. 第三步:导入项目(两种方案)
  7. 第四步:查看部署预览效果
  8. 第五步:保存代码修改
  9. 功能迭代代码提交攻略
  10. 后续更新版本代码攻略
  11. 常见问题 Q&A

💡 背景说明

非技术员工电脑没有安装任何开发环境的情况下,使用 Genspark 部署项目并进行预览和测试,是跨部门员工之间沟通效率提升的关键。


✅ 此教程适用于:只需对项目效果进行展示和简单测试的非技术岗同学

❌ 不适用于:技术岗同学的正式开发部署(请找技术同学)

🗺️ 整体流程 Overview

📌 完整协作流程一览:

🚀 部署到 Genspark
🌿 创立自己仓库的分支
✏️ 自然语言修改
📤 提交至总仓库分支
🔍 评审
✅ 通过
🔀 推送到 main
⚙️ 开发

📁 各个通的项目在哪里找?

各个通的详细项目说明和相关资料,请查阅以下内部文档:

如需在 GitHub 上查看不同项目的代码仓库,可前往 SamZheng-Design 的 GitHub 主页,L2 开头的项目就是各个通的独立项目。

GitHub 仓库列表截图

↑ SamZheng-Design 的 GitHub 主页,L2 开头的就是各个通

1
打开 Genspark AI 开发者
Genspark AI 开发者菜单截图

↑ 点击左侧的「AI 开发者」选项

选择全栈开发选项

↑ 建议选「全栈网站或应用程序」;「现有 GitHub 项目」选项没有 preview 预览功能

2
将 GitHub 账号授权给 Genspark
⚠️ 常见问题:No valid token 错误

如果看到如下图这种 No valid GitHub App installation token found 的错误,需要注意:

你下载 Genspark AI Developer 时使用的 GitHub 账号,和在 Genspark 中授权的 GitHub 账号必须是同一个。

解决方法:在点击授权之后,会跳转到 GitHub 登录界面,请用当初下载 Genspark AI Developer 所使用的那个 GitHub 账号进行登录,登录后即可完成授权。
No valid token error screenshot
GitHub 授权界面

↑ 点击授权后可以看到自己账号里的仓库

💡 如果你的账号里已有正在开发或调整的项目,直接在列表里选择那个仓库就行,不需要填写 URL。
3
导入项目(两种方案,选一种)

如果账号是新的、没有仓库,或者你需要部署别人账号下的项目,按下面两个方案操作:

首先,登陆 GitHub 找到那个人的主页,进入对应的仓库。

GitHub 个人主页

↑ 找到目标账号的主页,进入你要部署的仓库

📋 方案一:手动复制链接法
  1. 进入仓库,确认你要部署的分支(一个仓库可能有多个分支,对应不同功能版本)
选择分支

↑ 点击分支下拉菜单,选择你需要的那个分支(比如 V5.0)

  1. 复制仓库的网址(切换分支后可以看到提交记录,方便确认这个分支是否正确)
复制仓库地址

↑ 点击「Code」→ 复制 HTTPS 地址(注意:不论哪个分支,地址都是一样的)

  1. 回到 Genspark,在对话框里输入:
请帮我把这个仓库的【分支名】分支的项目在我的账号创建一个仓库并部署一下:【粘贴仓库地址】
⚠️ 如果部署失败,重新做一次 GitHub 授权,或先手动在 GitHub 创建好仓库再告诉 Genspark:「帮我把这个仓库的 XXX 分支在我的账号的 YYY 仓库上传并部署一下」
4
查看部署预览效果 👀
Genspark 已选中仓库

↑ 确认仓库已选中,然后告诉 Genspark 你要部署哪个分支

项目预览效果

↑ 部署成功!可以直接在预览界面里看到项目运行效果(如这里的「身份通」项目)

💡 如果 Genspark 提示你配置 Cloudflare,忽略它就好,沙盒内预览不需要真正托管到域名,临时链接够用了。真正的线上部署交给技术同学处理。
之前部署效果展示

↑ 另一个部署案例:Cardi B 演唱会项目测算系统,直接在预览界面运行

5
保存代码修改 💾
把这部分修改代码上传仓库
新开一个分支上传
✅ Fork 出来的是你自己的副本,不会影响原来 SamZheng-Design 的代码,放心操作!

🔁 功能迭代代码提交攻略

在 Genspark 中完成修改或功能迭代后,按下面两种情况选择对应的提交方式:

🔧 小修改(Bug 修复、样式微调等)

直接推送到当前分支,并附上说明这次改了什么:

将当前代码修改推送到当前分支,将功能修改添加为 message 一起提交
💡 message 就是备注,方便以后回溯「这次改了什么」,建议写清楚,比如:「修复登录页按钮样式」

🔄 后续更新版本代码攻略

如果原仓库有新版本代码更新,你需要把自己 Fork 来的仓库同步到最新版本,然后重新在 Genspark 中部署预览。

❓ 常见问题 Q&A

🔴 Q: 部署失败了怎么办?
A: 重新做一次 GitHub 授权,或者先手动在 GitHub 建好仓库,然后让 Genspark 往那个仓库部署。
🟡 Q: 我需要把项目真正上线到网站吗?
A: 不需要!预览用临时链接就够了。真正的线上部署(配置域名、Cloudflare 等)交给技术同学处理。
🟢 Q: 我会不会改坏原来的代码?
A: 不会!Fork 出来的是你账号下的独立副本,原仓库完全不受影响。
🔵 Q: 我不知道要部署哪个分支?
A: 在 GitHub 仓库里切换到某个分支后,可以看到提交记录的备注(message),从里面判断这个版本是什么功能。也可以问负责的技术同学。