# ChatBot

**Repository Path**: SKINGAP/chat-bot

## Basic Information

- **Project Name**: ChatBot
- **Description**: 聊天机器人
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-07
- **Last Updated**: 2026-07-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 聊天机器人后端与调试台

这是一个可在本地运行的后端服务与调试台，用于验证“像本人语气生成回复”的流程。  
你可以通过网页调试台创建用户档案、升级会员、管理参考资料，并生成普通版和进阶版回复。

## 目前能力

- 创建演示用户风格档案（支持星座、已知 MBTI、简版 MBTI 测试结果、沟通偏好）
- 创建普通会员与进阶会员（模拟支付）
- 普通版生成可复制文本回复
- 进阶版支持目标导向回复、参考资料上下文、聊天截图上下文
- 本地 JSON 文件持久化（开发友好、易查看）
- 本地调试台（`http://127.0.0.1:3000`）用于手工验证接口
- 未设置 `OPENAI_API_KEY` 时自动使用 Mock 模式，不会真实调用模型 API

## 快速开始

安装 Node.js（建议 20+）后，在项目目录执行：

```bash
npm start
```

默认地址：

```text
http://localhost:3000
```

修改端口（Linux/macOS）：

```bash
PORT=4312 npm start
```

修改端口（Windows PowerShell）：

```powershell
$env:PORT='4312'
npm start
```

## 测试

```bash
npm test
```

## 微信小程序单机版

小程序单机版放在 `miniprogram/` 目录，用来在开发阶段测试用户体验。它不连接后端、不调用真实大模型、不接真实微信支付，所有数据都保存在微信小程序本地存储里。

### 打开方式

1. 打开微信开发者工具。
2. 选择“导入项目”。
3. 项目目录选择本仓库根目录。
4. AppID 可以选择测试号或游客模式。
5. 进入后首页会显示当前会员、普通试用次数、风格档案状态和功能入口。

### 可测试流程

1. 进入“风格设定”，填写授权聊天样本、星座、MBTI 或简版 MBTI 测试，并保存风格档案。
2. 进入“普通版回复”，输入对方说的话，生成并复制回复。
3. 进入“升级会员”，模拟开通普通版或进阶版。
4. 进入“资料库”，添加情感课程、理论摘要或沟通框架。
5. 进入“进阶版回复”，填写聊天目的、希望结果、资料标签，选择聊天截图，生成并复制回复。

### 小程序隐私边界

- 小程序只生成可复制文本，不自动代发消息。
- 聊天样本必须来自本人或已获授权。
- 聊天截图只作为当前页面的临时状态，不写入本地存储和回复日志。
- 回复日志不保存对方原话、用户目标原文、希望结果原文或截图路径。

## 环境变量

- `PORT`：服务端口，默认 `3000`
- `DATA_DIR`：本地 JSON 数据目录，默认 `data`
- `OPENAI_API_KEY`：真实模型 API Key，未设置时走 Mock 模式
- `OPENAI_MODEL`：模型名，默认 `gpt-4o-mini`

## 隐私边界

- 系统只会返回可复制文本，不会自动代发消息
- 原始聊天文本默认不保存
- 进阶版聊天截图为临时上下文，仅用于本次生成，不会写入 `replyLogs`
- API Key 仅从环境变量读取，请勿写进代码库