dsh-bupt-ucloud

配置

打开 Web UI 的 设置 → 插件，点开插件列表里的 教学云 / dsh-bupt-ucloud（配置表单就在这个 bundle 自己的页面里，不在「官方插件」区）：

字段	存放位置	说明
学号	配置档（profile）设置段 ucloud.username	统一认证学号
密码	本机凭据库	统一认证密码，不会写入配置文件
验证码识别令牌	本机凭据库	可选；填了就能自动识别验证码，不填则改为人工/视觉识别（见下）

密码与验证码令牌只写不读：页面仅显示「已配置 / 未配置」，保存后再次进入页面也不会回显。

保存后点 测试登录：页面会先保存未提交的改动，再调用 POST /dsh-bupt-ucloud/verify 真正登录一次，并显示姓名与角色（失败时显示平台或网络返回的原因）。 该路由与 /api 一样经过部署自身的浏览器信任检查（ctx.connection.requestRejection）， 检查不可用时以 503 失败关闭，且响应里永远不会出现凭据。

关于验证码：北邮统一认证在部分网络环境/风控下会要求输入验证码。有两种应对方式：

1. 在设置页填 Byrdocs OCR token（ocr.byrdocs.org），之后全自动；
2. 不填也行——插件会把验证码图片存到 $DSH_HOME/ucloud/captcha-.png，模型可以用 read_image 读它（或让你看一眼后把文字告诉模型），再调用 ucloud_login 完成登录。