thu-tok-auto（THU Tok Auto）

DSH / DeepSeek Harness 的 Cordis 插件：一键获取清华大学 MadModel 平台 （madmodel.cs.tsinghua.edu.cn）的最新 API token，自动写入 DSH 模型配置， 并支持到时自动续期。

• Get：立即续期。依次尝试「免登录签发 → SSO 重放 → 复用现有令牌」，成功后 写入 DSH 凭据 MADMODEL_API_KEY 并自动创建/复用模型 Provider llm-pi-ai.providers.madmodel（baseURL 指向 madmodel）。手动点 Get 不会被 "现有令牌还有效"短路：前两条都失败时它会直接打开登录窗口，并把原因显示在 控件上。
• Auto：开关自动续期。开启后每满 1 小时自动触发一次，任务运行在 Host 侧， 与页面是否打开无关。后台不会自己弹出登录窗口，但它会把"续期通道不可用"记进 状态，控件上以警告和悬浮说明呈现，等你去点 Get 登录。
• 计时器：显示「距最近一次 Get 的本地经过时间」hh:mm； 达到 100 小时后显示 Too Long!（表示该去管管了）。 悬停控件可查看状态、上次获取时间、Token 剩余有效期与 Auto 说明。

续期通道（2026-09-29 实测变更）

站点的免登录签发端点 /model-api/auth-login/check 已不再允许无凭证签发 （返回 10001 ticket已过期或无效，请重新登录）；保存的 SSO 会话过期后， /model-api/auth-login 会返回 10003 抱歉哦，您无此权限。插件因此按下面的顺序续期：

1. 免登录签发 —— 站点已关闭，通常直接失败；
2. 活着的登录浏览器 —— 登录窗口（或任何用同一 profile 的调试实例）还在运行时， 从它读回实时 cookie 与 localStorage 里的令牌。这是最可靠的一条；
3. SSO 重放 —— 用保存的 cookie 走一遍统一认证链取 ticket；
4. 复用现有令牌 —— 仍然有效就直接用：控件保持绿灯，不报警；
5. 手动点 Get 刷不出新令牌时打开登录窗口 —— 哪怕手上那枚旧令牌仍可用，因为你点它 就是要刷新，而登录是唯一还能刷新的门；后台 Auto 永远不弹窗，只把"续期通道不可用" 记进状态与悬浮提示。

登录状态是怎么留住的：SSO 的会话 cookie 是会话级的（浏览器进程结束就没了）， 把它复制进文件并不能复活它 —— 所以插件不复制，而是从还活着的浏览器实例里读。 Cookie 按全量保存，请求时按目标 URL 逐跳筛选（域 + 路径 + secure + 未过期）， 跨 id. / oauth. / auth*.tsinghua.edu.cn 与 madmodel 都会带上对应的一份。 由此：登录窗口别关 —— 只要那个实例还在，续期就不需要你再登录；关掉之后， 等这枚令牌到期时再登录一次即可。

• 令牌有效期间控件保持绿色；「续期通道不可用」只在悬浮提示里说明，不常驻警告；
• 登录窗口直接落在清华统一认证登录页 （id.tsinghua.edu.cn，带 ?/authLogin 回调，登录成功会跳回 madmodel）。

默认挂在左侧边栏底部：「设置」按钮上方；若设置上方已有其他插件的按钮 （如 Remote），则置于最顶部按钮的上方。Get/Auto 在左、计时器在右， 与 DSH 主题一致。连「设置」按钮都找不到时暂不显示，并持续重试。

安装

作为 DSH profile bundle（正式 npm 插件）安装，随 profile 声明同步：

dsh plugin --profile web add thu-tok-auto

然后重启 DSH Web（或对应 profile）使插件加载。也可手动在 ~/.dsh/profiles/web/package.json 的 dependencies 与 dsh.profile.bundles 中加入 thu-tok-auto 后重新安装。

更新：

dsh plugin --profile web up thu-tok-auto

使用

1. 安装并重启后，侧边栏底部「设置」上方出现 [●] [Get] [Auto ✓]　hh:mm 控件 （若 Remote 等插件已在设置上方，则排在其最上方；Auto 关闭时按钮显示为 Auto）；
2. 点 Get —— 校园网内直接签发成功，绿点亮起，token 已写入；
3. 点 Auto 开启自动续期：按钮变绿、白字 Auto ✓（再次点击关闭恢复原样）。

校外或凭据失效时的兜底：Get 会自动回退到已保存 SSO 会话；仍无法签发时， 手动点击 Get 会打开 Edge/Chrome 登录窗口，登录完成后自动捕获并继续。 后台 Auto 不会自行弹出登录窗口，只会把状态标记为「需要登录」。

工作原理

获取阶梯（依次尝试）

| 层级 | 方式 | 说明 | | --- | --- | --- | | 1 | GET /model-api/auth-login/check（无凭据） | 校园网内直接签发全新 token（实测可用，免登录） | | 2 | 复用已保存 token | 仅当旧 token 仍被 /model-api/auth-login 校验通过 | | 3 | SSO 重放 | 使用已保存的 id.tsinghua.edu.cn Cookie 走一遍票据流程 | | 4 | 需要登录 | 手动 Get 时打开 Edge/Chrome（CDP 捕获），登录后写入 |

成功签发的 token 会同时写入：

