docs: revamp and clarify installation and usage documentation

- Refactor and expand installation instructions with clearer separation between automated script and manual binary methods
- Revise and reorganize sections for greater consistency and clarity across English and Chinese README versions
- Improve headings, formatting, and example commands for easier understanding
- Remove duplicate and outdated instructions related to binary installation and usage output
- Update naming and section titles for VSCode Devcontainer setup
- Enhance wording for instructions regarding third-party API services to be more precise

Signed-off-by: appleboy <[email protected]>

Author: appleboy

README.md

@@ -21,11 +21,12 @@ A CLI tool written in [Go](https://go.dev) that generates git commit messages or
   - [Installation](#installation)
     - [macOS](#macos)
     - [Windows](#windows)
-    - [Using install script](#using-install-script)
+    - [Install via Script or Binary](#install-via-script-or-binary)
+      - [**A. Automated Install (Recommended)**](#a-automated-install-recommended)
+      - [**B. Manual Install (Advanced)**](#b-manual-install-advanced)
       - [Configurable Environment Variables](#configurable-environment-variables)
-    - [Pre-compiled Binaries](#pre-compiled-binaries)
     - [From Source](#from-source)
-    - [Using vscode devcontainer](#using-vscode-devcontainer)
+    - [Using VSCode Devcontainer](#using-vscode-devcontainer)
   - [Configuration](#configuration)
     - [How to Customize the Default Prompt Folder](#how-to-customize-the-default-prompt-folder)
     - [How to Change to Azure OpenAI Service](#how-to-change-to-azure-openai-service)
@@ -87,20 +88,47 @@ Install via [Chocolatey](https://chocolatey.org/install):
 choco install codegpt
 ```
 
-### Using install script
+### Install via Script or Binary
+
+For most systems, you can use an install script **or** manually download a pre-compiled binary.
+
+#### **A. Automated Install (Recommended)**
+
+Run the install script to automatically download and set up the latest release:
 
 ```sh
-# Download and run the install script
 bash < <(curl -sSL https://raw.githubusercontent.com/appleboy/CodeGPT/main/install.sh)
 ```
 
 Or download and run manually:
 
 ```sh
+curl -LO https://raw.githubusercontent.com/appleboy/CodeGPT/main/install.sh
 chmod +x install.sh
 ./install.sh
 ```
 
+#### **B. Manual Install (Advanced)**
+
+1. Download the latest pre-compiled binary from the [release page](https://github.com/appleboy/CodeGPT/releases).
+2. Change permissions:
+
+   ```sh
+   chmod 755 codegpt
+   ```
+
+3. Move the binary to your system bin directory:
+
+   ```sh
+   mv codegpt /usr/local/bin/
+   ```
+
+4. Confirm installation:
+
+   ```sh
+   codegpt version
+   ```
+
 #### Configurable Environment Variables
 
 | Variable Name | Default Value      | Description                                                 |
@@ -112,7 +140,7 @@ chmod +x install.sh
 Example usage:
 
 ```sh
-# Install a specific version to a custom directory
+# Install a specific version to a custom directory:
 VERSION=1.1.0 INSTALL_DIR=/opt/codegpt ./install.sh
 ```
 
@@ -122,19 +150,6 @@ The script will:
 2. Download the latest binary
 3. Add the binary to your PATH
 
-### Pre-compiled Binaries
-
-Download the pre-compiled binaries from the [release page](https://github.com/appleboy/CodeGPT/releases). Change the binary permissions to `755` and copy the binary to the system bin directory. Use the `codegpt` command as shown below:
-
-```sh
-$ codegpt version
-Version: 1.1.0
-Git Commit: 899396a
-Build Time: 2025-05-16T15:52:38Z
-Go Version: 1.24.3
-OS/Arch: darwin/arm64
-```
-
 ### From Source
 
 Install from source code:
@@ -143,10 +158,9 @@ Install from source code:
 go install github.com/appleboy/CodeGPT/cmd/codegpt@latest
 ```
 
-### Using vscode devcontainer
+### Using VSCode Devcontainer
 
-Add the [feature](https://github.com/kvokka/features/tree/main/src/codegpt) to
-your devcontainer.json:
+Add the [feature](https://github.com/kvokka/features/tree/main/src/codegpt) to your `devcontainer.json`:
 
 ```json
 "features": {
@@ -324,7 +338,7 @@ See the model list from the [Anthropic API documentation][103].
 
 ### How to Change to [Groq][30] API Service
 
-Get the `API key` from the Groq API Service, please visit [here][31]. Update the `base_url` and `api_key` in your config file.
+Get the `API key` from the Groq API Service by visiting the [Groq API Service][31]. Update the `base_url` and `api_key` in your config file.
 
 ```sh
 codegpt config set openai.provider openai
@@ -344,7 +358,7 @@ GroqCloud currently supports the [following models][32]:
 
 ### How to Change to Ollama API Service
 
-We can use the Llama3 model from the [Ollama][41] API Service, please visit [here][40]. Update the `base_url` in your config file.
+We can use the Llama3 model from the [Ollama][41] API Service; please visit the [Ollama API Models documentation][40]. Update the `base_url` in your config file.
 
 [40]: https://github.com/ollama/ollama/blob/main/docs/openai.md#models
 [41]: https://github.com/ollama/ollama

README.zh-cn.md

@@ -19,10 +19,14 @@
   - [目录](#目录)
   - [功能](#功能)
   - [安装](#安装)
-    - [使用安装脚本](#使用安装脚本)
+    - [macOS](#macos)
+    - [Windows](#windows)
+    - [脚本与二进制安装](#脚本与二进制安装)
+      - [**A. 自动化安装（推荐）**](#a-自动化安装推荐)
+      - [**B. 手动安装（进阶）**](#b-手动安装进阶)
       - [可配置的环境变量](#可配置的环境变量)
     - [从源码安装](#从源码安装)
-    - [使用 VSCode Devcontainer](#使用-vscode-devcontainer)
+    - [VSCode Devcontainer](#vscode-devcontainer)
   - [配置](#配置)
     - [如何自定义默认提示文件夹](#如何自定义默认提示文件夹)
     - [如何切换到 Azure OpenAI 服务](#如何切换到-azure-openai-服务)
@@ -63,33 +67,64 @@
 
 ## 安装
 
-在 macOS 上通过 [Homebrew](http://brew.sh/) 安装
+### macOS
+
+通过 [Homebrew](http://brew.sh/) 安装：
 
 ```sh
 brew tap appleboy/tap
 brew install codegpt
 ```
 
-在 Windows 上通过 [Chocolatey](https://chocolatey.org/install) 安装
+### Windows
+
+通过 [Chocolatey](https://chocolatey.org/install) 安装：
 
 ```sh
 choco install codegpt
 ```
 
-### 使用安装脚本
+### 脚本与二进制安装
+
+大多数系统推荐使用自动化脚本安装（推荐），也可手动下载二进制文件。
+
+#### **A. 自动化安装（推荐）**
+
+执行脚本，自动下载安装最新版：
 
 ```sh
-# 下载并运行安装脚本
 bash < <(curl -sSL https://raw.githubusercontent.com/appleboy/CodeGPT/main/install.sh)
 ```
 
-或手动下载并运行：
+或手动下载脚本后执行：
 
 ```sh
+curl -LO https://raw.githubusercontent.com/appleboy/CodeGPT/main/install.sh
 chmod +x install.sh
 ./install.sh
 ```
 
+#### **B. 手动安装（进阶）**
+
+1. 从 [发布页面](https://github.com/appleboy/CodeGPT/releases) 下载最新二进制文件。
+2. 修改权限：
+
+   ```sh
+   chmod 755 codegpt
+   ```
+
+3. 移动到 bin 目录：
+
+   ```sh
+   mv codegpt /usr/local/bin/
+   ```
+
+4. 验证安装：
+
+   ```sh
+   codegpt version
+   ```
+
 #### 可配置的环境变量
 
 | 变量名        | 默认值             | 说明                                      |
@@ -111,17 +146,6 @@ VERSION=1.1.0 INSTALL_DIR=/opt/codegpt ./install.sh
 2. 下载最新版二进制文件
 3. 将程序加入您的 PATH
 
-可以从 [发布页面](https://github.com/appleboy/CodeGPT/releases) 下载预编译的二进制文件。将二进制文件权限更改为 `755` 并将其复制到系统 bin 目录。使用如下所示的 `codegpt` 命令。
-
-```sh
-$ codegpt version
-Version: 1.1.0
-Git Commit: 899396a
-Build Time: 2025-05-16T15:52:38Z
-Go Version: 1.24.3
-OS/Arch: darwin/arm64
-```
-
 ### 从源码安装
 
 从源码安装：
@@ -130,7 +154,7 @@ OS/Arch: darwin/arm64
 go install github.com/appleboy/CodeGPT/cmd/codegpt@latest
 ```
 
-### 使用 VSCode Devcontainer
+### VSCode Devcontainer
 
 在 devcontainer.json 中添加 [feature](https://github.com/kvokka/features/tree/main/src/codegpt)：
 

README.zh-tw.md

@@ -21,11 +21,12 @@
   - [安裝](#安裝)
     - [macOS](#macos)
     - [Windows](#windows)
-    - [使用安裝腳本](#使用安裝腳本)
+    - [腳本與二進位安裝](#腳本與二進位安裝)
+      - [**A. 自動安裝（推薦）**](#a-自動安裝推薦)
+      - [**B. 手動安裝（進階）**](#b-手動安裝進階)
       - [可設定的環境變數](#可設定的環境變數)
-    - [預編譯二進制文件](#預編譯二進制文件)
     - [從源碼安裝](#從源碼安裝)
-    - [使用 VSCode Devcontainer](#使用-vscode-devcontainer)
+    - [VSCode Devcontainer](#vscode-devcontainer)
   - [配置](#配置)
     - [如何自定義默認提示文件夾](#如何自定義默認提示文件夾)
     - [如何切換到 Azure OpenAI 服務](#如何切換到-azure-openai-服務)
@@ -72,7 +73,7 @@
 
 ### macOS
 
-通過 [Homebrew](http://brew.sh/) 安裝：
+透過 [Homebrew](http://brew.sh/) 安裝：
 
 ```sh
 brew tap appleboy/tap
@@ -81,26 +82,53 @@ brew install codegpt
 
 ### Windows
 
-通過 [Chocolatey](https://chocolatey.org/install) 安裝：
+透過 [Chocolatey](https://chocolatey.org/install) 安裝：
 
 ```sh
 choco install codegpt
 ```
 
-### 使用安裝腳本
+### 腳本與二進位安裝
+
+大多數系統推薦使用安裝腳本自動安裝（推薦），亦可手動下載執行檔。
+
+#### **A. 自動安裝（推薦）**
+
+執行腳本，自動下載與安裝最新版：
 
 ```sh
-# 下載並執行安裝腳本
 bash < <(curl -sSL https://raw.githubusercontent.com/appleboy/CodeGPT/main/install.sh)
 ```
 
-或手動下載並執行：
+或手動下載腳本再執行：
 
 ```sh
+curl -LO https://raw.githubusercontent.com/appleboy/CodeGPT/main/install.sh
 chmod +x install.sh
 ./install.sh
 ```
 
+#### **B. 手動安裝（進階）**
+
+1. 從 [release 頁面](https://github.com/appleboy/CodeGPT/releases) 下載最新二進位檔案。
+2. 更改權限：
+
+   ```sh
+   chmod 755 codegpt
+   ```
+
+3. 移動到 bin 目錄：
+
+   ```sh
+   mv codegpt /usr/local/bin/
+   ```
+
+4. 驗證安裝：
+
+   ```sh
+   codegpt version
+   ```
+
 #### 可設定的環境變數
 
 | 變數名稱      | 預設值             | 說明                                      |
@@ -122,19 +150,6 @@ VERSION=1.1.0 INSTALL_DIR=/opt/codegpt ./install.sh
 2. 下載最新版二進位檔案
 3. 將程式加入您的 PATH
 
-### 預編譯二進制文件
-
-從 [release 頁面](https://github.com/appleboy/CodeGPT/releases) 下載預編譯的二進制文件。將二進制文件的權限更改為 `755`，並將二進制文件複製到系統 bin 目錄。使用如下所示的 `codegpt` 命令：
-
-```sh
-$ codegpt version
-Version: 1.1.0
-Git Commit: 899396a
-Build Time: 2025-05-16T15:52:38Z
-Go Version: 1.24.3
-OS/Arch: darwin/arm64
-```
-
 ### 從源碼安裝
 
 從源碼安裝：
@@ -143,9 +158,9 @@ OS/Arch: darwin/arm64
 go install github.com/appleboy/CodeGPT/cmd/codegpt@latest
 ```
 
-### 使用 VSCode Devcontainer
+### VSCode Devcontainer
 
-在 devcontainer.json 中添加 [feature](https://github.com/kvokka/features/tree/main/src/codegpt)：
+於 devcontainer.json 中新增 [feature](https://github.com/kvokka/features/tree/main/src/codegpt)：
 
 ```json
 "features": {