Release v1.0.0: Complete build system and documentation update

BasicProtein · BasicProtein · commit 2946d7365709 · 2025-07-18T14:09:05.000+08:00
- Add professional build system with comprehensive packaging
- Create Windows executable (11.20 MB)
- Generate portable cross-platform package (28 KB)
- Build Python wheel and source packages
- Update README with complete installation and usage instructions
- Add comprehensive checksums and release notes
- Support for VS Code, Cursor, and Windsurf IDEs
- Modern GUI interface with CLI fallback
- Complete error handling and validation
diff --git a/0.10.0 b/0.10.0
@@ -0,0 +1,5 @@
+Requirement already satisfied: build in d:\software\python\python310\lib\site-packages (1.2.2.post1)
+Requirement already satisfied: packaging>=19.1 in d:\software\python\python310\lib\site-packages (from build) (25.0)
+Requirement already satisfied: pyproject_hooks in d:\software\python\python310\lib\site-packages (from build) (1.2.0)
+Requirement already satisfied: colorama in d:\software\python\python310\lib\site-packages (from build) (0.4.6)
+Requirement already satisfied: tomli>=1.1.0 in d:\software\python\python310\lib\site-packages (from build) (2.0.1)
diff --git a/0.10.0' b/0.10.0'
diff --git a/0.37.0 b/0.37.0
@@ -0,0 +1 @@
+Requirement already satisfied: wheel in d:\software\python\python310\lib\site-packages (0.41.2)
diff --git a/0.40.0 b/0.40.0
@@ -0,0 +1 @@
+Requirement already satisfied: wheel in d:\software\python\python310\lib\site-packages (0.41.2)
diff --git a/0.8.0 b/0.8.0
@@ -0,0 +1,5 @@
+Requirement already satisfied: build in d:\software\python\python310\lib\site-packages (1.2.2.post1)
+Requirement already satisfied: packaging>=19.1 in d:\software\python\python310\lib\site-packages (from build) (25.0)
+Requirement already satisfied: pyproject_hooks in d:\software\python\python310\lib\site-packages (from build) (1.2.0)
+Requirement already satisfied: colorama in d:\software\python\python310\lib\site-packages (from build) (0.4.6)
+Requirement already satisfied: tomli>=1.1.0 in d:\software\python\python310\lib\site-packages (from build) (2.0.1)
diff --git a/4.0.0 b/4.0.0
@@ -0,0 +1,26 @@
+Requirement already satisfied: twine in d:\software\python\python310\lib\site-packages (6.1.0)
+Requirement already satisfied: readme-renderer>=35.0 in d:\software\python\python310\lib\site-packages (from twine) (44.0)
+Requirement already satisfied: requests>=2.20 in d:\software\python\python310\lib\site-packages (from twine) (2.31.0)
+Requirement already satisfied: requests-toolbelt!=0.9.0,>=0.8.0 in d:\software\python\python310\lib\site-packages (from twine) (1.0.0)
+Requirement already satisfied: urllib3>=1.26.0 in d:\software\python\python310\lib\site-packages (from twine) (1.26.15)
+Requirement already satisfied: keyring>=15.1 in d:\software\python\python310\lib\site-packages (from twine) (25.6.0)
+Requirement already satisfied: rfc3986>=1.4.0 in d:\software\python\python310\lib\site-packages (from twine) (2.0.0)
+Requirement already satisfied: rich>=12.0.0 in d:\software\python\python310\lib\site-packages (from twine) (13.3.5)
+Requirement already satisfied: packaging>=24.0 in d:\software\python\python310\lib\site-packages (from twine) (25.0)
+Requirement already satisfied: id in d:\software\python\python310\lib\site-packages (from twine) (1.5.0)
+Requirement already satisfied: pywin32-ctypes>=0.2.0 in d:\software\python\python310\lib\site-packages (from keyring>=15.1->twine) (0.2.3)
+Requirement already satisfied: importlib_metadata>=4.11.4 in d:\software\python\python310\lib\site-packages (from keyring>=15.1->twine) (6.6.0)
+Requirement already satisfied: jaraco.classes in d:\software\python\python310\lib\site-packages (from keyring>=15.1->twine) (3.4.0)
+Requirement already satisfied: jaraco.functools in d:\software\python\python310\lib\site-packages (from keyring>=15.1->twine) (4.2.1)
+Requirement already satisfied: jaraco.context in d:\software\python\python310\lib\site-packages (from keyring>=15.1->twine) (6.0.1)
+Requirement already satisfied: zipp>=0.5 in d:\software\python\python310\lib\site-packages (from importlib_metadata>=4.11.4->keyring>=15.1->twine) (3.15.0)
+Requirement already satisfied: nh3>=0.2.14 in d:\software\python\python310\lib\site-packages (from readme-renderer>=35.0->twine) (0.3.0)
+Requirement already satisfied: docutils>=0.21.2 in d:\software\python\python310\lib\site-packages (from readme-renderer>=35.0->twine) (0.21.2)
+Requirement already satisfied: Pygments>=2.5.1 in d:\software\python\python310\lib\site-packages (from readme-renderer>=35.0->twine) (2.15.1)
+Requirement already satisfied: charset-normalizer<4,>=2 in d:\software\python\python310\lib\site-packages (from requests>=2.20->twine) (3.1.0)
+Requirement already satisfied: idna<4,>=2.5 in d:\software\python\python310\lib\site-packages (from requests>=2.20->twine) (3.4)
+Requirement already satisfied: certifi>=2017.4.17 in d:\software\python\python310\lib\site-packages (from requests>=2.20->twine) (2022.12.7)
+Requirement already satisfied: markdown-it-py<3.0.0,>=2.2.0 in d:\software\python\python310\lib\site-packages (from rich>=12.0.0->twine) (2.2.0)
+Requirement already satisfied: mdurl~=0.1 in d:\software\python\python310\lib\site-packages (from markdown-it-py<3.0.0,>=2.2.0->rich>=12.0.0->twine) (0.1.2)
+Requirement already satisfied: more-itertools in d:\software\python\python310\lib\site-packages (from jaraco.classes->keyring>=15.1->twine) (10.7.0)
+Requirement already satisfied: backports.tarfile in d:\software\python\python310\lib\site-packages (from jaraco.context->keyring>=15.1->twine) (1.2.0)
diff --git a/5.0.0 b/5.0.0
@@ -0,0 +1,7 @@
+Requirement already satisfied: pyinstaller in d:\software\python\python310\lib\site-packages (6.14.2)
+Requirement already satisfied: setuptools>=42.0.0 in d:\software\python\python310\lib\site-packages (from pyinstaller) (63.2.0)
+Requirement already satisfied: altgraph in d:\software\python\python310\lib\site-packages (from pyinstaller) (0.17.4)
+Requirement already satisfied: pefile!=2024.8.26,>=2022.5.30 in d:\software\python\python310\lib\site-packages (from pyinstaller) (2023.2.7)
+Requirement already satisfied: pywin32-ctypes>=0.2.1 in d:\software\python\python310\lib\site-packages (from pyinstaller) (0.2.3)
+Requirement already satisfied: pyinstaller-hooks-contrib>=2025.5 in d:\software\python\python310\lib\site-packages (from pyinstaller) (2025.6)
+Requirement already satisfied: packaging>=22.0 in d:\software\python\python310\lib\site-packages (from pyinstaller) (25.0)
diff --git a/5.13.0 b/5.13.0
@@ -0,0 +1,7 @@
+Requirement already satisfied: pyinstaller in d:\software\python\python310\lib\site-packages (6.14.2)
+Requirement already satisfied: setuptools>=42.0.0 in d:\software\python\python310\lib\site-packages (from pyinstaller) (63.2.0)
+Requirement already satisfied: altgraph in d:\software\python\python310\lib\site-packages (from pyinstaller) (0.17.4)
+Requirement already satisfied: pefile!=2024.8.26,>=2022.5.30 in d:\software\python\python310\lib\site-packages (from pyinstaller) (2023.2.7)
+Requirement already satisfied: pywin32-ctypes>=0.2.1 in d:\software\python\python310\lib\site-packages (from pyinstaller) (0.2.3)
+Requirement already satisfied: pyinstaller-hooks-contrib>=2025.5 in d:\software\python\python310\lib\site-packages (from pyinstaller) (2025.6)
+Requirement already satisfied: packaging>=22.0 in d:\software\python\python310\lib\site-packages (from pyinstaller) (25.0)
diff --git a/60.0.0 b/60.0.0
@@ -0,0 +1 @@
+Requirement already satisfied: setuptools in d:\software\python\python310\lib\site-packages (63.2.0)
diff --git a/68.0.0 b/68.0.0
@@ -0,0 +1 @@
+Requirement already satisfied: setuptools in d:\software\python\python310\lib\site-packages (63.2.0)
diff --git a/README.md b/README.md
@@ -1,7 +1,13 @@
-# AugmentCode-Free
+# AugmentCode-Free v1.0.0
+
 AugmentCode无限免费续杯方案；新账号可获得600次免费的Claude Sonnet 4调用
 
