v13.0: 社区经验库+商业化基础设施(A/B/C/D全部完成)

Made-with: Cursor

Author: zcj220

.env.example

@@ -1,29 +1,38 @@
-# TestPilot AI 环境变量配置
-# 复制此文件为 .env 并填入实际值
+# ═══════════════════════════════════════════════════════
+#  TestPilot AI — 环境变量配置
+# ═══════════════════════════════════════════════════════
+#
+#  使用方式：cp .env.example .env && 编辑 .env
+#  注意：.env 文件已在 .gitignore 中，不会被提交
+#
+# ── 数据库 ──────────────────────────────────────
+# 本地开发可不设置（默认使用 SQLite）
+# 生产部署使用 PostgreSQL：
+# DATABASE_URL=postgresql://testpilot:你的密码@db:5432/testpilot
+DB_PASSWORD=changeme_use_strong_password
 
-# ── 服务配置 ──
-TP_SERVER_HOST=127.0.0.1
-TP_SERVER_PORT=8900
-TP_SERVER_RELOAD=true
-TP_SERVER_LOG_LEVEL=DEBUG
-
-# ── 沙箱配置 ──
-TP_SANDBOX_IMAGE=ghcr.io/agent-infra/sandbox:latest
-TP_SANDBOX_APP_PORT=3000
-
-# ── 浏览器配置 ──
-TP_BROWSER_HEADLESS=true
-TP_BROWSER_VIEWPORT_WIDTH=1280
-TP_BROWSER_VIEWPORT_HEIGHT=720
+# ── 认证 ────────────────────────────────────────
+# JWT 签名密钥（必须设置，建议 32+ 位随机字符串）
+# 生成方法：python -c "import secrets; print(secrets.token_urlsafe(32))"
+JWT_SECRET_KEY=changeme_generate_with_secrets_module
 
-# ── AI API 配置（必填） ──
-# 方舟平台 API 密钥（通过 OpenAI SDK 兼容接口调用）
-TP_AI_API_KEY=你的方舟平台API密钥
+# ── AI 服务 ─────────────────────────────────────
+# 方舟平台 API 密钥（不配置则 AI 测试功能不可用）
+TP_AI_API_KEY=
 TP_AI_API_BASE_URL=https://ark.cn-beijing.volces.com/api/v3
-# Doubao-Seed-1.8 统一模型（文本生成 + 视觉理解 + Agent）
 TP_AI_MODEL=doubao-seed-1-8-251228
 # 思考深度：minimal / low / medium / high
 TP_AI_REASONING_EFFORT=medium
 
-# ── 调试模式 ──
-DEBUG=false
+# ── 服务器 ──────────────────────────────────────
+TP_SERVER_HOST=127.0.0.1
+TP_SERVER_PORT=8900
+TP_SERVER_LOG_LEVEL=INFO
+
+# ── 支付（预留） ────────────────────────────────
+# 支付宝/微信支付/Stripe 回调验签密钥
+PAYMENT_WEBHOOK_SECRET=
+
+# ── 管理后台 ────────────────────────────────────
+# 管理员初始密码（首次部署后请立即修改）
+ADMIN_INITIAL_PASSWORD=changeme_admin_2026

Dockerfile

@@ -1,40 +1,47 @@
-# TestPilot AI CI Runner 镜像（v4.0）
+# TestPilot AI — API 服务镜像
 #
-# 用途：CI/CD 环境中运行 TestPilot AI 测试
-#
-# 构建：docker build -t testpilot/runner .
-# 使用：docker run --rm -v ./testpilot.json:/app/blueprint.json testpilot/runner run -b /app/blueprint.json
+# 多阶段构建：
+#   Stage 1: 安装 Python 依赖
+#   Stage 2: 精简运行镜像
 #
+# 构建：docker build -t testpilot/api .
+# 运行：docker run --env-file .env -p 8900:8900 testpilot/api
+
+# ── Stage 1: 依赖安装 ────────────────────────────
+FROM python:3.11-slim AS builder
+
+RUN pip install --no-cache-dir poetry
+
+WORKDIR /build
+COPY pyproject.toml poetry.lock* ./
+
+RUN poetry config virtualenvs.create false \
+    && poetry install --no-interaction --no-root --only main
 
+# ── Stage 2: 运行镜像 ────────────────────────────
 FROM python:3.11-slim
 
