GrACE-MCP

# GrACE-MCP 使用场景示例 本文档提供了 GrACE-MCP 在实际工作场景中的详细使用示例，帮助您更好地利用知识图谱功能。 --- ## 📋 目录 1. [个人信息和偏好](#1-个人信息和偏好) 2. [项目信息管理](#2-项目信息管理) 3. [学习和工作习惯](#3-学习和工作习惯) 4. [查询和检索信息](#4-查询和检索信息) 5. [项目需求管理](#5-项目需求管理) 6. [解决方案和最佳实践](#6-解决方案和最佳实践) 7. [关联信息查询](#7-关联信息查询) 8. [个性化建议](#8-个性化建议) 9. [学习进度跟踪](#9-学习进度跟踪) 10. [代码审查标准](#10-代码审查标准) 11. [项目部署清单](#11-项目部署清单) 12. [验证记忆效果](#12-验证记忆效果) 13. [Saga (长对话记忆)](#13-saga-长对话记忆) --- ## 1. 个人信息和偏好 ### 记录技术偏好 ``` 你：请记住我的技术偏好： - 编程语言：TypeScript 和 Python - 前端框架：React 和 Next.js - 后端框架：FastAPI 和 Express - 数据库偏好：PostgreSQL 和 MongoDB - 样式框架：喜欢使用 Tailwind CSS - 代码风格：偏好函数式编程，使用 ESLint 和 Prettier AI：[自动调用 add_episode 工具] ✅ Episode 已添加到知识图谱 ``` ### 记录开发工具偏好 ``` 你：请记住我使用的开发工具： - 客户端：VS Code, Cursor, Claude Desktop 等 MCP Client - 版本控制：Git，使用 GitHub - 包管理器：npm 和 pip - 测试框架：Jest 和 pytest - 部署平台：Vercel 和 AWS AI：[自动调用 add_episode 工具] ✅ Episode 已添加到知识图谱 ``` --- ## 2. 项目信息管理 ### 记录项目基本信息 ``` 你：请记录我当前的项目： 项目名称：电商管理系统 技术栈：Next.js + TypeScript + Prisma + PostgreSQL 部署平台：Vercel 主要功能：商品管理、订单处理、用户认证 开始时间：2025年1月 AI：[自动调用 add_episode 工具] ✅ Episode 已添加到知识图谱 ``` ### 设置项目隔离 ``` 你：请为我的"电商管理系统"项目设置独立的组 ID AI：[自动调用 set_group_id 工具] ✅ 组 ID 已设置为: 电商管理系统 ``` ### 查询项目信息 ``` 你：我之前记录了什么项目信息？ AI：[自动调用 search_entities 工具，entity_type="Project"] ✅ 找到相关项目信息... ``` --- ## 3. 学习和工作习惯 ### 记录工作习惯 ``` 你：请记住我的工作习惯： - 使用 VS Code 插件：Auto Rename Tag、ES7+ React Snippets、Prettier - 代码提交习惯：遵循 Conventional Commits 规范 - 测试偏好：Jest + React Testing Library，覆盖率要求 80%+ - 部署流程：GitHub Actions + Vercel 自动部署 - 代码审查：每次 PR 至少需要一人审查 AI：[自动调用 add_episode 工具] ✅ Episode 已添加到知识图谱 ``` ### 记录学习计划 ``` 你：请记录我的学习计划： 本月目标：深入学习 TypeScript 高级类型 已完成：泛型、条件类型、映射类型 进行中：模板字面量类型 下一步：学习 TypeScript 装饰器和元编程 AI：[自动调用 add_episode 工具] ✅ Episode 已添加到知识图谱 ``` --- ## 4. 查询和检索信息 ### 询问技术偏好 ``` 你：我之前提到过使用什么数据库吗？ AI：[自动调用 search_entities 工具] ✅ 找到相关实体： - PostgreSQL - MongoDB ``` ### 查询项目技术栈 ``` 你：提醒我一下我当前项目的技术栈是什么？ AI：[自动调用 search_entities 工具，entity_type="Project"] ✅ 找到项目信息： - 技术栈：Next.js + TypeScript + Prisma + PostgreSQL ``` ### 查询代码风格偏好 ``` 你：我的代码风格偏好是什么？ AI：[自动调用 search_entities 工具] ✅ 找到相关信息： - 偏好函数式编程 - 使用 ESLint 和 Prettier - 遵循 Conventional Commits 规范 ``` ### 时间范围查询 ``` 你：最近一周我记录了什么？ AI：[自动调用 query_by_time_range 工具，days=7] ✅ 找到最近一周的记录... ``` --- ## 5. 项目需求管理 ### 记录项目需求 ``` 你：对于电商项目，请记住这些需求： - 需要实现购物车功能，支持商品规格选择 - 支付集成：Stripe 和支付宝 - 管理后台需要数据分析图表 - 移动端适配是必需的 - 需要支持多语言（中文、英文） AI：[自动调用 add_episode 工具] ✅ Episode 已添加到知识图谱 ``` ### 批量记录需求 ``` 你：请批量记录这些需求： 1. 用户注册需要邮箱验证 2. 密码必须包含大小写字母和数字 3. 订单状态需要实时更新 4. 商品搜索支持模糊匹配 5. 需要实现商品推荐算法 AI：[自动调用 add_episodes_bulk 工具] ✅ 批量添加完成：5 个 Episode 已添加 ``` ### 查询项目需求 ``` 你：电商项目有哪些需求？ AI：[自动调用 search_entities 工具，entity_type="Requirement"] ✅ 找到相关需求... ``` --- ## 6. 解决方案和最佳实践 ### 记录解决方案 ``` 你：请记住这个解决方案： 问题：Next.js 中图片优化 解决方案：使用 next/image 组件，配置 domains 白名单，设置适当的 sizes 属性 最佳实践：为不同屏幕尺寸提供不同图片规格，使用 WebP 格式 AI：[自动调用 add_episode 工具] ✅ Episode 已添加到知识图谱 ``` ### 记录最佳实践 ``` 你：请记住这个最佳实践： 主题：React 性能优化 最佳实践： 1. 使用 React.memo 避免不必要的重渲染 2. 使用 useMemo 和 useCallback 优化计算和函数 3. 代码分割使用 React.lazy 和 Suspense 4. 虚拟滚动处理长列表 5. 避免在 render 中创建新对象 AI：[自动调用 add_episode 工具] ✅ Episode 已添加到知识图谱 ``` ### 查询最佳实践 ``` 你：我之前记录过 React 性能优化的最佳实践吗？ AI：[自动调用 search_entities 工具] ✅ 找到相关最佳实践... ``` --- ## 7. 关联信息查询 ### 基于偏好的推荐 ``` 你：基于我之前提到的技术偏好，为我的电商项目推荐一个状态管理方案 AI：[自动调用 search_entities 工具查找偏好] [自动调用 search_relationships 工具查找关联] [基于偏好推荐] ✅ 根据您的偏好（TypeScript、函数式编程），推荐使用： - Zustand（轻量级，TypeScript 友好） - Jotai（原子化状态管理，函数式风格） ``` ### 查询相关实体 ``` 你：TypeScript 和哪些技术有关联？ AI：[自动调用 search_relationships 工具] ✅ 找到相关关系： - TypeScript → React（用于前端开发） - TypeScript → Next.js（框架支持） - TypeScript → FastAPI（后端开发） ``` --- ## 8. 个性化建议 ### 基于习惯的文件夹结构建议 ``` 你：根据我的编程习惯和项目需求，帮我设计一个合适的文件夹结构 AI：[自动调用 search_entities 工具查找习惯和项目信息] [基于信息生成建议] ✅ 根据您的习惯（函数式编程、TypeScript、Next.js），建议： src/ ├── components/ # 可复用组件 ├── hooks/ # 自定义 Hooks ├── utils/ # 工具函数 ├── types/ # TypeScript 类型定义 ├── lib/ # 第三方库封装 └── pages/ # Next.js 页面 ``` ### 技术栈选择建议 ``` 你：我应该使用什么技术栈来开发新项目？ AI：[自动调用 search_entities 工具查找偏好] ✅ 根据您的偏好，推荐： - 前端：Next.js + TypeScript + React + Tailwind CSS - 后端：FastAPI + Python - 数据库：PostgreSQL - 部署：Vercel（前端）+ AWS（后端） ``` --- ## 9. 学习进度跟踪 ### 记录学习进度 ``` 你：请更新我的学习进度： - TypeScript 高级类型：已完成 80% - 泛型：✅ 已完成 - 条件类型：✅ 已完成 - 映射类型：✅ 已完成 - 模板字面量类型：🔄 进行中（50%） - 装饰器：⏳ 待开始 AI：[自动调用 add_episode 工具] ✅ Episode 已添加到知识图谱 ``` ### 查询学习进度 ``` 你：我的 TypeScript 学习进度如何？ AI：[自动调用 search_entities 工具] ✅ 找到学习进度： - 总体进度：80% - 已完成：泛型、条件类型、映射类型 - 进行中：模板字面量类型（50%） - 待开始：装饰器 ``` --- ## 10. 代码审查标准 ### 记录代码审查清单 ``` 你：请记住我的代码审查清单： 1. 是否有类型安全问题（TypeScript） 2. 组件是否可复用 3. 性能优化：useMemo、useCallback 的合理使用 4. 错误处理是否完善 5. 测试覆盖率是否达标（80%+） 6. 代码风格是否符合规范（ESLint、Prettier） 7. 是否有安全漏洞（XSS、CSRF 等） 8. 文档是否完整 AI：[自动调用 add_episode 工具] ✅ Episode 已添加到知识图谱 ``` ### 查询审查标准 ``` 你：我的代码审查标准是什么？ AI：[自动调用 search_entities 工具] ✅ 找到代码审查清单... ``` --- ## 11. 项目部署清单 ### 记录部署前检查清单 ``` 你：记录我的部署前检查清单： - 环境变量配置检查 - 数据库迁移脚本运行 - 静态资源 CDN 配置 - SSL 证书有效性 - 监控和日志配置 - 备份策略确认 - 性能测试通过 - 安全扫描完成 AI：[自动调用 add_episode 工具] ✅ Episode 已添加到知识图谱 ``` ### 查询部署清单 ``` 你：部署前需要检查什么？ AI：[自动调用 search_entities 工具] ✅ 找到部署检查清单... ``` --- ## 12. 验证记忆效果 ### 几天后测试记忆 ``` 你：我应该使用什么技术栈来开发新项目？ AI：[自动调用 search_entities 工具] ✅ 根据您之前的记录，推荐： - 前端：Next.js + TypeScript + React + Tailwind CSS - 后端：FastAPI + Python - 数据库：PostgreSQL ``` ### 查询偏好 ``` 你：提醒我一下我的代码风格偏好 AI：[自动调用 search_entities 工具] ✅ 您的代码风格偏好： - 函数式编程 - 使用 ESLint 和 Prettier - 遵循 Conventional Commits 规范 --- ## 13. Saga (长对话记忆) Saga 功能允许将多个独立的 Episode 关联到一个连续的会话或事务中。 ### 开启一个新的 Saga ``` 你：开启一个新的对话 saga，名称为"架构讨论"，内容是：我们要重构后端服务 AI：[自动调用 add_episode 工具，参数 saga="架构讨论"] ✅ Episode 已添加，Saga "架构讨论" 已创建 ``` ### 延续 Saga 系统会自动追踪 `saga` 和 `saga_previous_episode_uuid`，保持对话连贯性。 ``` 你：主要目标是提高并发处理能力 AI：[自动调用 add_episode 工具，参数 saga="架构讨论", saga_previous_episode_uuid="..."] ✅ Episode 已添加并关联到 "架构讨论" ``` ### 关联到 Saga ``` 你：还有一点，必须保持向后兼容。请把这也加到刚才的架构讨论里。 AI：[自动调用 add_episode 工具，参数 saga="架构讨论"] ✅ Episode 已添加 ``` ``` --- ## 💡 最佳实践建议 ### 1. 结构化记录 - 使用清晰的格式记录信息 - 分类存储（技术栈、项目、习惯等） - 使用元数据标记类型 ### 2. 定期更新 - 当偏好或技术栈发生变化时及时更新 - 定期回顾和清理过时信息 - 保持信息的时效性 ### 3. 具体化描述 - 记录具体的解决方案而不是抽象概念 - 包含上下文信息（项目名称、时间等） - 提供足够的细节以便后续检索 ### 4. 利用关联 - 通过关系查询发现信息之间的关联 - 利用语义搜索找到相关内容 - 使用时间范围查询追踪历史 ### 5. 数据隔离 - 为不同项目设置独立的组 ID - 避免不同项目之间的信息混淆 - 便于项目级别的数据管理 --- ## 🔍 高级用法 ### 语义搜索 ``` 你：帮我找一下关于性能优化的内容 AI：[自动调用 semantic_search 工具] ✅ 找到相关内容： - React 性能优化最佳实践 - Next.js 图片优化方案 - 数据库查询优化技巧 ``` ### Cypher 查询 ``` 你：查询所有与 TypeScript 相关的项目 AI：[自动调用 query_knowledge_graph 工具] ✅ 执行 Cypher 查询： MATCH (p:Project)-[:USES]->(t:Technology {name: 'TypeScript'}) RETURN p ``` ### 统计信息 ``` 你：我的知识图谱中有多少条记录？ AI：[自动调用 get_statistics 工具] ✅ 统计信息： - 节点总数：156 - 关系总数：89 - Episode 总数：45 ``` --- ## 📚 相关文档 - [使用指南](USAGE.md) - 完整的功能使用说明 - [快速开始](QUICKSTART.md) - 安装和配置步骤 - [API Key 说明](USAGE.md#1-基础配置类) - API key 配置说明 --- **提示**：所有示例中的 AI 响应都是自动的，您只需要在对话中自然地表达需求，AI 会自动调用相应的工具完成操作。