搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

brianbell-x/codehygiene

开发工具

用纯 NumPy 的微型三元神经网络给 11 种语言的代码做可读性与整洁度打分和行级标记。

126
5
Python
创建于 1 天前

项目介绍

codehygiene 判断的是代码“读起来干不干净”,而不是语法是否合法。传统 linter 能通过的文件,仍可能是高度嵌套、注释冗余或充满复制粘贴痕迹的代码。项目用纯 NumPy 实现一个约 574K 参数的 1.58-bit 三元网络,不依赖正则、分词器或 AST 解析,对 Python、C、C++、Rust、Go、Zig、JavaScript、TypeScript、Java、C# 和 Lua 给出整洁度评分。

一次前向传播会返回总分(0.0–1.0)、六项子分(flatness、naming、simplicity、comments、error_handling、layout)、风格原型(minimal、clean、enterprise、dense、slop),以及行级 Squiggle 提示,例如 deep_nesting、noisy_comment、swallowed_error。

权重不经过梯度下降训练,而是由 compile.py 中的数学电路编译成 {-1, 0, +1} 的三元矩阵,存放在 codehygiene/weights.npz 中(约 12.97 KiB),小文件在 CPU 上推理约 10 ms。

快速使用

用 uvx 直接运行,或先通过 pip 安装:

uvx --from git+https://github.com/brianbell-x/codehygiene codehygiene .
pip install git+https://github.com/brianbell-x/codehygiene
codehygiene src/

常用参数包括 --check(有 squiggle 达到阈值时以非零码退出,适合 CI)、--json(输出结构化结果)和 -t(调整 squiggle 概率阈值)。也支持从 stdin 读取:

codehygiene path/to/file.py --json
cat snippet.rs | codehygiene --json

要在 Claude Code、Codex、Cursor、Antigravity 或 Copilot 中作为 agent skill 使用,可通过 npx skills 安装:

npx skills add brianbell-x/codehygiene
npx skills update codehygiene -y

另有浏览器演示,在本地加载权重,对粘贴的片段或公开 GitHub 仓库评分。本地运行可启动自带的 docs 目录:

python3 -m http.server 8123 -d docs

在 Python 中可调用 codehygiene.score(code) 得到完整结果,codehygiene.lint(code, threshold=0.55) 返回 squiggle 列表,codehygiene.rl_reward(code, tests_passed=True, weight=0.25) 生成 RL 奖励;测试不通过时奖励为 0,避免模型用“看着干净但不能运行”的代码骗奖励。

使用约束

仅覆盖上述 11 种语言,其他文件不会被评分。它评估风格和整洁度,不检查正确性,不能替代测试或类型检查。评分阈值基于项目自带的代码范本和诊断集校准,换到别的代码库可能需要用 -t 调整。README 未声明许可证。CLI 默认最多每 12 小时检查一次公开发布元数据,并通过 stderr 输出一行更新提示;可用 --no-update-check 或设置 CODEHYGIENE_NO_UPDATE_CHECK=1 关闭,CI 环境下自动跳过。浏览器演示在按 URL 评分时需要联网获取公开仓库内容,粘贴片段则在本地处理。

HotRepo 点评

在 HotRepo 2026-11-16 的新项目榜记录中,该仓库为 118 星,约 1.5 小时内新增 18 星,同期采集到的 Star 曲线从 100 升到 118。这是仓库建立初期的单次窗口数据,反映的是即时关注度而非采用情况。技术描述在同阶段项目中相当具体:纯 NumPy 推理、三元权重、可复现的编译步骤、浏览器演示,以及用 GPT-OSS 120B 构建的四个应用做重构前后对比的 agent 基准。评分行为的主要依据仍是项目自带的基准,读者需要自行权衡这些数据。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。