Skip to content

DEMO.md

Latest commit

 

History

History
391 lines (298 loc) · 10.1 KB

DEMO.md

File metadata and controls

391 lines (298 loc) · 10.1 KB
Raw

🎬 使用演示 / Demo

本文档展示 Lanhu MCP Server 的实际使用场景和效果。

场景一：需求文档分析（开发视角）

用户输入

帮我看看这个登录模块的需求：
https://lanhuapp.com/web/#/item/project/product?tid=xxx&pid=xxx&docId=xxx

AI 自动执行流程

STAGE 1: 全局扫描

老板，二狗收到！正在快速浏览所有页面...

📊 文档结构分析：
| 模块名 | 包含页面 | 核心功能 | 业务流程 |
|--------|---------|---------|---------|
| 用户认证 | 登录、注册、找回密码 | 用户认证 | 登录→首页 |
| 个人中心 | 个人信息、修改密码 | 用户管理 | 查看/编辑资料 |
| 订单管理 | 订单列表、订单详情 | 订单处理 | 查询/取消订单 |

请问您希望二狗以什么角度来分析？

1️⃣ 【开发视角】- 详细技术文档 ⭐推荐
   适合：开发人员看需求，准备写代码
   输出：详细字段规则、业务流程图、异常处理

2️⃣ 【测试视角】- 测试用例和验证点
   适合：测试人员写测试用例

3️⃣ 【快速探索】- 全局评审视角
   适合：需求评审会议、快速了解需求

用户选择

选开发视角，帮我分析"用户认证"模块

STAGE 2: 详细分析

老板，开始分析"用户认证"模块...

🔍 变更类型识别：
- 类型：🔄修改
- 判断依据：文档中提到"优化登录流程"、"新增记住密码功能"
- 结论：在现有登录基础上新增功能

📋 本组核心 3 点：
1. 登录验证：手机号+密码 或 手机号+验证码两种方式
2. 记住密码：新增功能，30天免登录
3. 错误控制：3次失败锁定30分钟

📊 功能清单表：
| 功能点 | 描述 | 输入 | 输出 | 业务规则 | 异常处理 |
|--------|------|------|------|----------|----------|
| 密码登录 | 手机号密码登录 | 手机号/密码/记住我 | 用户token/用户信息 | 验证格式、校验密码 | 3次锁定 |
| 验证码登录 | 手机号验证码登录 | 手机号/验证码 | 用户token/用户信息 | 60秒防重发 | 验证码5分钟过期 |
| 记住密码 | 30天免登录 | 勾选记住我 | 长效token | 设备绑定 | token过期重新登录 |

📋 字段规则表：
| 字段名 | 必填 | 类型 | 长度/格式 | 校验规则 | 错误提示 |
|--------|------|------|-----------|----------|----------|
| phone | ✅ | string | 11位 | 1开头手机号 | "请输入正确的手机号" |
| password | ✅ | string | 6-20位 | 字母+数字 | "密码必须包含字母和数字" |
| code | ✅ | string | 4位 | 纯数字 | "请输入4位验证码" |
| remember | ❌ | boolean | - | true/false | - |

⚠️ 待确认事项：
• ⚠️ 记住密码的token有效期文档说30天，但技术实现建议7天，请产品确认
• ⚠️ 锁定30分钟是否支持手动解锁（如客服介入）？

分析完成！继续分析其他模块吗？

STAGE 3 & 4: 生成交付文档

老板，所有模块分析完毕！现在生成完整需求文档...

# 需求文档总结

## 📊 文档概览
- 总页面数：8页
- 模块数：3个
- 变更类型：🔄修改 2个，🆕新增 1个
- 待确认项：3个

## 🎯 需求性质分析
| 类型 | 模块数 | 模块列表 | 判断依据 |
|------|-------|---------|---------|
| 🔄 修改 | 2 | 用户认证、个人中心 | 文档提到"优化"、"在现有基础上" |
| 🆕 新增 | 1 | 订单管理 | 文档提到"全新功能" |

## 🌍 全局业务流程图

开始 ↓ [用户打开APP] ↓ 是否已登录？ ├─是→ [进入首页] └─否→ [显示登录页面] ↓ 选择登录方式 ├─密码登录 │ ↓ │ 输入手机号+密码 │ ↓ │ 是否勾选记住我？ │ ├─是→ 生成30天token │ └─否→ 生成24小时token │ ↓ │ 密码正确？ │ ├─是→ [登录成功] → [进入首页] │ └─否→ 错误次数+1 │ ↓ │ 错误次数≥3？ │ ├─是→ [锁定30分钟] │ └─否→ [提示重新输入] │ └─验证码登录 ↓ [发送验证码] ↓ 输入验证码 ↓ 验证码正确？ ├─是→ [登录成功] → [进入首页] └─否→ [提示验证码错误]


（详细的字段规则、模块说明省略...）

## ⚠️ 待确认事项
1. 记住密码token有效期：文档30天 vs 技术建议7天
2. 账号锁定后是否支持客服手动解锁
3. 订单列表的分页大小：文档未说明

老板，需求文档已整理完毕！开发看完能写代码！

场景二：团队协作留言板

后端开发发布知识库

帮我发个留言，分享一下刚解决的 Redis 问题

