dsh-volcengine-provider
v0.2.16
Published
火山方舟 Agent Plan 与 Coding Plan:OAuth 登录、账号、模型与额度管理。
Maintainers
Readme
火山方舟 Provider
在 DeepSeek Harness 中接入火山方舟 Agent Plan 与 Coding Plan。
账号管理、官方 CLI 两段式登录、模型同步和套餐额度,集中在一个设置页面。
快速开始
安装最新版本:
dsh plugin --profile web add dsh-volcengine-providerweb 是示例 Profile,请替换为实际目标;Desktop 使用桌面壳集成的 DSH CLI。也可从 GitHub Actions 或 Releases 下载插件包安装。
- 打开 设置 → 火山方舟 Provider。没有账号时直接点击 生成官方登录链接;已有账号时展开 管理账号,再点击 登录其他账号。
- 确认后设置页展示官方 CLI 输出的登录链接;在任意设备浏览器打开链接完成官方 SSO,复制页面给出的 base64 授权码,回到设置页粘贴提交,由官方 CLI 完成登录。凭据引用接入则使用 新增账号。
- 在账号卡片点击 用于 Agent套餐 / 用于 编程套餐,或在套餐卡片分别选择账号与启停。查看模型列表,按需拉取官方目录、刷新额度。
- 在 DSH 模型选择器中选择对应路由,开始使用。
两段式登录需安装支持 arkcli auth login volc-sso --no-browser 的官方 ArkCli(Windows 1.0.37 已实测)。详细配置见使用说明。
功能介绍
套餐区集中显示额度、重置时间和模型入口;已有账号时可在下方展开账号管理。
真实组件离线预览,使用受控 DSW 主题令牌,账号与额度均为示例数据。另见深色预览与390px 窄屏预览。
两套套餐,分别接入
Agent Plan 与 Coding Plan 各有独立的启用开关、账号选择、模型目录和额度状态,可以同时使用。关闭套餐会保留所选账号和模型配置,重新开启即可恢复。
| 套餐 | DSH 模型路由 | 额度窗口 |
|---|---|---|
| Agent Plan | volcengine-agent-plan | 5 小时、周、月、日,按能力范围分组 |
| Coding Plan | volcengine-coding-plan | 5 小时、周、月 |
账号管理与两段式登录
支持新增、编辑、删除账号,并为两套套餐分别选择账号。登录复用官方 ArkCli OAuth 的 --no-browser 两段式:设置页生成并校验官方登录链接、粘贴授权码,页面提供登录进度、取消和结果提示;授权码只在内存传给 CLI 子进程,不落盘、不进日志。每个账号使用独立的 CLI 身份目录。
已有 API Key 的用户可沿用 DSH 凭据服务或启动环境中的引用名。OAuth 与凭据引用两种方式的配置见账号与凭据。
拉取套餐模型
从官方套餐目录同步可用模型清单,按账号和套餐分别保存。能力参数依据官方 Plan Pi 文档和官方目录固化,显式匹配别名与版本,旧缓存默认值随快照更新,手动覆盖保留;来源与冲突见能力参数。每个模型可独立启停,目录刷新不清空设置;Auto/未知模型保守标记。
设置页和模型选择器使用友好名称,原始调用 ID 可在模型技术详情中查看。模型卡片在名称旁展示消耗倍率与限时折扣,并汇总视觉、思考、上下文和输出能力;倍率来源与 Coding Plan 的参考语义见能力参数。查看模型卡片预览与模型与思考配置预览。
调整模型参数
按账号、套餐和模型管理图片输入、工具调用、上下文长度、默认输出 token、温度及思考档位,支持恢复目录默认值。图片覆盖只影响本地能力声明;工具调用关闭时保留历史记录,但不再允许新的工具调用。当前通道不支持直接传入音频或视频。思考方式与官方资料中的差异见思考参数核对表。
单次请求显式填写的参数优先。温度在启用思考时可能被传输层忽略,最终 token 数还受思考预算与上下文约束。详见模型管理。
查看额度与重置时间
Coding Plan 展示剩余百分比;Agent Plan 同时展示 AFP 已用量、上限和剩余比例。不同能力的额度分组呈现;接口提供重置时间时显示倒计时,未提供时不猜测。支持手动刷新,读取失败时显示具体状态。
使用条件
- DSH Core:
>=0.2.1-rc.4 <0.3.0 || >=0.2.2-rc.1 <0.3.0(已核验宿主:桌面0.2.1-rc.4、手机版0.2.2-rc.1);@earendil-works/pi-ai:>=1.1.0 <2.0.0(已核验1.1.0与1.5.0)。 - Node.js:
>=22.19.0。 - ArkCli:两段式登录需支持
arkcli auth login volc-sso --no-browser;Phase 1 输出、session 接力与 Phase 2 解析已用真实 1.0.37(Windows)核验,真实授权码端到端登录未验收。 - 当前支持国内个人 Agent Plan / Coding Plan。
0.2.14 已发布到 npm latest。已完成隔离测试、目标 Core 加载与离线界面验证;两段式登录的 Phase 1/接力/Phase 2 解析已用真实 ArkCli 1.0.37 核验,真实授权码端到端登录、在线额度、推理调用和生产安装的边界见验证记录。
账号删除仅移除插件元数据,已保存的官方 CLI 身份目录会保留。反馈问题时请提供版本、套餐类型和脱敏错误,凭据、授权码及授权链接请勿提交。
文档与反馈
使用与常见问题 · 开发与发布 · 接口说明 · 提交 Issue
