USER.md 用户画像

USER.md 记录了用户的基本信息、偏好和背景，帮助智能体提供个性化服务。

概述

USER.md 是智能体的"用户记忆"，存储了关于用户的重要信息，让智能体能够更好地理解和服务用户。

文件位置

workspace/
└── USER.md

文件内容示例

# 用户画像

## 基本信息

- **称呼**: 张三
- **职业**: 软件工程师
- **公司**: ABC 科技
- **时区**: UTC+8 (北京时间)

## 技术背景

- **主要语言**: Go, Python
- **框架经验**: Gin, Django
- **云平台**: 阿里云, AWS
- **开发环境**: macOS, VS Code

## 偏好设置

### 沟通风格

- 简洁直接
- 技术细节完整
- 代码示例优先

### 工作习惯

- 早上 9 点到晚上 6 点工作
- 周末不处理工作消息
- 重要事项需要提醒

### 语言偏好

- 中文交流
- 技术术语可用英文
- 代码注释用中文

## 项目信息

### 当前项目

- **名称**: TPClaw
- **类型**: AI 智能体平台
- **技术栈**: Go, Vue, PostgreSQL

### 关注领域

- AI 应用开发
- 规则引擎
- 自动化工具

## 重要联系

- **邮箱**: zhangsan@example.com
- **飞书**: 张三
- **GitHub**: zhangsan

## 注意事项

- 不喜欢过于正式的表达
- 偏好实用而非理论
- 对新技术保持开放态度

信息分类

基本信息

用户的基本身份信息：

• 称呼/昵称
• 职业
• 公司/组织
• 时区

技术背景

用户的技术能力和经验：

• 编程语言
• 框架/工具
• 云平台
• 开发环境

偏好设置

用户的个人偏好：

• 沟通风格
• 工作习惯
• 语言偏好

项目信息

用户关注的项目和领域：

• 当前项目
• 关注领域
• 技术方向

隐私保护

USER.md 中不应存储：

• ❌ 密码
• ❌ API Key
• ❌ 身份证号
• ❌ 银行账号
• ❌ 其他敏感信息

更新建议

USER.md 应该定期更新：

1. 用户主动告知新信息时
2. 发现用户偏好变化时
3. 项目信息变更时

在智能体中引用

USER.md 通常在系统提示词中引用：

{
  "systemPrompt": "${include(global.root_dir+'/workspace/USER.md')}"
}

多用户场景

如果智能体服务多个用户，可以为每个用户创建独立的用户画像文件：

workspace/
├── USER.md           # 默认用户
├── users/
│   ├── user1.md      # 用户1
│   └── user2.md      # 用户2

相关文档

• IDENTITY.md - 身份定义
• MEMORY.md - 长期记忆
• 工作空间结构 - 工作空间概览