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 仓库
• 社区目录