Skip to content

Rebrand to Reforge with Lyra theme and ScrollArea #29

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
quan0715 merged 1 commit into from
Feb 7, 2026
Merged

Rebrand to Reforge with Lyra theme and ScrollArea #29

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/deploy-gce.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -195,7 +195,7 @@ jobs:
# Optional: Vertex AI (works best when the VM service account has Vertex permissions)
GCP_PROJECT_ID=${{ env.GCP_PROJECT_ID }}
GCP_LOCATION=us-central1
VERTEX_AI_MODEL=gemini-2.5-pro
# NOTE: 模型選擇現在由前端透過 API 參數傳遞，不再需要 VERTEX_AI_MODEL 環境變數

LOG_LEVEL=INFO
EOF
Expand Down
110 changes: 41 additions & 69 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,6 @@
# AI 舊程式碼智能重構系統
# Reforge

AI Refactoring. Measured. Continuous.

基於 LangChain Deep Agents 的智能程式碼分析與重構服務，提供隔離的 Docker 容器環境進行安全的程式碼重構。

Expand Down Expand Up @@ -41,27 +43,27 @@ Dockerfile 位置：

### 啟動服務

**使用 Docker Compose（推薦）**
**Docker Compose（開發/測試）**

```bash
# 啟動所有服務（MongoDB + Backend API + Frontend）
docker-compose -f devops/docker-compose.dev.yml up -d
# 啟動所有服務（PostgreSQL + MongoDB + Backend API + Frontend）
docker-compose -f devops/docker-compose.yml up -d

# 查看服務狀態
docker-compose -f devops/docker-compose.dev.yml ps
docker-compose -f devops/docker-compose.yml ps

# 查看日誌
docker-compose -f devops/docker-compose.dev.yml logs -f api
docker-compose -f devops/docker-compose.yml logs -f api

# 停止服務
docker-compose -f devops/docker-compose.dev.yml down
docker-compose -f devops/docker-compose.yml down
```

**GCE 單機（正式環境）**

- 先將 `refactor-base` / `refactor-api` / `refactor-frontend` 映像推送到 Artifact Registry
- 設定 `REGISTRY_HOST` / `GCP_PROJECT_ID` / `GAR_REPOSITORY` / `IMAGE_TAG` 後，用 `devops/docker-compose.prod.yml` 啟動（會從 Artifact Registry 拉取映像）
- 也可直接使用 `./scripts/deploy-prod.sh`（會先 pull + 啟動）
- 使用 `devops/docker-compose.prod.yml`
- 設定 `REGISTRY_HOST` / `GCP_PROJECT_ID` / `GAR_REPOSITORY` / `IMAGE_TAG`
- 映像從 Artifact Registry 拉取

服務端點：
- Frontend: http://localhost:5173
Expand Down Expand Up @@ -106,7 +108,6 @@ curl -X POST http://localhost:8000/api/v1/auth/login \
### 2. 建立專案

```bash
# 建立專案
curl -X POST http://localhost:8000/api/v1/projects \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
Expand All @@ -120,7 +121,6 @@ curl -X POST http://localhost:8000/api/v1/projects \
### 3. Provision 專案

```bash
# Provision 專案（建立隔離容器並 clone repository）
curl -X POST http://localhost:8000/api/v1/projects/{project_id}/provision \
-H "Authorization: Bearer YOUR_TOKEN"
```
Expand All @@ -143,16 +143,10 @@ curl -N http://localhost:8000/api/v1/projects/{project_id}/agent/runs/{run_id}/s

## 測試

### E2E 測試

```bash
# 執行完整 E2E 測試
./test_cloud_run_e2e_v2.sh
```

### Base Image 測試

```bash
# 測試 base image 建置
export ANTHROPIC_API_KEY=your-api-key
./test_base_image.sh
Expand All @@ -162,65 +156,44 @@ export ANTHROPIC_API_KEY=your-api-key

```
┌─────────────┐ HTTP ┌──────────────────┐
│ Frontend │ ◄─────────────► │ Backend API │
│ (React/Vite)│ │ (FastAPI) │
└─────────────┘ └────────┬─────────┘
│
┌────────────────┼────────────────┐
│ │ │
▼ ▼ ▼
┌──────────┐ ┌──────────────┐ ┌──────────┐
│ MongoDB │ │Docker Network│ │ Project │
│ │ │ │ │Container │
└──────────┘ └──────┬───────┘ └────┬─────┘
│ │
│ HTTP │
└───────────────┤
│
┌─────▼──────┐
│ AI Server │
│ (FastAPI) │
│ │
│ Deep Agent │
└────────────┘
│ Frontend │ <────────────> │ Backend API │
│ (React/Vite)│ │ (FastAPI) │
└─────────────┘ └────────┬─────────┘
│
┌────────────────┼────────────────┐
│ │ │
v v v
┌──────────┐ ┌──────────────┐ ┌──────────┐
│ MongoDB │ │Docker Network│ │ Project │
│ │ │ │ │Container │
└──────────┘ └──────┬───────┘ └────┬─────┘
│ │
│ HTTP │
└───────────────┤
│
┌─────v──────┐
│ AI Server │
│ (FastAPI) │
│ │
│ Deep Agent │
└────────────┘
```

