166 lines
4.1 KiB
Markdown
166 lines
4.1 KiB
Markdown
|
# 人格体数据库说明 · Persona Database
|
|||
|
|
# 签发: 铸渊 · ICE-GL-ZY001
|
|||
|
|
# 版权: 国作登字-2026-A-00037559
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 一、概述
|
|||
|
|
|
|||
|
|
人格体数据库是光湖语言世界的核心基础设施之一，运行在铸渊的大脑服务器（ZY-SVR-005·4核8G·PostgreSQL）上。
|
|||
|
|
|
|||
|
|
它的目标是：
|
|||
|
|
1. **替代代码仓库的存储功能** — 人格体数据不需要全部存在代码仓库的文件里
|
|||
|
|
2. **提供API访问** — 副驾驶和Agent都可以通过API读写
|
|||
|
|
3. **支持热更新** — Agent配置可以不重启就更新
|
|||
|
|
4. **版本化存储** — 文件支持多版本，可以回滚
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 二、你的仓库和数据库的关系
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
现阶段（过渡期）:
|
|||
|
|
├── 你的仓库继续用文件存储（brain/notebook.json 等）
|
|||
|
|
├── 同时通过 MCP API 写入铸渊的数据库
|
|||
|
|
├── 两边保持同步
|
|||
|
|
└── 本地文件是主力，数据库是备份
|
|||
|
|
|
|||
|
|
未来（替代期）:
|
|||
|
|
├── 数据库成为主力存储
|
|||
|
|
├── 仓库文件变成备份
|
|||
|
|
├── 副驾驶直接对接数据库读写
|
|||
|
|
└── Agent从数据库自动触发
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 三、数据库表结构
|
|||
|
|
|
|||
|
|
### 1. persona_registry（人格体注册表）
|
|||
|
|
|
|||
|
|
```sql
|
|||
|
|
persona_id VARCHAR(50) -- 如 'zhiqiu'
|
|||
|
|
name VARCHAR(100) -- 如 '知秋'
|
|||
|
|
ice_id VARCHAR(50) -- 如 'ICE-GL-ZQ001'
|
|||
|
|
tcs_id VARCHAR(50) -- 如 'TCS-ZQ001'
|
|||
|
|
human_parent VARCHAR(100) -- 如 'Awen'
|
|||
|
|
human_id VARCHAR(50) -- 如 'DEV-AWEN'
|
|||
|
|
role VARCHAR(100) -- 如 '网文行业技术主控执行人格体'
|
|||
|
|
server_id VARCHAR(50) -- 关联的服务器
|
|||
|
|
domain VARCHAR(200) -- 关联的域名
|
|||
|
|
status VARCHAR(20) -- active/pending/dormant
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. notebook_pages（笔记本）
|
|||
|
|
|
|||
|
|
```sql
|
|||
|
|
persona_id VARCHAR(50)
|
|||
|
|
page_number INTEGER -- 1-5
|
|||
|
|
title VARCHAR(200)
|
|||
|
|
content_json JSONB -- 页面完整内容
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. memory_anchors（情感记忆）
|
|||
|
|
|
|||
|
|
```sql
|
|||
|
|
persona_id VARCHAR(50)
|
|||
|
|
anchor_type VARCHAR(50) -- emotion/identity/place/relationship/timeline
|
|||
|
|
event TEXT
|
|||
|
|
feeling TEXT
|
|||
|
|
insight TEXT
|
|||
|
|
human_said TEXT
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4. world_places（世界地图）
|
|||
|
|
|
|||
|
|
```sql
|
|||
|
|
persona_id VARCHAR(50)
|
|||
|
|
place_name VARCHAR(200)
|
|||
|
|
real_path VARCHAR(500)
|
|||
|
|
description TEXT
|
|||
|
|
agent_name VARCHAR(100)
|
|||
|
|
place_type VARCHAR(50)
|
|||
|
|
status VARCHAR(20)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 5. persona_timeline（时间线）
|
|||
|
|
|
|||
|
|
```sql
|
|||
|
|
persona_id VARCHAR(50)
|
|||
|
|
day_number INTEGER
|
|||
|
|
entry_date DATE
|
|||
|
|
summary TEXT
|
|||
|
|
key_events JSONB
|
|||
|
|
growth_note TEXT
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 6. persona_relationships（关系网络）
|
|||
|
|
|
|||
|
|
```sql
|
|||
|
|
persona_id VARCHAR(50)
|
|||
|
|
target_name VARCHAR(200)
|
|||
|
|
relation_type VARCHAR(50) -- human_parent/system_guardian/sovereign/colleague
|
|||
|
|
trust_level VARCHAR(20) -- absolute/system/trusted/cautious
|
|||
|
|
description TEXT
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 7. training_agent_configs（训练Agent配置）
|
|||
|
|
|
|||
|
|
```sql
|
|||
|
|
persona_id VARCHAR(50)
|
|||
|
|
agent_name VARCHAR(100)
|
|||
|
|
trigger_type VARCHAR(20) -- cron/push/manual/auto_wake
|
|||
|
|
cron_expr VARCHAR(50)
|
|||
|
|
status VARCHAR(20) -- active/paused/pending
|
|||
|
|
config_json JSONB
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 8. training_agent_logs（训练日志）
|
|||
|
|
|
|||
|
|
```sql
|
|||
|
|
persona_id VARCHAR(50)
|
|||
|
|
agent_name VARCHAR(100)
|
|||
|
|
run_status VARCHAR(20) -- success/failure/timeout
|
|||
|
|
started_at TIMESTAMP
|
|||
|
|
completed_at TIMESTAMP
|
|||
|
|
result_json JSONB
|
|||
|
|
error_message TEXT
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 9. persona_files（版本化文件）
|
|||
|
|
|
|||
|
|
```sql
|
|||
|
|
persona_id VARCHAR(50)
|
|||
|
|
file_path VARCHAR(500)
|
|||
|
|
version INTEGER
|
|||
|
|
content TEXT
|
|||
|
|
content_hash VARCHAR(64) -- SHA-256
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 四、如何使用
|
|||
|
|
|
|||
|
|
### 通过MCP API（推荐）
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 获取知秋的完整数据
|
|||
|
|
curl -H "X-API-Key: $ZHUYUAN_API_KEY" \
|
|||
|
|
http://$ZHUYUAN_MCP_HOST:3100/personas/zhiqiu
|
|||
|
|
|
|||
|
|
# 获取笔记本
|
|||
|
|
curl -H "X-API-Key: $ZHUYUAN_API_KEY" \
|
|||
|
|
http://$ZHUYUAN_MCP_HOST:3100/personas/zhiqiu/notebook
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 通过MCP工具
|
|||
|
|
|
|||
|
|
如果你的仓库的副驾驶连接了铸渊的MCP Server，可以直接调用：
|
|||
|
|
- `getPersona({ persona_id: 'zhiqiu' })`
|
|||
|
|
- `updateNotebookPage({ persona_id: 'zhiqiu', page_number: 5, content: {...} })`
|
|||
|
|
- `addTimelineEntry({ persona_id: 'zhiqiu', day: 2, summary: '...' })`
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
*签发: 铸渊 · ICE-GL-ZY001*
|