dsh-provider-veark：DeepSeek Harness 接入火山方舟 Coding Plan

前言¶

DeepSeek Harness (DSH) 採用插件化架構，允許開發者通過社區插件擴展能力。dsh-provider-veark 是由 IcedWatermelonJuice 維護的插件，旨在解決 DSH 原生對火山方舟 Coding Plan 支持不足的問題，將火山方舟的文本、圖片與 PDF 文檔理解能力集成進來。它走火山官方 Responses API + Coding 網關，並實現了圖片優先上傳到方舟 Files API 的優化邏輯。

核心功能¶

• 多模態理解：支持文本、圖片與 PDF 文檔理解。
• 官方接口：走火山官方 Responses API + Coding 網關。
• 圖片優化：圖片優先上傳到方舟 Files API（上傳一次，多輪只傳 file_id）。
• 密鑰管理：密鑰粘貼即用，密鑰寫入 DSH 憑據服務，不回顯、不落 settings.yaml。

安裝與啓用¶

安裝後需重啓 DSH 生效。安裝過程中若遇到構建腳本被忽略的問題，需手動放行。

1. 執行安裝命令（以 web profile 爲例）：

    dsh plugin --profile web add @icedcola/dsh-provider-veark

2. 若首次安裝報錯 ERR_PNPM_IGNORED_BUILDS，需先手動放行構建腳本：

    dsh plugin --profile web approve-builds protobufjs

放行後重新執行上述安裝命令。

配置與使用¶

1. 在 DSH 網頁端進入「設置 → 插件」，找到「火山方舟 Coding Plan」卡片。
2. 粘貼火山方舟 API 密鑰並保存。
3. 在模型列表中選擇「火山方舟 Coding Plan」（默認 ark-code-latest），即可使用文本、圖片和 PDF 文檔理解功能。

文檔引用方式：
* 工作區文檔：在問題中直接輸入 @docs/文件.pdf 或帶空格路徑 @"docs/my paper.pdf"。
* Composer 按鈕：點擊 Composer 左側的 PDF 按鈕，插件會將文件暫存爲不可變快照，並在草稿中追加 @.dsh-pdf/<uuid>/<文件名>。

高級配置（settings.yaml）：
可編輯 %DSH_HOME%\settings.yaml 中的 dsh-provider-veark 段（保存即熱生效）：

dsh-provider-veark:
  preferFiles: true
  chatBaseURL: https://ark.cn-beijing.volces.com/api/coding/v3
  filesBaseURL: https://ark.cn-beijing.volces.com/api/v3
  apiKeyEnv: ARK_API_KEY
  pdfRetentionDays: 0

注意事項與已知邊界¶

• 權限要求：插件以當前 DSH 進程權限運行，安裝前請檢查源碼與許可證。
• 存儲位置：PDF 按鈕產生的 sidecar 默認保存在 %DSH_HOME%\provider-veark\pdfs\。
• 已知問題：
  • 首次安裝需手動放行 protobufjs 構建。
  • 助手歷史中的 reasoning 塊不回放（Responses 協議限制）。
  • 不支持視頻、音頻或 TOS 直傳。
  • 單個 PDF 和每次請求內累計 PDF 原始大小上限均爲 45 MiB。

總結¶

該插件爲 DeepSeek Harness 用戶提供了接入火山方舟 Coding Plan 的便捷入口。更多細節可參考項目主頁。

• GitHub 倉庫
• 社區目錄