# 日常开发流程

> 本网站采用「本地开发 → 推送 Gitea → 自动构建部署」的流程。
> Gitea 远端是必须的：推送上去才会触发自动部署、更新线上网站。

## 一、Git 远端

- 远端名：`gitea`
- 地址：`http://8.137.165.96:3000/shizhui/shizhui_website.git`
- 本地 `main` 已跟踪 `gitea/main`。

## 二、日常流程（同一台电脑）

```bash
# 1. 开工前先拉最新（同步其他设备 / CMS 在线编辑的改动）
git pull

# 2. 改代码 …… 本地预览
npm run dev        # http://localhost:4321

# 3. 构建自测（可选，CI 也会构建）
npm run build

# 4. 提交并推送 → 自动触发构建部署
git add -A
git commit -m "说明本次改动"
git push
```

推送后约 30~60 秒，Gitea Actions 自动完成构建并发布到 `/var/www/shizhui`，
线上网站随即更新。

## 三、换一台新电脑开发

```bash
git clone http://8.137.165.96:3000/shizhui/shizhui_website.git
cd shizhui_website
npm install
# 之后照「日常流程」即可
```

## 四、Git 凭据（重要）

远端走 HTTP，push/pull 需要 Gitea 账号密码（用户 `shizhui` 或 `developer`）。
为避免每次输入，二选一：

**方式 A：缓存凭据（推荐，简单）**
```bash
git config --global credential.helper store
# 第一次 push 时输入一次账号密码，之后会记住
```

**方式 B：在 URL 里带用户名（仍会提示输密码）**
```bash
git remote set-url gitea http://shizhui@8.137.165.96:3000/shizhui/shizhui_website.git
```

> 注意：`credential.helper store` 会把密码明文存到 `~/.git-credentials`，
> 个人电脑可接受；公用电脑慎用。

## 五、多设备协作的纪律

- **开工先 `git pull`，完工再 `git push`**。
- 这样本地、其他电脑、CMS 在线编辑三方都能和谐共存。
- 若 push 被拒（提示 rejected / non-fast-forward），先 `git pull --rebase` 再 push。

## 六、备案完成后

域名 ICP 备案通过后，可把访问与远端从 IP 切回域名：
- 网站：https://shizhui.xyz
- Gitea：可改回 https://git.shizhui.xyz（需相应调整 Gitea ROOT_URL 与反代）
- 届时通知我，我来切换并收尾（关闭 8080 测试端口等）。

## 七、状态自检（怀疑线上与代码不一致时）

```bash
# 本地与远端是否一致（输出为空即一致）
git fetch gitea && git log gitea/main..main --oneline

# 线上标题是否为最新
curl -s http://8.137.165.96:8080/ | grep -o "<title>[^<]*</title>"
```