# Aimeet

**Repository Path**: yuncang123/aimeet

## Basic Information

- **Project Name**: Aimeet
- **Description**: AI大赛路演项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: route-digital-twin-core
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-31
- **Last Updated**: 2026-08-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 数字分身实验室

`codex/route-digital-twin-core` 分支把项目拆成两个独立前端应用,模拟真实使用场景:

- `digital-meet/`: 数字分身控制台。用于训练、查看画像、记忆、策略和沟通回放。
- `social-sandbox/`: 模拟微信/QQ 的社交沙盒。它是独立 App,用于真实感地验证好友、会话和数字分身托管沟通。
- `digital-meet-backend/`: FastAPI 后端。提供鉴权、数字分身内核、记忆、沙盒消息和 WebSocket。

## 必读文档

- [产品方向](docs/PRODUCT_DIRECTION.md): 解释为什么当前路线是“数字分身”,不是新社交软件、电子伴侣或任务 Agent。
- [开发手册](docs/DEVELOPMENT.md): 本地启动、uv 环境、验证命令和开发约定。
- [个人 API Key 配置](docs/API_KEYS.md): 切换到你自己的 LLM/Embedding/文生图 key,控制 token 和费用。
- [架构说明](docs/ARCHITECTURE.md): 双前端、可拆后端、连接器和学习闭环。
- [数字分身 Agent 规格](docs/AGENT_SPEC.md): agent 的分层、loop、确认门和反思机制。
- [数字分身记忆模型](docs/AGENT_MEMORY.md): 记忆怎么写入、检索、过期和分层。
- [数字分身 Agent 评测标尺](docs/AGENT_RUBRIC.md): 判断它是否真的越来越像你。
- [功能地图](docs/FEATURE_MAP.md): 新需求应该放在哪里,哪些旧功能只保留兼容。
- [产品审计与下一步](docs/PRODUCT_AUDIT.md): 对照数字分身愿景列出已补齐和仍缺失的核心能力。

## 本地启动

后端:

```powershell
cd D:\Develop\private\aimeet\digital-meet-backend
uv run uvicorn app.main:app --reload --port 8000
```

如果只启动数字分身内核:

```powershell
cd D:\Develop\private\aimeet\digital-meet-backend
uv run uvicorn app.twin_app:app --reload --port 8000
```

如果只启动模拟社交沙盒:

```powershell
cd D:\Develop\private\aimeet\digital-meet-backend
uv run uvicorn app.sandbox_app:app --reload --port 8000
```

数字分身控制台:

```powershell
cd D:\Develop\private\aimeet\digital-meet
npm run dev -- --host 127.0.0.1 --port 5173
```

模拟社交沙盒:

```powershell
cd D:\Develop\private\aimeet\social-sandbox
npm run dev -- --host 127.0.0.1 --port 5174
```

访问:

- 数字分身控制台: http://127.0.0.1:5173
- 模拟社交沙盒: http://127.0.0.1:5174
- 后端 API: http://127.0.0.1:8000/docs

## 当前产品边界

数字分身控制台和模拟社交沙盒是两个独立 App。默认本地开发可以共用 `app.main:app` 这个组合后端;也可以按需要分别启动 `app.twin_app:app` 或 `app.sandbox_app:app`。当前它们复用同一套 SQLite 数据访问层,后续可以进一步拆成独立服务和数据库。

## 平台连接策略

最终产品应尽可能贴近真实使用场景:

- 平台愿意合作并提供 API: 使用 `official_api` 连接器,例如飞书开放平台机器人/消息 API。
- 平台不提供 API: 使用 `third_party_tool` 连接器承接合规的第三方工具、RPA、浏览器插件或人工确认桥接。
- 本地实验: 使用 `sandbox` 连接器,由 `social-sandbox` 模拟微信/QQ 的消息环境。

无论接入方式如何,数字分身外发沟通都必须保留发送前确认、审计记录、沟通回放和必要时转交真人的能力。

Docker 部署文件仍在从旧单前端应用向双前端应用迁移,本分支当前以本地开发验证为准。