From 708181a292e8476f82d0e845827a64fb2789f38e Mon Sep 17 00:00:00 2001
From: Gahow Wang <gahow.wang@gmail.com>
Date: Wed, 6 May 2026 16:00:44 +0800
Subject: [PATCH] agent: implement issue #1 - Doc: request CN version README

---
 README.md    |  2 ++
 README_CN.md | 33 +++++++++++++++++++++++++++++++++
 2 files changed, 35 insertions(+)
 create mode 100644 README_CN.md

diff --git a/README.md b/README.md
index 5b875ec..c10fdf9 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,7 @@
 # Agentic Gitea Issue-to-PR Manager
 
+[中文说明](README_CN.md)
+
 Local, auditable CLI service that scans configured Gitea repositories for eligible issues, runs an implementer agent in an isolated workspace, opens a pull request, runs a reviewer agent, and posts a standardized human review summary.
 
 The MVP never merges pull requests.
diff --git a/README_CN.md b/README_CN.md
new file mode 100644
index 0000000..3e88490
--- /dev/null
+++ b/README_CN.md
@@ -0,0 +1,33 @@
+# Agentic Gitea Issue-to-PR Manager
+
+[English](README.md)
+
+一个本地运行、可审计的 CLI 服务，用于扫描已配置 Gitea 仓库中的合格 issue，在隔离工作区中运行实现 agent，创建 pull request，运行评审 agent，并发布标准化的人工评审摘要。
+
+MVP 版本不会合并 pull request。
+
+## 快速开始
+
+```bash
+uv sync
+cp config.example.yaml config.yaml
+# 在 .env 中写入你的 token，例如 GITEA_TOKEN=...
+agent-gitea --config config.yaml sync-repos
+agent-gitea --config config.yaml scan-issues
+agent-gitea --config config.yaml run-once
+```
+
+`sync-repos` 会通过 `/user/repos` 发现已认证 Gitea 用户拥有的仓库；仓库不会列在配置文件中。
+`worker` 会持续同步仓库、扫描 issue，并处理符合条件的任务。
+
+## 命令
+
+- `agent-gitea sync-repos`
+- `agent-gitea scan-issues`
+- `agent-gitea run-once`
+- `agent-gitea worker`
+- `agent-gitea show-task <task_id>`
+- `agent-gitea retry-task <task_id>`
+- `agent-gitea cancel-task <task_id>`
+
+所需的配置结构请参考 `config.example.yaml`。