• 🔄 支持多种文件格式（TXT、EPUB等）
• 📋 直观的章节选择和队列管理
• 📊 实时显示文件信息（字数、章节数等）
• 🗂️ 智能缓存机制，提升处理效率

• 🧠 集成先进的AI模型进行内容分析
• ⚡ 支持批量处理，提高工作效率
• 📈 实时进度显示和状态反馈
• 🎯 精准提取情节、人物、情感等关键要素

• 🌈 紫色渐变玻璃态设计风格
• 🌓 明暗主题无缝切换
• 📱 完美的移动端响应式适配
• ✨ 流畅的动画和交互效果

• 🔑 安全的API密钥管理
• 🎛️ 丰富的参数调整选项
• 🔧 多种AI模型支持
• 💾 本地设置持久化存储

• 📋 结构化的分析结果展示
• 📄 支持Markdown格式导出
• 📋 一键复制功能
• 🔍 详细的调试信息查看

• Node.js 16+
• 现代浏览器（Chrome、Firefox、Safari、Edge）
• 稳定的网络连接

# 克隆项目
git clone https://github.com/Ggbond626/SmartReads.git
cd SmartReads

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 使用 Docker Compose（推荐）
docker-compose up --build

# 或使用 Docker
docker build -t smartreads-web .
docker run -p 4173:4173 smartreads-web

访问 http://localhost:4173 开始使用

1. 点击右上角设置按钮 ⚙️
2. 在"API设置"中配置：
   • API密钥
   • 基础URL
   • 模型选择
   • 参数调整
3. 测试连接确保配置正确

1. 在"预处理"面板选择文件
2. 支持拖拽上传或点击浏览
3. 自动解析章节信息
4. 选择需要分析的章节

1. 切换到"分析"面板
2. 添加章节到分析队列
3. 点击"开始分析"
4. 实时查看分析进度

1. 在"分析结果"面板查看详细分析
2. 支持复制或导出Markdown
3. 可展开调试信息查看详情

• 前端框架: React 18
• 样式方案: CSS Modules + CSS Variables
• 图标库: React Icons
• 状态管理: React Context API
• 构建工具: Vite
• 容器化: Docker + Docker Compose

src/
├── components/          # 组件目录
│   ├── common/         # 通用组件
│   │   ├── Button/     # 按钮组件
│   │   ├── FileInput/  # 文件输入组件
│   │   └── ...
│   ├── Header/         # 顶部导航栏
│   ├── Sidebar/        # 左侧面板
│   │   ├── AnalysisPanel/      # 分析面板
│   │   └── PreprocessPanel/    # 预处理面板
│   ├── ContentPanel/   # 右侧内容区域
│   ├── SettingsModal/  # 设置模态框
│   └── StatusBar/      # 底部状态栏
├── contexts/           # React Context
├── hooks/              # 自定义Hooks
├── utils/              # 工具函数
└── index.css          # 全局样式和设计令牌

• ✅ 智能文件处理: 自动识别章节结构
• ✅ 实时反馈: 进度条和状态提示
• ✅ 结果导出: Markdown格式输出
• ✅ 主题切换: 明暗主题支持
• ✅ 移动适配: 响应式设计
• ✅ 缓存机制: 提升处理效率
• ✅ 错误处理: 友好的错误提示

• 需要配置有效的AI API密钥
• 建议在安全环境中使用，保护API密钥
• 分析效果取决于AI模型和文本质量
• 大文件处理可能需要较长时间

本项目采用 CC BY-NC-SA 4.0 许可证。

简单说明：

• ✅ 可以自由使用 - 个人学习、研究、非商业用途
• ✅ 可以修改分享 - 可以基于此项目进行修改和分享
• ❌ 禁止商业使用 - 不得用于任何商业目的
• 📝 需要署名 - 使用时需要注明原作者
• 🔄 相同许可 - 修改后的作品需要使用相同许可证

查看 LICENSE 文件了解完整条款。

商业使用许可： 如需商业使用，请联系作者获得授权。

感谢所有为这个项目做出贡献的开发者和用户！