# 联通上下文测试工程

**Repository Path**: y00854865/unicom-context-testing-project

## Basic Information

- **Project Name**: 联通上下文测试工程
- **Description**: No description available
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-17
- **Last Updated**: 2026-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 联通上下文测试工程

#### 介绍

本项目用于测试和验证上下文服务（Context Service）的对话能力，提供可视化的前端界面和后端 API，支持意图裁决、上下文查询/写入、记忆召回等功能。

#### 项目结构

```
├── dialogue-system/          # 对话系统（主要开发分支）
│   ├── backend/             # FastAPI 后端
│   │   ├── main.py          # API 路由和核心逻辑
│   │   ├── config.json      # 服务配置
│   │   └── users.json       # 用户认证数据
│   └── frontend/            # Web 前端
│       └── index.html       # 单页应用
├── context_service/          # 上下文服务（C++ 实现）
└── context_api_Insights/     # API 洞察与分析
```

#### 对话系统使用说明

**启动后端**

```bash
cd dialogue-system/backend
pip install -r requirements.txt
python main.py
```

后端服务默认运行在 `http://0.0.0.0:8001`

**配置参数**

前端侧边栏「⚙️ 查询参数」支持以下可配置项：

| 参数 | 说明 | 可选值 |
|------|------|--------|
| `mode` | 查询模式 | `fast` / `quality` |
| `enable_memory` | 是否启用记忆 | `true` / `false` |
| `conversation_turns` | 召回历史轮数 | 整数（默认 3） |
| `rewrite_query` | 是否启用查询改写 | `true` / `false` |

**API 接口**

| 接口 | 方法 | 说明 |
|------|------|------|
| `/api/chat` | POST | 对话接口（意图裁决 + 上下文查询 + 生成回答） |
| `/api/v1/contexts/query` | POST | 代理查询上下文 |
| `/api/v1/contexts/write` | POST | 代理写入上下文 |
| `/api/v1/contexts/delete` | POST | 代理删除上下文 |
| `/api/v1/conversations/history/query` | POST | 查询会话历史 |
| `/api/v1/memory/history/query` | POST | 查询记忆列表 |
| `/config` | GET/PUT | 服务配置 |

#### 开发指南

```bash
# 同步最新代码
git checkout dev
git pull gitee dev

# 提交改动
git add <files>
git commit -m "feat: 描述"
git push gitee dev
```

#### 分支说明

- `master` — 稳定版本（受保护）
- `dev` — 开发分支，所有新功能开发在此分支进行

#### 参与贡献

1. Fork 本仓库
2. 从 `dev` 新建功能分支：`git checkout -b feat/xxx`
3. 提交代码后 Push：`git push gitee feat/xxx`
4. 在 Gitee 上创建 Pull Request 到 `dev` 分支