Skip to content

v0.3.2

Latest

Choose a tag to compare

@GOU-GEE GOU-GEE released this 15 Aug 11:14
· 4 commits to main since this release

v0.3.2

正式发布版本。为 DeepSeek Harness 等纯文本模型提供完整的视觉能力:
MCP Server(Python 包)+ DSH 原生插件(npm 包)+ 自动触发的 vision Skill。

版本说明:0.3.0 由作者手动认领 npm 包名;0.3.1 为 PyPI 首次发布
(npm 无此版本);0.3.2 为双端(npm + PyPI)一致发布的当前版本

🚀 新增功能

  • 4 个 MCP 工具analyze_image(单图,本地路径/URL/base64)、
    analyze_clipboard(剪贴板读图,Win/macOS/Linux)、compare_images
    (2-4 张多图对比)、vision_status(健康检查)
  • 7 种预置任务task 参数):通用描述 / OCR / UI 截图 / 报错诊断 /
    图表解读 / 代码提取 / 流程图理解
  • DSH 原生插件:可视化配置页、粘贴/拖拽图片自动触发、
    Key 存 DSH 官方凭据存储(不落库/不回显/不进上下文)
  • 自动运行时:无需 GUI PATH 有 Python/Node——自动下载固定版本
    uv 0.12.5 + 隔离 CPython 3.12 + 内置 wheel

🛡️ 容错与安全

  • 多 Key 轮换、同服务商模型降级、跨服务商备用链
  • 免费模型限流韧性:Retry-After 指数退避、请求预算、故障熔断
  • 识别结果缓存(LRU + TTL),同图同问秒回 cached=true
  • SSRF 防护、token 升档重试、空内容诊断、HTTP 状态码修复指引
  • Key 全程不写入 Git 仓库、日志、模型上下文与页面返回数据

📦 交付形态

  • PyPI:deepseek-vision-mcp==0.3.2(Trusted Publishing)
  • npm:dsh-plugin-deepseek-vision@0.3.2(含内置 Python wheel)
  • 默认视觉模型:智谱免费 glm-4.6v-flash;支持硅基流动/通义千问/OpenAI/自定义

✅ 质量

  • 94 个 Python 测试 + 18 个 DSH 插件 Node 测试
  • MCP SDK 1.2.0 / 1.29.0 / 2.0.0 兼容矩阵、真实 stdio 握手、Ruff、Twine
  • 全新环境安装验收通过:pip install deepseek-vision-mcp==0.3.2
    dsh plugin --profile web add dsh-plugin-deepseek-vision 均可直接使用

🧭 快速开始

pip install deepseek-vision-mcp
cp .env.example .env   # 填入 VISION_API_KEY
deepseek-vision-mcp

# DeepSeek Harness 一键插件
dsh plugin --profile web add dsh-plugin-deepseek-vision
cp -r skills/vision ~/.dsh/skills/