主页 | Echo-SIT

Echo用户帮助手册

Mon, 01 Jan 0001 00:00:00 +0000

一、引言

👋 欢迎使用Echo-SIT团队开发的校园小程序

本小程序是一款面向高校师生的多功能校园服务平台，基于 TypeScript、Vue 3 和现代前端技术栈开发。该小程序支持课表、成绩、消费、图书馆、校园地图等多种实用功能，致力于提升校园数字化体验。

二、如何开始使用

1.打开微信，在微信首页向下滑动，点击右上角"搜索"，在顶部搜索框中输入“Echo回应”

2.首次使用授权：

找到对应的小程序后，点击进入。
首次使用时，系统会提示您输入您的学号/工号及对应密码（就是登录学校OA的密码），以验证您的在校身份。

三、主要功能和使用指南

3.1 课表查询

入口：启动小程序后，默认显示即为课表页面。
课表导入：首次使用或学期更新时，请点击页面左上角的设置按钮，依序选择“更改课表”即可完成导入。若遇学校临时调休，请在此处选择对应的“调休课程”以获取准确安排。
查看与切换：
- 切换周次：在课表页面左右滑动屏幕，即可灵活切换查看上一周或下一周的课程安排。
- 课程详情：点击任一课程卡片，会弹出窗口展示该课程的详细信息（如任课教师、具体上课地点等）。
- 返回本周：点击右上角的 “返回本周” 按钮，可一键快速定位回当前周的课表。
课表导出/订阅：您可以将课表导出并订阅到您手机的系统日历中，从而实现课程安排的自动同步与提醒。
- 点击页面左上角的设置按钮。
- 选择“导出课表”功能，系统将生成一个标准的 iCalendar (.ics) 订阅链接。
- 订阅方式：
  1. iOS / Windows 用户：复制此链接后，通常可在Safari或Edge等浏览器中打开，系统会自动引导您将课程表订阅到系统自带的“日历”应用中。
  2. 安卓用户：建议将链接复制后，在您常用的日历应用中，找到“添加其他日历”或“通过链接订阅”功能，粘贴此链接即可完成订阅。

3.2 成绩与绩点查询

入口：点击底部导航栏「工具」 -> 选择「成绩查询」。
成绩查询：
- 页面默认显示当前学年学期的成绩列表。
- 可通过顶部菜单切换不同的学年和学期，查询历史成绩。
- 点击具体科目，可查看该课程的详细成绩构成。
绩点计算：可使用内置的绩点计算器，自主选择特定课程进行加权平均分和预估绩点的计算。

3.3 消费查询

入口：在「工具」页面选择「消费查询」。
校园卡服务：页面顶部会清晰显示您的校园卡实时余额。
电费查询：
- 在指定输入框中，准确填写您所在的楼号和寝室号。
- 点击「查询」按钮，即可获取当前剩余电费信息。
- 系统支持切换查看 24小时或 12小时内的电费消耗趋势图，助您掌握用电规律。

3.4 图书馆服务

入口：在「工具」页面选择「图书馆」。
馆藏检索：
- 在搜索框中输入关键词，即可快速查找您所需的图书资料，并实时查看其在馆状态、具体架位等信息。
- 您可以通过搜索框左侧的筛选按钮，灵活调整搜书方式，支持按标题、作者、主题、出版社、ISBN、索书号、分类号等多种维度进行精准检索。
- 提供 “本月热搜榜” 与 “热搜总榜” ，助您了解热门读物，发现阅读兴趣。

3.5 校园地图

入口：在「工具」页面选择「校园地图」。
功能：可浏览校园整体建筑布局，点击具体建筑图标即可查看其名称、功能介绍等详细信息，是您校园导览的得力助手。

3.6 校园电话黄页

入口：在「工具」页面选择「校园电话」。
功能：查看学校各部门、常用服务机构的联系电话列表。点击任一电话号码，即可直接发起呼叫。

3.7 考试安排

