# Windows ARM64 支持更新

## 版本 1.1.1（即将发布）

### 修复

- ✅ **修复 OpenCode 在 Windows ARM64 上的安装问题**
  - 现在能正确识别 Windows ARM64 架构（如 Surface Pro X、Surface Pro 9 5G 等）
  - 当检测到不支持的架构时，优雅地跳过 OpenCode 安装而不中断整个流程
  - 提供清晰的错误信息和替代方案（WSL2、其他 AI CLI 工具）
  - 其他工具（Git、Bun、CodeBuddy、iFlow、Qoder、Qwen）继续正常安装

### 变更详情

**问题：**
在某些机器上，OpenCode 安装失败并提示"必须安装 Windows ARM64 版本"，导致整个安装流程中断。

**根本原因：**
`opencode-ai` 包目前不提供 Windows ARM64 二进制文件（`opencode-windows-arm64`），只支持：
- Windows x64
- macOS Intel (x64)
- macOS Apple Silicon (arm64)
- Linux x64
- Linux ARM64

**解决方案：**
1. 在 `installOpenCode()` 方法中添加平台和架构检测
2. 对于 Windows ARM64，提前识别并跳过，返回 `false` 而不是抛出异常
3. 提供用户友好的错误信息和替代方案
4. 其他不受支持的架构也进行类似处理

### 测试

所有测试通过 ✅：
- Windows x64: 正常安装
- Windows ARM64: 正确跳过
- macOS Intel: 正常安装
- macOS Apple Silicon: 正常安装
- Linux x64: 正常安装
- Linux ARM64: 正常安装

### 用户影响

#### Windows ARM64 用户

**之前：**
```
❌ 安装失败
❌ 整个流程中断
```

**现在：**
```
⚠️  检测到 Windows ARM64 架构
❌ OpenCode 目前不支持 Windows ARM64 架构

可能的解决方案：
  1. 使用 WSL2 (Windows Subsystem for Linux) 安装 Linux 版本
  2. 等待 OpenCode 官方发布 Windows ARM64 版本
  3. 使用其他 AI CLI 工具（CodeBuddy、iFlow、Qoder、Qwen 均支持 ARM64）

跳过 OpenCode 安装，继续安装其他工具...
✅ Git、Bun、CodeBuddy、iFlow、Qoder、Qwen 等工具正常安装
```

### 替代方案

Windows ARM64 用户可以使用：

1. **WSL2（推荐）**
   ```bash
   wsl
   npm install -g opencode-ai
   ```

2. **其他 AI CLI 工具**（都支持 ARM64）
   - CodeBuddy: `npm install -g @tencent-ai/codebuddy-code`
   - iFlow CLI: `npm install -g @iflow-ai/iflow-cli`
   - Qoder CLI: `npm install -g @qoder-ai/qodercli`
   - Qwen CLI: `npm install -g @qwen-code/qwen-code`

3. **跳过 OpenCode**
   ```bash
   stigmergylite --no-opencode
   ```

### 相关文件

- `index.js` - 修改了 `installOpenCode()` 方法
- `OPENCODE_ARCHITECTURE_ISSUE.md` - 详细问题分析
- `FIX_OPENCODE_ARM64.md` - 完整修复说明
- `test-arm64-detection.js` - 平台检测测试
- `test-opencode-install.js` - 安装测试
- `test-full-install-flow.js` - 完整流程测试
- `diagnose-opencode.js` - 诊断工具

### 诊断工具

如果遇到架构相关问题，可以运行：
```bash
node diagnose-opencode.js
```

这将显示：
- 系统信息（平台、架构）
- npm 配置
- 环境变量
- 已安装的 opencode 二进制包
- 建议的解决方案

---

## 计划中的未来更新

### v1.2.0（计划中）

- ✅ 持续监控 OpenCode 是否发布 Windows ARM64 版本
- ✅ 如果发布，自动建议用户重新运行安装
- ✅ 在文档中明确列出所有工具的平台支持情况
- ✅ 向 OpenCode 项目反馈 Windows ARM64 支持需求