前言¶
在 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