入口：在「工具」页面选择「考试安排」。
功能：集中查看当前学期的所有考试信息，包括考试科目、具体时间、考场地点等关键详情，助您高效备考。

3.8 第二课堂

入口：在「工具」页面选择「第二课堂」。
功能：
- 查看个人已获得的第二课堂学分情况及各类活动的学分要求。
- 点击「查看进行中活动」，了解当前可报名的活动列表。
- 点击「查看全部活动」，浏览所有历史与未来活动。

3.9 公告与新闻

入口：在「工具」页面可直接浏览最新公告列表。
功能：点击具体公告标题即可查看全文。此外，可通过「新闻详情」页面获取更多校园资讯和新闻报道。

3.10 校历工具

入口：在「工具」页面选择「校历」。
功能：直观展示本学期校历，帮助您快速了解教学周次、重要节假日、寒暑假安排等关键日期。

3.11 自定义设置

入口：在课表页面点击左上角的设置按钮，选择「自定义设置」。
更换背景：
- 点击「更换背景」，可从手机相册选择图片或使用系统提供的默认背景图，自定义课表页面背景。
切换主题：
- 点击「切换主题」，可选择多种预设主题，包括：
  - 默认：保留系统原始配色与布局
  - 简约：采用简洁线条与纯色块，减少视觉干扰
  - 温暖：使用暖色调（如浅橙、米黄），营造温馨氛围
  - 梦幻：采用渐变色彩与柔和元素，增添梦幻感
  - 冷色：以蓝、灰色调为主，呈现冷静、专业风格
- 切换后，页面配色、图标风格等将实时更新，提升个性化体验。

四、注意事项

为确保您能顺利使用本小程序，请留意以下事项：

登录验证：部分涉及个人数据的功能（如成绩、课表、消费查询）需要您完成登录授权后方可使用。
数据同步：小程序内大部分数据与学校官方系统同步，可能存在一定延迟，请以学校各主管部门发布的最终数据为准。
测试功能提示：“第二课堂”功能目前处于测试阶段，相关数据可能存在延迟或不准确的情况，仅供参考。
异常处理：如遇功能异常或页面加载失败，建议尝试退出小程序后重新进入，或检查设备网络连接是否正常。
使用规范：为避免对服务器造成不必要的压力，请勿在短时间内过于频繁地刷新数据。

五、常见问题解答 (FAQ)

Q1: 课表无法显示或显示空白怎么办？

A1：请按以下步骤排查：
- 确认您已通过左上角设置按钮成功导入课表。
- 检查手机网络连接是否稳定。
- 尝试退出账号并重新登录。

Q2: 成绩查询为何没有数据？

A2：可能原因有：
- 当前所选的学年或学期确实尚无成绩记录。
- 您尚未完成该学期课程的教师评价等必要前置步骤。

Q3: 电费查询失败是什么原因？

A3：请检查：
- 输入的楼号和寝室号格式与内容是否完全正确。
- 网络连接是否通畅。
- 系统可能处于临时维护时段，请稍后再试。

Q4: 遇到功能异常或页面空白如何解决？

A4：通用解决方案：
- 完全关闭微信后台的小程序，然后重新打开。
- 检查微信客户端是否为最新版本。
- 确认当前使用的网络信号良好。

六、技术支持

如果您在使用过程中遇到本说明书未涵盖的问题，或有任何意见与建议，欢迎加入qq群交流：735705921

七、附录

用户协议及隐私政策

本小程序名为"Echo回应"，由上海应用技术大学回应工作室团队（EchoTech Studio，大学生大创实践项目）负责后续运营与维护，所有成员均为本校学生。Echo回应的服务主要基于上海应用技术大学教务系统及相关校内服务，由本团队负责技术支持与日常运维。使用本软件即代表您理解并同意以下条款：

数据代理说明

