@evan-williams/vision-tool
适用于 DeepSeek Harness 的对话式 UI/UX 视觉审查插件：由任何兼容 OpenAI 的多模态端点（例如 agnes-2.5-flash）支持 vision_review / vision_ask 工具
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @evan-williams/vision-tool@0.1.0Vision Tool 以 @evan-williams/vision-tool 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
为纯文本主模型提供对话式界面视觉评审的 DeepSeek Harness (dsh) 插件：围绕具体任务（如美化 HTML）对页面截图进行针对性评审与追问，返回自由文本的专业意见，供主模型据此修改代码。视觉后端为任意 OpenAI 兼容多模态端点（如 agnes-2.5-flash），零运行时依赖（仅 Node 内置能力）。
| 工具 | 作用 | 参数 |
|---|---|---|
vision_review | 首次评审：按六项默认维度全面评估（风格一致性、配色、间距对齐、视觉层级、可读性、组件一致性），模型有权自主增加评审维度 | path（必填）、focus（可选）、dimensions（可选） |
vision_ask | 对话式追问：结合前一轮结论深入询问具体问题 | path（必填）、question（必填）、context（可选） |
多轮对话为无状态设计：历史由主模型在会话中自然累积，通过 vision_ask 的 context 参数传递。
所有读取操作均在当前会话内完成：插件只注册读取工具，不创建新对话、不管理会话分组、不依赖 workspace 服务。
npx -y @deepseek-ai/dsh plugin --profile web add @evan-williams/vision-tool
安装后重启 dsh 进程生效：
npx -y @deepseek-ai/dsh web
插件按以下优先级解析 OpenAI 兼容后端（任一即可）：
~/.modlens/config.json（与 modlens 共享的配置）：{
"providers": {
"openai": {
"baseUrl": "https://apihub.agnes-ai.cn/v1",
"apiKey": "sk-...",
"model": "agnes-2.5-flash"
}
}
}
OPENAI_BASE_URL / OPENAI_API_KEY（model 缺省为 agnes-2.5-flash）。模型必须支持图像输入（多模态）；深度思考（chat_template_kwargs.enable_thinking）已默认开启。
vision_review（可带 focus，如"配色和谐度"）获得评审清单。vision_ask 追问（如"哪个按钮颜色最刺眼，具体怎么调"）。POST {baseUrl}/chat/completions（OpenAI 兼容，依据 agnes-2.5-flash API 文档）。chat_template_kwargs: { enable_thinking: true }。max_tokens: 8192（显式传入，避免服务端默认值导致评审截断）、temperature: 0.3。2026-08-14：工具 schema 非法导致消息机制崩溃（已修复）
根因：工具定义中 parameters 误用了 defineTool() 的扁平输入格式（required: true 内联、顶层无 type）。raw 注册（不经 defineTool 转换）时，上游收到顶层 type: null 的非法 schema，抛出 Invalid schema for function 'vision_ask'，中断消息机制。
修复：parameters 改为标准 JSON Schema 形态 { type: 'object', properties: {...}, required: [...] }（vision_review 必填 path，vision_ask 必填 path 与 question），与 modlens read_image 的注册形态一致；同时为每个工具注册包 try/catch，注册失败仅记录日志、不使插件 fiber 崩溃。
验证：node test/plugin-load.js 按 cordis loader 方式（file:// 动态 import）加载模块并模拟 ctx.tools.register，确认两个工具均以合法 JSON Schema 注册。
vision-tool/
├── package.json # type: module
├── src/index.js # 插件入口（工具注册）
├── lib/config.js # modlens 配置读取
├── lib/agnes.js # API 请求封装
├── lib/prompts.js # 评审提示词模板
├── test/smoke.js # 端到端冒烟测试
└── test/plugin-load.js # 插件加载与工具 schema 验证
冒烟测试（不经插件宿主，直接调用 lib 层）：
node test/smoke.js <截图路径> # 首次评审
node test/smoke.js <截图路径> --ask "哪个按钮颜色最刺眼" # 追问
node test/smoke.js <截图路径> --focus "配色和谐度" # 带关注点评审
node test/plugin-load.js # 插件加载与 schema 验证