# 参与贡献

外部协作默认通过 **Fork → 分支 → Pull Request**；仓库所有者审阅合并后，你在本机 `git pull` 即可同步。

## 流程摘要

1. **Fork** 本仓库，克隆你的 Fork。
2. （推荐）添加上游便于同步：

   ```text
   git remote add upstream https://github.com/hansjone/netx.git
   git fetch upstream
   git checkout -b feat/your-topic upstream/main
   ```

3. 若未添加上游，则基于当前默认分支（一般为 `main`）创建主题分支，例如 `fix/...` 或 `feat/...`。
4. 提交并推送到你的 Fork：`git push -u origin feat/your-topic`
5. 在 GitHub 上向 `hansjone/netx` 发起 **Pull Request**，说明变更内容与测试方式。

## 合并前注意

- 不要提交 `.env`、数据库口令、生产 URL 等敏感信息；以 `.env.example` / 文档中的占位符为准。
- Python 使用仓库约定的虚拟环境（见 `README.md`「Environment setup」）。
- 若改动 API、数据库或前端类型，请同步更新对应层（后端 schema / 前端 `types`）并尽量本地验证。

## 问题反馈

请使用 GitHub Issues（仓库内提供模板），写清复现步骤与环境。

若仓库暂不接收外部 PR，可在 README 中说明；本文档仍可供团队内部参考。