# 安装与更新

Dever 安装包和编辑器插件从 [Releases](https://git.dever.cc/shemic/dever/releases) 下载。

## 安装 dever

先检查 `dever --help`，确认已有同名命令的归属，不直接删除或覆盖。Dever 语言与 Go 框架的 `dever-go` 是不同工具。

当前开发机支持 Linux x86_64，要求 glibc 2.39 或更新版本。首次安装还需要 Bash、`/usr/bin/python3` 3.9+、支持 Ed25519 的 `/usr/bin/openssl`；管道下载需要 curl。安装使用管理员权限，非 root 用户通过 `/usr/bin/sudo` 提权，查看帮助不提权。

取得机器安装授权后执行：

```sh
curl -fsSL https://git.dever.cc/shemic/dever/raw/branch/main/install | bash
```

无需先克隆源码或安装 skill。安装器下载最新正式版本，安装到 `/opt/dever`，提供 `/usr/local/bin/dever`，并安装、启动机器共享服务及必要的沙箱策略。无需系统 zstd。没有匹配平台的发行包或下载校验失败时明确报错。

将命令尾部的 `bash` 换为 `bash -s -- --help` 可查看参数，换为 `bash -s -- --version <准确版本>` 可指定版本。`--no-start` 只安装、不启动服务；应用编译仍需要共享服务可用。已下载脚本也可用 `bash install --help` 查看帮助。

基础安装包含编译器、应用编译资源、数据库运行库和配套 skill。Python、Node、Go 及第三方构建工具按实际依赖准备，同一版本由多个用户和项目共享。生成的应用不依赖系统 Python、Node、Go、Rust 或 Dever 编译器。

## 让 AI 遵守项目规则

在已有项目根目录执行：

```sh
dever skill install
```

命令自动读取项目的版本选择，从配套 skill 获取规则，写入当前项目的 `AGENTS.md`。文件不存在就创建；已有文件只更新 `dever-language` 管理块，保留其他内容。重复执行不会重复追加。不需要指定 AI 技能目录。

`dever new` 已自动生成同一份规则，无需再执行一次。机器安装和 `dever update` 不改业务项目文件；需要刷新项目规则块时重新执行 `dever skill install`。

AGENTS 要求 AI 开始任务前执行 `dever skill path .`，读取项目版本的完整 skill 与相关参考。skill 随 Dever 提供，无需复制到项目。AI 指引不能代替编译器检查或业务验证。

如果旧安装仍提示 `skill install` 需要目录参数，重新运行上面的官方安装命令升级命令入口，再执行本命令；不要改回旧用法。

## 按需准备依赖和 ARM64 应用目标

显式 `dever lib add/update <project-root> ...` 按需准备对应生态，只有依赖需要源码构建时才准备构建工具。已有 `dever.lock` 的项目在新机器运行 `dever lib install <project-root>`，按锁恢复，保持配置与锁文件不变；没有 Lib 的 Python/JS/Go Adapter 也可通过该命令准备环境。缺锁时先用 `dever lib update <project-root>` 生成锁，不把 install 当作重新选版本的 update。

Linux x86_64 开发机可准备 Linux ARM64 应用目标：

```sh
dever target add linux-aarch64
dever lib update <project-root> --target linux-aarch64
dever build <project-root> --target linux-aarch64 --output <新文件>
```

没有外部依赖时省略 lib update；已有匹配目标的锁时使用 lib install。目标依赖和原生扩展必须支持 ARM64。target add 准备当前活动版本，锁定其他编译器版本的项目先安装并选择对应版本。

依赖和目标准备会显式联网，后续 run/build 离线；缺资源时按提示准备，不扫描宿主 Python、Node、Go 或 PATH 充当运行环境。省略目标时使用本机架构，run/test 始终在本机执行。ARM64 应用目标不表示提供 ARM64 宿主编译器，macOS、Windows 宿主安装暂未提供。

Linux 外部调用要求系统支持所需 namespace 与 openat2。受限 AppArmor 环境需要安装器配置的专用策略；策略不满足要求时明确失败，不关闭沙箱继续执行。

## 更新与选择版本

```sh
sudo dever update
dever version
dever skill path
```

update 同步准备核心、配套 skill 和当前已安装的可选扩展，全部成功后才切换活动版本；未使用的扩展不下载，失败保留原活动版本。普通 check/test/run/build 不检查更新、不隐式联网。更新不改业务项目文件或数据库。

项目可在 `config/setting.json` 的 `dever.version` 锁定准确 `major.minor.patch`，未锁定时使用机器活动版本。`sudo dever install <版本>` 准备指定版本，`sudo dever use <版本>` 切换活动版本；项目锁定仍优先于活动版本。已有项目用 `dever skill path <project-root>` 读取对应指引，不仅凭最新指南采用新语法。

旧安装若仍访问已停用的下载地址，重新执行上述安装命令，再使用正常 update。该操作需要同样的机器安装权限。