已合并
docs(CANNLab): 文档优化 #120
liudi5525创建于 10 天前
docs(CANNLab): 文档优化 #120
已合并
共 11 个文件变更+342-295
| @@ -32,8 +32,8 @@ | |||
| 32 | - [3.1 环境申请](#31-环境申请) | 32 | - [3.1 环境申请](#31-环境申请) |
| 33 | - [环境提供的算力规格](#环境提供的算力规格) | 33 | - [环境提供的算力规格](#环境提供的算力规格) |
| 34 | - [使用规则](#使用规则) | 34 | - [使用规则](#使用规则) |
| 35 | - - [资源申请限制](#资源申请限制) | 35 | + - [环境申请限制](#环境申请限制) |
| 36 | - - [3.2 环境生命周期管理](#32-环境生命周期管理) | 36 | + - [3.2 环境管理](#32-环境管理) |
| 37 | - [3.3 CANN 软件栈管理](#33-cann-软件栈管理) | 37 | - [3.3 CANN 软件栈管理](#33-cann-软件栈管理) |
| 38 | - [查询 CANN 版本](#查询-cann-版本) | 38 | - [查询 CANN 版本](#查询-cann-版本) |
| 39 | - [查询驱动版本](#查询驱动版本) | 39 | - [查询驱动版本](#查询驱动版本) |
| @@ -270,20 +270,22 @@ cat /home/developer/image-version.txt | |||
| 270 | 270 | ||
| 271 | **NPU 环境：** | 271 | **NPU 环境：** |
| 272 | - 总计 100 卡时，卡时消耗完将**自动关机**并释放资源 | 272 | - 总计 100 卡时，卡时消耗完将**自动关机**并释放资源 |
| 273 | -- 算力消耗以"卡时"为单位，如创建 2 卡环境，最多可用 50 小时 | 273 | +- 算力消耗以"卡时"为单位，如创建 1 卡环境，最多可用 100 小时 |
| 274 | +- 卡时不足时，可通过参与 CANN 社区任务赚取积分兑换算力（100 积分 = 1 卡时） | ||
| 275 | +- **环境开机即消耗算力，建议不用时及时关机或删除** | ||
| 274 | 276 | ||
| 275 | **CPU 环境：** | 277 | **CPU 环境：** |
| 276 | - 总计 720 核时，核时消耗完将**自动关机**并释放资源 | 278 | - 总计 720 核时，核时消耗完将**自动关机**并释放资源 |
| 277 | - 算力消耗以"核时"为单位，如创建 16vCPUs 环境，最多可用 45 小时 | 279 | - 算力消耗以"核时"为单位，如创建 16vCPUs 环境，最多可用 45 小时 |
| 278 | - | ||
| 279 | - **环境开机即消耗算力，建议不用时及时关机或删除** | 280 | - **环境开机即消耗算力，建议不用时及时关机或删除** |
| 280 | 281 | ||
| 281 | #### 环境申请限制 | 282 | #### 环境申请限制 |
| 282 | 283 | ||
| 283 | - NPU 和 CPU 资源**各可申请一个** | 284 | - NPU 和 CPU 资源**各可申请一个** |
| 284 | -- NPU 资源类型切换（如 A2 → A3）需关机、删除后重新创建 | 285 | +- NPU 资源类型（A2/A3）不支持直接切换，需关机、删除后重新创建 |
| 285 | - **注意：环境删除时，`/mnt/workspace` 数据不会保存** | 286 | - **注意：环境删除时，`/mnt/workspace` 数据不会保存** |
| 286 | 287 | ||
| 288 | + | ||
| 287 | ### 3.2 环境管理 | 289 | ### 3.2 环境管理 |
| 288 | 290 | ||
| 289 | CANNLab 环境存在以下状态： | 291 | CANNLab 环境存在以下状态： |
| @@ -302,61 +304,10 @@ CANNLab 环境存在以下状态： | |||
| 302 | - **开机**：重新启动已关机或休眠的环境。 | 304 | - **开机**：重新启动已关机或休眠的环境。 |
| 303 | - **删除**：彻底销毁环境。**删除后所有数据不可恢复**，请提前备份或 Push 代码至 Git 仓库。 | 305 | - **删除**：彻底销毁环境。**删除后所有数据不可恢复**，请提前备份或 Push 代码至 Git 仓库。 |
| 304 | 306 | ||
| 305 | -> **说明** | ||
| 306 | -> - NPU 资源类型（A2/A3）不支持直接切换，需关机、删除后重新创建。 | ||
| 307 | 307 | ||
| 308 | -### 3.3 内置CANN软件包查看与升级 | 308 | +### 3.3 环境数据 |
| 309 | 309 | ||
| 310 | -#### 查询 CANN 版本 | 310 | +#### 数据持久化存储 |
| 311 | - | ||
| 312 | -CANN 包已预装，安装路径为 `/home/developer/Ascend`（注意：区别于自行安装的默认路径 `/usr/local/Ascend`）。 | ||
| 313 | - | ||
| 314 | -**方式一：查询环境变量** | ||
| 315 | -```bash | ||
| 316 | -env | grep ASCEND | ||
| 317 | -``` | ||
| 318 | - | ||
| 319 | -**方式二：查看版本文件** | ||
| 320 | -```bash | ||
| 321 | -cat /home/developer/Ascend/ascend-toolkit/latest/opp/version.info | ||
| 322 | -``` | ||
| 323 | - | ||
| 324 | -#### 升级 CANN 版本 | ||
| 325 | - | ||
| 326 | -**方式一：控制台一键升级（推荐）** | ||
| 327 | - | ||
| 328 | -1. 在 CANNLab 环境列表，点击 **"CANN包升级"** 按钮 | ||
| 329 | -2. 选择可升级的 CANN 包版本（如 9.0.0 正式版、master 分支构建版本） | ||
| 330 | -3. 确认升级结果： | ||
| 331 | - | ||
| 332 | -```bash | ||
| 333 | -cd /home/developer/.cann | ||
| 334 | -./manage_cann_pkg.sh --version | ||
| 335 | -``` | ||
| 336 | - | ||
| 337 | -返回 `task.status = 1` 且 `process = 100%` 表示升级成功。 | ||
| 338 | - | ||
| 339 | -**方式二：手动安装** | ||
| 340 | - | ||
| 341 | -通过WebIDE或者VSCode连接后，在终端中可手动下载安装 | ||
| 342 | - | ||
| 343 | -### 3.4 内置驱动版本查看与升级 | ||
| 344 | - | ||
| 345 | -#### 查询驱动版本 | ||
| 346 | - | ||
| 347 | -当前驱动版本为 **25.5.1**，安装路径为 `/usr/local/Ascend/driver`。 | ||
| 348 | - | ||
| 349 | -```bash | ||
| 350 | -cat /usr/local/Ascend/driver/version.info | grep Version | ||
| 351 | -``` | ||
| 352 | - | ||
| 353 | -#### 驱动版本升级 | ||
| 354 | - | ||
| 355 | -暂不支持个人环境的驱动版本升级，由平台统一规划。如有驱动版本依赖，请参考[问题反馈](#问题反馈)进行反馈。 | ||
| 356 | - | ||
| 357 | -### 3.5 数据管理 | ||
| 358 | - | ||
| 359 | -#### 持久化存储 | ||
| 360 | 311 | ||
| 361 | | 目录 | 持久化 | 说明 | | 312 | | 目录 | 持久化 | 说明 | |
| 362 | |:---|:---|:---| | 313 | |:---|:---|:---| |
| @@ -377,7 +328,12 @@ cat /usr/local/Ascend/driver/version.info | grep Version | |||
| 377 | 328 | ||
| 378 | 从 CANN 开源仓库入口创建的环境，会**自动 clone 该仓库的代码**至 `/mnt/workspace`，无需手动拉取。 | 329 | 从 CANN 开源仓库入口创建的环境，会**自动 clone 该仓库的代码**至 `/mnt/workspace`，无需手动拉取。 |
| 379 | 330 | ||
| 380 | -### 3.6 代码工程管理 | 331 | + |
| 332 | +### 3.4 代码工程管理 | ||
| 333 | + | ||
| 334 | +#### Git 免密操作 | ||
| 335 | + | ||
| 336 | +平台基于 GitCode 账号绑定自动完成 SSH 公私钥配置，`git clone` / `git push` 全程免密。 | ||
| 381 | 337 | ||
| 382 | #### 切换工程目录 | 338 | #### 切换工程目录 |
| 383 | 339 | ||
| @@ -385,15 +341,91 @@ cat /usr/local/Ascend/driver/version.info | grep Version | |||
| 385 | 341 | ||
| 386 | #### 分支管理 | 342 | #### 分支管理 |
| 387 | 343 | ||
| 388 | -当前自动 clone 的代码为 **master** 分支，如需其他分支请手动切换。指定分支的功能已在开发中。 | 344 | +当前自动 clone 代码时支持选择一个分支，如后续需其他分支请手动切换。 |
| 389 | 345 | ||
| 390 | -#### Git 免密操作 | ||
| 391 | 346 | ||
| 392 | -平台基于 GitCode 账号绑定自动完成 SSH 公私钥配置，`git clone` / `git push` 全程免密。 | 347 | +### 3.5 镜像管理 |
| 393 | 348 | ||
| 394 | -### 3.7 内置开发工具 | 349 | +镜像中内置了 CANN 软件包、Huawei OP DevTools 算子开发插件、PyPTO Toolkit、OpenCode 编码辅助等开发工具。 |
| 395 | 350 | ||
| 396 | -#### Huawei OP DevTools（算子开发插件） | 351 | +#### 查看当前镜像版本 |
| 352 | + | ||
| 353 | +**方式一：** 在 CANNLab 环境列表页，鼠标移至"模板名称"查看详情 | ||
| 354 | + | ||
| 355 | +**方式二：** 在环境内执行命令： | ||
| 356 | + | ||
| 357 | +```bash | ||
| 358 | +cat /home/developer/image-version.txt | ||
| 359 | +``` | ||
| 360 | + | ||
| 361 | +#### 镜像版本更新 | ||
| 362 | + | ||
| 363 | +| 场景 | 操作方式 | | ||
| 364 | +|:---|:---| | ||
| 365 | +| 需要全新环境 | 关机 -> 删除环境 -> 重新创建（注意备份数据） | | ||
| 366 | +| 仅升级 CANN 包 | 使用"CANN包升级"按钮 | | ||
| 367 | +| 仅升级算子插件 | WebIDE "扩展"中搜索更新 | | ||
| 368 | +| 仅升级 OpenCode | WebIDE "扩展"中搜索 "CANNBot Toolkit" 更新 | | ||
| 369 | + | ||
| 370 | +> **注意：** 暂不支持直接镜像升级。 | ||
| 371 | + | ||
| 372 | +--- | ||
| 373 | + | ||
| 374 | + | ||
| 375 | +#### 内置CANN软件包查看与升级 | ||
| 376 | + | ||
| 377 | +**查询 CANN 版本** | ||
| 378 | + | ||
| 379 | +CANN 包已预装，安装路径为 `/home/developer/Ascend`（注意：区别于自行安装的默认路径 `/usr/local/Ascend`）。 | ||
| 380 | + | ||
| 381 | +**方式一：查询环境变量** | ||
| 382 | +```bash | ||
| 383 | +env | grep ASCEND | ||
| 384 | +``` | ||
| 385 | + | ||
| 386 | +**方式二：查看版本文件** | ||
| 387 | +```bash | ||
| 388 | +cat /home/developer/Ascend/ascend-toolkit/latest/opp/version.info | ||
| 389 | +``` | ||
| 390 | + | ||
| 391 | +**升级 CANN 版本** | ||
| 392 | + | ||
| 393 | +**方式一：控制台一键升级（推荐）** | ||
| 394 | + | ||
| 395 | +1. 在 CANNLab 环境列表，点击 **"CANN包升级"** 按钮 | ||
| 396 | +2. 选择可升级的 CANN 包版本（如 9.0.0 正式版、master 分支构建版本） | ||
| 397 | +3. 确认升级结果： | ||
| 398 | + | ||
| 399 | +```bash | ||
| 400 | +cd /home/developer/.cann | ||
| 401 | +./manage_cann_pkg.sh --version | ||
| 402 | +``` | ||
| 403 | + | ||
| 404 | +返回 `task.status = 1` 且 `process = 100%` 表示升级成功。 | ||
| 405 | + | ||
| 406 | +**方式二：手动安装** | ||
| 407 | + | ||
| 408 | +通过WebIDE或者VSCode连接后，在终端中可手动下载安装 | ||
| 409 | + | ||
| 410 | + | ||
| 411 | +### 3.6 环境驱动版本查看与升级 | ||
| 412 | + | ||
| 413 | +#### 查询驱动版本 | ||
| 414 | + | ||
| 415 | +当前驱动版本为 **25.5.1**，安装路径为 `/usr/local/Ascend/driver`。 | ||
| 416 | + | ||
| 417 | +```bash | ||
| 418 | +cat /usr/local/Ascend/driver/version.info | grep Version | ||
| 419 | +``` | ||
| 420 | + | ||
| 421 | +#### 驱动版本升级 | ||
| 422 | + | ||
| 423 | +暂不支持个人对环境的驱动版本升级，由平台统一规划。 | ||
| 424 | + | ||
| 425 | + | ||
| 426 | +#### 内置开发工具 | ||
| 427 | + | ||
| 428 | +**Huawei OP DevTools（算子开发插件）** | ||
| 397 | 429 | ||
| 398 | 预装于云开发环境中，提供： | 430 | 预装于云开发环境中，提供： |
| 399 | 431 | ||
| @@ -409,7 +441,7 @@ cat /usr/local/Ascend/driver/version.info | grep Version | |||
| 409 | 441 | ||
| 410 | **升级方式：** WebIDE 连接后，左侧栏"扩展"中搜索 "Huawei OP DevTools" 进行版本选择。 | 442 | **升级方式：** WebIDE 连接后，左侧栏"扩展"中搜索 "Huawei OP DevTools" 进行版本选择。 |
| 411 | 443 | ||
| 412 | -#### PyPTO Toolkit | 444 | +**PyPTO Toolkit** |
| 413 | 445 | ||
| 414 | 预装于云开发环境中，面向 AI 加速器的高性能编程框架，简化复杂融合算子及模型网络的开发流程。 | 446 | 预装于云开发环境中，面向 AI 加速器的高性能编程框架，简化复杂融合算子及模型网络的开发流程。 |
| 415 | 447 | ||
| @@ -427,7 +459,7 @@ cat /usr/local/Ascend/driver/version.info | grep Version | |||
| 427 | - 大模型算子级实现与优化 | 459 | - 大模型算子级实现与优化 |
| 428 | - 需要极致性能调优的算子开发 | 460 | - 需要极致性能调优的算子开发 |
| 429 | 461 | ||
| 430 | -#### OpenCode | 462 | +**OpenCode** |
| 431 | 463 | ||
| 432 | 终端内置 OpenCode 工具，支持自然语言交互式编码辅助。 | 464 | 终端内置 OpenCode 工具，支持自然语言交互式编码辅助。 |
| 433 | 465 | ||
| @@ -469,30 +501,6 @@ opencode --version | |||
| 469 | 501 | ||
| 470 | **升级方式：** WebIDE 连接后，"扩展"中搜索 "CANNBot Toolkit"，或通过命令行更新。 | 502 | **升级方式：** WebIDE 连接后，"扩展"中搜索 "CANNBot Toolkit"，或通过命令行更新。 |
| 471 | 503 | ||
| 472 | -### 3.8 镜像管理 | ||
| 473 | - | ||
| 474 | -#### 查看当前镜像版本 | ||
| 475 | - | ||
| 476 | -**方式一：** 在 CANNLab 环境列表页，鼠标移至"模板名称"查看详情 | ||
| 477 | - | ||
| 478 | -**方式二：** 在环境内执行命令： | ||
| 479 | - | ||
| 480 | -```bash | ||
| 481 | -cat /home/developer/image-version.txt | ||
| 482 | -``` | ||
| 483 | - | ||
| 484 | -#### 镜像版本更新 | ||
| 485 | - | ||
| 486 | -| 场景 | 操作方式 | | ||
| 487 | -|:---|:---| | ||
| 488 | -| 需要全新环境 | 关机 -> 删除环境 -> 重新创建（注意备份数据） | | ||
| 489 | -| 仅升级 CANN 包 | 使用"CANN包升级"按钮 | | ||
| 490 | -| 仅升级算子插件 | WebIDE "扩展"中搜索更新 | | ||
| 491 | -| 仅升级 OpenCode | WebIDE "扩展"中搜索 "CANNBot Toolkit" 更新 | | ||
| 492 | - | ||
| 493 | -> **注意：** 暂不支持直接镜像升级。 | ||
| 494 | - | ||
| 495 | ---- | ||
| 496 | 504 | ||
| 497 | ## 4. 常见问题 | 505 | ## 4. 常见问题 |
| 498 | 506 | ||
| @@ -6,6 +6,7 @@ | |||
| 6 | |:---|:---|:---|:---| | 6 | |:---|:---|:---|:---| |
| 7 | | V1.0 | 2026-05-28 | maoyuanxing | 初始版本 | | 7 | | V1.0 | 2026-05-28 | maoyuanxing | 初始版本 | |
| 8 | | V2.0 | 2026-07-03 | miaoxuedan | 修订版本 | | 8 | | V2.0 | 2026-07-03 | miaoxuedan | 修订版本 | |
| 9 | +| V3.0 | 2026-08-17 | liudi5525 | 章节重构与优化 | | ||
| 9 | 10 | ||
| 10 | --- | 11 | --- |
| 11 | 12 | ||
| @@ -31,28 +32,24 @@ | |||
| 31 | - [3.1 环境申请](#31-环境申请) | 32 | - [3.1 环境申请](#31-环境申请) |
| 32 | - [3.1.1 环境提供的算力规格](#311-环境提供的算力规格) | 33 | - [3.1.1 环境提供的算力规格](#311-环境提供的算力规格) |
| 33 | - [3.1.2 使用规则](#312-使用规则) | 34 | - [3.1.2 使用规则](#312-使用规则) |
| 34 | - - [3.1.3 资源申请限制](#313-资源申请限制) | 35 | + - [3.1.3 环境申请限制](#313-环境申请限制) |
| 35 | - - [3.2 环境生命周期管理](#32-环境生命周期管理) | 36 | + - [3.2 环境管理](#32-环境管理) |
| 36 | - - [3.3 CANN 软件栈管理](#33-cann-软件栈管理) | 37 | + - [3.3 环境数据](#33-环境数据) |
| 37 | - - [3.3.1 查询 CANN 版本](#331-查询-cann-版本) | 38 | + - [3.3.1 数据持久化存储](#331-数据持久化存储) |
| 38 | - - [3.3.2 查询驱动版本](#332-查询驱动版本) | 39 | + - [3.3.2 文件上传与下载](#332-文件上传与下载) |
| 39 | - - [3.3.3 升级 CANN 版本](#333-升级-cann-版本) | 40 | + - [3.4 代码工程管理](#34-代码工程管理) |
| 40 | - - [3.3.4 驱动版本升级](#334-驱动版本升级) | 41 | + - [3.4.1 代码自动拉取](#341-代码自动拉取) |
| 41 | - - [3.4 数据管理](#34-数据管理) | 42 | + - [3.4.2 Git 免密操作](#342-git-免密操作) |
| 42 | - - [3.4.1 持久化存储](#341-持久化存储) | 43 | + - [3.4.3 切换工程目录](#343-切换工程目录) |
| 43 | - - [3.4.2 文件上传与下载](#342-文件上传与下载) | 44 | + - [3.4.4 分支管理](#344-分支管理) |
| 44 | - - [3.4.3 代码自动拉取](#343-代码自动拉取) | 45 | + - [3.5 镜像管理](#35-镜像管理) |
| 45 | - - [3.5 代码工程管理](#35-代码工程管理) | 46 | + - [3.5.1 查看当前镜像版本](#351-查看当前镜像版本) |
| 46 | - - [3.5.1 切换工程目录](#351-切换工程目录) | 47 | + - [3.5.2 镜像版本更新](#352-镜像版本更新) |
| 47 | - - [3.5.2 分支管理](#352-分支管理) | 48 | + - [3.5.3 内置CANN软件包查看与升级](#353-内置cann软件包查看与升级) |
| 48 | - - [3.5.3 Git 免密操作](#353-git-免密操作) | 49 | + - [3.5.4 内置开发工具](#354-内置开发工具) |
| 49 | - - [3.6 内置开发工具](#36-内置开发工具) | 50 | + - [3.6 环境驱动版本查看与升级](#36-环境驱动版本查看与升级) |
| 50 | - - [3.6.1 Ascend C Toolkit（算子开发插件）](#361-ascend-c-toolkit算子开发插件) | 51 | + - [3.6.1 查询驱动版本](#361-查询驱动版本) |
| 51 | - - [3.6.2 PyPTO Toolkit](#362-pypto-toolkit) | 52 | + - [3.6.2 驱动版本升级](#362-驱动版本升级) |
| 52 | - - [3.6.3 CANNBot 插件](#363-cannbot-插件) | ||
| 53 | - - [3.7 镜像管理](#37-镜像管理) | ||
| 54 | - - [3.7.1 查看当前镜像版本](#371-查看当前镜像版本) | ||
| 55 | - - [3.7.2 镜像版本更新](#372-镜像版本更新) | ||
| 56 | - [4. 常见问题](#4-常见问题) | 53 | - [4. 常见问题](#4-常见问题) |
| 57 | - [4.1 WebIDE 连接类问题](#41-webide-连接类问题) | 54 | - [4.1 WebIDE 连接类问题](#41-webide-连接类问题) |
| 58 | - [Q1：页面隔一段时间，提示："网络不稳定，webide恢复中，请稍后（28秒）"](#q1页面隔一段时间提示网络不稳定webide恢复中请稍后28秒) | 55 | - [Q1：页面隔一段时间，提示："网络不稳定，webide恢复中，请稍后（28秒）"](#q1页面隔一段时间提示网络不稳定webide恢复中请稍后28秒) |
| @@ -64,7 +61,7 @@ | |||
| 64 | - [Q2：VSCode 隔一段时间不操作会断连，且需要再次进行 AtomGit 授权](#q2vscode-隔一段时间不操作会断连且需要再次进行-atomgit-授权) | 61 | - [Q2：VSCode 隔一段时间不操作会断连，且需要再次进行 AtomGit 授权](#q2vscode-隔一段时间不操作会断连且需要再次进行-atomgit-授权) |
| 65 | - [4.3 其它问题](#43-其它问题) | 62 | - [4.3 其它问题](#43-其它问题) |
| 66 | - [Q1：编译算子时提示找不到头文件](#q1编译算子时提示找不到头文件) | 63 | - [Q1：编译算子时提示找不到头文件](#q1编译算子时提示找不到头文件) |
| 67 | - - [Q2：创建实例时提示资源不足](#q2创建实例时提示资源不足) | 64 | + - [Q2：创建环境时提示资源不足](#q2创建环境时提示资源不足) |
| 68 | - [Q3：找不到代码工程目录](#q3找不到代码工程目录) | 65 | - [Q3：找不到代码工程目录](#q3找不到代码工程目录) |
| 69 | - [5. 问题反馈](#5-问题反馈) | 66 | - [5. 问题反馈](#5-问题反馈) |
| 70 | - [5.1 问题反馈](#51-问题反馈) | 67 | - [5.1 问题反馈](#51-问题反馈) |
| @@ -88,9 +85,9 @@ CANNLab 是 CANN 社区推出的提供 NPU 算力资源的一站式云开发平 | |||
| 88 | | 特点 | 说明 | | 85 | | 特点 | 说明 | |
| 89 | |:---|:---| | 86 | |:---|:---| |
| 90 | | **零配置开发环境** | 预装 WebIDE、Git、CANN 基础包（当前为 9.0.0 正式版本）及算子开发插件，开箱即用 | | 87 | | **零配置开发环境** | 预装 WebIDE、Git、CANN 基础包（当前为 9.0.0 正式版本）及算子开发插件，开箱即用 | |
| 91 | -| **多种算力规格** | 支持 A2、A3 昇腾算力实例以及 950 CPU 仿真实例 | | 88 | +| **多种算力规格** | 支持 A2、A3 昇腾算力环境以及 950 CPU 仿真环境 | |
| 92 | | **双端连接** | 支持 WebIDE（浏览器直接使用）与本地 VSCode Remote-SSH 远程连接 | | 89 | | **双端连接** | 支持 WebIDE（浏览器直接使用）与本地 VSCode Remote-SSH 远程连接 | |
| 93 | -| **数据持久化** | 持久化目录 `/mnt/workspace` 和 `/home` 在实例关机后数据保留，保障代码安全 | | 90 | +| **数据持久化** | 持久化目录 `/mnt/workspace` 和 `/home` 在环境关机后数据保留，保障代码安全 | |
| 94 | | **免费算力** | 开发者享有初始 100 卡时免费额度，后续可以通过积分兑换卡时 | | 91 | | **免费算力** | 开发者享有初始 100 卡时免费额度，后续可以通过积分兑换卡时 | |
| 95 | | **工具链集成** | 内置 Ascend C Toolkit 算子开发插件，PyPTO Toolkit、CANNBot Toolkit 等辅助工具 | | 92 | | **工具链集成** | 内置 Ascend C Toolkit 算子开发插件，PyPTO Toolkit、CANNBot Toolkit 等辅助工具 | |
| 96 | 93 | ||
| @@ -112,11 +109,11 @@ CANNLab 是 CANN 社区推出的提供 NPU 算力资源的一站式云开发平 | |||
| 112 | 109 | ||
| 113 | | 术语 | 说明 | | 110 | | 术语 | 说明 | |
| 114 | |:---|:---| | 111 | |:---|:---| |
| 115 | -| **实例** | CANNLab 提供的云端计算单元，包含 CANN 软件栈及开发工具 | | 112 | +| **环境** | CANNLab 提供的云端计算单元，包含 CANN 软件栈及开发工具 | |
| 116 | | **镜像** | 预装好开发环境的模板，包含 CANN 基础包、Python 环境及其他内置工具 | | 113 | | **镜像** | 预装好开发环境的模板，包含 CANN 基础包、Python 环境及其他内置工具 | |
| 117 | | **卡时** | 算力资源的计量单位，1 卡时 = NPU 卡数量 × 使用时长（小时） | | 114 | | **卡时** | 算力资源的计量单位，1 卡时 = NPU 卡数量 × 使用时长（小时） | |
| 118 | -| **工作空间** | 挂载在 `/mnt/workspace` 和 `/home` 的持久化存储目录，实例关机后数据保留 | | 115 | +| **工作空间** | 挂载在 `/mnt/workspace` 和 `/home` 的持久化存储目录，环境关机后数据保留 | |
| 119 | -| **NPU 实例** | 搭载昇腾 NPU 卡的计算实例，支持 A2 和 A3 | | 116 | +| **NPU 环境** | 搭载昇腾 NPU 卡的计算环境，支持 A2 和 A3 | |
| 120 | | **CPU 仿真环境** | 搭载 ARM CPU 的计算环境，用于无 NPU 依赖的算子逻辑验证与 UT 测试 | | 117 | | **CPU 仿真环境** | 搭载 ARM CPU 的计算环境，用于无 NPU 依赖的算子逻辑验证与 UT 测试 | |
| 121 | 118 | ||
| 122 | ## 2. 快速入门 | 119 | ## 2. 快速入门 |
| @@ -179,12 +176,12 @@ CANNLab 是 CANN 社区推出的提供 NPU 算力资源的一站式云开发平 | |||
| 179 | > **说明** | 176 | > **说明** |
| 180 | > - 推荐使用 Chrome 浏览器 | 177 | > - 推荐使用 Chrome 浏览器 |
| 181 | > - WebIDE 支持同时开启最多 **3 个**独立工作窗口，但不推荐开启多个工作窗口 | 178 | > - WebIDE 支持同时开启最多 **3 个**独立工作窗口，但不推荐开启多个工作窗口 |
| 182 | -> - 如遇到页面卡住或连接断开，可尝试关机再开机恢复实例 | 179 | +> - 如遇到页面卡住或连接断开，可尝试关机再开机恢复环境 |
| 183 | 180 | ||
| 184 | ##### 2.2.2.2 本地 VSCode 连接 | 181 | ##### 2.2.2.2 本地 VSCode 连接 |
| 185 | 182 | ||
| 186 | 1. 点击 **"连接"** -> 选择 **"Visual Studio Code"** | 183 | 1. 点击 **"连接"** -> 选择 **"Visual Studio Code"** |
| 187 | -2. 首次使用需安装 AtomGit Dev Space 和 Remote SSH 插件，根据提示依次操作 | 184 | +2. 首次使用需安装 CANNLab Dev Space 和 Remote SSH 插件，根据提示依次操作 |
| 188 | 3. 点击插件图标 -> "登录"，在浏览器中选择 AtomGit 账号授权 | 185 | 3. 点击插件图标 -> "登录"，在浏览器中选择 AtomGit 账号授权 |
| 189 | 186 | ||
| 190 |  | 187 |  |
| @@ -197,7 +194,7 @@ CANNLab 是 CANN 社区推出的提供 NPU 算力资源的一站式云开发平 | |||
| 197 | 194 | ||
| 198 | 6. 连接成功后，即可看到如下窗口： | 195 | 6. 连接成功后，即可看到如下窗口： |
| 199 | 196 | ||
| 200 | -  | 197 | +  |
| 201 | 198 | ||
| 202 | > **说明** | 199 | > **说明** |
| 203 | > - 插件闲时未操作自动退出时间为 24 小时，24 小时内有操作不会断连 | 200 | > - 插件闲时未操作自动退出时间为 24 小时，24 小时内有操作不会断连 |
| @@ -234,42 +231,125 @@ cat /home/developer/image-version.txt | |||
| 234 | 231 | ||
| 235 | #### 3.1.2 使用规则 | 232 | #### 3.1.2 使用规则 |
| 236 | 233 | ||
| 237 | -**开发者：** | 234 | +**NPU 环境：** |
| 238 | -- 总计 100 卡时，卡时消耗完将**自动关机**并释放资源 | 235 | +- 总计 100 算力时长，消耗完将**自动关机**并释放资源 |
| 239 | -- 算力消耗以"卡时"为单位，如创建 2 卡实例，最多可用 50 小时 | 236 | +- 算力消耗以"卡时"为单位，如创建 1 卡环境，最多可用 100 小时 |
| 240 | -- **建议闲时及时关机或删除，避免配额无谓消耗** | 237 | +- 卡时不足时，可参与 CANN 社区任务赚积分兑换算力（100 积分 = 1 卡时） |
| 238 | +- **环境开机即消耗算力，建议不用时及时关机** | ||
| 241 | 239 | ||
| 242 | -#### 3.1.3 资源申请限制 | 240 | +**CPU 环境：** |
| 241 | +- 总计 720 算力时长，消耗完将**自动关机**并释放资源 | ||
| 242 | +- 算力消耗以"核时"为单位，如创建 16vCPUs 环境，最多可用 45 小时 | ||
| 243 | +- **环境开机即消耗算力，建议不用时及时关机** | ||
| 244 | + | ||
| 245 | +#### 3.1.3 环境申请限制 | ||
| 243 | 246 | ||
| 244 | - NPU 和 CPU 资源**可各申请一个** | 247 | - NPU 和 CPU 资源**可各申请一个** |
| 245 | -- NPU 资源类型切换（如 A2 → A3）需关机、删除后重新创建 | 248 | +- NPU 资源类型（A2/A3）不支持直接切换，需关机、删除后重新创建 |
| 246 | -- **注意：实例删除时，`/mnt/workspace` 和 `/home` 数据不会保存** | 249 | +- **注意：环境删除时，`/mnt/workspace` 和 `/home` 数据不会保存** |
| 247 | 250 | ||
| 248 | -### 3.2 环境生命周期管理 | 251 | +### 3.2 环境管理 |
| 249 | 252 | ||
| 250 | -CANNLab 实例存在以下状态： | 253 | +CANNLab 环境存在以下状态： |
| 251 | 254 | ||
| 252 | | 状态 | 说明 | 是否消耗卡时 | | 255 | | 状态 | 说明 | 是否消耗卡时 | |
| 253 | |:---|:---|:---| | 256 | |:---|:---|:---| |
| 254 | -| **运行中** | 实例正在运行，可进行开发操作 | 是 | | 257 | +| **运行中** | 环境正在运行，可进行开发操作 | 是 | |
| 255 | -| **关机** | 实例已停止，`/mnt/workspace` 和 `/home` 数据保留 | 否 | | 258 | +| **关机** | 环境已停止，`/mnt/workspace` 和 `/home` 数据保留 | 否 | |
| 256 | | **休眠** | 长时间无操作自动挂起，数据保留 | 否 | | 259 | | **休眠** | 长时间无操作自动挂起，数据保留 | 否 | |
| 257 | -| **已删除** | 实例已销毁，数据不可恢复 | - | | 260 | +| **已删除** | 环境已销毁，数据不可恢复 | - | |
| 258 | 261 | ||
| 259 | **操作说明：** | 262 | **操作说明：** |
| 260 | 263 | ||
| 261 | -- **关机**：停止实例运行，释放算力资源。`/mnt/workspace` 和 `/home` 下的数据持久化保留，其他目录数据丢失。 | 264 | +- **关机**：停止环境运行，释放算力资源。`/mnt/workspace` 和 `/home` 下的数据持久化保留，其他目录数据丢失。 |
| 262 | -- **开机**：重新启动已关机或休眠的实例。 | 265 | +- **开机**：重新启动已关机或休眠的环境。 |
| 263 | -- **删除**：彻底销毁实例。**删除后所有数据不可恢复**，请提前备份或 Push 代码至 Git 仓库。 | 266 | +- **删除**：彻底销毁环境。**删除后所有数据不可恢复**，请提前备份或 Push 代码至 Git 仓库。 |
| 264 | 267 | ||
| 265 | -> **说明** | ||
| 266 | -> - NPU 资源类型（A2/A3）不支持直接切换，需关机、删除后重新创建。 | ||
| 267 | 268 | ||
| 268 | -### 3.3 CANN 软件栈管理 | ||
| 269 | 269 | ||
| 270 | -#### 3.3.1 查询 CANN 版本 | 270 | +### 3.3 环境数据 |
| 271 | 271 | ||
| 272 | -CANN 包已预装，安装路径为 `/home/developer/Ascend`（注意：区别于自行安装的默认路径 `/usr/local/Ascend`）。 | 272 | +#### 3.3.1 数据持久化存储 |
| 273 | + | ||
| 274 | +| 目录 | 持久化 | 说明 | | ||
| 275 | +|:---|:---|:---| | ||
| 276 | +| `/mnt/workspace` | ✅ 持久化 | 环境关机后数据保留，环境**删除**后数据清除 | | ||
| 277 | +| `/home` | ✅ 持久化 | 环境关机后数据保留，环境**删除**后数据清除 | | ||
| 278 | +| 其他系统目录 | ❌ 非持久化 | 环境**删除**后数据丢失 | | ||
| 279 | + | ||
| 280 | +> **重要提示** | ||
| 281 | +> - 请将所有代码工程、数据集、模型文件等重要文件存放于 `/mnt/workspace` 或 `/home` 目录下 | ||
| 282 | +> - 环境删除操作不可逆，请提前备份重要数据 | ||
| 283 | + | ||
| 284 | +#### 3.3.2 文件上传与下载 | ||
| 285 | + | ||
| 286 | +支持通过 WebIDE 界面或 VSCode 插件直接上传/下载文件。 | ||
| 287 | + | ||
| 288 | +**WebIDE 上传和下载：** | ||
| 289 | + | ||
| 290 | + | ||
| 291 | + | ||
| 292 | +**VSCode 下载：** | ||
| 293 | + | ||
| 294 | + | ||
| 295 | + | ||
| 296 | +**VSCode 上传：** 直接把文件拖动到对应目录即可。 | ||
| 297 | + | ||
| 298 | +> **注意：** 建议上传/下载的文件不要太大，过大的文件可能无法直接传输成功，需要通过分片或压缩解压等方式处理。 | ||
| 299 | + | ||
| 300 | + | ||
| 301 | +### 3.4 代码工程管理 | ||
| 302 | + | ||
| 303 | +#### 3.4.1 代码自动拉取 | ||
| 304 | + | ||
| 305 | +在新建环境时，可以**添加预加载代码仓**，在环境创建时，会**自动 clone 该仓库的代码**至 `/mnt/workspace`，无需手动拉取。如果在新建环境时没有添加预加载代码仓，环境创建将不会 clone 任何代码仓。 | ||
| 306 | + | ||
| 307 | +#### 3.4.2 Git 免密操作 | ||
| 308 | + | ||
| 309 | +平台基于 AtomGit 账号绑定自动完成 SSH 公私钥配置，`git clone` / `git push` 全程免密。 | ||
| 310 | + | ||
| 311 | +#### 3.4.3 切换工程目录 | ||
| 312 | + | ||
| 313 | +在 WebIDE 中：文件（File）-> 打开项目（Open Project）-> 选择对应仓库目录。 | ||
| 314 | + | ||
| 315 | + | ||
| 316 | +#### 3.4.4 分支管理 | ||
| 317 | + | ||
| 318 | +当前自动 clone 代码时支持选择一个分支，如后续需其他分支请手动切换。 | ||
| 319 | + | ||
| 320 | +### 3.5 镜像管理 | ||
| 321 | + | ||
| 322 | +CANNLab 环境基于预配置的镜像创建，镜像中内置了 CANN 软件包、Ascend C Toolkit 算子开发插件、PyPTO Toolkit、CANNBot 编码辅助等开发工具。本节介绍如何查看和更新镜像中的组件。 | ||
| 323 | + | ||
| 324 | +#### 3.5.1 查看当前镜像版本 | ||
| 325 | + | ||
| 326 | +**方式一：** 在 CANNLab 环境列表页，鼠标移至"镜像/规格"查看详情 | ||
| 327 | + | ||
| 328 | +**方式二：** 在环境内执行命令 | ||
| 329 | + | ||
| 330 | +```bash | ||
| 331 | +cat /home/developer/image-version.txt | ||
| 332 | +``` | ||
| 333 | + | ||
| 334 | +#### 3.5.2 镜像版本更新 | ||
| 335 | + | ||
| 336 | +根据需求选择合适的更新方式： | ||
| 337 | + | ||
| 338 | +| 场景 | 操作方式 | | ||
| 339 | +|:---|:---| | ||
| 340 | +| 需要全新环境 | 关机 -> 删除环境 -> 重新创建（注意备份数据） | | ||
| 341 | +| 仅升级 CANN 包 | 使用"CANN包升级"按钮 | | ||
| 342 | +| 仅升级算子插件 | 在"扩展"中搜索插件名称更新 | | ||
| 343 | + | ||
| 344 | +> **注意：** 暂不支持直接升级镜像。 | ||
| 345 | + | ||
| 346 | +#### 3.5.3 内置CANN软件包查看与升级 | ||
| 347 | + | ||
| 348 | +CANN 软件包是昇腾 AI 处理器的核心软件栈，已预装在环境中。 | ||
| 349 | + | ||
| 350 | +##### 3.5.3.1 查询 CANN 版本 | ||
| 351 | + | ||
| 352 | +CANN 包安装路径为 `/home/developer/Ascend`（注意：区别于自行安装的默认路径 `/usr/local/Ascend`）。 | ||
| 273 | 353 | ||
| 274 | **方式一：查询环境变量** | 354 | **方式一：查询环境变量** |
| 275 | ```bash | 355 | ```bash |
| @@ -281,19 +361,11 @@ env | grep ASCEND | |||
| 281 | cat /home/developer/Ascend/ascend-toolkit/latest/opp/version.info | 361 | cat /home/developer/Ascend/ascend-toolkit/latest/opp/version.info |
| 282 | ``` | 362 | ``` |
| 283 | 363 | ||
| 284 | -#### 3.3.2 查询驱动版本 | 364 | +##### 3.5.3.2 升级 CANN 版本 |
| 285 | - | ||
| 286 | -当前驱动版本为 **25.5.0（A2）、25.5.5（A3）**，路径为 `/usr/local/Ascend/driver`。 | ||
| 287 | - | ||
| 288 | -```bash | ||
| 289 | -cat /usr/local/Ascend/driver/version.info | grep Version | ||
| 290 | -``` | ||
| 291 | - | ||
| 292 | -#### 3.3.3 升级 CANN 版本 | ||
| 293 | 365 | ||
| 294 | **方式一：控制台一键升级（推荐）** | 366 | **方式一：控制台一键升级（推荐）** |
| 295 | 367 | ||
| 296 | -1. 在 CANNLab 实例列表，点击 **"CANN包升级"** 按钮 | 368 | +1. 在 CANNLab 环境列表，点击 **"CANN包升级"** 按钮 |
| 297 | 2. 选择可升级的 CANN 包版本（如 9.0.0 正式版、master 分支构建版本） | 369 | 2. 选择可升级的 CANN 包版本（如 9.0.0 正式版、master 分支构建版本） |
| 298 | 3. 确认升级结果： | 370 | 3. 确认升级结果： |
| 299 | 371 | ||
| @@ -308,49 +380,13 @@ cd /home/developer/.cann | |||
| 308 | 380 | ||
| 309 | 通过WebIDE或者VSCode连接后，在终端中可手动下载安装。 | 381 | 通过WebIDE或者VSCode连接后，在终端中可手动下载安装。 |
| 310 | 382 | ||
| 311 | -#### 3.3.4 驱动版本升级 | 383 | +除了 CANN 软件包，镜像中还预装了多种开发辅助工具，用于提升算子开发、性能调优等场景的效率。 |
| 312 | 384 | ||
| 313 | -暂不支持个人实例的驱动版本升级，由平台统一规划。如有驱动版本依赖，请参考[问题反馈](#问题反馈)进行反馈。 | 385 | +#### 3.5.4 内置开发工具 |
| 314 | 386 | ||
| 315 | -### 3.4 数据管理 | 387 | +环境中预装了多种开发辅助工具，提升开发效率。 |
| 316 | 388 | ||
| 317 | -#### 3.4.1 持久化存储 | 389 | +##### 3.5.4.1 Ascend C Toolkit（算子开发插件） |
| 318 | - | ||
| 319 | -| 目录 | 持久化 | 说明 | | ||
| 320 | -|:---|:---|:---| | ||
| 321 | -| `/mnt/workspace` | ✅ 持久化 | 实例关机后数据保留，实例**删除**后数据清除 | | ||
| 322 | -| `/home` | ✅ 持久化 | 实例关机后数据保留，实例**删除**后数据清除 | | ||
| 323 | -| 其他系统目录 | ❌ 非持久化 | 实例**删除**后数据丢失 | | ||
| 324 | - | ||
| 325 | -> **重要提示** | ||
| 326 | -> - 请将所有代码工程、数据集、模型文件等重要文件存放于 `/mnt/workspace` 或 `/home` 目录下 | ||
| 327 | -> - 实例删除操作不可逆，请提前备份重要数据 | ||
| 328 | - | ||
| 329 | -#### 3.4.2 文件上传与下载 | ||
| 330 | - | ||
| 331 | -支持通过 WebIDE 界面或 VSCode 插件直接上传/下载文件。 | ||
| 332 | - | ||
| 333 | -#### 3.4.3 代码自动拉取 | ||
| 334 | - | ||
| 335 | -在新建环境时，可以**添加预加载代码仓**，在环境实例化时，会**自动 clone 该仓库的代码**至 `/mnt/workspace`，无需手动拉取。如果在新建环境时没有添加预加载代码仓，环境实例化将不会 clone 任何代码仓。 | ||
| 336 | - | ||
| 337 | -### 3.5 代码工程管理 | ||
| 338 | - | ||
| 339 | -#### 3.5.1 切换工程目录 | ||
| 340 | - | ||
| 341 | -在 WebIDE 中：文件（File）-> 打开项目（Open Project）-> 选择对应仓库目录。 | ||
| 342 | - | ||
| 343 | -#### 3.5.2 分支管理 | ||
| 344 | - | ||
| 345 | -当前自动 clone 的代码为 **master** 分支，如需其他分支请手动切换。指定分支的功能正在开发中。 | ||
| 346 | - | ||
| 347 | -#### 3.5.3 Git 免密操作 | ||
| 348 | - | ||
| 349 | -平台基于 AtomGit 账号绑定自动完成 SSH 公私钥配置，`git clone` / `git push` 全程免密。 | ||
| 350 | - | ||
| 351 | -### 3.6 内置开发工具 | ||
| 352 | - | ||
| 353 | -#### 3.6.1 Ascend C Toolkit（算子开发插件） | ||
| 354 | 390 | ||
| 355 | 预装于云开发环境中，提供： | 391 | 预装于云开发环境中，提供： |
| 356 | 392 | ||
| @@ -368,7 +404,7 @@ cd /home/developer/.cann | |||
| 368 | 404 | ||
| 369 | 连接到环境后，左侧栏"扩展"中搜索 "Ascend C Toolkit"，在搜索到的 "Ascend C Toolkit" 插件上如果有"更新"图标，说明发布了新版本，在插件详情页面更新版本。为了简化操作，建议在插件详情页面勾选"自动更新"选项，后续插件将静默升级。 | 405 | 连接到环境后，左侧栏"扩展"中搜索 "Ascend C Toolkit"，在搜索到的 "Ascend C Toolkit" 插件上如果有"更新"图标，说明发布了新版本，在插件详情页面更新版本。为了简化操作，建议在插件详情页面勾选"自动更新"选项，后续插件将静默升级。 |
| 370 | 406 | ||
| 371 | -#### 3.6.2 PyPTO Toolkit | 407 | +##### 3.5.4.2 PyPTO Toolkit |
| 372 | 408 | ||
| 373 | 预装于云开发环境中，面向 AI 加速器的高性能编程框架，简化复杂融合算子及模型网络的开发流程。 | 409 | 预装于云开发环境中，面向 AI 加速器的高性能编程框架，简化复杂融合算子及模型网络的开发流程。 |
| 374 | 410 | ||
| @@ -391,7 +427,7 @@ cd /home/developer/.cann | |||
| 391 | 427 | ||
| 392 | 连接到环境后，左侧栏"扩展"中搜索 "PyPTO Toolkit"，在搜索到的 "PyPTO Toolkit" 插件上如果有"更新"图标，说明发布了新版本，在插件详情页面更新版本。为了简化操作，建议在插件详情页面勾选"自动更新"选项，后续插件将静默升级。 | 428 | 连接到环境后，左侧栏"扩展"中搜索 "PyPTO Toolkit"，在搜索到的 "PyPTO Toolkit" 插件上如果有"更新"图标，说明发布了新版本，在插件详情页面更新版本。为了简化操作，建议在插件详情页面勾选"自动更新"选项，后续插件将静默升级。 |
| 393 | 429 | ||
| 394 | -#### 3.6.3 CANNBot 插件 | 430 | +##### 3.5.4.3 CANNBot 插件 |
| 395 | 431 | ||
| 396 | 终端内置 CANNBot 工具，支持自然语言交互式编码辅助，提供免费token使用，具体可参考 [CANNBot用户手册](https://gitcode.com/cann/infrastructure/blob/master/docs/CANNBot/CANNBot-User-Guide.md) 。 | 432 | 终端内置 CANNBot 工具，支持自然语言交互式编码辅助，提供免费token使用，具体可参考 [CANNBot用户手册](https://gitcode.com/cann/infrastructure/blob/master/docs/CANNBot/CANNBot-User-Guide.md) 。 |
| 397 | 433 | ||
| @@ -399,31 +435,31 @@ cd /home/developer/.cann | |||
| 399 | 435 | ||
| 400 | 连接到环境后，左侧栏"扩展"中搜索 "CANNBot Toolkit"，在搜索到的 "CANNBot Toolkit" 插件上如果有"更新"图标，说明发布了新版本，在插件详情页面更新版本。为了简化操作，建议在插件详情页面勾选"自动更新"选项，后续插件将静默升级。 | 436 | 连接到环境后，左侧栏"扩展"中搜索 "CANNBot Toolkit"，在搜索到的 "CANNBot Toolkit" 插件上如果有"更新"图标，说明发布了新版本，在插件详情页面更新版本。为了简化操作，建议在插件详情页面勾选"自动更新"选项，后续插件将静默升级。 |
| 401 | 437 | ||
| 402 | -### 3.7 镜像管理 | ||
| 403 | 438 | ||
| 404 | -#### 3.7.1 查看当前镜像版本 | 439 | +### 3.6 环境驱动版本查看与升级 |
| 405 | 440 | ||
| 406 | -**方式一：** 在 CANNLab 实例列表页，鼠标移至"镜像/规格"查看详情 | 441 | +#### 3.6.1 查询驱动版本 |
| 407 | 442 | ||
| 408 | -**方式二：** 在环境内执行命令 | 443 | +当前驱动版本为 **25.5.0（A2）、25.5.5（A3）**，路径为 `/usr/local/Ascend/driver`。 |
| 409 | 444 | ||
| 410 | ```bash | 445 | ```bash |
| 411 | -cat /home/developer/image-version.txt | 446 | +cat /usr/local/Ascend/driver/version.info | grep Version |
| 412 | ``` | 447 | ``` |
| 413 | 448 | ||
| 414 | -#### 3.7.2 镜像版本更新 | 449 | +#### 3.6.2 驱动版本升级 |
| 415 | 450 | ||
| 416 | -| 场景 | 操作方式 | | 451 | +暂不支持个人对环境的驱动版本升级，由平台统一规划。 |
| 417 | -|:---|:---| | ||
| 418 | -| 需要全新环境 | 关机 -> 删除实例 -> 重新创建（注意备份数据） | | ||
| 419 | -| 仅升级 CANN 包 | 使用"CANN包升级"按钮 | | ||
| 420 | -| 仅升级算子插件 | 在"扩展"中搜索插件名称更新 | | ||
| 421 | 452 | ||
| 422 | -> **注意：** 暂不支持直接升级镜像。 | ||
| 423 | 453 | ||
| 424 | ## 4. 常见问题 | 454 | ## 4. 常见问题 |
| 425 | 455 | ||
| 426 | -### 4.1 WebIDE 连接类问题 | 456 | +### 4.1 创建环境类问题 |
| 457 | + | ||
| 458 | +#### Q1：创建环境时提示资源不足 | ||
| 459 | + | ||
| 460 | +**解决：** 当前资源池已无可用资源，请更换算力规格重试。 | ||
| 461 | + | ||
| 462 | +### 4.2 WebIDE 连接类问题 | ||
| 427 | 463 | ||
| 428 | #### Q1：页面隔一段时间，提示："网络不稳定，webide恢复中，请稍后（28秒）" | 464 | #### Q1：页面隔一段时间，提示："网络不稳定，webide恢复中，请稍后（28秒）" |
| 429 | 465 | ||
| @@ -450,7 +486,7 @@ cat /home/developer/image-version.txt | |||
| 450 | 486 | ||
| 451 | - 尝试使用 VSCode 进行连接： | 487 | - 尝试使用 VSCode 进行连接： |
| 452 | - VSCode 连接成功，可以尝试重启 codearts-server 进程。 | 488 | - VSCode 连接成功，可以尝试重启 codearts-server 进程。 |
| 453 | - - VSCode 连接失败，可以尝试实例关机再开机后恢复。 | 489 | + - VSCode 连接失败，可以尝试环境关机再开机后恢复。 |
| 454 | 490 | ||
| 455 | #### Q3：页面弹窗报"连接错误"，报错："云开发环境网络连接不稳定，您可以再次尝试连接（或者重启）以恢复连接。" | 491 | #### Q3：页面弹窗报"连接错误"，报错："云开发环境网络连接不稳定，您可以再次尝试连接（或者重启）以恢复连接。" |
| 456 | 492 | ||
| @@ -462,7 +498,7 @@ cat /home/developer/image-version.txt | |||
| 462 | 3. 可能是 GitCode 缓存失效或缓存被误清理，可尝试退出 GitCode 账号并重新登录，重新进入 CANNLab 平台 | 498 | 3. 可能是 GitCode 缓存失效或缓存被误清理，可尝试退出 GitCode 账号并重新登录，重新进入 CANNLab 平台 |
| 463 | 4. 如以上方式仍无法解决，请参考"问题反馈"咨询 | 499 | 4. 如以上方式仍无法解决，请参考"问题反馈"咨询 |
| 464 | 500 | ||
| 465 | -### 4.2 VSCode 连接类问题 | 501 | +### 4.3 VSCode 连接类问题 |
| 466 | 502 | ||
| 467 | #### Q1：VSCode右下角报错："WebSocket connection failed" | 503 | #### Q1：VSCode右下角报错："WebSocket connection failed" |
| 468 | 504 | ||
| @@ -478,7 +514,7 @@ VSCode右下角报错："WebSocket 连接失败" | |||
| 478 | 514 | ||
| 479 | **【解决思路】** | 515 | **【解决思路】** |
| 480 | - 确认是否为首次使用 VSCode 方式连接开发环境； | 516 | - 确认是否为首次使用 VSCode 方式连接开发环境； |
| 481 | -- 若是，检查 AtomGit Dev Space 插件的 proxy 和 remote-ssh 的配置是否正确。 | 517 | +- 若是，检查 CANNLab Dev Space 插件的 proxy 和 remote-ssh 的配置是否正确。 |
| 482 | 518 | ||
| 483 | #### Q2：VSCode 隔一段时间不操作会断连，且需要再次进行 AtomGit 授权 | 519 | #### Q2：VSCode 隔一段时间不操作会断连，且需要再次进行 AtomGit 授权 |
| 484 | 520 | ||
| @@ -494,7 +530,7 @@ VSCode 连接服务器通过 remote-ssh 连接，如果出现网络断开，可 | |||
| 494 | - 如果 VSCode 断连后，重新连接还需要跳转 AtomGit 进行登录，需要确认： | 530 | - 如果 VSCode 断连后，重新连接还需要跳转 AtomGit 进行登录，需要确认： |
| 495 | - 插件版本是否为最新版本，旧版本的闲时时间为2小时； | 531 | - 插件版本是否为最新版本，旧版本的闲时时间为2小时； |
| 496 | 532 | ||
| 497 | -### 4.3 其它问题 | 533 | +### 4.4 其它问题 |
| 498 | 534 | ||
| 499 | #### Q1：编译算子时提示找不到头文件 | 535 | #### Q1：编译算子时提示找不到头文件 |
| 500 | 536 | ||
| @@ -504,11 +540,7 @@ VSCode 连接服务器通过 remote-ssh 连接，如果出现网络断开，可 | |||
| 504 | source /home/developer/Ascend/ascend-toolkit/set_env.sh | 540 | source /home/developer/Ascend/ascend-toolkit/set_env.sh |
| 505 | ``` | 541 | ``` |
| 506 | 542 | ||
| 507 | -#### Q2：创建实例时提示资源不足 | 543 | +#### Q2：找不到代码工程目录 |
| 508 | - | ||
| 509 | -**解决：** 当前资源池已无可用资源，请更换算力规格重试。 | ||
| 510 | - | ||
| 511 | -#### Q3：找不到代码工程目录 | ||
| 512 | 544 | ||
| 513 | **排查：** 执行 `ls /mnt/workspace` 查看是否存在代码目录。如未自动拉取，请参考[问题反馈](#问题反馈)进行反馈。 | 545 | **排查：** 执行 `ls /mnt/workspace` 查看是否存在代码目录。如未自动拉取，请参考[问题反馈](#问题反馈)进行反馈。 |
| 514 | 546 | ||
| @@ -531,8 +563,8 @@ source /home/developer/Ascend/ascend-toolkit/set_env.sh | |||
| 531 | | **浏览器** | 推荐使用 Chrome 最新版，不支持 Firefox | | 563 | | **浏览器** | 推荐使用 Chrome 最新版，不支持 Firefox | |
| 532 | | **用户权限** | 操作用户为 `developer`，不支持直接使用 `root` 登录。可通过 `sudo` 命令切换到 `root` 权限 | | 564 | | **用户权限** | 操作用户为 `developer`，不支持直接使用 `root` 登录。可通过 `sudo` 命令切换到 `root` 权限 | |
| 533 | | **NPU 资源** | NPU 和 CPU 资源可各申请一个，不支持直接切换资源类型 | | 565 | | **NPU 资源** | NPU 和 CPU 资源可各申请一个，不支持直接切换资源类型 | |
| 534 | -| **镜像升级** | 暂不支持直接升级镜像，需关机、删除实例后重新创建 | | 566 | +| **镜像升级** | 暂不支持直接升级镜像，需关机、删除环境后重新创建 | |
| 535 | -| **驱动升级** | 暂不支持个人实例的驱动版本升级，由平台统一规划 | | 567 | +| **驱动升级** | 暂不支持个人环境的驱动版本升级，由平台统一规划 | |
| 536 | 568 | ||
| 537 | > **说明：** 以上约束可能随平台版本更新而调整，请关注 CANN 社区动态获取最新信息。 | 569 | > **说明：** 以上约束可能随平台版本更新而调整，请关注 CANN 社区动态获取最新信息。 |
| 538 | 570 | ||
Ddocs/CANNLab/V2/images/09_vscode_connected.png+0-0
| @@ -63,7 +63,7 @@ After the environment is created successfully, click **"Connect"** and select a | |||
| 63 | #### 2.2.2.2 Local VSCode Connection | 63 | #### 2.2.2.2 Local VSCode Connection |
| 64 | 64 | ||
| 65 | 1. Click **"Connect"** -> Select **"Visual Studio Code"** | 65 | 1. Click **"Connect"** -> Select **"Visual Studio Code"** |
| 66 | -2. On first use, install the AtomGit Dev Space and Remote SSH plugins as prompted. | 66 | +2. On first use, install the CANNLab Dev Space and Remote SSH plugins as prompted. |
| 67 | 3. Click the plugin icon -> "Login", then authorize with your AtomGit account in the browser. | 67 | 3. Click the plugin icon -> "Login", then authorize with your AtomGit account in the browser. |
| 68 | 68 | ||
| 69 |  | 69 |  |
| @@ -76,7 +76,7 @@ After the environment is created successfully, click **"Connect"** and select a | |||
| 76 | 76 | ||
| 77 | 6. After successful connection, you will see the following window: | 77 | 6. After successful connection, you will see the following window: |
| 78 | 78 | ||
| 79 | -  | 79 | +  |
| 80 | 80 | ||
| 81 | > **Note** | 81 | > **Note** |
| 82 | > - The plugin's idle logout time is 24 hours; operation within 24 hours will not cause disconnection | 82 | > - The plugin's idle logout time is 24 hours; operation within 24 hours will not cause disconnection |
| @@ -68,7 +68,7 @@ Error prompt 2: | |||
| 68 | 68 | ||
| 69 | **【Troubleshooting】** | 69 | **【Troubleshooting】** |
| 70 | - Confirm whether this is the first time using VSCode to connect to the development environment. | 70 | - Confirm whether this is the first time using VSCode to connect to the development environment. |
| 71 | -- If so, check whether the proxy and remote-ssh configurations of the AtomGit Dev Space plugin are correct. | 71 | +- If so, check whether the proxy and remote-ssh configurations of the CANNLab Dev Space plugin are correct. |
| 72 | 72 | ||
| 73 | ### Q2: VSCode disconnects after a period of inactivity and requires AtomGit authorization again | 73 | ### Q2: VSCode disconnects after a period of inactivity and requires AtomGit authorization again |
| 74 | 74 | ||
| @@ -63,7 +63,7 @@ | |||
| 63 | #### 2.2.2.2 本地 VSCode 连接 | 63 | #### 2.2.2.2 本地 VSCode 连接 |
| 64 | 64 | ||
| 65 | 1. 点击 **"连接"** -> 选择 **"Visual Studio Code"** | 65 | 1. 点击 **"连接"** -> 选择 **"Visual Studio Code"** |
| 66 | -2. 首次使用需安装 AtomGit Dev Space 和 Remote SSH 插件，根据提示允许即可 | 66 | +2. 首次使用需安装 CANNLab Dev Space 和 Remote SSH 插件，根据提示允许即可 |
| 67 | 3. 点击插件图标 -> "登录"，在浏览器中选择 AtomGit 账号授权 | 67 | 3. 点击插件图标 -> "登录"，在浏览器中选择 AtomGit 账号授权 |
| 68 | 68 | ||
| 69 |  | 69 |  |
| @@ -76,7 +76,7 @@ | |||
| 76 | 76 | ||
| 77 | 6. 连接成功后，即可看到如下窗口： | 77 | 6. 连接成功后，即可看到如下窗口： |
| 78 | 78 | ||
| 79 | -  | 79 | +  |
| 80 | 80 | ||
| 81 | > **说明** | 81 | > **说明** |
| 82 | > - 插件闲时未操作自动退出时间为 24 小时，24 小时内有操作不会断连 | 82 | > - 插件闲时未操作自动退出时间为 24 小时，24 小时内有操作不会断连 |
| @@ -15,20 +15,22 @@ | |||
| 15 | 15 | ||
| 16 | **NPU 环境：** | 16 | **NPU 环境：** |
| 17 | - 总计 100 卡时，卡时消耗完将**自动关机**并释放资源 | 17 | - 总计 100 卡时，卡时消耗完将**自动关机**并释放资源 |
| 18 | -- 算力消耗以"卡时"为单位，如创建 2 卡环境，最多可用 50 小时 | 18 | +- 算力消耗以"卡时"为单位，如创建 1 卡环境，最多可用 100 小时 |
| 19 | +- 卡时不足时，可通过参与 CANN 社区任务赚取积分兑换算力（100 积分 = 1 卡时） | ||
| 20 | +- **环境开机即消耗算力，建议不用时及时关机或删除** | ||
| 19 | 21 | ||
| 20 | **CPU 环境：** | 22 | **CPU 环境：** |
| 21 | - 总计 720 核时，核时消耗完将**自动关机**并释放资源 | 23 | - 总计 720 核时，核时消耗完将**自动关机**并释放资源 |
| 22 | - 算力消耗以"核时"为单位，如创建 16vCPUs 环境，最多可用 45 小时 | 24 | - 算力消耗以"核时"为单位，如创建 16vCPUs 环境，最多可用 45 小时 |
| 23 | - | ||
| 24 | - **环境开机即消耗算力，建议不用时及时关机或删除** | 25 | - **环境开机即消耗算力，建议不用时及时关机或删除** |
| 25 | 26 | ||
| 26 | ### 3.1.3 环境申请限制 | 27 | ### 3.1.3 环境申请限制 |
| 27 | 28 | ||
| 28 | - NPU 和 CPU 资源**可各申请一个** | 29 | - NPU 和 CPU 资源**可各申请一个** |
| 29 | -- NPU 资源类型切换（如 A2 → A3）需关机、删除后重新创建 | 30 | +- NPU 资源类型（A2/A3）不支持直接切换，需关机、删除后重新创建 |
| 30 | - **注意：环境删除时，`/mnt/workspace` 和 `/home` 数据不会保存** | 31 | - **注意：环境删除时，`/mnt/workspace` 和 `/home` 数据不会保存** |
| 31 | 32 | ||
| 33 | + | ||
| 32 | ## 3.2 环境管理 | 34 | ## 3.2 环境管理 |
| 33 | 35 | ||
| 34 | CANNLab 环境存在以下状态： | 36 | CANNLab 环境存在以下状态： |
| @@ -47,12 +49,72 @@ CANNLab 环境存在以下状态： | |||
| 47 | - **开机**：重新启动已关机或休眠的环境。 | 49 | - **开机**：重新启动已关机或休眠的环境。 |
| 48 | - **删除**：彻底销毁环境。**删除后所有数据不可恢复**，请提前备份或 Push 代码至 Git 仓库。 | 50 | - **删除**：彻底销毁环境。**删除后所有数据不可恢复**，请提前备份或 Push 代码至 Git 仓库。 |
| 49 | 51 | ||
| 50 | -> **说明** | ||
| 51 | -> - NPU 资源类型（A2/A3）不支持直接切换，需关机、删除后重新创建。 | ||
| 52 | 52 | ||
| 53 | -## 3.3 内置CANN软件包查看与升级 | 53 | +## 3.3 环境数据 |
| 54 | 54 | ||
| 55 | -### 3.3.1 查询 CANN 版本 | 55 | +### 3.3.1 数据持久化存储 |
| 56 | + | ||
| 57 | +| 目录 | 持久化 | 说明 | | ||
| 58 | +|:---|:---|:---| | ||
| 59 | +| `/mnt/workspace` | ✅ 持久化 | 环境关机后数据保留，环境**删除**后数据清除 | | ||
| 60 | +| `/home` | ✅ 持久化 | 环境关机后数据保留，环境**删除**后数据清除 | | ||
| 61 | +| 其他系统目录 | ❌ 非持久化 | 环境**删除**后数据丢失 | | ||
| 62 | + | ||
| 63 | +> **重要提示** | ||
| 64 | +> - 请将所有代码工程、数据集、模型文件等重要文件存放于 `/mnt/workspace` 或 `/home` 目录下 | ||
| 65 | +> - 环境删除操作不可逆，请提前备份重要数据 | ||
| 66 | + | ||
| 67 | +### 3.3.2 文件上传与下载 | ||
| 68 | + | ||
| 69 | +支持通过 WebIDE 界面或 VSCode 插件直接上传/下载文件。 | ||
| 70 | + | ||
| 71 | + | ||
| 72 | +## 3.4 代码工程管理 | ||
| 73 | + | ||
| 74 | +### 3.4.1 代码自动拉取 | ||
| 75 | + | ||
| 76 | +在新建环境时，可以**添加预加载代码仓**，在环境创建时，会**自动 clone 该仓库的代码**至 `/mnt/workspace`，无需手动拉取。如果在新建环境时没有添加预加载代码仓，环境创建将不会 clone 任何代码仓。 | ||
| 77 | + | ||
| 78 | +### 3.4.2 Git 免密操作 | ||
| 79 | + | ||
| 80 | +平台基于 AtomGit 账号绑定自动完成 SSH 公私钥配置，`git clone` / `git push` 全程免密。 | ||
| 81 | + | ||
| 82 | +### 3.4.3 切换工程目录 | ||
| 83 | + | ||
| 84 | +在 WebIDE 中：文件（File）-> 打开项目（Open Project）-> 选择对应仓库目录。 | ||
| 85 | + | ||
| 86 | +### 3.4.4 分支管理 | ||
| 87 | + | ||
| 88 | +当前自动 clone 代码时支持选择一个分支，如后续需其他分支请手动切换。 | ||
| 89 | + | ||
| 90 | + | ||
| 91 | +## 3.5 镜像管理 | ||
| 92 | + | ||
| 93 | +镜像中内置了 CANN 软件包、Ascend C Toolkit 算子开发插件、PyPTO Toolkit、CANNBot 编码辅助等开发工具。 | ||
| 94 | + | ||
| 95 | +### 3.5.1 查看当前镜像版本 | ||
| 96 | + | ||
| 97 | +**方式一：** 在 CANNLab 环境列表页，鼠标移至"镜像/规格"查看详情 | ||
| 98 | + | ||
| 99 | +**方式二：** 在环境内执行命令 | ||
| 100 | + | ||
| 101 | +```bash | ||
| 102 | +cat /home/developer/image-version.txt | ||
| 103 | +``` | ||
| 104 | + | ||
| 105 | +### 3.5.2 镜像版本更新 | ||
| 106 | + | ||
| 107 | +| 场景 | 操作方式 | | ||
| 108 | +|:---|:---| | ||
| 109 | +| 需要全新环境 | 关机 -> 删除环境 -> 重新创建（注意备份数据） | | ||
| 110 | +| 仅升级 CANN 包 | 使用"CANN包升级"按钮 | | ||
| 111 | +| 仅升级算子插件 | 在"扩展"中搜索插件名称更新 | | ||
| 112 | + | ||
| 113 | +> **注意：** 暂不支持直接升级镜像。 | ||
| 114 | + | ||
| 115 | +### 3.5.3 内置CANN软件包查看与升级 | ||
| 116 | + | ||
| 117 | +#### 查询 CANN 版本 | ||
| 56 | 118 | ||
| 57 | CANN 包已预装，安装路径为 `/home/developer/Ascend`（注意：区别于自行安装的默认路径 `/usr/local/Ascend`）。 | 119 | CANN 包已预装，安装路径为 `/home/developer/Ascend`（注意：区别于自行安装的默认路径 `/usr/local/Ascend`）。 |
| 58 | 120 | ||
| @@ -66,7 +128,7 @@ env | grep ASCEND | |||
| 66 | cat /home/developer/Ascend/ascend-toolkit/latest/opp/version.info | 128 | cat /home/developer/Ascend/ascend-toolkit/latest/opp/version.info |
| 67 | ``` | 129 | ``` |
| 68 | 130 | ||
| 69 | -### 3.3.2 升级 CANN 版本 | 131 | +#### 升级 CANN 版本 |
| 70 | 132 | ||
| 71 | **方式一：控制台一键升级（推荐）** | 133 | **方式一：控制台一键升级（推荐）** |
| 72 | 134 | ||
| @@ -85,9 +147,10 @@ cd /home/developer/.cann | |||
| 85 | 147 | ||
| 86 | 通过WebIDE或者VSCode连接后，在终端中可手动下载安装。 | 148 | 通过WebIDE或者VSCode连接后，在终端中可手动下载安装。 |
| 87 | 149 | ||
| 88 | -## 3.4 内置驱动版本查看与升级 | ||
| 89 | 150 | ||
| 90 | -### 3.4.1 查询驱动版本 | 151 | +## 3.6 环境驱动版本查看与升级 |
| 152 | + | ||
| 153 | +### 3.6.1 查询驱动版本 | ||
| 91 | 154 | ||
| 92 | 当前驱动版本为 **25.5.0（A2）、25.5.5（A3）**，路径为 `/usr/local/Ascend/driver`。 | 155 | 当前驱动版本为 **25.5.0（A2）、25.5.5（A3）**，路径为 `/usr/local/Ascend/driver`。 |
| 93 | 156 | ||
| @@ -95,49 +158,14 @@ cd /home/developer/.cann | |||
| 95 | cat /usr/local/Ascend/driver/version.info | grep Version | 158 | cat /usr/local/Ascend/driver/version.info | grep Version |
| 96 | ``` | 159 | ``` |
| 97 | 160 | ||
| 98 | -### 3.4.2 驱动版本升级 | 161 | +### 3.6.2 驱动版本升级 |
| 99 | 162 | ||
| 100 | -暂不支持个人环境的驱动版本升级，由平台统一规划。如有驱动版本依赖，请参考[问题反馈](../CANNLab用户手册.md#问题反馈)进行反馈。 | 163 | +暂不支持个人对环境的驱动版本升级，由平台统一规划。 |
| 101 | 164 | ||
| 102 | -## 3.5 数据管理 | ||
| 103 | 165 | ||
| 104 | -### 3.5.1 持久化存储 | 166 | +### 3.5.4 内置开发工具 |
| 105 | 167 | ||
| 106 | -| 目录 | 持久化 | 说明 | | 168 | +#### Ascend C Toolkit（算子开发插件） |
| 107 | -|:---|:---|:---| | ||
| 108 | -| `/mnt/workspace` | ✅ 持久化 | 环境关机后数据保留，环境**删除**后数据清除 | | ||
| 109 | -| `/home` | ✅ 持久化 | 环境关机后数据保留，环境**删除**后数据清除 | | ||
| 110 | -| 其他系统目录 | ❌ 非持久化 | 环境**删除**后数据丢失 | | ||
| 111 | - | ||
| 112 | -> **重要提示** | ||
| 113 | -> - 请将所有代码工程、数据集、模型文件等重要文件存放于 `/mnt/workspace` 或 `/home` 目录下 | ||
| 114 | -> - 环境删除操作不可逆，请提前备份重要数据 | ||
| 115 | - | ||
| 116 | -### 3.5.2 文件上传与下载 | ||
| 117 | - | ||
| 118 | -支持通过 WebIDE 界面或 VSCode 插件直接上传/下载文件。 | ||
| 119 | - | ||
| 120 | -### 3.5.3 代码自动拉取 | ||
| 121 | - | ||
| 122 | -在新建环境时，可以**添加预加载代码仓**，在环境创建时，会**自动 clone 该仓库的代码**至 `/mnt/workspace`，无需手动拉取。如果在新建环境时没有添加预加载代码仓，环境创建将不会 clone 任何代码仓。 | ||
| 123 | - | ||
| 124 | -## 3.6 代码工程管理 | ||
| 125 | - | ||
| 126 | -### 3.6.1 切换工程目录 | ||
| 127 | - | ||
| 128 | -在 WebIDE 中：文件（File）-> 打开项目（Open Project）-> 选择对应仓库目录。 | ||
| 129 | - | ||
| 130 | -### 3.6.2 分支管理 | ||
| 131 | - | ||
| 132 | -当前自动 clone 的代码为 **master** 分支，如需其他分支请手动切换。指定分支的功能正在开发中。 | ||
| 133 | - | ||
| 134 | -### 3.6.3 Git 免密操作 | ||
| 135 | - | ||
| 136 | -平台基于 AtomGit 账号绑定自动完成 SSH 公私钥配置，`git clone` / `git push` 全程免密。 | ||
| 137 | - | ||
| 138 | -## 3.7 内置开发工具 | ||
| 139 | - | ||
| 140 | -### 3.7.1 Ascend C Toolkit（算子开发插件） | ||
| 141 | 169 | ||
| 142 | 预装于云开发环境中，提供： | 170 | 预装于云开发环境中，提供： |
| 143 | 171 | ||
| @@ -155,7 +183,7 @@ cat /usr/local/Ascend/driver/version.info | grep Version | |||
| 155 | 183 | ||
| 156 | 连接到环境后，左侧栏"扩展"中搜索 "Ascend C Toolkit"，在搜索到的 "Ascend C Toolkit" 插件上如果有"更新"图标，说明发布了新版本，在插件详情页面更新版本。为了简化操作，建议在插件详情页面勾选"自动更新"选项，后续插件将静默升级。 | 184 | 连接到环境后，左侧栏"扩展"中搜索 "Ascend C Toolkit"，在搜索到的 "Ascend C Toolkit" 插件上如果有"更新"图标，说明发布了新版本，在插件详情页面更新版本。为了简化操作，建议在插件详情页面勾选"自动更新"选项，后续插件将静默升级。 |
| 157 | 185 | ||
| 158 | -### 3.7.2 PyPTO Toolkit | 186 | +#### PyPTO Toolkit |
| 159 | 187 | ||
| 160 | 预装于云开发环境中，面向 AI 加速器的高性能编程框架，简化复杂融合算子及模型网络的开发流程。 | 188 | 预装于云开发环境中，面向 AI 加速器的高性能编程框架，简化复杂融合算子及模型网络的开发流程。 |
| 161 | 189 | ||
| @@ -178,7 +206,7 @@ cat /usr/local/Ascend/driver/version.info | grep Version | |||
| 178 | 206 | ||
| 179 | 连接到环境后，左侧栏"扩展"中搜索 "PyPTO Toolkit"，在搜索到的 "PyPTO Toolkit" 插件上如果有"更新"图标，说明发布了新版本，在插件详情页面更新版本。为了简化操作，建议在插件详情页面勾选"自动更新"选项，后续插件将静默升级。 | 207 | 连接到环境后，左侧栏"扩展"中搜索 "PyPTO Toolkit"，在搜索到的 "PyPTO Toolkit" 插件上如果有"更新"图标，说明发布了新版本，在插件详情页面更新版本。为了简化操作，建议在插件详情页面勾选"自动更新"选项，后续插件将静默升级。 |
| 180 | 208 | ||
| 181 | -### 3.7.3 CANNBot 插件 | 209 | +#### CANNBot 插件 |
| 182 | 210 | ||
| 183 | 终端内置 CANNBot 工具，支持自然语言交互式编码辅助，提供免费token使用，具体可参考 [CANNBot用户手册](https://gitcode.com/cann/infrastructure/blob/master/docs/CANNBot/CANNBot-User-Guide.md) 。 | 211 | 终端内置 CANNBot 工具，支持自然语言交互式编码辅助，提供免费token使用，具体可参考 [CANNBot用户手册](https://gitcode.com/cann/infrastructure/blob/master/docs/CANNBot/CANNBot-User-Guide.md) 。 |
| 184 | 212 | ||
| @@ -186,24 +214,3 @@ cat /usr/local/Ascend/driver/version.info | grep Version | |||
| 186 | 214 | ||
| 187 | 连接到环境后，左侧栏"扩展"中搜索 "CANNBot Toolkit"，在搜索到的 "CANNBot Toolkit" 插件上如果有"更新"图标，说明发布了新版本，在插件详情页面更新版本。为了简化操作，建议在插件详情页面勾选"自动更新"选项，后续插件将静默升级。 | 215 | 连接到环境后，左侧栏"扩展"中搜索 "CANNBot Toolkit"，在搜索到的 "CANNBot Toolkit" 插件上如果有"更新"图标，说明发布了新版本，在插件详情页面更新版本。为了简化操作，建议在插件详情页面勾选"自动更新"选项，后续插件将静默升级。 |
| 188 | 216 | ||
| 189 | -## 3.8 镜像管理 | ||
| 190 | - | ||
| 191 | -### 3.8.1 查看当前镜像版本 | ||
| 192 | - | ||
| 193 | -**方式一：** 在 CANNLab 环境列表页，鼠标移至"镜像/规格"查看详情 | ||
| 194 | - | ||
| 195 | -**方式二：** 在环境内执行命令 | ||
| 196 | - | ||
| 197 | -```bash | ||
| 198 | -cat /home/developer/image-version.txt | ||
| 199 | -``` | ||
| 200 | - | ||
| 201 | -### 3.8.2 镜像版本更新 | ||
| 202 | - | ||
| 203 | -| 场景 | 操作方式 | | ||
| 204 | -|:---|:---| | ||
| 205 | -| 需要全新环境 | 关机 -> 删除环境 -> 重新创建（注意备份数据） | | ||
| 206 | -| 仅升级 CANN 包 | 使用"CANN包升级"按钮 | | ||
| 207 | -| 仅升级算子插件 | 在"扩展"中搜索插件名称更新 | | ||
| 208 | - | ||
| 209 | -> **注意：** 暂不支持直接升级镜像。 | ||
| @@ -68,7 +68,7 @@ VSCode右下角报错："WebSocket 连接失败" | |||
| 68 | 68 | ||
| 69 | **【解决思路】** | 69 | **【解决思路】** |
| 70 | - 确认是否为首次使用 VSCode 方式连接开发环境； | 70 | - 确认是否为首次使用 VSCode 方式连接开发环境； |
| 71 | -- 若是，检查 AtomGit Dev Space 插件的 proxy 和 remote-ssh 的配置是否正确。 | 71 | +- 若是，检查 CANNLab Dev Space 插件的 proxy 和 remote-ssh 的配置是否正确。 |
| 72 | 72 | ||
| 73 | ### Q2：VSCode 隔一段时间不操作会断连，且需要再次进行 AtomGit 授权 | 73 | ### Q2：VSCode 隔一段时间不操作会断连，且需要再次进行 AtomGit 授权 |
| 74 | 74 | ||