为提供稳定的服务，Echo回应将通过自有的代理服务器中转您与上海应用技术大学校园网服务（通常位于 .sit.edu.cn 域名下）之间的网络请求。这意味着您在使用本小程序时，相关请求和数据将经由我们的服务器进行转发。

我们郑重承诺：在此中转过程中，您的个人信息（包括但不限于学号、密码、成绩、课表等）不会被我们的服务器存储或记录。代理服务器仅做实时转发，不会留存任何用户数据。

校园网服务说明

校园网服务由上海应用技术大学官方提供并运营，Echo回应不对其服务的可用性、稳定性或数据的准确性作任何担保。如在使用过程中遇到校园网服务相关问题，请及时联系学校相关部门处理。

您授权Echo回应以用户代理（User Agent）身份，使用您的身份信息访问校园网站点，以便为您提供相关服务。在此过程中，您的账号及身份信息仅用于您所请求的校园网服务，不会被我们保留或用于其他目的。

数据安全与隐私保护

我们采取业界流行的加密传输等安全技术措施，尽力保护您的数据在传输过程中的安全。您的所有个人信息仅用于实现您所请求的服务功能，Echo回应不会向任何第三方提供、出售、出租、分享或交易您的个人信息。

本地数据存储说明

为提升用户体验，Echo回应会在您的设备本地存储以下数据：

登录凭据（学号、密码加密形式）：用于维持登录状态
课程表、成绩等查询结果缓存：减少网络请求，提升加载速度
用户个性化设置：如用户头像、界面主题、偏好设置等

所有本地存储数据均采用设备原生加密机制保护，且您随时可以通过清除小程序缓存来删除这些数据。

数据缓存策略

为提高服务响应速度，Echo回应对以下数据采取本地缓存策略：

课程表、成绩等数据
用户基本信息
静态数据（如校园电话等）

缓存数据用于改善用户体验，对数据的实时性有一定的影响，望您知悉。您可随时通过“刷新缓存”功能来获取最新数据。

用户权利

您享有以下权利：

知情权：了解个人信息的处理方式和目的
访问权：随时查看小程序存储的个人信息
删除权：通过清除小程序缓存删除所有本地数据
撤回同意权：停止使用即视为撤回数据处理同意

用户义务

您在使用Echo回应时，应遵守国家法律法规、学校规章制度和社会公序良俗，不得利用本程序进行任何违法、违规或损害他人利益的行为。

Echo回应团队有权对任何异常使用行为进行调查，并保留暂停服务、记录相关信息及移交学校有关部门处理的权利。

安全事件响应

如发生个人信息泄露等安全事件，我们将：

及时通过适当方式告知您
按照法律法规要求上报主管部门
采取合理有效措施减少损失
进行安全漏洞排查和修复
协议变更说明

如本协议发生更新，我们将通过适当方式提醒您。如您不同意变更后的协议，可联系我们删除与您账户相关的信息。

联系我们

如对隐私政策有任何疑问或建议，请联系：

微信公众号：SIT回应工作室
反馈时间：每日9:00-22:00，48小时内回复

Git Commit规范

Wed, 24 Sep 2025 00:00:00 +0000

基本介绍

在使用Git进行代码仓库管理的时候，我们不可避免需要提交Commit，即每次提交代码需要标注本次进行了哪些修改，方便让合作者快速阅览了解开发内容，提高合作效率。目前Angular规范是最广泛的Git Commit规范方法，本文参考下列文档，使用中文编写新手友好的实用教程。

规范内容

Commit信息格式

<type>(<scope>): <subject>
<BLANK LINE>
<body>
<BLANK LINE>
<footer>

其中type(提交类型)和subject(简短描述)是必须项，scope(影响范围)是可选项第一行为Header(标题)，第二部分为Body(正文)，最后部分为Footer(脚注) 一般实际开发中主要遵循标题规范，即 type(scope): subject，示例如下

feat(第二课堂): 显示第二课堂学分
fix(第二课堂): 修复第二课堂学分显示问题
docs: Readme中增加新人环境配置教程
test: 教务系统API单元测试

