 从题库到上线，一个人用 AI Agent 搞定安全知识竞赛
2026 年 6 月
# **一、接到一个"不可能"的任务**

我在一家大型快递物流企业的安全管理部门工作。今年 5 月，2026 年安全月来临前夕，领导找到我说：
"搞一个线上安全知识竞赛，让全区员工扫码就能答题，答对了还能抽奖。下周一上线。"
当时是周四下午。
我既不是程序员，也不会写后端——**我的本职工作是对接各网点、搞安全检查、写整改报告。**但安全月的活动不能掉链子。所以我做了一件这个时代每个非程序员都应该做的事：找 AI Agent 帮忙。
三天后，一套完整的在线考试系统上线了。双站点运行，支持数百人同时扫码答题，自动判分，自动抽奖，至今零故障。
这篇文章，我会把从零到一的全过程拆开来讲——包括代码怎么写、域名怎么配、坑怎么踩。哪怕你一行代码都不会写，照着做也能跑起来。
# **二、先把需求定清楚：要做什么**

动手之前，花半小时把需求理清楚，这半小时值后面两天。

| | | |
|:-:|:-:|:-:|
|**需求项**|**具体要求**|**优先级**|
|答题方式|员工用手机扫码进入答题页面，无需下载 App|P0|
|题库管理|从 Excel 题库导入，随机抽题，每题四个选项|P0|
|白名单校验|仅限花名册内的员工参与，防止外部刷题|P0|
|自动判分|提交后实时出分，显示对错|P0|
|抽奖机制|满分才有资格参与抽奖，随机抽取中奖者|P1|
|管理后台|管理员查看成绩、导出数据、公示获奖名单|P1|
|公网访问|有独立域名，员工在任何网络环境都能打开|P0|
|安全稳定|不能崩溃、不能丢数据、不能被人刷|P0|
 
# **三、技术选型：非程序员能驾驭的栈**

项目需求明确后，接下来是技术选型。我的思路很简单：
• **不学新语言。** 用 Python —— 语法简单，资料最多。
• **不装数据库。** 用 JSON 文件存数据 —— 几百人的考试数据，文件系统完全够用。
• **不搞复杂部署。** 本地跑通后，用 Cloudflare Tunnel 把服务暴露到公网，零成本。
• **不手写前端。** 用 Flask 的 Jinja2 模板引擎，HTML 页面直接渲染，把前端复杂度降到最低。
 

| | | |
|:-:|:-:|:-:|
|**技术组件**|**选型**|**理由**|
|后端框架|Flask (Python)|轻量、入门零门槛、中文社区活跃|
|数据存储|JSON 文件|无需安装数据库，读写代码 3 行|
|前端模板|Jinja2|Flask 内置，变量直接嵌入 HTML|
|公网访问|Cloudflare Tunnel|免费、自动 HTTPS、不需要公网 IP|
|域名|Cloudflare DNS|免费托管，与 Tunnel 无缝集成|
|部署环境|腾讯云 Windows 云服务器|已有资源，直接复用|
|AI 辅助|WorkBuddy AI Agent|全流程辅助写代码、排 Bug、配部署|
# **四、系统架构：双站点 + 一条隧道**

先看整体架构，后面每一步都会展开细讲：
 
用户浏览器                          Cloudflare 边缘网络                       腾讯云服务器
 
exam.xxx.site  ───HTTPS───>  Cloudflare Tunnel  ───http───>  Flask :5050  (安全考试)
admin.xxx.site ───HTTPS───>         (同一隧道)       ───http───>  Flask :5051  (行政考试)
 
两个 Flask 实例跑在同一台服务器上，通过 Cloudflare Tunnel 的 Ingress 规则按域名分流：
• **exam.xxx.site → 端口 5050，安全知识考试**
• **admin.xxx.site → 端口 5051，行政生活知识问答**
每个实例内部都包含：题库加载、白名单校验、答题提交、自动判分、结果存储、成绩查看、抽奖。
# **五、关键实现：一步一步来**

## **5.1 题库：从 Excel 到 Python 数据结构**

