工程开发
code-review-netsync avatar

code-review-netsync

STYLY-NetSync 自动代码审查,执行协议一致性、线程安全及 Unity C#/Python 编码规范。

简介

code-review-netsync 是一项专为 STYLY-NetSync 存储库开发人员设计的工程工具,该项目是一个用于基于位置的娱乐 (LBE) 的高性能 Unity 网络框架。它通过对比 Git diff 与严格的项目特定规则来执行自动化代码审查,确保 Unity (C#) 客户端与基于 Python 的服务器之间的代码质量和同步。此技能旨在协助软件工程师和技术美术在提交合并请求或在 XR 环境中部署前进行代码检查。

  • 对 Git diff 进行自动验证,对照 Unity C# 与 Python 的编码标准,包括空值安全、UnityEngine API 的线程安全以及 ZeroMQ 模式的正确使用。

  • 监控并标记协议变更,通过检测序列化逻辑、协议常量(如 MSG_CLIENT_POSE 或 PROTOCOL_VERSION)以及量化设置的修改来触发检查。

  • 确保跨语言的一致性,标记在 Unity C# 类(例如 NetSyncManager, BinarySerializer)发生更改时,Python 文件(例如 client.py, binary_serializer.py)缺乏对应更新的情况。

  • 强制执行项目架构规范,例如禁用 ZMQ_CONFLATE、正确处理多部分消息以及确保文档使用英语编写。

  • 将审查结果按严重程度(CRITICAL、WARNING、INFO)分类,并提供可操作的修改建议。

  • 在提交拉取请求或修改核心网络组件时使用此技能,以便在进入生产环境前捕捉错误、协议不匹配或线程安全问题。

  • 工具需要 Git diff 作为输入(未暂存、已暂存或基于范围)以识别目标文件。

  • 若修改了 BinarySerializer.cs 或 types.py 等协议触发文件,技能会自动应用全面的协议影响检查清单。

  • 在合并前务必审查「CRITICAL」输出,因为这些标记直接针对可能导致 LBE 网络堆栈崩溃或损坏的严重问题。

仓库统计

Star 数
38
Fork 数
10
Open Issue 数
13
主要语言
Python
默认分支
main
同步状态
空闲
最近同步时间
2026年5月3日 22:37
在 GitHub 查看