cmder

跨平台命令行提示工具，通过语义化关键词搜索预设命令模板，选中后直接填入终端输入行，编辑后回车执行。

依赖 Node.js（>=14）。

安装

npm install -g cmder
cmder init --install     # 一键配置 Shell 集成，重启终端后生效

使用

cmder 端口               # 搜索端口相关命令
cmder git log            # Git 日志相关
cmder docker             # Docker 相关命令
cmder                    # 列出所有可用命令
cmder -l git             # 列出命令及模板
cmder -h                 # 帮助

交互流程

1. cmder <关键词> → 列出匹配命令，↑↓ 选择，Enter 确认，q/Esc 退出
2. 命令模板填入终端输入行（带 {{变量}} 占位符）
3. 修改占位符为实际值，回车执行

两种模式

| 模式 | 安装 | 效果 | |------|------|------| | 普通模式 | npm install -g cmder | 命令输出到终端 | | 增强模式 | cmder init --install | 命令直接填入输入行，编辑即执行 |

Shell 集成

cmder init --install 会自动检测当前 Shell 并配置。

手动配置：

| Shell | 配置 | |-------|------| | PowerShell | . "path/to/shell/cmder.ps1" 加到 $PROFILE | | Zsh | source "path/to/shell/cmder.zsh" 加到 ~/.zshrc | | Bash | source "path/to/shell/cmder.sh" 加到 ~/.bashrc | | Fish | source "path/to/shell/cmder.fish" 加到 ~/.config/fish/config.fish | cmder -l # 列出所有命令及命令模板

查看帮助

cmder -h

### 交互流程

1. 输入 `cmder <关键词>` 搜索命令
2. 用 `↑` `↓` 箭头键选择，`Enter` 确认，`q` / `Esc` 退出
3. 命令模板填入终端输入行（带 `{{变量}}` 占位符）

## 自定义命令库

默认命令库为项目根目录的 `commands.json`。你也可以在以下位置创建自己的命令库（优先级从高到低）：

1. `./commands.json` — 当前工作目录
2. `~/.cmder/commands.json` — 用户目录
3. `<cmder>/commands.json` — 默认命令库

### 命令格式

```json
{
  "commands": [
    {
      "name": "查看端口占用",
      "keywords": ["端口", "port", "netstat", "占用"],
      "command": "netstat -ano | findstr '{{port}}'",
      "description": "查看Windows上指定端口的占用情况",
      "platform": ["windows"],
      "variables": {
        "port": { "description": "端口号", "default": "8080" }
      }
    }
  ]
}

| 字段 | 必填 | 说明 | |------|------|------| | name | 是 | 命令显示名称 | | keywords | 是 | 搜索关键词，输入任意关键词即可匹配 | | command | 是 | 命令模板，{{变量名}} 为占位符 | | description | 否 | 命令描述，显示在选择列表中 | | platform | 否 | 适用平台：windows/macos/linux/all，不填则全平台 | | variables | 否 | 变量定义，description 为提示文字，default 为默认值 |

项目结构

cmder/
├── bin/cmder.js          # CLI 入口
├── lib/
│   ├── cli.js            # 主逻辑
│   ├── search.js         # 搜索匹配
│   └── picker.js         # 交互式选择器
├── commands.json          # 默认命令数据库
├── shell/                 # Shell 集成脚本
│   ├── cmder.ps1
│   ├── cmder.sh
│   ├── cmder.zsh
│   └── cmder.fish
└── package.json