启动前，我手头有一份 Excel 题库——100 道安全知识题，每题 4 个选项。第一步是先把它变成代码能读的数据。
 
使用 Python 的 openpyxl 库读取 Excel，把每道题转成一个字典对象：
import json, openpyxl
 
wb = openpyxl.load_workbook('考试题.xlsx')
ws = wb.active
questions = []
for row in ws.iter_rows(min_row=2, values_only=True):
    q = {
        'question': row[0],                # 题目
        'options': [row[1],row[2],row[3],row[4]],  # 四个选项
        'answer': int(row[5]) - 1         # 正确答案索引
    }
    questions.append(q)
 
# 保存为 JSON，Flask 启动时直接加载
json.dump(questions, open('questions.json','w'), ensure_ascii=False)
 
## **5.2 Flask 应用：核心逻辑不到 200 行**

Flask 应用的结构非常简单，核心就四个接口：

| | | |
|:-:|:-:|:-:|
|**接口**|**方法**|**功能**|
|/|GET|渲染答题页面（Jinja2 模板）|
|/api/check_whitelist|POST|校验员工是否在白名单中|
|/api/submit|POST|提交答题结果、自动判分|
|/api/results|GET|查看所有成绩（需密码）|
|/api/winners|GET|获取中奖名单|
 
**核心代码骨架：**
from flask import Flask, request, jsonify, render_template
import json, random, os
from datetime import datetime
 
app = Flask(__name__)
 
# 启动时加载题库和白名单
questions = json.load(open('data/questions.json'))
roster   = json.load(open('data/roster.json'))
results  = json.load(open('data/results.json')) if os.path.exists('data/results.json') else []
 
@app.route('/')
def index():
    picked = random.sample(questions, 3)     # 100题里随机抽3题
    return render_template('exam.html', questions=picked)
 
@app.route('/api/submit', methods=['POST'])
def submit():
    data = request.json
    answers = data['answers']                 # 用户提交的答案
    qids = data['qids']                       # 对应题目ID
    score = 0
    for i, qid in enumerate(qids):
        if answers[i] == questions[qid]['answer']:
            score += 1
    entry = { 'name': data['name'], 'score': score, 'time': str(datetime.now()) }
    results.append(entry)
    json.dump(results, open('data/results.json','w'))
    return jsonify({ 'score': score, 'total': len(qids) })
 
if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5050)
 
## **5.3 白名单：防止外部刷题**

安全考试有一个硬需求：只有花名册上的员工才能答题。解决方案是在进入答题页之前加一道校验：
@app.route('/api/check_whitelist', methods=['POST'])
def check_whitelist():
    name = request.json.get('name', '').strip()
    match = None
    for emp in roster:
        if name in emp['name']:             # 模糊匹配
            match = emp
            break
    if match:
        return jsonify({ 'valid': True, 'info': match })
    return jsonify({ 'valid': False, 'msg': '您的信息未在花名册中' })
 
使用模糊匹配而不是精确匹配，是因为员工输入名字时可能有空格、错别字，太严格反而造成体验问题。
 
## **5.4 抽奖：满分才有资格**

抽奖逻辑很简单：从 results 中筛选出满分（3 题全对）的答题者，随机抽取中奖名额：
@app.route('/api/winners')
def winners():
    perfect = [r for r in results if r['score'] == 3]  # 满分
    if len(perfect) <= 10:
        return jsonify(perfect)                           # 不足10人全中奖
    picks = random.sample(perfect, 10)                    # 随机抽10个
    return jsonify(picks)
 
## **5.5 前端：扫码即答，零学习成本**

为了避免"先学怎么用"的障碍，前端设计遵循极简原则：
• **首页就是验证页。** 输入姓名 → 校验白名单 → 进入答题
• **答题页只显示题目。** 每题四个按钮，选完点提交
• **结果页当场出分。** 对错一目了然，不需要等邮件通知
• **移动端优先。** 所有页面在手机上宽度自适应，字号够大
 
