# Eve

**Repository Path**: garychk/Eve

## Basic Information

- **Project Name**: Eve
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-07
- **Last Updated**: 2026-07-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Eve

[English](README.md) | [中文](README.zh-CN.md)

Eve 是一门面向 AI 模型的可执行语义语言，以及一套 local-first
runtime。

AI 模型生成紧凑的 `.eve` 源码，Eve 再将其降低为 typed semantic DAG、
canonical protocol artifacts、execution plans、受控 capability calls、
receipts、replay evidence，以及必要时的 generated targets，例如 Web
项目。

人类通过 projections 和工具进行检查、批准、治理、调试和审计。人类不是
Eve 的主要源码作者。

## 状态

Eve Plan 2.0 已在 `2026-06-21` 完成 public release declaration，并在
`2026-06-24` 完成成熟 model-native GA 线的签收。

- Roadmap: [docs/roadmap.md](docs/roadmap.md)
- Public release signoff: [docs/eve-public-release-signoff-2026-06-21.md](docs/eve-public-release-signoff-2026-06-21.md)
- Model-native GA signoff: [docs/eve-model-native-ga-signoff-2026-06-24.md](docs/eve-model-native-ga-signoff-2026-06-24.md)
- Release gate: [docs/eve-protocol-release-v2.md](docs/eve-protocol-release-v2.md)
- Command contract: [docs/eve-command-surface-v1.md](docs/eve-command-surface-v1.md)

`docs/roadmap.md` 仍然是阶段顺序与完成状态的唯一真值。当前仓库依然按开发
阶段工作，因此只要有利于 Plan 2.0 收敛，就允许继续做破坏式重构。

## 官网部署

官网现已收口为由服务器侧 Nginx 承载 `https://eve.gcya.tech` 的纯静态站，
媒体资源单独从 `https://media.gcya.tech/eve/` 提供。

- 静态站目录：`/opt/www/eve`
- Nginx 参考配置：`deploy/nginx/eve.conf`
- 官网发布脚本：`deploy/scripts/publish-website.sh`
- 媒体上传脚本：`deploy/scripts/upload-website-media-to-oss.sh`

`website/assets/media/*` 仍然是仓库内首页媒体文件的源码真值，但它们不再作为
官网服务器运行态真值随页面一同部署。线上官网应直接从 CDN 媒体域名加载视频
与封面，而不是由官网服务器本地目录直接提供这些媒体文件。

## 安装

### 当前支持的操作系统与架构

当前 GitHub Release 官方发布的二进制仅包含：

- Linux `x86_64`，对应 `eve-linux-x86_64.tar.gz`
- macOS `arm64`（Apple Silicon），对应 `eve-darwin-arm64.tar.gz`

其他操作系统或架构目前还不在本仓库的官方发布矩阵内。若本地具备 Rust
toolchain 与所需依赖，仍可能可以从源码构建，但这不属于当前官方发布支持范围。

### 1. GitHub Release Binary

从 GitHub Release 页面下载对应平台的二进制包：

- `eve-linux-x86_64.tar.gz`
- `eve-darwin-arm64.tar.gz`

然后安装到 `PATH`：

```bash
tar -xzf eve-linux-x86_64.tar.gz
chmod +x eve
sudo mv eve /usr/local/bin/eve
```

macOS arm64 使用 `eve-darwin-arm64.tar.gz`，不要使用 Linux 包。

### 2. 从源码构建

```bash
cargo build --release -p eve-cli --bin eve
./target/release/eve doctor examples/phase8/local_quickstart
```

## Quickstart

```bash
eve new my-app --template reference-web
cd my-app
eve check
eve run
eve test
eve verify
eve build
eve doctor
```

`eve build` 会从 `.eve` 语义真值生成目标产物。对于 Web target，生成文件位于项目的 `generated/` 目录下。

## Starter Templates

推荐优先使用的官方模板：

- `reference-web`
- `reference-data-workflow`
- `reference-local-agent`
- `reference-os-automation`
- `reference-native-ui`

仍然保留的聚焦型 starter：

- `web-app`
- `audit-report`
- `structured-extraction`
- `external-commit-approval`

官方模板目录见 [docs/eve-official-template-catalog-v1.md](docs/eve-official-template-catalog-v1.md)。

## 常用流程

大多数用户一开始只需要这一条主链路：

```bash
eve new my-app --template reference-web
cd my-app
eve check
eve run
eve test
eve verify
eve build
eve doctor
```

其他常用命令分组：

