kscript 1.0.5 → 1.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1a21e42184ac49fa0c908bbb72ab90645120c9f30d7990afd195b4ebb2b36b15
-  data.tar.gz: 6109ca879f18c78b01cae044611112d01a3195cb8e963447e4258fd42db1a7ff
+  metadata.gz: 4c903c89ab57a0f91270b2b320b60981ba56ba5d6e4bb4096eb6bd26ab7b5a61
+  data.tar.gz: 17a2a9d64078442493704bb60065bcc14a4b5728dcf1b7caf2440f0ce80c0008
 SHA512:
-  metadata.gz: 53cfbde7c40af91e2d44a707743affc870b23b0c74abc486003793096883a6664c26f37d378230d831e42ca3a198523bc2e041f1d3f593efb11499e36eb2ebf6
-  data.tar.gz: 1831f66a704e1aa55186b8944e7c7641e7c8882f68644234d644c5918833121ec473b77ef51040cffb9d7aa5eab261942b3a11b2b3db5773df0fe7dcbf4c3d56
+  metadata.gz: f27cd8c019f492bd37359c01e0ca710ecc3ec99818b795efc3fd7a688ff4b06b47892421e01c7ceda79066c44184f60d86cfa07ed0c79df9db97dc367cb358cb
+  data.tar.gz: e83ee610a5684dea38c12a68933e23224dee8b2654e9c689ed81ae57e4ee6c7f52620fec51347d6b1f9288075b10e1a42fa041ae8a8c4c4c61614e04ce8dfc51

data/README.md