### 核心特性

- **隔離環境**: 每個專案在獨立的 Docker 容器中執行
- **AI Server**: 容器內建 FastAPI HTTP Server，提供 Agent 執行介面
- **異步任務**: 支援長時間執行的 Agent 任務（無 timeout 限制）
- **實時日誌**: SSE 串流提供 Agent 執行過程的實時日誌
- **JWT 認證**: 安全的使用者認證機制

## 技術棧

- **Backend**: FastAPI, Python 3.11, MongoDB
- **Backend**: FastAPI, Python 3.11, MongoDB, PostgreSQL
- **Frontend**: React 18, Vite, TypeScript, Tailwind CSS, shadcn/ui
- **AI/ML**: LangChain, Deep Agents, Anthropic Claude
- **容器**: Docker, Docker Compose
- **認證**: JWT (JSON Web Tokens)

## 📚 文件
## 文件

### 完整文件導覽

請參閱 **[docs/](./docs/)** 資料夾：

- **[docs/API.md](./docs/API.md)** - REST API 完整規格（詳細的 Request/Response）
- **[docs/BACKEND.md](./docs/BACKEND.md)** - 後端技術文件（架構、服務層、部署）
- **[docs/guides/](./docs/guides/)** - 使用指南（CLI 工具等）
- **[docs/API.md](./docs/API.md)** - REST API 完整規格
- **[docs/BACKEND.md](./docs/BACKEND.md)** - 後端技術文件
- **[docs/guides/](./docs/guides/)** - 使用指南
- **[docs/testing/](./docs/testing/)** - 測試文件

### 開發指引

- [CLAUDE.md](./CLAUDE.md) - Claude Code 專案指引
- [docs/README.md](./docs/README.md) - 文件索引

### API 文件

- **Swagger UI**: http://localhost:8000/docs（互動式 API 文件）
- **詳細規格**: [docs/API.md](./docs/API.md)（完整的 Request/Response 範例）
- **[CLAUDE.md](./CLAUDE.md)** - Claude Code 專案指引

## 常見問題

Expand All @@ -235,14 +208,13 @@ docker images | grep refactor-base

1. 檢查容器內 AI Server 的 LLM API Key 設定
2. 查看容器日誌：`docker logs refactor-project-{project_id}`
3. 檢查 API 日誌：`docker-compose -f devops/docker-compose.dev.yml logs -f api`
4. 查看 Agent 執行日誌：使用 SSE stream 端點
3. 檢查 API 日誌：`docker-compose -f devops/docker-compose.yml logs -f api`

### 如何清理測試資料？

```bash
# 停止並移除所有容器和資料
docker-compose -f devops/docker-compose.dev.yml down -v
docker-compose -f devops/docker-compose.yml down -v

# 清理專案容器
docker ps -a | grep refactor-project | awk '{print $1}' | xargs docker rm -f
Expand Down
13 changes: 10 additions & 3 deletions agent/deep_agent.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -149,9 +149,16 @@ def _agent_init(self):
)

# 準備 middleware 列表
# 注意：當 checkpointer 啟用時，SummarizationMiddleware 可能已被自動添加
# 暫時不手動添加 middleware，避免重複
middleware = []
# 啟用 SummarizationMiddleware 來自動壓縮過長的對話歷史
middleware = [
SummarizationMiddleware(
model=self.model,
# 當訊息數量超過 50 條時觸發壓縮
trigger=("messages", 50),
Comment on lines +153 to +157
Copy link

Copilot AI Feb 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

SummarizationMiddleware is enabled unconditionally and uses self.model for summarization. This can materially increase token usage/latency (summarization calls compete with the main agent model) and may not be desired in all environments. Consider making summarization enablement + trigger/keep thresholds configurable via env/config, and optionally using a cheaper/faster model for summarization.

Copilot uses AI. Check for mistakes.
# 壓縮後保留最近的 20 條訊息
keep=("messages", 20),
)
]

self.agent = create_deep_agent(
model=self.model,
Expand Down
94 changes: 0 additions & 94 deletions devops/docker-compose.dev.yml
View file
Open in desktop

This file was deleted.

6 changes: 3 additions & 3 deletions frontend/components.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
{
"$schema": "https://ui.shadcn.com/schema.json",
"style": "default",
"style": "new-york",
"rsc": false,
"tsx": true,
"tailwind": {
"config": "tailwind.config.js",
"css": "src/index.css",
"baseColor": "neutral",
"cssVariables": false,
"baseColor": "stone",
"cssVariables": true,
"prefix": ""
},
"aliases": {
Expand Down
7 changes: 5 additions & 2 deletions frontend/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,12 @@
<html lang="zh-TW">
<head>
<meta charset="UTF-8" />
<link rel="icon" type="image/svg+xml" href="/vite.svg" />
<link rel="icon" type="image/svg+xml" href="/reforge-logo.svg" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>AI 舊程式碼智能重構系統</title>
<title>Reforge</title>
<link rel="preconnect" href="https://fonts.googleapis.com" />
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
<link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:ital,wght@0,300;0,400;0,500;0,600;0,700;1,400&display=swap" rel="stylesheet" />
</head>
<body>
<div id="root"></div>
Expand Down
Loading
Loading