Flask 的 Jinja2 模板引擎让前端变得极其简单——变量直接嵌入 HTML：
{% for q in questions %}
<div class="question">
  <h3>第 {{ loop.index }} 题：{{ q.question }}</h3>
  {% for opt in q.options %}
  <button onclick="select({{ loop.index0 }})">{{ opt }}</button>
  {% endfor %}
</div>
{% endfor %}
 
## **5.6 双系统：复制一份给行政考试**

做完安全考试系统后，行政那边也希望搭一套类似的——题库不同、主题色不同、域名不同，但逻辑完全一样。
解决方案很简单：
1. 复制整个 exam_server 文件夹，命名为 exam_server_admin
2. 修改端口：5050 → 5051
3. 替换题库文件和花名册
4. 修改页面标题和配色（红色 → 橙色）
5. Cloudflare Tunnel 加一条路由：admin.xxx.site → :5051
整个复制+改造过程不到一小时就完成了。这就是架构简洁的好处——当系统足够简单时，扩展几乎零成本。
# **六、部署：Cloudflare Tunnel 零成本公网访问**

系统本地跑通后，怎么让外部员工扫码就能打开？这是整个项目最难的一环，也是一般教程最不爱讲的。
传统方案：买域名 → 备案 → 买服务器 → 配 Nginx → 申请 SSL 证书 → 配 HTTPS → 配 DNS。这一套流程，光备案就得等 2-4 周。安全月可等不起。
 
**我选择了 Cloudflare Tunnel。**原理很简单：在你的服务器上跑一个 cloudflared 客户端，它会和 Cloudflare 边缘网络建立一条加密隧道。所有访问你域名的 HTTPS 请求，Cloudflare 自动通过这条隧道转发到你服务器上的本地端口。
 
## **6.1 三步完成部署**

**第一步：安装 cloudflared。**
# Windows 服务器
cloudflared-windows-amd64.exe service install <token>
**第二步：配置 Ingress 路由。**
config.yml 是核心配置文件，决定了哪个域名映射到哪个本地端口：
tunnel: <tunnel-id>
credentials-file: C:\exam\cloudflared\credentials.json
 
ingress:
  - hostname: exam.yanyubaby.site
    service: http://localhost:5050
  - hostname: admin.yanyubaby.site
    service: http://localhost:5051
  - service: http_status:404     # 兜底：其他域名一律 404
**第三步：在 Cloudflare 控制台添加 DNS 记录。**
只需添加一条 CNAME 记录，将你的域名指向隧道 ID。Cloudflare 自动为你签发 SSL 证书，自动提供 HTTPS。是的，完全免费。
 
## **6.2 保活：不能半夜挂掉**

考试系统上线后，最担心的就是服务半夜挂掉，第二天早上同事扫码发现打不开。
解决方法：写一个 PowerShell 保活脚本，每隔 5 分钟检测一次 Flask 端口和 cloudflared 进程，异常时自动重启：
# exam_keepalive.ps1
$ports = @(5050, 5051)
foreach ($port in $ports) {
    $conn = Test-NetConnection -ComputerName localhost -Port $port
    if (-not $conn.TcpTestSucceeded) {
        Start-Process python -ArgumentList "app.py" -WorkingDirectory "...\$port"
    }
}
# 检测 cloudflared 进程
if (-not (Get-Process cloudflared -ErrorAction SilentlyContinue)) {
    Start-Process cloudflared -ArgumentList "tunnel run <tunnel-id>"
}
用 Windows 任务计划程序设置每 5 分钟执行一次，服务再也没无故挂过。
# **七、我踩过的五个坑**

任何一个非程序员做技术项目，都会遇到意料之外的问题。以下是我亲身经历的：
 
## **坑一：华为手机扫码打不开**