@@ -12,20 +12,20 @@ _  ,<  _(__  )/ /__ _  /   _  / __  /_/ / /_
 [![Gem Version](https://img.shields.io/gem/v/kscript?style=flat-square)](https://rubygems.org/gems/kscript)
 [![CI Status](https://github.com/kevin197011/kscript/actions/workflows/gem-push.yml/badge.svg?branch=main)](https://github.com/kevin197011/kscript/actions/workflows/gem-push.yml)
 
-> Ruby CLI 工具集，专为系统运维、开发自动化、网络与项目管理场景设计。支持插件化、极致美化输出、自动补全、结构化日志、CI/CD 自动发布等现代特性。
+> Ruby CLI 工具集，专为系统运维、开发自动化、网络与项目管理场景设计。支持插件化、美化输出、自动补全、结构化日志、CI/CD 自动发布等现代特性。
 
 ---
 
 ## ✨ 特性亮点
-- **统一 CLI 框架**：所有命令一键调用，美化输出
-- **插件化架构**：业务命令即插件，易扩展、易维护
-- **极致美化**：ASCII banner、彩色分组、对齐、分隔线，极客体验
-- **人性化/结构化日志双模式**：`--log`/`--log-level` 切换，支持 JSON/终端友好输出
-- **自动补全**：zsh/bash 补全脚本自动部署，命令一键补全
-- **参数健壮**：所有插件兼容多余参数，支持全局参数过滤
-- **CI/CD 自动发布**：GitHub Actions 自动构建并推送 RubyGem
-- **多平台支持**：macOS、Linux、Windows（部分工具）
-- **自动生成配置**：首次安装自动生成 `~/.kscript/.env` 配置示例
+- 统一 CLI 框架，所有命令一键调用，美化输出
+- 插件化架构，业务命令即插件，易扩展、易维护
+- 美化输出：ASCII banner、彩色分组、分隔线
+- 人性化/结构化日志双模式：`--log`/`--log-level` 切换，支持 JSON/终端友好输出
+- 自动补全：zsh/bash 补全脚本自动部署
+- 参数健壮：所有插件兼容多余参数，支持全局参数过滤
+- CI/CD 自动发布：GitHub Actions 自动构建并推送 RubyGem
+- 多平台支持：macOS、Linux，部分工具支持 Windows
+- 自动生成配置：首次安装自动生成 `~/.kscript/.env` 配置示例
 
 ---
 
@@ -67,17 +67,17 @@ kscript version
 ```bash
 kscript <command> [args...]
 # 例如
-kscript apnic CN
-kscript portscan 192.168.1.1
-kscript sh 'ls -l'
-kscript projscan ~/projects
+kscript apnic_ip CN
+kscript port_scan 192.168.1.1
+kscript shell_helper 'ls -l'
+kscript project_scan ~/projects
 kscript aws_s3 --file local.txt --bucket my-bucket --key test.txt --region ap-northeast-1 --access_key xxx --secret_key yyy
 ```
 
 ### 结构化日志模式
 ```bash
-kscript apnic CN --log
-kscript portscan 192.168.1.1 --log-level=debug
+kscript apnic_ip CN --log
+kscript port_scan 192.168.1.1 --log-level=debug
 ```
 
 ---
@@ -86,40 +86,32 @@ kscript portscan 192.168.1.1 --log-level=debug
 
 > 运行 `kscript list` 可分组美化展示所有插件命令
 
-- **network**
-  - `apnic`：获取国家 IPv4 段
-  - `portscan`：端口扫描
-  - `ip`：IP 工具
-  - `wg_acl`：WireGuard 防火墙 ACL
-  - `wg_pass`：WireGuard 密码工具
-- **project**
-  - `projscan`：扫描目录下所有 git 项目
-  - `cleaner`：源码多版本清理
-  - `rename`：批量重命名文件
-- **system/macos**
-  - `syscheck`：macOS 系统健康检查
-  - `top`：macOS 资源占用排行
-  - `optimize`：macOS 性能优化
-  - `sh`：命令行速查/cheatsheet
-- **media**
-  - `ffmpeg`：FFmpeg 安装与检测
-- **elastic**
-  - `es_fingerprint`：Elasticsearch 证书指纹
-  - `kibana`：Kibana 空间/索引/用户/角色自动化
-- **ci**
-  - `jenkins`：Jenkins Job 导入导出
-- **cloud**
-  - `aws_s3`：AWS S3 文件上传测试
-- **其它**
-  - `usd`：美元汇率工具
-  - `lvm`：LVM 卷管理
-  - `windows_font_enhancer`：Windows 字体增强
+| 分组      | 命令                   | 用法示例                                                         | 参数说明                                               | 描述                                                         |
+|-----------|------------------------|------------------------------------------------------------------|--------------------------------------------------------|--------------------------------------------------------------|
+| network   | `apnic_ip`             | `kscript apnic_ip CN`                                            | `[country_code]`                                       | Get APNIC IPv4 ranges for a country.                         |
+| network   | `port_scan`            | `kscript port_scan 192.168.1.1`                                  | `<target_host> [ports] [thread_count]`                 | Scan open ports on a target host.                            |
+| network   | `ip_lookup`            | `kscript ip_lookup 8.8.8.8`                                      | `<ip_address>`                                         | Query IP geolocation and ISP info.                           |
+| network   | `wg_acl`               | `kscript wg_acl add --ip=10.0.0.2`                               | `[subcommand] [options]`                               | Manage WireGuard firewall ACL rules.                         |
+| network   | `wg_pass`              | `kscript wg_pass 32`                                             | `[length]`                                             | Generate a random password for WireGuard.                    |
+| project   | `project_scan`         | `kscript project_scan ~/projects/src`                            | `[src_path]`                                           | Scan and list all git projects in a directory.               |
+| project   | `vcs_cleaner`          | `kscript vcs_cleaner ~/projects/src`                             | `[src_path]`                                           | Clean old source code versions, keep N latest.               |
+| project   | `file_rename`          | `kscript file_rename foo bar ./src`                              | `<pattern> <replacement> [path]`                       | Batch rename files by pattern.                               |
+| system    | `shell_helper`         | `kscript shell_helper 'ls'`                                      | `[subcommand] [args...]`                               | Query shell command usage and cheatsheets.                   |
+| system    | `lvm_manage`           | `kscript lvm_manage /dev/sda2 /mnt/data`                         | `<device> <mount_point>`                               | Mount and manage Linux LVM volumes.                          |
+| macos     | `mac_status`           | `kscript mac_status`                                             |                                                        | Show macOS system resource monitor report.                   |
+| macos     | `mac_optimize`         | `kscript mac_optimize`                                           |                                                        | Optimize macOS system performance.                           |
+| media     | `ffmpeg_install`       | `kscript ffmpeg_install 6.0`                                     | `[version]`                                            | Install and verify FFmpeg on Linux.                          |
+| elastic   | `elastic_cert_finger`  | `kscript elastic_cert_finger ./ca.crt`                           | `<cert_file>`                                          | Generate Elasticsearch certificate SHA256 fingerprint.       |
+| elastic   | `kibana_manage`        | `kscript kibana_manage export --host=localhost --index=log-*`    | `[subcommand] [options]`                               | Kibana automation: space, index, user, role management.      |
+| ci        | `jenkins_manage`       | `kscript jenkins_manage list --host=jenkins.local`               | `[subcommand] [options]`                               | Jenkins job export/import automation.                        |
+| cloud     | `aws_s3`               | `kscript aws_s3 --file local.txt --bucket my-bucket ...`         | `--file --bucket --key --region --access_key --secret_key` | Upload a file to AWS S3 for testing.                         |
+| finance   | `usd_rate`             | `kscript usd_rate CNY`                                           | `[currency_code]`                                      | Get latest USD exchange rates.                               |
 
 ---
 
 ## ⚡ Shell 自动补全 & 配置示例
 
-- **首次安装/升级自动为 zsh/bash 部署补全脚本，并生成 `~/.kscript/.env` 配置示例**
+- 首次安装/升级自动为 zsh/bash 部署补全脚本，并生成 `~/.kscript/.env` 配置示例
 - 补全脚本路径：
   - zsh: `~/.zsh/completions/_kscript`
   - bash: `~/.bash_completion.d/kscript`
@@ -153,7 +145,7 @@ LOG=1
 
 ## 🧑‍💻 插件开发规范
 - 插件文件统一放在 `lib/kscript/plugins/kk_xxx_utils.rb`
-- 类名如 `KkApnicUtils`，自动注册为 `apnic` 命令
+- 类名如 `KkApnicIpUtils`，自动注册为 `apnic_ip` 命令
 - 支持 `self.description`、`self.usage`、`self.arguments`、`self.group`、`self.author`
 - 输出统一用 `logger.kinfo`/`logger.kerror`，支持结构化日志
 - 兼容多余参数，避免 ArgumentError
@@ -172,7 +164,7 @@ LOG=1
 ## 📦 依赖与兼容性
 
 - Ruby >= 3.0
-- 依赖：bcrypt, http, nokogiri, thor, aws-sdk-s3 等
+- 依赖：bcrypt, http, nokogiri, thor, aws-sdk-s3, httpx 等
 - 支持 macOS、Linux，部分工具支持 Windows
 
 ---

data/lib/kscript/base.rb

@@ -37,7 +37,7 @@ module Kscript
 
     # 判断是否为人性化输出模式（无 --log/--log-level 参数且 ENV['LOG'] 未设置）
     def human_output?
-      !(ARGV.include?('--log') || ARGV.include?('--log-level') || ENV['LOG'])
+      !(ARGV.include?('--log') || ARGV.include?('--log-level') || ENV.fetch('LOG', nil))
     end
   end
 end

data/lib/kscript/cli.rb

@@ -70,7 +70,7 @@ module Kscript
       orig_command = info[:name].to_s.sub(/^kk_/, '')
       # shell -> sh
       command = orig_command == 'shell' ? 'sh' : orig_command
-      command = reserved.include?(command) ? "#{command}_cmd" : command
+      command = "#{command}_cmd" if reserved.include?(command)
       klass = info[:class]
       desc command,
            (info[:description] || 'No description') + (reserved.include?(orig_command) ? " (original: #{orig_command})" : '')
@@ -113,7 +113,7 @@ module Kscript
       else
         puts bold('Loaded environment variables:')
         keys.sort.each do |k|
-          v = ENV[k]
+          v = ENV.fetch(k, nil)
           puts green(k.ljust(28)) + gray('=') + cyan(v)
         end
       end

data/lib/kscript/logger.rb

@@ -5,23 +5,27 @@ module Kscript
   class Logger
     LEVELS = %i[debug info warn error fatal unknown].freeze
 
-    # 极客风格终端输出
+    # Colorful output
     COLORS = {
       info: "\e[32m", # green
       warn: "\e[33m", # yellow
       error: "\e[31m", # red
       debug: "\e[90m", # gray
+      fatal: "\e[35m", # magenta
+      unknown: "\e[36m", # cyan
       reset: "\e[0m"
     }.freeze
 
     def initialize(service: 'kscript', level: :info, out: $stdout, human_output: nil)
+      require 'json'
+      require 'time'
       @service = service
       @logger = ::Logger.new(out)
       @logger.level = ::Logger.const_get(level.to_s.upcase)
       @human_output = human_output
     end
 
-    # 允许外部设置输出模式
+    # 设置人类可读输出模式
     def set_human_output(val)
       @human_output = val
     end
@@ -44,6 +48,7 @@ module Kscript
       end
     end
 
+    # 结构化日志输出
     def log(level, message, context = {})
       entry = {
         timestamp: Time.now.utc.iso8601,
@@ -55,7 +60,7 @@ module Kscript
       @logger.send(level, entry.to_json)
     end
 
-    # 终端输出
+    # 终端输出（带颜色、trace、时间等）
     def klog(level, message, context = {})
       if human_output?
         puts "[#{level.to_s.upcase}] #{message} #{context.map { |k, v| "#{k}=#{v}" }.join(' ')}".strip
@@ -72,7 +77,7 @@ module Kscript
       end
     end
 
-    # 便捷方法
+    # 便捷方法（info/warn/error/debug）
     def kinfo(msg, ctx = {})
       klog(:info, msg, ctx)
     end

data/lib/kscript/plugins/{kk_apnic_utils.rb → kk_apnic_ip_utils.rb}

@@ -8,7 +8,7 @@
 require 'kscript'
 
 module Kscript
-  class KkApnicUtils < Base
+  class KkApnicIpUtils < Base
     attr_reader :country_sn, :cache_file
 
     # Initialize class instance, set country code and cache file path
@@ -69,7 +69,7 @@ module Kscript
     end
 
     def self.usage
-      "kscript apnic CN\nkscript apnic US"
+      "kscript apnic_ip CN\nkscript apnic_ip US"
     end
 
     def self.group

data/lib/kscript/plugins/kk_aws_s3_utils.rb

@@ -17,14 +17,14 @@ module Kscript
   class KkAwsS3Utils < Base
     # 初始化，支持所有参数通过 CLI 传递
     def initialize(*args, **opts)
-      super(*args, **opts)
+      super
       # 兼容 --file test.txt 以及 --file=test.txt
       @file = opts[:file] || args[0]
-      @bucket = opts[:bucket] || args[1] || ENV['AWS_BUCKET']
+      @bucket = opts[:bucket] || args[1] || ENV.fetch('AWS_BUCKET', nil)
       @key = opts[:key] || args[2]
-      @region = opts[:region] || ENV['AWS_REGION']
-      @access_key = opts[:access_key] || ENV['AWS_ACCESS_KEY_ID']
-      @secret_key = opts[:secret_key] || ENV['AWS_SECRET_ACCESS_KEY']
+      @region = opts[:region] || ENV.fetch('AWS_REGION', nil)
+      @access_key = opts[:access_key] || ENV.fetch('AWS_ACCESS_KEY_ID', nil)
+      @secret_key = opts[:secret_key] || ENV.fetch('AWS_SECRET_ACCESS_KEY', nil)
     end
 
     # 主入口

data/lib/kscript/plugins/{kk_es_fingerprint_utils.rb → kk_elastic_cert_finger_utils.rb}

@@ -8,7 +8,7 @@
 require 'kscript'
 
 module Kscript
-  class KkEsFingerprintUtils < Base
+  class KkElasticCertFingerUtils < Base
     DEFAULT_CERT_PATH = 'elasticsearch.crt'
 
     attr_reader :cert_path
@@ -16,7 +16,7 @@ module Kscript
     # Initialize with certificate path
     # @param cert_path [String] path to the certificate file
     def initialize(*args, **opts)
-      super(*args, **opts)
+      super
       @cert_path = opts[:cert_path] || self.class::DEFAULT_CERT_PATH
     end
 
@@ -31,7 +31,7 @@ module Kscript
     end
 
     def self.usage
-      "kscript es_fingerprint <cert_file>\nkscript es_fingerprint ./ca.crt"
+      "kscript elastic_cert_finger <cert_file>\nkscript elastic_cert_finger ./ca.crt"
     end
 
     def self.group

data/lib/kscript/plugins/{kk_ffmpeg_utils.rb → kk_ffmpeg_install_utils.rb}

@@ -8,9 +8,9 @@
 require 'kscript'
 
 module Kscript
-  class KkFfmpegUtils < Base
+  class KkFfmpegInstallUtils < Base
     def initialize(*args, **opts)
-      super(*args, **opts)
+      super
     end
 
     def run
@@ -28,7 +28,7 @@ module Kscript
     end
 
     def self.usage
-      "kscript ffmpeg 6.0\nkscript ffmpeg latest"
+      "kscript ffmpeg_install 6.0\nkscript ffmpeg_install latest"
     end
 
     def self.group

data/lib/kscript/plugins/{kk_rename_utils.rb → kk_file_rename_utils.rb}

@@ -8,11 +8,11 @@
 require 'kscript'
 
 module Kscript
-  class KkRenameUtils < Base
+  class KkFileRenameUtils < Base
     attr_reader :source_pattern, :target_pattern, :directory
 
     def initialize(*args, **opts)
-      super(*args, **opts)
+      super
       @source_pattern = args[0]
       @target_pattern = args[1]
       @directory = args[2] || Dir.pwd
@@ -35,7 +35,7 @@ module Kscript
     end
 
     def self.usage
-      "kscript rename foo bar ./src\nkscript rename 'test' 'prod' ~/projects"
+      "kscript file_rename foo bar ./src\nkscript file_rename 'test' 'prod' ~/projects"
     end
 
     def self.group

data/lib/kscript/plugins/{kk_ip_utils.rb → kk_ip_lookup_utils.rb}

@@ -8,20 +8,23 @@
 require 'kscript'
 
 module Kscript
-  class KkIpUtils < Base
+  class KkIpLookupUtils < Base
     IP_API_BASE_URL = 'http://ip-api.com/json'
     IP_CHECK_URL = 'https://api.ipify.org?format=json'
 
     attr_reader :ip_address
 
     def initialize(*args, **opts)
-      super(*args, **opts)
+      super
       @ip_address = args.first || fetch_public_ip
     end
 
-    def run
+    def run(*args, **_opts)
       with_error_handling do
-        fetch_location
+        ip = args.first || @ip_address
+        validate_ip_address!(ip)
+        response = make_api_request(ip)
+        handle_response(response)
       end
     end
 
@@ -36,7 +39,7 @@ module Kscript
     end
 
     def self.usage
-      "kscript ip <ip_address>\nkscript ip 8.8.8.8"
+      "kscript ip_lookup <ip_address>\nkscript ip_lookup 8.8.8.8"
     end
 
     def self.group
@@ -54,31 +57,43 @@ module Kscript
     private
 
     def fetch_public_ip
-      response = HTTP.get(IP_CHECK_URL)
-      raise "Failed to detect public IP: #{response.status}" unless response.status.success?
+      begin
+        require 'httpx'
+      rescue LoadError
+        abort 'Missing dependency: httpx. Please run: gem install httpx'
+      end
+      response = HTTPX.get(IP_CHECK_URL)
+      response = response.first if response.is_a?(Array)
+      raise "Failed to detect public IP: #{response.status}" unless response.status == 200
 
       data = JSON.parse(response.body.to_s)
-      logger.info("Detected public IP: #{data['ip']}")
+      logger.kinfo("Detected public IP: #{data['ip']}")
       data['ip']
     end
 
-    def validate_ip_address!
-      return if valid_ip_format?
+    def validate_ip_address!(ip)
+      return if valid_ip_format?(ip)
 
       raise ArgumentError, 'Invalid IP address format'
     end
 
-    def valid_ip_format?
-      /^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.match?(@ip_address)
+    def valid_ip_format?(ip)
+      /^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.match?(ip)
     end
 
-    def make_api_request
-      HTTP.get("#{IP_API_BASE_URL}/#{@ip_address}")
+    def make_api_request(ip)
+      begin
+        require 'httpx'
+      rescue LoadError
+        abort 'Missing dependency: httpx. Please run: gem install httpx'
+      end
+      response = HTTPX.get("#{IP_API_BASE_URL}/#{ip}")
+      response.is_a?(Array) ? response.first : response
     end
 
     def handle_response(response)
-      if response.status.success?
-        logger.kinfo('IP location result', data: response.parse(:json))
+      if response.status == 200
+        logger.kinfo('IP location result', data: JSON.parse(response.body.to_s))
       else
         logger.kerror("API request failed: #{response.status}")
       end

data/lib/kscript/plugins/{kk_jenkins_utils.rb → kk_jenkins_manage_utils.rb}

@@ -8,9 +8,9 @@
 require 'kscript'
 
 module Kscript
-  class KkJenkinsUtils < Base
+  class KkJenkinsManageUtils < Base
     def initialize(*args, **opts)
-      super(*args, **opts)
+      super
       jenkins_url, user, password = args
       @jenkins_url = jenkins_url
       @user = user
@@ -106,7 +106,7 @@ module Kscript
     end
 
     def self.usage
-      "kscript jenkins list --host=jenkins.local\nkscript jenkins trigger --job=build"
+      "kscript jenkins_manage list --host=jenkins.local\nkscript jenkins_manage trigger --job=build"
     end
 
     def self.group

data/lib/kscript/plugins/{kk_kibana_utils.rb → kk_kibana_manage_utils.rb}

@@ -8,9 +8,9 @@
 require 'kscript'
 
 module Kscript
-  class KkKibanaUtils < Base
+  class KkKibanaManageUtils < Base
     def initialize(*args, **opts)
-      super(*args, **opts)
+      super
       project_name, project_env, base_url, username, password = args
       @base_url = base_url
       @username = username
@@ -158,7 +158,7 @@ module Kscript
     end
 
     def self.usage
-      "kscript kibana export --host=localhost --index=log-*\nkscript kibana import --file=dashboard.json"
+      "kscript kibana_manage export --host=localhost --index=log-*\nkscript kibana_manage import --file=dashboard.json"
     end
 
     def self.group
@@ -191,23 +191,23 @@ module Kscript
     # Construct the body for creating an index
     def index_body(index_name, uuid)
       {
-        "contentTypeId": 'index-pattern',
-        "data": {
-          "fieldAttrs": '{}',
-          "title": "#{index_name}*",
-          "timeFieldName": '@timestamp',
-          "sourceFilters": '[]',
-          "fields": '[]',
-          "fieldFormatMap": '{}',
-          "runtimeFieldMap": '{}',
-          "name": index_name,
-          "allowHidden": false
+        contentTypeId: 'index-pattern',
+        data: {
+          fieldAttrs: '{}',
+          title: "#{index_name}*",
+          timeFieldName: '@timestamp',
+          sourceFilters: '[]',
+          fields: '[]',
+          fieldFormatMap: '{}',
+          runtimeFieldMap: '{}',
+          name: index_name,
+          allowHidden: false
         },
-        "options": {
-          "id": uuid,
-          "overwrite": false
+        options: {
+          id: uuid,
+          overwrite: false
         },
-        "version": 1
+        version: 1
       }
     end
 

data/lib/kscript/plugins/{kk_lvm_utils.rb → kk_lvm_manage_utils.rb}

@@ -8,7 +8,7 @@
 require 'kscript'
 
 module Kscript
-  class KkLvmUtils < Base
+  class KkLvmManageUtils < Base
     DEFAULT_CONFIG = {
       device: '/dev/sdb',
       volume_group: 'vg_data',
@@ -21,7 +21,7 @@ module Kscript
     # Initialize the LVM mounter with configuration
     # @param config [Hash] configuration options
     def initialize(*args, **opts)
-      super(*args, **opts)
+      super
       @config = DEFAULT_CONFIG.merge(opts)
     end
 
@@ -47,7 +47,7 @@ module Kscript
     end
 
     def self.usage
-      "kscript lvm /dev/sda2 /mnt/data\nkscript lvm /dev/vg0/lv_home /mnt/home"
+      "kscript lvm_manage /dev/sda2 /mnt/data\nkscript lvm_manage /dev/vg0/lv_home /mnt/home"
     end
 
     def self.group

data/lib/kscript/plugins/{kk_optimize_utils.rb → kk_mac_optimize_utils.rb}

@@ -8,9 +8,9 @@
 require 'kscript'
 
 module Kscript
-  class KkOptimizeUtils < Base
+  class KkMacOptimizeUtils < Base
     def initialize(*args, **opts)
-      super(*args, **opts)
+      super
     end
 
     def run(*args, **_opts)
@@ -74,7 +74,7 @@ module Kscript
     end
 
     def self.usage
-      'kscript optimize'
+      'kscript mac_optimize'
     end
 
     def self.group

data/lib/kscript/plugins/{kk_syscheck_utils.rb → kk_mac_status_utils.rb}

@@ -8,9 +8,9 @@
 require 'kscript'
 
 module Kscript
-  class KkSyscheckUtils < Base
+  class KkMacStatusUtils < Base
     def initialize(*_args, **opts)
-      super(**opts.merge(service: 'kk_syscheck'))
+      super(**opts.merge(service: 'kk_mac_status'))
     end
 
     def run
@@ -24,19 +24,12 @@ module Kscript
       logger.kinfo("📅 Date Time: #{Time.now}")
       logger.kinfo('')
 
-      # CPU Usage
-      logger.kinfo('===============================')
-      logger.kinfo(' CPU Usage (Top 10)')
-      logger.kinfo('===============================')
-      cpu_output = `ps aux | sort -nrk 3 | head -n 10`
-      logger.kinfo(cpu_output)
-
-      # Memory Usage
-      logger.kinfo('===============================')
-      logger.kinfo(' Memory Usage (Top 10)')
-      logger.kinfo('===============================')
-      mem_output = `ps aux | sort -nrk 4 | head -n 10`
-      logger.kinfo(mem_output)
+      # Top 10 by CPU
+      print_header('Top 10 Processes by CPU Usage')
+      print_process_list(:cpu)
+      # Top 10 by Memory
+      print_header('Top 10 Processes by Memory Usage')
+      print_process_list(:mem)
 
       # GPU Usage
       if `which powermetrics`.strip.empty?
@@ -77,6 +70,25 @@ module Kscript
       logger.kinfo("\n✅ System resource check completed!")
     end
 
+    def print_header(title)
+      logger.kinfo('')
+      logger.kinfo('===============================')
+      logger.kinfo(" #{title}")
+      logger.kinfo('===============================')
+    end
+
+    def print_process_list(sort_field)
+      lines = `ps aux`.split("\n")
+      lines.shift
+      processes = lines.map { |line| line.split(/\s+/, 11) }
+      index = sort_field == :cpu ? 2 : 3
+      top = processes.sort_by { |p| -p[index].to_f }.first(10)
+      logger.kinfo('USER       PID      %CPU  %MEM  COMMAND   ')
+      top.each do |p|
+        logger.kinfo(format('%-10s %-8s %-5s %-5s %-10s', p[0], p[1], p[2], p[3], p[10][0..30]))
+      end
+    end
+
     def self.description
       'Show macOS system resource monitor report.'
     end
@@ -86,7 +98,7 @@ module Kscript
     end
 
     def self.usage
-      "kscript syscheck\nkscript syscheck --detail"
+      "kscript mac_status\nkscript mac_status --detail"
     end
 
     def self.group

data/lib/kscript/plugins/{kk_portscan_utils.rb → kk_port_scan_utils.rb}

@@ -8,7 +8,7 @@
 require 'kscript'
 
 module Kscript
-  class KkPortscanUtils < Base
+  class KkPortScanUtils < Base
     attr_reader :host, :ports, :thread_count
 
     # Initialize the scanner with target host and port range
@@ -16,7 +16,7 @@ module Kscript
     # @param ports [Array<Integer>] list of ports to scan
     # @param thread_count [Integer] number of concurrent threads
     def initialize(*args, **opts)
-      super(*args, **opts)
+      super
       @target = args[0]
       @ports = parse_ports(args[1] || (1..1024))
       @thread_count = (opts[:thread_count] || 50).to_i
@@ -98,7 +98,7 @@ module Kscript
     end
 
     def self.usage
-      "kscript portscan 192.168.1.1\nkscript portscan example.com 22,80,443 100\nkscript portscan 192.168.1.1 1..1024 200"
+      "kscript port_scan 192.168.1.1\nkscript port_scan example.com 22,80,443 100\nkscript port_scan 192.168.1.1 1..1024 200"
     end
 
     def self.group

data/lib/kscript/plugins/{kk_projscan_utils.rb → kk_project_scan_utils.rb}

@@ -8,9 +8,9 @@
 require 'kscript'
 
 module Kscript
-  class KkProjscanUtils < Base
+  class KkProjectScanUtils < Base
     def initialize(*args, **opts)
-      super(*args, **opts)
+      super
     end
 
     def run
@@ -34,7 +34,7 @@ module Kscript
     end
 
     def self.usage
-      "kscript projscan ~/projects/src\nkscript projscan /opt --type=go"
+      "kscript project_scan ~/projects/src\nkscript project_scan /opt --type=go"
     end
 
     def self.group
@@ -56,7 +56,7 @@ module Kscript
 
     def scan_projects
       projects = []
-      Dir.glob(File.join(@src_path, '*')).sort.each do |path|
+      Dir.glob(File.join(@src_path, '*')).each do |path|
         next unless File.directory?(path)
         next unless git_project?(path)
 

data/lib/kscript/plugins/kk_shell_helper_utils.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2025 Kk
+#
+# This software is released under the MIT License.
+# https://opensource.org/licenses/MIT
+
+require 'kscript'
+
+module Kscript
+  class KkShellHelperUtils < Base
+    CHT_SH_URL = 'https://cht.sh'
+
+    attr_reader :command
+
+    # Initialize with shell command to look up
+    # @param command [String] command to get help for
+    def initialize(*args, **opts)
+      super
+      @command = args.join(' ').strip
+    end
+
+    def run(*args, **_opts)
+      command = args.join(' ').strip
+      with_error_handling do
+        if command.nil? || command.strip.empty?
+          logger.kwarn("Usage: #{self.class.usage}")
+        else
+          fetch_help(command)
+        end
+      end
+    end
+
+    def help
+      if command
+        fetch_help
+      else
+        logger.kinfo("Usage: #{$PROGRAM_NAME} <command>")
+        exit 1
+      end
+    end
+
+    # Fetch and display command documentation
+    def fetch_help(command)
+      response = make_request(command)
+      response = response.first if response.is_a?(Array)
+      puts response.body
+    rescue StandardError => e
+      display_error(e)
+    end
+
+    def self.arguments
+      '[subcommand] [args...]'
+    end
+
+    def self.usage
+      "kscript shell_helper 'ls'\nkscript shell_helper 'echo hello'"
+    end
+
+    def self.group
+      'system'
+    end
+
+    def self.author
+      'kk'
+    end
+
+    def self.description
+      'Query shell command usage and cheatsheets.'
+    end
+
+    private
+
+    # Make HTTP request to cheat.sh
+    # @return [HTTPX::Response] response from cheat.sh
+    def make_request(command)
+      begin
+        require 'httpx'
+        require 'uri'
+      rescue LoadError
+        abort 'Missing dependency: httpx. Please run: gem install httpx'
+      end
+      HTTPX.with(
+        headers: {
+          'User-Agent' => 'curl/8.0.1',
+          'Accept' => 'text/plain'
+        }
+      ).get("https://cheat.sh/#{URI.encode_www_form_component(command)}")
+    end
+
+    # Display error message
+    # @param error [StandardError] error to display
+    def display_error(error)
+      logger.kerror("An error occurred: #{error.message}")
+    end
+  end
+end

data/lib/kscript/plugins/{kk_usd_utils.rb → kk_usd_rate_utils.rb}

@@ -11,7 +11,7 @@ require 'net/http'
 require 'json'
 
 module Kscript
-  class KkUsdUtils < Base
+  class KkUsdRateUtils < Base
     API_URL = 'https://api.exchangerate-api.com/v4/latest/USD'
 
     def initialize(currency_code = 'CNY', *args, **opts)
@@ -44,7 +44,7 @@ module Kscript
     end
 
     def self.usage
-      "kscript usd CNY\nkscript usd EUR"
+      "kscript usd_rate CNY\nkscript usd_rate EUR"
     end
 
     def self.group

data/lib/kscript/plugins/{kk_cleaner_utils.rb → kk_vcs_cleaner_utils.rb}

@@ -8,7 +8,7 @@
 require 'kscript'
 
 module Kscript
-  class KkCleanerUtils < Base
+  class KkVcsCleanerUtils < Base
     DEFAULT_RETAIN_VERSIONS = 10
 
     attr_reader :source_path, :retain_count
@@ -17,7 +17,7 @@ module Kscript
     # @param source_path [String] path to source code directory
     # @param retain_count [Integer] number of versions to keep
     def initialize(*args, **opts)
-      super(*args, **opts)
+      super
       @source_path = args[0] || '/data/sources/*/**'
       @retain_count = args[1] || DEFAULT_RETAIN_VERSIONS
     end
@@ -40,7 +40,7 @@ module Kscript
     end
 
     def self.usage
-      "kscript source_cleaner ~/projects/src\nkscript source_cleaner . --exclude=vendor"
+      "kscript vcs_cleaner ~/projects/src\nkscript vcs_cleaner . --exclude=vendor"
     end
 
     def self.group

data/lib/kscript/plugins/kk_wg_acl_utils.rb

@@ -13,7 +13,7 @@ module Kscript
     ALLOWED_IPS = %w[127.0.0.1].freeze
 
     def initialize(*args, **opts)
-      super(*args, **opts)
+      super
     end
 
     def run

data/lib/kscript/plugins/kk_wg_pass_utils.rb

@@ -10,7 +10,7 @@ require 'kscript'
 module Kscript
   class KkWgPassUtils < Base
     def initialize(*args, **opts)
-      super(*args, **opts)
+      super
     end
 
     def run

data/lib/kscript/plugins.rb

@@ -5,7 +5,7 @@ module Kscript
     PLUGIN_DIR = File.expand_path('plugins', __dir__)
 
     def self.load_all
-      Dir.glob(File.join(PLUGIN_DIR, 'kk_*.rb')).sort.each do |file|
+      Dir.glob(File.join(PLUGIN_DIR, 'kk_*.rb')).each do |file|
         # 解析出类名
         basename = File.basename(file, '.rb')
         class_name = basename.split('_').map(&:capitalize).join

data/lib/kscript/version.rb

@@ -6,5 +6,5 @@
 # https://opensource.org/licenses/MIT
 
 module Kscript
-  VERSION = '1.0.5'
+  VERSION = '1.0.7'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kscript
 version: !ruby/object:Gem::Version
-  version: 1.0.5
+  version: 1.0.7
 platform: ruby
 authors:
 - Kk
@@ -59,25 +59,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '3.0'
 - !ruby/object:Gem::Dependency
-  name: http
+  name: httpx
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '4.0'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: '1.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '4.0'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: '1.5'
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
@@ -162,23 +156,22 @@ files:
 - lib/kscript/config.rb
 - lib/kscript/logger.rb
 - lib/kscript/plugins.rb
-- lib/kscript/plugins/kk_apnic_utils.rb
+- lib/kscript/plugins/kk_apnic_ip_utils.rb
 - lib/kscript/plugins/kk_aws_s3_utils.rb
-- lib/kscript/plugins/kk_cleaner_utils.rb
-- lib/kscript/plugins/kk_es_fingerprint_utils.rb
-- lib/kscript/plugins/kk_ffmpeg_utils.rb
-- lib/kscript/plugins/kk_ip_utils.rb
-- lib/kscript/plugins/kk_jenkins_utils.rb
-- lib/kscript/plugins/kk_kibana_utils.rb
-- lib/kscript/plugins/kk_lvm_utils.rb
-- lib/kscript/plugins/kk_optimize_utils.rb
-- lib/kscript/plugins/kk_portscan_utils.rb
-- lib/kscript/plugins/kk_projscan_utils.rb
-- lib/kscript/plugins/kk_rename_utils.rb
-- lib/kscript/plugins/kk_sh_utils.rb
-- lib/kscript/plugins/kk_syscheck_utils.rb
-- lib/kscript/plugins/kk_top_utils.rb
-- lib/kscript/plugins/kk_usd_utils.rb
+- lib/kscript/plugins/kk_elastic_cert_finger_utils.rb
+- lib/kscript/plugins/kk_ffmpeg_install_utils.rb
+- lib/kscript/plugins/kk_file_rename_utils.rb
+- lib/kscript/plugins/kk_ip_lookup_utils.rb
+- lib/kscript/plugins/kk_jenkins_manage_utils.rb
+- lib/kscript/plugins/kk_kibana_manage_utils.rb
+- lib/kscript/plugins/kk_lvm_manage_utils.rb
+- lib/kscript/plugins/kk_mac_optimize_utils.rb
+- lib/kscript/plugins/kk_mac_status_utils.rb
+- lib/kscript/plugins/kk_port_scan_utils.rb
+- lib/kscript/plugins/kk_project_scan_utils.rb
+- lib/kscript/plugins/kk_shell_helper_utils.rb
+- lib/kscript/plugins/kk_usd_rate_utils.rb
+- lib/kscript/plugins/kk_vcs_cleaner_utils.rb
 - lib/kscript/plugins/kk_wg_acl_utils.rb
 - lib/kscript/plugins/kk_wg_pass_utils.rb
 - lib/kscript/post_install.rb

data/lib/kscript/plugins/kk_sh_utils.rb

@@ -1,111 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright (c) 2025 Kk
-#
-# This software is released under the MIT License.
-# https://opensource.org/licenses/MIT
-
-require 'kscript'
-
-module Kscript
-  class KkShUtils < Base
-    CHT_SH_URL = 'https://cht.sh'
-
-    attr_reader :command
-
-    # Initialize with shell command to look up
-    # @param command [String] command to get help for
-    def initialize(*args, **opts)
-      super(*args, **opts)
-      @command = args.first
-    end
-
-    def run
-      with_error_handling do
-        help
-      end
-    end
-
-    def help
-      if command
-        fetch_help
-      else
-        logger.kinfo("Usage: #{$PROGRAM_NAME} <command>")
-        exit 1
-      end
-    end
-
-    # Fetch and display command documentation
-    def fetch_help
-      response = make_request
-      display_result(response)
-    rescue HTTP::Error => e
-      display_error(e)
-    end
-
-    def self.arguments
-      '[subcommand] [args...]'
-    end
-
-    def self.usage
-      "kscript sh 'ls'\nkscript sh 'echo hello'"
-    end
-
-    def self.group
-      'system'
-    end
-
-    def self.author
-      'kk'
-    end
-
-    def self.description
-      'Query sh command usage and cheatsheets.'
-    end
-
-    private
-
-    # Make HTTP request to cht.sh
-    # @return [HTTP::Response] response from cht.sh
-    def make_request
-      HTTP.get("#{CHT_SH_URL}/#{command}")
-    end
-
-    # Display command documentation
-    # @param response [HTTP::Response] response from cht.sh
-    def display_result(response)
-      if response.status.success?
-        text = extract_plain_text(response.body)
-        logger.kinfo(text)
-      else
-        logger.kerror("Failed to retrieve data: #{response.status}")
-      end
-    end
-
-    # 提取纯文本内容
-    def extract_plain_text(body)
-      body = body.to_s
-      begin
-        doc = Nokogiri::HTML(body)
-        doc.search('script,style').remove
-        text = doc.text.lines.map(&:strip)
-        # 过滤掉包含广告/社交/Follow等内容的行
-        text = text.reject { |line| line =~ /Follow @|twitter|github|sponsor|donate|chubin|^!function/ }
-        text.reject!(&:empty?)
-        # 去除顶部多余空白行，只保留正文
-        text = text.drop_while(&:empty?)
-        text.join("\n")
-      rescue StandardError
-        body.gsub(/\e\[[\d;]*m/, '').lines.reject do |line|
-          line =~ /Follow @|twitter|github|sponsor|donate|chubin|^!function/
-        end.drop_while { |line| line.strip.empty? }.join
-      end
-    end
-
-    # Display error message
-    # @param error [StandardError] error to display
-    def display_error(error)
-      logger.kerror("An error occurred: #{error.message}")
-    end
-  end
-end

data/lib/kscript/plugins/kk_top_utils.rb

@@ -1,71 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright (c) 2025 Kk
-#
-# This software is released under the MIT License.
-# https://opensource.org/licenses/MIT
-
-require 'kscript'
-
-module Kscript
-  class KkTopUtils < Base
-    def initialize(*args, **opts)
-      super(*args, **opts)
-    end
-
-    def run
-      with_error_handling do
-        print_report
-      end
-    end
-
-    def print_report
-      logger.kinfo("System Resource Top Report - #{Time.now.strftime('%Y-%m-%d %H:%M:%S')}")
-      print_header('Top 10 Processes by CPU Usage')
-      print_process_list(:cpu)
-      print_header('Top 10 Processes by Memory Usage')
-      print_process_list(:mem)
-    end
-
-    def print_header(title)
-      logger.kinfo('')
-      logger.kinfo('===============================')
-      logger.kinfo(" #{title}")
-      logger.kinfo('===============================')
-    end
-
-    def print_process_list(sort_field)
-      lines = `ps aux`.split("\n")
-      lines.shift
-      processes = lines.map { |line| line.split(/\s+/, 11) }
-      index = sort_field == :cpu ? 2 : 3
-      top = processes.sort_by { |p| -p[index].to_f }.first(10)
-      logger.kinfo(format('%-10s %-8s %-5s %-5s %-10s', 'USER', 'PID', '%CPU', '%MEM', 'COMMAND'))
-      top.each do |p|
-        logger.kinfo(format('%-10s %-8s %-5s %-5s %-10s', p[0], p[1], p[2], p[3], p[10][0..30]))
-      end
-    end
-
-    def self.description
-      'Show top 10 processes by CPU/memory on macOS.'
-    end
-
-    def self.arguments
-      ''
-    end
-
-    def self.usage
-      'kscript top'
-    end
-
-    def self.group
-      'macos'
-    end
-
-    def self.author
-      'kk'
-    end
-  end
-end
-
-Kscript::KkTopUtils.new.run if __FILE__ == $PROGRAM_NAME