-**支持多IDE**: VS Code、Cursor、Windsurf 的维护工具包
+**支持多IDE**: VS Code、Cursor、Windsurf 的专业维护工具包
+
+[![GitHub release](https://img.shields.io/github/v/release/BasicProtein/AugmentCode-Free)](https://github.com/BasicProtein/AugmentCode-Free/releases)
+[![Python](https://img.shields.io/badge/Python-3.7+-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)](https://github.com/BasicProtein/AugmentCode-Free)
 
 2025年6月18日更新：
 
@@ -80,67 +86,109 @@ Summary: The primary account can be any account, even if it is blocked. The prim
 -   **User Feedback**: Provides clear confirmation dialogs and status messages for all operations.
 -   **Modern Design**: Features animated interface elements and intuitive user experience.
 
-## Installation
-
-1.  **Clone the repository:**
-    ```bash
-    git clone https://github.com/BasicProtein/AugmentCode-Free.git
-    cd AugmentCode-Free
-    ```
-2.  **Install dependencies (if any specified in `requirements.txt` or `setup.py`):**
-    ```bash
-    pip install .
-    # or
-    # pip install -r requirements.txt
-    ```
+## 📥 Installation & Download
 
-## Usage
+### Option 1: Python Package (Recommended)
+Install directly from PyPI (coming soon) or from source:
 
-**⚠️ Important Notes**:
-- Please log out of your AugmentCode account before use
-- Close the IDE background and run the script
-- Recommend backing up important data first
+```bash
+# Install from source
+git clone https://github.com/BasicProtein/AugmentCode-Free.git
+cd AugmentCode-Free
+pip install .
 
-**⚠️ Important Notes**:
-- Please log out of your AugmentCode account before use
-- Close the IDE background and run the script
-- Recommend backing up important data first
+# Or install dependencies manually
+pip install -r requirements.txt
+```
 
-**⚠️ Important Notes**:
-- Please log out of your AugmentCode account before use
-- Close the IDE background and run the script
-- Recommend backing up important data first
+### Option 2: Standalone Downloads
 
-**(Important things should be said three times!)**
+#### Windows Users
+- **Executable**: Download `AugmentCode-Free-v1.0.0.exe` (11.20 MB)
+  - No Python installation required
+  - Double-click to run
+  - Includes all dependencies
 
-You can use AugmentCode-Free in two ways:
+#### Cross-Platform Users
+- **Portable Package**: Download `AugmentCode-Free-v1.0.0-Portable.zip` (28 KB)
+  - Works on Windows, Linux, macOS
+  - Requires Python 3.7+
+  - Extract and run startup script
 
-### 1. Graphical User Interface (GUI) - Recommended
-The GUI provides an easy-to-use interface for all features.
+#### Developers
+- **Source Package**: Download `augment-tools-core-1.0.0.tar.gz` (18 KB)
+- **Wheel Package**: Download `augment_tools_core-1.0.0-py3-none-any.whl` (16 KB)
 
--   **Directly (from project root):**
-    ```bash
-    python main.py
-    ```
+### 📋 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
 
--   **If installed via pip (as `augment-tools-gui`):**
-    ```bash
-    augment-tools-gui
+### 🔐 File Verification
+All release files include SHA256, SHA1, and MD5 checksums for integrity verification.
+Download `checksums.txt` or `SHA256SUMS` from the release page to verify your downloads.
     ```
 
-### 2. Command-Line Interface (CLI)
-For users who prefer the command line or need to script operations.
-
--   **If installed via pip (as `augment-tools`):**
-    ```bash
-    # Show help
-    augment-tools --help
-    
-    # Clean VS Code database
-    augment-tools clean-db --ide vscode
-    
-    # Clean Cursor database
-    augment-tools clean-db --ide cursor
+## 🚀 Usage
+
+### ⚠️ Important Notes
+**Before using this tool:**
+- ✅ **Log out** of your AugmentCode account
+- ✅ **Close all IDE instances** (VS Code, Cursor, Windsurf)
+- ✅ **Backup important data** if needed
+- ✅ The tool will automatically detect and help close running IDEs
+
+### Method 1: GUI Interface (Recommended)
+
+#### Windows Executable
+1. Download `AugmentCode-Free-v1.0.0.exe`
+2. Double-click to run
+3. Select your IDE from the dropdown
+4. Click the desired operation button
+5. Follow on-screen instructions
+
+#### Portable Version
+1. Download and extract `AugmentCode-Free-v1.0.0-Portable.zip`
+2. **Windows**: Double-click `Start-AugmentCode-Free.bat`
+3. **Linux/macOS**: Run `./start-augmentcode-free.sh`
+4. Use the GUI interface as described above
+
+#### From Source
+```bash
+# Clone and install
+git clone https://github.com/BasicProtein/AugmentCode-Free.git
+cd AugmentCode-Free
+pip install -r requirements.txt
+
+# Launch GUI
+python main.py
+```
+
+### Method 2: Command Line Interface
+
+#### After Installation
+```bash
+# Install the package
+pip install augment-tools-core
+
+# Show all available commands
+augment-tools --help
+
+# Clean database for specific IDE
+augment-tools clean-db --ide vscode
+augment-tools clean-db --ide cursor
+augment-tools clean-db --ide windsurf
+
+# Modify telemetry IDs
+augment-tools modify-ids --ide vscode
+augment-tools modify-ids --ide cursor
+augment-tools modify-ids --ide windsurf
+
+# Run all operations (clean + modify)
+augment-tools run-all --ide vscode
+augment-tools run-all --ide cursor
+augment-tools run-all --ide windsurf
     
     # Modify Windsurf telemetry IDs
     augment-tools modify-ids --ide windsurf
diff --git a/build.py b/build.py
diff --git a/setup.py b/setup.py
diff --git a/update_checksums.py b/update_checksums.py

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+Requirement already satisfied: wheel in d:\software\python\python310\lib\site-packages (0.41.2)`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+Requirement already satisfied: setuptools in d:\software\python\python310\lib\site-packages (63.2.0)`