mta-mcp 1.8.1

package/CHANGELOG.md

@@ -0,0 +1,457 @@
+# Changelog
+
+本文件记录 Copilot Prompts MCP Server 的所有重要变更。
+
+格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)。
+
+---
+
+## [1.7.0] - 2025-12-22
+
+### 🧹 v1.4.0 更新：项目目录清理与归档
+
+#### 📂 目录结构优化
+
+- **创建归档目录**
+  - 新建 `archive/docs/` 存放历史文档
+  - 新建 `archive/tests/` 存放测试文件
+  
+- **文档归档**
+  - 移动 CLAUDE_SETUP.md → archive/docs/
+  - 移动 DEVELOPMENT_ROADMAP.md → archive/docs/
+  - 移动 GETTING_STARTED.md → archive/docs/
+  - 移动 MIGRATION_GUIDE.md → archive/docs/
+  - 移动 TROUBLESHOOTING.md → archive/docs/
+  - 移动 USAGE_GUIDE.md → archive/docs/
+  
+- **测试文件归档**
+  - 移动所有 test-*.cjs 文件 → archive/tests/
+  - 移动所有 test-*.sh 文件 → archive/tests/
+
+#### 🎯 目录规范
+
+**mcp-server 根目录现在只保留：**
+- README.md - 主要文档
+- CHANGELOG.md - 版本变更记录
+- package.json - 项目配置
+- tsconfig.json - TypeScript 配置
+- src/ - 源代码
+- build/ - 编译输出
+- archive/ - 历史文件归档
+
+#### 💡 影响范围
+
+- 项目目录更清晰、易于维护
+- 新用户更容易找到核心文档
+- 历史文档和测试文件有序归档
+- 符合 v1.3.0 不生成多余文档的规范
+
+---
+
+### 🎯 v1.3.0 更新：注释与文档生成规范
+
+#### ✨ 新增底层强制规则
+
+- **注释格式规范**
+  - ⚠️ TypeScript/JavaScript 中单行注释必须使用 `//` 而非 `/** */`
+  - 注释内容必须清晰且有意义
+  - 说明「为什么」而非「做什么」
+  - 避免无意义的重复性注释
+  
+- **文档生成限制**
+  - ⚠️ 禁止自动创建 Markdown 文档（除非用户明确要求）
+  - 不生成 USAGE.md、GUIDE.md、NOTES.md 等文件
+  - 仅在以下情况创建文档：
+    - 用户明确说「生成文档」、「创建说明」等
+    - 项目初始化需要 README.md
+    - 修改现有文档文件
+  - 默认在代码中添加详细注释而非创建额外文档
+
+#### 📝 规范文件更新
+
+- 更新 `standards/core/code-style.md`
+  - 添加单行注释格式强制规则
+  - 强化文档创建规范说明
+  - 提供清晰的注释示例对比
+  
+- 更新 `standards/core/code-generation.md`
+  - 强化禁止创建文档的规则
+  - 添加注释格式规范章节
+  - 明确何时可以创建文档的场景
+
+#### 🎯 影响范围
+
+- 所有生成 TypeScript/JavaScript 代码的场景
+- 确保注释风格专业、统一、有意义
+- 减少不必要的文档文件生成
+- 保持代码库清洁、易维护
+
+---
+
+## [1.6.0] - 2025-12-19
+
+### 🎯 v1.2.0 更新：底层核心规范强制加载
+
+#### ✨ 新增功能
+
+- **底层必须规范系统**
+  - 新增 `MANDATORY_CORE_STANDARDS` 常量，定义3个底层核心规范
+  - 强制加载通用编码规范，确保基础代码质量
+  - 核心规范列表：
+    - `standards://core/code-style` - 代码风格规范（命名、格式等）
+    - `standards://core/typescript-base` - TypeScript基础规范
+    - `standards://core/code-generation` - 代码生成规范（注释、文档等）
+
+- **智能规范加载增强**
+  - `getRelevantStandards` 方法始终包含核心规范（权重100）
+  - 无论用户输入什么场景/文件类型，都能获得基础质量保障
+  - 避免遗漏基本编码规范的情况
+
+#### 🎯 影响范围
+
+- 所有调用 `get_relevant_standards` MCP工具的场景
+- 确保代码风格、类型安全、注释文档等基础规范始终生效
+- 提升各项目、框架、语言之间的编码一致性
+
+---
+
+## [1.5.0] - 2025-12-19
+
+### 🛡️ v1.1.0 更新：代码质量保障
+
+#### ✨ 新增功能
+
+- **代码验证系统**
+  - 新增 `CodeValidator` 核心模块，提供多层次代码质量检查
+  - 自动检测并防止常见代码生成错误：
+    - 重复标签闭合（如 `</style></style>`）
+    - 括号不匹配
+    - 代码不完整
+  - 配置文件生成前自动验证，确保输出质量
+
+- **自动修复机制**
+  - 智能识别简单语法错误并尝试自动修复
+  - 修复失败时提供详细的错误报告和修复建议
+  - 记录所有修复操作，提高透明度
+
+- **多场景兼容性保障**
+  - 确保生成的代码能够正常运行
+  - 考虑不同用户的使用场景
+  - 避免破坏性更新
+
+#### 🔧 改进
+
+- **增强 `generateConfig` 工具**
+  - 集成代码验证流程
+  - 生成配置前进行完整性检查
+  - 验证失败时提供清晰的错误信息
+
+- **改进错误提示**
+  - 详细的验证报告，包含行号和具体位置
+  - 针对性的修复建议
+  - 分级的错误和警告系统
+
+#### 📝 规则应用
+
+根据 `admin-rules.json` v1.1.0 规则：
+- ✅ 代码更新后确保能够运行
+- ✅ 优化考虑不同用户使用场景
+- ✅ 解决重大代码语法错误问题
+
+---
+
+## [1.4.1] - 2025-12-15
+
+### 🔧 配置格式修复与优化
+
+#### 🐛 Bug 修复
+
+- **修复 `auto_setup` 工具生成错误的配置格式**
+  - 将 `mcpServers` 改为 VS Code 正确的 `servers` 格式
+  - 添加必需的 `env: {}` 字段
+  - 添加推荐的 `autoStart: true` 字段
+  - 修复配置合并逻辑中的键名错误
+
+- **增强 `health_check` 工具**
+  - 支持检测新旧两种配置格式
+  - 自动识别旧格式并提供升级建议
+  - 检查是否包含必需字段（env, autoStart）
+  - 提供更详细的诊断信息和修复建议
+
+#### 📚 文档改进
+
+- **新增 [故障排除指南](./TROUBLESHOOTING.md)**
+  - VS Code 配置问题完整解决方案
+  - Claude Desktop 配置问题
+  - MCP 服务器启动问题
+  - 配置文件格式错误处理
+  - 快速诊断检查清单
+
+- **新增 [迁移指南](./MIGRATION_GUIDE.md)**
+  - v1.3.x 到 v1.4.x 迁移说明
+  - 配置格式对照表
+  - 自动迁移和手动迁移步骤
+  - 版本兼容性说明
+
+- **更新 [使用指南](./USAGE_GUIDE.md)**
+  - 添加正确的配置格式注意事项
+  - 强调 servers vs mcpServers 的区别
+  - 添加必需字段说明
+
+- **更新 [README](./README.md)**
+  - 添加文档导航章节
+  - 改进故障排查章节
+  - 添加常见问题快速链接
+
+#### ✨ 功能增强
+
+- **`auto_setup` 自动升级旧配置**
+  - 检测使用旧格式 `mcpServers` 的配置
+  - 自动转换为新格式 `servers`
+  - 保留用户自定义配置
+  - 添加升级提示信息
+
+- **配置验证改进**
+  - 验证配置键名是否正确
+  - 检查必需字段是否存在
+  - 提供明确的错误信息和修复建议
+
+#### 🎯 配置格式说明
+
+**VS Code (v1.4.1+)**:
+```json
+{
+  "servers": {  // ✅ 正确
+    "copilot-prompts": {
+      "command": "node",
+      "args": ["..."],
+      "env": {},          // ✅ 必需
+      "autoStart": true   // ✅ 推荐
+    }
+  }
+}
+```
+
+**Claude Desktop** (保持不变):
+```json
+{
+  "mcpServers": {  // ✅ Claude 使用此格式
+    "copilot-prompts": {
+      "command": "node",
+      "args": ["..."]
+    }
+  }
+}
+```
+
+---
+
+## [1.4.0] - 2025-12-15
+
+### 🎉 Phase 4: 傻瓜模式增强
+
+#### 🚀 新增工具
+
+- **`auto_setup`** - 🎯 一键自动配置
+  - 自动创建 `.vscode/mcp.json`
+  - 自动配置 `settings.json`
+  - 自动添加推荐扩展
+  - 自动更新 `.gitignore`
+  - 智能检测 MCP 服务器路径
+  - 合并现有配置（不覆盖）
+
+- **`health_check`** - 🏥 健康检查诊断
+  - 服务器运行状态检查
+  - 配置文件完整性验证
+  - 依赖安装检查
+  - 规范文件检测
+  - 详细的修复建议
+  - 可选详细模式（verbose）
+
+- **`get_smart_standards`** - 🧠 零参数智能推荐
+  - 自动从文件路径检测类型
+  - 自动从内容提取导入
+  - 自动推断开发场景
+  - 环境感知（package.json）
+  - 无需手动指定任何参数
+
+- **`use_preset`** - ⚡ 预设场景快捷方式
+  - `vue3-component` - Vue 3 组件开发
+  - `vue3-form` - Vue 3 表单开发
+  - `vue3-table` - Vue 3 表格开发
+  - `pinia-store` - Pinia 状态管理
+  - `api-call` - API 调用层
+  - `typescript-strict` - TypeScript 严格模式
+  - `i18n` - 国际化开发
+  - `composable` - Vue 3 Composable
+
+- **`list_presets`** - 📋 列出所有可用预设
+
+#### ⚡ 功能增强
+
+- **`analyze_project`** 支持自动路径检测
+  - `projectPath` 参数变为可选
+  - 不填则自动使用当前工作目录
+  - 返回结果包含 `autoDetected` 标记
+
+### 🎯 使用体验提升
+
+- **配置时间**：从 5 分钟缩短至 30 秒
+- **使用门槛**：从需要理解配置到一句话搞定
+- **错误诊断**：从手动排查到自动诊断 + 建议
+- **参数填写**：从必须指定到智能检测
+- **场景匹配**：从描述场景到选择预设
+
+### 📚 测试
+
+- 新增 `test-phase4.cjs` - 6 个测试场景
+- 测试通过率：100%
+- 覆盖所有新增功能
+
+---
+
+## [1.3.0] - 2025-12-15
+
+### 🚀 新增功能
+
+#### 性能与缓存优化（Phase 3）
+- **智能缓存系统**：LRU 缓存机制，避免重复文件 I/O
+  - 缓存容量：50 个条目
+  - 缓存时长：30 分钟
+  - 自动淘汰：最少使用（LRU）策略
+- **使用统计**：记录最常用的规范和组合
+  - 热门规范 Top 5 排行
+  - 常用组合 Top 5 排行
+  - 优化推荐算法依据
+- **性能监控**：实时性能指标追踪
+  - 缓存命中率统计
+  - 平均响应时间
+  - Token 节省总计
+- **`get_standards_stats` 工具**：查看系统统计和性能数据
+
+### ⚡ 性能提升
+
+- **缓存命中率**：连续相同请求达到 300%+ 命中率
+- **响应时间**：从 ~2ms 降至 ~0.25ms（缓存命中时）
+- **Token 节省**：累计追踪，可视化节省效果
+- **组合优化**：智能去重 + 核心规范优先排序
+
+### 🔧 内部优化
+
+- 增强 `StandardsManager` 类：
+  - `updateCache()` - LRU 缓存更新
+  - `getPerformanceMetrics()` - 性能指标获取
+  - `getUsageStats()` - 使用统计
+  - `getCacheStats()` - 缓存详情
+  - `clearCache()` - 手动清除缓存
+- 优化 `combineStandards()` 方法：
+  - 自动去重
+  - 核心规范优先
+  - Token 计算与追踪
+- 优化 `readStandard()` 方法：
+  - 缓存检查
+  - 访问计数
+  - 响应时间统计
+
+### 🧪 测试
+
+- `test-phase3.cjs`：性能与缓存测试（4 个场景）
+  - 缓存效果验证
+  - 多场景使用统计
+  - 性能指标查看
+  - 缓存详情分析
+
+---
+
+## [1.2.0] - 2025-12-15
+
+### 🎉 新增功能
+
+#### MCP Resources 系统（Phase 1）
+- **模块化编码规范**：将大型 `copilot-instructions.md` 拆分为 8 个独立规范文件
+  - 核心规范（core）：code-style.md, typescript-base.md
+  - 框架规范（frameworks）：vue3-composition.md, pinia.md
+  - 库规范（libraries）：element-plus.md, i18n.md
+  - 模式规范（patterns）：api-layer.md, component-design.md
+- **MCP Resources API**：通过标准 MCP 协议提供规范访问
+  - `ListResources` - 列出所有可用规范
+  - `ReadResource` - 按需读取特定规范
+- **`get_relevant_standards` 工具**：智能推荐相关规范
+
+#### 增强上下文分析（Phase 2）
+- **自动导入检测**：从文件内容自动提取 import 语句
+- **智能匹配算法**：基于权重的多维度评分系统
+  - 文件类型匹配（权重 50）
+  - 直接导入匹配（权重 40）
+  - 场景匹配（权重 30）
+  - 相关导入匹配（权重 20）
+  - 内容关键词匹配（权重 15）
+- **`fileContent` 参数**：支持传入完整文件内容进行深度分析
+
+### ⚡ 性能优化
+
+- **Token 消耗降低 50-70%**：
+  - 传统方式：~10,000 tokens（完整规范）
+  - Resources 方式：~3,500 tokens（3-6 个模块）
+- **智能过滤**：低于阈值（10分）的规范不会被加载
+- **优先级排序**：高分规范优先返回
+
+### 📚 文档更新
+
+- 更新 README.md，添加 Resources 使用说明
+- 创建 `standards/README.md` 规范索引
+- 更新 `.github/copilot-instructions.md` 引用新系统
+- 添加 Phase 1 和 Phase 2 测试用例
+
+### 🧪 测试
+
+- `test-standards.cjs`：基础 Resources 功能测试（4 个场景）
+- `test-phase2.cjs`：增强上下文分析测试（4 个场景）
+
+### 🔧 内部改进
+
+- 新增 `StandardsManager` 类管理规范资源
+- 增强 `getRelevantStandards()` 方法支持多种输入模式
+- 添加 `detectImports()` 自动解析导入语句
+- 实现评分系统：`scoreByFileType`, `scoreByImports`, `scoreByScenario`, `scoreByContent`
+
+---
+
+## [1.1.0] - 2025-12-14
+
+### 新增
+
+- **MCP 服务器实现**：基于 Model Context Protocol 1.0
+- **4 个核心工具**：
+  - `analyze_project` - 项目分析
+  - `match_agents` - 智能匹配 Agents
+  - `list_available_agents` - 列出可用 Agents
+  - `generate_config` - 生成配置文件
+- **智能 Agent 匹配器**：基于加权评分算法
+- **GitHub API 集成**：动态获取 Agents
+
+### 优化
+
+- 模块化核心逻辑设计
+- 支持 Claude Desktop 等 MCP 客户端
+- 完善错误处理和日志输出
+
+---
+
+## [1.0.0] - 2025-12-10
+
+### 初始发布
+
+- 基础 MCP 服务器框架
+- 项目分析功能
+- Agent 匹配功能
+
+---
+
+## 版本说明
+
+- **主版本号（Major）**：不兼容的 API 变更
+- **次版本号（Minor）**：向下兼容的功能新增
+- **修订号（Patch）**：向下兼容的问题修正
+
+当前稳定版本：**1.2.0**