GitHub Copilot CLI 接入指南

🖥️ Cursor + GitHub Copilot CLI + CLI-Anything

Cursor IDE 内置了 GitHub Copilot CLI，可以直接调用生成的 CLI 工具。本指南介绍如何在 Cursor 中集成 CLI-Anything。

📋 前提条件

Cursor IDE 已安装
GitHub Copilot CLI (copilot) 已安装
Python 3.10+
目标软件已安装

🚀 快速接入

Step 1：安装 CLI-Hub

在 Cursor 的内置终端（Ctrl + `）中执行：

npm install -g cli-anything-hub
# 或者
pip install cli-anything-hub

Step 2：安装目标 CLI

copilot ext run cli-hub install gimp
copilot ext run cli-hub install blender

Step 3：在 Cursor Chat 中使用

在 Cursor 的 AI Chat 面板中输入：

@copilot 用 GIMP 把当前项目的 logo.png 裁剪成 512x512

Cursor 会自动在终端中执行对应的 CLI 命令。

💡 典型使用场景

场景 1：前端开发 + 图片处理

@copilot 用 GIMP 把 hero-bg.jpg 压缩到 200KB 以下，保持 1920x1080

→ Cursor 执行 cli-anything-gimp image compress --input hero-bg.jpg --max-size 200 --width 1920 --height 1080

场景 2：3D 开发 + Blender

@copilot 用 Blender 把 models/ 目录下的 .obj 文件批量转为 .glb

→ Cursor 生成批量转换脚本

场景 3：文档开发 + LibreOffice

@copilot 把 README.md 转为 Word 文档，加上封面页

场景 4：视频开发 + Shotcut

@copilot 用 Shotcut 把 intro.mp4 和 demo.mp4 合并，加上转场效果

配置优化

.cursorrules 配置

在项目根目录创建 .cursorrules 文件，让 Cursor AI 更好地理解 CLI-Anything：

# CLI-Anyanything 集成规则

当用户请求涉及以下操作时，优先使用 CLI-Anything 工具：
- 图片处理（裁剪、压缩、格式转换）→ cli-anything-gimp
- 3D 模型操作（渲染、格式转换）→ cli-anything-blender
- 办公文档（转换、生成）→ cli-anything-libreoffice
- 视频编辑（剪辑、合并、转码）→ cli-anything-shotcut
- 直播录制（开始/停止录制）→ cli-anything-obs

已安装的 CLI 列表：
- cli-anything-gimp
- cli-anything-blender
- cli-anything-libreoffice

使用方式：在终端中直接调用对应的 CLI 命令。

Tasks 配置

利用 Cursor 的 Tasks 功能创建常用操作快捷方式：

[
  {
    "name": "压缩图片",
    "prompt": "用 GIMP CLI 压缩当前选中的图片文件，目标大小 < 200KB"
  },
  {
    "name": "3D 渲染",
    "prompt": "用 Blender CLI 渲染当前项目的 3D 场景"
  },
  {
    "name": "文档转 PDF",
    "prompt": "用 LibreOffice CLI 将当前文档转为 PDF 格式"
  }
]

替代方案：在终端中直接调用

如果 Copilot CLI 扩展不可用，也可以直接在终端中调用：

# 打开终端
Ctrl + `

# 手动运行 CLI
cli-anything-gimp image crop --input ./logo.png --width 512 --height 512

🐛 常见问题

Q: 终端中 CLI 命令不可用

解决：确保 Cursor 的终端 shell 已加载 Python 环境的 PATH。

# 检查
which cli-anything-gimp

# 如果找不到，手动添加到 PATH
export PATH="$HOME/.local/bin:$PATH"

Q: AI Chat 不调用 CLI

解决：使用 @copilot 前缀明确指示 Cursor 调用 CLI。

Q: Windows 上终端报错

解决：确保使用 Git Bash 或 WSL 作为 Cursor 的默认终端（Settings → Terminal → Shell Path）。