linshen
7a5836191d
- Revamp README with new monorepo structure and detailed project overview - Enhance file structure documentation with package-specific details - Update frontend development guidelines with modern best practices - Refactor progress tracking document with detailed milestones and risk assessment - Expand tech stack documentation with in-depth technology descriptions - Improve app flow documentation with TypeScript-based code examples
166 lines
2.7 KiB
Markdown
166 lines
2.7 KiB
Markdown
# 技术栈文档
|
|
|
|
## 1. 项目架构
|
|
- Monorepo
|
|
- pnpm workspace
|
|
- 多包管理
|
|
- 包间依赖
|
|
- 统一版本控制
|
|
|
|
## 2. 核心包 (@prompt-optimizer/core)
|
|
- TypeScript 5.3.x
|
|
- 类型系统
|
|
- 接口定义
|
|
- 模块化
|
|
- LangChain
|
|
- @langchain/core ^0.3.33
|
|
- @langchain/google-genai ^0.1.6
|
|
- @langchain/openai ^0.3.17
|
|
- @langchain/deepseek ^0.1.2
|
|
- 模型管理
|
|
- 提示词处理
|
|
- 流式响应
|
|
- 工具库
|
|
- uuid ^11.0.5
|
|
- zod ^3.22.4
|
|
- rxjs ^7.8.1
|
|
- 错误处理
|
|
- 类型定义
|
|
|
|
## 3. Web包 (@prompt-optimizer/web)
|
|
- Vue 3.4.x
|
|
- Composition API
|
|
- Script Setup
|
|
- 响应式系统
|
|
- 组件生态
|
|
- Vite 5.1.x
|
|
- 快速开发服务器
|
|
- 优化的构建
|
|
- 插件系统
|
|
- HMR支持
|
|
|
|
## 4. UI框架和样式
|
|
- TailwindCSS 3.4.x
|
|
- 实用优先
|
|
- 响应式设计
|
|
- 深色模式支持
|
|
- 动画系统
|
|
- Vue Transitions
|
|
- 页面过渡动画
|
|
- 组件切换效果
|
|
- 列表动画
|
|
- DaisyUI 4.7.x
|
|
- 组件库
|
|
- 主题支持
|
|
- 响应式组件
|
|
|
|
## 5. 状态管理
|
|
- Vue Reactivity
|
|
- ref/reactive
|
|
- computed
|
|
- watch
|
|
- watchEffect
|
|
- LocalStorage
|
|
- 配置持久化
|
|
- 历史记录存储
|
|
- 模板管理
|
|
- 加密存储
|
|
- Pinia 2.1.x
|
|
- 状态管理
|
|
- 持久化
|
|
- 插件支持
|
|
|
|
## 6. 安全性
|
|
- WebCrypto API
|
|
- API密钥加密
|
|
- 安全存储
|
|
- 密钥轮换
|
|
- XSS防护
|
|
- 输入验证
|
|
- 内容过滤
|
|
- 安全编码
|
|
- CORS配置
|
|
- API访问控制
|
|
- 安全头部
|
|
- CSP策略
|
|
|
|
## 7. 开发工具
|
|
- TypeScript 5.3.x
|
|
- 类型检查
|
|
- 代码提示
|
|
- 接口定义
|
|
- ESLint 8.56.x
|
|
- 代码规范
|
|
- 自动修复
|
|
- TypeScript支持
|
|
- Prettier 3.2.x
|
|
- 代码格式化
|
|
- 统一风格
|
|
- 编辑器集成
|
|
|
|
## 8. 测试框架
|
|
- Vitest 1.2.x
|
|
- 单元测试
|
|
- 集成测试
|
|
- 快照测试
|
|
- 覆盖率报告
|
|
- Vue Test Utils 2.4.x
|
|
- 组件测试
|
|
- 行为模拟
|
|
- 事件测试
|
|
- Playwright 1.41.x
|
|
- E2E测试
|
|
- 跨浏览器测试
|
|
- 视觉回归测试
|
|
|
|
## 9. 构建和部署
|
|
- pnpm 8.15.x
|
|
- 包管理
|
|
- 依赖处理
|
|
- 工作区管理
|
|
- 快速安装
|
|
- GitHub Actions
|
|
- CI/CD流程
|
|
- 自动测试
|
|
- 自动部署
|
|
- 版本发布
|
|
- Vercel
|
|
- 静态托管
|
|
- 自动部署
|
|
- CDN分发
|
|
- 环境变量管理
|
|
|
|
## 10. 开发环境
|
|
- Node.js >= 16.20.0
|
|
- pnpm >= 8.15.0
|
|
- VS Code
|
|
- Volar 1.8.x
|
|
- ESLint
|
|
- Prettier
|
|
- Cursor
|
|
- GitLens
|
|
- Tailwind CSS IntelliSense
|
|
|
|
## 11. 浏览器支持
|
|
- Chrome >= 90
|
|
- Firefox >= 90
|
|
- Safari >= 14
|
|
- Edge >= 90
|
|
- 移动端浏览器
|
|
- iOS Safari >= 14
|
|
- Android Chrome >= 90
|
|
|
|
## 12. API集成
|
|
- LangChain集成
|
|
- Gemini API
|
|
- DeepSeek API
|
|
- OpenAI API（计划中）
|
|
- 自定义API支持
|
|
- 配置化集成
|
|
- 错误处理
|
|
- 重试机制
|
|
- 流式响应
|
|
- WebSocket支持
|
|
- 实时通信
|
|
- 心跳检测
|
|
- 自动重连 |