docs: update incremental setup notes

This commit is contained in:
xujiao 2026-07-09 11:19:30 +08:00
parent e51946176e
commit 504617566f
2 changed files with 8 additions and 9 deletions

View File

@ -43,12 +43,7 @@ cd ~/app/netrans
make update
```
`make update` 会先拉取最新代码,再调用 `setup.sh` 做增量安装。增量安装根据本地 `.install_state` 判断哪些组件发生变化:
- `requirements.txt` 变化时重装 Python 依赖
- `vendor/` 变化时重装 acuity
- `script/``setup.sh` 变化时重新配置环境变量
- 其他普通代码更新只执行 `pip install -e .`
`make update` 会拉取最新代码并自动执行增量安装。
### 强制全量重装

View File

@ -160,14 +160,18 @@ def _sync_metadata_to_net(nn, net, model_filename, quantized, use_hybrid=False):
#### 功能说明
新增智能增量安装对比上次安装状态快照vendor 指纹、requirements 指纹、script/setup 指纹),只执行必要的安装步骤,避免每次都全量重装。
新增智能增量安装对比上次安装状态快照vendor 指纹、requirements 指纹、script/setup/安装路径指纹),只执行必要的安装步骤,避免每次都全量重装。
**判断逻辑**
- `.install_state`(本地快照,不提交)记录上次安装时各组件的指纹
- 指纹按文件内容计算,避免文件大小未变化时误判为无变化
- `.install_state` 只按白名单字段解析,不再作为 shell 脚本 source 执行
- `script/``setup.sh` 指纹按文件内容计算,并排除 Python 缓存文件
- `vendor/` 使用路径、大小、mtime 的快速元数据指纹,避免每次对完整 SDK 做内容 hash
- `VERSION` 中的 `FORCE_REINSTALL_SINCE` 字段指定最低全量重装版本
- 日常 git pull 后vendor 和 requirements 未变时,仅 `pip install -e`(秒级完成)
- pip 调用统一使用 `python3 -m pip`,确保安装到当前 Python 环境
- 安装脚本会检查必要文件、acuity whl 和 Vivante SDK cmdtools 目录
- `~/.bashrc` 中的 `PATH``VIV_SDK_PATH` 使用 Netrans 托管块维护,目录迁移时自动重写,避免重复追加旧路径
**使用方式**
@ -184,7 +188,7 @@ make version # 查看当前源码版本
#### 更新文件
- `setup.sh`: 新增并修正指纹对比和增量安装逻辑
- `setup.sh`: 新增并修正指纹对比、安装状态读取、结构检查和环境变量维护逻辑
- `Makefile`: 保留 `install`、`update`、`reinstall`、`version`、`check`、`clean` 用户目标
- `README.md`: 同步用户安装、更新和强制重装说明
- `VERSION`: 新增 `FORCE_REINSTALL_SINCE` 强制重装门禁字段