📋 使用前准备

1. 安装插件

在 VSCode 扩展市场搜索并安装以下两个插件：

💡 安装 DevStation 时会自动提示安装依赖插件，点击安装即可

2. 登录账号

安装完成后，在 VSCode 左侧面板找到 资源环境 视图，点击 登录 按钮完成账号登录。

🗂 创建任务配置

第一步：创建配置目录

在项目根目录下创建 .devstation 文件夹：

my-project/
├── .devstation/           ← 👈 在这里创建
│   ├── compile.yml        # 编译任务配置
│   └── ut_with_npu.yml    # NPU 测试任务配置
├── src/
├── ci/
└── ...

第二步：编写任务配置

在 .devstation/ 下创建 .yml 文件，每个文件代表一个任务。

📝 配置字段详解

一个完整的任务配置结构如下：

name: 任务名称                    # 【必填】任务名称，显示在任务列表中

on: workflow_dispatch             # 【必填】固定值，表示手动触发

jobs:
  run-task:                       # 【必填】任务定义
    runs-on: 资源规格              # 【必填】需要的计算资源
    container:
      image: 镜像地址              # 【选填】容器镜像
      options: 容器启动参数         # 【选填】如 --add-host
    steps:                        # 【必填】执行步骤列表
      - name: 步骤名称
        working-directory: 远程目录  # 【选填】代码同步和命令执行的基础目录
        run: |                     # 【必填】要执行的命令
          你的命令
        env:                       # 【选填】环境变量
          KEY: VALUE
    with:                          # 【选填】Job 级别的产物传输配置
      trans-files:
        - action: download/upload
          remotePath: 远程路径
          localPath: 本地路径

with:                              # 【选填】全局产物传输配置
  trans-files:
    - action: download/upload
      remotePath: 远程路径
      localPath: 本地路径
    - action: combine               # 共享存储模式，只需填写 remotePath
      remotePath: 远程路径

各字段说明

🔹 runs-on — 资源规格

指定你需要什么样的远程机器，格式：

<NPU数量>*<NPU型号> | <CPU数量>*<CPU类型> | <内存数量>*<内存单位> | <磁盘数量>*<磁盘单位>

💡 编译任务一般不需要 NPU，设为 0*；运行测试任务如需 NPU 卡则设为 1* 或更多

🔹 container — 容器配置

🔹 steps — 执行步骤

每个步骤包含以下字段：

💡 working-directory 的作用：

• 代码同步到 <working-directory>/<项目名> 目录
• 命令执行前自动 cd 到该目录
• 例如 working-directory: /home/usr1，项目名 myproject，则代码同步到 /home/usr1/myproject

🔹 trans-files — 产物传输

用于在本地和远程之间传输文件：

💡 trans-files 可以写在顶层 with 下，也可以写在 jobs.run-task.with 下，效果相同

💡 combine 模式适用于共享存储场景：任务执行完成后，自动将 remotePath 指定的远程文件复制到远程环境的 /opt/data 目录下，供其他任务或环境共享访问

🌟 完整示例

示例一：编译任务

场景：在远程 CPU 环境上编译代码，编译完成后把产物下载回本地。

name: compile_library

on: workflow_dispatch

jobs:
  run-task:
    runs-on: 0*NPU-310P-310P | 8*CPU-X86| 32*RAM | 50*HD
    container:
      image: swr.cn-north-4.myhuaweicloud.com/frameworkptadapter/pytorch_2.7.1_a1_x86_64_builder:20260518
      options: --add-host
    steps:
      - name: runScript
        working-directory: /home/usr1
        run: |
          git clone https://gitcode.com/tegixia/develop_tools.git
          cd develop_tools
          cd build
          cmake .. && make .
        env:
          Env1: 1
          Env2: 2
    with:
      trans-files:
        - action: download
          remotePath: /home/usr1/test_library
          localPath: .test_library

执行流程：

① 申请远程环境（纯 CPU，无 NPU）
        ↓
② 启动容器镜像
        ↓
③ 同步本地代码 → 远程 /home/usr1/<项目名>/
        ↓
④ 执行步骤 runScript（克隆代码、编译构建）
        ↓
⑤ 下载编译产物 test_library → 本地 .test_library

示例二：NPU 测试任务

场景：在带 NPU 卡的远程环境上运行测试用例，需要先上传测试数据包。

name: test_library

on: workflow_dispatch

jobs:
  run-task:
    runs-on: 1*NPU-310P-310P | 8*CPU-X86| 32*RAM | 50*HD
    container:
      image: swr.cn-north-4.myhuaweicloud.com/frameworkptadapter/pytorch_2.7.1_a1_x86_64_builder:20260518
      options: --add-host
    steps:
      - name: runScript
        working-directory: /home/usr1
        run: |
          cd /tmp
          chmod +x test_library && ./test_library
        env:
          Env1: 1
          Env2: 2
    with:
      trans-files:
        - action: upload
          remotePath: /tmp/test_library
          localPath: .vscode/test_library

执行流程：

① 上传测试文件 test_library → 远程 /tmp/
        ↓
② 申请远程环境（含 1 张 NPU-310P 卡）
        ↓
③ 同步本地代码 → 远程 /home/usr1/<项目名>/
        ↓
④ 执行步骤 runScript（运行测试）

示例三：共享存储任务

场景：编译完成后将产物存入共享存储目录 /mnt/share，供其他任务或环境直接访问，无需手动传输。

name: compile_and_share

on: workflow_dispatch

jobs:
  run-task:
    runs-on: 0*NPU-310P-310P | 8*CPU-X86| 32*RAM | 50*HD
    container:
      image: swr.cn-north-4.myhuaweicloud.com/frameworkptadapter/pytorch_2.7.1_a1_x86_64_builder:20260518
      options: --add-host
    steps:
      - name: runScript
        working-directory: /home/usr1
        run: |
          git clone https://gitcode.com/tegixia/develop_tools.git
          cd develop_tools
          cd build
          cmake .. && make .
        env:
          Env1: 1
          Env2: 2
    with:
      trans-files:
        - action: download
          remotePath: /home/usr1/test_library
          localPath: .test_library
        - action: combine
          remotePath: /home/usr1/test_library

执行流程：

① 申请远程环境（纯 CPU，无 NPU）
        ↓
② 启动容器镜像
        ↓
③ 同步本地代码 → 远程 /home/usr1/<项目名>/
        ↓
④ 执行步骤 runScript（克隆代码、编译构建）
        ↓
⑤ 下载编译产物 test_library → 本地 .test_library
⑥ 复制 test_library → 共享存储 /mnt/share/test_library

编译任务 vs 测试任务 vs 共享存储任务 对比

🏃 如何运行任务

1. 创建配置文件：在项目 .devstation/ 目录下编写 .yml 任务配置
2. 打开任务面板：在 VSCode 左侧点击 任务执行 视图
3. 点击运行：在任务列表中找到你的任务，点击 ▶ 按钮运行
4. 查看日志：运行过程中会自动打开输出日志，可实时查看执行进度
5. 获取产物：任务完成后，配置了 download 的产物会自动下载到本地指定路径

⚠️ 资源申请失败

如果申请资源失败，右下角会弹出通知提示失败原因，并提供以下帮助：

• 支持服务 — 跳转到 https://hidevlab.huawei.com/support 获取帮助
• 联系我们 — 跳转到 https://hidevlab.huawei.com/support/contact-us 直接联系支持团队