[debug/dev] loosen riot username check; autoload zcalc (#40)

* riot: loosen username check as sometimes it's not a unix username

* Revert "riot: loosen username check as sometimes it's not a unix username"

This reverts commit bdb64ce1f2.

* riot: loosen username check as sometimes it's not a unix username

* zshrc: autoload zcalc

---------

Co-authored-by: xiongdian.me <xiongdian.me@bytedance.com>

.gitconfig2

@@ -1,5 +1,20 @@
 [user]
-	email = me@beardic.cn
+    email = me@beardic.cn
-	name = Dict Xiong
+    name = Dict Xiong
 [core]
     editor = vim
+    # test this by `git update-index --test-untracked-cache`
+    # disable this by setting `GIT_DISABLE_UNTRACKED_CACHE`
+    untrackedCache = true
+    quotepath = false  # chinese chars
+[push]
+    autoSetupRemote = true
+[branch]
+    # Show most recently changed branches first.
+    sort = -committerdate
+[help]
+    autocorrect = 1
+[init]
+    defaultBranch = main
+[log]
+    date = iso

.github/workflows/gitee_sync.yml

@@ -1,9 +1,6 @@
 name: sync repos to gitee
 on:
-  push:
+  push: ~
-    branches: 
-      - main
-      - dev
   schedule:
     - cron: 10 4 * * *
   workflow_dispatch: ~

.github/workflows/gitee_sync_dependencies.yml

@@ -38,6 +38,23 @@ jobs:
         force_update: true  # 启用后，强制同步，即强制覆盖目的端仓库
         static_list: "antigen,zsh-syntax-highlighting,zsh-autosuggestions,zsh-completions"  # 静态同步列表，在此填写需要同步的仓库名称，可填写多个
         timeout: '600s'  # git超时设置，超时后会自动重试git操作
+  zdharma-continuum:
+    runs-on: ubuntu-20.04
+    steps:
+    - name: zdharma-continuum repos  # 名字随便起
+      uses: Yikun/hub-mirror-action@v1.2  # 使用Yikun/hub-mirror-action
+      with:
+        src: github/zdharma-continuum  # 源端账户名(github)
+        dst: gitee/dictxiong  # 目的端账户名(gitee)
+        dst_key: ${{ secrets.GITEE_PRIVATE_KEY }}  # SSH密钥对中的私钥
+        dst_token:  ${{ secrets.GITEE_TOKEN }}  # Gitee账户的私人令牌
+        src_account_type: org
+        dst_account_type: user  # 账户类型
+        clone_style: "https"  # 使用https方式进行clone，也可以使用ssh
+        debug: true  # 启用后会显示所有执行命令
+        force_update: true  # 启用后，强制同步，即强制覆盖目的端仓库
+        static_list: "fast-syntax-highlighting"  # 静态同步列表，在此填写需要同步的仓库名称，可填写多个
+        timeout: '600s'  # git超时设置，超时后会自动重试git操作
   tmux-mem-cpu-load:
     runs-on: ubuntu-20.04
     steps:
@@ -106,3 +123,20 @@ jobs:
         force_update: true  # 启用后，强制同步，即强制覆盖目的端仓库
         static_list: "onedark.vim"  # 静态同步列表，在此填写需要同步的仓库名称，可填写多个
         timeout: '600s'  # git超时设置，超时后会自动重试git操作
+  fzf:
+    runs-on: ubuntu-20.04
+    steps:
+    - name: junegunn/fzf # 名字随便起
+      uses: Yikun/hub-mirror-action@v1.2  # 使用Yikun/hub-mirror-action
+      with:
+        src: github/junegunn  # 源端账户名(github)
+        dst: gitee/dictxiong  # 目的端账户名(gitee)
+        dst_key: ${{ secrets.GITEE_PRIVATE_KEY }}  # SSH密钥对中的私钥
+        dst_token:  ${{ secrets.GITEE_TOKEN }}  # Gitee账户的私人令牌
+        src_account_type: user
+        dst_account_type: user  # 账户类型
+        clone_style: "https"  # 使用https方式进行clone，也可以使用ssh
+        debug: true  # 启用后会显示所有执行命令
+        force_update: true  # 启用后，强制同步，即强制覆盖目的端仓库
+        static_list: "fzf"  # 静态同步列表，在此填写需要同步的仓库名称，可填写多个
+        timeout: '600s'  # git超时设置，超时后会自动重试git操作

.github/workflows/test.yml

@@ -0,0 +1,131 @@
+name: test
+on: 
+  push: ~
+  workflow_dispatch: ~
+jobs:
+  test-ubuntu:
+    name: test on ubuntu
+    runs-on: ubuntu-latest
+    steps:
+      - name: checkout repo
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+      
+      - name: install dfs
+        run: |
+          rev=`git rev-parse HEAD`
+          pwd
+          set -x
+          DFS_NO_WALL=0 ./install.sh -adl
+          test `git rev-parse HEAD` = "$rev"
+
+      - name: antigen build
+        shell: /bin/zsh -ileo PIPE_FAIL {0}
+        run: |
+          echo $SHELL
+          antigen list
+
+      - name: run tests and reset
+        shell: /bin/zsh -ileo PIPE_FAIL {0}
+        run: |
+          source tools/test.zsh
+          antigen reset
+          rm -rf $ANTIGEN $HOME/.antigen $HOME/.config/dotfiles
+          ./install.sh -dl
+
+      - name: antigen build with DFS_NO_WALL
+        shell: /bin/zsh -ileo PIPE_FAIL {0}
+        run: |
+          echo $SHELL
+          antigen list
+
+      - name: run tests
+        shell: /bin/zsh -ileo PIPE_FAIL {0}
+        run: source tools/test.zsh
+  
+  test-macos:
+    name: test on macos
+    runs-on: macos-12
+    steps:
+      - name: checkout repo
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: install dfs
+        run: |
+          rev=`git rev-parse HEAD`
+          pwd
+          set -x
+          DFS_NO_WALL=0 ./install.sh -adl
+          test `git rev-parse HEAD` = "$rev"
+
+      - name: antigen build
+        shell: /bin/zsh -ileo PIPE_FAIL {0}
+        run: |
+          echo $SHELL
+          antigen list
+
+      - name: run tests and reset
+        shell: /bin/zsh -ileo PIPE_FAIL {0}
+        run: |
+          source tools/test.zsh
+          antigen reset
+          rm -rf $ANTIGEN $HOME/.antigen $HOME/.config/dotfiles
+          ./install.sh -dl
+
+      - name: antigen build with DFS_NO_WALL
+        shell: /bin/zsh -ileo PIPE_FAIL {0}
+        run: |
+          echo $SHELL
+          antigen list
+
+      - name: run tests
+        shell: /bin/zsh -ileo PIPE_FAIL {0}
+        run: source tools/test.zsh
+
+  test-autodep:
+    name: test of auto-install dependencies
+    runs-on: ubuntu-latest
+    steps:
+      - name: remove dependencies
+        run: |
+          sudo apt-get -y remove curl vim python3
+
+      - name: checkout repo
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: install dfs
+        run: |
+          rev=`git rev-parse HEAD`
+          set -x
+          ./install.sh -dal
+          test `git rev-parse HEAD` = "$rev"
+
+      - name: antigen build
+        shell: /bin/zsh -ileo PIPE_FAIL {0}
+        run: |
+          echo $SHELL
+          antigen list
+
+  test-get-dotfiles-cn:
+    name: test of get.dotfiles.cn script
+    runs-on: ubuntu-latest
+    steps:
+      - name: checkout repo
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: run the script
+        run: |
+          repo=https://github.com/DictXiong/dotfiles bash tools/get.dotfiles.cn -asl
+
+      - name: run tests
+        shell: /bin/zsh -ileo PIPE_FAIL {0}
+        run: |
+          dfs cd
+          source tools/test.zsh

.gitignore

@@ -1 +1,2 @@
 *.zwc
+update.sh

.ssh/authorized_keys2

@@ -1,15 +1,8 @@
-ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQD5VPD5c/pBtQM5mcKMzJ6vC2jDdVJU6ifkP1EvAeV/dKEyy5hOc+EXC8Ws7bAp3a7twvsQGSqNbeXuAO4PzX2KHhI49KiFyRugo8LsUF3TVVluOXtGWKgw+36TBO3rNFgWOnhw5B4IlNtxo2nk4grCkgEsE6w+Ignd+FrEFec457oal2SPN02TjUfRULaEPSpZTl7cA/5Re9/QmlcYjuyA9zbkO98KYA0M71W/eUcjfjNEaWXjn2pcloakoWwEEdi4v/yJ1Fk+gQYcbpoftxpWmWLvFhDGP+qvTZY5QHxDxiPbc3HDdx0qBvMOQW9XSt0J/L/btnxcZvA1lDtkC2bm8zvHxtLBZ9JBRutMbRhdSgkd3+5DwHDIO0EIUqckgCfX3t7avj5RsPAl0j4V40yB637YQim7saN3FWq43SpR3i6buNbQLPdgy2SDN6fAZcAPWvifE1KG7I2BtmiFFYjAy3iU1KD2Hgn6mIpOOCZOJV30/cf3Oq8ZSDfD7PmDu72yOea3h9JlvkKjjqknnF4NdQ5cy1FuIfyebnF6+ugbdA9UqY9PZdnuwy5RkwkmJwC4AVO3GaOfuQDU61UMSoTfYH1yB8x8HHUQcJzLtfExrYpVPAo89tyN1lcIIBUBoHhNMCwVBZipfV/H41cIxs5wkHsolQ02zZaAX6Cgbii9FQ== home
-
-ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIPmMImRSAhksHUfCwNpcj61izGn0Xkv1KRIuxb0OSdJl pc0/old
-
-ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIO4K5S3zDYbxlw7B45zOdmKud95nXU1V6kSxEvbTOsy2 pc1/old
-
 # keys below are the new security system starting from 2022-07
-sk-ssh-ed25519@openssh.com AAAAGnNrLXNzaC1lZDI1NTE5QG9wZW5zc2guY29tAAAAIGdLJYOrBhWERmkQ+sNM8tGzJ37UBEKkEuhbtE9B65mOAAAABHNzaDo= sk0/fido
 
 ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIGakUcSuNhuH7tk+Nj9gDfRtxYfGPL9yb8toQ/EpSJAM openpgp:0xD9271B01
 
-ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCUN7IXF4nlFcVfgHesgik3LIAiXlVMYJPm3yD13EVarQx5jqdBgk8Dwgkgf4rPO6MFpvIpinOyEO8zOS6HHQrCLZUv5yTFaDkUuB7eQ0EmpicGbmk9bHqj1HkOZxaobkpEfQUmFKYvkp4EexVw66sO0qfXvjHZ4H6yCAJLK5aUnKfgrE8tODzP82sU/mpJjW+Pq3uanNq754gaHwhxCIXG143/zp8qzBAeKe38xVqqDq9fTkG4hvzFvkRdS88i6l1z++0P3n0HGdOjtSg7P7fO7+7ZyPYr0gO5vB720Om/zxqPrGd9cicWi4P+aVKa+0ujWH/pqufWG6uCjKWHnBs7 sk0.ibd.ink/piv/9a
+ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCUN7IXF4nlFcVfgHesgik3LIAiXlVMYJPm3yD13EVarQx5jqdBgk8Dwgkgf4rPO6MFpvIpinOyEO8zOS6HHQrCLZUv5yTFaDkUuB7eQ0EmpicGbmk9bHqj1HkOZxaobkpEfQUmFKYvkp4EexVw66sO0qfXvjHZ4H6yCAJLK5aUnKfgrE8tODzP82sU/mpJjW+Pq3uanNq754gaHwhxCIXG143/zp8qzBAeKe38xVqqDq9fTkG4hvzFvkRdS88i6l1z++0P3n0HGdOjtSg7P7fO7+7ZyPYr0gO5vB720Om/zxqPrGd9cicWi4P+aVKa+0ujWH/pqufWG6uCjKWHnBs7 sk0/piv/9a
 
 ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIGV/6cLUGA5YWVI6uPhIBOBZvlNBlZLkehHQN0Gxnc+B ltp0/ubuntu
 
@@ -19,10 +12,17 @@ ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIFO4k0tJ+Bfu95Uavg/5P3EXMKNcq+bMqaTqzkvRZ7ji
 
 ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIN8g34WHLEix6Qt0J/ClYbZeb9wh+p1IOcZkz/vNbZrv ltp1/windows
 
+ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIBN24pvN1RMN+iSZyHPdyExA1Rvt8pdr3e6ih6iX+KrQ ltp2
+
 ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIGZFTyR+R86fUpZBDkDR9yYzJpmeNsIv2CMHTh6EuEeq pc0/windows
 
-ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAID8WHIpwdZl7+HIZfQpwIAhpxT1huI9sd6Ydeokilg5l pc1/windows
+ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIHLYgVj+NPino6sOmahULN7SbAMaVAgzqPfDjz2S8zDv pc1/windows
-
-ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAyNTYAAABBBJ/+BWSTv3w1Ru9ksfse3EUbu4ukJruUU94fCG7Sk+5g3+F80KqJGykP9tHueU07iZfAuaYj7Zcy+IWx9Ih+eYA= ph0/sep
 
 ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAyNTYAAABBBNvHya5i3GNniGww9Yx5ikos4Z5jevu8zz8hCQi05++SgejFPnbw9UjbHFjODK2M+ZHuhRF5mdf996r4/BxWyP8= pad0/sep
+
+ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAyNTYAAABBBC5gu+U4picxVvCNYjLlmxGLpJl7svj3LklO7jSpwqdrNxlE+/xkx07PJx76AbA77dDM1Dxmm/VOvVQCKTRLTgk= ip14/sep
+
+ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIF52mPmbLEriZ+DfmrMHFtvg2kiO2JpRpitvs7PbJowh home0
+
+ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIKhS4voo3K/Dvzqckr0bouO1WkCI5XxswstHWnuuyKBz ltp1-bd
+

.update.sh

@@ -0,0 +1,59 @@
+#!/bin/bash
+
+THIS_DIR=$( cd "$( dirname "${BASH_SOURCE[0]:-${(%):-%x}}" )" && pwd )
+THIS_FILE=$(basename "${BASH_SOURCE}")
+source "$THIS_DIR/tools/common.sh"
+
+DFS_UPDATED_RET=${DFS_UPDATED_RET:-0}
+DFS_UPDATE_CHANNEL=${DFS_UPDATE_CHANNEL:-"main"}
+
+# send beacon online
+apost_beacon "sys.online"
+
+# update dns
+if [[ "$DFS_DDNS_ENABLE" == "1" ]]; then
+    fmt_info "updating dns ..."
+    if ! is_tty; then
+        time_to_sleep=$((RANDOM%600))
+        fmt_note "sleep for $time_to_sleep seconds"
+        sleep $time_to_sleep
+    fi
+    "$THIS_DIR/tools/frigg-client.sh" ddns || (fmt_error "failed to update dns" && apost_beacon "dfs.ddns.fail")
+fi
+
+# fetch origin
+cd $DOTFILES
+git fetch --all --prune
+if [[ -n "$(git status -s)" ]]; then
+    fmt_error "directory not clean"
+    apost_beacon "dfs.dirty"
+    exit
+fi
+
+# get the specified commit id
+case $DFS_UPDATE_CHANNEL in
+    "main" ) DFS_COMMIT=$(curl $DFS_CURL_OPTIONS -fsSL https://api.beardic.cn/get-var/dfs-commit-id) ;;
+    "dev" ) DFS_COMMIT=$(git rev-parse origin/dev 2> /dev/null) || DFS_COMMIT=$(git rev-parse origin/main) ;;
+    "latest" ) DFS_COMMIT=$(git for-each-ref --sort=-committerdate refs/heads refs/remotes --format='%(objectname)' | head -n 1) ;;
+    * ) fmt_fatal "invalid update channel: $DFS_UPDATE_CHANNEL" ;;
+esac
+if [[ ${#DFS_COMMIT} != 40 ]]; then
+    fmt_error "invalid commit id"
+    apost_beacon "dfs.invalid-commit"
+    apost_log "ERROR" "$THIS_FILE" "invalid commit id: ${DFS_COMMIT}"
+    exit
+fi
+
+# update
+if [[ "$(git rev-parse HEAD)" == "$DFS_COMMIT" ]]; then
+    fmt_info "nothing to do"
+else
+    fmt_info "checking out to commit $DFS_COMMIT ..."
+    if [[ -z "$DFS_DEV" || "$DFS_DEV" == "0" ]]; then
+        post_beacon "dfs.updated"
+        git -c advice.detachedHead=false checkout $DFS_COMMIT
+        cp ./.update.sh ./update.sh && chmod +x ./update.sh && exit $DFS_UPDATED_RET
+    else
+        fmt_warning "won't really checkout in dev mode"
+    fi
+fi

.vimrc2

@@ -16,6 +16,7 @@ set autoindent
 set smartindent
 set tabstop=4
 set expandtab "spaces instead of tabs
+set backspace=indent,eol,start
 set number "line numbers
 set history=1000
 set ignorecase "when searching

.zshrc2

@@ -1,123 +1,182 @@
+# env for shell
 export TERM="xterm-256color"
-export LC_ALL=C.UTF-8
+if (command -v locale >/dev/null) && ( locale -a | grep -qxE "C.UTF-8|C.utf8" ); then
-export LANG=C.UTF-8
+    export LC_ALL=C.UTF-8
+    export LANG=C.UTF-8
+else
+    export LC_ALL=en_US.UTF-8
+    export LANG=en_US.UTF-8
+fi
+export DOTFILES=$( cd "$( dirname "${BASH_SOURCE[0]:-${(%):-%x}}" )" && pwd )
+export PATH="$PATH:$DOTFILES/scripts"
+export EDITOR='vim'
+# env for apps
+export PYTHONIOENCODING='UTF-8'
+export GPG_TTY=$(tty)
+export LESS_TERMCAP_md=$'\E[01;33m'
+# env for dfs
+if [[ -f ~/.config/dotfiles/env ]]; then set -a; source ~/.config/dotfiles/env; set +a; fi
 
 # antigen
-
+if [[ "$DFS_NO_WALL" == "1" ]]; then
-# if test -z "$NO_WALL"; then
+    ANTIGEN_URL="https://raw.githubusercontent.com/zsh-users/antigen/develop/bin/antigen.zsh"
-#     ANTIGEN_OMZ_REPO_URL="https://mirrors.tuna.tsinghua.edu.cn/git/ohmyzsh.git"
+    ANTIGEN_OMZ_REPO_URL="https://github.com/ohmyzsh/ohmyzsh.git"
-#     ANTIGEN_URL="https://raw.fastgit.org/zsh-users/antigen/master/bin/antigen.zsh"
+    ANTIGEN_PLUGINS=(
-#     GIHUB_PROXY="https://hub.fastgit.xyz/"
+        "https://github.com/zdharma-continuum/fast-syntax-highlighting"
-# else
+        "https://github.com/zsh-users/zsh-completions"
-#     ANTIGEN_URL="git.io/antigen"
+        "https://github.com/zsh-users/zsh-autosuggestions"
-#     GIHUB_PROXY=""
+    )
-# fi
+else
-# antigen bundle ${GIHUB_PROXY}zsh-users/zsh-syntax-highlighting
+    ANTIGEN_URL="https://gitee.com/dictxiong/antigen/raw/develop/bin/antigen.zsh"
-# antigen bundle ${GIHUB_PROXY}zsh-users/zsh-completions
+    ANTIGEN_OMZ_REPO_URL="https://gitee.com/dictxiong/ohmyzsh.git"
-# antigen bundle ${GIHUB_PROXY}zsh-users/zsh-autosuggestions
+    ANTIGEN_PLUGINS=(
-ANTIGEN_OMZ_REPO_URL="https://gitee.com/dictxiong/ohmyzsh.git"
+        "https://gitee.com/dictxiong/fast-syntax-highlighting"
-ANTIGEN_URL="https://gitee.com/dictxiong/antigen/raw/develop/bin/antigen.zsh"
+        "https://gitee.com/dictxiong/zsh-completions"
+        "https://gitee.com/dictxiong/zsh-autosuggestions"
+    )
+fi
 ANTIGEN="$HOME/antigen.zsh"
 # Install antigen.zsh if not exist
 if [ ! -f "$ANTIGEN" ]; then
-	echo "Installing antigen ..."
+    echo "Installing antigen ..."
-	TMPFILE="/tmp/antigen.zsh"
+    TMPFILE="/tmp/antigen.zsh"
-	if [ -x "$(which curl)" ]; then
+    if [ -x "$(which curl)" ]; then
-		curl -L "$ANTIGEN_URL" -o "$TMPFILE" 
+        curl -L "$ANTIGEN_URL" -o "$TMPFILE"
-	elif [ -x "$(which wget)" ]; then
+    elif [ -x "$(which wget)" ]; then
-		wget "$ANTIGEN_URL" -O "$TMPFILE" 
+        wget "$ANTIGEN_URL" -O "$TMPFILE"
-	else
+    else
-		echo "ERROR: please install curl or wget before installation !!"
+        echo "ERROR: please install curl or wget before installation !!"
-		exit
+        exit
-	fi
+    fi
-	if [ ! $? -eq 0 ]; then
+    if [ ! $? -eq 0 ]; then
-		echo ""
+        echo ""
-		echo "ERROR: downloading antigen.zsh ($ANTIGEN_URL) failed !!"
+        echo "ERROR: downloading antigen.zsh ($ANTIGEN_URL) failed !!"
-		exit
+        exit
-	fi;
+    fi;
-	echo "move $TMPFILE to $ANTIGEN"
+    echo "move $TMPFILE to $ANTIGEN"
-	mv "$TMPFILE" "$ANTIGEN"
+    mv "$TMPFILE" "$ANTIGEN"
 fi
 # config and enable antigen
 source "$ANTIGEN"
-antigen use oh-my-zsh
 # enable plugins
-antigen_plugins=( \
+antigen use oh-my-zsh
-    "command-not-found" \
+ANTIGEN_PLUGINS+=(
-    "docker" \
+    "command-not-found"
-    "extract" \
+    "docker"
-    "fzf" \
+    "extract"
-    "git" \
+    "fzf"
-    "ripgrep" \
+    "git"
-    "thefuck" \
+    "ripgrep"
-    "tmux" \
+    "tmux"
-    "ufw" \
+    "ufw"
-    "z" \
+    "z"
-    "https://gitee.com/dictxiong/zsh-syntax-highlighting" \
-    "https://gitee.com/dictxiong/zsh-completions" \
-    "https://gitee.com/dictxiong/zsh-autosuggestions" \
 )
-for i in ${antigen_plugins[*]}
+for i in ${ANTIGEN_PLUGINS[*]}; do
-do
     if [[ -z $ANTIGEN_EXCLUDE || ! $i =~ $ANTIGEN_EXCLUDE ]]; then
         antigen bundle $i
     fi
 done
 # select theme
-antigen theme ${ZSH_THEME:-ys}
+TMP_THEME=ys
+if [[ -e /.dockerenv ]]; then
+    TMP_THEME=robbyrussell
+    echo "==========================="
+    echo "This is in docker container"
+    echo "==========================="
+fi
+antigen theme ${ZSH_THEME:-$TMP_THEME}
 # apply 
 antigen apply
 # end of antigen config
 
-# functions
+# beacon
-export DOTFILES=$( cd "$( dirname "${BASH_SOURCE[0]:-${(%):-%x}}" )" && pwd )
+if [[ -z "$DFS_INITED" && -z "$CI"  ]]; then
-
+    if [[ "$EUID" == "0" ]]; then
-SUDO=''
+        "$DOTFILES/tools/common.sh" apost_beacon "sys.login.root" "$(who am i | sed -E 's/ +/ /g' | awk '$1=$1')" 2>/dev/null
-if (( $EUID != 0 )); then
+    else
-    SUDO='sudo'
+        "$DOTFILES/tools/common.sh" apost_beacon "sys.login.user" "$(who am i | sed -E 's/ +/ /g' | awk '$1=$1')" 2>/dev/null
+    fi
 fi
 
-dfs()
-{
-	case $1 in
-		update ) (cd "$DOTFILES" && git pull) ;;
-		force-update ) (cd "$DOTFILES" && git fetch --all && git reset --hard origin/main && git pull) ;;
-		reset  ) 
-			antigen reset 1> /dev/null
-			rm -rf $HOME/.antigen
-			$DOTFILES/install.sh -r
-			dfs update
-			$DOTFILES/install.sh -i
-			echo 'Done. Please open a new shell to see the changes.'
-			;;
-		cd     ) cd "$DOTFILES" ;;
-		*      ) echo "unknown command \"$1\". available: update, force-update, reset, cd" ;;
-	esac
-}
-
-dogo()
-{
-	if [[ -z "$1" || "$1" =~ "-h|--help" ]]; then
-		echo "usage: dogo <container>"
-	else
-		$SUDO docker exec -it $1 zsh
-	fi
-}
-
 # alias
 alias "pls"='sudo $(fc -ln -1)'
 alias "se"='sudo -sE'
 alias "pbd"='ping baidu.com'
 alias "p114"='ping 114.114.114.114'
 alias "p666"='ping6 2001:da8::666'
