🤝 协作者指南：修改图片并完成部署

本指南适用于协作者参与本项目时的完整流程，包括：

• ✅ 如何准备 Git 环境与 SSH 密钥
• ✅ 替换项目图片（如 logo）
• ✅ 推送改动并触发服务器部署

🧰 第一步：本地准备 SSH 密钥并发送给我

为了让你拥有提交权限并拉取代码，需要你在本地生成 SSH 密钥，并将公钥内容发给我。

1.1 在本地终端中执行以下命令：

ssh-keygen -t ed25519 -C "your_email@example.com"

一路回车（无需设置密码），会生成：

~/.ssh/id_ed25519       # ✅ 私钥（请勿泄露）
~/.ssh/id_ed25519.pub   # ✅ 公钥（需要发我）

1.2 获取公钥内容并复制：

cat ~/.ssh/id_ed25519.pub

将输出的整段以 ssh-ed25519 开头的内容复制下来并发送给我，我会将其添加为仓库的 deploy key。

🧾 第二步：配置 Git 基本信息（如未设置）

git config --global user.name "你的名字"
git config --global user.email "your_email@example.com"

🔧 第三步：拉取项目

git clone git@github.com:agnostic-ap/XHOMES.git
cd XHOMES

🖼 第四步：修改图片

4.0 通过浏览器F12检查图片路径,并复制src

4.1 若为非直观可看明白的字符序列，则前往网站进行解析

https://www.urldecoder.org/zh/

4.2 替换项目内 以下路径下的图片文件：

public/...

• 保持文件名一致
• 保持原尺寸（如 240 × 80）

4.3 本地预览（如有 Node 环境）(可选

npm install
# 或
yarn install

npm run dev
# 或
yarn dev

访问 http://localhost:3000 检查图片显示是否正常。

📤 第五步：提交并推送改动

git add .
git commit -m "chore(assets): update img"
git push

🚀 第六步：部署

登录服务器进行以下操作：

ssh ubuntu@123.123.123
cd /home/XHOMES/XHOMES
./deploy.sh

✅ 最终验证

部署完成后请访问 https://xhomes.co.nz 检查修改是否生效。

🧠 常见问题

图片不更新？

• 尝试浏览器强制刷新：Ctrl + Shift + R
• 二次尝试还是不行，可能有 CDN，需刷新缓存（由我处理）

推送失败？

• 确保已配置 SSH 公钥，未使用 HTTPS 地址
• 使用 ssh -T git@github.com 测试是否连接成功

如有问题，欢迎随时联系我。