kscript 1.0.7 → 1.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c903c89ab57a0f91270b2b320b60981ba56ba5d6e4bb4096eb6bd26ab7b5a61
-  data.tar.gz: 17a2a9d64078442493704bb60065bcc14a4b5728dcf1b7caf2440f0ce80c0008
+  metadata.gz: 587c4a1f08230cd5085bace44a9fbb4035f52a62a4f1fdb35e00fb5ef4e52567
+  data.tar.gz: efb3539204a0b0dddb0a8a375a6d58574d668b96bdef01dacd0d1e394f309542
 SHA512:
-  metadata.gz: f27cd8c019f492bd37359c01e0ca710ecc3ec99818b795efc3fd7a688ff4b06b47892421e01c7ceda79066c44184f60d86cfa07ed0c79df9db97dc367cb358cb
-  data.tar.gz: e83ee610a5684dea38c12a68933e23224dee8b2654e9c689ed81ae57e4ee6c7f52620fec51347d6b1f9288075b10e1a42fa041ae8a8c4c4c61614e04ce8dfc51
+  metadata.gz: 54c44443112073b48dda6b9d4c7f9707ab99b94b8fb5e4a04c1320cdcd1becaacd34c81c452d21bd84bc20be797900e05fed004d07e5423c7081e49a96379b66
+  data.tar.gz: c155b0a6eb3c047c73e5b90c0c6353aaff99e47eab12acdab905cfa287090475ff35c681d95674a92b85268f886ad4351e0ce58209d0b00f727e696d3ff4ffe3

data/README.md

