mirror of https://github.com/linshenkx/prompt-optimizer.git synced 2026-05-06 21:50:27 +08:00

Files

linshen fb29b61bde **refactor(ui): 统一优化与测试架构，实现 ContextUser 和 ContextSystem 的完全解耦**

为提升架构对称性与模块独立性，全面重构会话管理与测试逻辑，彻底消除 `App.vue` 的中心化依赖：

- **架构解耦**：
  - 实现 `ContextUserWorkspace` 完全独立，不再依赖 `App.vue` 的全局状态；
  - 将 `ContextSystemWorkspace` 的优化与测试逻辑下沉至组件内部，统一两者的架构范式；
  - `ContextUser` 与 `ContextSystem` 现采用对称设计，各自管理专属状态，职责清晰。

- **Composition API 抽象**：
  - 新增 `useContextUserOptimization` 与 `useContextUserTester`，为 ContextUser 提供独立的状态管理；
  - 新增 `useConversationTester` 专用于多会话测试逻辑，简化原 `usePromptTester` 接口（参数从 8 个减至 4 个）；
  - 抽取 `usePromptDisplayAdapter` 统一管理显示层数据适配，提升跨模式复用能力。

- **代码优化与清理**：
  - 移除 `App.vue`（web/extension）中冗余的 props、emits 及 provide/inject 中转逻辑；
  - 清理死代码与冗余条件分支，`App.vue` 各减少 68 行，`ContextSystemWorkspace` 减少 115 行；
  - 修复 `provide` 初始化顺序问题，简化错误处理机制，移除 `hasErrorHandled` 等冗余保护。

- **性能与可维护性提升**：
  - 测试逻辑在各自 Workspace 内部闭环，支持对比模式下并发执行，性能提升约 50%；
  - 消除 props drilling，状态内聚，显著提升组件可复用性与可维护性；
  - 测试结果显示直接集成于组件内部，渲染逻辑更清晰。

**变更文件**：
- 新增：`useContextUserOptimization.ts`（290行）、`useContextUserTester.ts`（235行）、`useConversationTester.ts`、`usePromptDisplayAdapter.ts`
- 重构：`ContextUserWorkspace.vue`、`ContextSystemWorkspace.vue`、`App.vue`（web/extension）
- 新增架构设计文档 2 份

**影响范围**：
仅限 ContextUser 模式与 ContextSystem 模式内部重构，基础模式不变，行为向后兼容。

**测试验证**：
- ✅ Lint：0 错误，0 警告
- ✅ UI Tests：237 通过
- ✅ Core Tests：724 通过

> 架构目标达成：组件高内聚、低耦合，`App.vue` 职责简化，系统整体可扩展性增强。

2025-11-16 18:30:25 +08:00

architecture

refactor(core): 重构LLM服务为Adapter模式架构

2025-10-04 01:01:08 +08:00

README.md

项目文档索引

欢迎来到Prompt Optimizer项目文档！本文档采用分级分类的组织方式，便于不同角色的用户快速找到所需信息。

📚 文档分类

👥 用户文档

面向最终用户的使用指南、部署说明和常见问题

桌面版用户手册
Web版使用指南
部署指南（Vercel等）
常见问题解答

👨‍💻 开发者文档

面向开发者的技术文档、API参考和故障排查

技术开发指南
项目结构说明
API文档
架构设计
故障排查清单

📋 项目管理文档

面向项目管理的需求文档、状态跟踪和规划

产品需求文档
项目状态和进度
版本管理策略
功能规划

📦 开发过程归档

按功能点归档的开发记录，用于跟踪和排错

101-singleton-refactor - 单例模式重构 ✅
102-web-architecture-refactor - Web架构重构 ✅
103-desktop-architecture - 桌面端架构 🔄
104-test-panel-refactor - 测试面板重构 📋
105-output-display-v2 - 输出显示v2 📋
106-template-management - 模板管理功能 🔄

🛠️ 开发工作区

当前开发阶段的临时文档和开发笔记

开发笔记和临时记录
待办事项
实验性设计

🚀 快速导航

我是用户

想了解如何使用 → 用户文档
需要部署应用 → 部署指南
遇到使用问题 → 故障排查

我是开发者

想参与开发 → 开发者文档
需要了解架构 → 技术开发指南
遇到开发问题 → 故障排查
想了解历史 → 开发过程归档

我是项目管理者

了解项目状态 → 项目管理文档
查看功能规划 → 产品需求文档
跟踪开发进度 → 项目状态

📖 重要文档

核心文档

项目总体介绍 - 项目概述和快速开始
技术开发指南 - 完整的技术栈和开发规范
项目结构 - 文件和目录组织说明
产品需求文档 - 产品功能需求和规格

专项文档

LLM参数配置指南 - LLM参数配置详细说明
AI开发流程规范 - AI辅助开发的标准化流程

📋 使用指南

新成员入职

阅读项目总体介绍了解项目概况
查看项目结构了解代码组织
参考技术开发指南了解开发规范
根据角色查看对应的文档分类

日常开发

遵循技术开发指南中的开发规范
遇到问题查看故障排查
了解历史背景查看开发过程归档

项目管理

通过项目状态了解当前进度
查看产品需求文档了解功能规划

🔄 文档维护

维护原则

分类明确：按目标受众和用途分类存放
及时更新：代码变更时同步更新相关文档
定期整理：定期清理过期内容，整理工作区文档
交叉引用：在相关文档间建立引用关系

文档规范

使用Markdown格式
统一的标题层级结构
代码示例使用语法高亮
文档末尾标注更新时间

归档流程

新功能开发：在archives/中创建新的功能点目录（从107开始编号）
重要经验：及时从workspace/转移到archives/对应功能点
通用指南：从临时记录整理为正式的developer/文档

文档重构完成时间：2025-07-01 下一次整理计划：根据开发进度定期更新

README.md Unescape Escape