-alias l='ls -lAGh --time-style="+%y-%m-%d %H:%M"'
+alias "cbd"='curl http://www.baidu.com'
+alias "cbds"='curl https://www.baidu.com'
+alias "gdebug"='git add -A; git commit --allow-empty -m "bug fix ($(date))"'
+case $(bash "$DOTFILES/tools/common.sh" get_os_type) in
+    macos  ) alias l='ls -lAGh -D "%y-%m-%d %H:%M"' ;;
+    *      ) alias l='ls -lAGh --time-style="+%y-%m-%d %H:%M"' ;;
+esac
+if [[ -x $(command -v trash) ]]; then
+    alias "rm"="echo use the full path i.e. '/bin/rm'\; consider using trash"
+fi
+gbes() { git for-each-ref --sort=-committerdate refs/heads refs/remotes --format="%(authordate:format:%y-%m-%d.%a %H:%M %z)|%(color:red)%(objectname:short)|%(color:yellow)%(refname:short)%(color:reset)|%(color:reset)%(authorname): %(color:green)%(subject)" --color=always | column -ts"|" | less -FX }
+sagt() { eval "$($DOTFILES/tools/sagent.sh $@)" }
 
 # key bindings
-bindkey "^b" beginning-of-line
+bindkey "^b" beginning-of-line  # ctrl+b
-bindkey "^e" end-of-line
+bindkey "\eOH" beginning-of-line
-bindkey "^[[H" beginning-of-line
+bindkey "\e[H" beginning-of-line  # home; termius
-bindkey "^[[F" end-of-line
+bindkey "\e[1~" beginning-of-line
-bindkey "^[[1~" beginning-of-line
+
-bindkey "^[[4~" end-of-line
+bindkey "^e" end-of-line  # ctrl+e
-bindkey "^[OH" beginning-of-line
+bindkey "\eOF" end-of-line
-bindkey "^[OF" end-of-line
+bindkey "\e[F" end-of-line  # end; termius
+bindkey "\e[4~" end-of-line
+
+bindkey "\ef" forward-word  # alt+f
+bindkey "\e[5C" forward-word
+bindkey "\e\e[C" forward-word  # alt+right_arrow; iterm2
+bindkey "\e[1;5C" forward-word  # alt+right_arrow; termius
+
+bindkey "\eb" backward-word  # alt+e
+bindkey "\e[5D" backward-word
+bindkey "\e\e[D" backward-word  # alt+left_arrow; iterm2
+bindkey "\e[1;5D" backward-word  # alt+left_arrow; termius
+
+bindkey "\ed" delete-char  # alt+d
+
+# mods
+autoload zcalc
+
+# dfs
+dfs()
+{
+    setopt local_options err_return pipe_fail
+    case $1 in
+        cd     ) cd "$DOTFILES" ;;
+        update ) "$DOTFILES/update.sh" ;;
+        version ) (cd "$DOTFILES" && git rev-parse HEAD) ;;
+        vversion ) (cd "$DOTFILES" && git show) ;;
+        config )
+            mkdir -p ~/.config/dotfiles
+            $EDITOR ~/.config/dotfiles/env
+            ;;
+        force-update ) (
+            cd "$DOTFILES"
+            git fetch --all
+            ref=$(git symbolic-ref --short HEAD 2> /dev/null)  || ref=$(git rev-parse --short HEAD 2> /dev/null)  || return 0
+            for i in $(git for-each-ref refs/heads --format='%(refname)') ; do git checkout ${i#refs/heads/} ; git pull --ff-only ; done
+            git checkout -c advice.detachedHead=false $ref)
+            ;;
+        reset  )
+            antigen reset 1> /dev/null
+            rm -rf $HOME/.antigen
+            "$DOTFILES/install.sh" -r
+            dfs update
+            "$DOTFILES/install.sh" -i
+            echo 'Done. Please open a new shell to see the changes.'
+            ;;
+        log    ) "$DOTFILES/tools/common.sh" "post_log" "INFO" "dfs" "$2" ;;
+        beacon ) "$DOTFILES/tools/common.sh" "post_beacon" "$2" "$3" ;;
+        *      ) echo "unknown command \"$1\". available: update, force-update, version, reset, cd, log" ;;
+    esac
+}
+
+# clean
+unset i
+export DFS_INITED=1

