update version

Author: PetrusZ

README-en.md

@@ -4,7 +4,7 @@
 [![CodeQL](https://github.com/koderover/zadig-review-agent/actions/workflows/codeql.yml/badge.svg)](https://github.com/koderover/zadig-review-agent/actions/workflows/codeql.yml)
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
 
-Read-only, LLM-powered code review for local development and CI workflows.
+An LLM-powered code review agent for local development and CI workflows.
 
 English | [简体中文](README.md)
 
@@ -15,39 +15,34 @@ Zadig Review Agent reviews Git changes, asks a configured language model to iden
 Key properties:
 
 - reviews a workspace, one commit, or a ref range;
-- supports OpenAI, Gemini, and Anthropic protocols through their official Go SDKs;
+- supports OpenAI, Gemini, and Anthropic protocols;
 - applies built-in or repository-specific review rules;
 - exposes only read-only repository tools to the model;
 - returns deterministic exit codes suitable for CI quality gates;
-- never writes comments back to a forge or modifies the reviewed repository.
 
 This project is a review assistant, not a substitute for tests, security analysis, or human review. Model output can be incomplete or incorrect.
 
 ## Requirements
 
-- Go 1.24 or later when building from source
+- Go 1.25.12 or later when building from source
 - Git and a Git repository to review
 - credentials for one supported model provider (not needed for `--preview`)
 
 ## Installation
 
 ### Go install
 
-After the first tagged release is available:
-
 ```bash
 go install github.com/koderover/zadig-review-agent@latest
 ```
 
-`go install` honors the standard `GOPROXY` setting. To use a trusted organization or regional proxy for one installation:
+`go install` honors the standard `GOPROXY` setting. To use a trusted proxy for one installation:
 
 ```bash
-GOPROXY=https://your-go-proxy.example,direct \
+GOPROXY=https://goproxy.cn,direct \
   go install github.com/koderover/zadig-review-agent@latest
 ```
 
-Use an explicit version such as `@v0.1.0` when reproducible installation is more important than tracking the latest release.
-
 ### Release archive
 
 Download the archive for Linux, macOS, or Windows from [GitHub Releases](https://github.com/koderover/zadig-review-agent/releases), then verify it with `checksums.txt`.

README.md

@@ -4,7 +4,7 @@
 [![CodeQL](https://github.com/koderover/zadig-review-agent/actions/workflows/codeql.yml/badge.svg)](https://github.com/koderover/zadig-review-agent/actions/workflows/codeql.yml)
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
 
-面向本地开发和 CI 工作流的只读大模型代码审查工具。
+面向本地开发和 CI 工作流的大模型代码审查 Agent 工具。
 
 [English](README-en.md) | 简体中文
 
@@ -15,39 +15,34 @@ Zadig Review Agent 读取 Git 变更，使用用户配置的大语言模型识
 主要特性：
 
 - 支持审查工作区、单个提交或两个 ref 之间的变更；
-- 通过官方 Go SDK 支持 OpenAI、Gemini 和 Anthropic 协议；
+- 支持 OpenAI、Gemini 和 Anthropic 协议；
 - 支持内置规则和仓库自定义规则；
 - 只向模型提供只读仓库工具；
 - 提供适合 CI 质量门禁的确定性退出码；
-- 不向代码托管平台回写评论，也不修改被审查仓库。
 
 本项目是审查辅助工具，不能替代测试、安全扫描或人工审查。模型输出可能不完整或不准确。
 
 ## 环境要求
 
-- 从源码构建时需要 Go 1.24 或更高版本
+- 从源码构建时需要 Go 1.25.12 或更高版本
 - Git 以及一个待审查的 Git 仓库
-- 一个受支持模型服务的凭证（`--preview` 不需要）
+- 一个支持的 LLM 服务的凭证（`--preview` 不需要）
 
 ## 安装
 
 ### 使用 Go 安装
 
-首个标签版本发布后可执行：
-
 ```bash
 go install github.com/koderover/zadig-review-agent@latest
 ```
 
-`go install` 支持标准 `GOPROXY` 配置。单次安装可以使用可信的企业或区域代理：
+`go install` 支持标准 `GOPROXY` 配置：
 
 ```bash
-GOPROXY=https://your-go-proxy.example,direct \
+GOPROXY=https://goproxy.cn,direct \
   go install github.com/koderover/zadig-review-agent@latest
 ```
 
-如果需要可复现安装，请使用 `@v0.1.0` 等明确版本，不要使用 `@latest`。
-
 ### 下载发布包
 
 从 [GitHub Releases](https://github.com/koderover/zadig-review-agent/releases) 下载 Linux、macOS 或 Windows 压缩包，并使用 `checksums.txt` 校验。
@@ -152,12 +147,12 @@ zadig-review-agent review \
 
 退出码保持稳定：
 
-| 退出码 | 含义 |
-| --- | --- |
-| `0` | 审查完整，且没有 finding 命中 `fail_on`。 |
-| `1` | 审查完整，且至少一个 finding 命中 `fail_on`。 |
-| `2` | 配置、Git、Provider、过滤或审查流程不完整。 |
-| `130` | 进程被取消。 |
+| 退出码 | 含义                                          |
+| ------ | --------------------------------------------- |
+| `0`    | 审查完整，且没有 finding 命中 `fail_on`。     |
+| `1`    | 审查完整，且至少一个 finding 命中 `fail_on`。 |
+| `2`    | 配置、Git、Provider、过滤或审查流程不完整。   |
+| `130`  | 进程被取消。                                  |
 
 默认质量门禁在出现 `critical` 或 `high` finding 时失败，可通过 `review.fail_on` 或 `--fail-on` 调整。
 

internal/cli/cli_test.go

@@ -33,6 +33,18 @@ func TestVersion(t *testing.T) {
 		}
 	}
 
+	version.Version, version.Commit, version.Date = "v0.1.0", "unknown", "unknown"
+	{
+		var stdout, stderr bytes.Buffer
+		code, err := Run(context.Background(), []string{"version"}, &stdout, &stderr)
+		if err != nil || code != 0 {
+			t.Fatalf("code=%d err=%v stderr=%s", code, err, stderr.String())
+		}
+		if got, want := strings.TrimSpace(stdout.String()), "zadig-review-agent v0.1.0"; got != want {
+			t.Fatalf("got %q want %q", got, want)
+		}
+	}
+
 	version.Version = "v1.2.3"
 	version.Commit = "0123456789abcdef"
 	version.Date = "2026-07-20T08:00:00Z"

internal/version/version.go

@@ -1,6 +1,9 @@
 package version
 
-import "fmt"
+import (
+	"fmt"
+	"runtime/debug"
+)
 
 var (
 	Version = "dev"
@@ -9,7 +12,34 @@ var (
 )
 
 func String() string {
-	return fmt.Sprintf("zadig-review-agent %s (commit %s, built %s)", Version, shortCommit(Commit), Date)
+	info, ok := debug.ReadBuildInfo()
+	buildVersion, commit, date := resolveBuildInfo(Version, Commit, Date, info, ok)
+	if buildVersion != "dev" && commit == "unknown" && date == "unknown" {
+		return fmt.Sprintf("zadig-review-agent %s", buildVersion)
+	}
+	return fmt.Sprintf("zadig-review-agent %s (commit %s, built %s)", buildVersion, shortCommit(commit), date)
+}
+
+func resolveBuildInfo(version, commit, date string, info *debug.BuildInfo, ok bool) (string, string, string) {
+	if !ok || version != "dev" || info.Main.Version == "" || info.Main.Version == "(devel)" {
+		return version, commit, date
+	}
+
+	version = info.Main.Version
+	for _, setting := range info.Settings {
+		switch setting.Key {
+		case "vcs.revision":
+			if commit == "unknown" && setting.Value != "" {
+				commit = setting.Value
+			}
+		case "vcs.time":
+			if date == "unknown" && setting.Value != "" {
+				date = setting.Value
+			}
+		}
+	}
+
+	return version, commit, date
 }
 
 func shortCommit(commit string) string {

internal/version/version_test.go

@@ -0,0 +1,56 @@
+package version
+
+import (
+	"runtime/debug"
+	"testing"
+)
+
+func TestResolveBuildInfoUsesModuleVersion(t *testing.T) {
+	info := &debug.BuildInfo{
+		Main: debug.Module{Version: "v0.1.0"},
+		Settings: []debug.BuildSetting{
+			{Key: "vcs.revision", Value: "0123456789abcdef"},
+			{Key: "vcs.time", Value: "2026-07-20T08:00:00Z"},
+		},
+	}
+
+	version, commit, date := resolveBuildInfo("dev", "unknown", "unknown", info, true)
+	if version != "v0.1.0" {
+		t.Fatalf("version = %q, want %q", version, "v0.1.0")
+	}
+	if commit != "0123456789abcdef" {
+		t.Fatalf("commit = %q, want %q", commit, "0123456789abcdef")
+	}
+	if date != "2026-07-20T08:00:00Z" {
+		t.Fatalf("date = %q, want %q", date, "2026-07-20T08:00:00Z")
+	}
+}
+
+func TestResolveBuildInfoPreservesInjectedValues(t *testing.T) {
+	info := &debug.BuildInfo{Main: debug.Module{Version: "v0.1.0"}}
+
+	version, commit, date := resolveBuildInfo(
+		"v1.2.3",
+		"fedcba9876543210",
+		"2026-07-21T08:00:00Z",
+		info,
+		true,
+	)
+	if version != "v1.2.3" || commit != "fedcba9876543210" || date != "2026-07-21T08:00:00Z" {
+		t.Fatalf("got (%q, %q, %q), want injected values", version, commit, date)
+	}
+}
+
+func TestResolveBuildInfoIgnoresDevelopmentBuild(t *testing.T) {
+	info := &debug.BuildInfo{
+		Main: debug.Module{Version: "(devel)"},
+		Settings: []debug.BuildSetting{
+			{Key: "vcs.revision", Value: "0123456789abcdef"},
+		},
+	}
+
+	version, commit, date := resolveBuildInfo("dev", "unknown", "unknown", info, true)
+	if version != "dev" || commit != "unknown" || date != "unknown" {
+		t.Fatalf("got (%q, %q, %q), want development defaults", version, commit, date)
+	}
+}