⚡ 介绍

del-repos 是一个功能强大的命令行工具，用于批量删除 GitHub 或 Gitee 仓库，提供直观的交互式界面。

🛠️ 功能特性

• 🌐 多平台支持：同时支持 GitHub 和 Gitee 平台
• 🔍 智能搜索：高级搜索功能，快速查找仓库
• ✅ 批量选择：交互式复选框界面，支持多选
• 🔐 令牌管理：安全的令牌存储和自动验证
• 🎯 仓库筛选：可选择个人仓库或所有可访问仓库
• 💾 配置持久化：保存令牌供未来使用
• 🎨 丰富界面：彩色输出，进度指示器和加载动画
• ⚠️ 安全优先：多重确认步骤，防止意外删除
• 📊 详细反馈：全面的错误处理和操作摘要

🚀 安装

前提条件

• 已安装 Node.js v14.0.0 或更高版本
• 可从 Node.js 官网 下载安装

安装步骤

使用 npm 或 pnpm 全局安装：

# 使用 npm
npm install del-repos -g

# 使用 pnpm
pnpm install del-repos -g

# 使用 yarn
yarn global add del-repos

📋 命令行选项

| 选项 | 说明 | |------|------| | -v, --version | 显示当前版本 | | -h, --help | 显示帮助信息 | | -t <type> | 仓库类型筛选（o: 个人，a: 全部） | | --clear-token | 清除保存的身份验证令牌 |

仓库类型筛选示例

# 仅获取个人拥有的仓库
del-repos -t o

# 获取所有可访问的仓库（默认）
# （包括协作者和组织成员仓库）
del-repos
# 或
del-repos -t a

# 清除保存的令牌（当令牌过期时很有用）
del-repos --clear-token

🌟 使用方法

快速开始

只需运行以下命令即可启动交互式删除流程：

del-repos

详细步骤

1. 🚀 平台选择

   • 选择 GitHub 或 Gitee 平台
   • 工具提供清晰的交互式选择界面

2. 🔑 令牌认证

   • 输入所选平台的个人访问令牌
   • 工具会自动在浏览器中打开令牌生成页面
   • 所需权限：
     • GitHub：delete_repo、project、repo
     • Gitee：仓库删除权限
   • 可选择安全保存令牌以供将来使用

3. 📦 仓库发现

   • 工具会显示加载动画，获取您的仓库列表
   • 显示找到的仓库总数
   • 支持按仓库类型筛选（个人拥有 vs. 所有可访问）

4. 🔍 智能仓库选择

   • 搜索功能：实时输入筛选仓库
   • 批量选择：使用空格键选择/取消选择仓库
   • 编号列表：带编号的仓库列表便于导航
   • 视觉反馈：清晰指示已选择的仓库

5. ⚠️ 安全确认

   • 危险区警告：明确指示操作的破坏性
   • 仓库审查：列出所有将被删除的仓库
   • 最终确认：删除前需要明确确认

6. 🗑️ 删除过程

   • 实时进度更新和加载动画
   • 详细的错误处理和报告
   • 完成后的成功摘要

⚠️ 重要注意事项

🚨 安全警告

• ⚠️ 不可逆操作：删除的仓库无法恢复
• 🔍 仔细检查：始终验证您即将删除的仓库
• 🔐 令牌安全：保持访问令牌安全，切勿共享
• 📝 备份：考虑在删除前备份重要仓库

🔑 令牌要求

GitHub 令牌权限

• delete_repo - 仓库删除所需
• project - 项目板访问权限
• repo - 完整仓库访问权限

Gitee 令牌权限

• 必须启用仓库删除权限

🛠️ 故障排除

如果遇到问题，请检查：

• ✅ 您的网络连接稳定
• ✅ 您的令牌具有所需权限
• ✅ 平台 API 可访问
• ✅ 您拥有必要的仓库访问权限

常见问题：

• 401/403 身份验证错误：您的令牌可能已过期或失效。使用 del-repos --clear-token 清除保存的令牌并重新输入新的令牌。
• 令牌权限问题：确保您的令牌具有所需的权限范围（参见上面的令牌要求部分）。

如需更多帮助或报告错误，请提交 Issue

🙌 贡献

我们欢迎所有的贡献和建议！如果您想为 del-repos 做出贡献，请按以下步骤：

开发环境设置

1. 克隆仓库：

   git clone https://github.com/yaolifeng0629/del-repos.git
   cd del-repos

2. 安装依赖：

   npm install
   # 或
   pnpm install

3. 开发和测试：

   npm run dev
   # 或
   pnpm dev

4. 构建项目：

   npm run build

如何贡献

• 🐛 报告错误：通过创建 Issue 报告问题
• 💡 建议功能：通过 Issue 讨论提出功能建议
• 🔧 提交 PR：为错误修复或新功能提交拉取请求
• 📖 改进文档：帮助其他用户改进文档
• ⭐ 点赞仓库：如果觉得有用请给仓库点星

开发指南

• 遵循现有的代码风格和约定
• 为新功能添加测试
• 必要时更新文档
• 提交 PR 前确保所有测试通过

感谢所有帮助改进 del-repos 的贡献者！ 🎉

📦 最新更新 (v1.1.3)

• ✨ 增强 CLI 体验：改进的用户提示和视觉反馈
• 🔍 搜索功能：添加 inquirer-search-checkbox 以更好地筛选仓库
• ✅ 确认步骤：仓库删除前的额外安全检查
• 🔄 改进加载动画：操作期间更好的视觉反馈
• 🛠️ 错误处理：全面的错误报告和操作摘要
• 💾 令牌管理：可选择保存令牌供将来使用

⭐ 支持项目

如果您觉得这个工具有帮助，请考虑：

• ⭐ 给仓库点星：在 GitHub 上点星
• 📣 分享给他人：推荐给可能受益的其他人
• 🐛 报告问题：帮助改进工具
• 🔧 参与贡献：让它变得更好

您的支持是持续开发的动力！

📊 星路历程

📄 许可证

本项目采用 ISC 许可证 - 详情请查看 LICENSE 文件。