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/