一键式安装(推荐)

One-click Installation

通过以下命令可以快速安装GCR插件：

Use the following command to quickly install the GCR plugin:

curl -s https://raw.githubusercontent.com/gaojunbin/GCR/master/install_gcr.sh -o ~/install_gcr.sh && bash ~/install_gcr.sh && rm ~/install_gcr.sh

curl -s https://raw.githubusercontent.com/gaojunbin/GCR/master/install_gcr.sh -o ~/install_gcr.sh && bash ~/install_gcr.sh && rm ~/install_gcr.sh

您可以按照屏幕提示根据您使用的操作系统和用户权限选择对应的安装方式。

You can follow the on-screen prompts to select the corresponding installation method based on your operating system and user permissions.

目前一键安装支持的操作系统有：Ubuntu, MacOS, NUS HPC, NUS Medicine HPC, NSCC Singapore. 理论上一切支持zsh的操作系统（目前市面上大多数操作系统应该都支持）均可以支持GCR，但是部分操作系统安装zsh的方式略有不同，且某些安装方式需要root权限，不同权限的用户安装方式也会略有不同。 一键脚本在未来会尽可能支持更多操作系统，若在安装过程中遇到问题，可先自行安装zsh，并设置zsh为默认shell，然后再按照脚本内容自行安装GCR即可。

The operating systems currently supported by one-click installation include: Ubuntu, Mac OS, NUS HPC, NUS Medicine HPC, NSCC Singapore. In theory, all operating systems that support zsh (most operating systems currently on the market should support it) can support GCR. However, some operating systems have slightly different ways of installing zsh, and some installation methods require root permissions. The installation methods of users with different permissions will also be slightly different. The one-click script will support as many operating systems as possible in the future. If you encounter problems during the installation process, you can first install zsh yourself, set zsh as the default shell, and then install GCR yourself according to the script content.

由于windows与类unix操作系统底层命令差异较大，短期内不考虑支持。

Since the underlying commands of Windows and Unix-like operating systems are quite different, support will not be considered in the short term.

若您原先较为依赖bashrc / bash_profile的配置，请自行移植需要的配置到zshrc。 继续阅读分步安装有助于你更好的理解如何移植。

If you originally relied on bashrc bash_profile configuration, please transplant the required configuration to zshrc yourself. Continue reading for a step-by-step installation to help you better understand how to migrate.

分步手动安装

Step-by-step Manual Installation

如果您想手动安装，请按以下步骤操作：

If you prefer to install manually, please follow these steps:

1. 下载GCR插件代码

git clone https://github.com/gaojunbin/GCR.git

复制
2. 自行安装zsh

sudo apt-get install zsh # Ubuntu
sudo yum install zsh # CentOS
brew install zsh # MacOS (Homebrew)
                    

MacOS市面上大多数系统已经默认预装zsh且作为预设shell (MAC YYDS)， 若需要升级zsh版本，可通过Homebrew包管理器，由于MAC经历了x86到arm架构的变化，Homebrew的安装也有细微的改变，官方目前有较为完整的解决方案，可参考Homebrew官网。安装完毕后即可使用Homebrew安装/更新zsh，请注意环境路径，使得系统zsh可以找到并使用你预期路径下的zsh。

对于其他操作系统，如果是服务器端无法使用一键脚本成功安装，请先确认服务器是否预安装了较新版zsh（部分较老版本的ubuntu等系统预装zsh太旧无法支持完整功能），若需要重新安装zsh，可按照对应系统自行安装。请注意，默认情况下安装zsh需要root权限，如果你所使用的账号没有root权限，你可以从zsh官方下载源代码并自行编译安装（一键脚本中HPC， NSCC等就是采用了这样的解决方案），但是自行编译安装会因为操作系统等因素遇到各种不一样的问题，请关注官方仓库寻求解决方案。oh-my-zsh提供了一些安装指导，供参考。

3. 安装GCR

GCR基于开源工具oh-my-zsh,但是修改了部分内容，如果您之前已经在使用oh-my-zsh，请先卸载oh-my-zsh并清理原始文件，防止与GCR冲突。

1) 检查GCR下载的目录以及$HOME下是否有足够的磁盘空间 （GCR不需要很大的空间，但请留出>5GB存储防止意外）

2) 检查zsh是否正常安装以及版本是否较新 (> 5.0)

