软件工程第一次个人作业

🎮软工开荒副本：

新手冒险者的AI魔法师转职任务

这个作业属于哪个课程	2026-01软件工程与软件⼯程实践
这个作业要求在哪里	软件工程课程第一次个人作业
这个作业的目标	完成博客园、GitHub、HuggingFace账号准备；模拟调用Flux模型实现AI绘图前后端交互；搭建GitHub个人主页；梳理个人技能树完成自我评估；使用AI生成软件工程学习指南并分析，掌握软件工程项目开发基础流程
学号	102402103

🎮软工新手副本・通关实录📝

副本提示：HuggingFace 远端服务器 SSL 校验触发副本地域限制，无法直接连接 BOSS 接口，本次采用本地模拟模式完成图像生成支线任务。

一、副本前置任务✨

领取主线任务前，需要完成三大装备账号的解锁与配置：

1. GitHub 储物仓库：完成账号注册，完善个人资料，后续将在这里搭建专属个人主页仓库，存放所有任务代码存档。
   
2. 博客园冒险日志营地：注册账号并开通随笔权限，完善头像昵称；添加导师与助教好友，加入 2026 软件工程班级阵营，完成实名认证，成功进入班级圈子。这里用来记录每一次闯关踩坑与任务报告。
   
3. HuggingFace 魔法工坊：注册账号，生成专属魔法令牌 Token，原本准备召唤 Flux 绘图模型Xlabs-AI/flux-RealismLora，但是遭遇SSL 证书校验障碍，远程魔法通道无法连通，因此切换成本地模拟模式，保留全套交互界面完成挑战。

二、支线任务：召唤 AI 画师🤖

2.1 副本环境 & 故障说明

尝试连接 HuggingFace 魔法工坊的 Flux 图像生成模型时，持续弹出 SSL 证书认证失败警告，当前网络环境无法打通远端 API 传送通道。
因此启用本地模拟生成图像方案，前端交互面板完整保留提示词输入框、提交按钮、结果展示区域，服务运行地址：127.0.0.1:5000。

2.2 魔法咒语（提示词）打磨思路

最终定稿魔法咒语：
beautiful dark green forest at dusk, tall pine trees, soft golden sunlight beams through canopy, small glowing fireflies floating above dark green grass, calm mysterious atmosphere, cinematic color

• 初版咒语：beautiful forest at dusk, fireflies floating above grass, pine trees, soft golden sunlight, realistic photo, high detail
  踩坑记录：描述过于笼统，画面氛围感不足，光影细节缺失，AI 渲染效果平淡。
  
• 迭代优化：新增dark green、tall pine trees、sunlight beams through canopy、cinematic color关键词，强化黄昏密林、穿透树冠的光束、萤火虫的静谧氛围感，赋予画面电影级质感。

2.3 副本核心代码展示（本地模拟版）

后端驱动脚本

from flask import Flask, render_template, request, jsonify
import time

app = Flask(__name__)
@app.route('/generate', methods=['POST'])
def generate_image():
    prompt = request.form.get("prompt", "")
    time.sleep(2)
    result_img_url = "/static/forest_result.jpg"
    return jsonify({
        "status": "success",
        "prompt": prompt,
        "image_url": result_img_url
    })
@app.route('/')
def index():
    return render_template("index.html")

if __name__ == '__main__':
    app.run(host="127.0.0.1", port=5000, debug=True)

前端交互面板

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>AI画师召唤面板</title>
    <style>
        .container {width:800px;margin:30px auto;}
        textarea {width:100%;height:120px;padding:10px;font-size:16px;}
        button {margin-top:10px;padding:10px 20px;font-size:16px;cursor:pointer;}
        #result {margin-top:20px;}
        img {max-width:100%;}
    </style>
</head>
<body>
    <div class="container">
        <h2>🧙AI画师召唤台（本地模拟模式）</h2>
        <textarea id="prompt" placeholder="在此输入你的魔法提示词..."></textarea>
        <br>
        <button onclick="startGenerate()">召唤AI画师，开始绘图</button>
        <div id="result"></div>
    </div>

    <script>
        async function startGenerate(){
            const prompt = document.getElementById("prompt").value;
            const resultDom = document.getElementById("result");
            resultDom.innerText = "✨AI画师正在绘制中，请稍候...";
            const formData = new FormData();
            formData.append("prompt", prompt);
            const resp = await fetch("/generate",{method:"POST", body:formData});
            const data = await resp.json();
            resultDom.innerHTML = `<p>✅绘图完成，你的魔法咒语：${data.prompt}</p>
            <img src="${data.image_url}" alt="AI生成图片">`;
        }
    </script>
