---
title: 功能包下载
description: "DevKit AI采用“按需下载”策略，在检测到用户发起的指令后，会自动下载并安装相应的工具包，当前仅支持SQL迁移和C/C++源码迁移。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengdevps/devkitai/usermanual/kunpengDevKitAI_0035.html
sourcePath: /source/zh/kunpengdevps/devkitai/usermanual/kunpengDevKitAI_0035.html
indexId: 31440bf5af2101c512594fc7454ee285680e13d0043489bb4ba44a67093f345769
---
# 功能包下载

DevKit AI采用“按需下载”策略，在检测到用户发起的指令后，会自动下载并安装相应的工具包，当前仅支持SQL迁移和C/C++源码迁移。

支持以下两种配置方式：


**表1 功能包下载说明**

| 使用模式 | 适用场景 | 配置方式 | 优势 |
| --- | --- | --- | --- |
| 在线模式 | 服务端具备外网访问权限。 | 在配置文件中配置下载地址、版本及工具等，系统默认已配置。 | 配置简单，工具包自动更新，无需人工干预。 |
| 离线模式 | 服务端处于内网环境，无外网访问权限。 | 将工具安装包手动放置于指定目录。 | 全隔离外网，满足高安全合规要求。 |
| 注：若两者同时配置，则以离线模式优先。 | 注：若两者同时配置，则以离线模式优先。 | 注：若两者同时配置，则以离线模式优先。 | 注：若两者同时配置，则以离线模式优先。 |


#### 在线模式

默认已配置，若需使用其他版本或工具，请按照以下方式手动修改配置文件。

1. 使用 SSH 远程登录工具，登录DevKit AI的安装节点。
2. 进入DevKit AI基础包解压后目录，配置packages.yaml文件。

```
vi config/packages.yaml
```


3. 按“i”进入编辑模式，修改配置文件。

```
download_defaults:
base_url: "https://kunpeng-repo.obs.cn-north-4.myhuaweicloud.com/Kunpeng%20DevKit/Kunpeng%20DevKit%20"
signature_suffix: "p7s"
timeout_seconds: 300
# 是否校验 SSL 证书；开启后会校验 HTTPS 连接中的服务端证书，生产环境建议保持 true
ssl_verify: true
retry: 3
verify_defaults:
signature_type: "p7s"
signature_format: "DER"
# 是否校验证书链；开启后会校验证书是否由可信 CA 签发且链路完整，生产环境建议保持 true
verify_chain: true
# 是否启用安装包签名校验；生产环境建议保持 true
enabled: true
# 安装包配置列表；每个条目对应一个需要下载、验签和安装的产品包
packages:
# 可选字段示例（按需开启）：
# filename_override: "custom-file-name.tar.gz"
# 用途：当上游包名不符合默认拼接规则时，显式指定完整文件名。
- product: "DevKit-Porting-Advisor"
project_version: "26.1.RC1"
artifact_version: "26.1.RC1"
supported_versions:
- "26.1.RC1"
package_format: "tar.gz"
enabled: true
- product: "DevKit-CLI"
project_version: "26.1.RC1"
artifact_version: "26.1.RC1"
supported_versions:
- "26.1.RC1"
package_format: "tar.gz"
enabled: true
```


**表2 参数说明**

