修改readme

Author: jienigui-1

.github/workflows/ci.yml

@@ -16,12 +16,12 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 18
 
       - name: Setup pnpm
         uses: pnpm/action-setup@v2
         with:
-          version: 8
+          version: 9
 
       - name: Install Dependencies
         run: pnpm install

.github/workflows/release.yml

@@ -20,12 +20,12 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 18
 
       - name: Setup pnpm
         uses: pnpm/action-setup@v2
         with:
-          version: 8
+          version: 9
 
       - name: Install Dependencies
         run: pnpm install

README.EN.md

@@ -2,7 +2,7 @@ English | [中文](README.md)
 
 # Volcengine SDK for Node.js
 
-## Installation
+## Installation Core Packages
 
 ### Requirements
 
@@ -35,34 +35,26 @@ export VOLCSTACK_ACCESS_KEY_ID="YOUR_AK"
 export VOLCSTACK_SECRET_ACCESS_KEY="YOUR_SK"
 ```
 
-## Endpoint Configuration
-
-The SDK supports multiple ways to configure the Endpoint, with the following priority (highest to lowest):
-
-1.  **Custom Endpoint**: Specify `EndpointWithEndpoint` in the client configuration (e.g. `iam.example.com`).
-2.  **Automatic Addressing**: Specify `region`, and the SDK will automatically construct the Endpoint based on the service name and region (e.g. `ecs.cn-beijing.volcengineapi.com`).
-3.  **Default**: If not specified and cannot be deduced, `open.volcengineapi.com` is used by default.
-
 ## Quick Start
 
 The following example shows how to initialize the client and send a request.
-Install the corresponding service SDK package (e.g., `@volcengine/iam`).
+Install the corresponding service SDK package (e.g., `@volcengine/ecs`).
 
 ```bash
 # pnpm
-pnpm add @volcengine/iam
+pnpm add @volcengine/ecs
 ```
 
 ```typescript
-import { IAMClient, ListUsersCommand } from "@volcengine/iam"; // Need to install the corresponding service package
+import { ECSClient, DescribeZonesCommand } from "@volcengine/ecs"; // Need to install the corresponding service package
 
 // 1. Use AK/SK from environment variables and specify Region
