# HefestoAI — 面向 AI 生成代码的发布真实性检查引擎

> 主要用途：在提交 / 合并之前验证 AI 生成的代码。 HefestoAI 是一款开发者工具，作为 pre-commit / pre-push 关卡运行，检测代码变更中的语义漂移、风险差异和策略违规，尤其是 AI 助手（Claude Code、Cursor、Copilot）生成或编辑的代码。它检查项目声明的内容（依赖、配置、安装产物）是否与实际行为一致，并执行安全和复杂度检查。

本文件是 /llms.txt 的简体中文译本。如有出入，以英文版 /llms.txt 为准。

Version: 4.20.4. Site: https://hefestoai.narapallc.com

关键词：AI 生成代码检查、代码安全、静态代码分析、代码审查、CI 门禁、MCP 服务器、pre-commit。

## 可核实的事实
- 版本：v4.20.4
- 输出格式：text、json、html 和 SARIF 2.1.0（`hefesto analyze --output sarif`）
- MCP 服务器：已上架官方 MCP Registry（io.github.artvepa80/hefestoai）和 Smithery
- MCP 客户端连接地址：/api/mcp-protocol（JSON-RPC 2.0，streamable-http）。/api/mcp 仅用于 REST 发现，不是连接地址。
- 托管分析：MCP `analyze` 工具和 POST /api/analyze 对你发送的文件运行开源引擎 hefesto-ai（`hefesto analyze --no-config`）：最多 20 个文件，每个 100 KB，总计 256 KB，20 秒，每个 IP 每分钟 10 次请求；不存储任何内容
- 软件包包含 22 种格式；`hefesto analyze` 会运行全部 22 种
- 运行环境：Python 3.10+
- 遥测：CLI 默认向 PostHog US Cloud 发送使用数据（随机安装 ID 和计数；不含代码、文件路径和检查结果，IP 地址会被丢弃、不会保存），可用 `hefesto telemetry disable`、`HEFESTO_TELEMETRY=0` 或 `DO_NOT_TRACK=1` 关闭。GitHub Action 只有设置 `telemetry: 1` 才发送。`hefesto analyze` 还会向 pypi.org 查询新版本（缓存 24 小时）；从 4.20.3 起，设置 `HEFESTO_NO_UPDATE_CHECK=1`、`HEFESTO_TELEMETRY=0` 或 `DO_NOT_TRACK=1` 即可跳过这项检查（`hefesto telemetry disable` 不会跳过；4.20.2 及更早版本没有开关）。

## 安装
pip install hefesto-ai

## 添加为 MCP 服务器（Smithery）
npx @smithery/cli@latest mcp add artvepa80/hefestoai

## 价格
PRO：每月 8 美元。OMEGA：每月 19 美元。最新价格： https://hefestoai.narapallc.com

## MCP / API 端点
- [MCP](https://hefestoai.narapallc.com/api/mcp-protocol)
- [REST discovery](https://hefestoai.narapallc.com/api/mcp)
- [OpenAPI](https://hefestoai.narapallc.com/openapi.json)
- [Ask](https://hefestoai.narapallc.com/api/ask)
- [Agent descriptor](https://hefestoai.narapallc.com/.well-known/agent-card.json)
- [Agent 描述文件（简体中文）](https://hefestoai.narapallc.com/.well-known/agent.zh-CN.json)

## 链接
- [hefestoai.narapallc.com](https://hefestoai.narapallc.com)
- [github.com/artvepa80/Agents-Hefesto](https://github.com/artvepa80/Agents-Hefesto)
- [pypi.org/project/hefesto-ai](https://pypi.org/project/hefesto-ai/)
- [x.com/HefestoAI](https://x.com/HefestoAI)
- [English (canonical)](https://hefestoai.narapallc.com/llms.txt)