**现象：**荣耀/华为手机扫描二维码后，浏览器提示"此网站无法提供安全连接"。苹果和其他安卓手机正常。
**原因：**Cloudflare Tunnel 提供的是 HTTPS。但华为手机的浏览器（基于 Chromium 定制版）对某些非标准 SSL 配置比较敏感——特别是当 Cloudflare 的 Edge Certificate 使用的是共享证书而非专用证书时，华为会拦截。
**解决：**在 Flask 中加入 User-Agent 检测，当识别到华为设备时，自动跳转到引导页面，提示用户改用"扫一扫"中的浏览器打开，或直接复制链接到 Chrome。这个临时方案虽然不完美，但保证了 95% 以上的用户能正常访问。
**长期方案：**域名完成 ICP 备案后，在 Cloudflare 中为该域名申请专用 SSL 证书，即可彻底解决兼容性问题。
 
## **坑二：结果文件被覆盖**

**现象：**某次服务器重启后，之前的答题结果全部丢失。
**原因：**JSON 文件作为数据存储，单文件写入有一个致命问题——程序异常退出时，文件可能只写了一半，导致下次启动时读取失败，框架把它当成空文件重新初始化了。
**解决：**实现双保险机制——每次提交答题结果后，在内存中更新并写回 JSON 的同时，自动备份一个带时间戳的副本：
backup_name = f'results_{datetime.now().strftime("%Y%m%d_%H%M%S")}.json'
json.dump(results, open(f'data/backup/{backup_name}','w'))
同时限制备份数量为 48 份（最近两天的每小时备份），防止磁盘撑满。
 
## **坑三：域名未备案，外部访问不稳定**

**现象：**部分运营商的网络环境下，访问 exam.xxx.site 会出现"连接被重置"。
**原因：**根据中国法律规定，在中国境内提供互联网信息服务的域名必须完成 ICP 备案。Cloudflare Tunnel 虽然提供了 HTTPS 加密，但如果域名指向的实际服务器在中国境内且未备案，部分 ISP 会主动阻断。
**解决：**两种情况——如果服务器在境外（使用 Cloudflare 的全球边缘网络），则无需备案；如果服务器在境内（腾讯云），则需要完成 ICP 备案。我的项目服务器在腾讯云，所以备案是绕不过去的一步。短期方案是限制了使用场景（仅内部员工，在公司 WiFi 下访问）；长期方案是走完备案流程。
 
## **坑四：题库格式"脏"得超乎想象**

**现象：**Excel 题库里有很多"隐形"问题——选项里混着全角括号、多余空格、换行符、乱码字符。
**原因：**题库由多人协作编辑，格式从未统一。比如同一道题的 A 选项，有人写"1.保持冷静"，有人写"1、保持冷静"，还有人写"1: 保持冷静"，这些对于 Python 来说是三个完全不同的字符串。
**解决：**在数据导入阶段增加一个清洗环节——去掉首尾空格、统一全角半角符号、去除不可见字符。这几行代码救了后面所有环节：
def clean(text):
    text = text.strip()
    text = text.replace('\xa0', ' ')           # 全角空格转半角
    text = text.replace('（', '(').replace('）', ')') # 全角括号
    return text
 
## **坑五：AI 写的代码，还是要自己看懂**

**这可能是最重要的一条经验。**
WorkBuddy 帮我写了 90% 的代码，但它不了解我的具体运行环境——Windows 服务器的一些特性、网络策略的限制、企业安全软件的干预，这些都需要我手动排查和适配。
我的做法是：AI 生成一段代码，我当场跑一遍、读一遍、搞清楚每一行在做什么。不是为了写代码而写代码，而是借这个机会学会怎么写代码。三天下来，写完 200 行 Python，我也差不多会写 200 行 Python 了。
# **八、效果与数据**

系统上线后运行至今，实际数据：

| | |
|:-:|:-:|
|**指标**|**数据**|
|参与答题人数|数百人（覆盖全区员工）|
|单日最高并发|无崩溃，Flask 默认并发完全够用|
|系统运行时长|连续运行至今，零主动维护|
|开发耗时|3 天（每天约 4-5 小时）|
|资金成本|0 元（域名自带，Cloudflare Tunnel 免费，无新增服务器）|
 
# **九、总结：非程序员的编程哲学**

回看这三天，我最大的感受是：
**"不会写代码"不再是"做不了软件"的借口。**
 
