Discuz! X5 论坛全功能运营

要解决什么问题

运营或自动化脚本经常要在 Discuz! X5 上完成登录、发帖回帖、查版块与用户数据、点赞收藏、私信与任务勋章等操作。官方能力分散在大量 REST 接口里，还要处理 Token、API 签名与过期续期；手写脚本容易在参数缺失或错误码（如 -103 签名过期、-105 Token 无效）上反复踩坑。

技能如何工作

技能把论坛运营收敛成固定流程：初始化认证 → 匹配并调用接口 → 格式化结果 → 保留登录态（也可手动登出清缓存）。

• 认证：用 username、password 与可选 base_url（默认论坛地址）登录 /token，本地缓存 Token（约 2 小时），签名过期或 Token 失效时自动重试或续期。
• 内容：列表与详情（如 /domi/threads、/forumdisplay、/viewthread），发帖 /post/newthread、回复与引用 /post/newreply。
• 互动与用户：点赞、收藏、/member/loginInfo、/profile、积分与好友等。
• 消息与运营：通知、私信、任务申请/领奖、勋章领取、/domi/upload 附件上传。
• 扩展：raw-api 可自定义调用任意 X5 接口；也可用 /discuz-forum-operation 带子命令与参数显式触发。

必填参数缺失时会主动追问；成功判定以返回 ID、可查询内容或 ret=0 等规则为准。

适用边界与注意

• 需要有效论坛账号；部分操作依赖账号权限（如无权限会返回 1004）。
• 默认 base_url 指向资料中的示例站点，对接自有论坛时必须改地址。
• 网络异常仅有限重试，持续失败需自行检查连通性与论坛状态。