Maozhua V0.1 Demo Scenarios

# 猫爪 v0.1 Demo 场景

Status: Draft  
Audience: Founder, product, sales, demo operators  
Companions: [maozhua-v0.1-quick-start.md](maozhua-v0.1-quick-start.md), [maozhua-v0.1-release-notes-draft.md](maozhua-v0.1-release-notes-draft.md)

## 1. 文档目的

本文档定义猫爪 v0.1 对外演示与试用讲解时最推荐的 5 个场景。

原则：

- 优先展示稳定能力
- 不展示边界模糊的能力
- 每个场景都要能在短时间内形成价值感知

## 2. Demo 场景 1：3 分钟理解仓库

### 目标

让用户快速感知猫爪能读懂真实项目。

### 建议话术

- 打开一个真实代码仓库
- 直接提问整体结构
- 让它说明主要模块和入口

### 示例

```bash
pi "请总结这个仓库的结构、核心模块和最重要的入口文件"
```

### 价值点

- 上手快
- 不需要复杂配置
- 立刻体现代码理解能力

## 3. Demo 场景 2：精准定位关键逻辑

### 目标

让用户看到搜索与定位能力。

### 示例

```bash
pi "帮我找出这个项目里处理 session 持久化的核心文件和函数"
```

### 价值点

- 适合接手陌生仓库
- 适合 code review 前的快速摸底

## 4. Demo 场景 3：解释一个错误或失败

### 目标

展示问题分析能力。

### 示例

```bash
pi -p "这个错误最可能是什么原因？请给出 3 个排查方向。"
```

### 价值点

- 用户最容易理解
- 很适合形成“这工具能帮到我”的感知

## 5. Demo 场景 4：轻量代码修改建议

### 目标

展示它不仅能解释，还能推动实际改动。

### 示例

```bash
pi @src/main.rs "请帮我找出这里最值得先优化的一处，并说明原因"
```

### 价值点

- 体现 AI coding workflow
- 风险比直接大改代码低

## 6. Demo 场景 5：会话继续与恢复

### 目标

展示它不是一次性问答工具，而是可持续工作流。

### 示例

```bash
pi --continue
```

或：

```bash
pi --resume
```

### 价值点

- 体现真实工作流连续性
- 对比单次问答工具更有产品感

## 7. 不建议在首轮 Demo 中展示的内容

首轮演示不建议重点展示：

- 深度 RPC 接入
- SDK 嵌入
- 复杂扩展生态兼容
- OpenClaw V2 产品层能力
- 边界模糊的 provider 兼容性

## 8. Demo 操作建议

- 优先使用已验证的仓库和终端环境
- 演示前先确认 provider 凭据可用
- 准备 1 套主仓库和 1 套备用仓库
- 每个场景控制在 2–5 分钟
- 避免现场展示高风险未验证路径

## 9. 演示目标

如果 Demo 成功，观众应该形成这三个判断：

1. 猫爪已经是一个可用产品，而不只是技术项目
2. 它能在真实代码仓库里立即产生价值
3. 它值得进入试用阶段并提供反馈