From b2e65f8e7cbe04d51a36b7f38257cc232665bbf0 Mon Sep 17 00:00:00 2001
From: pionxe <yuisui@foxmail.com>
Date: Wed, 1 Apr 2026 20:09:15 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E5=9C=A8README=E4=B8=AD=E8=A1=A5?=
 =?UTF-8?q?=E5=85=85=E5=AE=89=E8=A3=85=E8=84=9A=E6=9C=AC=E5=91=BD=E4=BB=A4?=
 =?UTF-8?q?=E4=B8=8E=E8=87=AA=E5=8A=A8=E5=8F=91=E5=B8=83=E6=8C=87=E5=8D=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/README.md b/README.md
index f50c6e3c..9a1f2b9c 100644
--- a/README.md
+++ b/README.md
@@ -11,6 +11,28 @@ NeoCode 是一个在终端中运行的 AI 编码助手，采用 ReAct（Reason-A
 - **多 Provider 支持** — OpenAI、Gemini 等主流模型，易于扩展
 - **终端原生体验** — 基于 Bubble Tea 的现代化 TUI
 
+## 一键安装
+
+NeoCode 提供了跨平台的一键安装脚本。无论你是哪种操作系统，只需在终端执行以下命令，脚本将自动探测系统架构、拉取最新 Release 产物并配置好环境变量：
+
+### 🍎 macOS / Linux
+打开终端（Terminal）并运行：
+```bash
+curl -fsSL https://raw.githubusercontent.com/1024XEngineer/neo-code/main/scripts/install.sh | bash
+```
+
+### Windows
+
+打开 PowerShell 并运行：
+
+
+
+```PowerShell
+irm https://raw.githubusercontent.com/pionxe/neo-code/main/scripts/install.ps1 | iex
+```
+
+
+
 ## 快速开始
 
 ### 环境要求
@@ -126,6 +148,35 @@ NeoCode 正处于 MVP 阶段，核心闭环已可用：
 - 🛠️ 工具能力扩展
 - 🔧 稳定性与性能
 
+
+
+## 自动化发版指南
+
+NeoCode 已经集成了 GoReleaser 与 GitHub Actions 的全自动化 CI/CD 流水线。
+
+**作为项目维护者，发布新版本时绝对不需要在本地手动编译或打包二进制文件。** 只需要通过 Git 打一个语义化版本标签（Tag）即可触发全自动构建：
+
+1. **确保主分支代码已就绪**：所有新特性和 Bug 修复均已合并至 `main` 分支。
+
+2. **在本地打上版本标签**（版本号必须以 `v` 开头，如 `v0.1.0`）：
+
+   ```Bash
+   git tag v0.1.0
+   ```
+
+3. **将标签推送到远程仓库**：
+
+   ```Bash
+   git push origin v0.1.0
+   ```
+
+**发布流水线说明：** 推送到远程后，GitHub Actions 会自动接管，整个过程通常耗时 1~2 分钟：
+
+- 自动读取 `.goreleaser.yaml` 配置。
+- 执行跨平台（Windows/macOS/Linux）与多架构（amd64/arm64）的静态交叉编译。
+- 自动将编译产物打包压缩（`.tar.gz` 和 `.zip`），并计算 SHA256 校验和。
+- 自动在项目的 Releases 页面创建一个全新的发版记录，并将所有压缩包作为资产（Assets）挂载上去。
+
 ## License
 
 MIT