IcedWatermelonJuice/dsh-provider-veark ↗★ 2

@icedcola/dsh-provider-veark

火山方舟 Coding Plan LLM provider for DeepSeek Harness — provider-scoped PDF、图片与 Responses API 流式支持 适合需要使用火山方舟API,且需要直接在对话中上传和解析PDF文档的用户。

Package
@icedcola/dsh-provider-veark
Compatibility
Unverified
Harness peer range
>=0.1.2-rc.1
Version
0.2.2
License
MIT
Last updated
Sep 11, 2026

Install

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:IcedWatermelonJuice/dsh-provider-veark

配置

  1. 打开 DSH 网页 → 设置 → 插件 →「火山方舟 Coding Plan」,展开卡片。
  2. 粘贴密钥(火山方舟 API Key)→ 保存。密钥写入 DSH 凭据服务,不回显、不落 settings.yaml。
  3. 完成。模型选择中出现「火山方舟 Coding Plan」(默认 ark-code-latest),文本、图片和 PDF 文档理解即可使用。

插件配置卡片

PDF 使用方法:先选择声明了 pdf 输入能力的模型(默认 ark-code-latest)。工作区内文档可直接在问题中输入 @docs/文件.pdf,带空格路径使用 @"docs/my paper.pdf";工作区外文档点击 Composer 左侧的 PDF 按钮,插件会立即暂存不可变快照并向草稿追加 @.dsh-pdf//。/pdf 仅保留为迁移提示。按钮仅在本插件的 volcengine provider 且当前模型声明 pdf 时显示;自定义模型默认只有 text,请仅在实际 endpoint 支持文档理解时手动勾选 pdf。

Composer 左侧的 PDF 上传按钮

内置 @ 文件引用与 PDF 按钮

卡片内可折叠调整:图片是否走云端文件服务、接口地址、图片清晰度与大小上限、PDF 本地保留天数、超时与重试、模型列表等;全部字段留空即恢复默认。

settings.yaml 高级字段(可选)

也可直接编辑 %DSH_HOME%\settings.yaml 的 dsh-provider-veark: 段(保存即热生效,可整段省略 = 全默认):

dsh-provider-veark:
  preferFiles: true
  chatBaseURL: https://ark.cn-beijing.volces.com/api/coding/v3   # coding 网关,勿改
  filesBaseURL: https://ark.cn-beijing.volces.com/api/v3         # 标准域被 403 时切到 …/api/coding/v3
  apiKeyEnv: ARK_API_KEY
  # models:
  #   - id: ark-code-latest
  #     name: Ark Code Latest
  #     contextWindow: 1000000
  #     maxTokens: 128000
  #     inputModalities: ["text", "image", "pdf"]
  #     imagePixelBudget: 640000
  #     imageMaxBytes: 1048576
  # requestImagePixelBudget: 640000
  # requestImageMaxBytes: 1048576
  # fileExpirySeconds: 604800
  # filesApiTimeoutMs: 15000
  # filesProbeIntervalMs: 21600000
  # pdfRetentionDays: 0       # 0 = 不自动删除;1–3650 = 后续上传时清理超期 sidecar

密钥也可不填卡片,改为启动前设置环境变量 ARK_API_KEY(或自定义 apiKeyEnv 指定的引用名)。