</body>
</html>

2.4 闯关步骤 & 冒险者心得

1. 登录 HuggingFace 魔法工坊，进入 Settings→Access Tokens，创建读写权限的专属魔法令牌并妥善保存。
2. 编写 Flask 后端驱动脚本，搭建简易 HTML 交互面板，制作提示词输入表单。
3. 发起远程模型调用请求，多次调试后确认 SSL 证书校验失败，远端通道无法连通。
4. 改写脚本，切换成本地模拟图片返回逻辑，完整保留整套前后端交互链路。

冒险者心得：调用第三方远程接口，随时会遭遇网络、证书、权限等突发副本陷阱。写代码不能只盯着功能能不能跑，必须提前预判网络异常、接口报错这类工程风险。本次虽然没能成功连接真实的 HuggingFace 远端 API，但完整打通了前后端交互框架，吃透了 API 调用的完整流程。

三、角色技能树梳理 & 长期练级规划📊

3.1 技能树盘点与自我评估

• ✅ 已解锁技能

1. Python 开发：熟练使用 Flask 搭建简易 Web 后端，通过接口实现前后端数据交互。
2. 数据处理：掌握 numpy、pandas，能够独立完成基础数据清洗与数据分析任务。
3. 版本控制：熟练操作 Git 与 GitHub，可以新建仓库、提交代码、编写个人据点 README。
4. 前端基础：掌握 HTML 基础语法，能够编写简单页面并和后端接口通信。
5. 专业理论：掌握计算机网络、操作系统、数据库等基础理论 buff。

• 💡 感兴趣的练级方向
  AI 应用开发、大模型 API 工程化、Web 后端开发、大数据应用开发
• ⚠️ 待修炼短板

1. 缺少大数据项目的需求拆解、UML 建模、标准化测试这类工程实战经验。
2. 项目架构思路薄弱，没有团队协作、大型数据项目开发的副本经验。
3. 前端技能比较单薄，只会基础 HTML，缺少页面美化、动态交互能力。
4. 代码规范、模块化拆分、单元测试意识不足，工程化能力需要持续打磨。

3.2 练级进度统计

当前累计代码量：约 3800 行（包含课程练习、各类小任务）
本学期副本通关目标：累计 700 行？不，累计 7000 行代码，优先保证代码质量与工程规范，拒绝单纯刷行数的无效练级😉。

3.3 本副本期待解锁的能力与收获

最想解锁技能：大数据场景下的软件工程开发规范。掌握大数据项目需求分析、数据模块设计、系统架构划分、数据测试与项目交付的完整流程。学会把软件工程规范落地在数据处理、数据分析、AI 应用类项目中。
期待收获：搭建大数据工程化思维，掌握数据软件标准化开发流程；学会大数据项目团队分工、迭代开发与项目管理；能够独立完成结构规范、文档齐全、可稳定运行的大数据与 AI 应用项目🚀。

3.4 AI 向导生成练级路线 & 测评🤖

AI 向导：DeepSeek

AI 向导给出的软件工程练级指南

1. 吃透软件生命周期模型，掌握 UML 用例图、类图、时序图绘制。
2. 项目开发严格遵守流程：需求→设计→编码→测试→文档，杜绝一上来直接敲代码🙅。
3. 使用 Git 规范管理项目版本，每一次代码提交都写清楚备注。
4. 学习单元测试，为核心模块编写测试用例，提前捕获程序 bug。
5. 项目通关后及时复盘，记录开发踩坑点与优化方案。

向导合理性测评
这份练级指南整体靠谱，适配本课程闯关学习👍。
优点：覆盖软件工程核心开发流程，帮助养成规范开发习惯，很适合课程实训与小型项目。
缺点：偏向通用软件项目，缺少大数据、数据处理类项目的工程化指导，团队分工与风险应对的内容比较单薄。
结论：可以作为基础练级攻略，后续我会结合大数据专业方向，补充数据项目开发规范、文档撰写与团队协作训练💪。

副本备注：本文部分文字由 AI 辅助生成

五、冒险日志营地后台截图