# wxwork-assistant

**Repository Path**: hymanfire/wxwork-assistant

## Basic Information

- **Project Name**: wxwork-assistant
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-03
- **Last Updated**: 2026-09-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智能企微助手

面向企业微信客服场景的前端工作台，包含企微账号扫码登录、会话列表、会话消息查询和发送等核心流程。

## 技术栈

Vue 3、TypeScript、Vite、Vue Router、Pinia、Axios、Element Plus。

## 本地运行

要求 Node.js 20.19+ 或 22.12+。

```bash
npm install
cp .env.example .env
npm run dev
```

开发服务器会将 `/api` 代理到 `http://localhost:8055`。如后端地址不同，请修改 `.env` 中的 `VITE_API_PROXY_TARGET`。

## 环境变量

| 变量 | 默认值 | 说明 |
| --- | --- | --- |
| `VITE_API_BASE_URL` | `/api` | 前端请求基础路径 |
| `VITE_API_PROXY_TARGET` | `http://localhost:8055` | 本地后端服务地址 |
| `VITE_DEFAULT_CONVERSATION_ID` | 文档约定的联调会话 ID | 工作台默认会话 |
| `VITE_LOGIN_POLL_INTERVAL_MS` | `2000` | 登录状态轮询间隔，前端最低强制为 2 秒 |
| `VITE_QIWE_CLIENT_VERSION` | 空 | QiWe iPad 客户端版本；无特殊需求请保持为空 |

## 页面

- `/login`：创建设备登录会话、二维码展示、扫码状态轮询、6 位验证码和结果反馈。
- `/workbench/:conversationId?`：会话工作台、会话列表切换、消息列表手动/定时刷新、文本消息发送、消息状态与待接入的客户洞察区域。

客户画像和 AI 建议目前没有稳定的数据接口，页面会明确标记为“待接入”，不会用演示数据冒充真实数据。

## 验证

```bash
npm run build
npm run test
```