# Agent 人格设置引导功能 - 会话交接文档

> **创建时间**: 2026-03-16
> **状态**: Phase 2 进行中

---

## 一、功能概述

为 ZCLAW 添加类似 ZCLAW 的 Agent 创建引导向导，包括人格风格设置、Emoji 选择、使用场景标签选择等。

**计划文档**: `plans/vast-stirring-wilkinson.md`

---

## 二、已完成工作

### Phase 1: 数据层 ✅ 已完成

1. **扩展 Clone 接口** (`desktop/src/store/agentStore.ts`)
   - 添加字段: `emoji`, `personality`, `communicationStyle`, `notes`, `onboardingCompleted`

2. **扩展 Clone 和 QuickConfig 接口** (`desktop/src/store/gatewayStore.ts`)
   - 添加相同的人格相关字段

3. **创建人格预设配置** (`desktop/src/lib/personality-presets.ts`)
   - `PERSONALITY_OPTIONS`: 4种人格风格 (专业严谨/友好亲切/创意灵活/简洁高效)
   - `SCENARIO_TAGS`: 9个使用场景标签 (编程开发/内容写作/产品策划等)
   - `EMOJI_PRESETS`: Emoji 预设分组 (动物/物体/表情)
   - `QUICK_START_SUGGESTIONS`: 首次对话快速建议
   - 辅助函数: `generateWelcomeMessage`, `generateSoulContent`, `generateUserContent`

### Phase 2: 核心组件 ✅ 已完成

1. **EmojiPicker** (`desktop/src/components/ui/EmojiPicker.tsx`)
   - 分类标签 (全部/动物/物体/表情)
   - 8列网格布局
   - 选中状态显示

2. **PersonalitySelector** (`desktop/src/components/PersonalitySelector.tsx`)
   - 4种人格卡片选择
   - 特质标签显示
   - `PersonalityBadge` 显示组件

3. **ScenarioTags** (`desktop/src/components/ScenarioTags.tsx`)
   - 多选标签
   - 最多选择5个
   - `ScenarioBadges` 显示组件

4. **AgentOnboardingWizard** (`desktop/src/components/AgentOnboardingWizard.tsx`)
   - 5步向导: 认识用户 → Agent身份 → 人格风格 → 使用场景 → 工作环境
   - 进度条显示
   - 表单验证
   - 配置预览
   - 创建提交

---

## 三、待完成工作

### Phase 3: 集成 (优先级高)

1. **修改 CloneManager** (`desktop/src/components/CloneManager.tsx`)
   - 集成 AgentOnboardingWizard 模态框
   - 替换或增强现有的内联表单

2. **实现 FirstConversationPrompt**
   - 创建 `desktop/src/components/FirstConversationPrompt.tsx`
   - 显示个性化欢迎消息
   - 显示快速开始建议按钮
   - 集成到 `ChatArea.tsx`

3. **修改 RightPanel** (`desktop/src/components/RightPanel.tsx`)
   - 显示 Agent 的 emoji
   - 显示人格风格标签
   - 显示使用场景标签

### Phase 4: 测试

1. 测试创建流程
2. 测试持久化
3. 测试首次对话引导

---

## 四、关键文件路径

```
desktop/src/
├── components/
│   ├── AgentOnboardingWizard.tsx  # ✅ 已创建
│   ├── PersonalitySelector.tsx    # ✅ 已创建
│   ├── ScenarioTags.tsx           # ✅ 已创建
│   ├── CloneManager.tsx           # 🔧 需修改
│   ├── ChatArea.tsx               # 🔧 需修改
│   └── RightPanel.tsx             # 🔧 需修改
├── components/ui/
│   └── EmojiPicker.tsx            # ✅ 已创建
├── lib/
│   └── personality-presets.ts     # ✅ 已创建
└── store/
    ├── agentStore.ts              # ✅ 已修改
    └── gatewayStore.ts            # ✅ 已修改
```

---

## 五、参考资源

- ZCLAW 快速配置: `docs/archive/zclaw-legacy/autoclaw界面/html版/4.html`
- ZCLAW Agent 面板: `docs/archive/zclaw-legacy/autoclaw界面/html版/3.html`
- 现有 Modal 模式: `desktop/src/components/CreateTriggerModal.tsx`

---

## 六、新会话提示词

```
我正在实现 ZCLAW 的 Agent 人格设置引导功能，参考 ZCLAW 的设计。

**当前进度**:
- Phase 1 (数据层) ✅ 已完成
- Phase 2 (核心组件) ✅ 已完成
- Phase 3 (集成) ⏳ 待开始
- Phase 4 (测试) ⏳ 待开始

**已完成的文件**:
- `desktop/src/store/agentStore.ts` - 扩展了 Clone 接口
- `desktop/src/store/gatewayStore.ts` - 扩展了 Clone 和 QuickConfig 接口
- `desktop/src/lib/personality-presets.ts` - 人格预设配置
- `desktop/src/components/ui/EmojiPicker.tsx` - Emoji 选择器
- `desktop/src/components/PersonalitySelector.tsx` - 人格选择器
- `desktop/src/components/ScenarioTags.tsx` - 场景标签选择器
- `desktop/src/components/AgentOnboardingWizard.tsx` - 向导主组件

**下一步工作**:
1. 修改 `CloneManager.tsx` 集成 AgentOnboardingWizard
2. 创建 `FirstConversationPrompt.tsx` 并集成到 ChatArea
3. 修改 `RightPanel.tsx` 显示人格信息

请继续完成 Phase 3 的集成工作。详细计划见 `plans/vast-stirring-wilkinson.md`。
```