Kiwi TCMS 15.3 正式发布，开源测试管理系统最新版本上线

Kiwi TCMS 在测试管理领域一直备受关注，不少团队采用它来同时支持手动测试与自动化测试流程。其核心能力包括：与缺陷追踪系统无缝集成、快速精准的搜索界面、细粒度的权限管控、兼容主流测试框架的插件生态、多维度的清晰报表，以及一套全面的 RESTful API——可以说，测试管理平台所需的核心功能它基本都具备。

Kiwi TCMS 15.3 版本现已正式发布。虽然本次迭代规模不大，但一些细节改进仍然值得关注，重点涵盖依赖组件升级、数据库迁移脚本新增，以及大量 API 功能扩展与优化。

自 15.2 版本以来的主要变更，我们逐一进行解读。

功能优化

• Django 框架从 5.2.9 升级到了 5.2.10，保持稳定的迭代节奏，提升安全性与性能。
• django-simple-captcha 从 0.6.2 升级到 0.6.3，验证码组件获得修复与增强。
• django-simple-history 从 3.10.1 升级到 3.11.0，历史记录追踪功能更加可靠。
• （原文提到的“从 3.10 更新到 3.10.1”，未明确具体包名，这里保留原描述。）
• psycopg[binary] 从 3.3.1 升级到 3.3.2，PostgreSQL 数据库连接库得到优化。
• python-gitlab 从 7.0.0 直接跳升到 8.0.0，版本跨度较大，需注意兼容性影响。
• tzdata 从 2025.2 升级到 2025.3，时区数据同步更新。
• node_modules/pdfmake 从 0.2.20 升级到 0.3.3，PDF 生成组件获得重要更新。
• 管理后台现在支持对“分类”、“产品”、“优先级”、“组件”及“版本”等模型字段进行本地化翻译，修复了问题 #4193，多语言场景更友好。
• 分类项（Category）列表默认按名称升序排列，修复了问题 #4166，筛选体验更一致。
• 文件上传环节的元数据校验逻辑得到强化，有效降低了上传出错的风险。
• 邮件主题中的换行符被清除，避免因格式异常导致服务中断——这一细节在自动化通知场景中尤为实用。

数据库变更

• 新增迁移脚本：management.0012_alter_classification_options_alter_component_options_and_more
• 新增迁移脚本：testcases.0023_alter_category_ordering

如果你正在升级数据库，请务必执行这些迁移脚本，确保数据结构与新版匹配。

API 接口增强

本次 API 层面的变化相当丰富，几乎覆盖了从 Bug 管理到测试执行的全链路，值得深入关注。

• Bug 管理新增了 Bug.create()、Bug.filter_canonical()、Bug.get_comments()、Bug.add_comment()、Bug.add_attachment()、Bug.list_attachments()、Bug.add_execution() 方法——Bug 与测试执行的关联更加紧密，便于追踪缺陷与测试用例的对应关系。
• Group 管理新增了 Group.filter()、Group.permissions()、Group.users() 方法，权限和用户查询更加灵活，方便团队管理。
• TestExecution 新增了 TestExecution.add_attachment()、TestExecution.list_attachments()、TestExecution.create()、TestExecution.add_property() 方法，测试执行环节的附件与属性管理进一步完善。
• TestRun 新增了 TestRun.list_attachments()、TestRun.add_property()、TestRun.get_cc() 方法，测试运行的数据管理能力得到增强。
• TestCase.create() 和 TestPlan.create() 现在支持通过参数覆盖 create_date 字段——这对需要精确控制创建时间的场景（如数据迁移或历史记录导入）非常有用。
• 超级管理员可以在调用 TestCase.add_comment() 和 TestExecution.add_comment() 时自定义评论作者与提交时间，该权限进一步强化了管理员的控制力，适合审计或回溯场景。
• 大量 filter 方法返回结果改为按 id 字段升序排列，涉及 BugTracker、Category、Classification、Component、Group、PlanType、Priority、Tag、Template、TestCase、TestCaseStatus、TestExecution、TestExecutionStatus、TestRun、User——几乎是对全局性的排序规范调整，对依赖 API 进行结果一致性的处理影响较大，建议开发者注意适配。
• TestCase.comments() 方法的响应结构做了调整：site 字段重命名为 site_id，user 字段重命名为 user_id——命名更规范，但若存在旧解析逻辑，需进行相应迁移。

代码重构与测试改进

• actions/upload-artifact 动作从 v5 升级到 v6，CI/CD 流程更加稳定高效。
• black 代码格式化工具从 25.11.0 升级到 25.12.0，代码风格一致性进一步提升。
• Locust 性能测试框架从 2.42.6 升级到 2.43.1，压力测试能力得到增强。
• node_modules/brace-expansion 从 1.1.11 升级到 1.1.12，依赖安全性更新。
• node_modules/webpack 从 5.103.0 升级到 5.104.1，前端构建性能优化。
• 官网文档中相关链接地址同步更新，确保用户访问到最新资源。
• TestRun.create() API 实现中的冗余逻辑被移除，代码更简洁、可维护性更高。
• 为 TestRun.create() 的单元测试补充了更多断言用例，测试覆盖更全面，保障稳定性。

总体来看，Kiwi TCMS 15.3 版本虽然是一次小版本迭代，但 API 的扩展与规范化力度显著，尤其是 filter 排序的统一调整，对于依赖 API 进行数据处理的团队来说需要重点关注。数据库迁移脚本也已新增，升级时务必执行。如果你已经在使用 Kiwi TCMS，这个版本值得跟进升级。