yml2213
230d6c1918
移除服务器浏览器方案（容器/Xvfb/noVNC/CDP 会话管理），后端仅下发 兑换材料；新增内置 Chrome/Edge 扩展一键写入 huya.com 登录态， 未安装扩展时回退控制台脚本手动注入，兑换始终由用户手动完成。
3.3 KiB
3.3 KiB
虎牙浏览器兑换（本机浏览器）
人工兑换在操作者自己的 Chrome/Edge 中完成：后端下发目标页地址和登录材料，登录态自动（扩展）或手动（控制台脚本）写入本机浏览器，兑换本身始终由人工点击，服务端不托管任何浏览器会话。
一键自动注入（推荐）：安装内置扩展
项目自带 Chrome/Edge 扩展 web/extension/huya-exchange-helper/，安装一次后即可自动注入：
- 打开扩展管理页：Chrome 为
chrome://extensions，Edge 为edge://extensions。 - 开启「开发者模式」，点击「加载已解压的扩展程序」，选择仓库目录
web/extension/huya-exchange-helper。 - 刷新后台页面（扩展的内容脚本需要对当前页生效）。
之后的流程：
- 点击账号行的浏览器图标 → 后端返回兑换材料 → 扩展自动把该账号 Cookie 写入
.huya.com域并在新标签页打开已登录的兑换页。 - 确认页面右上角账号无误后，手动完成兑换。
- 回到后台点击「完成」。
扩展只在注入时覆盖与登录态同名的旧 Cookie，其余虎牙 Cookie 不动；扩展图标点击可作为兜底（读取当前后台页签留存的材料）；未检测到材料时图标会显示「无任务」角标。
手动方式（未装扩展时的兜底）
- 点击账号行的浏览器图标，弹出「浏览器兑换」窗口。
- 点击「打开兑换页面」在新标签页打开兑换活动页（地址来自配置的
room_pid，未配置时回落到活动页https://zt.huya.com/b02faae1/pc/index.html）。 - 点击「复制登录脚本」，在兑换页面按
F12打开控制台，粘贴脚本并回车执行。Chrome/Edge 首次粘贴需先手动输入allow pasting再回车。脚本把该账号 Cookie 写入.huya.com域并自动跳转。 - 确认登录态正确后完成兑换，回到系统点击「完成」。
没有控制台操作习惯时，可安装 Cookie-editor 类扩展，使用「复制 Cookie 字符串」在 .huya.com 域下导入。
接口
POST /api/huya/accounts/{account_id}/browser-exchange（权限 huya:task）返回：
{
"account_id": 1,
"username": "xxx",
"target_url": "https://...",
"cookie_string": "yyuid=...; ...",
"cookie_script": "(function(){...})();"
}
- 脚本由
core.huya.cookie_utils.browser_login_script生成：Cookie 以 JSON 数组内联（自动转义），逐条document.cookie写入domain=.huya.com; path=/，有效期 180 天，最后跳转目标页。 - 扩展注入走同一条接口：前端解析
cookie_string后通过 DOM 事件交给扩展，由chrome.cookiesAPI 写入。 - 服务端不保存任何会话状态。
安全说明
- 接口受
huya:task权限与账号可见范围约束；脚本、Cookie 字符串与扩展注入等同账号凭证，仅在授权用户点击时下发。 - 登录态只写入操作者自己的浏览器，不会在服务器留存浏览器进程或 Profile。
- 扩展为内部工具，通过开发者模式加载；其内容脚本在所有页面注入通信桥（manifest
<all_urls>），但只响应本后台页面派发的固定事件，且只写huya.com域的 Cookie。 - 请勿把脚本、Cookie 或扩展转给无关人员；如需共享操作，建议使用系统的账号授权机制而非转发凭证。