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.

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`。