Releases: BasicProtein/AugmentCode-Free
AugmentCode-Free v2.0.4
AugmentCode-Free v2.0.4 - 构建优化版
🎉 版本亮点
AugmentCode-Free v2.0.4 是一个重要的构建优化版本,专注于解决 macOS 构建问题、增强权限检查功能,并完善了用户体验。
🔧 核心功能改进
权限检查增强
- 智能只读检测:自动检测文件只读状态,避免补丁失败
- 友好错误提示:提供详细的权限问题解决方案
- 操作指导:当检测到只读文件时,提供5步详细操作指南
- 错误分类:区分权限问题和其他写入错误,提供针对性建议
国际化完善
- 双语错误信息:所有错误提示支持中英文显示
- 详细解决方案:错误信息包含具体的解决步骤
- 用户友好:根据系统语言自动显示对应语言的提示
用户体验提升
- 自动诊断:补丁失败时自动检测原因
- 具体指导:提供可操作的解决方案
- 减少困惑:明确区分不同类型的错误
🍎 macOS 构建修复
解决的问题
- "Failed to create parent directory structure" 错误:通过优化构建流程解决
- "IncompatibleBinaryArchError" 架构问题:移除 universal2 架构以提高兼容性
- 权限问题:自动处理 macOS 权限和安全设置
双版本支持
- 应用包版本:
AugmentCode-Free-v2.0.4-macos.app- 标准 macOS 应用 - 独立可执行文件:
AugmentCode-Free-v2.0.4-macos-standalone- 兼容性更好
架构支持
- Intel Mac:完全支持
- Apple Silicon Mac:完全支持
- 自动适配:根据构建环境自动生成对应架构版本
📚 文档完善
新增文档
- macOS 故障排除指南:专门解决 macOS 相关问题
- 构建说明更新:包含最新的构建方法和故障排除
- 自动化脚本:提供
build_macos.sh一键构建脚本
文档结构优化
- docs/ 目录:统一管理所有技术文档
- 中英文双语:所有文档提供完整的中英文对照
- GitHub 链接:使用完整 GitHub 路径,确保正常跳转
🚀 GitHub Actions 优化
修复的问题
- 权限问题:解决 "Resource not accessible by integration" 错误
- 自动发布:确保 Release 能够正常创建
- 多平台构建:优化 Windows、macOS、Linux 构建流程
构建改进
- 更多隐藏导入:添加必要的模块导入,减少运行时错误
- 权限设置:自动设置正确的文件权限
- 错误处理:改进构建过程中的错误处理
🏗️ 项目结构优化
清理工作
- 删除重复文件:清理旧版本的 spec 文件
- 统一版本号:所有文件版本号更新到 2.0.4
- 链接更新:所有文档链接使用完整 GitHub 路径
📦 下载与安装
预编译版本
从 GitHub Releases 下载:
- Windows:
AugmentCode-Free-v2.0.4-windows.exe - macOS:
AugmentCode-Free-v2.0.4-macos.app或AugmentCode-Free-v2.0.4-macos-standalone - Linux:
AugmentCode-Free-v2.0.4-linux
macOS 用户特别说明
如果遇到安全警告:
- 右键点击应用 → 选择"打开"
- 或在系统偏好设置 → 安全性与隐私 → 点击"仍要打开"
- 详细解决方案请查看 macOS 故障排除指南
🔧 技术改进
代码质量
- 错误处理增强:完善异常捕获和处理机制
- 权限检查:新增文件权限检查功能
- 国际化支持:完善多语言支持机制
构建优化
- PyInstaller 配置:优化打包配置,减少体积
- 依赖管理:更精确的依赖导入
- 兼容性改进:提高不同系统版本的兼容性
📖 相关文档
⚠️ 重要提示
- 本项目完全开源免费!
- 如有人向您收费,请立即举报诈骗行为
- 项目地址:https://github.com/BasicProtein/AugmentCode-Free
🙏 致谢
感谢所有用户的反馈和建议,特别是 macOS 用户报告的构建问题,帮助我们不断改进产品质量。
发布日期: 2025年8月22日
版本: v2.0.4
代号: 构建优化版
AugmentCode-Free v2.0.4 - Build Optimized Version
🎉 Release Highlights
AugmentCode-Free v2.0.4 is a significant build optimization release, focusing on resolving macOS build issues, enhancing permission checking functionality, and improving user experience.
🔧 Core Feature Improvements
Enhanced Permission Check
- Smart Read-only Detection: Automatically detects file read-only status to prevent patch failures
- Friendly Error Messages: Provides detailed solutions for permission issues
- Operation Guidance: Offers 5-step detailed instructions when read-only files are detected
- Error Classification: Distinguishes permission issues from other write errors with targeted suggestions
Improved Internationalization
- Bilingual Error Messages: All error prompts support both Chinese and English display
- Detailed Solutions: Error messages include specific resolution steps
- User-Friendly: Automatically displays corresponding language prompts based on system language
Enhanced User Experience
- Automatic Diagnosis: Automatically detects causes when patches fail
- Specific Guidance: Provides actionable solutions
- Reduced Confusion: Clearly distinguishes different types of errors
🍎 macOS Build Fixes
Resolved Issues
- "Failed to create parent directory structure" Error: Resolved through optimized build process
- "IncompatibleBinaryArchError" Architecture Issue: Removed universal2 architecture for better compatibility
- Permission Issues: Automatically handles macOS permissions and security settings
Dual Version Support
- App Bundle Version:
AugmentCode-Free-v2.0.4-macos.app- Standard macOS application - Standalone Executable:
AugmentCode-Free-v2.0.4-macos-standalone- Better compatibility
Architecture Support
- Intel Mac: Full support
- Apple Silicon Mac: Full support
- Auto-Adaptation: Automatically generates corresponding architecture version based on build environment
📚 Documentation Improvements
New Documentation
- macOS Troubleshooting Guide: Specifically addresses macOS-related issues
- Updated Build Instructions: Includes latest build methods and troubleshooting
- Automation Scripts: Provides
build_macos.shone-click build script
Documentation Structure Optimization
- docs/ Directory: Unified management of all technical documentation
- Bilingual Support: All documentation provides complete Chinese-English comparison
- GitHub Links: Uses complete GitHub paths to ensure proper navigation
🚀 GitHub Actions Optimization
Fixed Issues
- Permission Issues: Resolved "Resource not accessible by integration" error
- Auto-Publishing: Ensures Release can be created normally
- Multi-Platform Build: Optimized Windows, macOS, Linux build processes
Build Improvements
- More Hidden Imports: Added necessary module imports to reduce runtime errors
- Permission Settings: Automatically sets correct file permissions
- Error Handling: Improved error handling during build process
🏗️ Project Structure Optimization
Cleanup Work
- Removed Duplicate Files: Cleaned up old version spec files
- Unified Version Numbers: Updated all file version numbers to 2.0.4
- Link Updates: All documentation links use complete GitHub paths
📦 Download & Installation
Pre-built Releases
Download from GitHub Releases:
- Windows:
AugmentCode-Free-v2.0.4-windows.exe - macOS:
AugmentCode-Free-v2.0.4-macos.apporAugmentCode-Free-v2.0.4-macos-standalone - Linux:
AugmentCode-Free-v2.0.4-linux
Special Notes for macOS Users
If you encounter security warnings:
- Right-click the application → Select "Open"
- Or go to System Preferences → Security & Privacy → Click "Open Anyway"
- For detailed solutions, see macOS Troubleshooting Guide
🔧 Technical Improvements
Code Quality
- Enhanced Error Handling: Improved exception catching and handling mechanisms
- Permission Checking: Added file permission checking functionality
- Internationalization Support: Improved multi-language support mechanism
Build Optimization
- PyInstaller Configuration: Optimized packaging configuration to reduce size
- Dependency Management: More precise dependency imports
- Compatibility Improvements: Enhanced compatibility with different system versions
📖 Related Documentation
⚠️ Important Notice
- This project is completely open source and free!
- If anyone charges you for it, please report the fraud immediately
- Project URL: https://github.com/BasicProtein/AugmentCode-Free
🙏 Acknowledgments
Thanks to all users for their feedback and suggestions, especially macOS users who reported build issues, helping us continuously improve product quality.
Release Date: August 22, 2025
Version: v2.0.4
Codename: Build Optimized Version
AugmentCode-Free v2.0.3
🎉 AugmentCode-Free v2.0.3 - 国际化优化版本
🎯 主要修复
- ✅ 修复按钮显示问题 - 解决按钮显示键名(如
buttons.run_all)而不是实际文本的问题 - ✅ 修复语言文件缺失 - PyInstaller现在正确包含语言文件,支持完整的中英文切换
- ✅ 完善国际化支持 - 修复所有硬编码中文文本,包括工作线程日志和补丁状态显示
- ✅ 优化用户体验 - 界面文本现在完全支持多语言显示
🔧 技术改进
- PyInstaller配置优化 - 添加
languages和config目录到打包配置 - 工作线程国际化 -
workers.py中所有状态消息支持多语言 - 补丁操作国际化 -
patch_worker.py中所有操作消息支持多语言 - 状态显示国际化 - 补丁状态(已补丁/未补丁)根据语言设置正确显示
📦 下载信息
- 文件名:
AugmentCode-Free-v2.0.3.exe - 文件大小: 37.3 MB
- 支持系统: Windows 10/11 (64位)
- 支持IDE: VS Code, Cursor, Windsurf, JetBrains系列
🚀 使用说明
- 下载
AugmentCode-Free-v2.0.3.exe - 双击运行(首次运行可能需要管理员权限)
- 选择语言(中文/English)
- 选择要处理的IDE
- 点击相应功能按钮
⚠️ 重要提示
- 本项目完全开源免费!
- 如有人向您收费,请立即举报诈骗行为
- 项目地址:https://github.com/BasicProtein/AugmentCode-Free
🔄 从v2.0.2升级
如果您使用的是v2.0.2版本,建议升级到v2.0.3以获得完整的国际化支持和更好的用户体验。
完整更新日志请查看提交记录
🎉 AugmentCode-Free v2.0.3 - Internationalization Optimized Version
🎯 Major Fixes
- ✅ Button Display Issue - Addressed an issue where buttons displayed key names (e.g.,
buttons.run_all) instead of actual text. - ✅ Language File Fix - PyInstaller now correctly includes language files, fully supporting Chinese and English language switching.
- ✅ Improved Internationalization Support - Fixed all hard-coded Chinese text, including worker logs and patch status displays.
- ✅ User Experience Optimization - UI text now fully supports multiple languages.
🔧 Technical Improvements
- PyInstaller Configuration Optimization - Added
languagesandconfigdirectories to the package configuration. - Worker Internationalization - All status messages in
workers.pynow support multiple languages. - Patch Operation Internationalization - All operation messages in
patch_worker.pynow support multiple languages. - Status Display Internationalization - Patch status (patched/unpatched) is displayed correctly based on the language setting.
📦 Download Information
- File Name:
AugmentCode-Free-v2.0.3.exe - File Size: 37.3 MB
- Supported Systems: Windows 10/11 (64-bit)
- Supported IDEs: VS Code, Cursor, Windsurf, JetBrains
🚀 Instructions
- Download
AugmentCode-Free-v2.0.3.exe - Double-click to run (administrator privileges may be required for the first run)
- Select a language (Chinese/English)
- Select the IDE to work with
- Click the corresponding function button
⚠️ Important Note
- This project is completely open source and free!
- If you are being charged, please report the scam immediately.
- Project address: https://github.com/BasicProtein/AugmentCode-Free
🔄 Upgrading from v2.0.2
If you are using v2.0.2, we recommend upgrading to v2.0.3 for full internationalization support and a better user experience.
For a complete changelog, please see the commit log
AugmentCode-Free v2.0.2
AugmentCode-Free v2.0.2
🔍 扩展文件扫描优化
本版本主要优化了扩展文件扫描功能,大幅提升了多IDE兼容性和扫描成功率。
✨ 主要改进
- 🔍 路径模式增强:添加
augment.vscode-augment-*等多种扩展名称模式,提升扫描成功率 - 🔧 搜索策略改进:当标准搜索失败时,自动启用关键词搜索作为备选方案
- ✅ 文件验证优化:支持识别压缩/混淆的扩展文件,基于文件路径进行智能判断
- 📝 调试信息增强:添加详细的搜索过程日志,帮助定位扫描问题
- 🎯 全IDE支持:优化覆盖 VS Code、Cursor、Windsurf 等所有支持的IDE
🐛 修复问题
- 修复了扩展文件扫描失败的问题
- 解决了扩展文件路径模式不完整的问题
- 改进了压缩扩展文件的识别逻辑
- 提升了多IDE环境下的兼容性
📦 下载文件
- Windows 可执行文件:
AugmentCode-Free-v2.0.2.exe - 源代码: 包含所有优化功能的完整源代码
🔧 系统要求
- 操作系统: Windows 7/10/11 x64
- 内存: 100MB RAM 最小
- 存储: 50MB 可用空间
🚀 使用方法
- 下载
AugmentCode-Free-v2.0.2.exe - 双击运行(首次运行可能需要管理员权限)
- 选择对应的IDE类型进行扫描和补丁操作
📞 支持与反馈
- GitHub Issues: 提交问题
- Telegram群组: https://t.me/+rL2-my2wYy5hODA1
AugmentCode-Free v2.0.2
🔍 Extension File Scanning Optimization
This version primarily optimizes the extension file scanning function, significantly improving multi-IDE compatibility and scanning success rate.
✨ Major Improvements
- 🔍 Path Pattern Enhancement: Adds various extension name patterns such as
augment.vscode-augment-*to improve scanning success rates - 🔧 Search Strategy Improvement: Automatically uses keyword search as a fallback when standard search fails
- ✅ File Verification Optimization: Supports identification of compressed/obfuscated extension files, making intelligent judgments based on the file path
- 📝 Debug Information Enhancement: Adds detailed search process logs to help locate scanning issues
- 🎯 Full IDE Support: Optimized coverage for all supported IDEs, including VS Code, Cursor, and Windsurf
🐛 Bug Fixes
- Fixed an issue with extension file scanning failures
- Resolved an issue with incomplete extension file path patterns
- Improved the recognition logic for compressed extension files
- Improved compatibility across multiple IDE environments
📦 Download Files
- Windows Executable Files: AugmentCode-Free-v2.0.2.exe
- Source Code: Complete source code including all optimization features
🔧 System Requirements
- Operating System: Windows 7/10/11 x64
- Memory: Minimum 100MB RAM
- Storage: 50MB available space
🚀 Instructions
- Download AugmentCode-Free-v2.0.2.exe
- Double-click to run (administrator privileges may be required for the first run)
- Select the appropriate IDE for scanning and patching
📞 Support and Feedback
- GitHub Issues: Submit an issue
- Telegram Group: https://t.me/+rL2-my2wYy5hODA1
AugmentCode-Free v2.0.1
主要修复:
- 修复MainPage类中_append_log方法名不一致导致的闪退问题
- 重构关于对话框显示机制,解决内容需要拖动才显示的问题
- 将硬编码文本改为国际化支持,添加缺失的语言键值对
- 优化卡片布局和字体大小,确保文字完整显示
- 提升用户体验,所有功能现在可以正常使用
Major fixes:
- Fixed a crash issue caused by inconsistent _append_log method names in the MainPage class.
- Refactored the About dialog display mechanism to resolve the issue where content needed to be dragged to display.
- Modified hard-coded text to support internationalization and added missing language key-value pairs.
- Optimized card layout and font size to ensure complete text display.
- Improved user experience; all features now function normally.
AugmentCode-Free v2.0.0
AugmentCode-Free v2.0.0 发布说明
🎉 版本亮点
🎨 界面优化与多语言完善
- 完美多语言支持:所有界面元素支持中英文实时切换,包括按钮、标签、下拉框选项
- 布局优化:窗口宽度增加至680px,按钮宽度全面提升,确保英文文本完整显示
- 界面细节优化:清空日志按钮定位优化,垂直高度增加,解决显示截断问题
- 用户体验提升:移除多余emoji,界面更简洁专业
🔧 补丁功能集成
- 代码补丁应用:新增补丁应用、恢复、扫描功能
- 多种补丁模式:支持随机假数据、完全阻止、空数据、隐身模式、调试模式
- 状态管理:完善补丁状态检测和管理机制
🧹 代码优化
- 项目清理:删除所有测试文件和无效文档
- 结构优化:清理临时文件和版本文件
- 文档更新:完善README.md,添加最新功能说明
📦 下载文件
- 源码包:
AugmentCode-Free-v2.0.0-Source.zip - 可执行文件:
AugmentCode-Free-v2.0.0.exe(构建中) - 便携版:
AugmentCode-Free-v2.0.0-Portable.zip(构建中)
🔧 系统要求
- 操作系统: Windows 10/11 x64
- Python: 3.7+ (源码运行)
- 支持IDE: VS Code、Cursor、Windsurf、JetBrains 系列
🚀 使用方法
- 下载对应的发布包
- 解压到任意目录
- 运行
AugmentCode-Free-v2.0.0.exe或python main.py - 选择需要清理的IDE
- 点击相应的功能按钮
📝 更新日志
详见项目 README.md 文件中的更新记录。
🎉 Version Highlights
🎨 Interface Optimization and Multilingual Improvement
- Full Multilingual Support: All interface elements support real-time switching between Chinese and English, including buttons, labels, and drop-down options.
- Layout Optimization: Window width increased to 680px, and button widths increased across the board to ensure full display of English text.
- Interface Detail Optimization: Clear log button positioning optimized, vertical height increased to resolve display truncation issues.
- User Experience Improvement: Removed redundant emojis for a cleaner and more professional interface.
🔧 Patch Integration
- Code Patch Application: Added patch application, restore, and scan functions.
- Multiple Patch Modes: Supports random fake data, complete blocking, empty data, incognito mode, and debug mode.
- State Management: Improved patch status detection and management mechanisms.
🧹 Code Optimization
- Project Cleanup: Delete all test files and invalid documents.
- Structural Optimization: Clean up temporary and version files.
- Documentation Update: Improved README.md and added the latest feature descriptions
📦 Download Files
- Source Code:
AugmentCode-Free-v2.0.0-Source.zip - Executable:
AugmentCode-Free-v2.0.0.exe(Under Construction) - Portable Version:
AugmentCode-Free-v2.0.0-Portable.zip(Under Construction)
🔧 System Requirements
- Operating System: Windows 10/11 x64
- Python: 3.7+ (Run from Source)
- Supported IDE: VS Code, Cursor, Windsurf, JetBrains Series
🚀 Instructions
- Download the corresponding release package
- Extract the package to any directory
- Run
AugmentCode-Free-v2.0.0.exeorpython main.py - Select the IDE you want to clean.
- Click the corresponding function button.
📝 Changelog
See the changelog in the project README.md file for details.
发布日期: 2025年8月12日
版本: v2.0.0
作者: BasicProtein
Augment-Tools -v1.0.6
AugmentCode-Free v1.0.6 构建说明 / Build Instructions
Windows 平台 ✅ 已完成 / Windows Platform ✅ Completed
已成功构建 / Successfully built:
AugmentCode-Free-v1.0.6.exe(36.9 MB) - Windows 可执行文件 / Windows executableAugmentCode-Free-v1.0.6-Portable.zip(59 KB) - 跨平台便携包 / Cross-platform portable package
macOS 平台构建 / macOS Platform Build
在 macOS 系统上执行以下命令 / Execute the following commands on macOS:
# 安装依赖 / Install dependencies
pip install pyinstaller PyQt6 psutil click colorama
# 构建 macOS 应用 / Build macOS application
pyinstaller --onefile --windowed \
--name AugmentCode-Free-v1.0.6 \
--distpath dist \
--add-data "augment_tools_core:augment_tools_core" \
--add-data "gui_qt6:gui_qt6" \
--add-data "languages:languages" \
--add-data "config:config" \
--hidden-import PyQt6 \
--hidden-import PyQt6.QtWidgets \
--hidden-import PyQt6.QtCore \
--hidden-import PyQt6.QtGui \
--hidden-import psutil \
--hidden-import xml.etree.ElementTree \
main.py
# 创建 DMG 包(可选)/ Create DMG package (optional)
# 需要安装 create-dmg: brew install create-dmg
# Requires create-dmg: brew install create-dmg
create-dmg \
--volname "AugmentCode-Free v1.0.6" \
--window-pos 200 120 \
--window-size 600 300 \
--icon-size 100 \
--icon "AugmentCode-Free-v1.0.6.app" 175 120 \
--hide-extension "AugmentCode-Free-v1.0.6.app" \
--app-drop-link 425 120 \
"AugmentCode-Free-v1.0.6.dmg" \
"dist/"Linux 平台构建 / Linux Platform Build
在 Linux 系统上执行以下命令 / Execute the following commands on Linux:
# 安装系统依赖(Ubuntu/Debian)/ Install system dependencies (Ubuntu/Debian)
sudo apt update
sudo apt install python3-pip python3-venv
sudo apt install libxcb-xinerama0 libxcb-cursor0 libxcb-icccm4 libxcb-image0 \
libxcb-keysyms1 libxcb-render-util0 libxcb-shape0 libxcb-util1 \
libxcb-xkb1 libxkbcommon-x11-0
# 创建虚拟环境 / Create virtual environment
python3 -m venv venv
source venv/bin/activate
# 安装 Python 依赖 / Install Python dependencies
pip install pyinstaller PyQt6 psutil click colorama
# 构建 Linux 可执行文件 / Build Linux executable
pyinstaller --onefile \
--name AugmentCode-Free-v1.0.6 \
--distpath dist \
--add-data "augment_tools_core:augment_tools_core" \
--add-data "gui_qt6:gui_qt6" \
--add-data "languages:languages" \
--add-data "config:config" \
--hidden-import PyQt6 \
--hidden-import PyQt6.QtWidgets \
--hidden-import PyQt6.QtCore \
--hidden-import PyQt6.QtGui \
--hidden-import psutil \
--hidden-import xml.etree.ElementTree \
main.py
# 创建 AppImage(可选)/ Create AppImage (optional)
# 需要下载 appimagetool / Download appimagetool
wget https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage
chmod +x appimagetool-x86_64.AppImage
# 创建 AppDir 结构 / Create AppDir structure
mkdir -p AugmentCode-Free.AppDir/usr/bin
mkdir -p AugmentCode-Free.AppDir/usr/share/applications
mkdir -p AugmentCode-Free.AppDir/usr/share/icons/hicolor/256x256/apps
# 复制可执行文件 / Copy executable
cp dist/AugmentCode-Free-v1.0.6 AugmentCode-Free.AppDir/usr/bin/
# 创建 .desktop 文件 / Create .desktop file
cat > AugmentCode-Free.AppDir/AugmentCode-Free.desktop << EOF
[Desktop Entry]
Type=Application
Name=AugmentCode-Free
Exec=AugmentCode-Free-v1.0.6
Icon=augmentcode-free
Categories=Development;
EOF
# 创建 AppRun 脚本 / Create AppRun script
cat > AugmentCode-Free.AppDir/AppRun << EOF
#!/bin/bash
cd "\$(dirname "\$0")"
exec ./usr/bin/AugmentCode-Free-v1.0.6 "\$@"
EOF
chmod +x AugmentCode-Free.AppDir/AppRun
# 构建 AppImage / Build AppImage
./appimagetool-x86_64.AppImage AugmentCode-Free.AppDir AugmentCode-Free-v1.0.6-x86_64.AppImage构建验证 / Build Verification
构建完成后,请验证以下功能 / After building, please verify the following functions:
- 启动测试 / Startup Test: 程序能正常启动并显示GUI / Program starts normally and displays GUI
- IDE检测 / IDE Detection: 能正确检测已安装的IDE / Correctly detects installed IDEs
- 功能测试 / Function Test:
- VS Code/Cursor/Windsurf 数据库清理 / Database cleaning
- 遥测ID修改 / Telemetry ID modification
- JetBrains SessionID修改 / JetBrains SessionID modification
- 多语言 / Multi-language: 中英文界面切换正常 / Chinese/English interface switching works properly
- 进程检测 / Process Detection: 能正确检测运行中的IDE进程 / Correctly detects running IDE processes
发布清单 / Release Checklist
每个平台需要提供 / Each platform should provide:
-
Windows:
AugmentCode-Free-v1.0.6.exe✅AugmentCode-Free-v1.0.6-Portable.zip✅
-
macOS:
AugmentCode-Free-v1.0.6.app(或 .dmg / or .dmg)- 便携包已包含在 Windows 构建中 / Portable package included in Windows build
-
Linux:
AugmentCode-Free-v1.0.6(可执行文件 / executable)AugmentCode-Free-v1.0.6-x86_64.AppImage(可选 / optional)- 便携包已包含在 Windows 构建中 / Portable package included in Windows build
注意事项 / Important Notes
- 依赖管理 / Dependency Management: 确保所有平台都包含必要的系统依赖 / Ensure all platforms include necessary system dependencies
- 权限设置 / Permission Settings: Linux/macOS 可执行文件需要执行权限 / Linux/macOS executables need execute permissions
- 代码签名 / Code Signing: macOS 可能需要代码签名以避免安全警告 / macOS may require code signing to avoid security warnings
- 测试环境 / Testing Environment: 在干净的系统上测试以确保依赖完整性 / Test on clean systems to ensure dependency integrity
Augment-Tools -v1.0.5
AugmentCode-Free v1.0.5 构建说明 / Build Instructions
Windows 平台 ✅ 已完成 / Windows Platform ✅ Completed
已成功构建 / Successfully built:
AugmentCode-Free-v1.0.5.exe(36.9 MB) - Windows 可执行文件 / Windows executableAugmentCode-Free-v1.0.5-Portable.zip(59 KB) - 跨平台便携包 / Cross-platform portable package
macOS 平台构建 / macOS Platform Build
在 macOS 系统上执行以下命令 / Execute the following commands on macOS:
# 安装依赖 / Install dependencies
pip install pyinstaller PyQt6 psutil click colorama
# 构建 macOS 应用 / Build macOS application
pyinstaller --onefile --windowed \
--name AugmentCode-Free-v1.0.5 \
--distpath dist \
--add-data "augment_tools_core:augment_tools_core" \
--add-data "gui_qt6:gui_qt6" \
--add-data "languages:languages" \
--add-data "config:config" \
--hidden-import PyQt6 \
--hidden-import PyQt6.QtWidgets \
--hidden-import PyQt6.QtCore \
--hidden-import PyQt6.QtGui \
--hidden-import psutil \
--hidden-import xml.etree.ElementTree \
main.py
# 创建 DMG 包(可选)/ Create DMG package (optional)
# 需要安装 create-dmg: brew install create-dmg
# Requires create-dmg: brew install create-dmg
create-dmg \
--volname "AugmentCode-Free v1.0.5" \
--window-pos 200 120 \
--window-size 600 300 \
--icon-size 100 \
--icon "AugmentCode-Free-v1.0.5.app" 175 120 \
--hide-extension "AugmentCode-Free-v1.0.5.app" \
--app-drop-link 425 120 \
"AugmentCode-Free-v1.0.5.dmg" \
"dist/"Linux 平台构建 / Linux Platform Build
在 Linux 系统上执行以下命令 / Execute the following commands on Linux:
# 安装系统依赖(Ubuntu/Debian)/ Install system dependencies (Ubuntu/Debian)
sudo apt update
sudo apt install python3-pip python3-venv
sudo apt install libxcb-xinerama0 libxcb-cursor0 libxcb-icccm4 libxcb-image0 \
libxcb-keysyms1 libxcb-render-util0 libxcb-shape0 libxcb-util1 \
libxcb-xkb1 libxkbcommon-x11-0
# 创建虚拟环境 / Create virtual environment
python3 -m venv venv
source venv/bin/activate
# 安装 Python 依赖 / Install Python dependencies
pip install pyinstaller PyQt6 psutil click colorama
# 构建 Linux 可执行文件 / Build Linux executable
pyinstaller --onefile \
--name AugmentCode-Free-v1.0.5 \
--distpath dist \
--add-data "augment_tools_core:augment_tools_core" \
--add-data "gui_qt6:gui_qt6" \
--add-data "languages:languages" \
--add-data "config:config" \
--hidden-import PyQt6 \
--hidden-import PyQt6.QtWidgets \
--hidden-import PyQt6.QtCore \
--hidden-import PyQt6.QtGui \
--hidden-import psutil \
--hidden-import xml.etree.ElementTree \
main.py
# 创建 AppImage(可选)/ Create AppImage (optional)
# 需要下载 appimagetool / Download appimagetool
wget https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage
chmod +x appimagetool-x86_64.AppImage
# 创建 AppDir 结构 / Create AppDir structure
mkdir -p AugmentCode-Free.AppDir/usr/bin
mkdir -p AugmentCode-Free.AppDir/usr/share/applications
mkdir -p AugmentCode-Free.AppDir/usr/share/icons/hicolor/256x256/apps
# 复制可执行文件 / Copy executable
cp dist/AugmentCode-Free-v1.0.5 AugmentCode-Free.AppDir/usr/bin/
# 创建 .desktop 文件 / Create .desktop file
cat > AugmentCode-Free.AppDir/AugmentCode-Free.desktop << EOF
[Desktop Entry]
Type=Application
Name=AugmentCode-Free
Exec=AugmentCode-Free-v1.0.5
Icon=augmentcode-free
Categories=Development;
EOF
# 创建 AppRun 脚本 / Create AppRun script
cat > AugmentCode-Free.AppDir/AppRun << EOF
#!/bin/bash
cd "\$(dirname "\$0")"
exec ./usr/bin/AugmentCode-Free-v1.0.5 "\$@"
EOF
chmod +x AugmentCode-Free.AppDir/AppRun
# 构建 AppImage / Build AppImage
./appimagetool-x86_64.AppImage AugmentCode-Free.AppDir AugmentCode-Free-v1.0.5-x86_64.AppImage构建验证 / Build Verification
构建完成后,请验证以下功能 / After building, please verify the following functions:
- 启动测试 / Startup Test: 程序能正常启动并显示GUI / Program starts normally and displays GUI
- IDE检测 / IDE Detection: 能正确检测已安装的IDE / Correctly detects installed IDEs
- 功能测试 / Function Test:
- VS Code/Cursor/Windsurf 数据库清理 / Database cleaning
- 遥测ID修改 / Telemetry ID modification
- JetBrains SessionID修改 / JetBrains SessionID modification
- 多语言 / Multi-language: 中英文界面切换正常 / Chinese/English interface switching works properly
- 进程检测 / Process Detection: 能正确检测运行中的IDE进程 / Correctly detects running IDE processes
发布清单 / Release Checklist
每个平台需要提供 / Each platform should provide:
-
Windows:
AugmentCode-Free-v1.0.5.exe✅AugmentCode-Free-v1.0.5-Portable.zip✅
-
macOS:
AugmentCode-Free-v1.0.5.app(或 .dmg / or .dmg)- 便携包已包含在 Windows 构建中 / Portable package included in Windows build
-
Linux:
AugmentCode-Free-v1.0.5(可执行文件 / executable)AugmentCode-Free-v1.0.5-x86_64.AppImage(可选 / optional)- 便携包已包含在 Windows 构建中 / Portable package included in Windows build
注意事项 / Important Notes
- 依赖管理 / Dependency Management: 确保所有平台都包含必要的系统依赖 / Ensure all platforms include necessary system dependencies
- 权限设置 / Permission Settings: Linux/macOS 可执行文件需要执行权限 / Linux/macOS executables need execute permissions
- 代码签名 / Code Signing: macOS 可能需要代码签名以避免安全警告 / macOS may require code signing to avoid security warnings
- 测试环境 / Testing Environment: 在干净的系统上测试以确保依赖完整性 / Test on clean systems to ensure dependency integrity
Augment-Tools -v1.0.4
AugmentCode-Free v1.0.4 Release
Overview
多IDE维护工具包 - 支持VS Code、Cursor、Windsurf
New Features
- Multi-IDE Support: Complete support for VS Code, Cursor, and Windsurf
- Advanced Database Cleaning: Intelligent cleanup of IDE-specific database entries
- Telemetry Management: Comprehensive telemetry ID modification and reset
- Process Management: Automatic detection and management of running IDE processes
- Modern GUI: Intuitive graphical user interface with real-time feedback
- CLI Interface: Full command-line interface for automation and scripting
Technical Improvements
- Modular Architecture: Completely refactored codebase for better maintainability
- Enhanced Error Handling: Comprehensive error handling and user feedback
- Cross-Platform Support: Full compatibility with Windows, Linux, and macOS
- Performance Optimization: Improved execution speed and resource usage
Download Options
Python Package (Recommended)
pip install augment-tools-coreStandalone Downloads
- Windows Executable:
AugmentCode-Free-v1.0.4.exe- No Python installation required - Portable Package:
AugmentCode-Free-v1.0.4-Portable.zip- Cross-platform portable version - Source Package:
AugmentCode-Free-v1.0.4-Source.tar.gz- Complete source code
Installation & Usage
GUI Mode (Recommended)
- Download and extract the portable package
- Run the appropriate startup script for your platform
- Select your IDE and desired operation
- Follow the on-screen instructions
Command Line Mode
# Install the package
pip install augment-tools-core
# Use the CLI
augment-tools --help
augment-tools clean-db --ide vscode
augment-tools modify-ids --ide cursor
augment-tools run-all --ide windsurfImportant Notes
- Ensure you are logged out of your AugmentCode account
- Close all IDE instances before running the tool
- Consider backing up important data
File Verification
All release files include SHA256, SHA1, and MD5 checksums for integrity verification.
See checksums.txt and SHA256SUMS files in the release.
System Requirements
- Python: 3.7 or higher (for source/portable versions)
- Operating System: Windows 7/10/11, Linux, macOS
- Memory: 100MB RAM minimum
- Storage: 50MB free space
Support & Documentation
- Repository: https://github.com/BasicProtein/AugmentCode-Free
- Issues: https://github.com/BasicProtein/AugmentCode-Free/issues
- Documentation: See README.md for complete documentation
Build Information
- Version: v1.0.4
- Build Date: 2025-07-25T19:29:40.786487
- Python Version: 3.10.8
- Platform: Windows-10-10.0.22621-SP0
Author: BasicProtein
License: MIT License
Augment-Tools -v1.0.3
AugmentCode-Free v1.0.3 Release Notes
🎉 Release Information
Version: v1.0.3
Release Date: 2025-07-25
Build Type: Stable Release
🔧 Bug Fixes
About Dialog Display Issue
-
Fixed: Text display issue in "Supported IDEs" and "Main Features" modules on the About page
-
Issue: Text needs to be dragged to display properly
-
Solution: Simplified the style sheet and removed CSS properties that may cause PyQt6 rendering conflicts
-
Impact: Improved user experience, the About dialog box can now display all text content properly
Build System Improvements
-
Fixed: Unicode encoding issues in build scripts
-
Enhancement: Improved error message display, using colors to distinguish SUCCESS/ERROR/WARNING
-
Compatibility: Improved build stability in different coding environments
🧹 Code Cleanup
Project Maintenance
- Removed: Cleaned up useless test files and temporary documents
test_pyqt6.py- PyQt6 test fileABOUT_DIALOG_ISSUE_REPORT.md- Technical report documentRELEASE_v1.0.2_SUMMARY.md- Old version release summary- All
__pycache__cache files - Unified: Unified the version number to v1.0.3 to ensure that all configuration files have the same version
📦 Release Assets
Windows Executable
- File:
AugmentCode-Free-v1.0.3.exe - Size: ~40MB
- Type: Single-file executable program, no need to install Python environment
Portable Package
- File:
AugmentCode-Free-v1.0.3-Portable.zip - Content: Complete source code package, supports cross-platform use
- Usage: Run
python main.pyafter decompression
Python Packages
- Wheel:
augment_tools_core-1.0.3-py3-none-any.whl - Source:
augment-tools-core-1.0.3.tar.gz - Installation:
pip install augment_tools_core-1.0.3-py3-none-any.whl
Verification Files
- Checksums:
checksums.txt- Detailed checksum information - SHA256:
SHA256SUMS- Standard SHA256 checksum format
🎯 Supported IDEs
- VS Code - Full support
- Cursor - Full support
- Windsurf - Full support
⚡ Main Features
- Clean IDE database - Clean cache and temporary files
- Modify telemetry ID - Protect privacy and avoid data collection
- Modify all configurations with one click - Batch configuration management
🔧 System Requirements
- Windows: Windows 10/11 (recommended)
- Python: 3.7+ (only required for portable version)
- Memory: at least 512MB RAM
- Storage: at least 100MB free space
📋 Installation Instructions
Option 1: Windows Executable (recommended)
- Download
AugmentCode-Free-v1.0.3.exe - Double-click to run, no installation required
Option 2: Portable Package
- Download
AugmentCode-Free-v1.0.3-Portable.zip - Unzip to any directory
- Make sure Python 3.7+ is installed
- Run
python main.py
Option 3: Python Package
pip install augment_tools_core-1.0.3-py3-none-any.whl🔐 File Verification
Verify file integrity using SHA256 checksum:
# Windows PowerShell
Get-FileHash filename -Algorithm SHA256
# Linux/macOS
sha256sum filenameCompare the checksum in the SHA256SUMS file to ensure the file has not been tampered with.
🐛 Known Issues
There are currently no known major issues. If you encounter problems, please submit an issue in the GitHub repository.
📞 Support
🙏 Acknowledgments
Thanks to all users for their feedback and suggestions, which help us continue to improve AugmentCode-Free.
Happy Coding! 🚀
AugmentCode-Free v1.0.3 Release Notes
🎉 Release Information
Version: v1.0.3
Release Date: 2025-07-25
Build Type: Stable Release
🔧 Bug Fixes
About Dialog Display Issue
- Fixed: About页面中"支持的IDE"和"主要功能"模块文字显示问题
- Issue: 文字需要拖动窗口才能正常显示
- Solution: 简化了样式表,移除了可能导致PyQt6渲染冲突的CSS属性
- Impact: 提升了用户体验,About对话框现在能正常显示所有文字内容
Build System Improvements
- Fixed: 构建脚本中的Unicode编码问题
- Enhancement: 改进了错误信息显示,使用颜色区分SUCCESS/ERROR/WARNING
- Compatibility: 提升了在不同编码环境下的构建稳定性
🧹 Code Cleanup
Project Maintenance
- Removed: 清理了无用的测试文件和临时文档
test_pyqt6.py- PyQt6测试文件ABOUT_DIALOG_ISSUE_REPORT.md- 技术报告文档RELEASE_v1.0.2_SUMMARY.md- 旧版本发布总结- 所有
__pycache__缓存文件
- Unified: 统一了版本号为v1.0.3,确保所有配置文件版本一致
📦 Release Assets
Windows Executable
- File:
AugmentCode-Free-v1.0.3.exe - Size: ~40MB
- Type: 单文件可执行程序,无需安装Python环境
Portable Package
- File:
AugmentCode-Free-v1.0.3-Portable.zip - Content: 完整源码包,支持跨平台使用
- Usage: 解压后运行
python main.py
Python Packages
- Wheel:
augment_tools_core-1.0.3-py3-none-any.whl - Source:
augment-tools-core-1.0.3.tar.gz - Installation:
pip install augment_tools_core-1.0.3-py3-none-any.whl
Verification Files
- Checksums:
checksums.txt- 详细校验和信息 - SHA256:
SHA256SUMS- 标准SHA256校验和格式
🎯 Supported IDEs
- VS Code - 完全支持
- Cursor - 完全支持
- Windsurf - 完全支持
⚡ Main Features
- 清理IDE数据库 - 清理缓存和临时文件
- 修改遥测ID - 保护隐私,避免数据收集
- 一键修改所有配置 - 批量配置管理
🔧 System Requirements
- Windows: Windows 10/11 (推荐)
- Python: 3.7+ (仅便携版需要)
- Memory: 最少512MB RAM
- Storage: 最少100MB可用空间
📋 Installation Instructions
Option 1: Windows Executable (推荐)
- 下载
AugmentCode-Free-v1.0.3.exe - 双击运行,无需安装
Option 2: Portable Package
- 下载
AugmentCode-Free-v1.0.3-Portable.zip - 解压到任意目录
- 确保已安装Python 3.7+
- 运行
python main.py
Option 3: Python Package
pip install augment_tools_core-1.0.3-py3-none-any.whl🔐 File Verification
使用SHA256校验和验证文件完整性:
# Windows PowerShell
Get-FileHash filename -Algorithm SHA256
# Linux/macOS
sha256sum filename对比 SHA256SUMS 文件中的校验和确保文件未被篡改。
🐛 Known Issues
目前没有已知的重大问题。如果遇到问题,请在GitHub仓库提交Issue。
📞 Support
- GitHub: https://github.com/BasicProtein/AugmentCode-Free
- Issues: https://github.com/BasicProtein/AugmentCode-Free/issues
🙏 Acknowledgments
感谢所有用户的反馈和建议,帮助我们持续改进AugmentCode-Free。
Happy Coding! 🚀
Augment-Tools -v1.0.2
AugmentCode-Free v1.0.2 Release
Overview
多IDE维护工具包 - 支持VS Code、Cursor、Windsurf
What's New in v1.0.2
- UI优化: 关于页面文字居中对齐,警告文字适当换行显示
- 性能提升: 添加进程检查缓存机制,减少按钮响应时间
- 用户体验: 按钮点击后立即显示状态反馈
- 新用户引导: 首次启动时自动显示关于弹窗,可选择不再显示
- 版本更新: 版本号从v1.0.0更新到v1.0.2
New Features
- Multi-IDE Support: Complete support for VS Code, Cursor, and Windsurf
- Advanced Database Cleaning: Intelligent cleanup of IDE-specific database entries
- Telemetry Management: Comprehensive telemetry ID modification and reset
- Process Management: Automatic detection and management of running IDE processes
- Modern GUI: Intuitive graphical user interface with real-time feedback
- CLI Interface: Full command-line interface for automation and scripting
Technical Improvements
- Modular Architecture: Completely refactored codebase for better maintainability
- Enhanced Error Handling: Comprehensive error handling and user feedback
- Cross-Platform Support: Full compatibility with Windows, Linux, and macOS
- Performance Optimization: Improved execution speed and resource usage
Download Options
Python Package (Recommended)
pip install augment-tools-core==1.0.2Standalone Downloads
- Windows Executable:
AugmentCode-Free-v1.0.2.exe(11.32 MB) - No Python installation required - Portable Package:
AugmentCode-Free-v1.0.2-Portable.zip(30 KB) - Cross-platform portable version - Python Wheel:
augment_tools_core-1.0.2-py3-none-any.whl- For pip installation - Source Package:
augment-tools-core-1.0.2.tar.gz- Complete source code
Installation & Usage
GUI Mode (Recommended)
- Download and extract the portable package
- Run the appropriate startup script for your platform
- Select your IDE and desired operation
- Follow the on-screen instructions
Command Line Mode
# Install the package
pip install augment-tools-core
# Use the CLI
augment-tools --help
augment-tools clean-db --ide vscode
augment-tools modify-ids --ide cursor
augment-tools run-all --ide windsurfImportant Notes
- Ensure you are logged out of your AugmentCode account
- Close all IDE instances before running the tool
- Consider backing up important data
File Verification
All release files include SHA256, SHA1, and MD5 checksums for integrity verification.
See checksums.txt and SHA256SUMS files in the release.
System Requirements
- Python: 3.7 or higher (for source/portable versions)
- Operating System: Windows 7/10/11, Linux, macOS
- Memory: 100MB RAM minimum
- Storage: 50MB free space
Support & Documentation
- Repository: https://github.com/BasicProtein/AugmentCode-Free
- Issues: https://github.com/BasicProtein/AugmentCode-Free/issues
- Documentation: See README.md for complete documentation
Build Information
- Version: v1.0.2
- Build Date: 2025-07-24T01:48:22.946758
- Python Version: 3.10.8
- Platform: Windows-10-10.0.22621-SP0
Author: BasicProtein
License: MIT License