easy-command 2.0.2 → 2.0.5

package/README.md

@@ -10,10 +10,18 @@ Configure a polished Zsh terminal in one command.
 
 ## INSTALL
 
-### npm
+### npm (recommended)
 
 ```bash
-npx easy-command -y
+npm i -g easy-command
+easy-command -y
+```
+
+Or install globally and configure your terminal in one command:
+
+```bash
+npx easy-command -y --global
+exec zsh -l
 ```
 
 ### GitHub
@@ -34,19 +42,19 @@ exec zsh -l
 
 ```bash
 # Preview installation without changing your machine
-npx easy-command --dry-run
+easy-command --dry-run
 
 # Check Shell, dependencies, managed repositories, and .zshrc configuration
-npx easy-command doctor
+easy-command doctor
 
 # Restore missing managed files and configuration
-npx easy-command repair -y
+easy-command repair -y
 
 # Safely update Oh My Zsh and managed plugins
-npx easy-command update -y
+easy-command update -y
 ```
 
-`npx` runs the command without a global npm installation. If you prefer the shorter `easy-command` command, install it globally with `npm install -g easy-command`.
+If you do not want a global npm installation, replace `easy-command` in the examples with `npx easy-command`.
 
 ## What you get
 
@@ -83,11 +91,13 @@ bash install.sh -y --no-chsh
 # Remove only the configuration block managed by easy-command
 bash install.sh --uninstall
 
-# Enable optional directory jumping, fuzzy search, and Git aliases
-bash install.sh -y --with-zoxide --with-fzf --with-git-aliases
+# Enable optional fuzzy search and Git aliases
+bash install.sh -y --with-fzf --with-git-aliases
 ```
 
-`zoxide` enables `z <keyword>` directory jumping. `fzf` adds fuzzy history and file searching. Git aliases use the non-conflicting `ec-` prefix, such as `git ec-status`; existing aliases are never overwritten.
+`zoxide` is installed by default. It enables `z <keyword>` directory jumping and `z add <directory>` (or `z a <directory>`) for manually recording a directory. Use `--without-zoxide` to disable it. `fzf` adds fuzzy history and file searching. Git aliases use the non-conflicting `ec-` prefix, such as `git ec-status`; existing aliases are never overwritten.
+
+For a unified interface, use `ec <keyword>` to jump, `ec add <directory>` (or `ec a <directory>`) to record a directory, `ec list` (or `ec l`) to view entries, and `ec del <directory>` (or `ec remove <directory>`) to remove one. `ec doctor`, `ec repair`, `ec update`, `ec install`, `ec uninstall`, and `ec --dry-run` run the matching easy-command maintenance operation. `z` remains available for zoxide compatibility.
 
 ## Requirements
 
@@ -121,13 +131,13 @@ bash install.sh -y
 For production, pin a release tag instead of running `main` directly:
 
 ```bash
-npx easy-command@2.0.2 -y
+npx easy-command@2.0.5 -y
 ```
 
 Or, without npm:
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/UnionSchool/easy-command/v2.0.2/install.sh | bash -s -- -y
+curl -fsSL https://raw.githubusercontent.com/UnionSchool/easy-command/v2.0.5/install.sh | bash -s -- -y
 ```
 
 ## License

package/README_CN.md

@@ -10,10 +10,18 @@
 
 ## 安装
 
-### npm 安装
+### npm 安装（推荐）
 
 ```bash
-npx easy-command -y
+npm i -g easy-command
+easy-command -y
+```
+
+也可以一条命令完成全局安装和终端配置：
+
+```bash
+npx easy-command -y --global
+exec zsh -l
 ```
 
 ### GitHub 安装