zsh --version

复制

3) 设置zsh默认shell (有root权限)

sudo chsh -s $(which zsh) $(whoami) # 如果你有root权限

复制

3') 设置zsh默认shell (没有root权限)

# 添加下面的代码到你的默认shell配置下，以bash为例，你可以添加到～/.bashrc或者~/.bash_profile下, $path/to/zsh是你zsh安装的路径

[ -f $path/to/zsh ] && exec $path/to/zsh -l

复制

4) 进入GCR文件夹并拷贝GCR依赖文件

cp .ohmyshell ~/
cp .ohmytool ~/
cp .ohmyzsh ~/
cp .p9k.zsh ~/
cp .ohmyprint ~/
cp -r oh-my-zsh ~/.oh-my-zsh

复制

5) 生成GCR配置文件 .zshrc 到$HOME目录下

SHOW_GCR_INFO=false
CHECK_GCR_UPDATE=true
source ~/.ohmyzsh
source ~/.p9k.zsh
source ~/.ohmyshell

复制

6) 迁移原shell中有用的部分

迁移原shell中有用的部分到新的文件，并在.zshrc中source该文件，也可以直接迁移到.zshrc中，但是建议不要直接写在主文件中

7) 至此，你的GCR安装完毕！

1. Download the GCR code

git clone https://github.com/gaojunbin/GCR.git

copy
2. Install zsh yourself

sudo apt-get install zsh # Ubuntu
sudo yum install zsh # CentOS
brew install zsh # MacOS (Homebrew)
                    

Most systems on the MacOS market have zsh pre-installed as a default shell (MAC YYDS), if you need to upgrade the zsh version, you can use the Homebrew package manager, due to the MAC has gone through a change from x86 to arm architecture, the Homebrew installation has also changed slightly, the official has a more complete solution, can refer to theHomebrew.After the installation is complete, you can use homebrew to install/update zsh. Please pay attention to the environment path so that the system zsh can find and use zsh in your expected path.

For other operating systems, if the server cannot be successfully installed using a one-click script, please first confirm whether the server has a newer version of zsh pre-installed (some older versions of ubuntu and other systems have pre-installed zsh that is too old to support full functionality). If necessary Reinstall zsh, you can install it yourself according to the corresponding system. Please note that installing zsh requires root permissions by default. If the account you are using does not have root permissions, you can download the source codes from zsh and compile and install it by yourself (HPC, NSCC, etc. in one-click scripts use this solution). However, compiling and installing by yourself will encounter various problems due to operating system and other factors. Please pay attention to the official warehouse for solutions.oh-my-zsh provide some installation instructions for reference.

3. Install GCR

GCR is based on the open source tool oh-my-zsh, but some contents have been modified. If you have been using oh-my-zsh before, please uninstall oh-my-zsh first and clean the original files to prevent conflicts with GCR.

1) Check whether there is enough disk space in the directory where GCR is downloaded and $HOME (GCR does not require a large space, but please set aside >5 GB storage to prevent accidents)

2) Check whether zsh is installed normally and whether the version is newer (> 5.0)

zsh --version

copy

3) Set zsh default shell (with root permissions)

sudo chsh -s $(which zsh) $(whoami) # If you have the root permission

copy

3') Set zsh default shell (without root permissions)

# Add the following code to your default shell configuration. Taking bash as an example, you can add it to ~/.bashrc or ~/.bash_profile. $path/to/zsh is the path to your zsh installation.

[ -f $path/to/zsh ] && exec $path/to/zsh -l

copy

4) Enter the gcr folder and copy the gcr dependency files

cp .ohmyshell ~/
cp .ohmytool ~/
cp .ohmyzsh ~/
cp .p9k.zsh ~/
cp .ohmyprint ~/
cp -r oh-my-zsh ~/.oh-my-zsh

copy

5) Generate the GCR configuration file .zshrc to the $HOME directory

SHOW_GCR_INFO=false
CHECK_GCR_UPDATE=true
source ~/.ohmyzsh
source ~/.p9k.zsh
source ~/.ohmyshell

copy

6) Migrate useful parts of the original shell

Migrate useful parts of the original shell to a new file and source the file in .zshrc. You can also migrate it directly to .zshrc, but it is recommended not to write it directly in the main file.

7) At this point, your gcr is installed!