Apache-2.0 的 Python CLI，把火山方舟 MaaS 平台變成本機 Agent 可呼叫的工具箱——文字 / 多模態對話、Seedream / Seedance 媒體生成、影片總結、精調、一鍵部署 Endpoint，以及用量、帳單與 `doctor` 診斷。
DSH 整合
相容
作者聲明
安全稽核
未稽核
最後核實
2026-08-25
授權條款
Apache-2.0
01它能幫你完成什麼？
讓本機 AI Agent 呼叫火山方舟模型，完成文字對話、多模態理解與圖片 / 影片生成
文字與多模態對話回覆、影片總結，以及自動下載到本機的 Seedream / Seedance 圖片與影片產物
使用 Claude Code / OpenCode / Codex 等本機 Agent 的開發者，希望把方舟生成與理解能力接進自己的工作流
把基礎模型或自訂模型一鍵部署為可呼叫的 Endpoint
上線後的 Endpoint（可用 `arkcli infer endpoint` 列示與查詢），以及精調得到的自訂模型
需要把方舟模型當作線上服務使用的工程師與平台團隊
查詢用量、帳單並對方舟資源做唯讀診斷
用量統計、帳單明細與 `doctor` 診斷結果（錯誤碼 / 指標）
需要監控成本、排查呼叫失敗並查看監控指標的維運與開發者
02如何將外掛接入 DeepSeek Harness？
安裝步驟
- 01
$ npm i -g @volcengine/ark-cli@latest
- 02
arkcli --version
- 03
arkcli auth login volc-sso
- 04
arkcli auth status
- 05
arkcli +connect
驗證整合成功
- arkcli --version
- arkcli auth status
03DSH 整合程度與能力邊界
透過 `arkcli +connect` 安裝 Ark Skills，並用 `arkcli helper configure --with-mcp` 把 Ark CLI 的 MCP 工具能力注入本機 Harness（如 Codex），讓 Agent 以自然語言呼叫火山方舟的模型、生成與診斷能力。
模型呼叫
文字 / 多模態提示（如 @photo.jpg、@demo.mp4）→文字對話、多模態理解與串流輸出回覆
圖片 / 影片生成
文字生成指令（如「生成一張未來城市海報」）→Seedream 圖片與 Seedance 影片，產物自動下載到本機
生成的圖片 / 影片會自動下載到本機檔案系統多模態理解
圖片 / 影片 / 語音 / 文件→OCR、影片總結、語音轉寫、字幕打軸、文件欄位抽取結果
一鍵部署 Endpoint
模型名（如 doubao-seed-2-0-pro-260215）與 Endpoint 名稱→上線後的 Endpoint，可用 `arkcli infer endpoint` 管理
04適合誰？何時不該用？
適合
- 使用 Claude Code / OpenCode / Codex 等本機 Agent 的開發者，希望把方舟生成與理解能力接進自己的工作流
- 需要把方舟模型當作線上服務使用的工程師與平台團隊
- 需要監控成本、排查呼叫失敗並查看監控指標的維運與開發者
不適合
- `plans buy` / `plans renew` 是計費操作，Ark CLI 會先展示協議和確認步驟，不會預設直接扣款。
05相容性、維護與安全提醒
- `plans buy` / `plans renew` 是計費操作，Ark CLI 會先展示協議和確認步驟，不會預設直接扣款。
- `doctor` 預設是唯讀診斷，不會修改資源；需要修復時會透過確認流程執行。
- `arkcli +connect uninstall` 只會清理注入到本機 Agent 的 `ark-` / `arkcli-` 前綴 Skills，不會解除安裝 `arkcli` 指令本身。
Apache-2.0 · 活躍維護中（最新版本 v1.0.21，2026-08-24）
06常見問題
怎麼安裝 Ark CLI？
執行 `npm i -g @volcengine/ark-cli@latest`，再用 `arkcli --version` 確認。之後執行 `arkcli auth login volc-sso` 登入火山方舟，它會自動完成身分、profile 與 API Key 設定。
Ark CLI 如何接入 DeepSeek Harness？
它透過 `arkcli +connect` 安裝 Ark Skills，並用 `arkcli helper configure --with-mcp` 把 Ark CLI 的 MCP 工具能力注入本機 Harness（例如 Codex），讓 Agent 以自然語言呼叫方舟能力。
Agent 用 Ark CLI 實際能做哪些事？
文字與多模態對話、OCR / 影片總結 / 語音轉寫、Seedream 生圖與 Seedance 生影片（自動存到本機）、精調、一鍵部署 Endpoint，以及用量 / 帳單 / `doctor` 診斷。
計費指令安全嗎——會自動扣款嗎？
不會。`plans buy` / `plans renew` 是計費操作，Ark CLI 會先展示協議和確認步驟，不會預設直接扣款。
如何只清理注入的 Skills 而不解除安裝 CLI？
`arkcli +connect uninstall` 只清理注入到本機 Agent 的 `ark-` / `arkcli-` 前綴 Skills，不會解除安裝 `arkcli` 指令本身。
07相關的 DSH 工作流程
ruflo
作者 ruvnet
原版智慧體元框架（meta-harness）：支援多智慧體叢集部署、自主工作流編排與對話式 AI 系統構建，內建自適應記憶、自學習智慧與 RAG 檢索，原生整合 Claude Code / Codex / Hermes 等大量工具。
reactive-resume
作者 amruthpillai
注重隱私的開源簡歷生成器，安全、可定製、可移植，永久免費，支援自託管。
everos
作者 evermind-ai
為所有 AI 智慧體提供的便攜統一記憶層，本地優先、Markdown 原生、資料歸使用者所有，跨應用與工作流自進化。
yao
作者 yaoapp
在桌面、移動端、瀏覽器或 API 上統一管理你的智慧體與工作區，看板式任務追蹤，支援自託管。
08資料與來源
配置 Harness / MCP，让本地 Agent 调用方舟能力
arkcli helper configure codex --with-mcp
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生；最後核實於 2026-08-25。發現錯誤？提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛，涵蓋各個分類。