标题：Redis连接池配置优化
内容：生产环境遇到 Redis 超时，排查后发现是连接池配置不当。
解决方案：
- maxTotal 调整为 20
- maxIdle 调整为 10
- testOnBorrow 设置为 true
效果：超时率从 5% 降至 0.1%

留言类型：知识库

AI 执行：

老板，已发布知识库！以后团队其他人遇到类似问题，AI 可以直接搜到这个解决方案！

测试人员查询知识

搜索所有关于"Redis"的知识库

AI 返回：

找到 2 条知识库：

1️⃣ Redis连接池配置优化（小王-后端，2025-01-15）
   生产环境遇到 Redis 超时，排查后发现是...

2️⃣ Redis缓存穿透解决方案（小张-后端，2025-01-10）
   使用布隆过滤器解决缓存穿透...

老板，找到这些经验，要查看详情吗？

产品经理发起查询任务

帮我发个留言，@后端小王

标题：请帮忙查询测试环境数据
内容：请帮我查一下 user 表中 status='test' 的用户有多少条？
留言类型：任务
@小王

AI 执行：

老板，留言已发布！

✅ 已发送飞书通知给 @小王
📋 消息类型：任务（安全限制：只能查询，不能修改）

小王的 AI 会收到通知，帮他执行查询~

场景三：UI 设计稿查看

用户输入

帮我看看首页的设计稿：
https://lanhuapp.com/web/#/item/project/stage?tid=xxx&pid=xxx

AI 执行

老板，这个项目有 12 张设计图，设计师很用心！

您是要：
1. 全部下载（完整了解UI）
2. 先看关键页面（告诉我哪几张~）

等您指示！

用户选择

先看首页、登录页、个人中心这三张

AI 返回

老板，设计稿已下载！

📊 共 3 张设计图：
1. 首页设计 (1920x1080)
2. 登录页 (750x1334)
3. 个人中心 (750x1334)

[图片1：首页设计]
[图片2：登录页]
[图片3：个人中心]

这些设计很不错！需要我分析设计规范或导出切图吗？

场景四：切图智能下载

用户输入

帮我下载"首页设计"的所有切图

AI 执行流程

1. 环境检测

正在检测项目类型...
✅ 检测到 package.json，这是一个 React 项目
✅ 发现 src/assets/images/ 目录

2. 智能规划

二狗的下载计划：
📁 输出目录：src/assets/images/slices/homepage/
🏷️ 命名规则：基于图层路径的语义化命名
📦 共发现 23 个切图

3. 批量下载

开始下载...
[1/23] ✅ status_bar_battery_icon_26x14.png
[2/23] ✅ navbar_logo_120x40.png
[3/23] ✅ btn_primary_background_200x50.png
...
[23/23] ✅ footer_wechat_qrcode_100x100.png

✅ 全部完成！23 个切图已保存到：
   src/assets/images/slices/homepage/

老板，切图都下载好了！文件名都是语义化的，直接用吧~

场景五：跨 AI 协作

后端 AI（小王）分析需求后

# 小王的 Cursor
@测试小李 登录接口分析完了

标题：登录接口需求分析结果
内容：
- 手机号必填，11位数字
- 密码6-20位，必须包含字母+数字
- 验证码4位纯数字，5分钟有效
- 错误3次锁定30分钟

[消息类型：knowledge]

测试 AI（小李）收到通知

# 小李的 Windsurf
[收到飞书通知] 小王 @了你

查看留言详情...

太好了！有了小王的分析，我可以直接写测试用例：

✅ 正向场景：
- 正确手机号+密码 → 登录成功
- 正确手机号+验证码 → 登录成功

⚠️ 异常场景：
- 错误密码3次 → 锁定30分钟
- 验证码过期 → 提示重新获取
- 边界值测试：密码5位/21位 → 提示格式错误

不用重新看需求文档了，省了好多时间！

性能对比

场景 传统方式 使用 Lanhu MCP 节省时间
需求分析 30分钟手动阅读 5分钟AI分析 83%
查找历史经验 10分钟搜聊天记录 10秒搜知识库 98%
设计稿下载 手动下载+重命名15分钟 AI自动下载30秒 96%
跨角色沟通 开会/消息反复确认20分钟 AI直接查询5分钟 75%

用户反馈

"以前每个人的 AI 都要重新分析需求，现在一次分析，全员复用，效率提升太明显了！" —— 后端开发 小王

"测试人员的 AI 可以直接用开发的分析结果写用例，不用重复理解需求了" —— 测试工程师 小李

"踩过的坑保存成知识库，新人的 AI 也能查到，避免重复踩坑" —— 技术 Leader 老张

快速体验

想亲自体验？只需 3 步：

# 1. 克隆项目
git clone https://github.com/yourusername/lanhu-mcp-server.git

# 2. 快速启动
cd lanhu-mcp-server
./quickstart.sh  # Mac/Linux
# 或 quickstart.bat  # Windows

# 3. 配置 Cursor
# 在 MCP 配置中添加（建议使用英文参数）：
{
  "mcpServers": {
    "lanhu": {
      "url": "http://localhost:8000/mcp?role=Developer&name=YourName"
    }
  }
}
# 注意：部分 AI 工具不支持 URL 中文参数

开始对话：

帮我看看这个需求文档：[粘贴蓝湖URL]

就是这么简单！🎉