Files
prompt-optimizer/docs/tech-stack.md
T
linshen 2e6246aa7a feat: Enhance error handling, testing, and extension development
- Implement comprehensive error handling strategies in app-flow.md
- Add detailed testing workflows for unit, integration, and E2E tests
- Update Chrome extension manifest and icon configurations
- Improve UI package configuration and component structure
- Update project progress and tech stack documentation
- Optimize extension package icon and HTML setup
2025-02-15 21:17:23 +08:00

3.2 KiB

技术栈文档

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
    • 单元测试
    • 集成测试
    • 快照测试
    • 覆盖率报告
    • 模拟功能(Mock/Spy)
    • 异步测试支持
  • Vue Test Utils 2.4.x
    • 组件测试
    • 行为模拟
    • 事件测试
    • 组合式函数测试
    • Props/Emit测试
    • 生命周期钩子测试
  • 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支持
    • 实时通信
    • 心跳检测
    • 自动重连

13. 错误处理系统

  • 统一错误类型
    • APIError
    • ValidationError
    • ConfigError
    • StorageError
  • 错误恢复机制
    • 自动重试
    • 降级处理
    • 错误边界
  • 错误监控
    • 错误日志
    • 性能监控
    • 用户反馈
  • 调试工具
    • Vue Devtools
    • Chrome DevTools
    • 网络分析