deepseek-harness 视觉辅助模型功能包（vision-assistant-pack）

打包自一台已启用该功能的 deepseek-harness 安装。功能内容：

1. 图片自动转描述：当会话模型不支持图片时，用配置的视觉辅助模型（如 mimo-v2.5）把 图片转成文字描述后再进入对话 —— 模型收到描述文本，界面仍显示原图（描述隐藏到后台）。
2. 设置页下拉选择：设置 → 插件 → 视觉辅助模型 的"提供方/模型"改为下拉菜单， 选项直接来自本机已配置的模型目录（不再手写，避免拼错）。
3. 会话行为：带描述的图片会话可以在各纯文本模型间自由切换；未描述的图片仍阻止切换到 纯文本模型；把会话切到视觉模型（如 mimo）时图片直接原样发送。
4. read_image 工具回退：agent 用 read_image 读取本地图片文件时，纯文本模型也会 自动把图片交给视觉辅助模型描述（含工具结果内嵌套的图片块），界面照常显示原图。

截图

设置页下拉选择（提供方/模型）	会话中显示原图、模型收到描述

---

一、给执行安装的 agent 的步骤（照做即可）

平台说明：功能补丁（patch）是纯 TypeScript 源码改动，与操作系统无关； 安装器是 Node 脚本（install.mjs / verify.mjs），Windows / macOS / Linux 通用 （deepseek-harness 运行本身要求 Node ^22.19.0 || >=24.0.0，无需额外安装任何东西）。

前置条件（先向用户确认或检测）：

• 目标机器有 deepseek-harness 源码 checkout（含 apps/、packages/、.git， 通过 npm run dsh -- --profile web 启动）。
• Node ^22.19.0 || >=24.0.0，且能运行 npm run build:*（web 构建需要 pnpm）。

安装（在目标机器上执行）：

node install.mjs --checkout /目标/deepseek-harness路径

若不知道 checkout 路径：先问用户；或在常见位置探测（脚本内置 ~/AppData/Roaming/reasonix/global-workspace/deepseek-harness、 ~/global-workspace/deepseek-harness、~/deepseek-harness、当前目录等）。 脚本会自动完成：版本兼容基线检查 → 备份原文件 → git apply 打补丁 → 合并 settings.yaml（vision-assistant 段，留空）→ 依次构建 build:lib:host / build:lib:client / build:web → 验证构建产物标记。

脚本不会重启服务（在脚本里杀服务会杀掉正在执行安装的 agent 自己）。 构建全部成功、输出"安装完成"后：

1. 告诉用户手动重启：关闭当前 dsh 进程，在 checkout 目录执行 npm run dsh -- --profile web。
2. 可选复查：node verify.mjs --checkout <路径>。
3. 提醒用户：重启后打开 设置 → 插件 → 视觉辅助模型，从下拉中选择自己的 视觉提供方与模型；提供方 API 密钥需各自配置（.credentials.yaml），本包不含任何密钥。

故障处理：

• "版本不兼容/基线标记缺失"：目标 checkout 与打包基准（commit 47f9438）不一致。 停止安装并告知用户，不要强制打补丁。
• 构建失败：按日志提示处理（多为 Node/pnpm 版本），修复后重跑 node install.mjs （已应用部分会跳过：补丁检测到"已安装"会直接继续构建）。
• 安装后设置页无"视觉辅助模型"卡片：浏览器硬刷新（Ctrl+F5）后再看。

二、给人类看的说明

• 不包含任何密钥；视觉提供方/模型需要在安装后于设置页下拉选择自己的。
• 本包基于 commit 47f9438（2026-08-13）制作；版本差异过大时补丁可能无法应用， 属预期行为，请先对齐版本。
• 卸载/回滚：备份在 checkout 的 .vision-assistant-backup-<时间戳>/ 目录， 把备份的文件复制回原路径并重新构建即可；或用 git 还原： git checkout -- packages/...（对新文件用 git clean -f，注意先确认没有别的改动）。