erkamyaman/unslopovich

项目介绍

unslopovich 由一个代理技能和一个零依赖的 JavaScript 检测器组成，目标是找出让 App 或网站看起来像 AI 生成出来的 UI/UX 问题。检测器实现了 31 条规则，覆盖 SwiftUI、UIKit、Jetpack Compose、Android XML、React Native、Flutter、Ionic、React、Vue、Svelte、Astro、HTML、CSS 和 Tailwind 类名，能识别紫色渐变、卡片套卡片、装饰性状态圆点、用 Emoji 充当图标、未虚拟化的长列表、禁用的返回手势、移动端汉堡菜单、缺失的 alt 文本、禁用缩放、被移除的焦点环等模式。

作者称分析了 App Store 与 Google Play 上共 1,201,466 条评论，其中 529,434 条为 3 星及以下。作者将这些低分评论中约四分之一的问题归为设计和前端层面可以修复的部分。这些是作者的研究结论，方法和局限另见 研究说明。

项目面向使用编程代理、希望用结构化方式审查现有 App 的开发者；Flutter、SwiftUI、React Native、Compose、React 和普通 HTML 都在支持范围内。检测器会读取最近的 package.json 来区分手机应用和网站。

快速开始

前提：Node.js 18 或更高版本，以及受支持的编程代理（Claude Code、Codex、Cursor、OpenCode、Gemini CLI、GitHub Copilot）。

1. 安装技能，安装器会自动识别本机上的代理：

npx unslopovich

2. 在代理中请求诊断：

/unslopovich review my app

Codex 使用 $unslopovich review my app，其余列出的代理使用斜杠形式，参见安装说明。

3. 需要修复时指定目标界面：

/unslopovich treat checkout

也可以不经过代理，直接运行检测器：

npx unslopovich detect src/
npx unslopovich detect --json ios/ android/

发现问题时退出码为 2，可用于 PR 卡点；--list-rules 会列出每条规则及修复方式。该包在 npm 上发布为 unslopovich。

使用约束

• 检测器读取源码，不读取渲染后的界面。弹窗遮挡、列表卡顿等只在运行时出现的问题，需要代理查看正在运行的应用。
• 报告会把性能问题标为 Not profiled；审查通过不代表性能或正确性没有问题。
• 忽略规则：单行用 // unslopovich-ignore <rule-id>（XML 中用 <!-- unslopovich-ignore <rule-id> -->），项目级用 .unslopovich/config.json 的 ignoreRules 和 ignorePaths。
• 平台由最近的 package.json 推断，判断错误时可用 --platform web 或 --platform mobile 覆盖。
• 技能会把项目上下文写入 .unslopovich/chart.md（核心任务和品牌规则），并在修改前把界面分为健康、轻度或重度问题。
• 默认按用户安装；使用 --project 可安装到项目内供团队共用，也可手动复制 skills/unslopovich。
• 许可证为 MIT，检测器没有运行时依赖。

HotRepo 点评

unslopovich 于 2026-11-15 进入 HotRepo 的 JavaScript 新项目榜，当时 107 stars，记录的统计窗口内新增 3 个 Star，4 个 Fork。仓库创建于 2026-11-09，目前仍是早期数据，不足以判断长期趋势。比较有说服力的是它把确定性检测器和代理审查拆成了两层：CLI 部分不依赖模型，有可验证的核心；忽略配置和退出码也让它能接入 CI。至于「用户到底在抱怨什么」的统计，来自作者自己对评论的人工标注，读者应结合研究方法和样本局限来看这些百分比，不宜直接当作普遍结论。