• DSH 凭据：credentials.set('MADMODEL_API_KEY', token)
• DSH 模型配置：查找 baseURL 含 madmodel.cs.tsinghua.edu.cn 的 Provider； 不存在则自动创建 llm-pi-ai.providers.madmodel （api: openai-completions、apiKeyEnv: MADMODEL_API_KEY）。插件只写目标 Provider，不会把其他 Provider 复制成用户层覆盖。

模型列表跟着站点走

站点的模型会改名、下架、换档位（2026-09 就把 DeepSeek-V4-Flash-0731 换成了 DeepSeek-V4.1-Flash，旧名字现在请求直接返回"模型不存在"）。插件不写死这份名单：

• 每次 Get / Auto 签发后，从站点自己的前端包里读它正在用的模型列表 （站点没有模型列表接口，/v1/models 会落回 SPA），转成 provider 的 models 写进去；列表与现有配置一致时不写盘。结果缓存 6 小时，避免每次重复下载几 MB 的包。
• 读不到时回退到代码内置的名单，功能不受影响。
• 排除名单（EXCLUDED_MODEL_IDS）：DeepSeek-V4-Flash-Vision-Exp（V4.1-Flash 已覆盖图片输入）与 DeepSeek-R1-W8A8。
• 注意：既然名单跟着站点走，手动往 provider 里加的模型会在下一次签到时被同步覆盖； 要长期保留请加进代码里的名单。
• contextWindow 统一写 150000，依据是网关的请求体上限而不是模型上限：madmodel 前面的 nginx 是 client_max_body_size 1m，1 MiB 请求体折合约 15–17 万 token （实测 148,442 token 通过、200,000 被 413 拒绝）。写得比这更大，历史涨上来时 整个请求会被网关拒掉（413，不是截断）。

时间语义（实测数据）

• 签发接口（/auth-login/check）发出的 JWT：exp − iat == 6h 整（多次采样）。 站点 API 手册写 5h，是登录签发场景的保守说法；本插件按实测 6h 处理。
• 签发服务的时钟比本地快约 9.6 分钟：JWT 的 iat/exp 不可直接与本地时钟比对。 因此新签发 token 一律以本地时钟记录 lastGetAt = Date.now()。
• 旧 token 仅通过有效性校验而被复用时，不会重置 lastGetAt，避免把剩余寿命 错算成新的 6 小时。
• 显示剩余 = lastGetAt + 6h − now；计时 = now − lastGetAt。
• Auto 间隔 1 小时：不按 token 寿命卡点，每满 1 小时重新签发一次（校园网签发 免费）。假定 6h 寿命只是 JWT 解码结果、不是站点的保证，所以固定间隔比精确卡点 更稳。剩余时间是本地估算，须以服务端校验为准。
• 计时从未获取过/无基准时显示 --:--；超过 99:59 显示 Too Long!。

平台限制（重要）

• 插件以 profile bundle 形式运行在 DSH 宿主进程，UI 通过 DSH 的结构化页面注入表 加载全局脚本：页面刷新（F5）后按钮自动重新出现（不再需要重新激活插件）。
• UI 信息（状态、计时基准）通过 /thu-tok-auto/api/* 每 10 秒轮询更新， 计时器本身在页面本地每秒走字。
• 本机浏览器登录捕获依赖 Edge/Chrome 的 DevTools 调试端口（本机 9333–9343）； 同时识别系统级和当前用户目录下的浏览器安装。

状态与文件

• 状态文件：%USERPROFILE%\.dsh\madmodel\state.json （cookies、ssoCookies、lastGetAt、auto；不再保存 token）。旧版状态中的 token 会迁移到 DSH 凭据存储，并从状态文件移除。
• 登录浏览器配置目录：%USERPROFILE%\.dsh\madmodel\profile\；从本机 CDP 端口 9333–9343 中选择未占用端口，只连接 URL 主机名严格匹配清华域的页面。
• token 只写入 DSH 凭据引用 MADMODEL_API_KEY，不会通过 HTTP 发给浏览器， 也不会出现在任何子进程命令行中。
• 无任何遥测；网络访问仅限 MadModel 与清华统一身份认证域名，以及本机 CDP。

兼容性与验证

• Node.js >= 22（登录捕获使用 Node 内置 WebSocket 与 fetch）；已按 DSH 0.1.2-rc.1 的 profile bundle（dsh.bundle.patch）、settings、credentials、 timer、webServer、connection 与 llm-pi-ai 接口核对。
• npm run check：检查 Host/核心/UI 语法与补丁声明。
• npm test：运行 token 生命周期、Provider 写入、Host Auto、登录捕获与敏感信息 边界回归测试（发布前 prepack 自动执行）。

开发与源码

• GitHub：https://github.com/OverDustD7/thu-tok-auto
• npm：https://www.npmjs.com/package/thu-tok-auto
• 源码结构：
  • lib/core.js —— 核心逻辑（依赖注入，可独立单测）：获取阶梯、凭据/配置写入、 状态迁移、Auto 判据、登录捕获编排；
  • lib/index.js —— Cordis 插件入口：装配真实环境（Node fetch/WebSocket/fs、 DSH settings/credentials/timer/webServer/connection），提供 /thu-tok-auto/api/* 与 UI 注入；
  • lib/ui.js —— 浏览器端全局脚本 UI。

0.2.0 及更早版本为「DSH 会话内动态 Cordis 插件」形态（lib/host.js / lib/client.js）；0.2.1 起改为可直接安装的 profile bundle。行为与状态文件 路径保持一致，切换无需迁移。

License

MIT