Issue 模板: documentation
来源: Scene 1 文档可操作性评估（batch_id: 20260803_103134）
优先级: P0
关联 KEP: environment_prep（KEI: env_install_success_rate = 0）

Document Link（文档链接）

https://gitcode.com/cann/ops-cv/blob/master/docs/QUICKSTART.md （第 3 节"安装 AddExample 算子包"，第 68-74 行）

Issues Section（问题文档片段）

### 3. 安装AddExample算子包

```bash
./build_out/cann-ops-cv-*linux*.run

AddExample安装在${ASCEND_HOME_PATH}/opp/vendors路径中，${ASCEND_HOME_PATH}表示CANN软件安装目录。

## Existing Issues（存在的问题）

安装命令 `./build_out/cann-ops-cv-*linux*.run` 在实际环境中存在两个未文档化的问题：

### 1. sudo 权限需求

当 `${ASCEND_HOME_PATH}/opp/vendors/` 目录下已存在 root 权限的文件时（如之前以 root 安装过其他算子包），普通用户执行 `.run` 包会因 `cp` 权限被拒绝而失败。文档未说明此场景下需要使用 `sudo -E`（需 `-E` 保留 ASCEND_HOME_PATH 等环境变量）。

### 2. --force 参数

安装程序会校验依赖库 `libnnopbase.so`，当该库不在默认搜索路径时校验失败导致安装中断。文档未说明可使用 `--force` 参数跳过库验证。

### 重现过程

1. `./build_out/cann-ops-cv-*linux*.run` → Permission denied
2. `sudo ./build_out/cann-ops-cv-*linux*.run` → ASCEND_HOME_PATH 丢失
3. `sudo -E ./build_out/cann-ops-cv-*linux*.run` → libnnopbase.so 库验证失败
4. `sudo -E --force ./build_out/cann-ops-cv-*linux*.run` → 成功

### 建议改进

在安装步骤中补充：

- 说明可能需要 `sudo -E` 权限的场景（vendors 目录已有 root 权限文件时）
- 说明 `--force` 参数的使用场景（库验证失败时）
- 或提供 `--install-path` 替代方案以避免权限问题