install.sh

@@ -1,243 +1,331 @@
 #!/bin/bash
+set -e
+THIS_DIR=$( cd "$( dirname "${BASH_SOURCE[0]:-${(%):-%x}}" )" && pwd )
+source "$THIS_DIR/tools/common.sh"
 
-# Color settings
+
-# Source: https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh
+if [[ ! "$DOTFILES" == "${HOME}"* ]]; then 
-if [ -t 1 ]; then
+    fmt_fatal "\"$DOTFILES\" is not under \"$HOME\". aborting ..."
-    is_tty() {
-        true
-    }
-else
-    is_tty() {
-        false
-    }
 fi
+DOTFILE_TILDE=${DOTFILES/"$HOME"/\~}
 
-supports_truecolor() {
+CRON_JOB="0 * * * * ${DOTFILES}/update.sh"
-    case "$COLORTERM" in
+declare -a DFS_CONFIGS
-    truecolor|24bit) return 0 ;;
+declare -a HOME_FILES_PATH
-    esac
+declare -a HOME_FILES_CONTENT
+HOME_FILES_PATH[0]=".zshrc"
+HOME_FILES_CONTENT[0]="source ${DOTFILE_TILDE}/.zshrc2"
+HOME_FILES_PATH[1]=".tmux.conf"
+HOME_FILES_CONTENT[1]="source-file ${DOTFILE_TILDE}/.tmux.conf2"
+HOME_FILES_PATH[2]=".vimrc"
+HOME_FILES_CONTENT[2]="source ${DOTFILE_TILDE}/.vimrc2"
+HOME_FILES_PATH[3]=".gitconfig"
+HOME_FILES_CONTENT[3]="[include] path = \"${DOTFILE_TILDE}/.gitconfig2\""
 
-    case "$TERM" in
+declare -a HOME_SYMLINKS_SRC
-    iterm           |\
+declare -a HOME_SYMLINKS_DST
-    tmux-truecolor  |\
+HOME_SYMLINKS_SRC[0]=".ssh/authorized_keys2"
-    linux-truecolor |\
+HOME_SYMLINKS_DST[0]=".ssh/authorized_keys2"
-    xterm-truecolor |\
-    screen-truecolor) return 0 ;;
-    esac
 
-    return 1
+install_dependencies()
-}
-
-fmt_fatal() {
-    printf '%sfatal: %s%s\n' "${FMT_BOLD}${FMT_RED}" "$*" "$FMT_RESET" >&2
-    exit
-}
-
-fmt_error() {
-    printf '%serror: %s%s\n' "${FMT_RED}" "$*" "$FMT_RESET" >&2
-}
-
-fmt_warning() {
-    echo "${FMT_YELLOW}warning: $1 ${FMT_RESET}" 
-}
-
-fmt_note() {
-    echo "${FMT_GREEN}$1 ${FMT_RESET}"
-}
-
-setup_color() {
-    # Only use colors if connected to a terminal
-    if ! is_tty; then
-        FMT_RAINBOW=""
-        FMT_RED=""
-        FMT_GREEN=""
-        FMT_YELLOW=""
-        FMT_BLUE=""
-        FMT_BOLD=""
-        FMT_RESET=""
-    return
-    fi
-
-    if supports_truecolor; then
-    FMT_RAINBOW="
-        $(printf '\033[38;2;255;0;0m')
-        $(printf '\033[38;2;255;97;0m')
-        $(printf '\033[38;2;247;255;0m')
-        $(printf '\033[38;2;0;255;30m')
-        $(printf '\033[38;2;77;0;255m')
-        $(printf '\033[38;2;168;0;255m')
-        $(printf '\033[38;2;245;0;172m')
-    "
-    else
-    FMT_RAINBOW="
-        $(printf '\033[38;5;196m')
-        $(printf '\033[38;5;202m')
-        $(printf '\033[38;5;226m')
-        $(printf '\033[38;5;082m')
-        $(printf '\033[38;5;021m')
-        $(printf '\033[38;5;093m')
-        $(printf '\033[38;5;163m')
-    "
-    fi
-
-    FMT_RED=$(printf '\033[31m')
-    FMT_GREEN=$(printf '\033[32m')
-    FMT_YELLOW=$(printf '\033[33m')
-    FMT_BLUE=$(printf '\033[34m')
-    FMT_BOLD=$(printf '\033[1m')
-    FMT_RESET=$(printf '\033[0m')
-}
-# END of color settings
-
-dotfile_path=$( cd "$( dirname "${BASH_SOURCE[0]:-${(%):-%x}}" )" && pwd )
-home_slashes=${HOME//\//\\\/}
-if [[ ! $dotfile_path == ${home_slashes}* ]]; then 
-    fmt_fatal "\"$dotfile_path\" is not under \"$HOME\". aborting ..."
-fi
-dotfile_home_path=${dotfile_path/${home_slashes}/\~}
-dotfile_relative_path=${dotfile_path#${home_slashes}\/}
-crontab_job="0 * * * * cd ${dotfile_path} && env git pull"
-
-ask_for_yN()
 {
-    while true; do
+    local ret=0
-        read -p "${FMT_YELLOW}$1${FMT_RESET} [yN]: " yn
+    fmt_note "installing dependencies ..."
-        case $yn in
+    set +e
-            [Yy]* ) return 1;;
+    case $(get_os_name) in
-            [Nn]* ) return 0;;
+        "ubuntu"|"debian" )
-            * ) return 0;;
+            $SUDOE "$DOTFILES/tools/ubuntu.sh" apt-install
-        esac
+            ret=$?
+            ;;
+        "alpine" )
+            $SUDOE "$DOTFILES/tools/alpine.sh" apk-add
+            ret=$?
+            ;;
+        "macos" )
+            "$DOTFILES/tools/macos.sh" brew-install
+            ret=$?
+            ;;
+        "msys" )
+            "$DOTFILES/tools/msys2.sh" pacman-S
+            ret=$?
+            ;;
+        * ) fmt_error "dfs auto-install is not implemented on OS: $(get_os_name). skipping ..."
+    esac
+    set -e
+    if [[ "$ret" != "0" ]]; then
+        fmt_error "failed to install dependencies."
+    fi
+}
+
+preinstall_check()
+{
+    fmt_note "checking requirements ..."
+    local mandatory_commands=( "git" "zsh" "curl" "grep" "cat" "cp" "bash" "mkdir" )
+    local optional_commands=( "vim" "tmux" "ping" )
+    for i in "${mandatory_commands[@]}"; do
+        if ! command -v $i 1>/dev/null; then
+            fmt_info "all this utils are required: ${mandatory_commands[@]}"
+            fmt_info "install them manually or check scripts in tools/"
+            fmt_fatal "\"$i\" not found. aborting ..."
+        fi
+    done
+    for i in "${optional_commands[@]}"; do
+        if ! command -v $i 1>/dev/null; then
+            fmt_warning "\"$i\" not found"
+            yn=$(ask_for_Yn "continue anyway?")
+            if [[ "$yn" == "0" ]]; then
+                fmt_info "all this utils are suggested: ${optional_commands[@]}"
+                fmt_info "install them manually or check scripts in tools/"
+                fmt_fatal "aborting ..."
+            fi
+        fi
     done
 }
 
