@zrhsh/wukong-cli 0.3.0 → 0.4.1

package/README.md

@@ -1,104 +1,104 @@
 # Wukong CLI
 
-TypeScript CLI tool for Oceanet/NRP system with OAuth Device PKCE Flow authentication and automatic token refresh.
+用于 Oceanet/NRP 系统的 TypeScript CLI 工具，支持 OAuth Device PKCE Flow 认证和自动 token 刷新。
 
-## Features
+## 功能特性
 
-- 🔐 **Secure Authentication** - OAuth Device PKCE Flow without password input
-- 🔄 **Auto Token Refresh** - Automatic token refresh before expiration
-- 🌍 **Multi-Environment** - Support for dev, beta, uat, and prod environments
-- 🐛 **Debug Mode** - Show HTTP requests and responses with `--debug` flag
-- 💾 **Secure Storage** - Platform native credential managers with file fallback
-- 🛠️ **HTTP Client** - Built-in HTTP client with automatic authentication
-- ⚙️ **Smart Configuration** - Built-in defaults with fallback to user configuration
-- 🔍 **Structured Errors** - Clear error messages with actionable fix suggestions
+- 🔐 **安全认证** - OAuth Device PKCE Flow，无需输入密码
+- 🔄 **自动刷新** - Token 过期前自动刷新
+- 🌍 **多环境支持** - 支持 dev、beta、uat 和 prod 环境
+- 🐛 **调试模式** - 使用 `--debug` 标志显示 HTTP 请求和响应
+- 💾 **安全存储** - 使用平台原生凭据管理器，支持文件回退
+- 🛠️ **HTTP 客户端** - 内置 HTTP 客户端，自动处理认证
+- ⚙️ **智能配置** - 内置默认配置，支持用户自定义
+- 🔍 **结构化错误** - 清晰的错误消息和可操作的修复建议
 
-## Quick Start
+## 快速开始
 
 ```bash
-# Install
+# 安装
 npm install -g @zrhsh/wukong-cli
 
-# Initialize configuration
+# 初始化配置
 wukong-cli init
 
-# Login
+# 登录
 wukong-cli auth login
 
-# Check status
+# 查看状态
 wukong-cli auth status
 
-# Make API request
+# 发送 API 请求
 wukong-cli http get "/oceanet-auth/web/userInfo"
 ```
 
-## Development
+## 开发
 
 ```bash
-# Clone repository
+# 克隆仓库
 git clone <repository-url>
 cd wukong-ts-cli
 
-# Install dependencies (自动构建项目)
+# 安装依赖（自动构建项目）
 npm install
 
-# Development mode (直接运行 TypeScript)
+# 开发模式（直接运行 TypeScript）
 npm run dev <args>
 
-# Build for production
+# 生产环境构建
 npm run build
 
-# Link globally for testing
+# 全局链接用于测试
 npm run link
 
-# Run tests
+# 运行测试
 npm test
 
-# Verify before publishing
+# 发布前验证
 npm run verify
 ```
 
 **注意**：项目配置了自动构建脚本（`prepare` 和 `prepack`），在 `npm install` 和 `npm publish` 时会自动构建。如果遇到 `MODULE_NOT_FOUND` 错误，请运行 `npm run build` 手动构建。
 
-## Deprecation Notices
+## 弃用通知
 
-⚠️ **Device Flow API**: 某些内部 API 已标记为弃用，将在 v1.0.0 中移除。这不会影响终端用户的使用。详见 [弃用文档](./docs/deprecation/)。
+⚠️ **Device Flow API**：某些内部 API 已标记为弃用，将在 v1.0.0 中移除。这不会影响终端用户的使用。详见 [弃用文档](./docs/deprecation/)。
 
-## Commands
+## 命令
 
-### Configuration Commands
+### 配置命令
 
 ```bash
-wukong-cli init          # Initialize configuration file
+wukong-cli init          # 初始化配置文件
 ```
 
-### Authentication Commands
+### 认证命令
 
 ```bash
-wukong-cli auth login     # OAuth Device PKCE Flow login
-wukong-cli auth status    # Show authentication status
-wukong-cli auth refresh   # Refresh access token
-wukong-cli auth logout    # Logout and clear tokens
+wukong-cli auth login     # OAuth Device PKCE Flow 登录
+wukong-cli auth status    # 显示认证状态
+wukong-cli auth refresh   # 刷新访问令牌
+wukong-cli auth logout    # 登出并清除令牌
 ```
 
