linshen
2f4d7429ef
- 更新 `composables-refactor-plan.md` 与 `experience.md`，记录重构成果、问题与后续计划，强调顶层声明和响应式连接。引入 `useAppInitializer`，及其对架构统一和代码复用的贡献。 - 更新多个组件与Composable文件，使其通过 `inject` 获取服务实例引用，解决了`ref` 迁移到 `reactive` 和异步回调中调用Composable函数导致的错误，优化了模板管理器的使用方式，并移除对服务单例的直接依赖。 - 修复 `templateLanguageService` 依赖注入失败的 bug，更新组件导出和模板管理器，优化代码结构与可读性。 - 将背景与目标修改为当前状态与问题，明确上层应用尚未适配底层重构的现状，并记录Web应用和浏览器插件启动失败问题，提出后续修复步骤。更新实施计划，强调对齐上层应用与底层服务架构的必要性。
项目文档索引
文档合并说明
为了提高文档的组织性和可读性，我们对项目文档进行了重构和合并。以下是文档合并情况：
| 新文档 | 包含原文档 | 说明 |
|---|---|---|
| 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