From 504617566fb3ea0cdf0ec13690095b94106a917e Mon Sep 17 00:00:00 2001 From: xujiao Date: Thu, 9 Jul 2026 11:19:30 +0800 Subject: [PATCH] docs: update incremental setup notes --- README.md | 7 +------ docs/release.md | 10 +++++++--- 2 files changed, 8 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index b48a622..bed87f3 100644 --- a/README.md +++ b/README.md @@ -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` 会拉取最新代码并自动执行增量安装。 ### 强制全量重装 diff --git a/docs/release.md b/docs/release.md index e4d6a9d..b37c802 100644 --- a/docs/release.md +++ b/docs/release.md @@ -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` 强制重装门禁字段