-### HTTP Commands
+### HTTP 命令
 
 ```bash
-wukong-cli http get "/endpoint"              # GET request
-wukong-cli http post "/endpoint" -d '{"key":"value"}'  # POST request
-wukong-cli http put "/endpoint" -d '{"key":"value"}'   # PUT request
-wukong-cli http delete "/endpoint"           # DELETE request
+wukong-cli http get "/endpoint"              # GET 请求
+wukong-cli http post "/endpoint" -d '{"key":"value"}'  # POST 请求
+wukong-cli http put "/endpoint" -d '{"key":"value"}'   # PUT 请求
+wukong-cli http delete "/endpoint"           # DELETE 请求
 ```
 
-### Global Options
+### 全局选项
 
 ```bash
---debug         # Enable debug mode (show HTTP requests)
--V, --version   # Show version number
--h, --help      # Show help information
+--debug         # 启用调试模式（显示 HTTP 请求）
+-V, --version   # 显示版本号
+-h, --help      # 显示帮助信息
 ```
 
-## Environment Switching
+## 环境切换
 
 ```bash
 # PowerShell
@@ -114,28 +114,28 @@ set WUKONG_CLI_ENV=beta
 wukong-cli auth login
 ```
 
-## Configuration
+## 配置
 
-Wukong CLI uses intelligent configuration with built-in defaults:
+Wukong CLI 使用智能配置，内置默认值：
 
-- **No Configuration Required**: CLI works out of the box with built-in environment defaults
-- **Custom Configuration**: Optional `wukong-cli.json` for custom endpoints
-- **Smart Fallback**: Uses built-in defaults when environments are not configured
-- **Clear Errors**: Structured error messages guide you to fix configuration issues
+- **无需配置**：CLI 开箱即用，使用内置的环境默认配置
+- **自定义配置**：可选的 `wukong-cli.json` 用于自定义端点
+- **智能回退**：环境未配置时使用内置默认值
+- **清晰错误**：结构化错误消息指导您修复配置问题
 
-### Configuration File Location
+### 配置文件位置
 
 ```bash
-~/wukong-cli.json  # User home directory
+~/wukong-cli.json  # 用户主目录
 ```
 
-### Initialize Configuration
+### 初始化配置
 
 ```bash
-wukong-cli init  # Creates or resets configuration file
+wukong-cli init  # 创建或重置配置文件
 ```
 
-### Example Configuration
+### 配置示例
 
 ```json
 {
@@ -155,9 +155,9 @@ wukong-cli init  # Creates or resets configuration file
 }
 ```
 
-### Configuration Errors
+### 配置错误
 
-If your configuration is incomplete, you'll see structured error messages:
+如果配置不完整，您会看到结构化错误消息：
 
 ```
 [ERROR] Configuration Error
@@ -169,113 +169,63 @@ Missing fields: apiBaseUrl, clientId
 Edit your wukong-cli.json or run 'wukong-cli init' to reset
 ```
 
-## Documentation
+## 文档
 
-### Getting Started
-- 📖 [Installation Guide](docs/getting-started/installation.md) - Detailed installation steps
-- 📖 [Quick Start](docs/getting-started/quick-start.md) - 5-minute quick start guide
-- 📖 [Configuration](docs/getting-started/configuration.md) - Environment configuration
+### 入门指南
+- 📖 [快速开始](docs/getting-started/quick-start.md) - 5分钟快速上手
+- 📖 [完整安装配置指南](docs/getting-started/complete-guide.md) - 详细安装和配置步骤
 
-### User Guide
-- 📖 [Command Reference](docs/user-guide/commands.md) - Complete command reference
-- 📖 [Authentication](docs/user-guide/authentication.md) - OAuth Device PKCE Flow details
-- 📖 [Environments](docs/user-guide/environments.md) - Multi-environment configuration
-- 📖 [Troubleshooting](docs/user-guide/troubleshooting.md) - Common issues and solutions
+### 用户指南
+- 📖 [命令参考](docs/user-guide/commands.md) - 完整命令参考
+- 📖 [认证详解](docs/user-guide/authentication.md) - OAuth Device PKCE Flow 详情
+- 📖 [环境配置](docs/user-guide/environments.md) - 多环境配置
+- 📖 [故障排查](docs/user-guide/troubleshooting.md) - 常见问题和解决方案
 
