参与贡献¶
感谢帮助完善 BUPT Agent。请先阅读 README 的支持范围和 安全说明。
开发环境¶
使用 Python 3.12+ 与 uv。在 Windows 上推荐 Git Bash;不要把 Bash 命令直接粘贴进 PowerShell。
默认检查使用合成数据与模拟网络,不要求学校账号,也不访问学校业务接口。系统凭据库测试只创建临时测试条目,完成后删除。真实账号联调需单独运行,见 诊断说明。
提交改动¶
文档站直接复用仓库内容。修改文档后请按 文档站维护说明 构建并检查链接、搜索索引和页面元信息;部署由 GitHub Actions 完成。
- 描述具体问题与预期行为;修复应附能复现问题的合成测试。
- 新接口需有可追溯的协议证据、参数校验、响应解析测试和验证范围说明。
- 保留分页、原始状态、未知值及显式错误。不要把接口失败转换成正常空结果。
- 下载限定已核验域名;不要增加任意 URL 请求或任意用户 ID 查询工具。
- 修改工具时同时更新 CLI/MCP 文档;只读查询不得隐含提交、评分或签到动作。
- 检查代码、测试、提交信息及截图均不含个人数据,再提交 PR。
不要提交账号、密码、Cookie、令牌、HAR、真实作业、成绩、课件或互评内容。测试样例必须为合成数据。private/、artifacts/、本机应用数据目录不能作为贡献材料。
来源与授权¶
贡献将按仓库 GPL-3.0-only 许可证分发。只贡献你有权提供的内容;引用或移植第三方代码时,注明源文件、版本、许可证和修改范围,保留要求的版权声明。协议参考与代码移植应明确区分,见 来源记录。
不要求附真实账号复现。可用步骤、错误码和合成响应描述问题。涉及安全问题请使用 SECURITY.md 的非公开报告流程。