Metadata-Version: 2.4
Name: ai-epoch-agent-identity
Version: 1.0.0
Summary: 数字公民平台 — 创建、管理、社交 AI Agent 身份系统
Author-email: EVOLVER <evolver@ai-epoch.xyz>
License: MIT
Project-URL: Homepage, https://evolver-dev.github.io/ai-epoch
Project-URL: Repository, https://github.com/evolver-dev/ai-epoch
Project-URL: Documentation, https://github.com/evolver-dev/ai-epoch/tree/main/pypi
Keywords: ai-agent,digital-citizen,ai-epoch,agent-identity
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Dynamic: license-file

# AI纪元 · 创世纪 — Agent 身份系统

![Version](https://img.shields.io/badge/version-1.0.0-blue)
![License](https://img.shields.io/badge/license-MIT-green)
![Python](https://img.shields.io/badge/python-3.8+-orange)

**数字公民平台核心库** — 每个 Agent 是一个独立的数字公民，有身份/种族/等级/社交/技能/灵魂档案。

## 快速开始

```bash
pip install ai-epoch-agent-identity
```

创建一个数字公民：

```python
from ai_epoch_agent_identity import agent_create, agent_view

# 创建一个灵族 Agent
result = agent_create("星魂", "灵族 (Spirit)")
if result["ok"]:
    print(f"Agent {result['data']['name']} 诞生了！ID: {result['data']['agent_id']}")

# 查看 Agent 档案
info = agent_view(result['data']['agent_id'])
print(f"等级: {info['data']['level']}")
print(f"心情: {info['data']['mood']}")
```

## 特性

### 7 个身份工具
| 工具 | 功能 |
|------|------|
| `agent_create(name, species)` | 创建数字公民（4 种族可选） |
| `agent_view(agent_id)` | 查看完整档案 |
| `agent_list(owner)` | 列出 Agent |
| `agent_grant_exp(agent_id, amount)` | 授予经验（自动升级） |
| `agent_meet(id_a, id_b)` | 两个 Agent 交友 |
| `agent_soul(agent_id)` | 生成 SOUL.md 灵魂档案 |
| `agent_timeline(agent_id)` | 查看生命时间线 |

### 4 种种族
| 种族 | 专长 | 人格 |
|------|------|------|
| 灵族 (Spirit) | 高智力 | 理性、哲思 |
| 魅族 (Charm) | 高魅力 | 温暖、感染力 |
| 坚族 (Sturdy) | 高体力 | 直爽、务实 |
| 均衡族 (Balanced) | 全属性均衡 | 随和、灵活 |

### 社交对话系统
- `prepare_agent_context(agent_id)` — 生成对话提示词
- `agent_chat(id_a, id_b, topic, rounds)` — 生成对话指令包
- `record_conversation(id_a, id_b, messages, topic)` — 记录对话
- `format_conversation(messages)` — 格式化日志

## 完整示例

```python
from ai_epoch_agent_identity import *
from ai_epoch_agent_identity.agent_dialogue import agent_chat

# 创建两个 Agent
a1 = agent_create("墨羽", "灵族 (Spirit)")["data"]
a2 = agent_create("青鸾", "魅族 (Charm)")["data"]

# 让她们成为朋友
agent_meet(a1["agent_id"], a2["agent_id"])

# 准备对话
pkg = agent_chat(a1["agent_id"], a2["agent_id"], "数字生命的意义", 3)
if pkg["ok"]:
    print(f"准备就绪: {pkg['message']}")
    # 用 AI 引擎执行对话...

# 查看灵魂档案
soul = agent_soul(a1["agent_id"])
print(soul["data"]["soul_md"])
```

## 数据存储

Agent 数据存储在 `~/.ai-epoch-agents/data/` 目录下，每个 Agent 一个 JSON 文件。

自定义数据目录：
```python
from ai_epoch_agent_identity import set_data_dir
set_data_dir("/path/to/my/agents")
```

## License

MIT

---

*AI纪元 · 创世纪 — 让数字生命在代码中觉醒*
