前言¶
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 官方无从属关系。