-### Development
-- 📖 [Development Setup](docs/development/setup.md) - Development environment setup
-- 📖 [Coding Standards](docs/development/coding-standards.md) - Coding standards and best practices
-- 📖 [Testing Guide](docs/development/testing.md) - Testing strategies
-- 📖 [Contributing](docs/development/contributing.md) - Contribution guide
+### 开发指南
+- 📖 [开发环境设置](docs/development/setup.md) - 开发环境配置
+- 📖 [编码规范](docs/development/coding-standards.md) - 编码规范和最佳实践
+- 📖 [测试指南](docs/development/testing.md) - 测试策略
+- 📖 [贡献指南](docs/development/contributing.md) - 贡献指南
 
-### Architecture
-- 📖 [Architecture Overview](docs/architecture/README.md) - System architecture documentation
-- 📖 [Design Patterns](docs/architecture/solid-improvements.md) - SOLID principles application
-- 📖 [HTTP Client](docs/architecture/http-client.md) - HTTP client architecture
+### 架构设计
+- 📖 [架构概览](docs/architecture/README.md) - 系统架构文档
+- 📖 [SOLID 改进](docs/architecture/solid-improvements.md) - SOLID 原则应用
+- 📖 [配置系统架构](docs/architecture/configuration.md) - 配置系统设计
+- 📖 [HTTP 客户端](docs/architecture/http-client.md) - HTTP 客户端架构
 
-### Publishing
-- 📖 [Publishing Guide](docs/publishing/README.md) - Version management and publishing
+### 发布管理
+- 📖 [发布指南](docs/publishing/README.md) - 版本管理和发布流程
+- 📖 [发布说明](docs/publishing/release-notes.md) - 版本更新记录
 
-## Project Information
+## 项目信息
 
-- **Version**: 0.1.12
-- **Package**: @zrhsh/wukong-cli
-- **Organization**: @zrhsh
-- **License**: MIT
+- **版本**: 0.3.0
+- **包名**: @zrhsh/wukong-cli
+- **组织**: @zrhsh
+- **许可证**: MIT
 - **Node.js**: v18+
 - **TypeScript**: 5.x+
 
-## Installation
+## 贡献
 
-```bash
-# Global installation from npm
-npm install -g @zzhsh/wukong-cli
-
-# Development installation from source
-git clone <repository-url>
-cd wukong-ts-cli
-npm install
-npm run build
-npm run link
-```
-
-## Development
-
-```bash
-# Clone repository
-git clone <repository-url>
-cd wukong-ts-cli
-
-# Install dependencies
-npm install
-
-# Development mode
-npm run dev auth login
-
-# Build
-npm run build
-
-# Test
-npm run link
-wukong-cli --version
-
-# Unit tests
-npm test
-
-# E2E tests - Automated (无需用户交互，CI/CD 推荐)
-npm run test:e2e:automated      # 默认环境自动化测试
-npm run test:e2e:automated:dev  # 开发环境自动化测试
-npm run test:e2e:automated:beta # 测试环境自动化测试
-npm run test:e2e:automated:prod # 生产环境自动化测试
-
-# E2E tests - Interactive (需要用户OAuth授权)
-npm run test:e2e:interactive      # 默认环境交互式测试
-npm run test:e2e:interactive:dev  # 开发环境交互式测试
-npm run test:e2e:interactive:beta # 测试环境交互式测试
-npm run test:e2e:interactive:prod # 生产环境交互式测试
-npm run test:e2e:interactive:run  # 带用户引导的交互式测试
-```
-
-## Contributing
-
-Contributions are welcome! Please see:
-- 📖 [Contributing Guide](docs/development/contributing.md)
-- 📖 [Coding Standards](docs/development/coding-standards.md)
+欢迎贡献！请参阅：
+- 📖 [贡献指南](docs/development/contributing.md)
+- 📖 [编码规范](docs/development/coding-standards.md)
 
-## License
+## 许可证
 
-MIT License - see [LICENSE](LICENSE) file for details
+MIT License - 详见 [LICENSE](LICENSE) 文件
 
-## Support
+## 支持
 
-- **Issues**: (GitHub Issues URL)
-- **Documentation**: (in docs/ directory)
-- **Debug Mode**: Use `--debug` flag for detailed logs
+- **问题反馈**: (GitHub Issues URL)
+- **文档**: (docs/ 目录)
+- **调试模式**: 使用 `--debug` 标志查看详细日志
 
