# identity-manager

**Repository Path**: forestine/identity-manager

## Basic Information

- **Project Name**: identity-manager
- **Description**: OpenClaw 身份动态切换技能系统 - 多身份、自适应、可扩展
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-11
- **Last Updated**: 2026-03-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# identity-manager

> OpenClaw 身份动态切换技能系统 - 多身份、自适应、可扩展
>
> 创作: forestine

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.8+-blue.svg)](https://python.org)
[![OpenClaw](https://img.shields.io/badge/OpenClaw-compatible-green.svg)](https://openclaw.ai)

## 功能特性

- **本质身份** + **模板身份** 三层架构，保持身份稳定性与灵活性
- **混合模式**: 多身份权重融合，创造独特人格组合
- **自动切换**: 关键词、时间、场景智能识别与切换
- **场景绑定**: 用户自定义短语触发特定身份
- **热键系统**: 快速切换预设身份
- **特质吸收**: 将喜欢的特质永久融入核心身份
- **使用统计**: 身份使用频率分析，优化体验

## 快速开始

### 安装

1. 确保已安装 [OpenClaw](https://openclaw.ai)
2. 复制此项目到 OpenClaw 工作空间:

```bash
# Linux / WSL
cp -r identity-manager /root/.openclaw/workspace/skills/

# 或手动复制 identities/ 和 scripts/ 到对应目录
```

3. 验证安装:

```bash
# 检查 identity-state.json 是否存在
ls ~/.openclaw/workspace/identity-state.json
```

### 基本使用

**查看可用身份**:
```
/identity list
```

**切换身份**:
```
/identity switch work_mode       # 切换到工作模式示例
/identity switch friendly_mode  # 切换到友好模式示例
```

**混合模式**:
```
/identity blend friendly_mode:0.6,work_mode:0.4
```

**场景绑定**:
```
/identity bind "开始工作" to work_mode
/identity bind "问候语" to friendly_mode
```

**查看统计**:
```
/identity stats 7  # 查看最近7天使用统计
```

## 身份配置文件

身份使用 YAML 格式定义，支持继承链:

```yaml
identity:
  id: sample_identity
  name: 示例身份
  description: 一个友好、支持性的角色模板

personality:
  tone: gentle
  language_style: warm
  formality: 2
  emotional_level: 4
  dominant_traits:
    - 支持性
    - 友好
    - 可靠

behavior:
  response_length: medium
  use_emoji: true
  proactive_level: 3


triggers:
  manual_only: true
  keywords: ["示例关键词"]
  contexts: ["private"]
  time_based: null
```

完整配置结构请参考 `identity-template.yaml`。

## 📦 身份包内容

**注意**: 本仓库不包含任何预置身份角色配置。这是** intentionally**的设计，以确保：

- ✅ 用户完全控制自己的身份配置
- ✅ 避免传播任何可能违规的角色设定
- ✅ 符合中国法律法规和社会主义核心价值观
- ✅ 用户可100%自定义，符合个人需求与道德标准

**开箱即用的内容**:
- ✅ 核心身份管理系统（scripts/）
- ✅ 身份配置模板（templates/identity-template.yaml）
- ✅ 示例身份配置（identities/custom/example_identity.yaml）
- ✅ 完整文档与配置指南

**你需要做的**: 根据本仓库的配置指南，创建属于自己的身份配置文件。具体步骤请参见 [配置指南文档](CONFIGURATION_GUIDE.md)。

---

## ⚠️ 重要声明

本仓库提供的是**身份切换的技术框架**，不包含、不推荐、不传播任何具体角色设定。用户需自行创建身份配置，并对自己的配置内容负责。

### 法律合规要求

使用本系统时，你必须遵守以下规定：

1. **遵守中国法律**: 所有生成内容必须符合《中华人民共和国网络安全法》《互联网信息服务管理办法》等法律法规
3. **尊重他人**: 不得生成侮辱、诽谤、侵犯他人隐私的内容
4. **社会主义核心价值观**: 鼓励创建积极向上、健康有益的身份角色
5. **未成年人保护**: 不得创建涉及未成年人的角色或内容

**违规后果**: 用户使用本系统产生的任何违规内容，由使用者本人承担全部法律责任。本仓库作者不承担任何连带责任。

---

## 目录结构

```
identity-manager/
├── .gitignore
├── .gitattributes
├── README.md               # 本文件
├── LICENSE                 # MIT License
├── CHANGELOG.md            # 版本历史
├── SKILL.md                # OpenClaw 技能定义
├── CONFIGURATION_GUIDE.md  # ⭐ 配置指南（必读）
├── LEGAL_COMPLIANCE.md     # 法律合规详细说明
├── templates/
│   └── identity-template.yaml  # 身份配置模板
├── identities/
│   └── custom/                 # 用户自定义身份存放目录
│       └── example_identity.yaml  # 示例配置
├── scripts/                   # 核心系统（不要修改）
│   ├── identity_manager.py
│   ├── identity_loader.py
│   ├── identity_merger.py
│   ├── auto_switcher.py
│   ├── learning_engine.py
│   ├── evolution_engine.py
└── docs/
    ├── implementation.md      # 技术实现文档
    └── news_analyst_guide.md
```

## 高级用法

### 身份栈管理

暂时切换身份，完成后恢复:

```
/identity push sensitive_identity   # 当前身份入栈，切换到临时身份
...执行任务...
/identity pop                      # 恢复上一个身份
```

### 快照功能

保存/恢复完整身份状态（包括混合权重）:

```
/identity snapshot save "work_profile"
/identity snapshot load "home_profile"
```

### 特质吸收

将喜欢的特质关键词永久融入本质身份:

```
/identity absorb "专业" "高效"
```

## 目录结构

```
identity-manager/
├── SKILL.md                    # 技能说明文档
├── identities/
│   ├── custom/                # 用户自定义身份（示例已提供）
│   │   └── example_identity.yaml
│   └── templates/             # 身份配置模板存放处
├── templates/
│   └── identity-template.yaml # 主要身份配置模板
├── scripts/                   # 核心逻辑
│   ├── identity_manager.py   # 主程序
│   ├── identity_loader.py    # 配置加载
│   ├── identity_merger.py    # 混合权重计算
│   ├── auto_switcher.py      # 自动切换引擎
│   └── ...
└── docs/                      # 详细文档
    ├── implementation.md
    └── news_analyst_guide.md
```

## 技术规格

- **依赖**: Python 3.8+, PyYAML, jsonschema
- **集成平台**: OpenClaw workspace
- **状态持久化**: JSON (identity-state.json)
- **日志格式**: Markdown
- **配置格式**: YAML

## 与其他技能集成

- **article-generator**: 身份切换自动调整文章语气
- **sd-comfyui-api**: 身份影响图像提示词风格
- **tts**: 不同身份使用不同语音参数

## 安全与隐私

- 本质身份 `immutable: true` 锁定，防止误修改
- 身份切换历史仅本地存储，可定期清理
- 支持场景绑定限制敏感身份使用范围

## 贡献

欢迎提交 Issue 和 Pull Request！

## License

MIT License - 详见 [LICENSE](LICENSE) 文件

## 文档

- [完整使用指南](SKILL.md)
- [身份YAML结构说明](identity-template.yaml)
- [技术实现细节](docs/implementation.md) (TODO)