由 yuanyuan 如果你在 WorkBuddy 里使用的是 DeepSeek 等纯文本模型，想让它看懂图片、分析截图，系统一定会提示“本机没有视觉能力”。虽然可以通过安装插件来“外挂”视觉，但很多朋友发现，这个插件经常过几天就失效了，总要手动修复。今天这篇保姆级教程，不仅带你从零装好插件，还会告诉你为什么它总是失效，以及一劳永逸的替代方案。
💡 第一步：确诊——为什么 WorkBuddy 看不见图？
在动手之前，先确认一下你的模型确实不支持图片。
打开电脑的 CMD（命令提示符），输入以下命令（注意 Windows 下用 type 代替 Linux 的 cat）：
cmd
type %USERPROFILE%.workbuddy\models.json
如果你看到 "supportsImages": false，这就破案了。WorkBuddy 的前端直接拦截了图片，模型自然无法处理。
🛠️ 第二步：准备——安装必备环境
因为我们要用的插件依赖 Python 和 Git，所以需要先搞定这两个基础工具。
1. 安装 Git for Windows
去官网下载安装包，一路“Next”即可。重点： 在“Adjusting your PATH environment”这一步，保持默认的 Git from the command line and also from 3rd-party software。
装完后，在开始菜单找到 Git Bash 并打开。
2. 安装 Python 3
去 Python 官网下载 Windows installer。
⚠️ 致命细节： 安装界面的第一步，一定要勾选最下方的 Add python.exe to PATH，然后点击 Install Now。
[插入图片：Python 安装界面，圈出 Add python.exe to PATH 的截图]
装好后，在 Git Bash 里输入 python --version 验证。
🔑 第三步：申请视觉 API Key（阿里云百炼）
既然主模型看不了图，我们就得找个“外援”。这里推荐阿里云百炼的 Qwen-VL 模型，新用户有免费额度，日常看图成本极低（约 0.001 元/张）。
- 登录阿里云百炼控制台，开通服务并完成实名认证。
- 进入左侧菜单最下方的 API-KEY，点击创建。
- 提示“余额不足”不用管，直接点确定（免费的 Token 额度不影响创建）。
- 复制生成好的
sk-开头的 Key，保存备用。
🚀 第四步：安装视觉插件 deepseek-vision
回到 Git Bash 窗口，依次执行以下三条命令：
bash
复制
下载
git clone https://github.com/rison114514/deepseek-vision.git cd deepseek-vision bash install.sh
脚本跑完后，我们需要把刚才申请的 Key 填进去。
在 Git Bash 中输入以下命令打开记事本：
bash
复制
下载
notepad.exe "C:/Users/你的用户名/.workbuddy/deepseek-vision/config.json"
把 "api_key" 后面的占位符替换成你的 sk- Key，保存并关闭记事本。
修复一个常见 Bug：
如果安装完发现 hooks 文件夹是空的，手动补拷一下：
bash
复制
下载
cp ~/deepseek-vision/hooks/vision-hook.py ~/.workbuddy/deepseek-vision/hooks/
✅ 第五步：重启与测试
必须彻底退出 WorkBuddy（右下角托盘右键退出），然后重新打开。
随便截一张图，在输入框按 Ctrl+V 粘贴，问它：“这张图里有什么？”
如果它准确报出了图片里的文字和内容，恭喜你，插件生效了！
😭 痛点：为什么它总是“失忆”，过几天就读不了图？
很多朋友发现，刚装好能用，过几天 WorkBuddy 突然又说“看不了图”了。原因是 WorkBuddy 软件更新或重置时，覆盖了 settings.json 文件，把我们写入的 UserPromptSubmit 钩子配置清掉了。
怎么救急？
在 Git Bash 里重新运行下面这条修复命令：
bash
复制
下载
python3 -c "import json, os; p=os.path.expanduser('~/.workbuddy/settings.json'); d=json.load(open(p, encoding='utf-8')); h=d.setdefault('hooks', {}).setdefault('UserPromptSubmit', [{}])[0].setdefault('hooks', []); c={'type':'command', 'command':'\"D:/Program Files/Git/usr/bin/python3\" \"C:/Users/Administrator/.workbuddy/deepseek-vision/hooks/vision-hook.py\"'}; h[:]=[x for x in h if 'vision-hook.py' not in str(x)] + [c]; json.dump(d, open(p,'w',encoding='utf-8'), indent=2, ensure_ascii=False); print('✅ 钩子配置已重新写入')"
跑完之后，彻底重启 WorkBuddy 即可恢复。
🌟 终极建议：不想折腾了怎么办？
deepseek-vision 本质上是个外挂补丁，只要 WorkBuddy 一更新，它就可能失效。如果你受不了这种“三天两头修一次”的日子，最好的办法是直接换个自带视觉能力的模型。
在 WorkBuddy 的模型设置里，直接接入 Qwen-VL 或其他多模态大模型。这样不需要装任何插件，不需要挂靠钩子，粘贴图片它就能直接看懂，这才是最省心的归宿。