log-format-template.md•4.24 kB
# AI对话记录标准格式模板
## 记录结构规范
### 基础信息区块
```markdown
## [时间戳] - [对话编号]
### 📱 Agent信息
- **平台**: [claude-code | cursor | vscode | idea]
- **模型**: [模型名称和版本，如 Claude-3.5-Sonnet, GPT-4, Copilot等]
- **会话ID**: [会话唯一标识符，如果有]
### 👤 用户提问
[用户原始输入内容]
**提问类型**: [文本 | 图片 | 代码 | 混合]
**图片描述** (如果包含图片):
- **图片1**: [对图片内容的详细描述，包括关键元素、界面布局、代码截图内容等]
- **图片2**: [...]
### 🤖 AI回复总结
**问题理解**: [AI对用户问题的理解和分析]
**解决方案概述**: [提供的主要解决方案或建议]
**关键技术点**:
- [技术点1]
- [技术点2]
- [...]
### 📝 文件修改记录
**修改的文件**:
1. **文件路径**: `src/components/LoginForm.tsx`
- **修改类型**: [新建 | 修改 | 删除]
- **修改内容**: [具体修改的代码片段或功能描述]
- **行号范围**: [如 L15-L32]
2. **文件路径**: `src/types/user.ts`
- **修改类型**: [新建 | 修改 | 删除]
- **修改内容**: [具体修改内容]
- **行号范围**: [行号信息]
### ⚡ 执行的操作
- [操作1: 如运行命令、安装依赖等]
- [操作2: 如创建文件、重构代码等]
- [操作3: 如测试验证、部署等]
### 🏷️ 标签
`[主题标签]` `[技术栈]` `[操作类型]` `[难度等级]`
### 🔗 相关对话
- [关联的历史对话ID或日期]
- [相关的文档链接]
---
```
## 实际使用示例
```markdown
## 2025-08-04 22:30:15 - 对话#042
### 📱 Agent信息
- **平台**: claude-code
- **模型**: Claude-3.5-Sonnet (20241022)
- **会话ID**: session_abc123
### 👤 用户提问
帮我实现一个React登录组件，需要支持邮箱密码登录，要有表单验证和错误提示
**提问类型**: 文本
### 🤖 AI回复总结
**问题理解**: 用户需要创建一个完整的React登录组件，包含表单验证、错误处理和用户交互功能
**解决方案概述**: 创建LoginForm组件，使用React Hook Form进行表单管理，添加输入验证和错误状态处理
**关键技术点**:
- React函数组件和Hooks
- 表单验证逻辑
- 状态管理和错误处理
- TypeScript类型定义
### 📝 文件修改记录
**修改的文件**:
1. **文件路径**: `src/components/LoginForm.tsx`
- **修改类型**: 新建
- **修改内容**: 创建完整的登录表单组件，包含邮箱密码输入框、验证逻辑和提交处理
- **行号范围**: L1-L85
2. **文件路径**: `src/types/auth.ts`
- **修改类型**: 新建
- **修改内容**: 定义登录表单数据类型和验证规则接口
- **行号范围**: L1-L15
3. **文件路径**: `src/styles/LoginForm.module.css`
- **修改类型**: 新建
- **修改内容**: 登录组件的样式定义，包含响应式布局和错误状态样式
- **行号范围**: L1-L45
### ⚡ 执行的操作
- 分析项目结构和现有组件模式
- 创建LoginForm组件文件
- 添加TypeScript类型定义
- 实现表单验证逻辑
- 创建配套样式文件
- 测试组件基本功能
### 🏷️ 标签
`React` `登录组件` `表单验证` `TypeScript` `新功能开发`
### 🔗 相关对话
- 2025-08-03对话#038: 关于React项目结构设计
- 组件开发规范文档: docs/component-guidelines.md
---
```
## 特殊情况处理
### 图片内容描述规范
当用户提供图片时，描述应包含：
- **界面截图**: 描述UI布局、按钮位置、文本内容、颜色主题等
- **代码截图**: 描述代码语言、关键函数名、错误信息、行号等
- **设计图**: 描述设计元素、布局结构、交互流程等
- **错误截图**: 描述错误类型、错误信息、发生位置等
### 复杂操作记录
对于涉及多步骤的复杂操作：
- 按时间顺序记录每个步骤
- 标注每步的目的和结果
- 记录遇到的问题和解决方法
- 标明最终达成的目标
### 代码修改细节
- 对于大型重构，按模块分别记录
- 新增功能突出核心逻辑
- 修复bug记录问题原因和解决思路
- 性能优化记录前后对比数据