WiFi-DensePose 代码规范实战：从写代码到提 PR 的一页速查
WiFi-DensePose 代码规范实战从写代码到提 PR 的一页速查【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuViewWiFi-DensePose 把商用 mesh 路由器的 CSI 信号变成可穿墙的实时全身骨骼跟踪。这篇按真实开发动线过一遍它的代码风格约定格式、命名、异常与提交纪律读完一次能少踩不少坑。一、开工前先跑一遍 Black再把目录读明白项目把Black 格式化作硬性门槛4 空格缩进、88 字符行宽、函数与类之间空两行、字符串优先双引号。装好 pre-commit 钩子后这件事就不用再操心。目录不用记抓住分工即可src/api/接口层src/hardware/负责 CSI 采集与清洗src/neural_network/ 放推理src/tracking/是跟踪算法每个子包靠__init__.py显式导出公共接口禁止通配符导入测试文件与源码同构放置tests/下镜像src/的层级二、命名、类型提示与模块划分代码风格里最容易忽略的细节命名是一套固定约定类名 PascalCase函数与变量 snake_case常量全大写私有成员单下划线开头。比命名更要命的一条是每个函数参数和返回值都写类型提示这是 CSI 信号处理编码规范里静态检查能跑起来的前提。纯数据容器直接用 dataclassAPI 请求/响应对象才上 Pydanticdataclass class CSISample: amplitude: np.ndarray phase: np.ndarray num_subcarriers: int class PoseRequest(BaseModel): csi_data: List[CSISample] confidence_floor: float 0.5模块划分按单一职责走一个文件只承载一个核心类依赖从构造函数注入而不是模块内全局实例化循环导入直接视为设计错误。三、让代码更稳异常分层 结构化日志异常做成一棵树统一根类各层专用子类调用方就能精准捕获class WiFiDensePoseError(Exception): 项目基础异常。 class CSIProcessingError(WiFiDensePoseError): CSI 数据处理错误。 class ModelInferenceError(WiFiDensePoseError): 神经网络推理错误。捕获时只接具体异常不兜底Exception重新抛出时用from把原异常挂在链上别把现场弄丢。日志统一从get_logger(__name__)取实例输出时带上结构化extra字段排查时能直接对齐面板指标logger.debug( track update complete, extra{detections: len(dets), cost_ms: cost * 1000}, )下面这帧姿态估计界面里的性能指标就是靠这类日志字段串起来的四、提 PR 之前测试、分支与提交格式一次对齐分支走修改版 Git Flowmain是生产基线develop做集成新功能开feature/*线上救火走hotfix/*。提交信息执行Conventional Commits类型前缀决定变更语义这是 Conventional Commits 开源贡献协作的基本盘feat(tracking): 加入卡尔曼滤波预测帧间运动 减少 ID 切换跟踪更稳。 Closes #456单测用 mock 隔离硬件依赖核心逻辑覆盖率守住 90%。提审前过一遍这四条Black 通过且没有引入新警告测试同步补齐覆盖异常分支日志字段足够定位问题Commit 前缀与实际改动一致细节如文档字符串写法与完整审查流程参考仓库内 archive/v1/docs/developer/contributing.md 的贡献指南——照上面这套走第一个 PR 就能稳稳进库。【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuView创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考