JR-JR07/dsh-modlens-installer

dsh + ModLens 视觉能力一键安装

给 DeepSeek Harness（dsh）装上图片识别能力的 Windows 一键安装包 —— 粘贴图片即可识别，纯文本模型也能看图。

下载安装包 ·
使用说明 ·
工作原理 ·
常见问题

✨ 这是什么

DeepSeek Harness 背后的 DeepSeek 模型是纯文本的，本身看不了图片。本项目把视觉插件 ModLens 打包成一个 Windows 安装程序（EXE），双击后自动完成：

- ✅ 安装 @liustack/modlens 视觉插件到 dsh web profile
- ✅ 配置视觉引擎：智谱 GLM-4V-Flash（免费模型）
- ✅ 引导填写 API Key（免费获取，2 分钟）
- ✅ 之后在 dsh 里选择 DeepSeek-V4-Flash (modlens vision) 模型，直接粘贴图片即可识别

🚀 快速开始

方法一：使用安装包（推荐）

1. 下载 dsh-modlens-setup-1.0.0.exe
2. 双击运行，安装向导 → 勾选「立即运行一键安装脚本」
3. 脚本自动安装插件并引导你填写智谱 API Key（免费获取：open.bigmodel.cn 注册 → API Keys → 创建）
4. 重启 dsh 服务器，打开 http://127.0.0.1:3080
5. 模型选择器选 DeepSeek-V4-Flash (modlens vision)，粘贴图片即可识别

方法二：直接运行脚本

powershell -ExecutionPolicy Bypass -File install.ps1

环境要求

- Windows 10 / 11
- Node.js 22.19+
- 已安装并使用过 dsh（DeepSeek Harness web）

📸 截图

识别效果（GLM-4V-Flash 实测）

| 原图 | 识别结果 |
| :-- | :-- |
|  | 动漫风格插画：紫发蓝眼的角色怀抱一只绿眼黑猫，表情平静（anime / chibi 风格，主色调紫蓝黑） |
|  | 「Whale Girl」鲸鱼娘插画：蓝发大眼、女仆装、围裙鲸鱼图案、带鲸鱼尾巴（chibi 风格，蓝白主色调） |

🔧 使用说明

1. 选择模型 DeepSeek-V4-Flash (modlens vision)（或 DeepSeek-V4-Pro (modlens vision)）
2. Ctrl+V 直接粘贴图片（支持 png / jpg / webp / gif / heic，单张 ≤25MB）
3. 正常提问，约 5 秒后模型基于识别结果回答
4. 识别内容以结构化证据呈现：OCR 全文、版面区块、语义实体、颜色风格

⚙️ 工作原理

粘贴图片 → dsh 插件拦截 → ModLens CLI → 视觉引擎(GLM-4V-Flash) → 结构化 JSON 证据 → DeepSeek 模型作答

- 模型仍是原 DeepSeek，不会降智，只是多了"看图"输入
- 引擎与配置存于 ~/.modlens/config.json（与 dsh 插件共享）
- 国内直连智谱，无需代理/VPN

❓ 常见问题

Q: 提示「declares no dsh.bundle」？
A: pnpm 发布冷静期压旧版所致。用本安装包已钉死版本（3.15.0+），不会出现；若手动安装遇到，改用：
npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modlens@3.15.0

Q: 识别报错/额度问题？
A: glm-4v-flash 免费但可能限流。可换付费高质量模型：
npx @liustack/modlens config set openai.model glm-4.5v

Q: 能换其他视觉服务吗？
A: 可以。modlens 支持任意 OpenAI 兼容接口（阿里 qwen-vl、SiliconFlow 等）：
npx @liustack/modlens config set openai.baseUrl
npx @liustack/modlens config set openai.model

Q: 更新插件？
npx -y @deepseek-ai/dsh plugin --profile web update @liustack/modlens

🛠 重新构建安装包

需要 Inno Setup 6（含简体中文语言包）
ISCC.exe setup.iss

📄 许可证

MIT

⭐ 觉得有用的话点个 Star，让更多人看到。