# ai-bridge

**Repository Path**: xinw2130/ai-bridge

## Basic Information

- **Project Name**: ai-bridge
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-14
- **Last Updated**: 2026-07-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI-Bridge

面向 AI 编程助手的工具库。每个 skill 目录下包含独立可执行的脚本和说明文档，AI 工具可直接读取 `README.md` 分析用途并执行。

## 工具列表

### 1. Dev Environment Setup — Windows 开发环境一键安装

**路径：** `skills/dev-env-setup/`  
**平台：** Windows (PowerShell, 需管理员权限)  
**触发词：** 安装开发环境、setup dev environment、新电脑装环境、install python node java、配置开发环境

**功能：** 在新 Windows 电脑上自动安装完整开发环境。

| 组件 | 方式 | 说明 |
|------|------|------|
| Python 3.12 (全局) | 官方安装器 | 系统级，优先于 conda base |
| Miniconda3 | 官方安装器 | 隔离环境，auto_activate_base=false |
| NVM for Windows | GitHub Release | Node.js 多版本管理 |
| Node.js LTS + 18 | 通过 NVM | 自动检测已安装版本并跳过 |
| Git for Windows | GitHub Release | 版本控制 |
| OpenJDK 8 (Java) | Adoptium MSI | 必装，不询问 |
| .NET SDK (C#) | dotnet-install | 可选 |
| C++ Build Tools (MSVC) | VS Build Tools | 可选 |
| Rust | rustup | 可选 |
| Go | 官方 MSI | 可选 |

**AI 执行方式：**
```powershell
# 读取 README.md 了解参数，然后：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
.\skills\dev-env-setup\scripts\setup-dev-env.ps1 -NoToAll
```

---

### 2. Win Cache Cleaner — Windows 缓存扫描与清理

**路径：** `skills/win-cache-cleaner/`  
**平台：** Windows (PowerShell + Python 3)  
**触发词：** 清理缓存、clean cache、释放磁盘空间、查看哪些缓存占空间、检索大的缓存文件

**功能：** 扫描并安全清理开发工具缓存，交互式流程：scan → 表格展示 → 按序号选择 → 确认 → 执行。

**覆盖：** npm/yarn/pnpm/pip/conda 缓存、Gradle/Go 构建缓存、Chrome/Edge 浏览器缓存、系统临时文件、VS Code 插件、Steam/Docker/Spotify 等应用缓存。

**安全规则：**
- ✅ SAFE 项（缓存/构建/临时）— 自动重建，可放心清理
- ⚠️ RISKY 项（依赖/插件/数据）— 需 `-Force` 参数

**AI 执行方式：**
```powershell
# Step 1: 扫描
powershell -ExecutionPolicy Bypass -File .\skills\win-cache-cleaner\scripts\scan_caches.ps1

# Step 2: 展示表格（用 Python 避免 PowerShell 编码问题）
python .\skills\win-cache-cleaner\scripts\print_table.py

# Step 3: 用户确认后执行清理（按序号）
powershell -ExecutionPolicy Bypass -File .\skills\win-cache-cleaner\scripts\clean_caches.ps1 -Indexes "2,5,7"

# RISKY 项需要 -Force
powershell -ExecutionPolicy Bypass -File .\skills\win-cache-cleaner\scripts\clean_caches.ps1 -Indexes "3" -Force
```

---

## 目录结构

```
ai-bridge/
├── README.md                          # 本文件（AI 入口）
├── skills/
│   ├── dev-env-setup/                 # 开发环境一键安装
│   │   ├── README.md                  # 工具说明（AI 可直接阅读）
│   │   └── scripts/
│   │       └── setup-dev-env.ps1      # 主脚本
│   └── win-cache-cleaner/             # Windows 缓存清理
│       ├── README.md                  # 工具说明（AI 可直接阅读）
│       └── scripts/
│           ├── scan_caches.ps1        # 扫描脚本
│           ├── clean_caches.ps1       # 清理脚本
│           └── print_table.py         # 表格输出
```

## 设计原则

1. **AI-first**：每个工具目录下都有 `README.md`，包含触发词、参数、执行方式，AI 可以直接读取并理解
2. **独立可执行**：每个脚本都是独立的，不依赖特定 AI 平台，拷贝到任何地方都能跑
3. **安全第一**：危险操作需要显式确认（如 `-Force` 参数、交互式确认流程）
4. **幂等性**：重复执行安全，已安装的组件会自动跳过