# cli

**Repository Path**: idcu-est/cli

## Basic Information

- **Project Name**: cli
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-22
- **Last Updated**: 2026-03-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# IDCU CLI - 不羁盟命令行工具

</div>

<div align="center">

[![PyPI version](https://img.shields.io/pypi/v/idcu-cli?style=flat-square)](https://pypi.org/project/idcu-cli/)
[![Python Version](https://img.shields.io/badge/python-3.8+-blue?style=flat-square)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-Apache--2.0-green?style=flat-square)](LICENSE)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000?style=flat-square)](https://github.com/psf/black)

**一站式全栈开发工作流管理工具**

**基于 Python 3.8+ 开发**

</div>

---

## 简介

IDCU CLI（不羁盟）是由 **IDCU (I Don't Care Union - 不羁盟)** 组织基于 **Python 3.8+** 开发的一站式全栈开发命令行工具集，旨在简化和标准化现代软件开发工作流。

无论您是单项目开发，还是多仓库/子模块项目管理，IDCU CLI 都能提供统一的命令接口，让您从繁琐的重复操作中解放出来，专注于创造价值。

## 功能特性

### 核心功能

- **Git 管理** - 支持单项目、多项目、子模块的完整 Git 操作集
- **Maven 构建** - 项目构建与依赖管理，支持多项目和子模块
- **插件系统** - 可扩展的插件架构，包含丰富的示例插件
- **配置管理** - YAML/JSON 配置文件支持，灵活定制
- **环境配置** - 开发环境变量自动配置与检测

### 增强功能

- **编码检测与修复** - 智能编码检测、转换和修复
- **国际化** - 中英文双语支持
- **错误重试** - 智能重试机制和降级策略
- **环境检测** - 开发环境软件版本检测

### 现代开发

- **CI/CD 集成** - 支持 GitHub Actions、GitLab CI、Jenkins
- **自动化部署** - Docker 构建、云平台集成、SCP 部署
- **AI 增强** - OpenAI/Ollama 支持、自动提交信息、代码变更摘要
- **团队协作** - 团队配置共享、权限管理、代码审查工作流
- **跨语言支持** - npm/yarn/pnpm、Python、Go、Rust 统一构建接口
- **Web UI** - FastAPI 后端、可视化仪表盘

## 快速开始

### 安装

```bash
# 从 PyPI 安装
pip install idcu-cli

# 或从源码安装
git clone https://gitee.com/idcu/cli.git
cd cli
pip install -e .
```

### 基础使用

```bash
# 查看帮助
idcu --help

# 查看版本
idcu --version

# Git 相关命令
idcu git list
idcu git status
idcu git commit -m "提交信息" -a
idcu git push
idcu git pull

# Maven 相关命令
idcu maven list
idcu maven build

# 插件管理
idcu plugin list
idcu plugin cmd <command>

# 环境配置
idcu env versions
idcu env setup

# 启动 Web UI
idcu web serve
```

## 项目结构

```
idcu/
├── cli/                    # 命令行界面模块
├── core/                   # 核心工具模块
│   ├── constants.py       # 常量定义
│   ├── ui.py              # UI 输出工具
│   ├── utils.py           # 工具函数
│   ├── encoding_utils.py  # 编码处理工具
│   ├── cache.py           # 缓存管理
│   ├── memory.py          # 内存管理
│   └── parallel.py        # 并行处理
├── tools/                 # 开发工具集
│   ├── git/               # Git 操作封装
│   ├── maven/             # Maven 操作封装
│   ├── plugins/           # 插件系统
│   ├── cicd/              # CI/CD 集成
│   ├── ai/                # AI 增强
│   ├── team/              # 团队协作
│   ├── crosslang/         # 跨语言构建
│   ├── web/               # Web UI
│   └── env_setup.py       # 环境配置工具
└── system/                # 系统层
    ├── config/            # 配置 schema 和验证
    ├── config_manager.py  # 配置管理
    ├── logger.py         # 日志系统
    ├── error_handler.py  # 错误处理
    ├── i18n.py           # 国际化
    └── env_utils.py      # 环境变量工具
```

## 配置

配置文件位于 `.idcu/config.yaml`，首次运行会自动创建默认配置。

```yaml
global:
  color_output: true
  verbose: false
  quiet: false
  dry_run: false

git:
  default_branch: develop
  remote_name: origin
  auto_fetch: false

maven:
  local_repo_path: .mvn/local-repo
  default_goals:
    - clean
    - install
  offline_mode: false
```

## 开发

### 运行测试

```bash
pytest tests/ -v
```

### 代码检查

```bash
# 类型检查
mypy idcu/

# 代码格式化
ruff format
ruff check
```

## 插件开发

项目提供了丰富的示例插件，参考 `idcu/tools/plugins/examples/` 目录：

- `hello_plugin.py` - 简单的 Hello World 示例
- `git_plugin.py` - Git 操作插件
- `file_utils_plugin.py` - 文件处理工具
- `system_info_plugin.py` - 系统信息插件
- `docker_plugin.py` - Docker 管理插件
- `redis_plugin.py` - Redis 管理插件
- `release_plugin.py` - 发布管理插件

## 文档

- [使用教程](TUTORIAL.md) - 详细的使用指南和教程
- [使用示例](EXAMPLES.md) - 丰富的命令使用示例
- [API 文档](docs/index.md) - 完整的 API 参考文档
- [发布指南](RELEASE.md) - 发布到 PyPI 的步骤说明

## 许可证

Apache License 2.0

---

<div align="center">
**IDCU CLI - 不羁盟命令行工具** | 基于 Python 开发 | 让开发更简单
</div>