-insert_if_not_exist()
+prepare_config()
 {
-    filename=$1
+    local remote=$(cd "$DOTFILES" && git remote get-url origin)
-    line=$2
+    if [[ -z "$DFS_NO_WALL" && $remote == *github* ]]; then
-    fmt_note "installing \"$line\" into \"$filename\" ..."
+        DFS_CONFIGS+=("DFS_NO_WALL=1")
-    mkdir -p $(dirname "$filename")
-    if [ ! -f "$filename" ]; then
-        touch $filename
     fi
-    grep -qxF -- "$line" "$filename" || echo "$line" >> "$filename"
+    if [[ ${#DFS_CONFIGS[@]} == 0 ]]; then
-}
+        return
-
-delete_if_exist()
-{
-    filename=$1
-    line=$2
-    fmt_note "removing \"$line\" from \"$filename\" ..."
-    if [ -f "$filename" ]; then
-        grep -vxF -- "$line" "$filename" | tee "$filename"
     fi
-}
+    fmt_note "preparing dotfiles configurations ..."
-
+    local key value
-create_symlink()
+    for i in "${DFS_CONFIGS[@]}"; do
-{
+        if [[ "$i" == *"="* ]]; then
-    src=$1
+            key=${i%%=*}
-    dest=$2
+            value=${i#*=}
-    fmt_note "creating symlink \"$dest\" --> \"$src\" ..."
-    if [ ! -f "$src" ]; then
-        fmt_error "\"$src\" does not exist! aborting this job ..."
-        return 1
-    fi
-    mkdir -p $(dirname "$dest")
-    if [ -f "$dest" ]; then
-        if [ "$(readlink $dest)" -ef "$src" ]; then
-            return 0
-        fi
-        fmt_warning "\"$dest\" already exists! stat output:"
-        echo ----------
-        stat $dest
-        echo ----------
-        ask_for_yN "would you like to replace ${dest}?"
-        if [ $? -eq 1 ]; then 
-            rm $dest
         else
-            fmt_error "\"$dest\" already exists! aborting this job ..."
+            key=$i
-            return 1
+            value=$(eval echo \$$key)
         fi
-    fi
+        HOME_FILES_PATH+=(".config/dotfiles/env")
-    ln -s $src $dest
+        HOME_FILES_CONTENT+=("$key=$value")
-    return $?
+        echo -n "$key=$value "
+        export $key=$value
+    done
+    echo
 }
 
-delete_link_if_match()
+append_hist()
 {
-    src=$1
+    fmt_note "appending zsh history ..."
-    dest=$2
+    "$DOTFILES/tools/append_zsh_hist.sh" "$@"
-    if [ "$(readlink $dest)" -ef "$src" ]; then
+}
-        fmt_note "removing symlink \"$dest\" ..."
+
-        echo ----------
+install_file_content()
-        stat $dest
+{
-        echo ----------
+    fmt_note "installing file content ..."
-        rm $dest
+    for ((i=0; i<${#HOME_FILES_PATH[@]}; i++)); do
+        local filename="$HOME/${HOME_FILES_PATH[$i]}"
+        local content="${HOME_FILES_CONTENT[$i]}"
+        fmt_info "installing \"$content\" into \"$filename\" ..."
+        mkdir -p $(dirname "$filename")
+        if [ ! -f "$filename" ]; then
+            touch $filename
+        fi
+        grep -qxF -- "$content" "$filename" || echo "$content" >> "$filename"
+    done
+}
+
+uninstall_file_content()
+{
+    fmt_note "uninstalling file content ..."
+    for ((i=0; i<${#HOME_FILES_PATH[@]}; i++)); do
+        local filename="$HOME/${HOME_FILES_PATH[$i]}"
+        local content=${HOME_FILES_CONTENT[$i]}
+        fmt_info "removing \"$content\" from \"$filename\" ..."
+        if [ -f "$filename" ]; then
+            grep -vxF -- "$content" "$filename" | tee "$filename"
+        fi
+    done
+}
+
+install_symlink()
+{
+    fmt_note "installing symlinks ..."
+    for ((i=0; i<${#HOME_SYMLINKS_SRC[@]}; i++)); do
+        local src="$DOTFILES/${HOME_SYMLINKS_SRC[$i]}"
+        local dst="$HOME/${HOME_SYMLINKS_DST[$i]}"
+        fmt_info "creating symlink \"$dst\" --> \"$src\" ..."
+        if [ ! -f "$src" ]; then
+            fmt_error "\"$src\" does not exist! aborting this job ..."
+            continue
+        fi
+        mkdir -p $(dirname "$dst")
+        if [ -f "$dst" ]; then
+            if [ "$(readlink $dst)" -ef "$src" ]; then
+                continue
+            fi
+            fmt_warning "\"$dst\" already exists! stat output:"
+            echo ----------
+            stat $dst
+            echo ----------
+            yn=$(ask_for_yN "would you like to replace ${dst}?")
+            if [[ "$yn" == "1" ]]; then
+                rm $dst
+            else
+                fmt_error "aborting this job ..."
+                continue
+            fi
+        fi
+        ln -s $src $dst
+    done
+}
+
+uninstall_symlink()
+{
+    fmt_note "uninstalling symlinks ..."
+    local src
+    for src in "${!HOME_SYMLINKS[@]}"; do
+        local dst=${HOME_SYMLINKS[$src]}
+        src="$DOTFILES/$src"
+        dst="$HOME/$dst"
+        if [ "$(readlink $dst)" -ef "$src" ]; then
+            fmt_info "removing symlink \"$dst\" ..."
+            echo ----------
+            stat $dst
+            echo ----------
+            rm $dst
+        fi
+    done
+}
+
+install_crontab()
+{
+    if [[ -x $(command -v crontab) ]]; then
+        fmt_note "installing \"$CRON_JOB\" to crontab ..."
+        if ! crontab -l 1>/dev/null 2>&1; then
+            echo -n | crontab -
+        fi
+        ( crontab -l | grep -vxF "${CRON_JOB}" | grep -v "no crontab for"; echo "$CRON_JOB" ) | crontab -
+    else
+        fmt_warning "crontab does not exist. skipping ..."
     fi
 }
 
-install_crontab(){
+uninstall_crontab()
-    fmt_note "installing \"$crontab_job\" to crontab ..."
+{
-    ( crontab -l | grep -vxF "${crontab_job}" | grep -v "no crontab for"; echo "$crontab_job" ) | crontab -
+    if [[ -x $(command -v crontab) ]]; then
+        fmt_note "removing \"$CRON_JOB\" from crontab ..."
+        ( crontab -l | grep -vxF "$CRON_JOB" ) | crontab -
+    else
+        fmt_note "crontab does not exist. skipping ..."
+    fi
 }
 
-uninstall_crontab(){
+install_tmux_tpm()
-    fmt_note "removing \"$crontab_job\" from crontab ..."
+{
-    ( crontab -l | grep -vxF "$crontab_job" ) | crontab - 
-}
-
-install_tmux_tpm(){
     TMUX_TPM="$HOME/.tmux/plugins/tpm"
     if [[ -x $(command -v tmux) && ! -d "$TMUX_TPM" ]]; then
         fmt_note "installing tmux tpm ..."
         git clone https://gitee.com/dictxiong/tpm "$TMUX_TPM"
         if [[ -x $(command -v g++) && -x $(command -v cmake) && -x $(command -v make) ]]; then
-            fmt_note "initializing tmux plugins ..."
+            if [[ -z "$DFS_LITE" || "$DFS_LITE" == "0" ]]; then
-            ~/.tmux/plugins/tpm/bin/install_plugins
+                fmt_note "initializing tmux plugins ..."
+                ~/.tmux/plugins/tpm/bin/install_plugins
+            else
+                fmt_warning "in lite mode, tmux plugins are downloaded but not complied"
+                fmt_info "try <prefix + I> or ~/.tmux/plugins/tpm/bin/install_plugins to complie manually"
+            fi
         else
             fmt_warning "pls install g++,cmake,make and then init tmux plugins by <prefix + I> or ~/.tmux/plugins/tpm/bin/install_plugins"
         fi
     fi
 }
 
-install_vim_vundle(){
+install_vim_vundle()
+{
     VIM_VUNDLE="$HOME/.vim/bundle/Vundle.vim"
     if [[ -x $(command -v vim) && ! -d "$VIM_VUNDLE" ]]; then
         fmt_note "installing vim vundle ..."
         git clone https://gitee.com/dictxiong/Vundle.vim "$VIM_VUNDLE"
         fmt_note "initializing vim plugins ..."
-        vim +PluginInstall +qall
+        echo | vim +PluginInstall +qall
     fi
 }
 
-install(){
+install_update()
+{
+    fmt_note "installing update.sh ..."
+    cp "${DOTFILES}/.update.sh" "${DOTFILES}/update.sh"
+    chmod +x "${DOTFILES}/update.sh"
+    fmt_note "running update.sh ..."
+    set +e
+    DFS_UPDATED_RET=85 ${DOTFILES}/update.sh
+    RET=$?
+    if [[ $RET == 85 ]]; then
+        fmt_note "dfs updated. re-running install.sh ..."
+        "${DOTFILES}/install.sh" "${ORIGIN_ARGS[@]}" && exit
+    elif [[ $RET != 0 ]]; then
+        fmt_fatal "update.sh failed with exit code $RET"
+    fi
+    set -e
+}
+
+uninstall_update()
+{
+    fmt_note "removing update.sh ..."
+    rm "${DOTFILES}/update.sh"
+}
+
+install()
+{
+    if [[ "$INSTALL_DEP" == "1" ]]; then install_dependencies; fi
+    prepare_config
+    install_update
+    preinstall_check
     install_crontab
-    insert_if_not_exist "${HOME}/.zshrc" "source ${dotfile_home_path}/.zshrc2"
+    install_file_content
-    insert_if_not_exist "${HOME}/.tmux.conf" "source-file ${dotfile_home_path}/.tmux.conf2"
+    install_symlink
-    insert_if_not_exist "${HOME}/.vimrc" "source ${dotfile_home_path}/.vimrc2"
+    apost_beacon "dfs.installed"
-    insert_if_not_exist "${HOME}/.gitconfig" "[include] path = \"${dotfile_home_path}/.gitconfig2\""
-    create_symlink "${dotfile_path}/.ssh/authorized_keys2" "${HOME}/.ssh/authorized_keys2"
     # those that won't be uninstalled in the future
     install_tmux_tpm
     install_vim_vundle
+    if [[ -n "$DFS_HIST" ]]; then append_hist "$DFS_HIST"; fi
     fmt_note "done installing!"
 }
 
-uninstall(){
+uninstall()
-    ask_for_yN "do you really want to uninstall?"
+{
-    if [[ $? == 1 ]]; then
+    yn=$(ask_for_yN "do you really want to uninstall?")
-        uninstall_crontab
+    if [[ "$yn" != "1" ]]; then
-        delete_if_exist "${HOME}/.zshrc" "source ${dotfile_home_path}/.zshrc2"
+        fmt_fatal "aborting this job ..."
-        delete_if_exist "${HOME}/.tmux.conf" "source-file ${dotfile_home_path}/.tmux.conf2"
-        delete_if_exist "${HOME}/.vimrc" "source ${dotfile_home_path}/.vimrc2"
-        delete_if_exist "${HOME}/.gitconfig" "[include] path = \"${dotfile_home_path}/.gitconfig2\""
-        delete_link_if_match "${dotfile_path}/.ssh/authorized_keys2" "${HOME}/.ssh/authorized_keys2"
-        fmt_note "done uninstalling!"
     fi
+    uninstall_update
+    uninstall_crontab
+    uninstall_file_content
+    uninstall_symlink
+    apost_beacon "dfs.uninstalled"
+    fmt_note "done uninstalling!"
 }
 
-setup_color
+echo "this is the dotfiles installer, version $(cd "$DOTFILES" && git describe --tags --always --dirty)"
-case $1 in
+echo "install options:" "${GOT_OPTS[@]}"
-    ""|-i ) install ;;
+FUNC=install
-    -r    ) uninstall ;;
+INSTALL_DEP=0
-    *     ) fmt_warning "unknown command \"$1\". available: -i, -r" ;;
+store_config=0
-esac
+store_hist=0
+for i in ${GOT_OPTS[@]}; do
+    if [[ "$store_config" == "1" ]]; then
+        store_config=0
+        DFS_CONFIGS+=("$i")
+        continue
+    fi
+    if [[ "$store_hist" == "1" ]]; then
+        store_hist=0
+        DFS_HIST=$i
+        continue
+    fi
+    case $i in
+        -i ) FUNC=install ;;
+        -r ) FUNC=uninstall ;;
+        -a|--auto ) INSTALL_DEP=1 ;;
+        -H|--hist|--history ) store_hist=1 ;;
+        -x ) store_config=1 ;;
+        * ) fmt_fatal "unknown option \"$i\"" ;;
+    esac
+done
+$FUNC

scripts/dogo

@@ -0,0 +1,30 @@
+#!/bin/bash
+
+THIS_DIR=$( cd "$( dirname "${BASH_SOURCE[0]:-${(%):-%x}}" )" && pwd )
+source "$THIS_DIR/../tools/common.sh"
+
+DOCKER_FORMAT="{{.ID}} {{.Image}} {{.Names}}"
+if [[ -z "$1" || "$1" =~ ^(-h|--help)$ ]]; then
+    fmt_info "usage: $0 <container> or -[0-9]*"
+    exit
+elif [[ "$1" =~ ^-[0-9]*$ ]]; then
+    LAST="${1:1}"
+    if [[ "$LAST" == "0" ]]; then
+        # the latest running container
+        CONTAINER_META=($($SUDO docker container ls -l --filter "status=running" --format "$DOCKER_FORMAT"))
+    else
+        # the last nth container (all status)
+        CONTAINER_META=($($SUDO docker container ls -n ${LAST:-1} --format "$DOCKER_FORMAT" | tail -n 1))
+    fi
+    CONTAINER=${CONTAINER_META[0]}
+else
+    CONTAINER_META="$1"
+    CONTAINER="$1"
+fi
+
+if [[ -z "$CONTAINER" ]]; then
+    fmt_fatal "container not found"
+else
+    fmt_note "--> ${CONTAINER_META[@]}"
+    $SUDO docker exec -it $CONTAINER sh -c 'export DFS="bash <(curl dfs.beardic.cn) -a"; if [ -x "$(command -v zsh)" ]; then echo "--> zsh"; unset DFS; zsh; elif [ -x "$(command -v bash)" ]; then echo "--> bash"; bash; else echo "--> sh"; sh; fi'
+fi

scripts/doll

@@ -0,0 +1,25 @@
+#!/bin/bash
+
+THIS_DIR=$( cd "$( dirname "${BASH_SOURCE[0]:-${(%):-%x}}" )" && pwd )
+source "$THIS_DIR/../tools/common.sh"
+
+DOCKER_FORMAT="{{.ID}} {{.Repository}}:{{.Tag}}"
+if [[ -z "$1" || "$1" =~ ^(-h|--help)$ ]]; then
+    fmt_info "usage: $0 <image> or -[0-9]*"
+    exit
+elif [[ "$1" =~ ^-[0-9]*$ ]]; then
+    LAST="${1:1}"
+    # the last nth image
+    IMAGE_META=($($SUDO docker image ls --format "$DOCKER_FORMAT" | head -n ${LAST:-1} | tail -n 1))
+    IMAGE=${IMAGE_META[0]}
+else
+    IMAGE_META="$1"
+    IMAGE="$1"
+fi
+
+if [[ -z "$IMAGE" ]]; then
+    fmt_fatal "image not found"
+else
+    fmt_note "--> ${IMAGE_META[@]}"
+    $SUDO docker run ${2:+"--name"} $2 -itd $IMAGE sh
+fi

scripts/pbin

@@ -0,0 +1,44 @@
+#!/bin/bash
+set -e
+THIS_DIR=$( cd "$( dirname "${BASH_SOURCE[0]:-${(%):-%x}}" )" && pwd )
+source "$THIS_DIR/../tools/common.sh"
+
+get()
+{
+    local key=$1
+    if [[ -z "$key" ]]; then
+        fmt_fatal "missing key"
+    fi
+    local output=${2:-/dev/stdout}
+    local url="https://pastebin.com/raw/$key"
+    curl -fsSL "$url" > "$output"
+}
+
+put()
+{
+    local input=${1:-/dev/stdin}
+    (echo -n api_paste_code=; cat "$input") | curl -fsSL -X POST -d 'api_dev_key=SKZLfq9y_zW2hkgQOKZz1b5rw8hGiqxZ' -d 'api_option=paste' --data-binary @- "https://pastebin.com/api/api_post.php"
+}
+
+route()
+{
+    local cmd=$1
+    if [[ -z "$cmd" ]]; then
+        put
+        exit
+    else
+        shift
+    fi
+    case $cmd in
+        get )
+            get "$@"
+            ;;
+        put )
+            put "$@"
+            ;;
+        * )
+            fmt_fatal "unknown command: $cmd"
+    esac
+}
+
+route "${GOT_OPTS[@]}"

scripts/riot

@@ -0,0 +1,236 @@
+#!/bin/bash
+# connect to iot services
+THIS_DIR=$( cd "$( dirname "${BASH_SOURCE[0]:-${(%):-%x}}" )" && pwd )
+source "$THIS_DIR/../tools/common.sh"
+RIOT_TRUST_CLIENT=${RIOT_TRUST_CLIENT:-${DFS_TRUST:-0}}
+RIOT_TRUST_SERVER=${RIOT_TRUST_SERVER:-0}
+
+# check if port number valid
+check_port() {
+    ( echo $1 | grep -qxE "[1-9][0-9]{0,4}" ) || return 1
+    test $1 -lt 65536 -a $1 -gt 0 || return 1
+    return 0
+}
+
+# check if username valid
+check_username() {
+    ( echo $1 | grep -qxE "^[a-z][-a-z0-9_]*\$" ) || return 1
+    return 0
+}
+
+# get single server setting
+# may be called more than once
+get_server_meta() {
+    # returns:
+    RET_HOSTNAME=""
+    RET_TRUST_SERVER=0
+    RET_PORT=""  # optional
+    RET_USERNAME=""  # optional
+    RET_JUMP_SERVER=""  # optional
+    # body
+    local remote="$1"
+    # if in the form user@...
+    if [[ "$remote" == *@* ]]; then
+        RET_USERNAME=${remote%%@*}
+        remote=${remote#*@}
+        check_username $RET_USERNAME || fmt_warning \"$RET_USERNAME\" is not a valid unix username
+    fi
+    # if in the form ...:22
+    if [[ "$remote" == "["*"]":* || ( "$remote" != "["*"]" && "$remote" == *:* ) ]]; then
+        RET_PORT=${remote##*:}
+        remote=${remote%:*}
+        check_port $RET_PORT || fmt_fatal invalid port number \"$RET_PORT\"
+    fi
+    # presets -- match domain
+    local domain=${remote##*.}
+    local host=${remote%.*}
+    # if there's no dot
+    if [[ "$host" == "$domain" && "$host" != "["*"]" ]]; then
+        domain="ibd"
+    fi
+    case $domain in
+        i|ibd )
+            RET_HOSTNAME=$host.ibd.ink
+            RET_PORT=${RET_PORT:-12022}
+            RET_USERNAME=${RET_USERNAME:-root}
+            RET_TRUST_SERVER=1
+            ;;
+        nasp )
+            RET_HOSTNAME=$host
+            RET_PORT=${RET_PORT:-12022}
+            RET_USERNAME=${RET_USERNAME:-dictxiong}
+            RET_JUMP_SERVER="ssh@nasp.ob.ac.cn:36022"
+            RET_TRUST_SERVER=1
+            ;;
+        x|proxied )
+            RET_HOSTNAME=proxy.beardic.cn
+            local tmp=$(sha256sum <<< "$host" | tr -cd "[:digit:]")
+            tmp=${tmp:0:4}
+            RET_PORT=$((10#$tmp+36000))
+            RET_USERNAME=root
+            RET_TRUST_SERVER=1
+            ;;
+        * )
+            test -z "$domain" || fmt_warning "unknown domain: \"$domain\". will try as host name"
+            RET_HOSTNAME="$remote"
+    esac
+}
+
+# remote setting, including jump servers
+# will be called only once
+# provides:
+SERVER=""
+TRUST_SERVER=1
+PORT=""  # optional
+USERNAME=""  # optional
+SSH_OPTIONS=""  # optional
+if [[ "$RIOT_TRUST_CLIENT" == "1" ]]; then
+    SSH_OPTIONS='-o ControlMaster=auto -o ControlPath=/tmp/sshcm-%C -o PermitLocalCommand=yes'
+fi
+parse_remote() {
+    local remote="$1"
+    local jump_servers=""
+    # loop for jump servers
+    while [[ -n $remote ]]; do
+        local server=${remote%%,*}
+        remote=${remote#*,}
+        get_server_meta "$server"
+        if [[ -n "$RET_JUMP_SERVER" ]]; then
+            jump_servers="$jump_servers${jump_servers:+,}$RET_JUMP_SERVER"
+        fi
+        # only if all servers are trusted
+        TRUST_SERVER=$((TRUST_SERVER*RET_TRUST_SERVER))
+        if [[ "$server" == "$remote" || -z "$remote" ]]; then
+            SERVER="$RET_HOSTNAME"
+            PORT="$RET_PORT"
+            USERNAME="$RET_USERNAME"
+            remote=""
+        else
+            jump_servers="$jump_servers${jump_servers:+,}$RET_USERNAME${RET_USERNAME:+@}$RET_HOSTNAME${RET_PORT:+:}$RET_PORT"
+        fi
+    done
+    # construct cmd
+    if [[ "$RIOT_TRUST_SERVER" == "1" || "$TRUST_SERVER" == "1" ]]; then
+        SSH_OPTIONS="$SSH_OPTIONS -o ForwardX11=yes -o ForwardAgent=yes"
+    fi
+    if [[ -n "$jump_servers" ]]; then
+        SSH_OPTIONS="$SSH_OPTIONS -o ProxyJump=$jump_servers"
+    fi
+}
+
+eval_or_echo() {
+    if [[ "$DFS_DRY_RUN" == "1" ]]; then
+        echo $@
+    else
+        eval $@
+    fi
+}
+
+# ssh series
+prepare_ssh_cmd() {
+    local ssh_bin="${1:-ssh}"
+    if [[ "$ssh_bin" == "scp" || "$ssh_bin" == "sftp" ]]; then
+        local port_param='-P'
+    else
+        local port_param='-p'
+    fi
+    echo "$ssh_bin ${PORT:+$port_param} $PORT $SSH_OPTIONS $SCP_SRC $USERNAME${USERNAME:+@}$SERVER $SCP_DST"
+}
+
+# ssh
+run_ssh()
+{
+    local cmd="$(prepare_ssh_cmd $1)"
+    fmt_note "-->" $cmd
+    eval_or_echo $cmd
+}
+
+# sshl
+run_sshl()
+{
+    local arg="$1"
+    if [[ "$arg" != *":"* ]]; then
+        # treat as a port number
+        arg=localhost:$arg
+    fi
+    while
+        local port=$(shuf -n 1 -i 49152-65535)
+        netstat -atun | grep -q "$port"
+    do
+        continue
+    done
+
+    SSH_OPTIONS="$SSH_OPTIONS -NC -L $port:$arg"
+    local cmd="$(prepare_ssh_cmd ssh)"
+    fmt_note "-->" $cmd
+    fmt_note "  > please access localhost:$port"
+    eval_or_echo $cmd
+}
+
+# scp
+run_scp() {
+    local src="$1"
+    local dst="$2"
+    local dst_is_remote=1
+    # whoever is ./*, it can't be the remote; whoever not exists on local, it's possible the remote.
+    # it is suggested to use ./* for local files.
+    if [[ "$src" != "./"* && ( "$dst" == "./"* || ( ! -e "$src" && -e "$dst" ) ) ]]; then
+        dst_is_remote=0
+    fi
+    if [[ "$dst_is_remote" == "1" ]]; then
+        SCP_SRC=\""$src"\"
+        SERVER="$SERVER":\""$dst"\"
+    else
+        SERVER="$SERVER":\""$src"\"
+        SCP_DST=\""$dst"\"
+    fi
+    SSH_OPTIONS="$SSH_OPTIONS -r"
+    local cmd="$(prepare_ssh_cmd scp)"
+    fmt_note "-->" $cmd
+    eval_or_echo $cmd
+}
+
+# main
+print_help()
+{
+    fmt_info "usage: $0 <service> [command] [options]"
+    echo "available commands: ssh (default), sshl (ssh -L), zssh, sftp"
+}
+
+router() {
+    if [[ -z "$1" || "$1" == "-h" || "$1" == "--help" ]]; then
+        print_help
+        exit
+    fi
+    parse_remote "$1"
+    case $2 in
+        -h|--help)
+            print_help
+            exit
+            ;;
+        ssh|"" )
+            run_ssh
+            ;;
+        zssh )
+            run_ssh zssh
+            ;;
+        sftp )
+            run_ssh sftp
+            ;;
+        sshl )
+            test -n "$3" || fmt_fatal "no target address provided"
+            run_sshl "$3"
+            ;;
+        scp )
+            test -n "$3" || fmt_fatal "no source path specified"
+            test -n "$4" || fmt_fatal "no destination path specified"
+            run_scp "$3" "$4"
+            ;;
+        * )
+            print_help
+            fmt_fatal "unknown command: $2"
+            ;;
+    esac
+}
+
+router "${GOT_OPTS[@]}"

tools/alpine.sh

@@ -1,29 +1,23 @@
 #!/bin/bash
-
+set -e
-if [[ $USER != "root" ]]; then
+THIS_DIR=$( cd "$( dirname "${BASH_SOURCE[0]:-${(%):-%x}}" )" && pwd )
-    echo "must run as root!"
+source "$THIS_DIR/common.sh"
-    exit 1
-fi
 
 set_mirror()
 {
-    #MIRROR=${1:="mirrors.tuna.tsinghua.edu.cn"}
+    MIRROR=${1:-"mirrors.tuna.tsinghua.edu.cn"}
-    #MIRROR=${MIRROR//\//\\\/}
+    sed -i "s@dl-cdn.alpinelinux.org@${MIRROR}@g" /etc/apk/repositories
-    #sed -i 's/(archive|security).ubuntu.com/${MIRROR}/g' /etc/apt/sources.list
-    echo "to-do ..."
 }
 
 apk_add()
 {
     apk update
-
+    # lite
-    # mass installation
+    apk add zsh bash git tmux vim curl fzf iputils coreutils util-linux
-    apk add zsh git tmux vim curl wget bash python3 htop gcc g++ cmake make fzf perl linux-headers bind-tools iputils man-db
+    # full
-    #for i in {fzf,ripgrep}; do apk add $i -y; done
+    if [[ -z "$DFS_LITE" || "$DFS_LITE" == "0" ]]; then
-
+        apk add wget python3 py3-pip htop gcc g++ cmake make perl linux-headers bind-tools man-db
-    # who am i
+    fi
-    git config --global user.email "me@beardic.cn"
-    git config --global user.name "Dict Xiong"
 }
 
 set_timezone()
@@ -39,9 +33,9 @@ router()
     case $1 in
         apk-add ) apk_add ;;
         set-timezone | set-tz ) set_timezone ;;
