🖼️ deepseek-vision — DSH 本地图片理解插件
> 把 deepseek-mcp-serve 的视觉识别能力收编为 DSH 宿主级 bundle 插件：vision_describe 工具随 DSH 启动自动挂载，所有会话的 AI 直接可用——无需规则提醒，遇到图片自然调用。
三层后端链自动降级：MiniMax-M3（云）→ 智谱 GLM-4.6V-Flash（云，免费）→ 本地 Ollama gemma3:4b（完全本地，涉密图片专用）
✨ 特性
- ⚙️ 零配置使用：AI 遇到图片自动调用
vision_describe（imagePath+question原样传入） - 🔁 重启不丢：bundle 注册进 web profile，随 DSH 启动自动挂载（与 dsh-collab-bundle 同机制）
- 🔒 密钥安全：keys 存
~/.dsh/vision.config.json，经子进程 env 注入，不进日志、不进工具输出；错误信息自动剥离 base64 图片数据 - 🧩 可复用：
visionService 可被其他插件ctx.get('vision')直接调用 - ⏱️ 超时可控：单后端超时 + 整体链 deadline，最坏等待有界
🧭 后端链
| 顺序 | 后端 | 端点 | 模型 |
|---|---|---|---|
| 1 | MiniMax（云） | https://api.minimaxi.com/v1/text/chatcompletion_v2 | MiniMax-M3 |
| 2 | 智谱（云，免费） | https://open.bigmodel.cn/api/paas/v4/chat/completions | GLM-4.6V-Flash |
| 3 | Ollama（本地） | http://localhost:11434/api/chat | gemma3:4b |
降级语义：网络错误 / 5xx / 429 → 降级下一后端；其他 4xx → fail-fast；全链失败 → 报错。强制 ollama 后端 = 完全本地处理（涉密图片）。
📦 文件结构
deepseek-mcp-plugin/
├── README.md
├── package.json # bundle 包定义（dsh.bundle.patch → cordis.patch.yml）
├── cordis.patch.yml # 挂载行（host 级：所有会话自动获得工具，重启不丢）
├── lib/
│ └── index.js # 插件主代码（ESM）
├── src/
│ └── deepseek-vision.host.js # 动态插件版源码（历史/机制参考）
└── docs/
├── 2026-08-15-deepseek-vision-plugin-design.md # 设计文档
└── 2026-08-15-deepseek-vision-plugin.md # 实施计划🚀 安装
dsh plugin --profile web add "file:D:/Deepseek-MCP-Plugin"- 自动注册进 web profile 的
dsh.profile.bundles与 dependencies（file: 依赖） - 注意：安装是复制（非链接）——修改
lib/index.js源码后需重新执行上述命令才生效 - 卸载：
dsh plugin --profile web remove deepseek-vision
✅ 状态
- [x] 动态插件验证通过（默认链识别与基线一致、429 降级、错误路径全部正确）
- [x] 固化：bundle 安装进 web profile，重启自动挂载（已实测）
- [x] AGENTS.md 识图规则退役（指向
vision_describe工具） - [x] 原
deepseek-mcp-serve技能归档（SKILL.md 标记 RETIRED） - [x] 推送至 GitHub（YNM10086/deepseek-mcp-plugin）
🔐 安全
- API keys 只从
~/.dsh/vision.config.json读取，经子进程 env 注入，不落盘、不进日志、不进工具返回 - 错误信息中 base64 图片数据会被
sanitize()剥离（[image omitted]） - 涉密图片务必传
backend: "ollama"（完全本地，不经过第三方服务器）