@@ -34,19 +42,19 @@ exec zsh -l
 
 ```bash
 # 预览安装过程，不修改本机环境
-npx easy-command --dry-run
+easy-command --dry-run
 
 # 检查 Shell、依赖、托管仓库和 .zshrc 配置
-npx easy-command doctor
+easy-command doctor
 
 # 恢复缺失的托管文件和配置
-npx easy-command repair -y
+easy-command repair -y
 
 # 安全更新 Oh My Zsh 和托管插件
-npx easy-command update -y
+easy-command update -y
 ```
 
-`npx` 无需全局安装即可运行命令。若希望直接使用更短的 `easy-command` 命令，可执行 `npm install -g easy-command`。
+如不希望全局安装 npm 包，将示例中的 `easy-command` 替换为 `npx easy-command` 即可。
 
 ## 安装后即可使用
 
@@ -83,11 +91,13 @@ bash install.sh -y --no-chsh
 # 仅删除 easy-command 管理的 .zshrc 配置区块
 bash install.sh --uninstall
 
-# 启用可选的目录跳转、模糊搜索和 Git 快捷操作
-bash install.sh -y --with-zoxide --with-fzf --with-git-aliases
+# 启用可选的模糊搜索和 Git 快捷操作
+bash install.sh -y --with-fzf --with-git-aliases
 ```
 
-`zoxide` 提供 `z <关键词>` 目录跳转；`fzf` 提供历史命令和文件的模糊搜索；Git 快捷操作使用 `ec-` 前缀，例如 `git ec-status`，不会覆盖已有别名。
+默认安装 `zoxide`，可使用 `z <关键词>` 跳转目录，也支持 `z add <目录>` 或 `z a <目录>` 手动记录目录；使用 `--without-zoxide` 可关闭。`fzf` 提供历史命令和文件的模糊搜索；Git 快捷操作使用 `ec-` 前缀，例如 `git ec-status`，不会覆盖已有别名。
+
+统一入口使用 `ec`：`ec <关键词>` 跳转目录，`ec add <目录>` 或 `ec a <目录>` 记录目录，`ec list` 或 `ec l` 查看记录，`ec del <目录>` 或 `ec remove <目录>` 删除记录；`ec doctor`、`ec repair`、`ec update`、`ec install`、`ec uninstall` 和 `ec --dry-run` 执行对应的 easy-command 维护操作。为兼容 zoxide，原有 `z` 命令仍可使用。
 
 ## 系统要求
 
@@ -121,13 +131,13 @@ bash install.sh -y
 生产环境建议固定到发布标签，而不是直接使用 `main`：
 
 ```bash
-npx easy-command@2.0.2 -y
+npx easy-command@2.0.5 -y
 ```
 
 或者不使用 npm：
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/UnionSchool/easy-command/v2.0.2/install.sh | bash -s -- -y
+curl -fsSL https://raw.githubusercontent.com/UnionSchool/easy-command/v2.0.5/install.sh | bash -s -- -y
 ```
 
 ## 许可

package/install.sh

@@ -2,7 +2,7 @@
 
 set -Eeuo pipefail
 
-readonly VERSION='2.0.2'
+readonly VERSION='2.0.5'
 readonly BEGIN_MARKER='# >>> easy-command zsh >>>'
 readonly END_MARKER='# <<< easy-command zsh <<<'
 readonly BASE_DIR_NAME='.easy-command'
@@ -11,9 +11,10 @@ ACTION='install'
 ASSUME_YES=false
 CHANGE_LOGIN_SHELL=true
 DRY_RUN=false
-ENABLE_ZOXIDE='auto'
+ENABLE_ZOXIDE=true
 ENABLE_FZF='auto'
 ENABLE_GIT_ALIASES='auto'
+GLOBAL_INSTALL=false
 TARGET_USER="${SUDO_USER:-${USER}}"
 TARGET_HOME=''
 
@@ -39,8 +40,9 @@ Options:
   --user USER         Configure this user. Defaults to the invoking user.
   --no-chsh           Do not change the user's default login shell to zsh.
   --dry-run           Preview changes without installing, writing files, or using sudo.
