# Windows Dev Stack

**Windows 原生** Claude Code CLI + GitHub Copilot CLI + MCP + Rust Token Killer 一键部署方案。

不依赖 WSL2，所有组件直接运行在 Windows 本机。

## 组件清单

| 组件 | 说明 | 安装位置 |
|------|------|---------|
| **Node.js LTS** | JS 运行时 | winget → 系统 |
| **Claude Code CLI** | `@anthropic-ai/claude-code` | npm global |
| **GitHub CLI + Copilot CLI** | `gh` + `github/gh-copilot` 扩展 | winget + gh extension |
| **Unity MCP Server** | AnkleBreaker-Studio — Claude ↔ Unity Editor | `%USERPROFILE%\unity-mcp-server\` |
| **Godot MCP Pro** | 本地包 v1.14.1 — Claude ↔ Godot Editor | `%USERPROFILE%\godot-mcp-pro\` |
| **Rust** | rustup stable 工具链 | winget → `%USERPROFILE%\.cargo\` |
| **RTK** | Rust Token Killer — LLM token 优化 | cargo install → `%USERPROFILE%\.cargo\bin\` |

## 目录结构

```
windows-dev-stack/
├── deploy.ps1        # Windows 一键部署（PowerShell 5.1+）
├── .env.example      # 配置模板
└── README.md
```

> Godot MCP Pro 本地包位于 `../claude-dev-stack/godot-mcp-pro-v1.14.1/`，
> 两个 stack 共用同一份本地包，无需重复存储。

---

## 快速开始

```powershell
# 1. 复制并填写配置
cd path\to\windows-dev-stack
cp .env.example .env
notepad .env

# 2. 运行部署（普通用户即可；防火墙步骤会弹 UAC 提权）
pwsh .\deploy.ps1

# 3. GitHub CLI 登录（首次使用前）
gh auth login
```

---

## 配置说明（`.env`）

### 推荐：灵眸 AI（国内直连，无需代理）

| 变量 | 说明 |
|------|------|
| `ANTHROPIC_AUTH_TOKEN` | 灵眸 API Key，从 [lmuai.com](https://lmuai.com) 获取 |
| `ANTHROPIC_BASE_URL` | `https://api.lmuai.com`（默认） |
| `CLAUDE_MODEL` | `claude-sonnet-4-6`（默认） |

### 备选：Anthropic 官方 API

| 变量 | 说明 |
|------|------|
| `ANTHROPIC_API_KEY` | 从 [console.anthropic.com](https://console.anthropic.com) 获取 |
| `ANTHROPIC_BASE_URL` | `https://api.anthropic.com` |

---

## 与 claude-dev-stack 的对比

| 特性 | `claude-dev-stack` | `windows-dev-stack` |
|------|--------------------|---------------------|
| 运行环境 | WSL2（Linux） | Windows 原生 |
| Claude Code CLI | WSL2 内 npm global | Windows npm global |
| GitHub Copilot CLI | WSL2 gh extension | Windows gh extension |
| Rust / RTK | WSL2 cargo | Windows cargo |
| MCP Servers | WSL2 node 进程 | Windows node 进程 |
| 适合场景 | Linux 工具链 / 命令行重度用户 | 纯 Windows 开发者 / 不想装 WSL2 |

两套 stack **可以共存**，各自写入独立配置，互不干扰。

---

## MCP 配置覆盖范围

`deploy.ps1` 自动写入以下客户端的 MCP 配置：

| 客户端 | 配置文件 |
|--------|---------|
| Claude Desktop | `%APPDATA%\Claude\claude_desktop_config.json` |
| Cursor | `%USERPROFILE%\.cursor\mcp.json` |
| Windsurf | `%APPDATA%\Windsurf\mcp_config.json` |
| VS Code | `%APPDATA%\Code\User\mcp.json` |
| Claude Code CLI | `claude mcp add --scope user`（写入用户级 MCP） |

---

## RTK 使用

RTK 通过 Claude Code 的 PreToolUse hook 自动生效（`deploy.ps1` 运行 `rtk init -g` 注册）。

```powershell
# 查看 token 节省统计
rtk gain
rtk gain --history

# 手动使用
rtk git status
rtk cargo test
```

`.github/copilot-instructions.md` 已在仓库根目录配置，GitHub Copilot (VS Code) 会自动读取并在终端命令前加 `rtk` 前缀。

---

## 故障排查

### Node.js 安装后找不到命令
```powershell
# 刷新当前会话 PATH
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" +
            [System.Environment]::GetEnvironmentVariable("Path","User")
# 或直接重开 PowerShell
```

### Rust / cargo 安装后找不到命令
```powershell
# 手动加入 PATH（当前会话）
$env:Path = "$env:USERPROFILE\.cargo\bin;$env:Path"
# 或重开终端（rustup installer 已写入用户 PATH）
```

### rtk 安装失败（需要 Build Tools）
```powershell
# 安装 Visual C++ Build Tools（Rust Windows 编译器后端依赖）
winget install Microsoft.VisualStudio.2022.BuildTools
# 安装后重开终端，再运行：
cargo install --git https://github.com/rtk-ai/rtk
```

### gh copilot 找不到扩展
```powershell
# 确认已登录
gh auth status
# 重新安装扩展
gh extension install github/gh-copilot
```

### Unity MCP Bridge 连接失败
```powershell
# 检查 Bridge 端口
Invoke-WebRequest http://127.0.0.1:7890/api/ping
# 确认防火墙已放行
Get-NetFirewallRule -DisplayName "Unity MCP Bridge*" | Select-Object DisplayName, Enabled
```
