前言¶

在 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