visual-review

配置

云端引擎（推荐）

在 $DSH_HOME/visual_review.config.json（默认 ~/.dsh/visual_review.config.json）写入：

{
  "url": "https://api.siliconflow.cn/v1/chat/completions",
  "apiKey": "sk-xxxx",
  "model": "Qwen/Qwen3.5-35B-A3B"
}

也可以在会话中让模型调用 visual_review_config 工具填写 url / api_key / model（只传需要修改的字段；三项都留空表示清除云端配置、回退本机引擎）。

该文件包含明文 API Key，务必加入 .gitignore 并注意文件权限（本仓库的 .gitignore 已包含）。

本机引擎

未配置云端时自动回退。需要本地模型：

huggingface-cli download Qwen/Qwen3-VL-8B-Instruct

模型目录解析顺序：命令行参数 → 环境变量 VISUAL_REVIEW_MODEL_DIR → 默认 ~/.cache/huggingface/hub/models--Qwen--Qwen3-VL-8B-Instruct。

环境变量

变量	默认值	说明
DSH_HOME	$HOME/.dsh	DSH 数据目录，visual_review.config.json 存放处
VISUAL_REVIEW_SERVER	插件自带 server/visual_review_server.py	本机推理脚本路径
VISUAL_REVIEW_PYTHON	python3	本机推理脚本的解释器
VISUAL_REVIEW_WORKSPACE	sandbox 工作区根 → 进程 cwd	工作区根目录（.visual_review_tmp 所在处）
VISUAL_REVIEW_ATTACH_ROOT	$HOME/.dsh/attachments/v1/objects	附件对象存储根目录（/vr-image 兜底读取用）
VISUAL_REVIEW_MODEL_DIR	HF 缓存默认路径	本机 Qwen3-VL 模型目录（worker 内读取）

使用

1. 直接体验：在聊天框粘贴或上传一张图片 → 图片立即渲染在气泡里；模型侧自动出现附件注解，模型会自动调用 visual_review 并给出图片描述。
2. 分析本地文件：让模型分析磁盘上的图片，例如“请用 visual_review 分析 /path/to/photo.png”，模型会以 image_path 参数调用工具。
3. 定制提问：给模型指令时说明诉求，如“读出这张图片里的所有文字”“描述这个图表的趋势”。工具支持 prompt 参数，由模型按需传递。
4. 切换引擎：调用 visual_review_config 修改云端配置即可；把三项都置空则回到本机引擎。