安装前先看这几项
- 配置资料
- 配置资料完整
- 配置难度
- 中等
- 适合新手
- 建议具备相关经验
- 兼容状态
- 声明兼容,尚未实测
- 验证状态
- 源码已审阅,未标记运行实测
本页目录(9)
按照固定来源完成安装、配置与验证
教程包含独立 Profile、精确安装目标、配置证据、最小验证任务、回退和数据清理。
这个插件能做什么
ark-plan-api 0.1.0 在 DSH 原生模型选择器注册火山方舟 Agent Plan、Coding Plan 与后付费模型路由。
需要多 Agent、工作流、编排能力的用户。
该插件涉及较高配置难度或敏感权限,不建议在生产工作区直接试装。
安装前准备
- 方舟测试账号与套餐(必需):确认中国区或 BytePlus 区域、套餐类型、额度和计费。
- 最小权限测试 Key(必需):单独创建可撤销的低额度凭据,不使用生产 Key。
如何安装 ark-plan-api
下面的命令使用本站核验的 DSH 基线,并锁定插件版本或 Git commit,避免默认分支变化导致安装内容漂移。本站已核对安装目标,但尚未在你的系统和 Profile 中实际执行。
- 安装到
webProfile- DSH 基线
0.1.1-rc.2- 安装来源
- GitHub 精确子目录
- 固定目标
@volcengine/ark-plan-api@0.1.0
- 01检查 Node.js 与 pnpm
DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上,并且
pnpm必须已在 PATH 中。先运行:环境检查node --version && pnpm --version - 02安装到 Web Profile
这条命令会把插件加入
webProfile,并在插件声明 DSH Bundle 时自动加入配置层。GitHub 精确子目录npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add @volcengine/ark-plan-api@0.1.0 - 03如遇构建脚本拦截
GitHub 源码插件可能通过
prepare构建。pnpm 10 及以上会先阻止未授权构建;只把终端明确提示的包名加入该 Profile 的pnpm-workspace.yaml中allowBuilds,审阅脚本后再重复上一步,不要使用全局放行。 - 04确认 Bundle 已进入配置
安装成功后先导出组合配置,不启动 Agent。输出中应能找到包名 @volcengine/ark-plan-api或对应 Bundle 层。
检查配置npx --yes @deepseek-ai/dsh@0.1.1-rc.2 --profile web --dump-config - 05启动并完成最小验证
启动 Web Profile 后,只测试一个与插件功能直接相关的最小任务,并检查日志、文件、网络和凭据访问是否符合预期。
启动 DSH Webnpx --yes @deepseek-ai/dsh@0.1.1-rc.2 web
测试不通过时先停止 DSH,再从同一 Profile 移除插件。移除后重新运行配置检查,确认对应 Bundle 层已经消失;插件自己创建的数据和外部账号配置可能需要另行清理。
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web remove @volcengine/ark-plan-api插件专属配置
DSH 设置 → Models- 选择 Agent Plan、Coding Plan 或后付费路由并绑定对应凭据。
环境变量
ARK_AGENT_PLAN_CN_API_KEY· 可选 · 敏感- 中国区 Agent Plan Key。
ARK_CODING_PLAN_CN_API_KEY· 可选 · 敏感- 中国区 Coding Plan Key。
ARK_CODING_PLAN_BYTEPLUS_API_KEY· 可选 · 敏感- BytePlus Coding Plan Key。
ARK_CN_API_KEY· 可选 · 敏感- 中国区后付费模型 Key。
ARK_BYTEPLUS_API_KEY· 可选 · 敏感- BytePlus 后付费模型 Key。
只设置实际使用的一种测试 Key · bash。示例中的账号、路径和凭据占位符必须替换,不要提交真实密钥。
export ARK_CODING_PLAN_CN_API_KEY="<TEST_API_KEY>"- 只设置与所选区域和套餐匹配的一种测试 Key。
- 重启 DSH Web,在模型选择器中选择对应方舟路由。
配置检查与成功结果
- 01导出组合配置并确认 @volcengine/ark-plan-api@0.1.0 已加载。
期望结果:模型路由出现,但输出中不包含 Key 值。
- 02发送一句不含秘密的最小提示并检查方舟账单。
期望结果:返回模型响应或明确认证错误,额度变化符合所选套餐。
第一次使用建议这样验证
- 让所选方舟模型只回答“连接成功”,不要附加文件、工具结果或图片。
它可能接触哪些数据和能力
读取多种 ARK API Key,并把提示词、工具内容和图片发送到火山方舟中国区或 BytePlus Anthropic 兼容端点;不同套餐 Key、区域和计费边界必须分开。
数据存储:提示词、工具内容和可选图片会发送到所选 Volcengine/BytePlus 方舟端点;凭据保存在本机环境或 DSH 凭据系统。
请注意:“源码已审阅”说明本站检查到的证据范围,不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。
故障排查与数据清理
- 401 或 403
- 核对区域、套餐与变量名,不要在中国区和 BytePlus Key 之间混用。
- 出现意外计费
- 立即撤销 Key,检查是否误选后付费路由并在方舟控制台设置额度告警。
- 从 web Profile 移除 @volcengine/ark-plan-api@0.1.0 并重启。
- 撤销测试 Key,检查方舟控制台没有遗留异常用量或按量路由。
深入审计:兼容性、数据流与来源
兼容性与审阅记录
兼容性说明
作者资料声明 DeepSeek Harness >=0.1.0,包清单以 Cordis Patch 注册模型路由但未声明 DSH peer;固定提交与 npm 精确包静态审阅未使用真实方舟账户。
数据流
DSH 模型请求、系统提示、工具内容与可选图片 → llm-pi-ai 路由 → Volcengine/BytePlus 方舟端点 → 模型流式结果返回 DSH;凭据由本机环境或 DSH 凭据系统提供。
源码审阅结论
已审阅固定提交中的 package、Cordis Patch、README 和 npm 0.1.0 精确包。该插件主要是模型路由配置,不会替用户开通套餐;Key 名称对应不同中国区/BytePlus 与套餐,配错可能产生认证失败或按量计费。只用测试 Key、最低额度和非敏感提示验证;本站未调用服务或验证账单。
来源与维护信息
本页根据固定提交的仓库、包清单和本站审阅资料生成。版本变化后,请重新核对作者说明。
- 来源快照
08bc6bb37dc9- 固定提交
006fac0755e8- 许可证
- MIT
- 主要语言
- YAML
- 中文资料
- 有完整中文配置资料