Type (提交类型)

常用的Type类型如下：

feat: 新功能
fix: 修复 bug
docs: 文档修改
style: 不影响代码逻辑的格式调整
refactor: 既不是新功能也不是修复 bug 的代码重构
perf: 性能优化
test: 添加或修改测试代码
chore: 构建过程或辅助工具的变动

Scope (影响范围)

指定提交影响的模块或文件范围，例如：

第二课堂
教务系统

Subject (简短描述)

建议使用中文
简单描述修改内容，使用陈述句，例如"修复了xx问题"
结尾不要使用句号或者其他标点符号

规范Git Commit工具

使用VSCode的用户可以安装git-commit-plugin插件，使用效果如下：

v2版本全新发布!

Wed, 20 Aug 2025 00:00:00 +0000

Echo App v2：校园服务小程序的现代化重构实践

项目概述

Echo App v2 是Echo校园服务平台的第二代产品，从微信小程序原生开发(v1)升级而来。本次重构采用了现代化的前端技术栈，为高校师生提供更优质、更稳定的校园数字化服务体验。

🛠️ 技术架构升级

从原生到框架的演进

Echo App v1 基于微信小程序原生开发，随着业务复杂度增加，我们面临以下挑战：

代码复用性差，多端适配成本高
开发效率受限，缺乏现代开发工具链
维护成本逐渐增加

现代化技术选型

基于以上考虑，v2版本采用了业界主流的前端框架组合：

跨端开发框架: 选用成熟的跨端解决方案
组件化开发: 采用现代化的UI组件库
类型安全: 引入静态类型检查提升代码质量
工程化: 完善的开发工具链和构建流程

开发效率提升

新的技术栈带来了显著的开发效率提升：

热重载和实时编译
类型安全的开发体验
丰富的组件生态系统
更好的代码组织和维护性

📁 项目架构设计

目录结构

echo-app-v2/
├── src/ # 源代码目录
│ ├── app.config.ts # 应用配置
│ ├── app.ts # 应用入口
│ ├── assets/ # 静态资源
│ ├── components/ # 公共组件
│ ├── composables/ # Vue组合式函数
│ ├── core/ # 核心工具类
│ ├── pages/ # 主页面
│ ├── toolspage/ # 工具子页面
│ ├── loginpage/ # 登录相关页面
│ └── types/ # TypeScript类型定义
├── config/ # 环境配置
├── modules/ # 子模块
│ └── echo-sdk-ts/ # TypeScript SDK
├── docs/ # 文档
└── package.json # 项目依赖

架构设计理念

项目采用清晰的架构分层：

表现层: 负责界面渲染和用户交互
业务层: 处理核心业务逻辑和数据
优势: 关注点分离，提升可维护性和可测试性

🚀 核心功能实现

1. 课表管理系统

功能特点:

可视化课表展示，支持多种视图模式
课程详情查看和提醒功能
智能的课程数据管理和同步

2. 成绩与绩点计算

功能特点:

成绩查询和统计分析
绩点自动计算
多维度数据展示

3. 校园卡消费分析

功能特点:

消费明细查询和管理
余额实时监控
消费数据统计分析

4. 统一认证系统

安全特性:

安全的身份认证机制
完善的会话管理
自动化的token维护

🎨 UI/UX 设计实践

UI设计理念

设计原则

一致性: 统一的视觉风格和交互模式
易用性: 简洁直观的操作流程
美观性: 现代化的界面设计

用户体验优化

流畅的页面切换动画
智能的加载状态提示
人性化的错误处理机制

响应式设计

移动端优先的设计理念
自适应布局系统
手势操作支持

🔧 开发实践总结

1. 类型安全开发

采用严格的类型检查机制，确保代码质量和开发效率：

完整的类型定义体系
编译时错误检测
更好的代码提示和自动补全

2. 组件化开发模式

基于现代化的组件开发理念：