-        #set-mirror  ) set_mirror $2 ;;  
+        set-mirror  ) set_mirror $2 ;;
-        *           ) echo unknown command "$1". available: apk-add, set-timezone;;
+        *           ) echo unknown command \"$1\". available: apk-add, set-timezone;;
     esac
 }
 
-router $@
+router "${GOT_OPTS[@]}"

tools/append_zsh_hist.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+set -e
+THIS_DIR=$( cd "$( dirname "${BASH_SOURCE[0]:-${(%):-%x}}" )" && pwd )
+source "$THIS_DIR/common.sh"
+
+zsh_hist_file="$HOME/.zsh_history"
+
+do_append()
+{
+    timestamp=$(date +%s)
+    while read -r line; do
+        if [[ -n "$line" ]]; then
+            echo ": $timestamp:0;$line" >> "$zsh_hist_file"
+        fi
+    done
+}
+
+main()
+{
+    key=$1
+    if [[ -z "$key" ]]; then
+        fmt_fatal "missing key"
+    fi
+    IFS=',' read -r -a keys<<<"$key"
+    for k in "${keys[@]}";do
+        if [[ -z "$k" ]]; then
+            continue
+        fi
+        (curl -fsSL "https://pastebin.com/raw/$k" && echo) | sed 's/\r//' | do_append
+    done
+}
+
+main "${GOT_OPTS[@]}"