@@ -140,7 +140,6 @@ AWS_SECRET_ACCESS_KEY=yyy
 KSCRIPT_LOG_LEVEL=info
 LOG=1
 ```
-
 ---
 
 ## 🧑‍💻 插件开发规范
@@ -185,3 +184,4 @@ MIT License. 详见 [LICENSE](LICENSE)。
 
 如需更多示例、插件开发指导或遇到问题，欢迎提 issue 或 PR！
 
+

data/lib/kscript/base.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require 'kscript'
+require_relative '../kscript'
 
 module Kscript
   # Base class for all kscript scripts

data/lib/{completions → kscript/completions}/kscript.bash

@@ -8,7 +8,7 @@ _kscript_completions() {
 
     # Main command list as array
     local opts=(
-        version help list apnic cleaner es_fingerprint ffmpeg ip jenkins kibana lvm optimize portscan projscan rename sh syscheck top usd wg_acl wg_pass
+        apnic_ip aws_s3 cursor_rules elastic_cert_finger ffmpeg_install file_rename ip_lookup jenkins_manage kibana_manage lvm_manage mac_optimize mac_status port_scan project_scan shell_helper usd_rate vcs_cleaner wg_acl wg_pass
     )
 
     if [[ ${COMP_CWORD} == 1 ]]; then

data/lib/kscript/completions/kscript.zsh

@@ -0,0 +1,27 @@
+#compdef kscript
+_kscript() {
+  local -a commands
+  commands=(
+    'apnic_ip:kscript command'
+    'aws_s3:kscript command'
+    'cursor_rules:kscript command'
+    'elastic_cert_finger:kscript command'
+    'ffmpeg_install:kscript command'
+    'file_rename:kscript command'
+    'ip_lookup:kscript command'
+    'jenkins_manage:kscript command'
+    'kibana_manage:kscript command'
+    'lvm_manage:kscript command'
+    'mac_optimize:kscript command'
+    'mac_status:kscript command'
+    'port_scan:kscript command'
+    'project_scan:kscript command'
+    'shell_helper:kscript command'
+    'usd_rate:kscript command'
+    'vcs_cleaner:kscript command'
+    'wg_acl:kscript command'
+    'wg_pass:kscript command'
+  )
+  _describe 'command' commands
+}
+compdef _kscript kscript

data/lib/kscript/plugins/kk_apnic_ip_utils.rb

@@ -5,10 +5,10 @@
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT
 
-require 'kscript'
+# require 'kscript' # 移除此行
 
 module Kscript
-  class KkApnicIpUtils < Base
+  class KkApnicIpUtils < Kscript::Base
     attr_reader :country_sn, :cache_file
 
     # Initialize class instance, set country code and cache file path
@@ -21,16 +21,20 @@ module Kscript
     # Download data from APNIC or read from cache
     def download_data
       if File.exist?(cache_file) && File.size?(cache_file)
-        logger.kinfo("Using cached data from #{cache_file}")
-      else
-        url = 'https://ftp.apnic.net/stats/apnic/delegated-apnic-latest'
-        response = HTTP.get(url)
-
-        raise "Failed to download the APNIC data. HTTP Status: #{response.status}" unless response.status.success?
-
-        File.write(cache_file, response.body.to_s)
-        logger.kinfo("Data downloaded and saved to #{cache_file}")
+        mtime = File.mtime(cache_file)
+        if Time.now - mtime < 86_400
+          logger.kinfo("Using cached data from #{cache_file} (updated #{mtime})")
+          return
+        else
+          logger.kinfo("Cache expired (last updated #{mtime}), downloading new data...")
+        end
       end
+      url = 'https://ftp.apnic.net/stats/apnic/delegated-apnic-latest'
+      response = HTTP.get(url)
+      raise "Failed to download the APNIC data. HTTP Status: #{response.status}" unless response.status.success?
+
+      File.write(cache_file, response.body.to_s)
+      logger.kinfo("Data downloaded and saved to #{cache_file}")
     end
 
     # Parse data and return IPv4 address ranges (CIDR format) for specified country
@@ -58,8 +62,9 @@ module Kscript
       32 - Math.log2(hosts).to_i
     end
 
-    def run
+    def run(*args, **_opts)
       with_error_handling do
+        @country_sn = args[0] if args[0]
         parse_ip_ranges
       end
     end

data/lib/kscript/plugins/kk_aws_s3_utils.rb

@@ -5,7 +5,7 @@
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT
 
-require 'kscript'
+# require 'kscript'
 
 # AWS S3 文件上传测试工具
 # 用法示例：
@@ -14,7 +14,7 @@ require 'kscript'
 # 依赖：aws-sdk-s3（已在主入口 require）
 
 module Kscript
-  class KkAwsS3Utils < Base
+  class KkAwsS3Utils < Kscript::Base
     # 初始化，支持所有参数通过 CLI 传递
     def initialize(*args, **opts)
       super

data/lib/kscript/plugins/kk_cursor_rules_utils.rb

@@ -0,0 +1,113 @@
+# 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 KkCursorRulesUtils < Kscript::Base
+    def initialize(*_args, **opts)
+      super(**opts.merge(service: 'kk_cursor_rules'))
+    end
+
+    def run(*args, **_opts)
+      with_error_handling do
+        if args[0].to_s == 'deploy'
+          deploy
+        else
+          logger.kwarn("Usage: #{self.class.usage}")
+        end
+      end
+    end
+
+    def deploy
+      logger.kinfo('======= 🚀 Cursor Rules Deploy =======')
+      logger.kinfo("📅 Date Time: #{Time.now}")
+      logger.kinfo('')
+
+      # Remove .cursor if exists
+      if Dir.exist?('.cursor')
+        logger.kinfo('Removing existing .cursor directory...')
+        FileUtils.rm_rf('.cursor')
+      end
+
+      # Clone .cursor repo
+      logger.kinfo('Cloning .cursor repo from github...')
+      system_or_raise('git clone git@github.com:kevin197011/cursor.git .cursor')
+
+      # Move Rakefile if not exists, else remove .cursor/Rakefile
+      if !File.exist?('Rakefile') && File.exist?('.cursor/Rakefile')
+        logger.kinfo('Moving .cursor/Rakefile to project root...')
+        FileUtils.mv('.cursor/Rakefile', 'Rakefile')
+      elsif File.exist?('.cursor/Rakefile')
+        logger.kinfo('Removing .cursor/Rakefile (already present in root)...')
+        FileUtils.rm_rf('.cursor/Rakefile')
+      end
+
+      # Move push.rb
+      if File.exist?('.cursor/push.rb')
+        logger.kinfo('Moving .cursor/push.rb to project root...')
+        FileUtils.mv('.cursor/push.rb', 'push.rb')
+      end
+
+      # Move .rubocop.yml
+      if File.exist?('.cursor/.rubocop.yml')
+        logger.kinfo('Moving .cursor/.rubocop.yml to project root...')
+        FileUtils.mv('.cursor/.rubocop.yml', '.rubocop.yml')
+      end
+
+      # Remove .cursor/.git if exists
+      if File.exist?('.cursor/.git')
+        logger.kinfo('Removing .cursor/.git directory...')
+        FileUtils.rm_rf('.cursor/.git')
+      end
+
+      # Ensure .gitignore contains .cursor
+      if File.exist?('.gitignore') && File.readlines('.gitignore').none? { |l| l.strip == '.cursor' }
+        logger.kinfo('Adding .cursor to .gitignore...')
+        File.open('.gitignore', 'a') { |f| f.puts '\n.cursor' }
+      end
+
+      logger.kinfo("\n✅ Cursor rules deploy completed!")
+    end
+
+    private
+
+    def system_or_raise(cmd)
+      logger.kinfo("Running: #{cmd}")
+      success = system(cmd)
+      raise "Command failed: #{cmd}" unless success
+    end
+
+    def with_error_handling
+      yield
+    rescue StandardError => e
+      logger.kerror("[ERROR] #{e.class}: #{e.message}")
+      exit(1)
+    end
+
+    # ==== CLI/Plugin Metadata ====
+    def self.description
+      'Cursor rules deploy helper: syncs .cursor repo and project rules.'
+    end
+
+    def self.arguments
+      '[deploy]'
+    end
+
+    def self.usage
+      'kscript cursor_rules deploy'
+    end
+
+    def self.group
+      'devops'
+    end
+
+    def self.author
+      'kk'
+    end
+  end
+end

data/lib/kscript/plugins/kk_elastic_cert_finger_utils.rb

@@ -5,10 +5,10 @@
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT
 
-require 'kscript'
+# require 'kscript'
 
 module Kscript
-  class KkElasticCertFingerUtils < Base
+  class KkElasticCertFingerUtils < Kscript::Base
     DEFAULT_CERT_PATH = 'elasticsearch.crt'
 
     attr_reader :cert_path

data/lib/kscript/plugins/kk_ffmpeg_install_utils.rb

@@ -5,10 +5,10 @@
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT
 
-require 'kscript'
+# require 'kscript'
 
 module Kscript
-  class KkFfmpegInstallUtils < Base
+  class KkFfmpegInstallUtils < Kscript::Base
     def initialize(*args, **opts)
       super
     end

data/lib/kscript/plugins/kk_file_rename_utils.rb

@@ -5,10 +5,10 @@
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT
 
-require 'kscript'
+# require 'kscript'
 
 module Kscript
-  class KkFileRenameUtils < Base
+  class KkFileRenameUtils < Kscript::Base
     attr_reader :source_pattern, :target_pattern, :directory
 
     def initialize(*args, **opts)

data/lib/kscript/plugins/kk_ip_lookup_utils.rb

@@ -5,10 +5,10 @@
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT
 
-require 'kscript'
+# require 'kscript'
 
 module Kscript
-  class KkIpLookupUtils < Base
+  class KkIpLookupUtils < Kscript::Base
     IP_API_BASE_URL = 'http://ip-api.com/json'
     IP_CHECK_URL = 'https://api.ipify.org?format=json'
 

data/lib/kscript/plugins/kk_jenkins_manage_utils.rb

@@ -5,10 +5,10 @@
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT
 
-require 'kscript'
+# require 'kscript'
 
 module Kscript
-  class KkJenkinsManageUtils < Base
+  class KkJenkinsManageUtils < Kscript::Base
     def initialize(*args, **opts)
       super
       jenkins_url, user, password = args

data/lib/kscript/plugins/kk_kibana_manage_utils.rb

@@ -5,10 +5,10 @@
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT
 
-require 'kscript'
+# require 'kscript'
 
 module Kscript
-  class KkKibanaManageUtils < Base
+  class KkKibanaManageUtils < Kscript::Base
     def initialize(*args, **opts)
       super
       project_name, project_env, base_url, username, password = args

data/lib/kscript/plugins/kk_lvm_manage_utils.rb

@@ -5,10 +5,10 @@
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT
 
-require 'kscript'
+# require 'kscript'
 
 module Kscript
-  class KkLvmManageUtils < Base
+  class KkLvmManageUtils < Kscript::Base
     DEFAULT_CONFIG = {
       device: '/dev/sdb',
       volume_group: 'vg_data',

data/lib/kscript/plugins/kk_mac_optimize_utils.rb

@@ -5,10 +5,10 @@
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT
 
-require 'kscript'
+# require 'kscript'
 
 module Kscript
-  class KkMacOptimizeUtils < Base
+  class KkMacOptimizeUtils < Kscript::Base
     def initialize(*args, **opts)
       super
     end

data/lib/kscript/plugins/kk_mac_status_utils.rb

@@ -5,10 +5,10 @@
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT
 
-require 'kscript'
+# require 'kscript'
 
 module Kscript
-  class KkMacStatusUtils < Base
+  class KkMacStatusUtils < Kscript::Base
     def initialize(*_args, **opts)
       super(**opts.merge(service: 'kk_mac_status'))
     end

data/lib/kscript/plugins/kk_port_scan_utils.rb

@@ -5,10 +5,10 @@
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT
 
-require 'kscript'
+# require 'kscript'
 
 module Kscript
-  class KkPortScanUtils < Base
+  class KkPortScanUtils < Kscript::Base
     attr_reader :host, :ports, :thread_count
 
     # Initialize the scanner with target host and port range
@@ -22,8 +22,12 @@ module Kscript
       @thread_count = (opts[:thread_count] || 50).to_i
     end
 
-    def run
+    def run(*args, **_opts)
       with_error_handling do
+        # 支持命令行参数覆盖
+        @target = args[0] if args[0]
+        @ports = parse_ports(args[1]) if args[1]
+        @thread_count = args[2].to_i if args[2]
         scan
       end
     end
@@ -31,11 +35,7 @@ module Kscript
     # Execute port scanning using multiple threads
     def scan
       msg = "Scanning #{@target} ports #{@ports} with concurrency=#{@thread_count}"
-      if human_output?
-        puts msg
-      else
-        logger.kinfo(msg)
-      end
+      logger.kinfo(msg)
       queue = Queue.new
       @ports.each { |port| queue << port }
       threads = []
@@ -50,12 +50,7 @@ module Kscript
             end
             begin
               Socket.tcp(@target, port, connect_timeout: 0.5) do |_sock|
-                if human_output?
-                  puts "Port #{port} is open"
-                else
-                  logger.kinfo('Port open', port: port)
-                  logger.kinfo("Port #{port} is open")
-                end
+                logger.kinfo('Port open', port: port)
               end
             rescue Errno::ECONNREFUSED, Errno::ETIMEDOUT, SocketError
               # closed or filtered

data/lib/kscript/plugins/kk_project_scan_utils.rb

@@ -5,10 +5,10 @@
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT
 
-require 'kscript'
+# require 'kscript'
 
 module Kscript
-  class KkProjectScanUtils < Base
+  class KkProjectScanUtils < Kscript::Base
     def initialize(*args, **opts)
       super
     end
@@ -58,7 +58,8 @@ module Kscript
       projects = []
       Dir.glob(File.join(@src_path, '*')).each do |path|
         next unless File.directory?(path)
-        next unless git_project?(path)
+
+        # next unless git_project?(path)
 
         project_name = File.basename(path)
         projects << create_project_entry(project_name, path)

data/lib/kscript/plugins/kk_shell_helper_utils.rb

@@ -5,10 +5,10 @@
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT
 
-require 'kscript'
+# require 'kscript'
 
 module Kscript
-  class KkShellHelperUtils < Base
+  class KkShellHelperUtils < Kscript::Base
     CHT_SH_URL = 'https://cht.sh'
 
     attr_reader :command
@@ -44,7 +44,7 @@ module Kscript
     def fetch_help(command)
       response = make_request(command)
       response = response.first if response.is_a?(Array)
-      puts response.body
+      logger.kinfo(response.body)
     rescue StandardError => e
       display_error(e)
     end

data/lib/kscript/plugins/kk_usd_rate_utils.rb

@@ -5,13 +5,11 @@
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT
 
-require 'kscript'
-
 require 'net/http'
 require 'json'
 
 module Kscript
-  class KkUsdRateUtils < Base
+  class KkUsdRateUtils < Kscript::Base
     API_URL = 'https://api.exchangerate-api.com/v4/latest/USD'
 
     def initialize(currency_code = 'CNY', *args, **opts)

data/lib/kscript/plugins/kk_vcs_cleaner_utils.rb

@@ -5,10 +5,10 @@
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT
 
-require 'kscript'
+# require 'kscript'
 
 module Kscript
-  class KkVcsCleanerUtils < Base
+  class KkVcsCleanerUtils < Kscript::Base
     DEFAULT_RETAIN_VERSIONS = 10
 
     attr_reader :source_path, :retain_count
@@ -64,7 +64,7 @@ module Kscript
       version_count = versions.length
       return if version_count <= @retain_count
 
-      logger.info("Processing #{app_path}", version_count: version_count, retain: @retain_count)
+      logger.kinfo("Processing #{app_path}", version_count: version_count, retain: @retain_count)
       cleanup_old_versions(versions, version_count)
     end
 

data/lib/kscript/plugins/kk_wg_acl_utils.rb

@@ -5,10 +5,10 @@
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT
 
-require 'kscript'
+# require 'kscript'
 
 module Kscript
-  class KkWgAclUtils < Base
+  class KkWgAclUtils < Kscript::Base
     WIREGUARD_PORT = 51_821
     ALLOWED_IPS = %w[127.0.0.1].freeze
 

data/lib/kscript/plugins/kk_wg_pass_utils.rb

@@ -5,10 +5,10 @@
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT
 
-require 'kscript'
+# require 'kscript'
 
 module Kscript
-  class KkWgPassUtils < Base
+  class KkWgPassUtils < Kscript::Base
     def initialize(*args, **opts)
       super
     end

data/lib/kscript/version.rb

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

data/lib/kscript.rb

@@ -27,12 +27,11 @@ require 'thor'
 require 'aws-sdk-s3'
 require 'dotenv'
 
-require 'kscript/config'
-require 'kscript/plugins'
-require 'kscript/base'
-require 'kscript/logger'
-require 'kscript/utils'
-require 'kscript/version'
+require_relative 'kscript/config'
+require_relative 'kscript/base'
+require_relative 'kscript/plugins'
+require_relative 'kscript/logger'
+require_relative 'kscript/version'
 
 module Kscript
   # fluentd 风格插件注册机制

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kscript
 version: !ruby/object:Gem::Version
-  version: 1.0.7
+  version: 1.0.9
 platform: ruby
 authors:
 - Kk
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-07-10 00:00:00.000000000 Z
+date: 2025-07-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-s3
@@ -147,17 +147,18 @@ files:
 - README.md
 - exe/kscript
 - ext/mkrf_conf.rb
-- lib/completions/kscript.bash
-- lib/completions/kscript.zsh
 - lib/kscript.rb
 - lib/kscript/banner.rb
 - lib/kscript/base.rb
 - lib/kscript/cli.rb
+- lib/kscript/completions/kscript.bash
+- lib/kscript/completions/kscript.zsh
 - lib/kscript/config.rb
 - lib/kscript/logger.rb
 - lib/kscript/plugins.rb
 - lib/kscript/plugins/kk_apnic_ip_utils.rb
 - lib/kscript/plugins/kk_aws_s3_utils.rb
+- lib/kscript/plugins/kk_cursor_rules_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
@@ -175,7 +176,6 @@ files:
 - lib/kscript/plugins/kk_wg_acl_utils.rb
 - lib/kscript/plugins/kk_wg_pass_utils.rb
 - lib/kscript/post_install.rb
-- lib/kscript/utils.rb
 - lib/kscript/version.rb
 homepage: https://github.com/kevin197011/kscript
 licenses:

data/lib/completions/kscript.zsh

@@ -1,29 +0,0 @@
-#compdef kscript
-_kscript() {
-  local -a commands
-  commands=(
-    'version:kscript command'
-    'help:kscript command'
-    'list:kscript command'
-    'apnic:kscript command'
-    'cleaner:kscript command'
-    'es_fingerprint:kscript command'
-    'ffmpeg:kscript command'
-    'ip:kscript command'
-    'jenkins:kscript command'
-    'kibana:kscript command'
-    'lvm:kscript command'
-    'optimize:kscript command'
-    'portscan:kscript command'
-    'projscan:kscript command'
-    'rename:kscript command'
-    'sh:kscript command'
-    'syscheck:kscript command'
-    'top:kscript command'
-    'usd:kscript command'
-    'wg_acl:kscript command'
-    'wg_pass:kscript command'
-  )
-  _describe 'command' commands
-}
-compdef _kscript kscript

data/lib/kscript/utils.rb

@@ -1 +0,0 @@
-# frozen_string_literal: true