AI Agent 改变了游戏规则。以前，非程序员要做一套系统，要么花钱外包，要么花几个月自学编程。现在，你只需要：
6. 说清楚你要做什么（需求分析）
7. 让 AI 把方案做出来（代码生成）
8. 跑起来看效果（测试验证）
9. 遇到问题让 AI 修（迭代调试）
10. 部署上线（一键脚本）
 
但这不意味着你什么都不用懂。恰恰相反——
**你需要更懂业务逻辑，**因为 AI 不懂你的行业语境；
**你需要更懂用户需求，**因为 AI 不会替你做产品决策；
**你需要更懂"什么能做、什么不能做"，**因为 AI 会给你一个技术上完美但现实中跑不通的方案。
 
说到底，AI Agent 是一个放大器——它把你"能描述出来的想法"变成"能跑起来的系统"。但想法本身，还是得你自己想。
 
# **附：完整项目文件结构**

给想照着做的同学一个参考：
exam_project/
├── exam_server/                  # 安全考试系统
│   ├── app.py                    # Flask 主应用 (~200行)
│   ├── templates/
│   │   ├── exam.html             # 答题页面
│   │   ├── stats.html            # 管理统计页
│   │   └── winners.html          # 获奖公示页
│   └── data/
│       ├── questions.json        # 100题题库
│       ├── roster.json           # 员工花名册
│       ├── results.json          # 答题结果
│       └── backup/               # 自动备份（最多48份）
├── exam_server_admin/            # 行政考试系统（结构同上）
├── deploy/
│   ├── deploy.bat                # 一键部署脚本
│   ├── cloudflared/
│   │   └── config.yml            # Tunnel 路由配置
│   └── exam_keepalive.ps1        # 保活监控
└── tools/
    ├── extract_doc.py            # 题库提取脚本
    └── gen_qrcode.py             # 二维码生成脚本
 
—— END ——

我在一家大型快递物流企业的安全管理部门工作。今年 5 月，2026 年安全月来临前夕，领导找到我说："搞一个线上安全知识竞赛，让全区员工扫码就能答题，答对了还能抽奖。下周一上线。"当时是周四下午。我既不是程序员，也不会写后端——我的本职工作是对接各网点、搞安全检查、写整改报告。但安全月的活动不能掉链子。所以我做了一件这个时代每个非程序员都应该做的事：找 AI Agent 帮忙。三天后，一套完整的在线考试系统上线了。双站点运行，支持数百人同时扫码答题，自动判分，自动抽奖，至今零故障。这篇文章，我会把从零到一的全过程拆开来讲——包括代码怎么写、域名怎么配、坑怎么踩。哪怕你一行代码都不会写，照着做也能跑起来。

Flask + Cloudflare Tunnel非程序员三天上线在线考试系统全记录

今年 5 月，2026 年安全月来临前夕，领导找到我说："搞一个线上安全知识竞赛，让全区员工扫码就能答题，答对了还能抽奖。下周一上线。"当时是周四下午。我既不是程序员，也不会写后端——我的本职工作是对接各网点、搞安全检查、写整改报告。但安全月的活动不能掉链子。所以我做了一件这个时代每个非程序员都应该做的事：找 AI Agent 帮忙。

一名小专员

后端

开发工具

职业发展

非程序员3天搭建安全知识竞赛系统：用Flask+CloudflareTunnel实现零成本部署，支持扫码答题、自动判分、抽奖功能，解决华为手机兼容性等5大技术难题，数百人参与零故障。

数据存储

数据结构

文件系统

云服务器

服务器

WorkBuddy 

数据库

Windows

Python

路由

Agent

JSON

热销域名限时优惠，新客首年免费！


domain

2026年中大促 | AI 领航 智绘未来

4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Flask + Cloudflare Tunnel非程序员三天上线在线考试系统全记录-腾讯云开发者社区-腾讯云

Flask + Cloudflare Tunnel非程序员三天上线在线考试系统全记录

Flask + Cloudflare Tunnel非程序员三天上线在线考试系统全记录

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