# mcc

**Repository Path**: sky1987_admin/mcc

## Basic Information

- **Project Name**: mcc
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-08
- **Last Updated**: 2026-01-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MCC - My Custom Command

简体中文 | [English](./README.md)

跨平台的自定义命令管理工具，将长命令映射为短命令，提高工作效率。

## ✨ 特性

- 🚀 **简化命令** - 将 `yarn build` 变成 `mcc yb`
- 🌍 **跨平台** - 支持 Windows、macOS、Linux
- ☁️ **云同步** - 通过坚果云同步配置到多台设备
- 📦 **零依赖** - 单文件可执行，无需安装运行时

## 📥 安装

### macOS / Linux 一键安装

```bash
curl -fsSL https://gitee.com/sky1987_admin/mcc/raw/main/install.sh | bash
```

或者使用 wget：
```bash
wget -qO- https://gitee.com/sky1987_admin/mcc/raw/main/install.sh | bash
```

### Windows 一键安装

```powershell
iwr -useb https://gitee.com/sky1987_admin/mcc/raw/main/install/install.ps1 | iex
```

### 卸载

```bash
curl -fsSL https://gitee.com/sky1987_admin/mcc/raw/main/uninstall.sh | bash
```

## 🚀 使用方法

### 交互菜单

```bash
mcc
```

显示交互式菜单，可进行：
- 添加/编辑/删除命令
- 查看所有命令
- 搜索命令
- 配置云同步
- **切换语言** (English / 简体中文)

### 执行命令

```bash
mcc <别名>
```

例如，添加了 `yb` -> `yarn build` 后：

```bash
mcc yb    # 执行 yarn build
```

**命令回退 (Fallback):**
如果输入的命令不是已存在的别名，MCC 会将其作为系统命令直接执行：
```bash
mcc ls -la   # 直接执行 'ls -la'
```

### 🔍 智能搜索

MCC 支持强大的智能搜索功能：

```bash
mcc search         # 进入交互式搜索模式
mcc s              # 同上（简写）
mcc s yarn         # 搜索包含 yarn 的命令
```

**搜索特性：**
- **模糊匹配**：输入 `arn` 可匹配 `yarn build`
- **首字母匹配**：输入 `yb` 可匹配 `yarn build`
- **智能排序**：按匹配度和使用频率排序
- **快速选择**：
    - 搜索结果显示序号 `[1], [2]...`
    - 输入 `mcc <关键词> <序号>` 可直接执行 (例如 `mcc y 1`)
    - 交互模式下会有 `->` 箭头指示当前选中项
- **进入菜单**: 输入为空时按 `Enter` 键直接打开主菜单。
- **退出/清空**: 按 `ESC` 键可清空当前输入，若输入为空则退出交互模式。

**使用统计：**
- 自动记录每个命令的使用次数
- 最常用和最近使用的命令会优先显示

### 快捷操作

```bash
mcc list    # 列出所有命令
mcc sync    # 手动同步
mcc help    # 显示帮助
```

## 📁 配置文件

配置存储于 `~/.mcc/` 目录：

```
~/.mcc/
├── config.json     # 主配置（同步设置等）
└── commands.json   # 命令列表
```

## ☁️ 云同步

MCC 支持 **实时配置同步** (支持坚果云、Dropbox、OneDrive 等本地同步文件夹)。
- **工作机制**: MCC 会直接将配置文件的读写重定向到您指定的同步目录，实现“一处修改，处处同步”。
- **路径安全**: 为防止污染您的根目录，MCC 会自动校验路径，并未包含 `/mcc` 时自动追加 (例如: `/Nutstore` -> `/Nutstore/mcc`)。
- **自动迁移**: 设置同步目录时，现有的配置数据会自动迁移到新位置。

1. 运行 `mcc` 进入菜单
2. 选择 `7. 同步设置`
3. 配置坚果云同步目录路径

配置完成后，命令的任何变更都会自动同步到云端（因为它们直接保存在云端目录中）。

## 🔧 从源码编译

```bash
# 克隆仓库
git clone https://github.com/yourname/mcc.git
cd mcc

# 编译当前平台
go build -o mcc

# 交叉编译
GOOS=windows GOARCH=amd64 go build -o mcc.exe
GOOS=darwin GOARCH=amd64 go build -o mcc-darwin-amd64
GOOS=linux GOARCH=amd64 go build -o mcc-linux-amd64
```

## 📋 命令示例

| 别名 | 原始命令 | 描述 |
|------|----------|------|
| yb | yarn build | 构建前端项目 |
| gp | git push origin main | 推送主分支 |
| dc | docker-compose up -d | 启动 Docker 服务 |
| nr | npm run dev | 启动开发服务器 |

## 📄 License

MIT License