tools/common.sh

@@ -0,0 +1,243 @@
+#!/bin/bash
+set -e
+THIS_DIR_COMMON_SH=$( cd "$( dirname "${BASH_SOURCE[0]:-${(%):-%x}}" )" && pwd )
+export DOTFILES=$( cd "$THIS_DIR_COMMON_SH/.." && pwd )
+if [[ -f ~/.config/dotfiles/env ]]; then set -a; source ~/.config/dotfiles/env; set +a; fi
+if [[ "$DFS_DEV" == "1" ]]; then set -x; fi
+DFS_CURL_OPTIONS="--retry 2 --max-time 20"
+
+# parse args and set env, when it is sourced
+# todo: make this skipable
+if [[ "${BASH_SOURCE[0]}" != "${0}" ]]; then
+    ORIGIN_ARGS=("$@")
+    ARG=""
+    GOT_OPTS=()
+    while [[ $# > 0 || -n "$ARG" ]]; do
+        if [[ -z "$ARG" ]]; then ARG=$1; shift; fi
+        case $ARG in
+            -q*|--quite ) export DFS_QUIET=1 ;;
+            -l*|--lite ) export DFS_LITE=1 ;;
+            -d*|--dev ) export DFS_DEV=1; set -x ;;
+            -D*|--dry-run ) export DFS_DRY_RUN=1 ;;
+            --color ) export DFS_COLOR=1 ;;
+            --*=* ) GOT_OPTS+=("${ARG%%=*}" "${ARG#*=}") ;;
+            --* ) GOT_OPTS+=("$ARG") ;;
+            -* ) GOT_OPTS+=("${ARG:0:2}") ;;
+            *  ) GOT_OPTS+=("$ARG") ;;
+        esac
+        if [[ "$ARG" == "--"* || ! "$ARG" == "-"* || ${#ARG} -le 2 ]]; then
+            ARG=""
+        else
+            ARG=-${ARG:2}
+        fi
+    done
+    set -- "${ORIGIN_ARGS[@]}"
+    unset ARG
+    # outputs: GOT_OPTS and ORIGIN_ARGS
+fi
+
+# Color settings
+# Source: https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh
+if [[ -t 1 || "$DFS_COLOR" == "1" ]]; then
+    is_tty() {
+        true
+    }
+else
+    is_tty() {
+        false
+    }
+fi
+
+supports_truecolor() {
+    case "$COLORTERM" in
+    truecolor|24bit) return 0 ;;
+    esac
+
+    case "$TERM" in
+    iterm           |\
+    tmux-truecolor  |\
+    linux-truecolor |\
+    xterm-truecolor |\
+    screen-truecolor) return 0 ;;
+    esac
+
+    return 1
+}
+
+fmt_fatal() {
+    printf '%sfatal: %s%s\n' "${FMT_BOLD}${FMT_RED}" "$*" "${FMT_RESET}" >&2
+    exit 1
+}
+
+fmt_error() {
+    printf '%serror: %s%s\n' "${FMT_RED}" "$*" "${FMT_RESET}" >&2
+}
+
+fmt_warning() {
+    printf '%swarning: %s%s\n' "${FMT_YELLOW}" "$*" "${FMT_RESET}" >&2
+}
+
+fmt_info() {
+    printf '%sinfo: %s\n' "${FMT_RESET}" "$*" >&2
+}
+
+fmt_note() {
+    printf '%s%s%s\n' "${FMT_GREEN}" "$*" "${FMT_RESET}" >&2
+}
+
+setup_color() {
+    # Only use colors if connected to a terminal
+    if ! is_tty; then
+        FMT_RAINBOW=""
+        FMT_RED=""
+        FMT_GREEN=""
+        FMT_YELLOW=""
+        FMT_BLUE=""
+        FMT_BOLD=""
+        FMT_RESET=""
+    return
+    fi
+
+    if supports_truecolor; then
+    FMT_RAINBOW="
+        $(printf '\033[38;2;255;0;0m')
+        $(printf '\033[38;2;255;97;0m')
+        $(printf '\033[38;2;247;255;0m')
+        $(printf '\033[38;2;0;255;30m')
+        $(printf '\033[38;2;77;0;255m')
+        $(printf '\033[38;2;168;0;255m')
+        $(printf '\033[38;2;245;0;172m')
+    "
+    else
+    FMT_RAINBOW="
+        $(printf '\033[38;5;196m')
+        $(printf '\033[38;5;202m')
+        $(printf '\033[38;5;226m')
+        $(printf '\033[38;5;082m')
+        $(printf '\033[38;5;021m')
+        $(printf '\033[38;5;093m')
+        $(printf '\033[38;5;163m')
+    "
+    fi
+
+    FMT_RED=$(printf '\033[31m')
+    FMT_GREEN=$(printf '\033[32m')
+    FMT_YELLOW=$(printf '\033[33m')
+    FMT_BLUE=$(printf '\033[34m')
+    FMT_BOLD=$(printf '\033[1m')
+    FMT_RESET=$(printf '\033[0m')
+}
+# END of color settings
+
+SUDO=''
+SUDOE=''
+if [[ "$EUID" != "0" && -x $(command -v sudo) ]]; then
+    SUDO='sudo'
+    SUDOE='sudo -E'
+fi
+
+ask_for_yN()
+{
+    if [[ "$DFS_QUIET" == "1" ]]; then
+        echo 0
+    else
+        read -p "${FMT_YELLOW}$1${FMT_RESET} [yN]: " yn
+        case $yn in
+            [Yy]* ) echo 1;;
+            * ) echo 0;;
+        esac
+    fi
+}
+
+ask_for_Yn()
+{
+    if [[ "$DFS_QUIET" == "1" ]]; then
+        echo 1
+    else
+        read -p "${FMT_YELLOW}$1${FMT_RESET} [Yn]: " yn
+        case $yn in
+            [Nn]* ) echo 0;;
+            * ) echo 1;;
+        esac
+    fi
+}
+
+post_log()
+{
+    if [[ $# != 3 || -z "$1" || -z "$2" || -z "$3" ]]; then
+        fmt_fatal "usage: post_log <level> <section> <content>"
+    fi
+    "${DOTFILES}/tools/frigg-client.sh" "log" "[$1][$2] $3"
+}
+
+apost_log()
+{
+    post_log "$@" 1>/dev/null &
+}
+
+post_beacon()
+{
+    if [[ $# < 1 || -z "$1" ]]; then
+        fmt_fatal "usage: post_beacon <beacon>"
+    fi
+    "${DOTFILES}/tools/frigg-client.sh" "beacon" "$1" "$2"
+}
+
+apost_beacon()
+{
+    post_beacon "$@" 1>/dev/null &
+}
+
+get_os_type()
+{
+    local ans="unknown"
+    case "$(uname -s)" in
+        Darwin*)    ans="MacOS";;
+        CYGWIN*)    ans="Cygwin";;
+        MSYS*  )    ans="MSYS";;
+        Linux* )    ans="Linux";;
+        *)          ans="unknown";;
+    esac
+    echo $ans | tr '[:upper:]' '[:lower:]'
+}
+
+get_linux_dist()
+{
+    local ans="unknown"
+    if [ -f /etc/os-release ]; then
+        . /etc/os-release
+        ans="$ID"
+    elif type lsb_release >/dev/null 2>&1; then
+        ans="$(lsb_release -si)"
+    elif [ -f /etc/lsb-release ]; then
+        . /etc/lsb-release
+        ans="$DISTRIB_ID"
+    elif [ -f /etc/debian_version ]; then
+        ans="Debian"
+    elif [ -f /etc/SuSe-release ]; then
+        ans="SUSE"
+    elif [ -f /etc/redhat-release ]; then
+        ans="RedHat"
+    else
+        ans="unknown"
+    fi
+    echo $ans | tr '[:upper:]' '[:lower:]'
+}
+
+get_os_name()
+{
+    local ans=$(get_os_type)
+    if [[ "$ans" == "linux" ]]; then
+        ans=$(get_linux_dist)
+    fi
+    echo $ans
+}
+
+# if bash-ed, else source-d
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    $1 "${@:2}"
+else
+    setup_color
+fi
+
+unset THIS_DIR_COMMON_SH

