前言¶
DeepSeek Harness（DSH）采用插件化架构，旨在将功能扩展与核心解耦。在使用火山方舟（Volcano Ark）Coding Plan 订阅时，开发者通常需要在多个模型路由和账号间切换，同时需要实时监控各周期的剩余额度。手动查询既耗时又容易遗漏。dsh-ark-quota 插件将额度监控与 DSH 的会话路由能力结合，在侧栏提供直观的用量展示与预测。
插件简介¶
dsh-ark-quota 是一个由 lordqyxz 维护的 DSH 插件。它的核心作用是在 DeepSeek Harness 的侧栏显示火山方舟订阅套餐的剩余额度。插件通过计算滑窗水位动力学和指数加权最小二乘拟合，提供“燃烧节奏”与耗尽预测，并支持随当前会话模型自动切换关联的火山账号。
核心功能¶
- 侧栏展示与折叠胶囊
插件在侧栏底部生成卡片或折叠胶囊，展示 5 小时、近 1 周和近 1 月的用量条与重置倒计时。最紧急的档位会常驻在折叠胶囊上，悬停即可查看全部信息。 - 燃烧节奏与耗尽预测
针对 5 小时档位，使用滑窗水位动力学计算净增速；针对周/月档位，使用额度进度除以时间进度的平均节奏。插件使用指数加权最小二乘拟合最近燃烧速率，并将预测段直接绘制在进度条上。快照数据通过storageDomain落盘，可跨重启保留。 - 自动切换账号
卡片身份取自 DSH 的llm provider路由。当你在会话中切换模型时，卡片会自动切到对应火山账号的额度信息。你也可以手动固定某一路由。 - 多账号管理
插件支持多账号。它会按路由保存密钥并自动建组；如果多个路由填写同一对 AK/SK，系统会自动合并为一个账号。当未订阅 Coding Plan 时，会自动回落调用 Agent Plan 的GetAFPUsage接口。 - 设置页热加载
在 DSH 设置页的「方舟额度」分区，可以修改 AK/SK。保存后配置即时生效，无需重启。
安装与启用¶
插件遵循 MIT 协议。安装方式如下：
命令行安装：
dsh plugin --profile <profile> add https://github.com/lordqyxz/dsh-ark-quota
设置页安装：
进入 DSH 设置页 → 插件 → 安装，填入：
https://github.com/lordqyxz/dsh-ark-quota
安装完成后，进入「设置」→「方舟额度」分区，选择对应的模型路由，粘贴 AK/SK 并保存。侧栏底部将出现卡片。
典型用法¶
- 在「设置」→「方舟额度」中选择你要监控的模型路由。
- 粘贴该路由对应的火山方舟 AK/SK。
- 保存设置。
- 在 DSH 中创建会话并切换模型，观察侧栏卡片是否随模型自动切换。
若需在本地校验密钥（不经过浏览器环境），可使用：
ARK_AK=… ARK_SK=… node tools/check.mjs
注意事项与要求¶
- 版本要求：需要 DeepSeek Harness 的
dsh web环境，版本需为 0.2.0-rc.1 或 0.2.0-rc.2。 - 账号要求：需拥有火山方舟的订阅及一对有效的 API 访问密钥（AK/SK）。
- 安全提醒：AK/SK 是真实凭据。插件在 schema 中将密钥声明为
role('secret')，设置界面只写不读。请勿将密钥提交至 Git 仓库或发送给他人。
结语¶
dsh-ark-quota 通过侧栏小组件和算法预测，简化了火山方舟订阅额度的管理流程。它解决了多模型路由下的账号切换与额度监控问题，适合需要频繁调用不同模型且对成本敏感的开发者。
- 项目主页：https://github.com/lordqyxz/dsh-ark-quota
- 生态目录：https://www.skillhub.cn/plugins/lordqyxz/dsh-ark-quota
