软件工程第一次作业

这个作业属于哪个课程	202601 软件工程 (福州大学 - 计算机与大数据学院)
这个作业要求在哪里	2026秋软件工程个人作业（第一次）
这个作业的目标	熟悉以博客园为中心的实践体系，完成账号开通与实名入班；调用 Hugging Face API 并实现前端交互生成图像；搭建 GitHub 个人主页；完成对自身技能与规划的梳理
学号	102401227

软件工程第一次个人作业：实践报告

一、环境准备

GitHub 账号：https://github.com/echo14670
博客园账号：https://home.cnblogs.com/u/lin123454321

二、Hugging Face API 调用：Flux 真实感图像生成

2.1 账号与 Token

创建账号并申请Token供本地调用

2.2 实现思路

架构：浏览器前端 index.html → 本地后端 backend.py → Hugging Face Inference API → 图片回传展示并自动保存
模型：XLabs-AI/flux-RealismLora
核心代码：

import os
from huggingface_hub import InferenceClient

client = InferenceClient(
    provider="auto",
    api_key=os.environ["HF_TOKEN"],
)

# output is a PIL.Image object
image = client.text_to_image(
    "your prompt",
    model="XLabs-AI/flux-RealismLora:preferred",
)

2.3 API 调用成功记录

2.4 提示词设计思路与迭代

版本	提示词	效果与问题	修改原因
v1	a girl in a room, realistic	人物僵硬、像 CG、背景空洞	无
v2	Portrait of a young woman sitting by a bright library window, natural sunlight, 85mm lens, shallow depth of field, holding a fountain pen writing notes, dust motes, realistic skin texture, no CGI, engaged expression looking thoughtfully at the paper	最接近真实照片	加入明确的镜头、光线、场景、动作叙事与质感提示词

2.5 体验与心得

踩坑：报错不一定是代码问题
api调用一开始遇到"连接超时 10060"和 "SSL: CERTIFICATE_VERIFY_FAILED"等多种网络访问问题，开始以为是代码写错了，后来逐层诊断确认，发现 router.huggingface.co 的 DNS 被投毒到了不可达地址，原因在于电脑装的网络代理工具没有完整覆盖huggingface的所有域名，所以在注册账号时网络环境正常，调用api时无法访问，最后修改网络环境解决，说明仔细检查环境（包括网络环境，代码编译环境等等）的重要性。

三、GitHub 个人主页

方案：Profile README
主页链接：https://github.com/echo14670
主页截图：

四、关于我：技能树与自我评估

已具备的专业知识与能力：
编程语言：C / C++ / Java / Python
Web 与工具：HTML/CSS/JS、Git/GitHub、Linux 基础、VS Code
嵌入式：NXP S32K144（S32 Design Studio）、FreeRTOS、FOC 电机控制、串口 IAP、EasyLogger
AI 与数据：PyTorch、MONAI（医学影像分割入门）、Hugging Face Inference API
感兴趣的方向：数据库 / 算法 / 软件工程实践 / 深度学习
目前欠缺/想提升：大型项目的工程化经验、代码规范与自动化测试、后端与数据库能力，以及把"能跑"打磨成"能用、好用"的产品思维

代码量统计

统计方式：按文件统计GitHub 仓库非空行
当前累计约：1.3万行
本学期结束希望达到：2万行

五、本课程最期待学习的知识与收获

最期待学习的知识与收获：软件工程的系统方法（包括需求分析、设计、测试、团队协作）

六、AI 生成《软件工程学习指南》与我的分析

使用的 AI 工具：DeepSeek
我使用的提示词：

你是一名软件工程课程助教。请为福州大学《软件工程》课程学生生成一份简要学习指南，内容包括：1) 课程核心目标与知识模块；2) 实用的学习方法与时间安排；3) 个人/团队实践项目建议；4) 常见误区；5) 推荐的免费工具与资源。要求简洁、用列表呈现，500~800 字。

AI 生成的指南原文：

福州大学《软件工程》学习指南

一、课程核心目标与知识模块

核心目标：掌握从需求到交付的软件工程化过程，学会在团队中规范协作、高质量地完成一个真实软件项目。
知识模块：软件过程模型（瀑布、敏捷、Scrum）→ 需求工程（用例、用户故事）→ 软件设计（UML、架构与模块化）→ 编码规范 → 软件测试（单元/集成/系统测试）→ 项目管理（Git 协作、进度与风险）→ 文档与质量保障。

二、学习方法与时间安排

坚持"边学边做"：每章学完一周内完成配套练习，不积压到期中。
每周固定投入：2–3 小时编码实践 + 1 小时写文档/复盘；项目按"两周小迭代、四周大版本"推进。
知识点立刻落地：学到 UML、设计模式或测试，马上在自己小项目中试用一遍。

三、个人/团队实践项目建议

选题宜小不宜大：优先选能完整走完流程的题目（如课程表助手、宿舍报修、二手书交易），胜过"大而空"的平台。
角色分工代替简单切模块：轮换承担需求、测试角色，每周站会同步进度，用看板跟踪任务，避免出现"个人孤岛"。
开工前书面确认需求范围，减少后期返工与组内扯皮。

四、常见误区

把写代码当成全部，忽视需求、文档与测试——工程课考核的是规范化的过程与成果。
不做版本管理、不留注释和记录，出问题后难以回溯。
前期拖延、后期熬夜赶工，或直接照搬网上大作业，都违背课程训练目的。

五、推荐免费工具与资源

版本协作：Git + GitHub/Gitee。
建模文档：draw.io（UML/流程图）、Markdown/Typora。
项目看板：GitHub Projects、Trello。
测试质量：Postman、JUnit/pytest、SonarQube 社区版。
学习资源：中国大学 MOOC《软件工程》、邹欣《构建之法》配套资料、博客园技术博客及开源教学仓库。

我的分析：
- 总体评价：AI 指南按"目标—方法—实践—误区—资源"组织，覆盖了软件过程、需求、设计、测试、项目管理等核心模块，整体成体系、层次清晰，作为通用入门指南合格；但它没有结合本课程"博客园班级作业 + GitHub 协作实践"的具体形式，落地性不足。
- 合理之处：一是"边学边做、知识点立刻在小项目里试用"，贴合工程课重实践的特点，避免我只背概念；二是"选题宜小不宜大、完整走完流程"，防止新手一上来就选平台级题目；三是提醒"别把写代码当全部，文档、测试与过程同样重要"，让我明白课程评的是规范与过程。
- 不合理/不适用之处：AI 不知道本课程以博客园（edu.cnblogs.com）班级作业为提交载体，整份指南没提博客写作、Markdown、互评等环节；部分建议超出能力，如每周站会、角色轮换、SonarQube 等流程偏重，容易为流程而流程；也未结合我的实际情况，没指出需先掌握的 Git、Markdown 前置技能。
- 我的采纳与修正：对照作业要求，指南漏了博客园、Markdown、GitHub 与 API 实践这几大载体，我会把"每次实践后用 Markdown 写技术博客并按时提交、互评"列为核心任务，将 Git 基础命令学习前置到团队协作之前，并把通用时间建议改造成按博客作业截止日期倒排的"调研→编码→写博客→互评修改"节奏表。

七、随笔后台编辑截图

posted @ 2026-09-08 00:06 asdadsdf 阅读(13) 评论(0) 收藏举报

刷新页面返回顶部