opencode-eyes：給文本模型一雙眼睛（StepFun step-3.7-flash）

前言¶

DeepSeek Harness（DSH）採用“一切皆插件”的理念。對於不具備原生視覺能力的大模型，可以通過掛載 MCP 服務器來擴展功能。opencode-eyes 插件正是爲此設計，它將 StepFun 的 step-3.7-flash 視覺模型封裝在插件中，讓文本模型能夠“看見”並描述圖片。

核心功能¶

多模態補全：爲純文本模型提供圖像理解能力。
工具註冊：自動註冊 mcp__opencode_eyes__describe_image 工具。
開箱即用：MCP 服務器打包在插件本體中，無需單獨部署服務器文件。

安裝與啓用¶

CLI 安裝¶

在需要使用的 DSH 配置文件（profile）中執行：

dsh plugin --profile web add bauerelizabeth07139/opencode-eyes

Desktop 安裝¶

打開 Plugins 側邊欄。
點擊 Add plugin。
輸入 bauerelizabeth07139/opencode-eyes 或完整的 GitHub URL。
啓用新出現的 dsh-opencode-eyes bundle。

卸載¶

dsh plugin --profile web remove dsh-opencode-eyes

典型用法¶

環境配置¶

插件通過 STEP_API_KEY 環境變量或配置文件中的 apiKey 獲取憑證。需要確保 StepFun 賬號有足夠的調用額度。

配置示例¶

在 cordis.patch.yml 中添加插件配置：

- id: dsh-opencode-eyes
  name: 'dsh-opencode-eyes'
  config:
    apiKey: 'sk-...'
    toolCallTimeoutMs: 300000

工具調用¶

模型調用工具 mcp__opencode_eyes__describe_image。參數如下：

image_path (必需)：本地圖片路徑。
prompt (可選)：針對圖片的描述提示詞。

插件會將圖片轉換爲 Base64 編碼的 JPEG 格式發送給 StepFun 接口。

配置與限制¶

可配置項¶

插件支持在配置中調整以下參數：

配置項	環境變量	默認值	說明
`apiKey`	`STEP_API_KEY`	空	StepFun 認證密鑰，必須配置
`model`	`STEP_MODEL`	`step-3.7-flash`	視覺模型 ID
`timeoutSeconds`	`STEP_TIMEOUT`	`120`	服務器等待 StepFun API 響應的超時時間
`maxDimension`	`STEP_MAX_DIMENSION`	`2048`	圖片縮放後的最大邊長
`jpegQuality`	`STEP_JPEG_QUALITY`	`85`	轉換爲 JPEG 的質量
`toolCallTimeoutMs`	—	`300000`	DSH 對單次工具調用的最大預算（毫秒）

注意事項¶

API Base URL：API 的基礎地址 https://api.stepfun.com/step_plan/v1/chat/completions 編譯在服務器代碼中，無法通過配置修改。
運行目錄：插件使用 src/ 佈局，服務器必須在 src 目錄運行。插件安裝時會自動處理此邏輯。
超時設置：StepFun 服務器默認超時爲 120 秒，而 DSH 默認超時較短。建議將 toolCallTimeoutMs 設置爲至少 300000（5分鐘）以避免超時。
運行環境：插件以當前 DSH 進程的權限運行，請確保對圖片路徑有讀取權限。

許可證與生態¶

許可證：MIT
維護者：bauerelizabeth07139
生態說明：此插件爲社區目錄維護的項目，與 DeepSeek 官方無從屬關係。