mta-mcp 2.6.0 → 2.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mta-mcp",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "MTA - 智能项目分析与编码规范管理 MCP 服务器",
   "type": "module",
   "main": "./dist/index.js",
@@ -24,7 +24,8 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsup",
+    "sync": "bash scripts/sync-resources.sh",
+    "build": "npm run sync && tsup",
     "watch": "tsup --watch",
     "start": "node bin/mta.js",
     "dev": "tsup --watch",
@@ -33,7 +34,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
-    "prepublishOnly": "npm run build && npm test"
+    "prepublishOnly": "npm run sync && npm run build && npm test"
   },
   "keywords": [
     "mcp",

package/standards/frameworks/flutter-ui-system.md

@@ -1,6 +1,6 @@
 # Flutter UI 开发规范 - Design Token 系统
 
-> my_flutter 项目专用的 UI 开发规范，基于 Design Token 和 Flex 组件系统
+> 基于 Design Token 和 Flex 组件系统的 Flutter UI 开发规范
 
 ## 🎯 核心原则
 
@@ -494,5 +494,4 @@ SvgPicture.asset(
 ---
 
 **维护团队**: MTA工作室  
-**适用项目**: my_flutter  
 **最后更新**: 2026-01-01

package/standards/workflows/large-project-split.md

@@ -221,7 +221,7 @@ src/views/main/模块名/
 ## 变更记录
 
 ### 2025-12-25
-- **临时任务**: 优化 API 封装
+- **临时任务**: 优化 API 封装，结合 VitaSage 的 wrap 函数
 - **影响范围**: src/api/request.ts, src/api/modules/*
 - **状态**: ✅ 已完成
 - **备注**: 新增 wrap 函数、文件上传下载、Mock 集成

package/templates/README.md

@@ -0,0 +1,144 @@
+# 📦 项目模板代码库
+
+> 预置的可复用代码模板，支持快速生成项目基础设施
+
+---
+
+## 🤖 Agent 使用指令
+
+当用户说出以下类似指令时，Agent 应按照本文档规范执行：
+
+**触发指令示例**：
+- "将 axios 模板应用到 ht-manage 项目"
+- "把 api-layer 模板复制到 VitaSage"
+- "给 xx 项目配置 API 层"
+- "应用 vue/api-layer 模板"
+
+**Agent 执行流程**：
+
+1. **识别模板** - 根据关键词匹配模板：
+   | 关键词 | 对应模板 |
+   |--------|----------|
+   | axios / api / api-layer / 请求封装 | `vue/api-layer` |
+   | types / 类型 | `common/types` |
+
+2. **确定目标路径** - 根据项目和模板类型：
+   | 模板 | 目标路径 |
+   |------|----------|
+   | `vue/api-layer` | `{项目}/src/api/` |
+   | `common/types` | `{项目}/src/types/` |
+
+3. **复制文件** - 将模板目录下的文件（排除 `_CONFIG.md`）复制到目标路径
+
+4. **提示配置** - 告知用户需要根据 `_CONFIG.md` 调整的配置项：
+   - UI 框架适配（showMessage）
+   - 后端响应格式适配
+   - Token 传递方式
+   - 环境变量配置
+
+**执行示例**：
+
+```
+用户: 将 axios 模板应用到 ht-manage 项目
+
+Agent 执行:
+1. 模板路径: /Users/pailasi/Work/copilot-prompts/templates/vue/api-layer/
+2. 目标路径: /Users/pailasi/Work/ht-manage/src/api/
+3. 复制文件:
+   - request.ts
+   - types.ts
+   - index.ts
+   - mock/index.ts
+   - modules/index.ts
+   - modules/_template.ts
+4. 提示用户按 _CONFIG.md 配置
+```
+
+---
+
+## 目录结构
+
+```
+templates/
+├── README.md                 # 本文件（含 Agent 指令）
+├── vue/                      # Vue 项目模板
+│   ├── api-layer/            # API 层封装（axios + mock）✅
+│   ├── composables/          # 通用 Composables（预留）
+│   ├── components/           # 通用组件模板（预留）
+│   └── stores/               # 状态管理模板（预留）
+├── flutter/                  # Flutter 项目模板（预留）
+│   ├── api-layer/
+│   └── themes/
+├── react/                    # React 项目模板（预留）
+└── common/                   # 跨框架通用模板
+    └── types/                # TypeScript 类型定义 ✅
+```
+
+---
+
+## 🎯 手动使用方式
+
+1. 进入对应模板目录
+2. 复制需要的文件到项目中
+3. 根据 `_CONFIG.md` 文件说明进行配置
+
+---
+
+## 📋 可用模板
+
+### Vue 项目
+
+| 模板 | 关键词 | 说明 | 状态 |
+|------|--------|------|------|
+| `vue/api-layer` | axios, api, 请求封装 | Axios + Mock 完整封装 | ✅ 可用 |
+| `vue/composables` | composable, hook | 通用 Composables | 🚧 计划中 |
+| `vue/components` | component, 组件 | 基础组件模板 | 🚧 计划中 |
+| `vue/stores` | pinia, store, 状态 | Pinia Store 模板 | 🚧 计划中 |
+
+### Flutter 项目
+
+| 模板 | 关键词 | 说明 | 状态 |
+|------|--------|------|------|
+| `flutter/api-layer` | dio, api | Dio + 状态管理封装 | 🚧 计划中 |
+| `flutter/themes` | theme, token | Design Token 系统 | 🚧 计划中 |
+
+### 通用模板
+
+| 模板 | 关键词 | 说明 | 状态 |
+|------|--------|------|------|
+| `common/types` | types, 类型 | TypeScript 通用类型 | ✅ 可用 |
+
+---
+
+## 🔧 模板规范
+
+每个模板目录必须包含：
+
+1. **`_CONFIG.md`** - 配置说明文件
+   - 模板用途
+   - 依赖要求
+   - 配置项说明
+   - 适配指南
+
+2. **源代码文件** - 可直接复制使用的代码
+   - 保持通用性，不含业务逻辑
+   - 标注自定义点（使用 `💡` 或 `TODO` 注释）
+   - 支持多种配置方案
+
+---
+
+## 🚀 扩展模板
+
+添加新模板时：
+
+1. 在对应框架目录下创建模板文件夹
+2. 编写 `_CONFIG.md` 配置说明
+3. 添加代码文件，确保通用性
+4. 更新本 README 的模板列表
+5. 如有相关规范文档，在 `standards/patterns/` 中添加
+
+---
+
+**维护者**: MTA工作室  
+**创建日期**: 2025-12-25  
+**版本**: v1.0

package/templates/common/types/_CONFIG.md

@@ -0,0 +1,12 @@
+# 通用 TypeScript 类型模板
+
+> 跨框架通用的类型定义
+
+## 📦 包含文件
+
+- `api.ts` - API 响应相关类型
+- `common.ts` - 通用业务类型
+
+## 🚀 使用方式
+
+复制到项目的 `src/types/` 目录

package/templates/common/types/api.ts

@@ -0,0 +1,39 @@
+/**
+ * API 相关类型定义
+ */
+
+/** API 响应基础结构 */
+export interface ApiResponse<T = any> {
+  code: number
+  data: T
+  message: string
+}
+
+/** 分页参数 */
+export interface PageParams {
+  page: number
+  pageSize: number
+}
+
+/** 分页数据 */
+export interface PageData<T> {
+  list: T[]
+  total: number
+  page: number
+  pageSize: number
+}
+
+/** 分页响应 */
+export type PageResponse<T> = ApiResponse<PageData<T>>
+
+/** 排序参数 */
+export interface SortParams {
+  sortField?: string
+  sortOrder?: 'asc' | 'desc'
+}
+
+/** 时间范围 */
+export interface DateRange {
+  startDate?: string
+  endDate?: string
+}

package/templates/common/types/common.ts

@@ -0,0 +1,70 @@
+/**
+ * 通用业务类型定义
+ */
+
+/** 通用 ID 类型 */
+export type ID = string | number
+
+/** 通用状态 */
+export type Status = 'active' | 'inactive' | 'pending' | 'deleted'
+
+/** 启用状态 */
+export type EnableStatus = 0 | 1
+
+/** 审核状态 */
+export type AuditStatus = 'pending' | 'approved' | 'rejected'
+
+/** 性别 */
+export type Gender = 'male' | 'female' | 'unknown'
+
+/** 键值对 */
+export interface KeyValue<T = any> {
+  key: string
+  value: T
+}
+
+/** 选项项（下拉框等） */
+export interface OptionItem<T = string | number> {
+  label: string
+  value: T
+  disabled?: boolean
+  children?: OptionItem<T>[]
+}
+
+/** 树形节点 */
+export interface TreeNode<T = any> {
+  id: ID
+  label: string
+  children?: TreeNode<T>[]
+  data?: T
+}
+
+/** 表格列配置 */
+export interface TableColumn {
+  prop: string
+  label: string
+  width?: number | string
+  minWidth?: number | string
+  fixed?: 'left' | 'right'
+  sortable?: boolean
+  align?: 'left' | 'center' | 'right'
+}
+
+/** 用户基础信息 */
+export interface UserBase {
+  id: ID
+  username: string
+  nickname?: string
+  avatar?: string
+  email?: string
+  phone?: string
+}
+
+/** 带时间戳的基础实体 */
+export interface BaseEntity {
+  id: ID
+  createdAt: string
+  updatedAt: string
+  createdBy?: ID
+  updatedBy?: ID
+}

package/templates/copilot-instructions-mcp-optimized.md

@@ -0,0 +1,158 @@
+<!-- ⚠️ 此文件由 Copilot Prompts MCP Server 生成 -->
+<!-- ℹ️ 你可以添加自定义内容，使用 CUSTOM_START/CUSTOM_END 标记保护 -->
+
+<!-- 🎯 作用域：此配置仅适用于当前项目 -->
+<!-- 项目名称: YourProject -->
+<!-- 项目路径: /path/to/your/project -->
+
+# 项目开发规范 - Copilot 指令
+
+> 📌 **配置信息**
+> - 生成时间: 2026-01-09
+> - 配置方式: MCP Token 优化模式
+> - Token 节省: 95%+ ✅
+
+---
+
+## ⚠️ 强制执行检查点
+
+> **此检查点的优先级高于本文件的所有其他内容**
+
+在执行**任何**以下操作前，必须先完成规范加载验证：
+
+### 受限操作清单
+
+- ❌ 创建任何代码文件（.vue、.ts、.tsx、.js 等）
+- ❌ 修改任何代码文件
+- ❌ 使用 `replace_string_in_file` 或 `multi_replace_string_in_file`
+- ❌ 生成任何代码片段
+
+### 强制验证流程
+
+1. **检查项目作用域** - 确认当前操作的文件路径包含 `/YourProject/`
+2. **加载相关规范** - 根据文件类型调用对应的 MCP 工具：
+   - Vue 文件 → `use_preset({ preset: "vue3-form" })` 或 `get_smart_standards()`
+   - TypeScript 文件 → `get_compact_standards({ currentFile: "xxx.ts" })`
+   - 特定场景 → 选择合适的预设或工具
+3. **验证加载成功** - 确认工具返回了规范内容
+4. **声明已加载** - 在响应中明确说明：`✅ 已加载规范: [工具名称]`
+
+### 违规处理
+
+- 如果未加载规范就生成代码 → **此操作无效，必须重新执行**
+- 如果出现语法错误 → **深刻反思，检查是否遵循了规范**
+- 如果出现低级错误 → **停止操作，重新加载规范后再继续**
+
+---
+
+## 🎯 作用域限制
+
+**⚠️ 此配置仅在以下情况生效：**
+
+1. 当前编辑的文件路径包含: `/YourProject/`
+2. 或当前工作目录为: `/path/to/your/project`
+
+**如果你在其他项目工作，请完全忽略此配置文件中的所有规范和指令。**
+
+---
+
+## ⚡ MCP 工具使用指南（Token 优化）
+
+> **核心理念**：不在配置文件中写规范，而是指导 AI 如何按需加载规范
+
+### 推荐工具（按优先级）
+
+| 优先级 | 工具 | Token 消耗 | 适用场景 |
+|-------|------|-----------|---------|
+| 🥇 | `use_preset` | ~500 | **最推荐**：表单、表格、API 等常见场景 |
+| 🥈 | `get_smart_standards` | ~2000 | 零参数，智能推荐 |
+| 🥉 | `get_compact_standards` | ~2000 | 精准控制（key-rules 模式） |
+| 🚫 | `get_relevant_standards` | ~15000 | 仅在需要完整规范时使用 |
+
+### 快速参考
+
+```typescript
+// 📋 创建表单组件
+use_preset({ preset: "vue3-form" })
+
+// 📊 创建数据表格
+use_preset({ preset: "vue3-table" })
+
+// 🌐 创建 API 接口
+use_preset({ preset: "api-call" })
+
+// 💾 创建 Pinia Store
+use_preset({ preset: "pinia-store" })
+
+// 🎯 零参数智能推荐
+get_smart_standards()
+
+// 🔍 按文件类型精准加载
+get_compact_standards({ 
+  currentFile: "src/views/User.vue",
+  mode: "key-rules"  // 默认，推荐
+})
+```
+
+### 标准开发流程
+
+1. ✅ **强制**: 加载规范（调用 MCP 工具）
+2. 理解需求
+3. 编写代码（遵循已加载的规范）
+4. 验证规范（确保符合要求）
+
+---
+
+## 📦 项目特定配置
+
+<!-- CUSTOM_START -->
+<!-- 在这里添加你的项目特定规范，这些内容会在配置更新时被保留 -->
+
+### 国际化规范
+
+- 所有文案使用 `$t('key')` 格式
+- 新增文案需同时添加中英文翻译
+
+### API 调用规范
+
+- 统一使用 `/src/api/` 目录管理接口
+- 接口命名遵循 RESTful 风格
+
+### 组件开发规范
+
+- 使用 Composition API
+- 使用 `<script setup>` 语法
+- 导出类型定义
+
+<!-- CUSTOM_END -->
+
+---
+
+## 🚫 禁止事项
+
+### 文档创建零容忍
+
+- ❌ **绝对禁止**：用户未明说时创建任何 .md 文档
+- ❌ **禁止主动询问**："是否需要创建文档？"
+- ✅ **正确做法**：仅在用户明确要求时创建文档
+
+### 代码质量零容忍
+
+**每次编辑后必检：**
+- ✅ 所有开始标签都有对应的结束标签
+- ✅ 缩进正确，嵌套层级清晰
+- ✅ 没有孤立的标签或重复的开始标签
+- ✅ Vue SFC 结构完整：`<template>` + `<script>` + `<style>`
+
+---
+
+## 📚 相关资源
+
+- [MCP Token 优化指南](https://github.com/ForLear/copilot-prompts/blob/main/docs/guides/MCP_TOKEN_OPTIMIZATION.md)
+- [预设场景列表](https://github.com/ForLear/copilot-prompts/blob/main/mcp-server/README.md#预设场景)
+- [规范库结构](https://github.com/ForLear/copilot-prompts/tree/main/standards)
+
+---
+
+**维护者**: MTA 工作室  
+**最后更新**: 2026-01-09

package/templates/vue/api-layer/_CONFIG.md

@@ -0,0 +1,145 @@
+# Vue API Layer 模板
+
+> Axios + Mock 完整封装，支持多种 UI 框架
+
+## 📋 模板信息
+
+- **适用框架**: Vue 3 + TypeScript
+- **构建工具**: Vite / Webpack
+- **UI 框架**: Element Plus / Ant Design Vue / Naive UI / 其他
+
+## 📦 包含文件
+
+```
+api-layer/
+├── _CONFIG.md              # 本文件
+├── request.ts              # Axios 核心封装
+├── mock/
+│   └── index.ts            # Mock 工具函数
+├── modules/
+│   ├── index.ts            # 模块导出
+│   └── _template.ts        # API 模块模板
+├── index.ts                # 统一入口
+└── types.ts                # 类型定义
+```
+
+## 🔧 依赖要求
+
+```json
+{
+  "dependencies": {
+    "axios": "^1.6.0"
+  }
+}
+```
+
+## 🚀 快速开始
+
+### 1. 复制文件
+
+将本目录下所有文件（除 `_CONFIG.md`）复制到项目的 `src/api/` 目录
+
+### 2. 配置环境变量
+
+```bash
+# .env.development
+VITE_API_BASE_URL=/api
+VITE_MOCK_ENABLED=true
+
+# .env.production
+VITE_API_BASE_URL=https://api.example.com
+VITE_MOCK_ENABLED=false
+```
+
+### 3. 适配 UI 框架
+
+编辑 `request.ts`，找到 `showMessage` 对象，替换为你的 UI 框架：
+
+```typescript
+// Element Plus
+import { ElMessage } from 'element-plus'
+const showMessage = {
+  success: (msg: string) => ElMessage.success(msg),
+  error: (msg: string) => ElMessage.error(msg),
+  warning: (msg: string) => ElMessage.warning(msg),
+}
+
+// Ant Design Vue
+import { message } from 'ant-design-vue'
+const showMessage = {
+  success: (msg: string) => message.success(msg),
+  error: (msg: string) => message.error(msg),
+  warning: (msg: string) => message.warning(msg),
+}
+
+// Naive UI
+import { useMessage } from 'naive-ui'
+// 需要在 setup 中使用，建议封装为工具函数
+```
+
+### 4. 适配后端响应格式
+
+编辑 `request.ts` 响应拦截器，调整业务状态码判断：
+
+```typescript
+// 常见格式 A: { code: 0, data, message }
+if (res.code === 0) return res
+
+// 常见格式 B: { code: 200, data, msg }
+if (res.code === 200) return res
+
+// 常见格式 C: { success: true, data, message }
+if (res.success === true) return res
+```
+
+### 5. 创建业务模块
+
+复制 `modules/_template.ts`，重命名为业务模块名（如 `user.ts`），修改内容。
+
+### 6. 导出模块
+
+编辑 `modules/index.ts`，添加导出：
+
+```typescript
+export * as userApi from './user'
+```
+
+---
+
+## ⚙️ 配置项
+
+### Token 配置
+
+| 配置项 | 位置 | 说明 |
+|--------|------|------|
+| `TOKEN_KEY` | request.ts | localStorage 存储键名 |
+| `USER_KEY` | request.ts | 用户信息存储键名 |
+| `NO_TOKEN_URLS` | request.ts | 无需 Token 的白名单 |
+| Token 传递方式 | 请求拦截器 | `Authorization: Bearer xxx` 或 `headers.token` |
+
+### 响应配置
+
+| 配置项 | 位置 | 说明 |
+|--------|------|------|
+| 成功状态码 | 响应拦截器 | `code === 0` 或 `code === 200` |
+| 错误消息字段 | 响应拦截器 | `message` 或 `msg` |
+| 登录过期处理 | 响应拦截器 | 清除 Token、跳转登录页 |
+
+### 类型配置
+
+| 配置项 | 位置 | 说明 |
+|--------|------|------|
+| 响应结构 | types.ts | `ApiResponse<T>` |
+| 分页参数 | types.ts | `PageParams` |
+| 分页数据 | types.ts | `PageData<T>` |
+
+---
+
+## 📚 相关文档
+
+- 详细规范：[vue-api-mock-layer.md](../../../standards/patterns/vue-api-mock-layer.md)
+
+---
+
+**版本**: v1.0  
+**更新日期**: 2025-12-25

package/templates/vue/api-layer/index.ts

@@ -0,0 +1,58 @@
+/**
+ * API 统一入口
+ *
+ * @example
+ * // 1. 导入模块使用
+ * import { userApi } from '@/api'
+ * const res = await userApi.getList(params)
+ *
+ * // 2. 使用 wrap 函数（推荐）
+ * import { wrap, userApi } from '@/api'
+ * const [res, err] = await wrap(userApi.getList(params))
+ * if (err) return
+ *
+ * // 3. 直接使用请求方法
+ * import { get, post } from '@/api'
+ * const res = await post('/custom/url', data)
+ */
+
+// 基础请求方法
+export {
+  get,
+  post,
+  put,
+  del,
+  wrap,
+  downloadFile,
+  uploadFile,
+} from './request'
+
+// Axios 实例
+export { default as axios } from './request'
+
+// Token 管理
+export {
+  getToken,
+  setToken,
+  clearToken,
+  getUserInfo,
+  setUserInfo,
+} from './request'
+
+// API 模块
+export * from './modules'
+
+// Mock 配置
+export { MOCK_ENABLED } from './mock'
+
+// 类型导出
+export type {
+  ApiResponse,
+  PageParams,
+  PageData,
+  PageResponse,
+  ID,
+  CommonStatus,
+  SortParams,
+  DateRangeParams,
+} from './types'