功能包下载

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

支持以下两种配置方式：

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

在线模式

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

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

按“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地址，默认已配置，用户无需修改。
	signature_suffix	签名文件后缀。
	timeout_seconds	功能包下载超时时间，默认为300秒。
	ssl_verify	是否开启SSL证书校验，若开启系统会校验HTTPS连接中的服务端证书，生产环境建议保持true。
	retry	重试次数。
verify_defaults	signature_type	签名文件类型，用户无需修改。
	signature_format	签名文件格式，用户无需修改。
	verify_chain	是否开启证书链校验，若开启系统会校验证书是否由可信CA签发且链路完整，生产环境建议保持true。
	enabled	是否开启安装包签名文件校验，生产环境建议保持true。
安装包配置列表，每个条目对应一个需要下载、验签和安装的产品包。
packages	filename_override	指定自定义功能包名。默认会根据{功能包名称}-{版本号}-{操作平台}-{包格式}进行拼接，若不符合该规则，可通过该参数覆盖，直接用作最终的下载包名。若需启用，请取消注释并配置此参数，此时project_version仍需配置。
	product	功能包名称，需要与待下载功能包的前缀保持一致。
	project_version	项目版本号，例如26.1.RC1。
	artifact_version	产品版本号，需要与待下载功能包的版本号保持一致。
	supported_versions	支持版本列表。
	package_format	功能包格式，需要与待下载功能包的格式保持一致。
	enabled	是否启用该功能包，若启用则在调用该工具时会自动下载并安装功能包。

按“Esc”键退出编辑模式，输入:wq!，按“Enter”键保存并退出文件。
若当前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

父主题： 高阶功能