前言¶
在 DeepSeek Harness（DSH）里接外部模型，通常要在 profile 里手写 provider、baseURL 和模型列表；若同时还想看平台侧的余额与用量，往往得另外开浏览器或自己写脚本。同济大学人工智能服务平台（agi.tongji.edu.cn）面向校内用户提供多类对话模型与套餐计费，但和 Harness 之间缺少一条开箱即用的链路。
dsh-tongji-agi 由社区维护者 1Jaron 发布，属于 DSH 生态中的「模型推理」类插件。它做两件事：用 llm-pi-ai 的 tongji provider 暴露 8 个对话模型（OpenAI Chat Completions 协议）；在 Web 客户端设置页与侧边栏展示余额、积分重置时间与用量统计。模型路由与面板彼此独立——只聊天可以只配 API Key，不登录 SSO；只看面板可以走统一身份认证，不配置推理密钥。
插件定位¶
包名 dsh-tongji-agi，当前 npm 版本为 1.1.0，许可证 MIT，源码仓库 github.com/1Jaron/dsh-tongji-agi。启用后通过 cordis.patch.yml 向宿主注入 bundle patch，并在 Web 端加载 lib/client.js（dsh.client.platform 为 web）。宿主要求 Node ^22.19.0 || >=24.0.0。
核心功能¶
模型路由¶
默认启用 OpenAI Chat Completions：POST /v1/chat/completions，baseURL 为 https://agi.tongji.edu.cn/v1，route 名 tongji。cordis.patch.yml 里还预留了 OpenAI Responses 与 Anthropic Compatible 端点，取消注释并合并到同一份 providers 映射后可按需启用；三种端点共用同一把 API Key。
patch 中列出的 8 个对话模型（与 GET /v1/models 返回的 id 需一字不差）包括：DeepSeek-V4.1-Flash（默认）、GLM-5.3、GLM-5.3-Flash、Qwen3.8-Flash-Next、Qwen3.8-27B、MiniMax-M3.1-Flash、MiMo-V2.6-Pro、MiMo-V2.6-Flash。各模型在 patch 中配置了 contextWindow: 65536、maxTokens: 8192、input: [text]。
余额与用量面板¶
设置页新增「同济AGI」分区：API Key 配置引导、余额、套餐重置时间、用量统计；支持 SSO 登录（含部分账号的短信二次认证）。数据通过平台 REST 接口拉取，例如余额 GET /api/v1/billing/overview，用量统计 GET /api/v1/my-usage/stats?kind=plan&range=7d 等。
左侧栏底部注册 sidebar.footer.action 槽位（tongji-balance-rail），可在 设置 → 同济AGI → 侧边栏显示 中勾选积分余额、重置时间、今日 Token、今日调用、模型占比等字段；选项保存在浏览器 localStorage。
安装与启用¶
从 npm 安装（推荐）¶
在 DSH 设置 → 插件 → 添加插件 中输入包名 dsh-tongji-agi，选择 npm 官方源。安装后点击「立即启用」，再到 设置 → 模型 → 同济 AGI → 编辑 填入 API Key。
从 GitHub 安装¶
在 设置 → 插件 → 安装 中填写：
github:1Jaron/dsh-tongji-agi
或与下列写法等价：
https://github.com/1Jaron/dsh-tongji-agi
安装前确认本机可执行 git --version；DSH 不捆绑 git，插件管理器会先 git ls-remote 探测连通性。国内直连 GitHub 失败时，GitHub 地址不经过「改用国内镜像」选项，需为 git 配置代理或改用本地 link: 方式。本包无构建脚本，不会触发 pnpm 的脚本许可重试流程。
加载效果¶
启用后：模型选择器出现「同济 AGI」下的 8 个模型；设置页出现「同济AGI」分区；侧边栏底部可显示积分摘要。修改 index.js 后需重启 Harness；lib/client.js 由 client-hmr 热载。
密钥与凭据¶
- 在 同济 AI 平台 API Key 页面 创建或复制 Key。
- 在 DSH 设置 → 模型 → 同济 AGI → 编辑 保存「API 密钥」。
- 在会话模型选择器里选用同济 AGI 模型。
cordis.patch.yml 中的 apiKeyEnv: TONGJI_API_KEY 为引用名。解析顺序：托管凭据库 $DSH_HOME/.credentials.yaml → 进程环境变量 → .env。未配置时请求失败并报宿主侧的 MISSING_CREDENTIAL。
也可写入凭据库或环境变量：
# $DSH_HOME/.credentials.yaml
TONGJI_API_KEY: sk-...
查看余额与用量时，在 设置 → 同济AGI → 账号设置 使用统一身份认证登录；账号凭据以 kind: 'grant' 形式存入宿主凭据库，不落盘到明文配置。
典型用法¶
仅使用模型推理： 完成 npm 或 GitHub 安装并启用 → 配置 TONGJI_API_KEY → 在对话中选 DeepSeek-V4.1-Flash 或其他列出的模型即可发往 https://agi.tongji.edu.cn/v1/chat/completions。
同时使用侧边栏用量： 在「同济AGI」分区登录 SSO；若触发短信增强认证，在面板输入验证码（远程方法 submitCode / resendCode）。登录成功后余额先展示，用量在后台刷新；可点「刷新统计」强制更新。
适用场景与注意¶
适合已在同济 AI 平台开通套餐、希望在 DSH 统一界面里选型对话模型并顺带查看点数或订阅余额的开发者。插件以当前 DSH 进程权限运行，安装前建议阅读仓库源码与 MIT 许可证，确认网络出站与凭据存储方式符合本机策略。
常见错误需区分：MISSING_CREDENTIAL 为本地未配 Key；403 API密钥不存在 为 Key 错误；403 {"message":"当前网络环境不支持"} 为平台 IP 网段白名单（例如部分校园无线经 CGNAT 出口不在备案网段内），需 VPN、换网络或联系管理员加网段，插件无法绕过。
平台文档提及但实测不可用的模型（如 DeepSeek-R1）会返回 400 Invalid model，新增模型 id 必须与 GET /v1/models 完全一致。
DSH 采用「一切皆插件」的扩展方式；社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-tongji-agi 把同济 AGI 的对话模型路由与计费面板收进 Harness 一处：推理走标准 Chat Completions，运维信息走 SSO 与平台 billing API。需要安装说明与网络排查细节时，以 GitHub README 为准。
- 目录页：https://www.skillhub.cn/plugins/1Jaron/dsh-tongji-agi
- 源码与文档：https://github.com/1Jaron/dsh-tongji-agi
