前言¶

在 DeepSeek Harness（DSH）里使用清华算力平台（easycompute.cs.tsinghua.edu.cn）上的 Paratera 模型时，通常要分开处理几件事：用清华统一身份认证（id.tsinghua.edu.cn）维持浏览器会话、在平台上查看算力券余额、到控制台创建或轮换 API 密钥，再把模型和参数写进 DSH 的 provider 配置。这些步骤彼此独立，也容易在会话过期或密钥变更时脱节。

dsh-tsinghua-paratera 是社区维护的非官方 DSH 插件，把上述环节收进 DSH 的设置页与输入栏。下面介绍它的定位、能力与安装用法；事实以仓库 README 与发布说明为准。

这是什么¶

• 名称：DSH 清华算力 · Paratera（npm 包名 dsh-tsinghua-paratera）
• 维护者：MsCutey
• 目录页：skillhub.cn/plugins/MsCutey/dsh-tsinghua-paratera
• 源码：github.com/MsCutey/dsh-tsinghua-paratera
• 当前修复版版本：1.0.5-windows.2（基于上游 1.0.4 功能线；许可证 MIT）

插件不隶属于清华大学、Paratera 或 DeepSeek。DSH 生态主张「一切皆插件」；SkillHub 等目录是社区站点，与 DeepSeek / 幻方无官方从属关系。本插件从 GitHub Releases 下载源码 ZIP 或插件 TGZ 后，用仓库自带的 install.mjs 挂到已初始化的 DSH desktop profile，而不是通过 dsh plugin add github:... 一类全局命令安装。

适用范围：仅适用于通过 id.tsinghua.edu.cn 登录的清华算力平台账号。Paratera 官方账号或其他高校、企业的 Paratera 接入不在支持范围内。

核心功能¶

资料中明确列出的能力如下。

登录、会话与余额¶

• 专用 Chrome 会话完成登录与续期，不使用日常 Chrome profile。
• 可选将登录密码存入系统凭据库：macOS Keychain / Windows 当前用户 DPAPI。
• 支持短信、企业微信二次认证；验证码由用户在界面输入；信任浏览器默认关闭。
• 输入栏在当前供应商为 paratera 时显示算力券余额（数据来自平台 couponFree）；设置页同时展示余额与会话状态。余额不是账单或实时结算保证。

控制台 API 密钥¶

• 在 DSH 内列出、新建、改名、启停、删除密钥，并将所选密钥导入 DSH。
• 设置页只显示密钥的 SHA-256 摘要指纹，不返回完整 API 密钥字符串。
• 密钥导入前会先验证模型列表，不发送计费的模型推理；覆盖旧密钥前由 DSH 备份。
• 1.0.5-windows.2 修正了相对上游的认证算法差异（SHA-256 → 与官网一致的 SparkMD5/MD5），并完成真实新建→删除密钥的验收说明（见仓库 docs/KEY-MANAGEMENT.md）。

模型导入与参数¶

• 导入 Paratera 模型，并调整名称、上下文长度、最大输出、文本/图片输入类型、思考挡位等；变更通过 DSH Settings 即时生效。
• 新模型默认思考挡位为 low / high / max。平台模型广场与公开目录仅用于生成推荐值，实际路由上限需按目标模型自行验证。

诊断与可选后台续期¶

• 提供宿主兼容性诊断。
• 后台续期为可选功能，安装时默认不注册；需要时再通过安装脚本注册计划任务（Windows）或 LaunchAgent（Mac），约每 6 小时检查一次。

环境要求¶

上游在 Apple Silicon Mac 上做过实机验证；1.0.5-windows.2 在 Windows 上验证了隔离 profile 下的 pnpm 安装/卸载及宿主 SDK。诊断兼容区间不代表每个 DSH 版本都逐一实测。

安装与启用¶

从 GitHub Releases 下载并解压到长期保留的目录，然后执行安装脚本。安装器会备份 profile 清单、追加本地链接和 bundle，重复执行不会重复追加。

macOS / Linux 终端（先预览再安装、最后校验）：

cd /path/to/dsh-tsinghua-paratera
node scripts/install.mjs --dry-run
node scripts/install.mjs
node scripts/install.mjs --verify