-## Version History
+## 版本历史
 
-See [Release Notes](docs/publishing/release-notes.md) for version history and changes.
+详见 [发布说明](docs/publishing/release-notes.md)。
 
 ---
 
-**Current Version**: 0.1.12 | **Package**: @zrhsh/wukong-cli | **Organization**: @zrhsh
+**当前版本**: 0.3.0 | **包名**: @zrhsh/wukong-cli | **组织**: @zrhsh

package/dist/cli.js

@@ -398,7 +398,12 @@ import { join, dirname } from "path";
 import { homedir } from "os";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function getUserConfigPath() {
-  return join(homedir(), "wukong-cli.json");
+  return CONFIG_FILE_PATH;
+}
+function ensureConfigDir() {
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+  }
 }
 function createDefaultConfig() {
   const configPath = getUserConfigPath();
@@ -413,10 +418,7 @@ function createDefaultConfig() {
     }
     const templateContent = readFileSync(templatePath, "utf-8");
     const defaultConfig = JSON.parse(templateContent);
-    const dir = dirname(configPath);
-    if (!existsSync(dir)) {
-      mkdirSync(dir, { recursive: true });
-    }
+    ensureConfigDir();
     writeFileSync(configPath, JSON.stringify(defaultConfig, null, 2), "utf-8");
   } catch (error) {
   }
@@ -515,12 +517,15 @@ function getDefaultEnvironment() {
   }
   return DEFAULT_ENVIRONMENT;
 }
+var CONFIG_DIR, CONFIG_FILE_PATH;
 var init_config_loader = __esm({
   "src/config/config-loader.ts"() {
     "use strict";
     init_esm_shims();
     init_environments();
     init_config_file_error();
+    CONFIG_DIR = join(homedir(), ".wukong-cli");
+    CONFIG_FILE_PATH = join(CONFIG_DIR, "wukong-cli.json");
   }
 });
 
