AioTieba4DotNet

Appearance

吧务相关 ​

这页按常见吧务任务组织。要查完整方法和签名，请同时对照 API 参考。

开始前 ​

  • 下面所有示例都以 client.Admins 为入口。
  • 这类操作基本都需要登录态，也就是 BDUSS 和 STOKEN。
  • 大多数写操作还要求当前账号具备目标贴吧的吧务权限。
  • 贴吧帖子本身的加精、置顶、移动、删帖、恢复等管理动作仍然在 client.Threads；这里聚焦吧务团队、权限、封禁、日志和申诉处理。

读取吧务团队和权限信息 ​

这组接口适合先确认当前贴吧的吧务成员和权限分配，再决定后续写操作。

csharp
using AioTieba4DotNet;

using var client = new TiebaClient("你的BDUSS", "你的STOKEN");

var bawuInfo = await client.Admins.GetBawuInfoAsync("csharp");
var bawuPerm = await client.Admins.GetBawuPermAsync("csharp", "目标用户 portrait");

Console.WriteLine(bawuInfo.Managers.Count);
Console.WriteLine(bawuPerm.Value);

如果你要做权限变更、封禁或解封，建议先走这一步，避免在权限条件不满足时盲目执行写操作。

增加、删除吧务并设置权限 ​

这组接口属于高权限写操作。执行前最好先确认目标用户和目标贴吧都没有弄错。

csharp
using AioTieba4DotNet;
using AioTieba4DotNet.Models;

using var client = new TiebaClient("你的BDUSS", "你的STOKEN");

await client.Admins.AddBawuAsync("csharp", "目标用户名", BawuType.Manager);
await client.Admins.SetBawuPermAsync("csharp", "目标用户 portrait", BawuPermType.All);
await client.Admins.DelBawuAsync("csharp", "目标用户 portrait", BawuType.Manager);

适合吧务团队维护或权限同步场景。AddBawuAsync(...) / DelBawuAsync(...) 管的是角色本身，SetBawuPermAsync(...) 管的是已分配吧务的权限集合。

管理吧务黑名单 ​

这组接口适合做吧务黑名单的读取和增删。

csharp
using AioTieba4DotNet;

using var client = new TiebaClient("你的BDUSS", "你的STOKEN");

var blacklist = await client.Admins.GetBawuBlacklistAsync("csharp");
await client.Admins.AddBawuBlacklistAsync("csharp", 123456789);
await client.Admins.DelBawuBlacklistAsync("csharp", 123456789);

Console.WriteLine(blacklist.Objs.Count);

如果你的目标只是普通用户黑名单，请回到 client.Users；这里的黑名单属于吧务管理范围。

查询删帖日志和用户管理日志 ​

这组接口适合做后台审计、排查误操作，或者回看最近的吧务动作。

csharp
using AioTieba4DotNet;
using AioTieba4DotNet.Models;

using var client = new TiebaClient("你的BDUSS", "你的STOKEN");

var postLogs = await client.Admins.GetBawuPostLogsAsync(
    "csharp",
    new BawuPostLogQueryOptions
    {
        PageNumber = 1
    });

var userLogs = await client.Admins.GetBawuUserLogsAsync(
    "csharp",
    new BawuUserLogQueryOptions
    {
        PageNumber = 1
    });

Console.WriteLine(postLogs.Objs.Count);
Console.WriteLine(userLogs.Objs.Count);

如果你已经知道筛选范围，可以再补充 SearchValue、StartTime、EndTime 或其他查询字段，把日志读取收窄到更具体的管理动作。

查询封禁列表、封禁和解封用户 ​

这组接口适合做封禁维护、人工复核和解封回滚。

csharp
using AioTieba4DotNet;

using var client = new TiebaClient("你的BDUSS", "你的STOKEN");

var blocks = await client.Admins.GetBlocksAsync("csharp");
await client.Admins.BlockAsync("csharp", "目标用户 portrait", day: 1, reason: "示例原因");
await client.Admins.UnblockAsync("csharp", 123456789);

Console.WriteLine(blocks.Objs.Count);

执行 BlockAsync(...) 前，最好先把理由和时长固定好。解封前也建议先确认目标用户和封禁记录对应的是同一个对象。

处理解封申诉 ​

这组接口适合做申诉审核流程。

csharp
using AioTieba4DotNet;

using var client = new TiebaClient("你的BDUSS", "你的STOKEN");

var appeals = await client.Admins.GetUnblockAppealsAsync("csharp");
await client.Admins.HandleUnblockAppealsAsync("csharp", new long[] { 1234567890 }, refuse: false);

Console.WriteLine(appeals.Objs.Count);

refuse: false 表示按通过处理；如果你要拒绝申诉，再显式传 refuse: true。

下一步 ​