未单独安装 Node 时，可使用 DSH 内置运行时，例如 macOS：

"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/primary-runtime/dependencies/node/bin/node" scripts/install.mjs

Windows PowerShell（默认入口仅预览；-Action Install 执行安装）：

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\windows.ps1
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\windows.ps1 -Action Install

Windows 上也可把安装目录中 resources\runtime\primary-runtime\dependencies\node\bin\node.exe 加入 PATH，或显式调用该 node.exe 运行 scripts/install.mjs。

可选参数：--dsh-home DIR、--profile NAME；环境变量 DSH_PNPM 可指定 pnpm.cjs。安装成功后需完全退出并重开 DSH。

插件以当前 DSH 进程权限运行；安装前应阅读源码、LICENSE 及 PRIVACY.md / SECURITY.md，自行判断是否与使用环境匹配。

典型用法¶

账号登录与查看余额¶

打开 DSH「设置 → 清华算力余额 → 账号登录」。

1. 选择「重新登录」，在专用 Chrome 窗口完成清华统一身份认证，回到 DSH 刷新。
2. 若需自动登录，可选「保存凭据」，在系统原生窗口输入密码；保存关闭后会尝试登录。
3. 二次认证时自行选择接收渠道并输入验证码；默认不把浏览器设为长期可信。
4. 在「模型」中选择已导入的 Paratera 模型后，输入栏模型名称旁会显示余额。

手动登录不会由插件保存登录密码，但浏览器会话与短期 token 仍保存在本机。验证码和密码不要粘贴到对话或工单中。

导入密钥与模型¶

完成平台登录后：「连接控制台 → 加载密钥 → 导入」。

• 「导入并添加」：保存所选密钥并追加所选模型。
• 「仅保存密钥」：只保存密钥，不添加模型。

删除密钥会影响使用该密钥的应用；新建或删除结果不确定时，应先刷新或按名称核实，避免重复操作。创建密钥不等于购买订阅，后续调用仍受平台计费规则约束。

注册后台续期（可选）¶

node scripts/install.mjs --task

遇到二次认证时，后台任务会结束当次检查，需回到 DSH 完成认证。自定义 DSH_HOME 会使用独立的浏览器目录与任务名称。

卸载与本地数据¶

node scripts/install.mjs --uninstall              # 同时移除已导入的模型与会话
node scripts/install.mjs --uninstall --keep-data  # 只摘除插件，保留模型与会话
node scripts/install.mjs --uninstall --purge-profile  # 另外删除专用 Chrome profile

卸载会从 profile 清单移除依赖、按 cordis.patch.yml 清理写入的 paratera provider（改动前自动备份），并删除会话状态文件等。删除 provider 不会撤销平台上的 API 密钥；宿主持有的 PARATERA_API_KEY 等需另行确认。请先手动退出 DSH、专用 Chrome 和凭据窗口。Windows 细节见仓库 docs/WINDOWS.md。

适用场景与注意¶

适合谁：已在清华算力平台使用 Paratera 路由、并在 DSH 中希望用图形化方式完成 SSO 登录、看算力券余额、管理控制台密钥与模型参数的 macOS / Windows 用户。

不适合谁：非 id.tsinghua.edu.cn 登录路径的 Paratera 账号；无法在本机安装 Google Chrome 或无法满足 Node / DSH 版本要求的环境。

安全与隐私：插件 README 写明不含遥测或分析服务代码；联网行为还受 DSH 与 Chrome 自身设置影响。本机 bearer token 缓存不等于硬件隔离；勿在不可信共享系统上保存密码或长期敞开登录窗口。问题反馈只需版本号、错误码与复现步骤，不要上传密码、完整 API 密钥或会话文件。

结尾¶

dsh-tsinghua-paratera 把清华算力 SSO、算力券余额展示、Paratera 控制台密钥与模型配置收进 DSH，适合已在该路径上使用 Paratera 的开发者做日常联调。安装与行为以仓库文档为准。

• 目录页：https://www.skillhub.cn/plugins/MsCutey/dsh-tsinghua-paratera
• GitHub：https://github.com/MsCutey/dsh-tsinghua-paratera