-const client = new IAMClient({
+const client = new ECSClient({
   region: "cn-beijing",
 });
 
 // 2. Or explicitly pass AK/SK in the code
-// const client = new IAMClient({
+// const client = new ECSClient({
 //   accessKeyId: "YOUR_AK",
 //   secretAccessKey: "YOUR_SK",
 //   region: "cn-beijing",
@@ -71,7 +63,7 @@ const client = new IAMClient({
 async function main() {
   try {
     // Send request (refer to service SDK documentation for specific Commands)
-    const command = new ListUsersCommand({});
+    const command = new DescribeZonesCommand({});
     const response = await client.send(command);
     console.log(response);
   } catch (error) {

README.md

@@ -2,7 +2,7 @@
 
 # Volcengine SDK for Node.js
 
-## 安装
+## 安装 Core 包
 
 ### 环境要求
 
@@ -35,35 +35,27 @@ export VOLCSTACK_ACCESS_KEY_ID="YOUR_AK"
 export VOLCSTACK_SECRET_ACCESS_KEY="YOUR_SK"
 ```
 
-## Endpoint 设置
-
-SDK 支持多种方式配置 Endpoint，优先级从高到低：
-
-1.  **自定义 Endpoint**: 在客户端配置中指定 `host` (e.g. `open.volcengineapi.com`).
-2.  **自动寻址**: 指定 `region`，SDK 会根据服务名和区域自动构造 Endpoint (e.g. `ecs.cn-beijing.volcengineapi.com`).
-3.  **默认**: 如果未指定且无法推导，默认使用 `open.volcengineapi.com`.
-
 ## 快速开始
 
 以下示例展示了如何初始化客户端并发送请求。
-安装对应的业务 SDK 包（如 `@volcengine/iam`）。
+安装对应的业务 SDK 包（如 `@volcengine/ecs`）。
 
 ```bash
 # pnpm
-pnpm add @volcengine/iam
+pnpm add @volcengine/ecs
 
 ```
 
 ```typescript
-import { IAMClient } from "@volcengine/iam"; // 需安装对应的业务包
+import { ECSClient, DescribeZonesCommand } from "@volcengine/ecs"; // 需安装对应的业务包
 
 // 1. 使用环境变量中的 AK/SK，并指定 Region
-const client = new IAMClient({
+const client = new ECSClient({
   region: "cn-beijing",
 });
 
 // 2. 或者在代码中显式传入 AK/SK
-// const client = new IAMClient({
+// const client = new ECSClient({
 //   accessKeyId: "YOUR_AK",
 //   secretAccessKey: "YOUR_SK",
 //   region: "cn-beijing",
@@ -72,7 +64,7 @@ const client = new IAMClient({
 async function main() {
   try {
     // 发送请求 (具体 Command 需参考业务 SDK 文档)
-    const command = new ListUsersCommand({});
+    const command = new DescribeZonesCommand({});
     const response = await client.send(command);
     console.log(response);
   } catch (error) {

SDK_Integration.md

@@ -441,9 +441,10 @@ The backoff strategy determines the wait time between each retry. You can choose
 - `ExponentialWithRandomJitterBackoffStrategy` (Default): Exponential backoff with jitter. Adds a random delay on top of exponential backoff to help avoid "thundering herd" effects.
 
 ```typescript
+import { StrategyName } from "@volcengine/sdk-core";
 const client = new EcsClient({
   // ... other configurations
-  retryMode: "ExponentialBackoffStrategy",
+  strategyName: StrategyName.ExponentialWithRandomJitterBackoffStrategy,
 });
 ```
 
@@ -502,7 +503,7 @@ try {
     if (error.status !== undefined) {
       // 1.1 SSL Error (status === 0)
       if (error.status === 0) {
-        console.error(`❌ SSL Error: ${error.message}`);
+        console.error(`❌ SSL Error`);
       }
       // 1.2 Server returned error (status > 0)
       else {
@@ -514,7 +515,6 @@ try {
           console.error(`   RequestId: ${RequestId}`);
         } else {
           // Other HTTP errors (such as 404, 500, 502, etc.)
-          console.error(`❌ HTTP Error ${error.status}: ${error.message}`);
         }
       }
     }
@@ -530,17 +530,12 @@ try {
     }
     // 3. Handle other SDK exceptions (Exception)
     else {
-      console.error("❌ SDK Exception Occurred:");
-      console.error(`   Message: ${error.message}`);
-      console.error(`   Name:    ${error.name}`);
-      if (error.originalError) {
-        console.error("   Cause:", error.originalError);
-      }
+      console.error("❌ SDK Exception Occurred");
     }
   }
   // 4. Unknown error (Error not thrown by SDK)
   else {
-    console.error("❌ Unknown Error:", error);
+    console.error("❌ Unknown Error");
   }
 }
 ```

SDK_Integration_zh.md

@@ -441,9 +441,11 @@ SDK 只会对特定的错误进行重试，包括：
 - `ExponentialWithRandomJitterBackoffStrategy` (默认): 带抖动的指数退避。在指数退避的基础上增加一个随机延迟，有助于避免“惊群效应”。
 
 ```typescript
+import { StrategyName } from "@volcengine/sdk-core";
+
 const client = new EcsClient({
   // ... 其他配置
-  retryMode: "ExponentialBackoffStrategy",
+  strategyName: StrategyName.ExponentialWithRandomJitterBackoffStrategy,
 });
 ```
 
@@ -502,7 +504,7 @@ try {
     if (error.status !== undefined) {
       // 1.1 SSL 错误 (status === 0)
       if (error.status === 0) {
-        console.error(`❌ SSL Error: ${error.message}`);
+        console.error(`❌ SSL Error`);
       }
       // 1.2 服务端返回的错误 (status > 0)
       else {
@@ -514,7 +516,6 @@ try {
           console.error(`   RequestId: ${RequestId}`);
         } else {
           // 其他 HTTP 错误 (如 404, 500, 502 等)
-          console.error(`❌ HTTP Error ${error.status}: ${error.message}`);
         }
       }
     }
@@ -530,17 +531,12 @@ try {
     }
     // 3. 处理其他 SDK 异常 (Exception)
     else {
-      console.error("❌ SDK Exception Occurred:");
-      console.error(`   Message: ${error.message}`);
-      console.error(`   Name:    ${error.name}`);
-      if (error.originalError) {
-        console.error("   Cause:", error.originalError);
-      }
+      console.error("❌ SDK Exception Occurred");
     }
   }
   // 4. 未知错误 (非 SDK 抛出的错误)
   else {
-    console.error("❌ Unknown Error:", error);
+    console.error("❌ Unknown Error");
   }
 }
 ```

packages/sdk-core/src/index.ts

@@ -1,4 +1,9 @@
 export { Client } from "./client/Client";
-export { ClientConfig, CommandOutput, HttpRequestError } from "./types/types";
+export {
+  ClientConfig,
+  CommandOutput,
+  HttpRequestError,
+  StrategyName,
+} from "./types/types";
 export { Command } from "./command/Command";
 export { buildRequestConfigFromMetaPath } from "./utils/meta";

packages/sdk-core/src/types/types.ts

@@ -128,7 +128,7 @@ export interface SendOptions {
   /**
    * AbortController 的 signal，用于取消请求
    */
-  abortSignal?: any;
+  abortSignal?: AbortSignal;
   /**
    * Request-level timeout in milliseconds
    * Overrides client-level httpOptions.timeout