chore: 初始化仓库

docs/reference/env-variables.md

@@ -0,0 +1,94 @@
+# 环境变量
+
+Spaceflow 使用的所有环境变量参考。
+
+## 通用
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| `SPACEFLOW_LANG` | 界面语言 | `zh-CN` |
+| `CI` | 是否在 CI 环境中运行 | — |
+
+## Git Provider
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| `GIT_PROVIDER_TYPE` | Git 平台类型（`github` / `gitea`） | 自动检测 |
+| `GITHUB_TOKEN` | GitHub API Token | — |
+| `GITHUB_SERVER_URL` | GitHub Server URL | `https://github.com` |
+| `GITEA_TOKEN` | Gitea API Token（向后兼容） | — |
+| `GITEA_SERVER_URL` | Gitea Server URL | — |
+
+::: tip 自动检测逻辑
+- 提供 `GITHUB_TOKEN` → 识别为 `github`
+- 提供 `GITEA_TOKEN` → 识别为 `gitea`
+- 都未提供 → 默认 `github`
+- 可通过 `GIT_PROVIDER_TYPE` 显式覆盖
+:::
+
+## LLM 配置
+
+### OpenAI
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| `OPENAI_API_KEY` | OpenAI API Key | — |
+| `OPENAI_BASE_URL` | OpenAI API Base URL | `https://api.openai.com/v1` |
+| `OPENAI_MODEL` | 模型名称 | `gpt-4o` |
+
+### Claude
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| `ANTHROPIC_API_KEY` | Anthropic API Key | — |
+
+### Claude Code
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| `CLAUDE_CODE_BASE_URL` | Claude Code Agent Base URL | — |
+| `CLAUDE_CODE_AUTH_TOKEN` | Claude Code Auth Token | — |
+| `CLAUDE_CODE_MODEL` | 模型名称 | `ark-code-latest` |
+
+### OpenCode
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| `OPENCODE_API_KEY` | OpenCode API Key | — |
+
+## 飞书
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| `FEISHU_APP_ID` | 飞书应用 App ID | — |
+| `FEISHU_APP_SECRET` | 飞书应用 App Secret | — |
+
+## GitHub Actions
+
+在 GitHub Actions 中使用时，以下变量会自动注入：
+
+| 变量 | 说明 |
+|------|------|
+| `GITHUB_TOKEN` | GitHub 自动注入的 Token |
+| `GITHUB_SERVER_URL` | GitHub Server URL |
+| `GITHUB_REPOSITORY` | 仓库全名（`owner/repo`） |
+| `GITHUB_EVENT_NAME` | 事件类型 |
+| `GITHUB_REF` | 触发分支/标签 |
+
+## 使用示例
+
+### 本地开发
+
+```bash
+export GITHUB_TOKEN=ghp_xxxxxxxxxxxx
+export OPENAI_API_KEY=sk-xxxxxxxxxxxx
+spaceflow review -p 123
+```
+
+### CI 环境
+
+```yaml
+env:
+  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+  OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+```