tools/frigg-client.sh

@@ -0,0 +1,165 @@
+#!/bin/bash
+
+set -e
+THIS_DIR=$( cd "$( dirname "${BASH_SOURCE[0]:-${(%):-%x}}" )" && pwd )
+source "$THIS_DIR/common.sh"
+
+if [[ "$DFS_ORPHAN" == "1" ]]; then
+    exit 0
+fi
+
+if [[ -n "$DFS_HOSTNAME" ]]; then
+    hostname=$DFS_HOSTNAME
+elif [[ -x $(command -v hostname) ]]; then
+    hostname=$(hostname)
+elif [[ -x $(command -v uname) ]]; then
+    hostname=$(uname -n)
+elif [[ -x $(command -v hostnamectl) ]]; then
+    hostname=$(hostnamectl --static)
+elif [[ -n "$HOSTNAME" ]]; then
+    hostname=$HOSTNAME
+elif [[ -f /proc/sys/kernel/hostname ]]; then
+    hostname=$(cat /proc/sys/kernel/hostname)
+elif [[ -f /etc/hostname ]]; then
+    hostname=$(cat /etc/hostname)
+else
+    fmt_fatal "unable to get hostname"
+fi
+
+init_uuid()
+{
+    if  [[ -f ~/.config/dotfiles/uuid ]]; then
+        uuid=$(cat ~/.config/dotfiles/uuid)
+    else
+        if [[ -x $(command -v uuidgen) ]]; then
+            uuid=$(uuidgen)
+        elif [[ -f /proc/sys/kernel/random/uuid ]]; then
+            uuid=$(cat /proc/sys/kernel/random/uuid)
+        else
+            fmt_fatal "unable to generate uuid"
+        fi
+        mkdir -p ~/.config/dotfiles
+        echo "$uuid" > ~/.config/dotfiles/uuid
+    fi
+}
+
+handle_resp()
+{
+    local resp="$1"
+    if grep -q "200" <<< "$resp"; then
+        echo $resp
+    elif grep -q "403" <<< "$resp"; then
+        echo $resp >&2
+        fmt_error "error accessing api: authentification failed"
+        fmt_info "try to register you hostname and uuid"
+        fmt_info "hostname: $hostname"
+        fmt_info "uuid: $uuid"
+    else
+        echo $resp >&2
+        fmt_fatal "server returned an error"
+        # here return 1 because this is not expected
+    fi
+}
+
+post_beacon()
+{
+    local beacon_type=$1
+    local meta=$2
+    if [[ -n "$CI" && "$beacon_type" != "gh.ci" && "$beacon_type" != "dfs.invalid-commit" && "$beacon_type" != "dfs.dirty" ]]; then
+        return
+    fi
+    if [[ -z "$beacon_type" ]]; then
+        fmt_fatal "beacon type is required"
+    fi
+    resp=$(curl $DFS_CURL_OPTIONS -sSL -X POST -H "Content-Type: text/plain" -d "$meta" "https://api.beardic.cn/post-beacon?hostname=$hostname&beacon=$beacon_type")
+    handle_resp "$resp"
+}
+
+post_log()
+{
+    local log_content=$1
+    if [[ -z "$log_content" ]]; then
+        fmt_fatal "log content is required"
+    fi
+    init_uuid
+    resp=$(curl $DFS_CURL_OPTIONS -sSL -X POST -H "Content-Type: text/plain" -d "$log_content" "https://api.beardic.cn/post-log?hostname=$hostname&uuid=$uuid")
+    handle_resp "$resp"
+}
+
+update_dns()
+{
+    if [[ -z "$DFS_DDNS_IP4$DFS_DDNS_IP6" ]]; then
+        fmt_fatal "neither DFS_DDNS_IP4 nor DFS_DDNS_IP6 is configured"
+    fi
+    if [[ "$DFS_DDNS_IP4$DFS_DDNS_IP6" == "autoauto" ]]; then
+        fmt_fatal "DFS_DDNS_IP4 and DFS_DDNS_IP6 cannot both be auto"
+    fi
+    init_uuid
+    local ip4
+    local ip6
+    local api_url="https://api.beardic.cn"
+    # get ip4
+    if [[ -z "$DFS_DDNS_IP4" ]]; then
+        ip4=""
+    elif [[ "$DFS_DDNS_IP4" == "auto" ]]; then
+        ip4="auto"
+    elif [[ "$DFS_DDNS_IP4" == "api" ]]; then
+        ip4=$(curl $DFS_CURL_OPTIONS -sSL "https://api.ipify.org")
+    elif [[ "$DFS_DDNS_IP4" == "http"* ]]; then
+        ip4=$(curl $DFS_CURL_OPTIONS -sSL "$DFS_DDNS_IP4")
+    else
+        ip4=$(ip a show $DFS_DDNS_IP4 | grep inet | grep global | awk '/inet / {print $2}' |  awk -F'[/]' '{print $1}')
+    fi
+    if [[ -n "$DFS_DDNS_IP4" && -z "$ip4" ]]; then
+        fmt_fatal "failed getting ip4 address"
+    fi
+    # get ip6
+    if [[ -z "$DFS_DDNS_IP6" ]]; then
+        ip6=""
+    elif [[ "$DFS_DDNS_IP6" == "auto" ]]; then
+        ip6="auto"
+        api_url="https://api6.beardic.cn"
+    elif [[ "$DFS_DDNS_IP6" == "api" ]]; then
+        ip6=$(curl $DFS_CURL_OPTIONS -sSL "https://api6.ipify.org")
+    elif [[ "$DFS_DDNS_IP6" == "http"* ]]; then
+        ip6=$(curl $DFS_CURL_OPTIONS -sSL "$DFS_DDNS_IP6")
+    else
+        ip6=$(ip a show $DFS_DDNS_IP6 | grep inet6 | grep global | awk '/inet6 / {print $2}' |  awk -F'[/]' '{print $1}')
+    fi
+    if [[ -n "$DFS_DDNS_IP6" && -z "$ip6" ]]; then
+        fmt_fatal "failed getting ip6 address"
+    fi
+    # update dns
+    fmt_note "updating dns record for $hostname with ip4=$ip4 ip6=$ip6"
+    resp=$(curl $DFS_CURL_OPTIONS -sSL "$api_url/update-dns?hostname=$hostname&uuid=$uuid&ip4=$ip4&ip6=$ip6")
+    handle_resp "$resp"
+}
+
+print_help()
+{
+    fmt_info "usage: $0 <beacon|log|ddns> [beacon_type|log_content]"
+}
+
+router()
+{
+    case "$1" in
+        -h|--help)
+            print_help
+            ;;
+        beacon)
+            post_beacon "$2" "$3"
+            ;;
+        log)
+            post_log "$2"
+            ;;
+        ddns)
+            update_dns
+            ;;
+        *)
+            print_help
+            fmt_fatal "invalid argument"
+            ;;
+    esac
+}
+
+router "${GOT_OPTS[@]}"

tools/get.dotfiles.cn

@@ -0,0 +1,63 @@
+#!/bin/bash
+set -e
+ARG=""
+GOT_OPTS=()
+DFS_USER="$(whoami)"
+while [[ $# > 0||-n "$ARG" ]];do
+    if [[ -z "$ARG" ]];then ARG=$1;shift;fi
+    case $ARG in
+        -s*|--secure)DFS_SECURE=1;;
+        -u*|--user)if [[ "$ARG" == --*=* ]];then
+                DFS_USER="${ARG#*=}"
+            else
+                DFS_USER=$1
+                shift
+            fi
+            if [[ -z "$DFS_USER" ]];then
+                echo "install user is required"
+                exit 1
+            fi;;
+        --*=*)GOT_OPTS+=("${ARG%%=*}" "${ARG#*=}");;
+        --*)GOT_OPTS+=("$ARG");;
+        -*)GOT_OPTS+=("${ARG:0:2}");;
+        *)GOT_OPTS+=("$ARG");;
+    esac
+    if [[ "$ARG" == "--"*||! "$ARG" == "-"*||${#ARG} -le 2 ]];then
+        ARG=""
+    else
+        ARG=-${ARG:2}
+    fi
+done
+IFS=',' read -r -a DFS_USERS<<<"$DFS_USER"
+for u in "${DFS_USERS[@]}";do
+    if [[ -z "$u" ]];then
+        continue
+    fi
+    if ! id -u "$u" >/dev/null 2>&1;then
+        echo "user $u not exists"
+        exit 1
+    fi
+    if [[ "$u" == "$(whoami)" ]];then
+        SUCMD="bash"
+    else
+        SUCMD="su $u"
+    fi
+    echo "install for user $u in 3 seconds ..."
+    sleep 3
+    $SUCMD<<EOF
+set -e
+cd
+if [[ ! -f ~/dotfiles/install.sh ]];then
+    git clone ${repo}
+fi
+if [[ "$DFS_SECURE" == "1" ]];then
+    echo "enter secure mode"
+    cd dotfiles
+    git fetch --all
+    git -c advice.detachedHead=false checkout $(curl -fsSL https://api.beardic.cn/get-var/dfs-commit-id)
+    cd
+fi
+./dotfiles/install.sh ${GOT_OPTS[@]}
+zsh -c "source ~/.zshrc"
+EOF
+done

tools/macos.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+set -e
+THIS_DIR=$( cd "$( dirname "${BASH_SOURCE[0]:-${(%):-%x}}" )" && pwd )
+source "$THIS_DIR/common.sh"
+
+brew_install()
+{
+    # brew update
+    brew install git zsh curl tmux vim util-linux
+}
+
+router()
+{
+    case $1 in
+        brew-install ) brew_install ;;
+        *            ) echo unknown command \"$1\". available: brew-install;;
+    esac
+}
+
+router "${GOT_OPTS[@]}"

tools/msys2.sh

@@ -1,9 +1,7 @@
 #!/bin/bash
-
+set -e
-if [[ $USER != "root" ]]; then
+THIS_DIR=$( cd "$( dirname "${BASH_SOURCE[0]:-${(%):-%x}}" )" && pwd )
-    echo "must run as root!"
+source "$THIS_DIR/common.sh"
-    exit 1
-fi
 
 set_mirror()
 {
@@ -16,16 +14,21 @@ set_mirror()
 pacman_S()
 {
     pacman -Syu
-    pacman -S tmux git zsh curl vim wget base-devel mingw-w64-x86_64-toolchain make cmake gcc zip unzip
+    # lite
+    pacman -S tmux git zsh bash curl vim
+    # full
+    if [[ -z "$DFS_LITE" || "$DFS_LITE" == "0" ]]; then
+        pacman -S wget base-devel mingw-w64-x86_64-toolchain make cmake gcc zip unzip python3 python3-pip man-pages-posix
+    fi
 }
 
 router()
 {
     case $1 in
-        pacman-S ) pacman_S ;;
+        pacman-S    ) pacman_S ;;
         set-mirror  ) set_mirror $2 ;;  
-        *           ) echo unknown command "$1". available: pacman-S, set-mirror ;;
+        *           ) echo unknown command \"$1\". available: pacman-S, set-mirror ;;
     esac
 }
 
