# AssistantAgent

**Repository Path**: zyx0121/assistant-agent

## Basic Information

- **Project Name**: AssistantAgent
- **Description**: 112312312321312
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-03
- **Last Updated**: 2026-04-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenCode Multiuser System

基于 OpenCode 的Vmall AI 助手系统。

## 环境要求

- Python 3.8+
- OpenCode CLI

## 依赖

- flask >= 3.0
- pyjwt >= 2.8
- bcrypt >= 4.0

## 快速开始

### 1. 配置环境

编辑 `config.json`，修改 Python 和 OpenCode 路径：

```json
{
    "python_path": "python",
    "opencode_path": "opencode-cli",
    "ports": {
        "auth_proxy": 5000,
        "opencode": 4096,
        "frontend": 3000
    }
}
```

- `python_path`: Python 可执行文件路径（如 `D:/conda/envs/zyx/python.exe`）
- `opencode_path`: OpenCode CLI 路径（如 `D:/Program Files/OpenCode/opencode-cli.exe`）
- `ports`: 各服务端口

### 2. 启动系统

```bash
python start.py
```

脚本会自动：
1. 检查 Python 和 OpenCode 是否可用
2. 检查依赖是否安装（未安装会提示安装）
3. 清理被占用的端口
4. 启动所有服务
5. 打开浏览器

### 3. 注册用户

打开 http://127.0.0.1:3000，点击"注册"标签注册账号。

### 4. 管理员审核

```bash
python admin_tool.py
```

管理员账号：`admin` / `xyz2026`

## 项目结构

```
AssistantAgent/
├── start.py                # 启动脚本
├── config.json             # 配置文件
├── requirements.txt        # 依赖列表
├── auth_proxy.py           # 认证代理服务
├── admin_tool.py           # 管理员工具
├── admin_auth.json         # 管理员配置
├── opencode.json           # OpenCode 模型配置
├── users.db                # SQLite 数据库
├── README.md               # 本文档
├── frontend/
│   └── index.html          # 前端页面
├── mcp_server/             # MCP 服务器
├── skills/                 # 技能库
└── .opencode/              # OpenCode 配置
```

## API 端点

### 用户 API

| 端点 | 方法 | 说明 |
|------|------|------|
| `/api/auth/register` | POST | 注册 |
| `/api/auth/login` | POST | 登录 |
| `/api/sessions` | GET/POST | 会话管理 |
| `/api/proxy/*` | * | 代理到 OpenCode |
    
### 管理员 API

| 端点 | 方法 | 说明 |
|------|------|------|
| `/api/admin/users` | GET | 列出用户 |
| `/api/admin/users/<id>/approve` | POST | 批准用户 |
| `/api/admin/users/<id>/reject` | POST | 拒绝用户 |

## 常见问题

### Q: 如何修改管理员密码？

编辑 `admin_auth.json` 文件。

### Q: 如何添加模型？

编辑 `opencode.json` 文件，在 `provider` 中添加新的模型配置。

### Q: 端口被占用怎么办？

启动脚本会自动清理被占用的端口，或者手动修改 `config.json` 中的端口配置。

公网url：https://nonamendable-teresia-supersacerdotal.ngrok-free.dev/