docs: update incremental setup notes
This commit is contained in:
parent
e51946176e
commit
504617566f
|
|
@ -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` 会拉取最新代码并自动执行增量安装。
|
||||
|
||||
### 强制全量重装
|
||||
|
||||
|
|
|
|||
|
|
@ -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` 强制重装门禁字段
|
||||
|
|
|
|||
Loading…
Reference in New Issue