内容
# Lyse
> 设计系统会漂移。Lyse 会衡量它。
为您设计系统的本地、确定性健康评分 — 审计，解释，并将修复交给您的编码代理，本地或在 CI 中。
[](https://github.com/lyse-labs/lyse/actions/workflows/ci.yml)
[](https://www.npmjs.com/package/@lyse-labs/lyse)
[](https://www.npmjs.com/package/@lyse-labs/lyse)
[](./LICENSE)
## 快速开始
AI 编码代理快速构建 UI — 并硬编码 `#3b82f6`，而 `color.brand.primary` 存在，重新发明 `<Button>`，并跳过故事。Lyse 审计他们（和人类）引入的漂移，评分为 0-100，并将修复交给同一个代理。
```bash
npx -y @lyse-labs/lyse@latest
```
就这样 — 无需配置，无需提示，您的健康评分在几秒钟内完成。
## 可选：校准
`lyse init` 检测您的框架，写入 `.lyse.yaml`，并可选地为您的 AI 代理连接 MCP 服务器。
```bash
npx -y @lyse-labs/lyse@latest init
```
## 命令
```bash
lyse audit # 重新运行审计（文本，JSON 或 SARIF）
lyse handoff # 审计，然后将发现的问题交给您的编码代理修复（Claude Code / Cursor / Codex）
lyse init --scaffold # 生成缺少的 AI 就绪文件（llms.txt，AGENTS.md）
lyse init --migrate-tokens # 将旧式 {value,type} 代币 JSON 转换为 DTCG ({$value,$type})
lyse explain X # 规则的原理 + 示例
lyse mcp setup # 将 MCP 连接到 Cursor / Claude Code / Codex
lyse add ci-gate # 安装评分回归 CI 门控（.github/workflows/lyse.yml）
lyse share # 将 Markdown 摘要复制到剪贴板
```
> **信任边界。** 默认情况下，`lyse handoff` 启动您的编码代理，绕过其权限提示，以便它可以应用修复 — 仅在您信任的仓库上运行它。它在生成之前确认（`Continue? [y/N]`，在 `--yes` 或非交互式下跳过）；传递 `--review` 以保留代理自己的每个操作权限提示。
## 审计内容
**6 个轴** 的健康评分（0-100）— 代币，a11y，组件，故事，ai-surface，ai-governance — 来自确定性静态规则。每个轴都是一个机会加权的清洁采用比率（`scoring-v3`）；轴需要 30+ 个机会才能计数。CMMI 样式的成熟度层级（Foundational → Autonomous）映射到评分。默认情况下，无需 LLM，无需网络，完全本地。上一版本严重性加权公式通过 `--score-model v2` 保持可达 — 评分在两个版本之间不可比较。完整公式和每个规则的文档在 [`docs/`](./docs/) 中。
可选的 **渲染层** （`lyse audit --render`）针对预构建的 Storybook 运行额外检查（`storybook-static/` 或 URL）：`tokens/rendered-token-fidelity`（CSS 自定义属性漂移）和 `a11y/runtime-axe`（axe-core a11y 违规）。两者都是实验性的，不会影响健康评分。
`lyse explain --score` 还报告 **AI 治理成熟度级别** （L0-L5，按 AI 功能存在 — 标记组件，AI 代币，交互模式，治理文档）。默认确定性；可选 LLM 层读取更难的语义功能。
## 隐私
`lyse audit` 默认 **仅静态** ：没有任何内容离开您的机器。可选 LLM 精确度过滤器是 **按需开启** （`--llm`，`LYSE_LLM=1` 或显式 `llm.provider` 配置），并且 BYOK — 安装 `claude` CLI 不会默默启用它，默认审计永远不会提示它。遥测是按需开启的（在您的第一个报告后显示一个一次性提示，默认拒绝）。参见 [PRIVACY.md](./PRIVACY.md)。
## 更多
- [`CHANGELOG.md`](./CHANGELOG.md) — 发布历史
- [`docs/`](./docs/) — 完整文档，规则页面，架构
- [`CONTRIBUTING.md`](./CONTRIBUTING.md) — 如何添加规则或修复错误
- [`LICENSE`](./LICENSE) / [`COMMERCIAL.md`](./COMMERCIAL.md) — 双 AGPLv3 / 商业
- [`SECURITY.md`](./SECURITY.md) — 漏洞报告
---
2026 Lyse Labs.
MCP 市场