mcslms/android/README_ENHANCED.md

Android 智能图书馆管理系统 - 增强版

🎉 新功能亮点

🎨 UML图生成器

• 在线实时生成：支持PlantUML语法
• 双服务器保障：PlantUML官方 + Kroki备用
• 自动故障转移：一个服务器失败自动切换
• 内置示例：快速上手

🚀 增强版网络服务

• 统一API管理：EnhancedApiService单例
• 多AI平台支持：DeepSeek + 智谱AI
• 语音识别集成：讯飞WebSocket流式API
• 完善错误处理：友好的用户提示

📦 快速开始

构建

.\gradlew.bat :android:assembleDebug

安装

adb install -r android\build\outputs\apk\debug\mcslms-debug.apk

运行

adb shell am start -n com.smartlibrary/.android.MainActivity

🎯 功能列表

基础功能

• ✅ 图书管理（查看、搜索）
• ✅ 借阅管理（借书、还书）
• ✅ 用户管理（信息查看）
• ✅ Mock数据生成

AI功能

• ✅ 本地AI助手：离线智能对话
• ✅ 增强AI助手：真实AI + 语音交互
• ✅ AI智能搜索：关键词提取和推荐
• ✅ AI个性化推荐：图书推荐系统

UML功能

• ✅ UML查看器：系统架构图展示
• ✅ UML生成器：在线实时生成 ⭐新增

语音功能

• ✅ 语音输入：讯飞语音识别
• ✅ 语音播报：讯飞语音合成

📱 界面预览

┌─────────────────────────────────┐
│  智能图书管理系统 (SLMS)        │
├─────────────────────────────────┤
│  📊 系统统计                    │
│  📚 图书总数: 50 本             │
│  📖 借阅记录: 20 条             │
│  🔄 当前借阅: 5 本              │
├─────────────────────────────────┤
│  🤖 AI智能功能                  │
│  ┌───────────────────────────┐  │
│  │ 💬 AI智能助手（本地）     │  │
│  └───────────────────────────┘  │
│  ┌───────────────────────────┐  │
│  │ 🚀 增强AI助手（真实AI）   │  │
│  └───────────────────────────┘  │
│  ┌───────────────────────────┐  │
│  │ 🔍 AI智能搜索             │  │
│  └───────────────────────────┘  │
│  ┌───────────────────────────┐  │
│  │ 💡 AI个性化推荐           │  │
│  └───────────────────────────┘  │
│  ┌───────────────────────────┐  │
│  │ 📊 查看系统UML图          │  │
│  └───────────────────────────┘  │
│  ┌───────────────────────────┐  │
│  │ 🎨 UML图生成器 ⭐新增    │  │
│  └───────────────────────────┘  │
└─────────────────────────────────┘

🔧 技术栈

• 语言：Java
• 框架：Android SDK (Min API 24)
• 网络：OkHttp 4.x
• 架构：分层架构（Presentation → Business → Service → Data）
• 设计模式：单例、回调、工厂

📚 文档

• 功能增强说明：FEATURE_ENHANCEMENTS.md
• 快速测试指南：QUICK_TEST_GUIDE.md
• 完成总结：COMPLETION_SUMMARY.md
• AI功能文档：AI_FEATURES.md

🎓 使用示例

1. 使用UML生成器

// 在MainActivity中
private void showUMLGenerator() {
    getSupportFragmentManager()
        .beginTransaction()
        .replace(android.R.id.content, new UMLGeneratorFragment())
        .addToBackStack(null)
        .commit();
}

2. 调用增强API服务

// 获取单例
EnhancedApiService apiService = EnhancedApiService.getInstance(context);

// AI对话
apiService.getAiCompletion("你好", AIConfig.AIProvider.DEEPSEEK, 
    new EnhancedApiService.ApiResponseListener<String>() {
        @Override
        public void onSuccess(String response) {
            // 处理响应
        }
        
        @Override
        public void onError(String error) {
            // 处理错误
        }
    });

// UML生成
apiService.generateDiagram(pumlText, EnhancedApiService.SERVER_PLANTUML,
    new EnhancedApiService.ApiResponseListener<Bitmap>() {
        @Override
        public void onSuccess(Bitmap bitmap) {
            imageView.setImageBitmap(bitmap);
        }
        
        @Override
        public void onError(String error) {
            Toast.makeText(context, error, Toast.LENGTH_LONG).show();
        }
    });

🐛 已知问题

1. 模拟器限制：语音功能需要在真实设备上测试
2. 网络依赖：部分功能需要网络连接
3. API限制：第三方API有调用频率限制

🔮 未来计划

短期

• 离线UML生成
• 语音优化（更多角色、语速控制）
• UI/UX优化（深色模式、动画）

长期

• 多语言支持
• 离线AI模型
• 跨平台版本（iOS、Web）

📞 支持

如有问题，请查看：

1. 快速测试指南 - 常见问题解决
2. 功能增强说明 - 技术细节
3. AI功能文档 - API配置

📄 许可

本项目仅用于学习和演示目的。

🙏 致谢

• 参考项目：分层架构HelloWorldAndroid版AI问答系统
• API提供商：DeepSeek、智谱AI、讯飞
• UML服务：PlantUML、Kroki

---

版本：Enhanced v1.0 构建日期：2025年 状态：✅ 已完成

🎉 享受使用增强版Android应用！ 🎉