CONTRIBUTING.md

参与贡献

欢迎提交问题反馈和 Pull Request。

本地开发

项目使用 Python 标准库和原生 HTML / CSS / JavaScript。准备 Python 3.10+ 与 Git 2.43+，然后运行：

python server.py

Node.js 仅用于可选的前端 JavaScript 语法检查，运行应用不需要 Node.js。

提交前验证

python -m unittest discover -s tests -v
python -m py_compile server.py remote_branches.py network_settings.py github_auth.py choose_folder.py upgrade_frontend.py
node --check web/app.js

测试会创建临时的本地 Git 仓库，不需要访问 GitHub，也不会下载 Unreal Engine。

修改下载流程时，请特别检查：暂停后是否保留已完成对象、服务重启后是否可以恢复、已有工作区修改是否得到保护，以及失败时是否显示可执行的提示。

问题反馈

请在 Issues 中提供：

• 操作系统、Python 和 Git 版本。
• 操作步骤、预期结果和实际结果。
• 相关错误日志，以及仓库是否需要认证。

粘贴日志前请移除密码、访问令牌、私有仓库地址和不希望公开的本地路径。不要上传 data/ 或本地下载的仓库。

项目结构

路径	用途
server.py	本地 HTTP 服务、下载队列、Git 操作与任务持久化
network_settings.py	代理设置持久化与 Git 子进程网络环境
github_auth.py	GitHub 浏览器登录、并发复用与超时处理
remote_branches.py	远端分支查询与地址校验
web/	浏览器界面
choose_folder.py	系统文件夹选择器
upgrade_frontend.py	在保留旧下载进程时提供新版页面
tests/	本地 Git 集成测试与接口测试

项目使用 MIT License。