- 意图闭环：`eve intent preview`、`eve intent apply`
- 包与兼容：`eve package inspect|resolve|verify-lock|audit`、`eve compat check`、`eve migrate --dry-run`
- Registry 与信任：`eve registry publish --dry-run`、`eve registry install`
- 运行证据：`eve debug trace`、`eve debug explain`、`eve ops health|replay-incident|export`
- Service 与 Agent：`eve service ...`、`eve agent ...`
- OS / automation / native：`eve os ...`、`eve automation ...`、`eve native ...`

完整冻结命令契约见 [docs/eve-command-surface-v1.md](docs/eve-command-surface-v1.md)。

## Eve 不是什么

Eve 不是围绕人类编码习惯设计的 Python、Java 或 JavaScript 替代品。它不是 JSON-first automation framework，不是 prompt-wrapper agent runtime，也不是不受限制的 shell/browser/network executor。

Eve 的源码真值是 `.eve`。JSON 只是用于检查、测试和 release evidence 的 projection surface。

## FAQ

### Q1. Eve 相比传统编程语言有什么优势？

Eve 的核心优势是让 AI 模型把意图表达为紧凑、类型化、可验证的语义，而不
是先绕到手写 host-language code。传统语言主要优化人类编码习惯；Eve 优化
的是模型生成、语义补丁、受控执行，以及不把生成代码当作源码真值的可验证
证据链。

### Q2. Eve 安装包小，是不是说明项目不完整？

不是。安装包大小本身不能证明项目完整或不完整。Eve 当前是 Rust-first 的本地工具链，公开二进制可以比携带大型标准运行时和生态的 Python、Java 发行包小很多。

### Q3. 这个项目是不是伪项目？

不是。Eve 不是只有文档，也不是 prompt wrapper。当前仓库已经具备真实的协议
与 runtime 链路：`.eve` source、semantic DAG、canonical artifacts、
execution plans、runtime execution、receipts、replay evidence、
package/registry/trust surfaces、service 与 agent 流程、OS 与 automation
boundary，以及 generated target proof。

### Q4. `eve build` 还是生成传统代码，相比直接写传统代码有什么优势？

优势在于：生成代码是输出，不是逻辑真值。Eve 把真值保存在 `.eve`、semantic DAG identity、execution plans、capability policy、receipts、replay 和 target diffs 中。

直接写传统代码时，代码库就是逻辑、副作用、测试和审计行为的主要承载处。Eve 的目标不同：模型先修改语义真值，runtime 或 integration path 需要时再生成或跳过 target code。

### Q5. 是否可以理解为自然语言 -> AI 模型 -> Eve -> 传统代码？

接近，但关键修正是：传统代码只是可选 target output。Eve 的目标主路径是：

```text
human intent
-> AI-authored .eve or semantic patch
-> semantic DAG
-> execution plan / bytecode
-> Eve runtime / capability adapters
-> receipts / replay / audit
-> optional generated target output
```

长期逻辑应该保存在 Eve artifacts 中。生成的传统代码可以服务 Web target、integration、deployment 或 migration，但不能成为主要反馈、调试、包管理、测试或执行真值。

### Q6. Eve 可以生成任何传统编程语言吗？

当前不能自动生成任何语言。Eve 可以逐步支持多个 target backend，但每个 target 都必须被实现、验证，并通过 manifest、target diff 和 audit evidence 追溯回 `.eve` 语义真值。

Eve 的目标不是为了生成所有语言而生成所有语言。目标是能直接执行时由 Eve runtime 直接执行，只有目标平台或集成确实需要时才生成传统代码。

### Q7. 任何 AI 模型都可以使用 Eve 吗？

Eve 的目标是 model-agnostic，不应该绑定某一家模型供应商。只要一个 AI 模型能够生成 `.eve`、应用 semantic patch、读取 diagnostics 并修复输出，它就可以在某种程度上使用 Eve。

不同模型使用 Eve 的稳定性会不同。强模型可以生成完整 package 和 workflow；
小模型可能更依赖 diagnostics、templates、repair loops、editor-facing
semantic projections、compatibility evidence，以及受信任的 registry
packet。

## 开发

```bash
cargo fmt --all --check
cargo test --workspace
```

常用本地验证：

```bash
cargo run -q -p eve-cli --bin eve -- check examples/phase8/local_quickstart
cargo run -q -p eve-cli --bin eve -- run examples/phase8/local_quickstart
cargo run -q -p eve-cli --bin eve -- test examples/phase8/local_quickstart
cargo run -q -p eve-cli --bin eve -- build examples/phase8/local_quickstart
cargo run -q -p eve-cli --bin eve -- doctor examples/phase8/local_quickstart
```

## 许可

可任选以下任一许可：

- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE))
- MIT License ([LICENSE-MIT](LICENSE-MIT))