netx/CONTRIBUTING.md

参与贡献

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

流程摘要

1. Fork 本仓库，克隆你的 Fork。

2. （推荐）添加上游便于同步：

   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 中说明；本文档仍可供团队内部参考。