| 参数 | 参数 | 说明 |
| --- | --- | --- |
| download\_defaults | base\_url | 基础URL地址，默认已配置，用户无需修改。 |
| download\_defaults | signature\_suffix | 签名文件后缀。 |
| download\_defaults | timeout\_seconds | 功能包下载超时时间，默认为300秒。 |
| download\_defaults | ssl\_verify | 是否开启SSL证书校验，若开启系统会校验HTTPS连接中的服务端证书，生产环境建议保持true。 |
| download\_defaults | retry | 重试次数。 |
| verify\_defaults | signature\_type | 签名文件类型，用户无需修改。 |
| verify\_defaults | signature\_format | 签名文件格式，用户无需修改。 |
| verify\_defaults | verify\_chain | 是否开启证书链校验，若开启系统会校验证书是否由可信CA签发且链路完整，生产环境建议保持true。 |
| verify\_defaults | enabled | 是否开启安装包签名文件校验，生产环境建议保持true。 |
| 安装包配置列表，每个条目对应一个需要下载、验签和安装的产品包。 | 安装包配置列表，每个条目对应一个需要下载、验签和安装的产品包。 | 安装包配置列表，每个条目对应一个需要下载、验签和安装的产品包。 |
| packages | filename\_override | 指定自定义功能包名。默认会根据{功能包名称}\-{版本号}\-{操作平台}\-{包格式}进行拼接，若不符合该规则，可通过该参数覆盖，直接用作最终的下载包名。 若需启用，请取消注释并配置此参数，此时project\_version仍需配置。 |
| packages | product | 功能包名称，需要与待下载功能包的前缀保持一致。 |
| packages | project\_version | 项目版本号，例如26.1.RC1。 |
| packages | artifact\_version | 产品版本号，需要与待下载功能包的版本号保持一致。 |
| packages | supported\_versions | 支持版本列表。 |
| packages | package\_format | 功能包格式，需要与待下载功能包的格式保持一致。 |
| packages | enabled | 是否启用该功能包，若启用则在调用该工具时会自动下载并安装功能包。 |


4. 按“Esc”键退出编辑模式，输入:wq!，按“Enter”键保存并退出文件。
5. 若当前Server端已启动，配置完成后需要重启。
  先停止当前进程。port为服务侦听的端口号；pid为查询的进程号。

```
ss -tulpn | grep :{
port
}
kill -9 {
pid
}
```


  重新启动服务。

```
nohup ./server > ./uvicorn.log 2>&1 &
cat ./uvicorn.log
```


#### 离线模式

可根据回显链接获取所需的软件包和数字签名，并将其按照如下目录放置于DevKit AI解压后的“_internal/packages/”文件夹中，若无相应路径需手动创建。

```
_internal/packages/
├── DevKit-Porting-Advisor
│   ├── DevKit-Porting-Advisor-26.1.RC1-Linux-Kunpeng.tar.gz
│   └── DevKit-Porting-Advisor-26.1.RC1-Linux-Kunpeng.tar.gz.p7s
└── DevKit-CLI
│   ├── DevKit-CLI-26.1.RC1-Linux-Kunpeng.tar.gz
│   └── DevKit-CLI-26.1.RC1-Linux-Kunpeng.tar.gz.p7s
```

回显信息如下所示：

```
[2026-06-16 13:59:34] [ERROR] [processID:3836988] [MainThread] [service:install_with_builtin_config:32] 安装出现错误: 离线安装请从以下链接地址下载对应文件，并放置到指定存放目录：
1. 安装包文件（.tar.gz）
下载地址: https://kunpeng-repo.obs.cn-north-4.myhuaweicloud.com/Kunpeng%20DevKit/Kunpeng%20DevKit%2026.1.RC1/DevKit-Porting-Advisor-26.1.RC1-Linux-Kunpeng.tar.gz
存放目录: /home/DevKit-AI-26.1.RC1-Linux-Kunpeng/_internal/packages/DevKit-Porting-Advisor
文件名称: DevKit-Porting-Advisor-26.1.RC1-Linux-Kunpeng.tar.gz
2. 签名文件（.p7s）
下载地址: https://kunpeng-repo.obs.cn-north-4.myhuaweicloud.com/Kunpeng%20DevKit/Kunpeng%20DevKit%2026.1.RC1/DevKit-Porting-Advisor-26.1.RC1-Linux-Kunpeng.tar.gz.p7s
存放目录: /home/DevKit-AI-26.1.RC1-Linux-Kunpeng/_internal/packages/DevKit-Porting-Advisor
文件名称: DevKit-Porting-Advisor-26.1.RC1-Linux-Kunpeng.tar.gz.p7s
```