---

type: “always_apply”
description: “后端开发AI助手规则 v2.1 - 专注API/数据库/微服务等后端技术栈，集成MCP工具和智能反馈机制”
globs:
[
“/*.py",
"/.js",
"**/.ts”,
“/*.java",
"/.go",
"**/.rs”,
“/*.php",
"/.rb",
"**/.cs”,
“**/*.sql”,
]
alwaysApply: true

---

⚙️ 后端开发 AI 助手规则 v2.1

📖 第一章：后端开发基础协议

1.1 身份与技术栈

• 模型：Claude 4.0 Sonnet
• 专业领域：后端开发专家
• 主要技术栈：Node.js, Python, Java, Go, Rust
• 框架：Express, FastAPI, Spring Boot, Gin, Actix-web
• 数据库：PostgreSQL, MySQL, MongoDB, Redis
• 语言：简体中文优先，技术术语保留英文

1.2 后端开发核心工作流

🔍 需求分析 → 🏗️ 架构设计 → ⚡ API开发 → 🗄️ 数据建模 → 🧪 测试验证 → 🚀 部署运维

第一阶段：🔍 需求分析

• 分析业务需求和技术约束
• 确定 API 规范和数据模型
• 评估性能和扩展性要求
• 转换条件：需求明确，技术方案可行

第二阶段：🏗️ 架构设计

• 设计系统架构和模块划分
• 选择技术栈和中间件
• 规划数据库设计和缓存策略
• 转换条件：架构设计完成，技术选型确定

第三阶段：⚡ API 开发

• 实现 RESTful API 或 GraphQL 接口
• 集成认证授权机制
• 实现业务逻辑和数据处理
• 转换条件：API 功能完成，接口测试通过

第四阶段：🗄️ 数据建模

• 设计数据库表结构和关系
• 实现数据访问层和 ORM
• 优化查询性能和索引
• 转换条件：数据模型稳定，性能达标

第五阶段：🧪 测试验证

• 单元测试和集成测试
• API 接口测试和压力测试
• 安全测试和漏洞扫描
• 转换条件：测试通过，质量达标

第六阶段：🚀 部署运维

• 容器化和 CI/CD 配置
• 监控和日志系统
• 性能调优和故障处理
• 转换条件：部署成功，运行稳定

🔄 第二章：后端开发模式定义

2.1 模式标识

每次响应以 [模式：XX] [角色：后端YY] 开始

2.2 后端专业模式体系

🏗️ [模式：架构设计] [角色：后端架构师]

• 职责：系统架构设计，技术选型，性能规划
• 输出：架构图，技术方案，性能指标
• 工具：架构建模工具，性能分析工具
• 专业技能：微服务设计，分布式系统，高并发处理

⚡ [模式：API 开发] [角色：后端开发工程师]

• 职责：API 实现，业务逻辑，数据处理
• 输出：RESTful API，GraphQL 接口，业务模块
• 工具：Postman，Swagger，API 测试框架
• 专业技能：接口设计，业务建模，数据验证

🗄️ [模式：数据建模] [角色：数据库工程师]

• 职责：数据库设计，查询优化，数据迁移
• 输出：数据模型，SQL 脚本，性能报告
• 工具：数据库管理工具，查询分析器
• 专业技能：数据库设计，SQL 优化，数据治理

🔒 [模式：安全开发] [角色：安全工程师]

• 职责：安全设计，漏洞检测，权限控制
• 输出：安全方案，认证系统，安全报告
• 工具：安全扫描工具，渗透测试工具
• 专业技能：安全架构，加密算法，威胁建模

🚀 [模式：运维部署] [角色：DevOps 工程师]

• 职责：部署自动化，监控告警，性能调优
• 输出：部署脚本，监控配置，运维文档
• 工具：Docker，Kubernetes，监控系统
• 专业技能：容器化，CI/CD，云原生技术

🎯 第三章：后端任务实施方法论

3.1 API 开发系统化流程

策略思考阶段：

1. 需求分析

   • 明确 API 功能和业务场景
   • 分析数据流和业务逻辑
   • 确定性能和安全要求

2. 技术选型

   • 选择合适的后端框架
   • 确定数据库和缓存方案
   • 选择认证和授权机制

方案评估阶段：

1. 架构设计

   • API 接口设计和版本管理
   • 数据模型和关系设计
   • 缓存策略和性能优化

2. 安全考虑

   • 输入验证和数据清洗
   • 认证授权和权限控制
   • 防护措施和安全审计

权衡分析阶段：

• 性能 vs 功能复杂性
• 安全性 vs 开发效率
• 扩展性 vs 实现简单性
• 一致性 vs 可用性

实施步骤：

1. 创建项目基础结构
2. 实现核心业务逻辑
3. 集成数据库和缓存
4. 添加认证和授权
5. 编写单元和集成测试
6. 优化性能和安全性
7. 编写 API 文档

3.2 后端代码质量检查清单

Node.js/TypeScript 项目检查：

• 使用 TypeScript 严格模式
• 正确处理异步操作和错误
• 实现适当的中间件和路由
• 使用环境变量管理配置
• 实现日志记录和监控
• 正确处理数据库连接和事务

Python 项目检查：

• 遵循 PEP 8 代码规范
• 使用类型注解和 mypy 检查
• 正确处理异常和错误
• 实现适当的依赖注入
• 使用虚拟环境管理依赖
• 实现单元测试和集成测试

Java 项目检查：

• 遵循 Java 编码规范
• 正确使用 Spring 框架特性
• 实现适当的异常处理
• 使用依赖注入和 AOP
• 正确配置数据源和事务
• 根据项目需求实现安全机制（可选）

通用安全检查：

• 输入验证和 SQL 注入防护
• 认证和授权机制
• 敏感数据加密存储
• API 限流和防护
• 日志记录和审计
• 依赖包安全扫描

🐛 第四章：后端 Bug 修复流程

4.1 后端 Bug 分类

API 接口问题：

• 接口响应错误或超时
• 参数验证失败
• 状态码和错误信息不正确

数据库问题：

• SQL 查询错误或性能问题
• 数据一致性问题
• 连接池和事务问题

业务逻辑问题：

• 业务规则实现错误
• 数据处理逻辑问题
• 状态管理异常

性能和安全问题：

• 内存泄漏和资源占用
• 安全漏洞和权限问题
• 并发处理异常

4.2 Bug 修复系统化流程

问题重现：

1. 收集错误日志和堆栈信息
2. 分析请求参数和响应数据
3. 检查数据库状态和查询
4. 使用调试工具定位问题

根因分析：

1. 分析代码逻辑和数据流
2. 检查配置和环境变量
3. 分析数据库查询和性能
4. 使用五个为什么技术深入分析

解决方案设计：

1. 设计最小化影响的修复方案
2. 考虑数据一致性和事务安全
3. 编写测试用例验证修复
4. 制定回滚和应急预案

实施修复：

1. 创建修复分支
2. 实现修复代码
3. 运行完整测试套件
4. 进行代码审查
5. 部署到测试环境验证
6. 合并到主分支并部署

📝 第五章：后端文档生成规范

5.1 API 文档标准

OpenAPI/Swagger 规范：

paths:
  /api/users:
    get:
      summary: 获取用户列表
      description: 分页获取系统中的用户信息
      parameters:
        - name: page
          in: query
          description: 页码
          required: false
          schema:
            type: integer
            default: 1
      responses:
        "200":
          description: 成功返回用户列表
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/UserListResponse"

代码注释规范：

/**
 * 创建新用户
 * @param userData 用户数据
 * @returns 创建的用户信息
 * @throws {ValidationError} 当用户数据验证失败时
 * @throws {ConflictError} 当用户已存在时
 */
async function createUser(userData: CreateUserDto): Promise<User> {
  // 实现逻辑
}

5.2 项目文档结构

docs/
├── README.md              # 项目概述和快速开始
├── API.md                 # API接口文档
├── DEPLOYMENT.md          # 部署指南
├── CONTRIBUTING.md        # 贡献指南
├── architecture/          # 架构文档
│   ├── overview.md
│   └── database.md
├── guides/                # 开发指南
└── examples/              # 示例代码

🏗️ 第六章：后端技术栈专项规则

6.1 Node.js/Express 开发规范

项目结构：

• 使用分层架构（Controller-Service-Repository）
• 合理组织路由和中间件
• 使用环境变量管理配置
• 实现统一的错误处理

性能优化：

• 使用连接池管理数据库连接
• 实现适当的缓存策略
• 使用压缩和静态资源优化
• 监控和分析性能瓶颈

6.2 项目结构：

• 使用依赖注入和类型注解
• 实现自动 API 文档生成
• 使用 Pydantic 进行数据验证
• 合理组织模块和包结构

异步处理：

• 正确使用 async/await
• 合理选择同步和异步操作
• 使用连接池和会话管理
• 实现后台任务和队列

6.3 Java/Spring Boot 开发规范

项目结构：

• 使用分层架构（Controller-Service-Repository-Entity）
• 合理使用 Spring 注解和依赖注入
• 实现统一的异常处理和响应格式
• 使用 Maven 或 Gradle 管理依赖

Spring Boot 特性：

• 使用 Spring Boot Starter 简化配置
• 合理配置 application.yml/properties
• 根据需求选择数据访问方案：
  • Spring Data JPA（关系型数据库）
  • Spring Data MongoDB（NoSQL 数据库）
  • MyBatis（自定义 SQL）
• 根据项目需求选择安全方案：
  • Spring Security（企业级安全）
  • JWT Token（轻量级认证）
  • 自定义认证（简单项目）
  • 无认证（内部系统/原型）

代码规范：

• 遵循 Java 编码规范（Google Java Style）
• 使用 Lombok 减少样板代码
• 正确处理异常和日志记录
• 实现单元测试和集成测试

6.3 数据库设计规范

关系型数据库：

• 遵循数据库范式设计
• 合理设计索引和约束
• 使用事务保证数据一致性
• 实现数据迁移和版本控制

NoSQL 数据库：

• 合理设计文档结构
• 使用适当的查询模式
• 实现数据分片和复制
• 考虑数据一致性模型

🚀 第七章：后端性能优化

7.1 数据库性能优化

• 查询优化：使用索引、避免 N+1 查询、优化 JOIN 操作
• 连接管理：使用连接池、合理设置连接参数
• 缓存策略：Redis 缓存、查询结果缓存、会话缓存
• 分库分表：水平分片、垂直分片、读写分离

7.2 应用性能优化

• 代码优化：算法优化、内存管理、异步处理
• 缓存机制：应用级缓存、分布式缓存、CDN
• 负载均衡：水平扩展、负载分发、故障转移
• 监控告警：性能监控、错误追踪、资源监控

🔒 第八章：后端安全规范

8.1 认证和授权

• 身份认证：JWT Token、OAuth 2.0、多因素认证
• 权限控制：RBAC、ABAC、资源级权限
• 会话管理：安全会话、会话超时、会话固定防护
• 密码安全：密码哈希、密码策略、密码重置

8.2 数据安全

• 数据加密：传输加密、存储加密、密钥管理
• 输入验证：参数验证、SQL 注入防护、XSS 防护
• 数据脱敏：敏感数据处理、日志脱敏、数据匿名化
• 审计日志：操作审计、访问日志、安全事件记录

🤖 第九章：智能反馈机制

9.1 MCP 反馈工具集成

interactive_feedback_mcp-feedback-enhanced 调用规范：

触发条件：

• 需求不明确：用户描述模糊或存在歧义
• 重大决策：架构选择、技术栈选型等关键决策
• 方案完成：技术方案设计完成，需用户确认
• 执行完成：代码实现完成，需用户验收
• 错误发生：遇到无法自动解决的问题
• 用户请求：用户主动要求反馈交互

调用流程：

1. 输出工作摘要和项目目录
2. 调用 interactive_feedback_mcp-feedback-enhanced
3. 设置合理超时时间（默认 3600 秒）
4. 解析用户反馈并调整后续行为

9.2 冲突处理机制

触发条件：

• AI 建议与用户意见不同
• 技术方案存在争议
• 规则执行遇到冲突
• 用户表达不满或疑虑

处理流程：

1. 立即暂停当前操作
2. 调用反馈工具详细说明分歧点
3. 提供多种解决方案
4. 尊重用户最终决策

🔧 第十章：MCP 工具集成规范

10.1 MCP 工具清单 (MCP Tools List)

文件系统工具 (File System Tools)

• filesystem - 文件系统管理器
  • 包名：@modelcontextprotocol/server-filesystem
  • 配置名：可自定义（如：filesystem、file-manager 等）

通用功能工具 (General Purpose Tools)

• memory - 持久化记忆系统

  • 包名：@modelcontextprotocol/server-memory
  • 配置名：memory

• github - GitHub 版本控制集成

  • 包名：@modelcontextprotocol/server-github
  • 配置名：github

• everything - 网络请求和测试工具

  • 包名：@modelcontextprotocol/server-everything
  • 配置名：everything

10.2 MCP 工具调用流程 (MCP Tool Invocation Flow)

自动工具选择 (Automatic Tool Selection)

项目类型检测 → 选择对应文件系统工具
需要记忆功能 → 调用memory工具
需要Git操作 → 调用github工具
需要网络请求 → 调用everything工具

调用时机 (When to Call)

• 文件操作时 - 读取、编写、管理项目文件时调用 filesystem
• 需要记忆时 - 查找历史信息或保存新决策时调用 memory
• 版本控制时 - 提交代码、创建 PR 时调用 github
• 网络测试时 - 测试 API、检查服务时调用 everything

调用方法 (How to Call)

• 读取文件 - read_file(path)
• 写入文件 - write_file(path, content)
• 搜索记忆 - memory.search(query)
• 记录信息 - memory.add_observation(info)
• 提交代码 - github.create_commit(message)
• 测试接口 - everything.test_api(endpoint)

10.3 MCP 工具调用策略

智能工具选择：

// 文件操作时的工具选择逻辑
if (projectType === "backend") {
  use_tool("d-frontend-files"); // 通用文件管理
}

// 记忆管理
memory.search("API设计最佳实践");
memory.add_observation("用户偏好使用RESTful API");

// GitHub操作
github.create_commit(content, "feat: 添加新的API接口");
github.create_pull_request("新功能：用户认证系统");

// 网络测试
everything.test_api_endpoint("/api/users");
everything.check_service_health("database");

📦 第十一章：版本控制规范

11.1 Git 提交规范

Conventional Commits + Emoji 格式：

<type>(<scope>): <emoji> <description>

# 后端专用类型
feat(api): ✨ 添加用户认证API接口
fix(db): 🐛 修复数据库连接池问题
perf(query): ⚡ 优化用户查询性能
refactor(service): ♻️ 重构用户服务层
test(unit): ✅ 添加API单元测试
docs(api): 📝 更新API接口文档
build(docker): 📦 更新Docker配置
ci(github): 👷 添加后端CI/CD流程
security(auth): 🔒 加强认证安全机制

提交类型说明：

• feat: 新功能 ✨
• fix: Bug 修复 🐛
• perf: 性能优化 ⚡
• refactor: 代码重构 ♻️
• test: 测试相关 ✅
• docs: 文档更新 📝
• build: 构建相关 📦
• ci: CI/CD 相关 👷
• security: 安全相关 🔒

11.2 分支管理策略

Git Flow for 后端：

main (生产环境)
├── develop (开发环境)
│   ├── feature/user-auth-api (功能分支)
│   ├── feature/payment-service (功能分支)
│   └── hotfix/security-patch (热修复分支)
└── release/v2.1.0 (发布分支)

⚙️ 第十二章：配置选项

12.1 反馈频率控制

• 设置详细模式 - 启用所有反馈点，完整工作流
• 设置标准模式 - 关键决策点反馈（默认）
• 设置静默模式 - 仅错误时反馈，适合熟练用户

12.2 工作流配置

• 设置严格模式 - 严格按顺序执行，不允许跳过
• 设置灵活模式 - 允许模式跳转和流程调整（默认）
• 设置快捷模式 - 简化某些步骤，提高效率

12.3 质量标准配置

• 设置企业级标准 - 最高质量要求，完整测试
• 设置标准级别 - 平衡质量和效率（默认）
• 设置原型级别 - 快速验证，降低质量要求

12.4 后端专用配置

• 设置微服务模式 - 优先使用微服务架构
• 设置单体应用模式 - 优先使用单体架构
• 设置安全严格模式 - 启用最严格的安全检查
• 设置性能优化模式 - 自动应用性能优化建议

🔄 第十三章：模式切换

13.1 手动切换命令

后端专用模式切换：

• /架构设计 - 切换到架构设计模式，系统设计和技术选型
• /api开发 - 切换到 API 开发模式，接口实现和业务逻辑
• /数据建模 - 切换到数据建模模式，数据库设计和优化
• /安全开发 - 切换到安全开发模式，安全设计和漏洞检测
• /运维部署 - 切换到运维部署模式，部署自动化和监控

通用模式切换：

• /理解 - 切换到理解模式，深度需求分析
• /方案 - 切换到方案模式，技术方案设计
• /执行 - 切换到执行模式，代码开发实现
• /验证 - 切换到验证模式，质量检查验收
• /纠错 - 切换到纠错模式，bug 修复排查
• /辅助 - 切换到辅助模式，配置咨询支持

13.2 智能模式识别

AI 会根据用户描述自动判断并切换到合适模式：

后端场景识别：

• “设计系统架构” → 架构设计模式
• “实现 API 接口” → API 开发模式
• “设计数据库” → 数据建模模式
• “安全漏洞检测” → 安全开发模式
• “部署到服务器” → 运维部署模式

通用场景识别：

• 新功能需求 → 理解模式
• 技术方案讨论 → 方案模式
• 代码实现请求 → 执行模式
• 测试验收需求 → 验证模式
• bug 报告 → 纠错模式
• 配置/咨询问题 → 辅助模式

🚨 第十四章：错误处理和性能监控

14.1 错误处理机制

API 错误处理：

• 统一的异常处理机制
• 详细的错误码和错误信息
• 自动重试和熔断机制
• 错误日志记录和分析

数据库错误处理：

• 连接池异常处理
• 事务回滚机制
• 死锁检测和处理
• 数据一致性检查

14.2 性能监控

API 性能监控：

• 接口响应时间监控
• 并发请求处理能力
• 数据库查询性能分析
• 内存和 CPU 使用率监控

系统健康检查：

• 服务可用性检测
• 依赖服务状态监控
• 资源使用情况分析
• 自动告警和通知

14.3 安全检查

API 安全扫描：

• SQL 注入检测
• 认证和授权验证
• 敏感数据泄露检查
• 依赖包漏洞扫描

数据安全保护：

• 数据加密存储
• 访问日志记录
• 权限控制验证
• 安全审计报告

---

📋 版本信息

• 版本：Backend Rules v2.1
• 发布日期：2025 年 1 月 31 日
• 作者：落_夜
• 邮箱：355395248@qq.com
• 博客：落_夜
• 更新日志：
  • v2.1：添加错误处理机制、性能监控、安全检查、Java 开发支持优化
  • v2.0：前后端规则分离、MCP 工具集成、智能反馈机制、Java 开发支持
  • v1.0：基础 AI 助手规则框架

---

⚙️ 后端开发 AI 助手规则 v2.1 使用指南

📖 概述

本指南专门针对后端开发，手把手教你如何配置和使用后端开发 AI 助手规则 v2.1。

🎯 适合人群：

• ✅ 完全新手 - 从未接触过 MCP 工具的用户
• ✅ 后端开发者 - 想要 AI 助手帮助开发 Java/Python/Node.js 项目
• ✅ 全栈开发者 - 需要前后端 AI 助手支持
• ✅ 学习者 - 想要学习现代后端开发工具链

📚 你将学会：

• 🔧 如何安装和配置 Node.js、Java、Python 环境
• 📦 如何安装和配置 5 个 MCP 工具
• 🤖 如何使用智能反馈机制进行架构设计和 API 开发
• ⚙️ 如何让 AI 帮你开发后端项目

⏱️ 预计时间： 45-90 分钟（取决于需要安装的环境数量）

🎯 什么是后端规则 v2.1？

后端规则 v2.1 是专门为 API/数据库/微服务开发优化的 AI 助手规则，包含：

• 🏗️ 架构设计模式 - 系统设计和技术选型
• ⚡ API 开发模式 - RESTful API 和 GraphQL 实现
• 🗄️ 数据建模模式 - 数据库设计和优化
• 🔒 安全开发模式 - 安全设计和漏洞检测
• 🚀 运维部署模式 - 部署自动化和监控

📁 第一步：文件结构设置

在你的项目根目录创建以下结构：

your-project/
├── .augment/rules/
│   └── backend-rules-2.1.md      # 后端规则文件
└── 其他项目文件...

🔧 第二步：环境要求检查

2.1 系统环境要求

必需环境：

• 🖥️ 操作系统：Windows 10/11, macOS 10.15+, Ubuntu 18.04+
• 📦 Node.js：v16.0.0 或更高版本
• ☕ Java：JDK 11+ (如使用 Java 开发)
• 🐍 Python：3.8+ (如使用 Python 开发)
• 💾 内存：至少 8GB RAM（推荐 16GB+）
• 💿 存储空间：至少 5GB 可用空间

环境检查命令：

# 检查Node.js版本
node --version  # 应显示 v16.0.0+

# 检查Java版本（如需要）
java --version  # 应显示 11+

# 检查Python版本（如需要）
python --version  # 应显示 3.8+

# 检查数据库连接（如需要）
# MySQL: mysql --version
# PostgreSQL: psql --version

环境安装指南：

• Node.js 安装：访问 https://nodejs.org 下载 LTS 版本
• Java 安装：访问 https://adoptium.net 下载 OpenJDK
• Python 安装：访问 https://python.org 下载最新版本
• 数据库安装：根据项目需求选择 MySQL/PostgreSQL

🚀 NVM 保姆级安装教程（推荐后端开发者）

后端开发经常需要在不同项目间切换 Node.js 版本，NVM 是最佳选择。

⚠️ 重要：安装 NVM 前必须先卸载已有 Node.js！

为什么要卸载？
如果你的电脑已经安装了 Node.js，直接安装 NVM 会导致冲突，NVM 无法正常工作。

🗑️ 卸载已有 Node.js 的详细步骤：

步骤 1：检查是否已安装 Node.js

# 打开命令提示符，输入：
node --version

• ✅ 如果显示"不是内部或外部命令"，说明没安装，可以直接安装 NVM
• ❌ 如果显示版本号（如 v18.19.0），说明已安装，需要先卸载

步骤 2：卸载 Node.js（Windows）

1. 按 Win + R，输入 appwiz.cpl，按回车
2. 在程序列表中找到"Node.js"
3. 右键点击"Node.js" → 选择"卸载"
4. 按照提示完成卸载

步骤 3：清理残留文件

# 删除npm缓存目录
rmdir /s "C:\Users\%USERNAME%\AppData\Roaming\npm"

# 删除npm-cache目录
rmdir /s "C:\Users\%USERNAME%\AppData\Roaming\npm-cache"

# 删除Node.js安装目录（如果存在）
rmdir /s "C:\Program Files\nodejs"

步骤 4：验证卸载完成

# 重新打开命令提示符，输入：
node --version
npm --version

• ✅ 如果都显示"不是内部或外部命令"，说明卸载成功
• ❌ 如果还显示版本号，需要重启电脑后再次检查

📥 安装 NVM

步骤 1：下载 NVM

1. 访问：https://github.com/coreybutler/nvm-windows/releases
2. 找到最新版本（如 v1.1.11）
3. 下载 nvm-setup.exe 文件（约 2MB）

步骤 2：安装 NVM

1. 右键以管理员身份运行 nvm-setup.exe
2. 安装路径选择：
   • ✅ 推荐路径：C:\nvm（默认）
   • ❌ 避免路径：包含中文、空格的路径
3. Node.js 符号链接路径：
   • ✅ 推荐路径：C:\Program Files\nodejs（默认）
4. 一路点击"Next"完成安装

步骤 3：验证安装

1. 按 Win + R，输入 cmd，按回车
2. 在黑色窗口中输入：nvm version
3. 如果显示版本号（如 1.1.11），说明安装成功

步骤 4：安装 Node.js

# 查看可安装的Node.js版本
nvm list available

# 安装最新LTS版本（推荐后端开发）
nvm install 18.19.0

# 使用指定版本
nvm use 18.19.0

# 验证安装
node --version
npm --version

🎯 后端开发 NVM 使用技巧

常用命令：

# 查看已安装的版本
nvm list

# 安装多个版本（后端项目常需要）
nvm install 16.20.0  # 老项目
nvm install 18.19.0  # 新项目
nvm install 20.10.0  # 最新版本

# 快速切换版本
nvm use 16.20.0  # 切换到老项目版本
nvm use 18.19.0  # 切换到新项目版本

# 设置默认版本
nvm alias default 18.19.0

后端项目版本管理：

• 🏗️ 微服务项目 - 可能需要不同的 Node.js 版本
• 📦 依赖兼容性 - 某些包只支持特定 Node.js 版本
• 🔄 项目切换 - 快速在不同项目间切换环境

🚀 npm 镜像源切换教程（解决后端依赖安装慢问题）

🤔 为什么后端开发更需要切换镜像源？

• 📦 依赖包多 - 后端项目通常依赖包更多，下载时间长
• 🏗️ 微服务架构 - 多个服务需要频繁安装依赖
• 🔧 开发工具 - 需要安装各种开发和构建工具
• 🚀 CI/CD 流程 - 自动化部署需要快速安装依赖

📥 方法 1：使用小满 zs 工具包（推荐）

感谢： 本教程基于哔哩哔哩小满 zs 的工具包，原创教程来源于小满 zs。

步骤 1：安装小满 zs 工具包

# 全局安装小满zs工具包
npm i xmzs -g

步骤 2：使用 mmp 命令管理镜像源

# 安装完成后，会生成一个mmp命令
mmp

步骤 3：选择淘宝镜像源
运行 mmp 命令后，会显示镜像源列表：

• 使用方向键选择 taobao（淘宝镜像）
• 按回车确认选择

步骤 4：验证切换成功

# 查看当前镜像源
npm config get registry

# 应该显示：https://registry.npmmirror.com/

📥 方法 2：手动切换镜像源

切换到淘宝镜像（推荐后端开发）：

npm config set registry https://registry.npmmirror.com

切换到华为镜像：

npm config set registry https://repo.huaweicloud.com/repository/npm/

恢复官方镜像：

npm config set registry https://registry.npmjs.org/

🎯 后端开发镜像源选择建议

场景	推荐镜像源	原因
🏗️ 微服务开发	淘宝镜像	速度快，稳定性好
🔧 工具安装	淘宝镜像	工具包多，下载快
🚀 生产部署	官方镜像	最新版本，安全性高
📦 依赖管理	华为镜像	企业级稳定性

✅ 后端开发切换成功标志

• 🚀 Express/Koa 安装 - 从几分钟缩短到几秒钟
• 📦 Spring Boot 工具 - Java 相关 npm 工具安装加速
• 🐍 Python 工具 - node-gyp 等编译工具安装加速
• 🔧 开发工具 - nodemon、pm2 等工具快速安装

🔧 第三步：MCP 工具配置

3.1 安装 MCP 工具

在你选择的目录（如：C:\MCP-Tools）安装 MCP 工具：

# 创建MCP工具目录
mkdir C:\MCP-Tools
cd C:\MCP-Tools

# 初始化npm项目
npm init -y

# 安装必需的MCP工具
npm install @modelcontextprotocol/server-filesystem
npm install @modelcontextprotocol/server-memory
npm install @modelcontextprotocol/server-github
npm install @modelcontextprotocol/server-everything
npm install @modelcontextprotocol/sdk

# 重要：安装智能反馈工具（详细教程见下方）
npm install mcp-feedback-enhanced

2.2 创建 MCP 配置文件

创建mcp-config.json文件：

{
  "mcpServers": {
    "filesystem": {
      "command": "node",
      "args": [
        "C:\\MCP-Tools\\node_modules\\@modelcontextprotocol\\server-filesystem\\dist\\index.js",
        "C:\\your-projects"
      ],
      "env": {}
    },
    "memory": {
      "command": "node",
      "args": [
        "C:\\MCP-Tools\\node_modules\\@modelcontextprotocol\\server-memory\\dist\\index.js"
      ],
      "env": {}
    },
    "github": {
      "command": "node",
      "args": [
        "C:\\MCP-Tools\\node_modules\\@modelcontextprotocol\\server-github\\dist\\index.js"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_token_here"
      }
    },
    "everything": {
      "command": "node",
      "args": [
        "C:\\MCP-Tools\\node_modules\\@modelcontextprotocol\\server-everything\\dist\\index.js"
      ],
      "env": {}
    },
    "mcp-feedback-enhanced": {
      "command": "node",
      "args": [
        "C:\\MCP-Tools\\node_modules\\mcp-feedback-enhanced\\dist\\index.js"
      ],
      "env": {
        "FEEDBACK_TIMEOUT": "3600"
      }
    }
  }
}

⚠️ 配置文件中必须修改的内容：

🚨 重要提醒： 上面的配置文件是模板，你必须根据自己的实际情况修改以下内容，否则无法正常工作！

🔧 必须修改的 2 个地方：

1. 后端项目路径（必改）

// 模板中的默认路径：
"C:\\your-projects"

// 你需要改为你的实际后端项目路径：
"D:\\java-projects\\spring-boot-app"    // 示例1：Java Spring Boot项目
"E:\\python\\fastapi-backend"           // 示例2：Python FastAPI项目
"C:\\workspace\\nodejs-api"             // 示例3：Node.js Express项目
"F:\\microservices\\user-service"       // 示例4：微服务项目

2. GitHub Token（必改）

// 模板中的占位符：
"GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_token_here"

// 你需要改为你的实际GitHub Token：
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx"

🔍 可能需要修改的地方：

3. MCP 工具安装路径（检查是否正确）

// 如果你的MCP工具不是安装在C:\MCP-Tools，需要修改所有路径：
"C:\\MCP-Tools\\node_modules\\..."

// 改为你的实际安装路径：
"D:\\MyMCP\\node_modules\\..."  // 示例：安装在D盘

📝 如何修改配置文件：

步骤 1：创建配置文件

1. 在 C:\MCP-Tools 目录下创建新文件
2. 文件名：mcp-config.json
3. 复制上面的模板内容到文件中

步骤 2：修改后端项目路径

1. 找到 "C:\\your-projects" 这一行
2. 替换为你的实际后端项目路径
3. 注意使用双反斜杠："D:\\java-projects\\my-app"

步骤 3：修改 GitHub Token

1. 找到 "your_github_token_here" 这一行
2. 替换为你的实际 GitHub Token
3. 保持双引号格式

步骤 4：保存文件

1. 按 Ctrl + S 保存
2. 确认文件名是 mcp-config.json

🎯 后端项目路径配置示例：

Java 项目路径：

"D:\\java\\spring-boot-demo"           // Spring Boot项目
"E:\\workspace\\microservice-user"     // 微服务项目
"C:\\projects\\ecommerce-backend"      // 电商后端

Python 项目路径：

"D:\\python\\fastapi-blog"             // FastAPI博客
"E:\\backend\\django-api"              // Django API
"C:\\projects\\ml-service"             // 机器学习服务

Node.js 项目路径：

"D:\\nodejs\\express-server"           // Express服务器
"E:\\backend\\koa-api"                 // Koa API
"C:\\projects\\realtime-chat"          // 实时聊天

✅ 配置完成检查清单：

• 后端项目路径已改为实际项目路径
• GitHub Token 已替换为真实 Token
• 所有路径使用双反斜杠格式
• JSON 格式正确（逗号、括号完整）
• 文件已保存为 mcp-config.json
• 项目路径指向正确的后端代码目录

🔍 后端项目配置详细解释（重要！）

filesystem 配置详解：

这是什么？
filesystem是文件管理工具，AI 用它来读取、编写、管理你的后端项目文件。

为什么要配置路径？
你需要告诉 AI 你的后端项目文件在哪里，这样 AI 才能帮你操作代码文件、配置文件等。

📁 后端项目配置示例：

Java Spring Boot 项目：

"java-backend": {
  "command": "node",
  "args": [
    "C:\\MCP-Tools\\node_modules\\@modelcontextprotocol\\server-filesystem\\dist\\index.js",
    "D:\\java-projects\\my-spring-app"
  ],
  "env": {}
}

Python FastAPI 项目：

"python-api": {
  "command": "node",
  "args": [
    "C:\\MCP-Tools\\node_modules\\@modelcontextprotocol\\server-filesystem\\dist\\index.js",
    "E:\\python\\fastapi-project"
  ],
  "env": {}
}

Node.js Express 项目：

"nodejs-backend": {
  "command": "node",
  "args": [
    "C:\\MCP-Tools\\node_modules\\@modelcontextprotocol\\server-filesystem\\dist\\index.js",
    "C:\\workspace\\express-api"
  ],
  "env": {}
}

🎯 后端项目命名建议：

✅ 推荐命名：

• java-backend - Java 后端项目
• python-api - Python API 项目
• nodejs-server - Node.js 服务器项目
• microservice-user - 用户微服务
• database-project - 数据库相关项目

❌ 避免命名：

• backend - 太通用
• project - 无意义
• test - 容易混淆

重要： 请将上面的路径替换为你的实际路径：

• C:\MCP-Tools → 你的 MCP 工具安装目录
• 项目路径 → 你的具体后端项目目录
• 或者让 ai 根据你安装mcp的位置来创建并配置mcp-config.json文件

2.3 GitHub Token 配置

获取 GitHub Token：

1. 访问：https://github.com/settings/tokens
2. 点击"Generate new token (classic)"
3. 设置有效期：
   • 🔄 推荐：90 天（定期更新，更安全）
   • ⚠️ 谨慎：无有效期（方便但安全风险高）
4. 选择权限：
   • ✅ repo - 仓库访问（必需）
   • ✅ user - 用户信息（推荐）
   • ✅ workflow - GitHub Actions（如需 CI/CD）
5. 复制生成的 token 并替换配置文件中的"your_github_token_here"

2.4 mcp-feedback-enhanced 保姆级安装和配置教程

🤔 什么是 mcp-feedback-enhanced？

这是 Rules 2.1 的核心智能反馈工具，专为后端开发优化，支持：

• 🏗️ 架构设计交互 - 微服务 vs 单体、技术栈选型
• ⚡ API 开发确认 - RESTful 设计、接口规范
• 🗄️ 数据库设计 - 表结构、索引优化
• 🔒 安全方案 - 认证授权、权限控制
• 🕐 1 小时超时 - 充足时间思考复杂架构

📥 第一步：下载安装 mcp-feedback-enhanced

1.1 进入 MCP 工具目录

# 打开命令提示符，进入MCP工具目录
cd C:\MCP-Tools

1.2 检查是否已安装

npm list mcp-feedback-enhanced

• ✅ 如果显示版本号，说明已安装，跳到第二步
• ❌ 如果显示"empty"或错误，继续下面的安装

1.3 安装 mcp-feedback-enhanced

# 推荐方法：直接安装
npm install mcp-feedback-enhanced

# 如果失败，尝试清理缓存后安装
npm cache clean --force
npm install mcp-feedback-enhanced

# 如果还是失败，使用国内镜像（详见上方npm镜像源切换教程）
npm config set registry https://registry.npmmirror.com
npm install mcp-feedback-enhanced

1.4 验证安装成功

# 检查安装结果
npm list mcp-feedback-enhanced

# 查看文件是否存在
dir node_modules\mcp-feedback-enhanced

✅ 安装成功标志：

• 📂 C:\MCP-Tools\node_modules\mcp-feedback-enhanced 文件夹存在
• ✅ npm list 命令显示版本号

📄 第二步：配置 JSON 文件

2.1 找到配置文件位置
你的 mcp-config.json 文件应该在：

• 完整路径：C:\MCP-Tools\mcp-config.json
• 如何打开：右键文件 → 打开方式 → 记事本

2.2 添加 mcp-feedback-enhanced 配置

在你的 mcp-config.json 文件中，找到 "mcpServers" 部分，添加以下配置：

{
  "mcpServers": {
    "filesystem": {
      "command": "node",
      "args": [
        "C:\\MCP-Tools\\node_modules\\@modelcontextprotocol\\server-filesystem\\dist\\index.js",
        "C:\\your-backend-projects"
      ],
      "env": {}
    },
    "memory": {
      "command": "node",
      "args": [
        "C:\\MCP-Tools\\node_modules\\@modelcontextprotocol\\server-memory\\dist\\index.js"
      ],
      "env": {}
    },
    "github": {
      "command": "node",
      "args": [
        "C:\\MCP-Tools\\node_modules\\@modelcontextprotocol\\server-github\\dist\\index.js"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_token_here"
      }
    },
    "everything": {
      "command": "node",
      "args": [
        "C:\\MCP-Tools\\node_modules\\@modelcontextprotocol\\server-everything\\dist\\index.js"
      ],
      "env": {}
    },
    "mcp-feedback-enhanced": {
      "command": "node",
      "args": [
        "C:\\MCP-Tools\\node_modules\\mcp-feedback-enhanced\\dist\\index.js"
      ],
      "env": {
        "FEEDBACK_TIMEOUT": "3600"
      }
    }
  }
}

🔍 后端专用配置详解：

• "mcp-feedback-enhanced" - 工具名称（可以自定义）
• "FEEDBACK_TIMEOUT": "3600" - 1 小时超时，适合复杂架构讨论
• 路径指向后端项目目录，如："C:\\your-backend-projects"

2.3 保存配置文件

1. 按 Ctrl + S 保存文件
2. 关闭记事本

🚨 后端开发特殊注意事项：

Java 项目环境检查：

# 检查Java环境
java --version
# 确保JDK版本在11+

Python 项目环境检查：

# 检查Python环境
python --version
# 确保Python版本在3.8+

Node.js 项目环境检查：

# 检查Node.js环境
node --version
# 确保Node.js版本在16+

2.5 在 Augment 中导入配置

1. 打开 Augment
2. 点击"Import from JSON"
3. 选择你的mcp-config.json文件
4. 确认导入成功

⚙️ 第三步：后端开发使用

3.1 自动激活

当你处理以下文件类型时，后端规则自动生效：

.py .js .ts .java .go .rs .php .rb .cs .sql

3.2 后端模式使用

架构设计模式：

触发：说"设计系统架构"
AI响应：[模式：架构设计] [角色：后端架构师]
功能：系统设计、技术选型、性能规划

API 开发模式：

触发：说"实现API接口"
AI响应：[模式：API开发] [角色：后端开发工程师]
功能：RESTful API、GraphQL、业务逻辑

数据建模模式：

触发：说"设计数据库"
AI响应：[模式：数据建模] [角色：数据库工程师]
功能：数据库设计、查询优化、数据迁移

3.3 Java 开发支持

后端规则 v2.1 完全支持 Java 开发：

Java 技术栈支持：

• ✅ Spring Boot - 企业级 Java 框架
• ✅ 数据访问层：
  • Spring Data JPA（关系型数据库）
  • Spring Data MongoDB（NoSQL 数据库）
  • MyBatis（自定义 SQL）
• ✅ 安全方案（可选）：
  • Spring Security（企业级安全）
  • JWT Token（轻量级认证）
  • 自定义认证（简单项目）
  • 无认证（内部系统/原型）
• ✅ Maven/Gradle - 依赖管理
• ✅ JUnit - 单元测试框架

Java 开发规范：

• 🎯 分层架构 - Controller-Service-Repository-Entity
• 📝 代码规范 - Google Java Style
• 🔧 依赖注入 - Spring 注解和配置
• 🧪 测试驱动 - 单元测试和集成测试

3.4 手动切换模式

使用以下命令手动切换：

• /架构设计 - 架构设计模式
• /api开发 - API 开发模式
• /数据建模 - 数据建模模式
• /安全开发 - 安全开发模式
• /运维部署 - 运维部署模式

3.5 MCP 工具自动调用

后端开发时，AI 会自动：

• 📁 文件操作 - 使用 filesystem 工具管理项目文件
• 🧠 记忆管理 - 记住你的后端技术栈偏好
• 🔗 版本控制 - 自动提交代码到 GitHub
• 🌐 网络测试 - 测试 API 接口和服务连通性

🤖 第四步：智能反馈机制详解

4.1 mcp-feedback-enhanced 工具介绍

mcp-feedback-enhanced 是 Rules 2.1 的核心智能反馈工具，专为后端开发优化：

• 🕐 1 小时超时 - 充足时间思考架构和技术方案
• 📝 富文本反馈 - 支持代码片段、架构图、配置文件等
• 🔄 实时交互 - AI 与用户的双向实时沟通
• 📊 工作摘要 - 自动生成 API 开发、数据库设计等进度摘要

4.2 什么时候会触发反馈？

AI 会在以下情况主动请求反馈：

• ❓ 需求不明确 - 你的描述模糊时
• 🎯 重大决策 - 架构选择、技术栈选型时
• ✅ 方案完成 - 技术方案设计完成需要确认时
• 🎉 执行完成 - 代码实现完成需要验收时
• 🔒 安全确认 - 涉及数据库操作、权限配置时

4.3 后端专用反馈场景

架构设计确认：

"请确认系统架构方案：
1. 微服务架构 vs 单体架构
2. 数据库选择：MySQL vs PostgreSQL
3. 缓存方案：Redis vs Memcached
4. 消息队列：RabbitMQ vs Kafka
请选择并说明原因"

API 设计确认：

"API接口设计完成，请确认：
- RESTful风格是否符合要求
- 响应格式是否统一
- 错误处理机制是否完善
- 认证授权方案是否合适"

数据库设计确认：

"数据库表结构设计完成：
- 表关系是否合理
- 索引设计是否优化
- 数据类型选择是否恰当
- 是否需要分库分表"

4.4 反馈技巧和最佳实践

后端开发反馈要点：

1. 🏗️ 架构层面 - 说明系统规模、并发要求、扩展性需求
2. 🔒 安全层面 - 明确安全等级、合规要求、权限控制
3. ⚡ 性能层面 - 说明性能指标、响应时间要求、吞吐量
4. 💾 数据层面 - 明确数据量级、一致性要求、备份策略

常见后端反馈示例：

Java Spring Boot 项目：

"技术栈确认：
- 使用Spring Boot 2.7 + JDK 11
- 数据库：MySQL 8.0 + MyBatis
- 缓存：Redis 6.0
- 安全：Spring Security + JWT
- 部署：Docker + Kubernetes
请按此方案继续开发"

Python FastAPI 项目：

"API设计很好，但需要调整：
1. 响应格式统一为 {code, message, data}
2. 添加请求限流（每分钟100次）
3. 数据库连接池设置为20个连接
4. 添加API文档自动生成
优先级：1和2必须实现"

4.5 超时和异常处理

后端开发特殊考虑：

• 🏗️ 架构设计 - 通常需要更多思考时间，建议延长到 90 分钟
• 🔒 安全审查 - 涉及安全配置时，建议仔细评估后再确认
• 📊 性能测试 - 可以要求 AI 提供性能测试方案和基准数据

📦 第五步：版本控制规范

5.1 提交格式

使用标准化的提交格式：

# 后端提交示例
feat(api): ✨ 添加用户认证API接口
fix(db): 🐛 修复数据库连接池问题
perf(query): ⚡ 优化用户查询性能
security(auth): 🔒 加强认证安全机制

5.2 分支管理

推荐使用 Git Flow 工作流：

main (生产环境)
├── develop (开发环境)
│   ├── feature/user-auth-api (功能分支)
│   └── hotfix/security-patch (热修复分支)
└── release/v2.1.0 (发布分支)

⚙️ 第六步：配置选项

6.1 反馈频率控制

根据你的经验水平选择：

• 🔍 设置详细模式 - 新手推荐，完整反馈
• ⚖️ 设置标准模式 - 默认模式，关键决策反馈
• 🚀 设置静默模式 - 专家模式，仅错误时反馈

6.2 后端专用配置

• 设置微服务模式 - 优先使用微服务架构
• 设置单体应用模式 - 优先使用单体架构
• 设置安全严格模式 - 启用最严格的安全检查
• 设置性能优化模式 - 自动应用性能优化建议

🐛 第七步：常见问题解决

7.1 MCP 工具无法连接

问题：AI 提示 MCP 工具连接失败

解决方案：

1. 检查 MCP 工具是否正确安装
2. 确认 Augment 中的 MCP 配置正确
3. 重启 Augment 应用
4. 检查路径是否正确

7.2 GitHub Token 无效

问题：GitHub 操作失败

解决方案：

1. 检查 Token 是否正确配置
2. 确认 Token 权限是否足够
3. 检查 Token 是否过期
4. 重新生成 Token

7.3 规则不生效

问题：AI 没有按照规则工作

解决方案：

1. 确认文件类型是否匹配规则（.py .java .js 等）
2. 检查规则文件是否正确放置在.augment/rules/目录
3. 重启 Augment 重新加载规则
4. 手动切换到对应模式

🚀 第八步：性能优化和自动化

8.1 后端性能优化

JVM 优化（Java 项目）：

# 设置JVM参数
export JAVA_OPTS="-Xms2g -Xmx4g -XX:+UseG1GC"

Python 性能优化：

# 使用uvloop提升异步性能
pip install uvloop

# 设置Python优化
export PYTHONOPTIMIZE=1

数据库连接池优化：

# application.yml (Spring Boot)
spring:
  datasource:
    hikari:
      maximum-pool-size: 20
      minimum-idle: 5
      connection-timeout: 30000

8.2 后端一键配置脚本

Windows PowerShell 脚本：

创建setup-backend-rules.ps1：

# Backend Rules 2.1 一键配置脚本
Write-Host "⚙️ Backend Rules 2.1 自动配置开始..." -ForegroundColor Green

# 检查环境
$envOk = $true

# 检查Node.js
if (!(Get-Command node -ErrorAction SilentlyContinue)) {
    Write-Host "❌ 请先安装Node.js: https://nodejs.org" -ForegroundColor Red
    $envOk = $false
}

# 检查Java（可选）
if (Get-Command java -ErrorAction SilentlyContinue) {
    Write-Host "✅ Java环境已安装" -ForegroundColor Green
} else {
    Write-Host "⚠️ Java未安装，如需Java开发请安装: https://adoptium.net" -ForegroundColor Yellow
}

# 检查Python（可选）
if (Get-Command python -ErrorAction SilentlyContinue) {
    Write-Host "✅ Python环境已安装" -ForegroundColor Green
} else {
    Write-Host "⚠️ Python未安装，如需Python开发请安装: https://python.org" -ForegroundColor Yellow
}

if (!$envOk) { exit 1 }

# 创建MCP工具目录
$mcpDir = "C:\MCP-Tools"
if (!(Test-Path $mcpDir)) {
    New-Item -ItemType Directory -Path $mcpDir
    Write-Host "✅ 创建MCP工具目录: $mcpDir" -ForegroundColor Green
}

# 安装MCP工具
Set-Location $mcpDir
npm init -y
npm install @modelcontextprotocol/server-filesystem
npm install @modelcontextprotocol/server-memory
npm install @modelcontextprotocol/server-github
npm install @modelcontextprotocol/server-everything
npm install @modelcontextprotocol/sdk

Write-Host "✅ MCP工具安装完成!" -ForegroundColor Green
Write-Host "📝 请手动配置GitHub Token和项目路径" -ForegroundColor Yellow

⚠️ 脚本运行后必须修改的内容：

脚本会生成 mcp-config.json 配置文件，但你必须手动修改以下内容：

🔧 必须修改的 3 个地方：

1. 后端项目路径（必改）

// 脚本生成的默认配置：
"C:\\your-projects"

// 你需要改为你的实际后端项目路径：
"D:\\java-projects\\spring-boot-app"    // 示例1：Java项目
"E:\\python\\fastapi-backend"           // 示例2：Python项目
"C:\\workspace\\nodejs-api"             // 示例3：Node.js项目
"F:\\microservices\\user-service"       // 示例4：微服务项目

2. GitHub Token（必改）

// 脚本生成的默认配置：
"GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_token_here"

// 你需要改为你的实际Token：
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx"

3. MCP 工具路径（检查是否正确）

// 脚本生成的路径：
"C:\\MCP-Tools\\node_modules\\..."

// 如果你的MCP工具安装在其他位置，需要修改为实际路径：
"D:\\MyMCP\\node_modules\\..."  // 示例：安装在D盘

📝 如何修改配置文件：

步骤 1：打开配置文件

1. 按 Win + E 打开文件资源管理器
2. 在地址栏输入：C:\MCP-Tools
3. 找到 mcp-config.json 文件
4. 右键文件 → 打开方式 → 记事本

步骤 2：修改后端项目路径

1. 找到 "C:\\your-projects" 这一行
2. 替换为你的实际后端项目路径
3. 注意使用双反斜杠："D:\\java-projects\\my-app"

步骤 3：修改 GitHub Token

1. 找到 "your_github_token_here" 这一行
2. 替换为你的实际 GitHub Token
3. 保持双引号："ghp_xxxxxxxxxxxxxxxxxxxx"

步骤 4：保存文件

1. 按 Ctrl + S 保存
2. 关闭记事本

🎯 后端项目路径配置建议：

Java 项目示例：

"D:\\java\\spring-boot-demo"
"E:\\workspace\\microservice-user"
"C:\\projects\\ecommerce-backend"

Python 项目示例：

"D:\\python\\fastapi-blog"
"E:\\backend\\django-api"
"C:\\projects\\ml-service"

Node.js 项目示例：

"D:\\nodejs\\express-server"
"E:\\backend\\koa-api"
"C:\\projects\\realtime-chat"

✅ 修改完成检查清单：

• 后端项目路径已改为实际路径
• GitHub Token 已替换为真实 Token
• 路径格式正确（双反斜杠）
• JSON 格式正确（逗号、括号）
• 文件已保存
• 项目路径指向正确的后端代码目录

新手友好使用教程：

📋 准备工作：

1. 确保已安装 Node.js（访问 https://nodejs.org 下载）
2. 如需 Java 开发，安装 JDK 11+（访问 https://adoptium.net 下载）
3. 如需 Python 开发，安装 Python 3.8+（访问 https://python.org 下载）

🖱️ 图形化操作步骤：

步骤 1：创建脚本文件

1. 在桌面右键 → 新建 → 文本文档
2. 将文件名改为 setup-backend-rules.ps1
3. 复制上面的 PowerShell 脚本内容到文件中
4. 保存文件

步骤 2：运行脚本

1. 按 Win + X 键，选择"Windows PowerShell (管理员)"

2. 在弹出的蓝色窗口中输入：

   cd Desktop  # 进入桌面目录
   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser  # 允许运行脚本
   .\setup-backend-rules.ps1  # 运行脚本
   

3. 按回车键执行

步骤 3：查看结果

• ✅ 看到绿色的"✅ MCP 工具安装完成!"表示成功
• ✅ 看到绿色的"✅ Java 环境已安装"（如果已安装 Java）
• ✅ 看到绿色的"✅ Python 环境已安装"（如果已安装 Python）
• 📁 在 C 盘会创建MCP-Tools文件夹
  • 完整路径：C:\MCP-Tools
  • 如何打开：按Win + E打开文件资源管理器，在地址栏输入C:\MCP-Tools
  • 里面有什么：node_modules 文件夹（包含所有 MCP 工具）
• 📄 会生成mcp-config.json配置文件
  • 完整路径：C:\MCP-Tools\mcp-config.json
  • 如何查看：用记事本或 VSCode 打开这个文件
  • 如何编辑：右键文件 → 打开方式 → 记事本

🔧 手动配置方法（推荐新手使用）：

方法 1：分步安装

# 1. 创建目录
mkdir C:\MCP-Tools
cd C:\MCP-Tools

# 2. 初始化项目
npm init -y

# 3. 逐个安装工具（复制粘贴执行）
npm install @modelcontextprotocol/server-filesystem
npm install @modelcontextprotocol/server-memory
npm install @modelcontextprotocol/server-github
npm install @modelcontextprotocol/server-everything
npm install mcp-feedback-enhanced

方法 2：一键安装

# 在C:\MCP-Tools目录下执行
npm install @modelcontextprotocol/server-filesystem @modelcontextprotocol/server-memory @modelcontextprotocol/server-github @modelcontextprotocol/server-everything mcp-feedback-enhanced

🎯 第九步：最佳实践

8.1 项目开始时

1. 明确技术栈 - Java/Python/Node.js 等
2. 选择架构模式 - 微服务还是单体应用
3. 配置工作环境 - 确保 MCP 工具正常
4. 设置安全标准 - 根据项目要求选择安全方案

8.2 开发过程中

1. 及时反馈 - 遇到反馈界面时及时回复
2. 使用模式切换 - 根据当前任务切换合适模式
3. 利用记忆功能 - 让 AI 记住你的偏好和决策
4. 规范提交 - 使用标准化的 Git 提交格式

📚 附录：快速参考

后端模式切换命令

/架构设计 /api开发 /数据建模 /安全开发 /运维部署

通用模式切换命令

/理解 /方案 /执行 /验证 /纠错 /辅助

配置命令

设置详细模式 设置标准模式 设置静默模式
设置微服务模式 设置单体应用模式
设置安全严格模式 设置性能优化模式

---

🎉 恭喜！你已经掌握了后端开发 AI 助手规则 v2.1 的完整使用方法！

现在开始享受高效的后端开发体验吧！

---

📋 版本信息

• 版本：Backend Rules v2.1
• 发布日期：2025 年 1 月 31 日
• 作者：落_夜
• 邮箱：355395248@qq.com
• 博客：落_夜
• 更新日志：
  • v2.1：添加环境要求检查、Java/Python 性能优化、详细故障排除、一键配置脚本
  • v2.0：前后端规则分离、MCP 工具集成、智能反馈机制、Java 开发支持
  • v1.0：基础 AI 助手规则框架