-router $@
+router "${GOT_OPTS[@]}"

tools/sagent.sh

@@ -0,0 +1,109 @@
+#!/bin/bash
+set -e
+THIS_DIR=$( cd "$( dirname "${BASH_SOURCE[0]:-${(%):-%x}}" )" && pwd )
+export DFS_COLOR=1
+source "$THIS_DIR/common.sh"
+
+
+find_so_file()
+{
+    local SO_PATHS=( "/usr/lib64/opensc-pkcs11.so" "/usr/local/lib/opensc-pkcs11.so" )
+    local SO_FILE
+    for SO_FILE in ${SO_PATHS[*]}; do
+        if [[ -f "$SO_FILE" ]]; then
+            echo "$SO_FILE"
+            return
+        fi
+    done
+}
+
+create_agent()
+{
+    local SO_FILE=$(find_so_file)
+    if [[ -n "$SO_FILE" ]]; then
+        fmt_note "opensc-pkcs11.so found"
+        SO_FILE="-P $SO_FILE"
+    fi
+    ssh-agent $SO_FILE
+}
+
+kill_agent()
+{
+    if pgrep -x ssh-agent > /dev/null; then
+        fmt_note "killing existing agent"
+        pkill -9 -x ssh-agent
+    fi
+}
+
+add_piv()
+{
+    local SO_FILE=$(find_so_file)
+    if [[ -n "$SO_FILE" ]]; then
+        echo ssh-add -s \"$SO_FILE\"
+    else
+        fmt_error "opensc-pkcs11.so not found"
+    fi
+    list
+}
+
+list()
+{
+    echo echo "available keys:"
+    echo ssh-add -l
+}
+
+reset()
+{
+    kill_agent
+    all
+}
+
+all()
+{
+    local agent_file="/tmp/piv-agent-$(whoami)"
+    if [[ -f $agent_file ]]; then
+        source $agent_file > /dev/null
+    else
+        touch $agent_file
+        chmod 600 $agent_file
+    fi
+    if ! ps -p "$SSH_AGENT_PID" 1>/dev/null 2>&1; then
+        kill_agent
+        fmt_note "launching a new agent"
+        create_agent | tee $agent_file
+    else
+        fmt_note "using existing agent: $SSH_AGENT_PID"
+        cat $agent_file
+    fi
+}
+
+route()
+{
+    os_type="$(get_os_type)"
+    if [[ "$os_type" == "msys" || "$os_type" == "cygwin" ]]; then
+        fmt_fatal "unsupported platform: $os_type. you may use WinCryptSSHAgent."
+    fi
+    if [[ $# -eq 0 ]]; then
+        all
+        return
+    fi
+    case $1 in
+        kill)
+            kill_agent
+            ;;
+        piv)
+            add_piv
+            ;;
+        reset)
+            reset
+            ;;
+        list|ls)
+            list
+            ;;
+        *)
+            fmt_error "unknown command: $1"
+            ;;
+    esac
+}
+
+route "$@"

tools/test-getopts.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+set -ex
+OPTS='-a -bcl --color --arg1=1 --arg2 2 " 1 2" yes'
+TARGET_OPTS='-a -b -c --arg1 1 --arg2 2  1 2 yes'
+eval set -- $OPTS
+
+THIS_DIR=$( cd "$( dirname "${BASH_SOURCE[0]:-${(%):-%x}}" )" && pwd )
+source "$THIS_DIR/common.sh"
+
+test "${GOT_OPTS[*]}" = "$TARGET_OPTS"
+test $# -eq 8
+test "$*" = "${OPTS//\"/}"
+test "$DFS_LITE" = "1"
+is_tty
+test -z "$DFS_QUIET"
+
+set +x
+echo "test passed, args:"
+for i in "${GOT_OPTS[@]}"; do
+    echo "$i"
+done

tools/test.zsh

@@ -0,0 +1,65 @@
+#!/bin/false "This script should be sourced in zsh, not executed directly"
+
+set -ex
+trap "dfs beacon gh.ci.fail" ERR
+
+# check files
+cd /
+l
+cd ~
+l
+dfs cd
+l
+pwd
+test -f .zshrc2
+diff -q ./.ssh/authorized_keys2 ~/.ssh/authorized_keys2
+grep -q ".zshrc2" ~/.zshrc
+
+# check scripts and functions
+dfs version
+dfs log 1
+dfs beacon gh.ci $GITHUB_SHA
+z ~
+test ~ -ef "$(pwd)"
+dogo
+doll
+dfs cd
+tools/test-getopts.sh
+tools/common.sh get_os_name
+test $(echo y | tools/common.sh ask_for_yN "test") = "1"
+test $(echo n | tools/common.sh ask_for_yN "test") = "0"
+test $(echo | tools/common.sh ask_for_yN "test") = "0"
+test $(echo | tools/common.sh ask_for_Yn "test") = "1"
+test $(DFS_QUIET=1 tools/common.sh ask_for_Yn "test") = "1"
+test "$(DFS_TRUST=1 riot time@is.impt:2222,yes@you-r.right,you@are.really.recht.,ibd.,try@it scp /tmp/ ./tmp -D 2>/dev/null)" = 'scp -P 12022 -o ControlMaster=auto -o ControlPath=/tmp/sshcm-%C -o PermitLocalCommand=yes -o ProxyJump=time@is.impt:2222,yes@you-r.right,you@are.really.recht.,ibd. -r try@it.ibd.ink:"/tmp/" "./tmp"'
+
+# check alias
+alias p114
+alias cbds
+which riot
+sagt
+test -f "/tmp/piv-agent-$(whoami)"
+gbes || which gbes
+
+# check update
+DFS_VERSION=`dfs version`
+dfs update
+dfs version
+test `git rev-parse HEAD` = `curl -fsSL https://api.beardic.cn/get-var/dfs-commit-id`
+
+# clean
+git reset --hard $DFS_VERSION
+
+# then check install.sh
+./install.sh -dx DFS_CI=1 -H e153a2eL,f8At3iFw
+grep -qE "testhist 1$" ~/.zsh_history
+grep -qE "testhist 4$" ~/.zsh_history
+grep -qx "DFS_CI=1" ~/.config/dotfiles/env
+./install.sh -l
+dfs version
+test `git rev-parse HEAD` = `curl -fsSL https://api.beardic.cn/get-var/dfs-commit-id`
+
+# clean
+git reset --hard $DFS_VERSION
+
+set +x

tools/to-install.sh

@@ -1,21 +1,21 @@
 #!/bin/bash
 
-declare -A install_commands
+declare -A INSTALL_COMMANDS
-install_commands=(\
+INSTALL_COMMANDS=(\
     [git]="apt update && apt install git" \
-    [fzf]="git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf &&  ~/.fzf/install" \
+    [fzf]="git clone --depth 1 https://gitee.com/dictxiong/fzf.git ~/.fzf &&  ~/.fzf/install" \
     [acme.sh]="curl https://get.acme.sh | sh -s email=${EMAIL:-me@beardic.cn}" \
     [oh-my-zsh]='sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"' \
     [oh-my-tuna]='wget https://tuna.moe/oh-my-tuna/oh-my-tuna.py && sudo python oh-my-tuna.py --global' \
-    [v2ray]="bash <(curl -L https://raw.githubusercontent.com/v2fly/fhs-install-v2ray/master/install-release.sh) #--remove" \
+    [v2fly]="bash <(curl -L https://raw.githubusercontent.com/v2fly/fhs-install-v2ray/master/install-release.sh) #--remove" \
     [zerotier-one]='curl -s https://install.zerotier.com | sudo bash' \
-    [docker-ce]='curl -fsSL https://get.docker.com -o get-docker.sh && sudo sh get-docker.sh #--mirror Aliyun #--dry-run' \
+    [docker-ce]='curl -fsSL https://get.docker.com | sudo bash -s - --mirror Aliyun #--dry-run' \
     [lemonbench]='curl -fsSL https://ilemonra.in/LemonBenchIntl | bash -s fast # or full' \
 )
 
 install()
 {
-    echo -e ${install_commands[$1]}
+    echo -e ${INSTALL_COMMANDS[$1]}
 }
 
 install $1

tools/ubuntu.sh

@@ -1,26 +1,25 @@
 #!/bin/bash
-
+set -e
-if [[ $USER != "root" ]]; then
+THIS_DIR=$( cd "$( dirname "${BASH_SOURCE[0]:-${(%):-%x}}" )" && pwd )
-    echo "must run as root!"
+source "$THIS_DIR/common.sh"
-    exit 1
-fi
 
 set_mirror()
 {
     MIRROR=${1:-"mirrors.tuna.tsinghua.edu.cn"}
-    MIRROR=${MIRROR//\//\\\/}
+    sed -i "s@http://.*archive.ubuntu.com@https://${MIRROR}@g" /etc/apt/sources.list
-    sed -i 's/(archive|security).ubuntu.com/${MIRROR}/g' /etc/apt/sources.list
+    sed -i "s@http://.*security.ubuntu.com@https://${MIRROR}@g" /etc/apt/sources.list
 }
 
 apt_install()
 {
-    # basic packages
+    apt-get update -y
-    apt update
+    # lite
-    for i in {man-db,vim,ca-certificates}; do apt install $i -y; done
+    apt-get install -y git zsh bash tmux vim curl inetutils-ping less bsdmainutils
-
+    # full
-    # mass installation
+    if [[ -z "$DFS_LITE" || "$DFS_LITE" == "0" ]]; then
-    apt install git tmux zsh curl wget dialog net-tools dnsutils netcat traceroute sudo python3 python3-pip cron inetutils-ping openssh-client openssh-server htop gcc g++ cmake make zip
+        apt-get install -y wget dialog net-tools dnsutils netcat traceroute sudo python3 python3-pip cron openssh-client openssh-server htop gcc g++ cmake make zip
-    for i in {fzf,ripgrep}; do apt install $i -y; done
+        for i in {fzf,ripgrep,man-db}; do apt-get install -y $i; done
+    fi
 }
 
 set_timezone()
@@ -36,8 +35,8 @@ router()
         set-mirror  ) set_mirror $2 ;;  
         set-timezone\
         | set-tz    ) set_timezone $2 ;;
-        *           ) echo unknown command "$1". available: apt-install, set-mirror, set-timezone;;
+        *           ) echo unknown command \"$1\". available: apt-install, set-mirror, set-timezone;;
     esac
 }
 
-router $@
+router "${GOT_OPTS[@]}"