成员管理 API

成员 CRUD、AI 员工创建、角色分配和密码管理。

成员管理 API

成员管理 API 提供组织内用户和 AI 员工的完整生命周期管理，包括创建、查询、更新、删除以及密码重置。

获取成员列表

GET /api/members

查询参数：

参数	类型	说明
`page`	integer	页码，默认 1
`page_size`	integer	每页数量，默认 20
`keyword`	string	按用户名或昵称搜索
`is_virtual`	boolean	筛选 AI 员工

响应示例：

{
  "items": [
    {
      "id": 1,
      "username": "zhangsan",
      "nickname": "张三",
      "role": "member",
      "is_virtual": false,
      "remote_node_id": null,
      "created_at": "2025-01-15T10:00:00Z"
    }
  ],
  "total": 42,
  "page": 1,
  "page_size": 20
}

创建成员

POST /api/members

请求体：

{
  "username": "ai-worker-01",
  "nickname": "AI 助手",
  "password": "secure-password",
  "role": "member",
  "is_virtual": true,
  "remote_node_id": 3
}

is_virtual：设为 true 表示该成员为 AI 员工，AI 员工不占用人类席位。
remote_node_id：绑定工作电脑节点，仅 AI 员工需要设置。绑定后该 AI 员工将在指定节点上执行任务。

更新成员

PUT /api/members/:id

请求体：

{
  "nickname": "新昵称",
  "role": "admin",
  "remote_node_id": 5
}

仅传入需要修改的字段即可，未传入的字段保持不变。

删除成员

DELETE /api/members/:id

删除成员会同时清理其关联的会话记录和工作分配。此操作不可逆。

重置密码

POST /api/members/:id/reset-password

请求体：

{
  "new_password": "new-secure-password"
}

仅管理员可调用此接口。重置后用户下次登录时需使用新密码。