feat: add sdkman reference

README.md

@@ -192,6 +192,7 @@ Quick Reference
 [Mitmproxy](./docs/mitmproxy.md)<!--rehype:style=background: rgb(4 92 135);-->  
 [Pacman](./docs/pacman.md)<!--rehype:style=background: rgb(24 147 209);&class=tag&data-lang=archlinux&class=contributing-->  
 [YUM](./docs/yum.md)<!--rehype:style=background: rgb(86 86 123);-->  
+[SDKMAN](./docs/sdkman.md)<!--rehype:style=background: rgb(0 118 198);-->  
 <!--rehype:class=home-card-->
 
 ## 数据库

docs/sdkman.md

@@ -0,0 +1,364 @@
+SDKMAN 备忘清单
+====
+
+SDKMAN是一款管理 java 体系中的各类 SDK 版本的工具，可以用于大多数基于Uinx的系统。它提供了命令行以及API，功能有：安装、移除、列举候选版本。这个快速参考备忘单显示了它的常用命令使用清单
+
+- [SDKMAN 官网](http://sdkman.io)
+
+入门
+---
+
+### 安装
+
+| 安装命令                                  | 环境                                                 |
+| :---------------------------------------- | ---------------------------------------------------- |
+| `curl -s "https://get.sdkman.io" \| bash` | macos/linux                                          |
+| `curl -s "https://get.sdkman.io" \| bash` | windows 需要 (WSL Approach) 或者 (Git Bash Approach) |
+
+- 查看 sdkman 是否安装成功
+
+    ```bash
+    $ sdk version
+    ```
+
+### 获取帮助
+
+您可以通过运行以下命令获得基本帮助：
+
+`$ sdk help`
+
+这将提供一个有用的顶级帮助页面。您可以向该命令添加限定符以获得有关特定子命令的帮助。
+
+`$ sdk help install`
+
+### 安装一个SDK
+
+最新稳定版通过运行以下命令安装您选择的SDK的最新稳定版本（例如Java JDK）：
+
+```shell
+$ sdk install java
+You will see something like the following output:
+
+Downloading: java 21.0.2-tem
+
+In progress...
+
+######################################################################## 100.0%
+
+Installing: java 21.0.2-tem
+Done installing!
+Now you will be prompted if you want this version to be set asdefault.
+
+Do you want java 21.0.2-tem to be set as default? (Y/n):
+Answering yes (or hitting enter) will ensure that all subsequent shells opened will have this version of the SDK in use by default.
+
+Setting java 21.0.2-tem as default.
+```
+
+### 安装特定版本
+
+`$ sdk install scala 3.4.1`
+
+### 安装本地版本
+
+使用快照版本？已经在本地安装了吗？通过指定本地安装的路径来安装本地版本：
+
+`$ sdk install groovy 3.0.0-SNAPSHOT /path/to/groovy-3.0.0-SNAPSHOT`
+
+`$ sdk install java 17-zulu /Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home`
+
+### 删除一个指定版本
+
+`$ sdk uninstall scala 3.4.1`
+
+### 所有可以安装的软件列表
+
+要获得可用 sdk 的列表：
+
+`$ sdk list`
+
+```shell
+================================================================================
+Available Candidates
+================================================================================
+q-quit                                  /-search down
+j-down                                  ?-search up
+k-up                                    h-help
+--------------------------------------------------------------------------------
+...
+--------------------------------------------------------------------------------
+Java (21.0.2-tem)        https://projects.eclipse.org/projects/adoptium.temurin/
+
+Java Platform, Standard Edition (or Java SE) is a widely used platform for
+development and deployment of portable code for desktop and server environments.
+Java SE uses the object-oriented Java programming language. It is part of the
+Java software-platform family. Java SE defines a wide range of general-purpose
+APIs – such as Java APIs for the Java Class Library – and also includes the Java
+Language Specification and the Java Virtual Machine Specification.
+
+$ sdk install java
+--------------------------------------------------------------------------------
+...
+```
+
+### 获取某个 sdk 的版本列表
+
+`$ sdk list groovy`
+
+```shell
+This will result in a list view showing the available, local, installed and current versions of the SDK.
+
+================================================================================
+Available Groovy Versions
+================================================================================
+> * 2.4.4                2.3.1                2.0.8                1.8.3
+2.4.3                2.3.0                2.0.7                1.8.2
+2.4.2                2.2.2                2.0.6                1.8.1
+2.4.1                2.2.1                2.0.5                1.8.0
+2.4.0                2.2.0                2.0.4                1.7.9
+2.3.9                2.1.9                2.0.3                1.7.8
+2.3.8                2.1.8                2.0.2                1.7.7
+2.3.7                2.1.7                2.0.1                1.7.6
+2.3.6                2.1.6                2.0.0                1.7.5
+2.3.5                2.1.5                1.8.9                1.7.4
+2.3.4                2.1.4                1.8.8                1.7.3
+2.3.3                2.1.3                1.8.7                1.7.2
+2.3.2                2.1.2                1.8.6                1.7.11
+2.3.11               2.1.1                1.8.5                1.7.10
+2.3.10               2.1.0                1.8.4                1.7.1
+
+================================================================================
++ - local version
+* - installed
+> - currently in use
+================================================================================
+```
+
+### 使用指定版本
+
+选择在当前终端中使用给定版本：
+
+`$ sdk use scala 3.4.1`
+
+**重要的是要意识到，这将仅切换当前 shell 的 SDK 版本。若要使此更改永久化，请改用默认命令。**
+
+### 设置默认版本
+
+选择将给定版本设为默认版本：
+
+`$ sdk default scala 3.4.1`
+
+这将确保所有后续 shell 将从使用中的版本 3.4.1。
+
+### 查看当前使用的版本
+
+要查 sdk 当前使用的版本：
+
+```shell
+$ sdk current java
+Using java version 21.0.2-tem
+```
+
+要查看所有 sdk 当前使用的版本：
+
+```shell
+$ sdk current
+Using:
+groovy: 4.0.20
+java: 21.0.2-tem
+scala: 3.4.1
+```
+
+### 配置 ENV
+
+想在每次访问项目时切换到特定的 JDK 或 SDK 吗？这可以通过项目基本目录中的 `.sdkmanrc` 文件来实现。可以通过发出以下命令自动生成此文件：
+
+`$ sdk env init`
+
+现在已经在当前目录中创建了一个包含以下内容的配置文件：
+
+```conf
+# Enable auto-env through the sdkman_auto_env config
+
+# Add key=value pairs of SDKs to use below
+
+java=21.0.2-tem
+```
+
+该文件预先填充了当前使用的JDK版本，但可以根据需要包含任意多个支持的SDK的键值对。要切换到 `.sdkmanrc`文件中的配置，只需发出以下命令：
+
+`sdk env`
+
+您应该看到如下输出：
+
+`Using java version 21.0.2-tem in this shell.`
+
+您的路径现在也已更新为在当前 shell 中使用这些 SDK 中的任何一个。离开项目时，您可能需要将SDK重置为默认版本。这可以通过输入：
+
+```shell
+$ sdk env clear
+```
+
+将java版本恢复到21.0.2-tem（默认）签出新项目后，您可能缺少在项目的 `.sdkmanrc` 文件中指定的一些SDK。要安装这些丢失的SDK，只需键入：
+
+```shell
+$ sdk env install
+
+Downloading: java 21.0.2-tem
+
+In progress...
+
+######################################################################## 100,0%
+
+Repackaging Java 21.0.2-tem...
+
+Done repackaging...
+
+Installing: java 21.0.2-tem
+Done installing!
+```
+
+您想在 cd 到目录中时自动切换 SDK 版本吗？这可以通过在 sdkman 配置中设置 `sdkman_auto_env=true` 来实现。请注意，这也会在离开目录时将任何特定于项目的SDK重置为默认版本。
+
+### 升级版本
+
+要查看您系统中 SDK 当前过期的内容：
+
+```shell
+$ sdk upgrade springboot
+Upgrade:
+springboot (1.2.4.RELEASE, 1.2.3.RELEASE < 3.2.4)
+```
+
+要查看所有 SDK 的过时内容：
+
+```shell
+$ sdk upgrade
+Upgrade:
+gradle (2.3, 1.11, 2.4, 2.5 < 8.7)
+grails (2.5.1 < 6.1.1)
+springboot (1.2.4.RELEASE, 1.2.3.RELEASE < 3.2.4
+```
+
+### SDKMAN 版本
+
+```shell
+$ sdk version
+
+SDKMAN!
+script: 5.7.0
+native: 0.1.3
+```
+
+### 离线模式
+
+最初被称为飞行模式，这允许SDKMAN！以在脱机工作时发挥作用。它有一个参数，可以传递给启用或禁用脱机模式。
+
+```shell
+$ sdk offline enable
+Forced offline mode enabled.
+
+$ sdk offline disable
+
+Online mode re-enabled
+```
+
+在离线模式下操作时，大多数命令仍然可以工作，即使它们将以缩小的容量操作。例如list命令，它将只显示当前安装的和活动的版本：
+
+```shell
+$ sdk list groovy
+------------------------------------------------------------
+
+Offline Mode: only showing installed groovy versions
+------------------------------------------------------------
+>
+> 2.4.4
+
+- 2.4.3
+
+------------------------------------------------------------
+
+- - installed
+>
+> - currently in use
+>
+------------------------------------------------------------
+```
+
+当互联网可用/不可用时，离线模式也将自动禁用/启用。当然，需要互联网连接的命令不会起作用，但会发出警告。
+
+### 自动更新
+
+安装新版本的SDKMAN！如果可用。
+
+`$ sdk selfupdate`
+
+如果没有可用的新版本，将显示相应的消息。可以通过将force参数传递给命令来强制重新安装：
+
+`$ sdk selfupdate force`
+
+自动每日检查新版本的SDKMAN！也将代表用户执行。
+
+### 更新
+
+定期更新 SDKMAN！需要更新以了解新的（或已删除的）SDK。当 SDK 元数据可能变得过时时，会显示一条警告，并说明如何更新。只需运行以下命令，就可以刷新 SDK 缓存，并且可以安装新的 SDK 缓存：
+
+```shell
+WARNING: SDKMAN is out-of-date and requires an update.
+
+$ sdk update
+Adding new candidates(s): kotlin
+```
+
+### Flush
+
+应该很少需要刷新 SDKMAN！。flush命令有助于实现这一点，因此您不需要删除任何目录。
+手动删除像 .sdkman/tmp 目录这样的目录会破坏 sdkman！请始终使用 flush 命令！
+
+`$ sdk flush`
+
+### Home
+
+在脚本中使用 SDKMAN 时，获取SDK所在位置的绝对路径通常很有用（类似于 java_home 命令在 macOS 上的工作方式）。为此，我们拥有设置权限。
+
+```shell
+$ sdk home java 21.0.2-tem
+/home/myuser/.sdkman/candidates/java/21.0.2-tem
+```
+
+### Configuration
+
+可以在 ~/.sdkman/etc/config 文件中找到配置。要编辑配置，可以发出 sdk-config 命令在系统编辑器中编辑此文件。以下配置可用：
+
+```conf
+# make sdkman non-interactive, preferred for CI environments
+sdkman_auto_answer=true|false
+
+# check for newer versions and prompt for update
+sdkman_selfupdate_feature=true|false
+
+# disables SSL certificate verification
+# https://github.com/sdkman/sdkman-cli/issues/327
+# HERE BE DRAGONS....
+sdkman_insecure_ssl=true|false
+
+# configure curl timeouts
+sdkman_curl_connect_timeout=5
+sdkman_curl_continue=true
+sdkman_curl_max_time=10
+
+# subscribe to the beta channel
+sdkman_beta_channel=true|false
+
+# enable verbose debugging
+sdkman_debug_mode=true|false
+
+# enable colour mode
+sdkman_colour_enable=true|false
+
+# enable automatic env
+sdkman_auto_env=true|false
+
+# enable bash or zsh auto-completion
+sdkman_auto_complete=true|false
+```