-  --with-zoxide       Enable optional zoxide directory jumping.
-  --without-zoxide    Disable zoxide in the managed configuration.
+  --global            Install this easy-command version globally with npm first.
+  --with-zoxide       Enable zoxide directory jumping (enabled by default).
+  --without-zoxide    Do not install or enable zoxide.
   --with-fzf          Enable optional fzf history and file searching.
   --without-fzf       Disable fzf in the managed configuration.
   --with-git-aliases  Add non-conflicting global Git aliases prefixed with ec-.
@@ -189,6 +191,17 @@ install_packages() {
     esac
 }
 
+install_global_package() {
+    "$GLOBAL_INSTALL" || return 0
+    command -v npm >/dev/null 2>&1 || fail 'npm is required for --global. Install Node.js/npm first.'
+
+    if "$DRY_RUN"; then
+        command_preview npm install -g "easy-command@$VERSION"
+    else
+        npm install -g "easy-command@$VERSION"
+    fi
+}
+
 ensure_repository() {
     local repository="$1"
     local destination="$2"
@@ -303,6 +316,60 @@ EOF
 # easy-command: zoxide
 if command -v zoxide >/dev/null 2>&1; then
     eval "$(zoxide init zsh)"
+
+    # Keep zoxide's normal jump behavior and add a short command for recording paths.
+    function z() {
+        if [[ "$1" == 'add' || "$1" == 'a' ]]; then
+            shift
+            command zoxide add "$@"
+        else
+            __zoxide_z "$@"
+        fi
+    }
+
+    # Unified easy-command directory interface. Keep z for zoxide compatibility.
+    function ec() {
+        case "$1" in
+            doctor|repair|update|install|uninstall)
+                if (( $+commands[easy-command] )); then
+                    command easy-command "$@"
+                else
+                    command npx easy-command "$@"
+                fi
+                ;;
+            --dry-run)
+                if (( $+commands[easy-command] )); then
+                    command easy-command "$@"
+                else
+                    command npx easy-command "$@"
+                fi
+                ;;
+            add|a)
+                shift
+                command zoxide add "$@"
+                ;;
+            list|ls|l)
+                shift
+                command zoxide query --list "$@"
+                ;;
+            del|remove)
+                shift
+                command zoxide remove "$@"
+                ;;
+            help|--help|-h)
+                printf '%s\n' \
+                    'Usage: ec <keyword>' \
+                    '       ec add|a <directory>' \
+                    '       ec list|ls|l [keyword]' \
+                    '       ec del|remove <directory>' \
+                    '       ec doctor|repair|update|install|uninstall' \
+                    '       ec --dry-run'
+                ;;
+            *)
+                __zoxide_z "$@"
+                ;;
+        esac
+    }
 fi
 EOF
     fi
@@ -465,6 +532,7 @@ parse_args() {
                 ;;
             --no-chsh) CHANGE_LOGIN_SHELL=false ;;
             --dry-run) DRY_RUN=true ;;
+            --global) GLOBAL_INSTALL=true ;;
             --with-zoxide) ENABLE_ZOXIDE=true ;;
             --without-zoxide) ENABLE_ZOXIDE=false ;;
             --with-fzf) ENABLE_FZF=true ;;
@@ -498,12 +566,16 @@ main() {
             ;;
         install)
             confirm "Install easy-command $VERSION for $TARGET_USER?"
+            install_global_package
             install_packages
             ensure_repositories
             change_login_shell
             write_zshrc_block
             configure_git_aliases
             info "Installed easy-command $VERSION for $TARGET_USER. Reconnect or run: exec zsh -l"
+            if "$GLOBAL_INSTALL"; then
+                info "Global CLI installed. After exec zsh -l, try: ec --help"
+            fi
             ;;
         repair)
             CHANGE_LOGIN_SHELL=false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "easy-command",
-  "version": "2.0.2",
+  "version": "2.0.5",
   "description": "Configure a polished Zsh terminal with one command.",
   "license": "MIT",
   "bin": {