可复用的组件设计
清晰的组件接口定义
统一的组件通信机制

3. 性能优化实践

实施多项性能优化措施：

代码分割和懒加载
资源优化和压缩
数据缓存策略
渲染性能优化

🧪 质量保证体系

测试策略

建立完善的质量保证体系：

单元测试覆盖核心业务逻辑
集成测试确保模块间协作
端到端测试验证完整用户流程

代码质量

实施严格的代码质量管理：

代码规范检查和自动格式化
静态代码分析
定期的代码审查

📦 部署与发布

构建发布流程

建立标准化的构建发布流程：

多环境配置管理
自动化构建脚本
版本控制和发布管理

环境管理

支持多环境部署：

开发环境用于功能验证
测试环境用于质量保证
生产环境服务真实用户

🚀 性能表现

通过技术架构升级，项目在以下方面获得显著提升：

加载性能: 更快的页面加载速度
运行效率: 更流畅的用户操作体验
资源占用: 更优化的内存使用
稳定性: 更可靠的系统运行

💡 重构经验总结

成功经验

从微信小程序原生开发(v1)升级到现代化框架(v2)带来了显著收益：

开发效率提升: 现代化的开发工具和框架显著提高了开发效率
代码质量改善: 类型安全和组件化开发提升了代码质量
维护成本降低: 清晰的架构分层降低了长期维护成本
跨端能力增强: 具备了向多平台扩展的技术基础

技术挑战与解决方案

在重构过程中面临的主要挑战：

技术栈迁移: 平稳地从原生开发过渡到框架开发
性能平衡: 在功能丰富性和性能表现间找到最佳平衡
兼容性保障: 确保新版本与原有功能的兼容性
团队适配: 帮助开发团队适应新的技术栈和开发模式

📚 学习资源

官方文档

🤝 贡献指南

项目遵循以下规范：

代码规范: ESLint + Prettier
提交信息: Conventional Commits
分支策略: Git Flow
文档要求: 代码注释 + Markdown文档

📞 技术支持

GitHub:
公众号: SIT回应工作室

Echo App v2 项目展示了现代前端技术栈在校园服务领域的成功实践，为高校数字化建设提供了优秀的技术解决方案。通过Taro+Vue+TypeScript+NutUI的组合，我们实现了高性能、跨平台、易维护的校园服务小程序，为师生提供了便捷的数字化校园体验。

主页 | Echo-SIT

Echo用户帮助手册

一、引言

二、如何开始使用

三、主要功能和使用指南

3.1 课表查询

3.2 成绩与绩点查询

3.3 消费查询

3.4 图书馆服务

3.5 校园地图

3.6 校园电话黄页

3.7 考试安排

3.8 第二课堂

3.9 公告与新闻

3.10 校历工具

3.11 自定义设置

四、注意事项

五、常见问题解答 (FAQ)

六、技术支持

七、附录

用户协议及隐私政策

Git Commit规范

基本介绍

规范内容

Commit信息格式

Type (提交类型)

Scope (影响范围)

Subject (简短描述)

规范Git Commit工具

v2版本全新发布!

Echo App v2：校园服务小程序的现代化重构实践

项目概述

🛠️ 技术架构升级

从原生到框架的演进

现代化技术选型

开发效率提升

📁 项目架构设计

目录结构

架构设计理念

🚀 核心功能实现

1. 课表管理系统

2. 成绩与绩点计算

3. 校园卡消费分析

4. 统一认证系统

🎨 UI/UX 设计实践

UI设计理念

设计原则

用户体验优化

响应式设计

🔧 开发实践总结

1. 类型安全开发

2. 组件化开发模式

3. 性能优化实践

🧪 质量保证体系

测试策略

代码质量

📦 部署与发布

构建发布流程

环境管理

🚀 性能表现

💡 重构经验总结

成功经验

技术挑战与解决方案

📚 学习资源

官方文档

推荐工具

🤝 贡献指南

📞 技术支持