ark-managed-agents

ark-managed-agents 0.1.0 为 DSH 增加方舟 Managed Agents 设置页和 MCP 工具，可派发云端长任务、查看状态与轨迹并下载产物。

• 方舟 Managed Agents 测试账号（必需）：使用独立项目、低额度和可删除的 Agent/环境。
• 隔离产物目录（必需）：准备专用本机目录，不允许工具写入个人目录或生产工作区。

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

安装到

web Profile

DSH 基线

0.1.1-rc.2

安装来源

GitHub 精确子目录

固定目标

@volcengine/ark-managed-agents@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-managed-agents@0.1.0

3. 03
   如遇构建脚本拦截

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

4. 04
   确认 Bundle 已进入配置

   安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 @volcengine/ark-managed-agents或对应 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

npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web remove @volcengine/ark-managed-agents

DSH 设置 → Managed Agents

保存测试 API Key 和默认模型。

$DSH_HOME/ma-artifacts

默认产物下载目录；应限制为测试数据。

export ARK_API_KEY="<TEST_API_KEY>"
export ARK_DEFAULT_MODEL="<TEST_MODEL_ID>"

1. 在方舟控制台创建低额度测试项目并确认资源删除入口。
2. 重启 DSH 后先调用 ma_list_agents，只读确认账号范围。

1. 01
   派发一个不含文件的短任务，wait=false，并记录 session_id。

   期望结果：返回 session、agent 和 environment ID；未下载文件。

2. 02
   用状态和结果工具查看任务，再到方舟控制台终止或清理测试资源。

   期望结果：轨迹和结果可追溯；控制台不存在遗留运行任务。

• 派发“返回当前 UTC 日期”的短任务，不挂载文件，不下载产物。

读取 ARK API Key，启动本机 MCP 子进程，自动创建或复用云端 Agent、开放网络的沙箱环境和 Session，并可把任务、系统提示、产物与用户指定下载目录在本机与方舟之间传输。

数据存储：任务、系统提示、轨迹和产物保存在方舟云端；下载工具可写入本机 $DSH_HOME/ma-artifacts 或指定目录。

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

Base URL 与 README 不一致

固定包代码默认 https://ark.cn-beijing.volces.com/api/v3；以当前代码和方舟官方控制台为准。

产生持续运行或计费

立即在方舟控制台终止资源并撤销 Key；不要依赖插件提供取消工具。