Discuz! X5 论坛全功能运营 Skill

1. 适用场景（When to Use）

AI 自动触发条件

• 用户需要登录/登出Discuz! X5论坛账号
• 用户需要发布帖子、回复帖子、评论、引用回复
• 用户需要管理论坛内容（查询帖子、版块、用户数据）
• 用户需要互动操作（点赞、收藏、取消收藏）
• 用户需要用户管理（查询个人信息、积分、好友、活跃用户）
• 用户需要消息管理（系统通知、私信、公共消息）
• 用户需要任务/勋章运营（申请任务、领取奖励、获取勋章）
• 用户需要附件上传（图片/文件上传至论坛）
• 用户需要原生API调用（自定义调用Discuz! X5任意接口）

手动命令触发

/discuz-forum-operation [操作命令] [参数]

2. 输入参数（Inputs）

全局必需参数

• 账号密码：username(论坛用户名)、password(论坛密码)
• 基础配置：base_url(论坛地址，默认https://dzx5.xcxgy.cn/)

分类可选参数

• 内容管理：fid(版块ID)、tid(帖子ID)、pid(回复ID)、subject(标题)、message(内容)
• 互动操作：action(操作类型)、favid(收藏ID)
• 用户管理：uid(用户ID)、limit(数量)、type(排行类型)
• 任务勋章：id(任务ID)、medalid(勋章ID)
• 附件上传：file_path(本地文件路径)

3. 执行步骤（Procedure）

核心执行流程（Agent 固定执行逻辑）

1. 初始化认证
• 自动加载环境变量/用户输入的论坛账号密码
• 调用登录API获取Token，本地缓存Token（有效期2小时）
• 自动获取API签名，处理签名过期/Token过期自动续期

1. 执行目标操作
• 根据用户指令匹配对应API接口
• 校验必填参数，缺失则主动询问用户补充
• 发起API请求，自动处理签名验证、请求加密

1. 结果处理
• 解析API返回数据，格式化输出给用户
• 成功：返回操作结果、ID、数据列表
• 失败：抛出错误信息，引导重试/修正参数

1. 收尾操作
• 支持手动执行登出命令清空Token缓存
• 操作完成后保留登录态，支持连续操作

4. 全量支持 API 清单（Discuz! X5 完整版）

4.1 认证相关

• 登录论坛：/token
• 登出论坛：/deltoken
• 自动续期Token：内置自动逻辑

4.2 内容管理

• 获取全站帖子列表：/domi/threads
• 获取版块帖子列表：/forumdisplay
• 获取帖子详情+回复：/viewthread
• 发布新帖：/post/newthread
• 回复帖子：/post/newreply
• 引用回复：/post/newreply
• 快捷评论：内置封装

4.3 互动操作

• 帖子点赞/取消：/like/thread
• 回复点赞/踩：/like/post
• 添加收藏：/favorite/add
• 取消收藏：/favorite/delete

4.4 用户管理

• 获取当前用户信息：/member/loginInfo
• 查询用户资料：/profile
• 获取活跃用户排行：/domi/active_users
• 查询个人积分：/my/credit
• 获取好友列表：/my/friend/list

4.5 个人内容检索

• 我的发帖：/my/thread
• 我的回复：/my/reply
• 我的收藏：/my/favorite

4.6 消息通知

• 获取系统通知：/notice
• 获取私信列表：/pm/private
• 查看私信详情：/pm/view
• 获取公共消息：/pm/announce
• 查看公共消息内容：/pm/viewg

4.7 任务运营

• 获取任务列表：/task/list
• 申请任务：/task/apply
• 查看任务详情：/task/view
• 领取任务奖励：/task/draw
• 放弃任务：/task/delete
• 查看任务参与人：/task/parter

4.8 勋章运营

• 获取勋章列表：/medal/list
• 领取勋章：/medal/get
• 我的勋章：/medal/my

4.9 附件管理

• 上传图片/文件：/domi/upload

4.10 原生API调用

• 自定义调用任意Discuz! X5接口：raw-api

5. 异常处理（Error Handling）

6. 验证标准（Verification）

操作成功判定规则

1. 认证类：返回有效Token、登录状态正常
2. 内容类：返回帖子ID/回复ID，前端可查询到对应内容
3. 查询类：返回非空数据列表，格式规范
4. 互动类：返回操作成功标识，状态同步更新
5. 上传类：返回附件ID(AID)和访问URL
6. API调用：返回ret=0，无错误信息

7. 使用示例（Examples）

7.1 触发语句

• 帮我登录Discuz论坛，账号admin，密码123456
• 发布一个帖子到版块2，标题：运营公告，内容：欢迎新用户
• 查询我的论坛积分和发帖数量
• 上传图片到论坛版块2
• 查看论坛任务列表并领取任务1

7.2 命令调用

# 登录
/discuz-forum-operation login --username admin --password 123456

# 发布帖子
/discuz-forum-operation post-thread --fid 2 --subject "测试帖子" --message "这是测试内容"

# 查询个人信息
/discuz-forum-operation get-user-info