前言¶

在 DeepSeek Harness（DSH）裏做智能體或日常開發時，若同時使用同濟大學 AGI 平臺（agi.tongji.edu.cn），積分餘額往往要單獨打開網頁或登錄統一身份認證才能看到。小鯨魚掛件（dsh-whale-widget）可以聚合多家 API 的餘額，但同濟 AGI 並不在官方列表裏。下面介紹社區插件 tongji-agi-credit（倉庫 Rccccc6/Tongji-AGI-Credit），它用官方接口拉取積分，提供獨立面板，並可一鍵接到小鯨魚；賬密只加密存在本插件目錄，不交給第三方。

這是什麼¶

Tongji AGI Credit 是 DSH 客戶端類插件，維護者爲 Rccccc6，當前版本 v0.3.0（MIT）。數據來源爲同濟 AGI 官方 API（agi.tongji.edu.cn/api/v1/*），需以你的學號與統一身份認證密碼登錄 iam.tongji.edu.cn 後才能讀取積分。插件對外提供進程內服務、本機迴環 HTTP 與面板 UI；已適配 dsh-whale-widget@0.4.2，不影響鯨魚裏 DeepSeek 官方餘額及其他廠商 API 賬本。

社區目錄頁：SkillHub - Tongji AGI Credit（獨立站點，與 DeepSeek / 幻方無官方從屬關係）。

核心功能¶

經 README 覈實，插件主要能力如下。

本地迴環 HTTP 默認從端口 47821 起監聽 127.0.0.1，僅 GET，需 Authorization: Bearer <token>（token 位於 <插件目錄>/.vault/bridge.token）。其他 DSH 插件可通過進程內服務名 tongjiAgiCredit 調用 getSnapshot()、refresh() 等。

安裝與啓用¶

兼容性（聲明於 engines）：DSH >= 0.2.0 < 0.3.0；Node ^22.19 || >= 24（跟隨 DSH 運行時）。不滿足 DSH 版本時宿主會拒絕加載並提示 allow-version。

安裝順序以 README 爲準，先做本插件，再確認小鯨魚，最後重啓 DSH。

1、安裝本插件（二選一）：

# 從本地 tgz 安裝
dsh plugin --profile desktop add C:/path/to/Tongji-AGI-Credit-0.3.0.tgz
# 或從源碼目錄安裝（改代碼重啓即生效）
dsh plugin --profile desktop add link:C:/path/to/Tongji-AGI-Credit

2、安裝或確認已裝小鯨魚掛件：

dsh plugin --profile desktop add dsh-whale-widget@0.4.2

3、重啓 DSH（必須）。

4、點左下角「濟」，填寫學號與統一身份認證密碼並保存；面板頂部應出現剩餘積分。

5、若要接到小鯨魚：面板右側「配置 ⚙️」→「插件接入」→ 一鍵接入，再 重啓 DSH，在小鯨魚中檢查是否出現「同濟AGI」。

可選配置寫在 cordis.patch.yml 的 insert 裏，例如：

- insert:
    - id: tongji-agi-credit
      name: tongji-agi-credit
      config:
        modelName: 同濟AGI
        renewAheadMinutes: 30

典型用法¶

面板與控制台

• 單擊「濟」開/關面板；勾選「隱藏圖標」可隱藏按鈕（每次啓動 DSH 默認仍顯示）。
• 控制台可執行 window.__TAC_OPEN__() 直接打開面板。

小鯨魚按壓泡泡

重啓 DSH 後，打開小鯨魚「按壓泡泡設置」，可選：

• 餘額·同濟AGI — 剩餘積分（無單位）；
• 今日已用·同濟AGI — 今日消耗積分。

本機程序讀餘額

GET http://127.0.0.1:47821/tac/v1/balance
GET http://127.0.0.1:47821/tac/v1/today
Authorization: Bearer <token>

其他 DSH 插件進程內調用

const tac = ctx.get('tongjiAgiCredit')
await tac.getSnapshot()
await tac.refresh()
await tac.getTodayUsage()
tac.status()

排障（README 摘要）

• 掛件無「同濟AGI」：面板 解除關聯 → 再 一鍵接入 → 重啓 DSH。
• 掛件顯示 --：先確認面板能取到積分；再等鯨魚輪詢（約 60 秒）或重啓。
• 面板取不到積分：確認能在 iam.tongji.edu.cn 登錄且網絡可達 agi.tongji.edu.cn；偶發圖形驗證碼或增強認證按面板提示處理。

清除數據：「解除關聯」只回滾鯨魚；「清除個人信息」會刪除整個金庫。建議先解除關聯再卸載，避免鯨魚側殘留配置。

適用場景與注意¶

適合誰：在同濟大學 AGI 平臺有賬號、已在用 DSH 桌面 profile，並希望在本機聚合查看積分或接到小鯨魚掛件的開發者與學生用戶。

隱私與安全（插件自述）

• 插件必須以你的身份登錄才能讀積分，因此需要學號與統一身份認證密碼；僅訪問 iam.tongji.edu.cn 與 agi.tongji.edu.cn，不向第三方上報。
• 鯨魚側只拿到佔位密鑰 TONGJI_AGI_TAC_KEY 與本機迴環 URL，拿不到你的個人信息。
• Windows 上優先使用 DPAPI / Electron safeStorage；其他平臺退到 AES-256-GCM。

安裝前請知悉

• 插件以 當前 DSH 進程權限 運行，安裝前應自行查看 GitHub 源碼 與 MIT 許可證，確認可接受賬密本地加密存儲與登錄行爲。
• AGI 前端與接口由上游變更時，插件可能需更新 lib/agi-session.mjs；字段缺失時會返回 code:'SHAPE' 而非假數據。
• 已知限制包括：會話按天計、幣種零寬字符依賴鯨魚顯示「無單位」、鯨魚 DOM 結構變化可能影響適配層入口行。

結尾¶

Tongji AGI Credit 把同濟 AGI 積分查看來回環 HTTP 與 DSH 面板裏，並可與小鯨魚掛件聯動，適合不想反覆開網頁查餘額的用戶。詳情與更新以倉庫 README 爲準。

• 目錄頁：https://www.skillhub.cn/plugins/Rccccc6/Tongji-AGI-Credit
• GitHub：https://github.com/Rccccc6/Tongji-AGI-Credit