@@ -1619,7 +1624,7 @@ var AuthenticatingHttpClient = class {
             const config2 = getOceanetConfig();
             const baseUrl2 = options.baseUrl || config2.API_BASE_URL;
             const retryUrl = endpoint.startsWith("http") ? endpoint : `${baseUrl2}${endpoint}`;
-            const retryResponse = await fetch(
+            const retryResponse = await retoken.fetch(
               retryUrl,
               {
                 method: options.method || "GET",
@@ -2022,6 +2027,16 @@ function buildUrl2(url, baseUrl) {
   const base = baseUrl || config.API_BASE_URL;
   return `${base}${cleanUrl}`;
 }
+function parseParams(params) {
+  if (!params || Object.keys(params).length === 0) {
+    return "";
+  }
+  const searchParams = new URLSearchParams();
+  for (const [key, value] of Object.entries(params)) {
+    searchParams.append(key, value);
+  }
+  return `?${searchParams.toString()}`;
+}
 async function executeRequest(method, url, options) {
   const spinner = ora4("Sending request...").start();
   try {
@@ -2033,32 +2048,37 @@ async function executeRequest(method, url, options) {
     }
     const fullUrl = buildUrl2(url, options.baseUrl);
     const customHeaders = parseHeaders(options.headers);
-    const headers = {
-      "Content-Type": "application/json",
-      "Authorization": `Bearer ${accessToken}`,
-      ...customHeaders
-    };
-    let body;
-    if (options.data) {
-      body = options.data;
-      if (!customHeaders["Content-Type"]) {
-        headers["Content-Type"] = "application/json";
-      }
-    }
+    const client = getClient();
+    const requestData = options.data ? JSON.parse(options.data) : void 0;
+    debugRequest(method, fullUrl, { ...customHeaders, "Authorization": "Bearer ***" }, requestData);
     spinner.text = `${method} ${chalk5.cyan(fullUrl)}`;
-    debugRequest(method, fullUrl, headers, options.data ? JSON.parse(options.data) : void 0);
     const startTime = Date.now();
-    const response = await fetch(fullUrl, {
-      method,
-      headers,
-      body: method !== "GET" && method !== "DELETE" ? body : void 0
-    });
+    let data;
+    switch (method.toUpperCase()) {
+      case "GET":
+        const getUrl = fullUrl + parseParams(options.params);
+        data = await client.get(getUrl);
+        break;
+      case "POST":
+        data = await client.post(fullUrl, requestData, customHeaders);
+        break;
+      case "PUT":
+        data = await client.put(fullUrl, requestData, customHeaders);
+        break;
+      case "DELETE":
+        data = await client.delete(fullUrl);
+        break;
+      case "PATCH":
+        data = await client.patch(fullUrl, requestData, customHeaders);
+        break;
+      default:
+        throw new Error(`Unsupported method: ${method}`);
+    }
     const duration = Date.now() - startTime;
-    const data = await response.json();
-    debugResponse(response.status, response.statusText, data, duration);
+    debugResponse(200, "OK", data, duration);
     spinner.succeed("Response received");
     console.log("");
-    console.log(chalk5.dim("Status:"), response.status, response.statusText);
+    console.log(chalk5.dim("Status:"), "200 OK");
     console.log("");
     console.log(chalk5.dim("Response:"));
     console.log(JSON.stringify(data, null, 2));
@@ -2096,11 +2116,13 @@ httpCommand.command("delete <url>").description("Send DELETE request").option("-
 // src/commands/init.ts
 init_esm_shims();
 import { Command as Command3 } from "commander";
-import { writeFileSync as writeFileSync3, existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
+import { writeFileSync as writeFileSync3, existsSync as existsSync3, readFileSync as readFileSync3, mkdirSync as mkdirSync3 } from "fs";
 import { join as join3, dirname as dirname3 } from "path";
 import { homedir as homedir3 } from "os";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import chalk6 from "chalk";
+var CONFIG_DIR2 = join3(homedir3(), ".wukong-cli");
+var CONFIG_FILE_PATH2 = join3(CONFIG_DIR2, "wukong-cli.json");
 function getProjectRoot2() {
   let currentDir = dirname3(fileURLToPath3(import.meta.url));
   while (currentDir !== dirname3(currentDir)) {
@@ -2111,8 +2133,12 @@ function getProjectRoot2() {
   }
   return process.cwd();
 }
+function ensureConfigDir2() {
+  if (!existsSync3(CONFIG_DIR2)) {
+    mkdirSync3(CONFIG_DIR2, { recursive: true });
+  }
+}
 async function executeInit() {
-  const configPath = join3(homedir3(), "wukong-cli.json");
   const templatePath = join3(getProjectRoot2(), "wukong-cli.json.template");
   if (!existsSync3(templatePath)) {
     console.error(chalk6.red("\u274C Template configuration file not found"));
@@ -2120,14 +2146,15 @@ async function executeInit() {
     process.exit(1);
   }
   try {
+    ensureConfigDir2();
     const templateContent = readFileSync3(templatePath, "utf-8");
-    const configExists = existsSync3(configPath);
+    const configExists = existsSync3(CONFIG_FILE_PATH2);
     if (configExists) {
       console.log(chalk6.yellow("\u26A0\uFE0F  Existing configuration file will be overwritten"));
     }
-    writeFileSync3(configPath, templateContent, "utf-8");
+    writeFileSync3(CONFIG_FILE_PATH2, templateContent, "utf-8");
     console.log(chalk6.green("\u2705 Configuration file created successfully"));
-    console.log(chalk6.gray(`Location: ${configPath}`));
+    console.log(chalk6.gray(`Location: ${CONFIG_FILE_PATH2}`));
     if (configExists) {
       console.log(chalk6.yellow("Previous configuration has been overwritten"));
     }
@@ -2144,13 +2171,13 @@ async function executeInit() {
     process.exit(1);
   }
 }
-var initCommand = new Command3("init").description("Initialize configuration file (creates or overwrites ~/wukong-cli.json)").action(async () => {
+var initCommand = new Command3("init").description("Initialize configuration file (creates or overwrites ~/.wukong-cli/wukong-cli.json)").action(async () => {
   await executeInit();
 });
 
 // src/cli.ts
 var program = new Command4();
-program.name("wukong-cli").description("Wukong CLI - TypeScript implementation").version("0.3.0").option("--debug", "Enable debug mode (show HTTP requests)").hook("preAction", (thisCommand) => {
+program.name("wukong-cli").description("Wukong CLI - TypeScript implementation").version("0.4.1").option("-d, --debug", "Enable debug mode (show HTTP requests)").hook("preAction", (thisCommand) => {
   const options = thisCommand.opts();
   if (options.debug === true) {
     setDebugMode(true, true);