# 规范目录索引

## ⚠️ 编写新规范的强制要求

**创建任何新的标准规范文件前，必须：**

1. **加载现有规范** - 先查看同类规范的编写方式
   ```
   get_relevant_standards({ scenario: "规范编写" })
   ```

2. **确保每个规范文件包含强制工作流说明**
   - 在文档开头添加 `## ⚠️ 强制工作流` 章节
   - 说明何时必须先调用 `get_relevant_standards`
   - 提供具体的调用示例

3. **验证规范结构**
   - 包含清晰的使用场景说明
   - 提供正确/错误示例对比
   - 标注 Token 大小和预计加载时间

**示例模板：**
```markdown
# 新框架规范

## ⚠️ 强制工作流
**在使用此框架编写代码前，必须调用：**
\`\`\`
get_relevant_standards({ imports: ["framework-name"] })
\`\`\`

## 核心原则
...
```

---

## 📁 目录结构

```
standards/
├── core/                    # 核心规范（总是包含）
│   ├── mandatory-rules.md   # 零容忍规则（跨框架）
│   ├── code-style.md        # 代码风格规范
│   ├── code-generation.md   # 代码生成规范
│   ├── typescript-base.md   # TypeScript 基础（TS/Vue 自动注入）
│   └── dart-base.md         # Dart 基础（.dart 自动注入）
│
├── frameworks/              # 框架规范（按需加载）
│   ├── vue3-composition.md  # Vue 3 Composition API
│   ├── pinia.md             # Pinia 状态管理
│   ├── flutter.md           # Flutter 开发规范
│   ├── flutter-ui-system.md # Flutter UI Token 系统
│   └── wechat-miniprogram.md # 微信小程序
│
├── libraries/               # 库规范（按需加载）
│   ├── element-plus.md      # Element Plus
│   └── i18n.md              # 国际化（Vue + Flutter ARB）
│
├── patterns/                # 设计模式（智能推荐）
│   ├── api-layer.md             # API 层设计
│   ├── component-design.md      # 组件设计模式（Vue + Flutter）
│   ├── hardcoding-prevention.md  # 硬编码防范（新增）
│   ├── mock-data.md             # Mock 数据规范（新增）
│   ├── error-handling-unification.md # 统一错误处理（新增）
│   ├── code-file-splitting.md   # 代码文件拆分（新增）
│   ├── vue-css-nesting.md       # Vue CSS 嵌套
│   ├── vue-api-mock-layer.md    # Vue API Mock 层
│   └── design-system-restoration.md # 设计稿还原
│
└── workflows/               # 工作流规范（场景触发）
    ├── large-project-split.md  # 大型项目文档拆分
    ├── problem-diagnosis.md    # 问题诊断与修复
    ├── design-restoration.md   # 设计稿还原流程
    └── sketch-pitfalls.md      # Sketch 测量陷阱
```

## 🎯 规范分类

### Core (核心规范)
始终包含的基础规范

| 文件 | 大小 | 说明 |
|------|------|------|
| code-style.md | ~2KB | 命名、注释、代码组织 |
| typescript-base.md | ~3KB | TS 基础类型、函数、泛型 |
| dart-base.md | ~5KB | Dart 基础、空安全、异步编程 |

### Frameworks (框架规范)
根据项目框架按需加载

| 文件 | 技术栈 | 触发条件 |
|------|--------|----------|
| vue3-composition.md | Vue 3 | import vue |
| pinia.md | Pinia | import pinia |
| flutter.md | Flutter | import flutter, .dart 文件 |
| wechat-miniprogram.md | 微信小程序 | import wx, .js/.wxml/.wxss 文件 |

### Libraries (库规范)
根据使用的库按需加载

| 文件 | 库名称 | 触发条件 |
|------|--------|----------|
| element-plus.md | Element Plus | import element-plus |
| i18n.md | Vue I18n | import vue-i18n |

### Patterns (设计模式)
根据任务类型智能推荐

| 文件 | 场景 | 触发词 |
|------|------|--------|
| api-layer.md | API 调用 | API, axios, request |
| component-design.md | 组件设计 | component, widget, props |
| hardcoding-prevention.md | 硬编码防范 | 硬编码, hardcode, magic number |
| mock-data.md | Mock 数据 | mock, 假数据, 模拟数据 |
| error-handling-unification.md | 错误处理 | toast, snackbar, 错误处理 |
| code-file-splitting.md | 文件拆分 | 拆分, split, 行数 |
| vue-css-nesting.md | Vue CSS 嵌套写法 | style, css, scoped |
| vue-api-mock-layer.md | Vue API Mock 层 | mock, api |

### Workflows (工作流规范)
根据项目规模和场景触发

| 文件 | 场景 | 触发条件 |
|------|------|----------|
| large-project-split.md | 大型项目文档拆分 | 页面数>30, 模块>5, 原型分析 |
| problem-diagnosis.md | 问题诊断与修复 | 修复 Bug、样式问题、异常排查 |

## 🔧 使用示例

### 场景 1: 创建 Vue 3 组件
**加载规范:**
- core/code-style.md
- core/typescript-base.md
- frameworks/vue3-composition.md
- patterns/component-design.md

**预计 Token:** ~8KB (vs 传统 20KB)

### 场景 2: Pinia Store
**加载规范:**
- core/typescript-base.md
- frameworks/vue3-composition.md
- frameworks/pinia.md

**预计 Token:** ~6KB (vs 传统 20KB)

### 场景 3: Element Plus 表单
**加载规范:**
- core/code-style.md
- frameworks/vue3-composition.md
- libraries/element-plus.md
- libraries/i18n.md

**预计 Token:** ~9KB (vs 传统 20KB)

## 📊 Token 节省对比

| 传统方式 | MCP 方案 | 节省 |
|---------|---------|------|
| 20KB (全量) | 6-10KB (按需) | 50-70% |

## 🎨 匹配规则

```typescript
// 规范匹配配置
export const standardsMapping = {
  // 框架检测
  frameworks: {
    vue3: {
      imports: ['vue', '@vue'],
      files: ['.vue'],
      standards: ['vue3-composition']
    },
    pinia: {
      imports: ['pinia'],
      standards: ['pinia']
    }
  },
  
  // 库检测
  libraries: {
    'element-plus': {
      imports: ['element-plus'],
      standards: ['element-plus']
    },
    'vue-i18n': {
      imports: ['vue-i18n'],
      standards: ['i18n']
    }
  },
  
  // 模式检测
  patterns: {
    api: {
      keywords: ['api', 'axios', 'request', 'fetch'],
      standards: ['api-layer']
    },
    component: {
      keywords: ['component', 'props', 'emit'],
      standards: ['component-design']
    }
  },
  
  // 工作流检测
  workflows: {
    'large-project': {
      keywords: ['原型', '设计稿', '页面拆分', '模块规划', '开发计划', '大型项目'],
      conditions: ['页面数>30', '模块>5'],
      standards: ['large-project-split']
    }
  }
}
```