ark-plan-api

ark-plan-api 0.1.0 在 DSH 原生模型选择器注册火山方舟 Agent Plan、Coding Plan 与后付费模型路由。

快速判断

安装前先看这几项

配置资料
配置资料完整
配置难度
中等
适合新手
建议具备相关经验
兼容状态
声明兼容,尚未实测
验证状态
源码已审阅,未标记运行实测
本页目录(9)
中文教程

按照固定来源完成安装、配置与验证

教程包含独立 Profile、精确安装目标、配置证据、最小验证任务、回退和数据清理。

查看 ark-plan-api 安装与配置教程 →
功能

这个插件能做什么

ark-plan-api 0.1.0 在 DSH 原生模型选择器注册火山方舟 Agent Plan、Coding Plan 与后付费模型路由。

适合谁

需要多 Agent、工作流、编排能力的用户

使用门槛

该插件涉及较高配置难度或敏感权限,不建议在生产工作区直接试装。

准备

安装前准备

  • 方舟测试账号与套餐(必需)确认中国区或 BytePlus 区域、套餐类型、额度和计费。
  • 最小权限测试 Key(必需)单独创建可撤销的低额度凭据,不使用生产 Key。
安装

如何安装 ark-plan-api

下面的命令使用本站核验的 DSH 基线,并锁定插件版本或 Git commit,避免默认分支变化导致安装内容漂移。本站已核对安装目标,但尚未在你的系统和 Profile 中实际执行。

安装到
web Profile
DSH 基线
0.1.1-rc.2
安装来源
GitHub 精确子目录
固定目标
@volcengine/ark-plan-api@0.1.0
  1. 01
    检查 Node.js 与 pnpm

    DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上,并且 pnpm 必须已在 PATH 中。先运行:

    环境检查
    node --version && pnpm --version
  2. 02
    安装到 Web Profile

    这条命令会把插件加入 web Profile,并在插件声明 DSH Bundle 时自动加入配置层。

    GitHub 精确子目录
    npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add @volcengine/ark-plan-api@0.1.0
  3. 03
    如遇构建脚本拦截

    GitHub 源码插件可能通过 prepare 构建。pnpm 10 及以上会先阻止未授权构建;只把终端明确提示的包名加入该 Profile 的 pnpm-workspace.yamlallowBuilds,审阅脚本后再重复上一步,不要使用全局放行。

  4. 04
    确认 Bundle 已进入配置

    安装成功后先导出组合配置,不启动 Agent。输出中应能找到包名 @volcengine/ark-plan-api或对应 Bundle 层。

    检查配置
    npx --yes @deepseek-ai/dsh@0.1.1-rc.2 --profile web --dump-config
  5. 05
    启动并完成最小验证

    启动 Web Profile 后,只测试一个与插件功能直接相关的最小任务,并检查日志、文件、网络和凭据访问是否符合预期。

    启动 DSH Web
    npx --yes @deepseek-ai/dsh@0.1.1-rc.2 web
卸载与回退

测试不通过时先停止 DSH,再从同一 Profile 移除插件。移除后重新运行配置检查,确认对应 Bundle 层已经消失;插件自己创建的数据和外部账号配置可能需要另行清理。

从 Web Profile 移除
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。示例中的账号、路径和凭据占位符必须替换,不要提交真实密钥。

复制 只设置实际使用的一种测试 Key 配置
export ARK_CODING_PLAN_CN_API_KEY="<TEST_API_KEY>"

核对配置证据外部链接,在新标签页打开

  1. 只设置与所选区域和套餐匹配的一种测试 Key。
  2. 重启 DSH Web,在模型选择器中选择对应方舟路由。
验证

配置检查与成功结果

  1. 01
    导出组合配置并确认 @volcengine/ark-plan-api@0.1.0 已加载。

    期望结果:模型路由出现,但输出中不包含 Key 值。

  2. 02
    发送一句不含秘密的最小提示并检查方舟账单。

    期望结果:返回模型响应或明确认证错误,额度变化符合所选套餐。

使用

第一次使用建议这样验证

  • 让所选方舟模型只回答“连接成功”,不要附加文件、工具结果或图片。
权限

它可能接触哪些数据和能力

使用服务凭据读取本地文件访问外部网络

读取多种 ARK API Key,并把提示词、工具内容和图片发送到火山方舟中国区或 BytePlus Anthropic 兼容端点;不同套餐 Key、区域和计费边界必须分开。

数据存储:提示词、工具内容和可选图片会发送到所选 Volcengine/BytePlus 方舟端点;凭据保存在本机环境或 DSH 凭据系统。

请注意:源码已审阅”说明本站检查到的证据范围,不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

排查

故障排查与数据清理

401 或 403
核对区域、套餐与变量名,不要在中国区和 BytePlus Key 之间混用。
出现意外计费
立即撤销 Key,检查是否误选后付费路由并在方舟控制台设置额度告警。
卸载后的清理步骤
  1. 从 web Profile 移除 @volcengine/ark-plan-api@0.1.0 并重启。
  2. 撤销测试 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
中文资料
有完整中文配置资料