CertFlow 5分钟快速上手

本文档帮助新用户在 5 分钟内完成 CertFlow 的安装和首次使用。

1. 环境准备

系统要求

  • Windows 10/11 或 Linux/macOS

  • Python 3.11+

  • 约 500MB 磁盘空间

安装 uv（推荐）

# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# Linux/macOS
curl -LsSf https://astral.sh/uv/install.sh | sh

2. 安装 CertFlow

# 克隆仓库
git clone https://github.com/your-repo/CertFlow-PySide6.git
cd CertFlow-PySide6

# 创建虚拟环境并安装
uv venv
uv sync

# 激活虚拟环境
# Windows
.venv\Scripts\activate
# Linux/macOS
source .venv/bin/activate

3. 启动应用

GUI 界面

python run.py

CLI 命令行

python -m certflow.cli --help

4. 第一个操作：导入销售计划

通过 GUI

  1. 点击「导入Excel」按钮

  2. 选择 Excel 文件

  3. 配置列映射（或使用自动检测）

  4. 点击「导入」

通过 CLI

python -m certflow.cli import_sales_plan -f data/xlsx/销售计划.xlsx

5. 第一个操作：打印合格证

通过 GUI打印合格证

  1. 在查询页面选择记录

  2. 点击「打印合格证」

  3. 选择编号规则

  4. 补充参数

  5. 点击「打印」

通过 CLI打印合格证

python -m certflow.cli print_cert --ids 1,2,3

6. 下一步

遇到问题？ 查看 故障排查 或提交 Issue