Add heartbeat workflows and backend quality baseline

.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: Backend Quality
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  backend-quality:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --dev
+
+      - name: Run backend quality gate
+        run: make check

.gitignore

@@ -8,3 +8,7 @@ wheels/
 
 # Virtual environments
 .venv
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml

Makefile

@@ -1,4 +1,4 @@
-.PHONY: help build-backend build-electron package-dmg clean install-deps
+.PHONY: help build-backend build-electron package-dmg clean install-deps lint format format-check test test-cov check
 
 # 项目配置
 PROJECT_NAME = AgentForge
@@ -79,4 +79,26 @@ check-dmg:
 		ls -lh "$(DMG_OUTPUT)"; \
 	else \
 		echo "DMG文件不存在"; \
-	fi
+	fi
+
+lint:
+	@echo "运行 Ruff lint..."
+	uv run ruff check .
+
+format:
+	@echo "运行 Ruff format..."
+	uv run ruff format .
+
+format-check:
+	@echo "检查代码格式..."
+	uv run ruff format --check .
+
+test:
+	@echo "运行 Python 测试..."
+	uv run pytest
+
+test-cov:
+	@echo "运行 Python 测试并检查覆盖率..."
+	uv run pytest --cov --cov-report=term-missing
+
+check: lint format-check test-cov

channels/agent_utils.py

@@ -9,7 +9,7 @@
 from __future__ import annotations
 
 import re
-from typing import Optional, TYPE_CHECKING
+from typing import TYPE_CHECKING, Optional
 
 if TYPE_CHECKING:
     from taskboard import TaskDB

channels/dir_utils.py

@@ -10,10 +10,10 @@
 
 from __future__ import annotations
 
+import json
 import os
 import re
-import json
-from typing import Optional, TYPE_CHECKING
+from typing import TYPE_CHECKING, Optional
 
 if TYPE_CHECKING:
     from taskboard import TaskDB
@@ -83,6 +83,7 @@ def extract_working_dir_with_claude(prompt: str) -> Optional[str]:
 
     try:
         import requests  # already in pyproject.toml
+
         resp = requests.post(
             "https://api.anthropic.com/v1/messages",
             headers={