feat(completion): add bash and zsh completions

Author: wnlen

install.sh

@@ -30,6 +30,7 @@ mark_install_plan || true
 mark_install_port_plan || true
 
 install_clashctl_entry
+install_clashctl_completion
 install_shell_alias_entry
 install_runtime_entry
 install_local_dashboard_assets

scripts/core/clashctl.sh

@@ -7,6 +7,7 @@ PROJECT_DIR="$(cd "$(dirname "$SCRIPT_PATH")/../.." && pwd)"
 source "$PROJECT_DIR/scripts/core/common.sh"
 source "$PROJECT_DIR/scripts/core/runtime.sh"
 source "$PROJECT_DIR/scripts/core/config.sh"
+source "$PROJECT_DIR/scripts/core/completion.sh"
 source "$PROJECT_DIR/scripts/core/proxy.sh"
 source "$PROJECT_DIR/scripts/core/update.sh"
 source "$PROJECT_DIR/scripts/init/systemd.sh"
@@ -42,6 +43,7 @@ Usage:
   status                         🔍️ 查看状态总览
   boot                           🚦 管理开机代理接管
   log/logs                       📜 查看日志
+  completion                     💡 导出 Bash / Zsh 补全脚本
 
 💡 更多高级能力：clashctl help advanced
 EOF
@@ -71,6 +73,7 @@ usage_advanced() {
   boot proxy on|off|status           📜 仅管理开机代理保持
   upgrade                        🚀 升级当前或指定内核
   update                         🔄 更新项目代码
+  completion bash|zsh            💡 导出 Shell 补全脚本
   dev reset                      🧪 恢复到安装前状态（保留项目目录和已下载文件）
 
 📌 Advanced Examples:
@@ -2976,6 +2979,7 @@ cmd_ui_help_summary() {
   printf '  %-18s %s\n' "clashctl sub" "🧩 订阅高级管理（启用 / 禁用 / 重命名 / 删除）"
   printf '  %-18s %s\n' "clashctl upgrade" "🚀 升级当前或指定内核"
   printf '  %-18s %s\n' "clashctl update" "🔄 更新项目代码"
+  printf '  %-18s %s\n' "clashctl completion" "💡 导出 Bash / Zsh 补全脚本"
   echo "📜 日志"
   printf '  %-18s %s\n' "clashctl doctor" "🩺 诊断面板"
   printf '  %-18s %s\n' "clashctl log/logs" "📜 查看日志"
@@ -7275,6 +7279,7 @@ case "$cmd" in
   proxy)          cmd_proxy "$@" ;;
   upgrade)        cmd_upgrade "$@" ;;
   update)         cmd_update "$@" ;;
+  completion)     cmd_completion "$@" ;;
   start-direct)   cmd_start_direct "$@" ;;
   stop-direct)    cmd_stop_direct "$@" ;;
   restart-direct) cmd_restart_direct "$@" ;;

scripts/core/common.sh

@@ -2307,6 +2307,30 @@ alias_source_file() {
   echo "$PROJECT_DIR/scripts/core/alias.sh"
 }
 
+completion_dir() {
+  if [ "$INSTALL_SCOPE" = "system" ]; then
+    echo "/etc/profile.d"
+  else
+    echo "$HOME/.config/clash-for-linux"
+  fi
+}
+
+bash_completion_entry_file() {
+  if [ "$INSTALL_SCOPE" = "system" ]; then
+    echo "$(completion_dir)/clash-for-linux-completion.bash"
+  else
+    echo "$(completion_dir)/completion.bash"
+  fi
+}
+
+zsh_completion_entry_file() {
+  if [ "$INSTALL_SCOPE" = "system" ]; then
+    echo "$(completion_dir)/clash-for-linux-completion.zsh"
+  else
+    echo "$(completion_dir)/completion.zsh"
+  fi
+}
+
 clashctl_entry_target() {
   echo "$(command_install_dir)/clashctl"
 }
@@ -2411,12 +2435,14 @@ cleanup_legacy_shell_entries() {
 }
 
 install_shell_alias_entry() {
-  local profile_file alias_file shell_rc
+  local profile_file alias_file shell_rc bash_completion_file zsh_completion_file
 
   cleanup_legacy_shell_entries
 
   profile_file="$(profile_entry_file)"
   alias_file="$(alias_source_file)"
+  bash_completion_file="$(bash_completion_entry_file)"
+  zsh_completion_file="$(zsh_completion_entry_file)"
 
   mkdir -p "$(dirname "$profile_file")"
   [ -f "$alias_file" ] || die "未找到 alias 脚本：$alias_file"
@@ -2430,6 +2456,18 @@ if [ -n "\${BASH_VERSION:-}" ] && [ -z "\${CLASH_FOR_LINUX_SHELL_LOADED:-}" ]; t
   export CLASH_FOR_LINUX_SHELL_LOADED="1"
   source "$alias_file"
 fi
+
+case "\$-" in
+  *i*)
+    if [ -n "\${BASH_VERSION:-}" ] && [ -z "\${CLASH_FOR_LINUX_BASH_COMPLETION_LOADED:-}" ] && [ -f "$bash_completion_file" ]; then
+      export CLASH_FOR_LINUX_BASH_COMPLETION_LOADED="1"
+      source "$bash_completion_file"
+    elif [ -n "\${ZSH_VERSION:-}" ] && [ -z "\${CLASH_FOR_LINUX_ZSH_COMPLETION_LOADED:-}" ] && [ -f "$zsh_completion_file" ]; then
+      export CLASH_FOR_LINUX_ZSH_COMPLETION_LOADED="1"
+      source "$zsh_completion_file"
+    fi
+    ;;
+esac
 EOF
   chmod +x "$profile_file"
 
@@ -2440,6 +2478,21 @@ EOF
   install_alias_command_wrappers
 }
 
+install_clashctl_completion() {
+  local bash_target zsh_target
+
+  bash_target="$(bash_completion_entry_file)"
+  zsh_target="$(zsh_completion_entry_file)"
+
+  mkdir -p "$(dirname "$bash_target")"
+  mkdir -p "$(dirname "$zsh_target")"
+
+  bash "$PROJECT_DIR/scripts/core/clashctl.sh" completion bash > "$bash_target"
+  bash "$PROJECT_DIR/scripts/core/clashctl.sh" completion zsh > "$zsh_target"
+
+  chmod +x "$bash_target" "$zsh_target" 2>/dev/null || true
+}
+
 remove_clashctl_entry() {
   rm -f "$(clashctl_entry_target)" "$(clashctl_bin_entry_target)" 2>/dev/null || true
   remove_alias_command_wrappers
@@ -2461,6 +2514,10 @@ remove_shell_alias_entry() {
   fi
 }
 
+remove_clashctl_completion() {
+  rm -f "$(bash_completion_entry_file)" "$(zsh_completion_entry_file)" 2>/dev/null || true
+}
+
 install_has_subscription() {
   [ -n "$(subscription_url 2>/dev/null || true)" ]
 }