# qianshi

千视科技官网 · https://qianshi.cool

## 部署

```bash
python deploy.py "提交信息"
```

**工作流：本地 commit + push → 服务器 git pull**

服务器只做 pull，不 commit。pull 只移动引用、不产生新 commit。

> 历史上用「SFTP 上传 + 服务器 commit」曾导致同一改动被提交两次
> （本地一次、服务器一次），author 与时间戳不同 → 同 tree 生出两个
> commit ID → 分支 `ahead 1, behind 1` 反复交叉。现已固化为
> `deploy.py`，不要再在服务器上手动 commit。

## 环境

| 项 | 值 |
| --- | --- |
| 线上 | https://qianshi.cool |
| 服务器 | 106.55.169.92，站点目录 `/var/www/qianshi` |
| Gitea | 与服务器同机，`http://127.0.0.1:3000/weizhiqiang/qianshi.git` |
| 仓库 remote | 本地走 `106.55.169.92:3000`，服务器走 `127.0.0.1:3000`（loopback） |

### 非交互凭据（已配置，勿删）

```
本地 与服务器:
  git config --global credential.helper store
  ~/.git-credentials   ← 含 Gitea HTTP 密码，权限 600
  GIT_TERMINAL_PROMPT=0  ← 缺凭据立即失败，不会挂起等交互
```

## 约定

- **CRLF**：已提交 `.gitattributes "* -text"` 禁用 git 行尾归一化。
  改 HTML 用 `newline=''` 读写，否则 LF/CRLF 分叉产生无意义 diff。
- **i18n**：新增文案须同时加入 `i18n.js` 的 `DICT`，英文值全局唯一
  （反向字典 `REV` 由 `REV[DICT[k]]=k` 构建，英文重复会致 ZH→EN→ZH 错译）。
- **批量维护脚本**（`gen_software_detail.py` / `update_site.py` /
  `update_address.py` / `add_logo.py` / `fix_visual.py`）含本机绝对路径，
  已在 `.gitignore` 中排除，不属于交付物。