linshen
ba8be35209
本次提交包含对UI层的一系列改进，主要集中在可维护性和用户体验上。
主要变更如下:
- **实现UI主题系统**:
- 在多个组件中，将硬编码的CSS类替换为语义化的主题类 (例如 `theme-background-surface`, `theme-button-toggle-active`)。
- 此项重构旨在简化未来主题的添加和维护，并解决第三方插件（如 `prose`）的样式冲突问题。
- **优化 `OutputDisplay` 交互逻辑**:
- `OutputDisplayCore` 组件引入 `userHasManuallyToggledReasoning` 状态，以区分用户手动操作和系统自动行为，避免在流式输出时意外干扰用户对“思考过程”面板的控制。
- “对比(Diff)”模式的切换按钮现在通过 `v-if` 控制，仅在存在可对比内容时渲染。
- **组件API与结构重构**:
- `OutputDisplay` 组件使用 `defineOptions({ inheritAttrs: false })` 和 `v-bind="$attrs"` 来正确处理多根节点的属性继承，遵循了Vue的最佳实践。
- **文档同步**:
- 更新了 `experience.md` 和 `output-display-v2-design.md`，以反映本次代码变更中包含的设计决策和技术方案。
项目文档索引
文档合并说明
为了提高文档的组织性和可读性，我们对项目文档进行了重构和合并。以下是文档合并情况：
| 新文档 | 包含原文档 | 说明 |
|---|---|---|
| technical-development-guide.md | development-guidelines.md, technical-documentation.md | 技术开发指南，整合了开发规范和技术文档 |
| project-structure.md | file-structure.md, fileNames.md | 项目结构说明，包含文件结构和目录组织 |
| project-status.md | progress.md, chrome-extension-plan.md | 项目状态，包含进度和Chrome扩展计划 |
核心文档
- README.md - 项目总体介绍
- technical-development-guide.md - 技术开发指南，包含技术栈和开发规范
- llm-params-guide.md - LLM参数配置详细指南
- project-structure.md - 项目结构，专注于文件和目录组织
- project-status.md - 项目状态，包含进度和计划
- prd.md - 产品需求文档
其他资源
- experience.md - 项目经验总结
- scratchpad.md - 开发笔记 (已简化)
- vercel.md / vercel_en.md - Vercel部署指南
如何使用文档
-
新成员入职：
- 首先阅读 README.md，了解项目概况
- 查看 project-structure.md 了解项目结构
- 参考 technical-development-guide.md 了解技术实现和开发规范
-
开发参考：
- 遵循 technical-development-guide.md 中的开发规范
- 查阅 technical-development-guide.md 了解应用流程
- 参考 project-structure.md 了解代码组织
-
项目进度：
- 通过 project-status.md 了解当前进度和计划
- 关注 CHANGELOG.md 了解最新变更
文档维护说明
- 所有文档采用 Markdown 格式
- 文档更新后，请在文档末尾添加更新时间
- 重要变更请同时更新 project-status.md 中的更新记录
- 文档中的代码示例应确保可运行且符合项目规范
- 注意区分不同文档的职责，避免内容重复
- 弃用的文档应标记为已弃用，并引导用户使用新文档
最后更新：2025-01-06