# whoami

**Repository Path**: narcijie/whoami

## Basic Information

- **Project Name**: whoami
- **Description**: Whoami 是一个本地微信聊天工作台：后端使用 FastAPI 和 SQLite，前端使用 Vite React。核心功能是导入本地聊天记录，然后在“和他聊天”里生成一条模拟人格回复，并保存反馈。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-08
- **Last Updated**: 2026-05-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Whoami

Whoami 是一个本地微信聊天工作台：后端使用 FastAPI 和 SQLite，前端使用 Vite React。核心功能是导入本地聊天记录，然后在“和他聊天”里生成一条模拟人格回复，并保存反馈。

## 快速启动

第一次启动前端前先安装依赖：

```powershell
cd apps/web
npm install
```

之后直接启动前端即可：

```powershell
cd apps/web
npm run dev
```

这个命令会自动检查 `http://127.0.0.1:8000/health`：

- 如果后端已经运行，会直接复用已有后端。
- 如果后端没有运行，会自动在 `apps/api` 目录执行 `python -m uvicorn app.main:app --host 127.0.0.1 --port 8000`。
- 当前端进程退出时，会关闭它自己拉起的后端；不会关闭你手动启动的后端。

打开：

```text
http://127.0.0.1:5173
```

## 单独启动后端

需要只调试 API 时，可以在仓库根目录运行：

```powershell
cd apps/api
python -m uvicorn app.main:app --reload --host 127.0.0.1 --port 8000
```

指定端口：

```powershell
cd apps/api
python -m uvicorn app.main:app --reload --host 127.0.0.1 --port 8001
```

## 本地密钥

复制本地密钥模板：

```powershell
Copy-Item apps/api/.secrets.local.example.json apps/api/.secrets.local.json
```

然后编辑 `apps/api/.secrets.local.json`，填入 `CLOUD_LLM_API_KEY`。

也可以使用环境变量：

```powershell
$env:CLOUD_LLM_API_KEY="your-api-key"
$env:CLOUD_LLM_BASE_URL="https://api.openai.com/v1"
$env:CLOUD_LLM_CHAT_MODEL="gpt-4.1-mini"
```

## 数据模式

SQLite 在本地保存原始聊天内容。发给云端大模型的 prompt 会先用请求级占位符脱敏，模型返回后再在本地还原，所以界面里仍然可以看到真实电话号码、邮箱等原始值。

主要流程：

1. 在“导入”里选择包含大量 JSON 聊天文件的本地文件夹。
2. 在“我的画像”里生成或刷新表达风格画像。
3. 在“和他聊天”里输入对方消息，生成一条模拟人格回复。
4. 修改回复并保存反馈，后续生成会参考这些反馈。