XG-Windsurf 激活管理工具 - VS Code 扩展

• ✨ 账户激活管理 - 激活码验证和管理
• 🔄 无感换号 - 实现账号无缝切换，无需手动重新登录
• 🖥️ 多设备支持 - 支持多台设备使用同一激活码
• 🚀 自动登录 - 通过动态补丁实现自动注入认证信息
• 📂 路径管理 - 自动检测和管理 Windsurf 安装路径
• 📢 公告获取 - 获取服务器端公告信息

通过动态修补（Runtime Patching） Windsurf 的核心扩展文件，注入自定义认证命令，实现账号的无缝切换。

项目会在运行时检查 Windsurf 的核心扩展文件（extension.js）是否已应用补丁：

检查补丁特征关键字：
- "windsurf.provideAuthTokenToAuthProviderWithShit"
- "handleAuthTokenWithShit"

如果未检测到补丁，系统会自动：

1. 定位原始函数 - 查找 handleAuthToken 函数（Windsurf 原生的认证处理函数）
2. 注入新函数 - 在原函数后插入 handleAuthTokenWithShit 函数
3. 注册自定义命令 - 添加 windsurf.provideAuthTokenToAuthProviderWithShit 命令
4. 写入文件 - 将修改后的内容写回 extension.js

核心代码差异：

// 原生函数 - 需要服务器验证
async handleAuthToken(A) {
    const e = await (0, Q.registerUser)(A);  // ← 这里会请求官方服务器
    const { apiKey: t, name: i } = e;
    // ...
}

// 补丁函数 - 直接使用传入的凭据
async handleAuthTokenWithShit(A) {
    const { apiKey: t, name: i } = A;  // ← 直接使用传入参数，无需验证
    // ...
}

当用户点击"刷新"或激活账号时：

1. 检查补丁状态
   ↓
2. 如需要则应用补丁（并重启 Windsurf）
   ↓
3. 执行登出命令（清理旧会话）
   ↓
4. 调用自定义命令注入新会话
   vscode.commands.executeCommand(
       "windsurf.provideAuthTokenToAuthProviderWithShit",
       {
           apiKey: "your-api-key",
           name: "[email protected]",
           apiServerUrl: "https://api.example.com"
       }
   )
   ↓
5. 会话注入到 VSCode Secrets
   ↓
6. 触发会话变更事件，更新 UI

补丁会修改以下文件（具体路径因操作系统而异）：

• Windows: %LOCALAPPDATA%\Programs\Windsurf\resources\app\extensions\codeium.windsurf-...\dist\extension.js
• macOS: /Applications/Windsurf.app/Contents/Resources/app/extensions/codeium.windsurf-.../dist/extension.js
• Linux: ~/.windsurf/resources/app/extensions/codeium.windsurf-.../dist/extension.js

由于需要修改系统文件，项目包含权限检测机制：

• Windows: 检测文件是否可写，提示以管理员身份运行 Windsurf
• macOS/Linux: 检测文件权限，提示使用 chmod 修改权限

⚠️ 重要提示：

• 补丁仅修改本地文件，不涉及网络攻击或破解
• 补丁函数与原生函数逻辑几乎完全相同，仅跳过服务器验证步骤
• 每次 Windsurf 更新后，补丁可能需要重新应用
• 使用自定义激活系统替代官方认证服务器

用户只需点击账号列表中的其他账号，系统会：

1. 自动登出当前账号
2. 自动注入新账号的认证信息
3. 自动刷新 Cascade 界面

整个过程无需手动操作，体验如同在多个官方账号间切换。

1. 克隆本仓库

git clone https://github.com/your-username/xg-windsurf.git
cd xg-windsurf

2. 安装依赖

npm install

3. 编译项目

npm run build

4. 打包扩展

npm run package

在开始使用前，你需要配置API服务器地址。编辑 src/config/api.ts 文件：

export const API_CONFIG = {
    BASE_URL: 'http://your-api-server.com',  // 替换为你的API服务器地址
    TIMEOUT: 30000,
} as const;

项目使用以下API端点（请确保你的服务器实现这些端点）：

• POST /api/account/validate-key - 激活验证
• POST /api/account/activate-refresh - 刷新激活
• POST /quota/api/key-usage - 获取使用状态
• GET /api/announcements - 获取公告
• POST /api/key/convert - 密钥转换

npm run watch

npm run build

npm run obfuscate

查看 LICENSE 文件了解详情。

欢迎提交 Pull Request 和 Issue！

• 本项目需要配合后端API服务器使用
• 请确保API服务器返回明文数据（不使用加密）
• 首次使用前请正确配置 src/config/api.ts