antiwear-web/backend/server/README.md

华为交互数字人后端服务

项目说明：本项目是华为交互数字人 HwICSUiSdk 标准集成项目的定制化开发版本，专为安特威公司打造，由江苏云上企数字科技有限公司研发。

功能说明

后端服务主要为前端提供以下功能：

1. 获取授权码 - 调用华为云 MetaStudio API 获取一次性授权码，用于前端 SDK 初始化

环境配置

1. 配置环境变量

复制 .env.example 文件为 .env：

cp .env.example .env

编辑 .env 文件，填入您的华为云凭证：

HUAWEI_AK=your_access_key_here
HUAWEI_SK=your_secret_key_here
HUAWEI_PROJECT_ID=your_project_id_here

2. 获取华为云凭证

AK/SK（推荐）

1. 登录 华为云控制台
2. 进入 "我的凭证" > "访问密钥"
3. 创建或下载访问密钥

项目 ID

1. 登录华为云控制台
2. 进入 "我的凭证" > "项目 ID"
3. 或访问 获取项目ID

启动服务

安装依赖

npm install

启动服务

npm start

服务将在 http://localhost:3001 启动。

API 接口

获取授权码

POST /api/once-code

请求示例：

curl -X POST http://localhost:3001/api/once-code

响应示例：

{
  "once_code": "OATAXWpTNDPGjVyzxNLKvumcv297Q7uUz5CCltLtFDE1uqnPAPmS4jm61XnMQGuV"
}

错误响应：

{
  "error_code": "INTERNAL_ERROR",
  "error_msg": "请配置环境变量: HUAWEI_AK 和 HUAWEI_SK"
}

健康检查

GET /health

响应示例：

{
  "status": "ok"
}

技术栈

• Express - Node.js Web 框架
• CORS - 跨域资源共享
• dotenv - 环境变量管理
• APIGW-javascript-sdk - 华为云 API 签名认证

目录结构

backend/server/
├── index.js                    # 服务入口
├── package.json                # 依赖配置
├── .env                        # 环境变量（不提交到版本库）
├── .env.example                # 环境变量示例
└── APIGW-javascript-sdk-2.0.6/ # 华为云签名SDK
    ├── signer.js               # 签名认证
    ├── node_demo.js            # 示例代码
    └── licenses/               # 许可证

注意事项

1. 安全性 - 请勿将 .env 文件提交到版本库
2. 凭证保护 - 生产环境请使用更安全的方式管理凭证
3. 跨域 - 默认允许所有来源跨域，生产环境请限制来源