-# 安装系统依赖（Playwright 需要）
 RUN apt-get update && apt-get install -y --no-install-recommends \
     curl \
     && rm -rf /var/lib/apt/lists/*
 
-# 安装 Poetry
-RUN pip install --no-cache-dir poetry
+COPY --from=builder /usr/local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages
+COPY --from=builder /usr/local/bin /usr/local/bin
 
 WORKDIR /app
+COPY src/ ./src/
+COPY alembic/ ./alembic/
+COPY alembic.ini cli.py main.py pyproject.toml ./
 
-# 复制依赖文件
-COPY pyproject.toml poetry.lock* ./
+RUN mkdir -p /app/data
 
-# 安装 Python 依赖
-RUN poetry config virtualenvs.create false \
-    && poetry install --no-interaction --no-root
+ENV PYTHONUNBUFFERED=1
+ENV TP_SERVER_HOST=0.0.0.0
+ENV TP_SERVER_PORT=8900
 
-# 安装 Playwright 浏览器
-RUN playwright install chromium \
-    && playwright install-deps chromium
-
-# 复制项目文件
-COPY . .
-
-# 暴露引擎端口
 EXPOSE 8900
 
-# 默认命令：启动引擎
-ENTRYPOINT ["python", "cli.py"]
-CMD ["serve", "--host", "0.0.0.0"]
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
+    CMD curl -f http://localhost:8900/api/v1/health || exit 1
+
+CMD ["python", "-m", "uvicorn", "src.app:app", "--host", "0.0.0.0", "--port", "8900"]

PROGRESS.md

@@ -1,6 +1,6 @@
 # TestPilot AI — 进度备忘录
 
-> 最后更新：2026-03-13
+> 最后更新：2026-03-15（v13.0 社区经验库+商业化 开始）
 
 ---
 
@@ -38,30 +38,40 @@
 
 ---
 
-## 📋 下次继续（待办）
-
-### 高优先
-- [ ] **Phase 2: AI自动评估分享价值 + 弹窗推荐**
-  - 测试完成后，如果发现Bug+Fix记录，AI自动算分享价值（已有calc_share_score）
-  - 超过阈值（如≥5分）弹窗询问用户是否分享到经验库
-  - 文件：`src/community/anonymizer.py` + 插件弹窗逻辑
-
-- [ ] **桌面测试state隔离**
-  - 每次测试前通过`app_exe`参数重启被测应用，确保状态干净
-  - MCP工具`run_desktop_test`需要支持`app_exe`参数
-
-### 中优先
-- [ ] **插件自动闭环开关**
-  - 测试→发现Bug→AI自动修复→重测→直到Bug=0
-  - 需要`auto_repair`开关 + 循环测试逻辑
-
-- [ ] **OCR进一步优化（可选）**
-  - 坐标分析时同时顺带返回页面文字（一次API调用返回坐标+文字）
-  - 需要改prompt格式，解析逻辑要处理混合输出
-
-### 低优先
-- [ ] **桌面应用打包** — `cargo tauri build`（Rust已配置在D:\DevEnv）
-- [ ] **Web测试截图优化** — 类似桌面hash缓存机制
+## 📋 当前重点（v13.0 社区经验库+商业化）
+
+### 🔴 最高优先（v13.0-A/B 在Windows上做）
+- [ ] **Step 1-3: 社区数据模型+Alembic+PG驱动**
+  - 新建 `src/community/models.py`（6张表）
+  - 添加 alembic + psycopg2-binary 依赖
+  - 生成第一个迁移脚本
+- [ ] **Step 4-6: 社区服务层+API路由+测试**
+  - 新建 `src/community/service.py`（20+函数）
+  - 新建 `src/community/routes.py`（15个端点）
+  - 新建 `tests/test_community.py`（≥30个用例）
+- [ ] **Step 7-15: Web门户**
+  - 新建 `web/` React项目（8个页面）
+  - 重点页面：用户主页（勋章墙+贡献统计+经验列表+平台雷达图）
+  - FastAPI集成 或 Nginx独立部署
+
+### 🔴 高优先（v13.0-C/D）
+- [ ] **Step 16-18: 插件社区对接**
+  - 后端API已有→插件自动生效
+  - 测试后分享推荐弹窗
+  - 勋章展示+社区搜索
+- [ ] **Step 19-24: 部署+积分**
+  - Docker Compose（PG+API+Web）
+  - 积分系统（余额/消费/充值）
+  - 支付接口预留
+
+### 🍎 并行（Mac上做）
+- [ ] **v13.0-E: Mac/iOS平台控制器**（不在Windows上改动）
+
+### 保留待办（优先级降低）
+- [ ] 桌面测试state隔离
+- [ ] 插件自动闭环开关
+- [ ] OCR进一步优化
+- [ ] 桌面应用打包
 
 ---
 

alembic.ini

@@ -0,0 +1,149 @@
+# A generic, single database configuration.
+
+[alembic]
+# path to migration scripts.
+# this is typically a path given in POSIX (e.g. forward slashes)
+# format, relative to the token %(here)s which refers to the location of this
+# ini file
+script_location = %(here)s/alembic
+
+# template used to generate migration file names; The default value is %%(rev)s_%%(slug)s
+# Uncomment the line below if you want the files to be prepended with date and time
+# see https://alembic.sqlalchemy.org/en/latest/tutorial.html#editing-the-ini-file
+# for all available tokens
+# file_template = %%(year)d_%%(month).2d_%%(day).2d_%%(hour).2d%%(minute).2d-%%(rev)s_%%(slug)s
+# Or organize into date-based subdirectories (requires recursive_version_locations = true)
+# file_template = %%(year)d/%%(month).2d/%%(day).2d_%%(hour).2d%%(minute).2d_%%(second).2d_%%(rev)s_%%(slug)s
+
+# sys.path path, will be prepended to sys.path if present.
+# defaults to the current working directory.  for multiple paths, the path separator
+# is defined by "path_separator" below.
+prepend_sys_path = .
+
+
+# timezone to use when rendering the date within the migration file
+# as well as the filename.
+# If specified, requires the tzdata library which can be installed by adding
+# `alembic[tz]` to the pip requirements.
+# string value is passed to ZoneInfo()
+# leave blank for localtime
+# timezone =
+
+# max length of characters to apply to the "slug" field
+# truncate_slug_length = 40
+
+# set to 'true' to run the environment during
+# the 'revision' command, regardless of autogenerate
+# revision_environment = false
+
+# set to 'true' to allow .pyc and .pyo files without
+# a source .py file to be detected as revisions in the
+# versions/ directory
+# sourceless = false
+
+# version location specification; This defaults
+# to <script_location>/versions.  When using multiple version
+# directories, initial revisions must be specified with --version-path.
+# The path separator used here should be the separator specified by "path_separator"
+# below.
+# version_locations = %(here)s/bar:%(here)s/bat:%(here)s/alembic/versions
+
+# path_separator; This indicates what character is used to split lists of file
+# paths, including version_locations and prepend_sys_path within configparser
+# files such as alembic.ini.
+# The default rendered in new alembic.ini files is "os", which uses os.pathsep
+# to provide os-dependent path splitting.
+#
+# Note that in order to support legacy alembic.ini files, this default does NOT
+# take place if path_separator is not present in alembic.ini.  If this
+# option is omitted entirely, fallback logic is as follows:
+#
+# 1. Parsing of the version_locations option falls back to using the legacy
+#    "version_path_separator" key, which if absent then falls back to the legacy
+#    behavior of splitting on spaces and/or commas.
+# 2. Parsing of the prepend_sys_path option falls back to the legacy
+#    behavior of splitting on spaces, commas, or colons.
+#
+# Valid values for path_separator are:
+#
+# path_separator = :
+# path_separator = ;
+# path_separator = space
+# path_separator = newline
+#
+# Use os.pathsep. Default configuration used for new projects.
+path_separator = os
+
+# set to 'true' to search source files recursively
+# in each "version_locations" directory
+# new in Alembic version 1.10
+# recursive_version_locations = false
+
+# the output encoding used when revision files
+# are written from script.py.mako
+# output_encoding = utf-8
+
+# database URL.  This is consumed by the user-maintained env.py script only.
+# other means of configuring database URLs may be customized within the env.py
+# file.
+sqlalchemy.url = driver://user:pass@localhost/dbname
+
+
+[post_write_hooks]
+# post_write_hooks defines scripts or Python functions that are run
+# on newly generated revision scripts.  See the documentation for further
+# detail and examples
+
+# format using "black" - use the console_scripts runner, against the "black" entrypoint
+# hooks = black
+# black.type = console_scripts
+# black.entrypoint = black
+# black.options = -l 79 REVISION_SCRIPT_FILENAME
+
+# lint with attempts to fix using "ruff" - use the module runner, against the "ruff" module
+# hooks = ruff
+# ruff.type = module
+# ruff.module = ruff
+# ruff.options = check --fix REVISION_SCRIPT_FILENAME
+
+# Alternatively, use the exec runner to execute a binary found on your PATH
+# hooks = ruff
+# ruff.type = exec
+# ruff.executable = ruff
+# ruff.options = check --fix REVISION_SCRIPT_FILENAME
+
+# Logging configuration.  This is also consumed by the user-maintained
+# env.py script only.
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARNING
+handlers = console
+qualname =
+
+[logger_sqlalchemy]
+level = WARNING
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers =
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stderr,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s [%(name)s] %(message)s
+datefmt = %H:%M:%S

alembic/README

@@ -0,0 +1 @@
+Generic single-database configuration.