# Nexus-Console

**Repository Path**: YunAbove/Nexus-Console

## Basic Information

- **Project Name**: Nexus-Console
- **Description**: UI-AUTO：专注于UI自动化测试的开源项目，提供高效的测试框架和工具，支持多种平台和语言，助力开发者提升测试效率与质量。
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-20
- **Last Updated**: 2026-10-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Nexus-Console

[English](README.md) | 中文

**Nexus 测试平台的 UI 自动化引擎。**

## 项目定位

Nexus-Console 从 ui-test 演进而来，基于 Playwright、Page Object、会话管理和数据夹具，为 DOSS 业务提供可维护的浏览器自动化能力。

框架负责浏览器、会话、页面对象、流程和数据能力，业务测试负责具体的业务链路和断言。

## 仓库地址

- GitHub：https://github.com/Abovetheclouds306/Nexus-Console
- Gitee：https://gitee.com/YunAbove/Nexus-Console

两个远端保持同一份代码，主分支为 master。

## V1.0 与 V2.0

V1.0 框架基线已经阶段性完结：

- Page Object、浏览器、会话和数据能力已从业务流程中分离。
- 旧页面和旧测试入口继续保留，便于兼容和回退。
- framework profile 已完成离线回归。
- 关键 UI 业务链路已完成验证。

V2.0 继续处理完整真实业务链路、审批/封停组合链路、legacy 页面桥接、固定等待收敛和更强的业务状态断言。跨浏览器暂不作为 V2.0 必达项。

## 核心能力

- Page Object：集中维护定位器和页面行为。
- Playwright：浏览器启动、登录、会话和页面交互。
- 配置驱动：环境变量、本地配置和示例配置分层加载。
- 动态数据：UserFactory、TestContext 和 DataFactory。
- 框架插件：为只读、写入试点和业务流程提供可控适配器。
- Agent 辅助：docs2tests、修复和探索工具。

## 快速开始

    # 创建环境并安装依赖
    python -m venv .venv
    # Windows: .venv\Scripts\activate
    pip install -r requirements.txt
    python -m playwright install chromium

    # 根据模板生成本地配置
    python scripts/init.py

    # 编辑 config/config.yaml，或设置 UI_TEST_* 环境变量
    # 配置文件包含测试环境凭据，只保留在本地

    # 先运行不依赖真实环境的框架检查
    python -m pytest -c framework-tests.ini

    # 运行 UI 业务冒烟，需要可访问测试环境
    python -m pytest -m smoke -v

UI 业务用例会启动真实浏览器，并可能写入测试环境。运行前请确认账号、业务数据和清理策略。

## 目录说明

    Nexus-Console/
    ├── pages/                 # Page Object：定位器和页面行为
    ├── tests/                 # UI 和业务流程测试
    ├── fixtures/              # UserFactory、TestContext 和 DataFactory
    ├── config/                # 配置加载和环境设置
    ├── utils/                 # 浏览器、数据库、日志和流程工具
    ├── framework/             # 通用会话、浏览器和断言能力
    ├── plugins/               # DOSS 业务适配器
    ├── agent/                 # Agent 执行循环
    ├── ai_agent/              # docs2tests、修复和探索工具
    └── scripts/init.py        # 本地初始化入口

## 文档与安全

- [仓库协作规则](AGENTS.md)
- [文档与数据策略](DOCS_POLICY.md)
- 业务文档、截图、日志和生成报告保留在本地，不提交到公开仓库。
- .env、config/config.yaml、Token、截图和日志禁止提交。
- test_data/ 和可复用 fixtures/ 清理时必须保留。
- 临时探针、缓存和报告由 .gitignore 忽略。

## 许可证

AGPL-3.0