@xlight-oss/visionary-dsh

DeepSeek Visionary 的 DeepSeek Harness（DSH）原生插件：把 deepseek_vision / deepseek_vision_status / deepseek_vision_login / deepseek_vision_logout 注册为 DSH 原生工具，由 visionary-server CLI 支撑（DeepSeek 网页版视觉模型，无需 API key）。

特性

• 原生工具 — 结构化参数 schema 注册到 ctx.tools，模型直接调用，无 MCP 中间层
• 复用 Rust 管道 — 每个工具 spawn visionary-server（PoW → 上传 → fork → HIF → SSE 全部在 Rust 侧），插件仅做参数映射与 JSON 解析
• 宿主级权限 — 工具在 DSH 宿主进程执行（不经 bash 沙箱），会话续聊与浏览器登录不受 workspace-write 限制
• 超时有界可取消 — 每个工具声明 timeoutMs 并转发 exec.signal（abort → kill 子进程）

安装

# npm 包（发布后）
dsh plugin --profile web add @xlight-oss/visionary-dsh

# 本地路径（开发验证）
dsh plugin --profile web add /path/to/packages/dsh-plugin

dsh plugin 会把包安装进 profile 并通过 dsh.bundle 声明自动追加到 dsh.profile.bundles 层叠——无需手写任何配置。重启 DSH 后 4 个工具出现在工具目录。

验证：dsh --profile web --dump-config 应出现 @xlight-oss/visionary-dsh 层与 visionary-vision 插件行。

本地路径（开发）安装：dsh plugin add 以 link 方式安装，Node 从包的真实位置解析其 peer 依赖，因此本地开发需先在包目录 pnpm install（peer 已镜像为 devDependencies，见 package.json），否则加载时报 Cannot find package '@deepseek-ai/dsh-tools'。已发布的 npm 包无此要求（DSH 的 profiles/node_modules 兜底解析）。

前置要求

visionary-server 二进制需可被找到（三者任一）：

1. Config.binaryPath（插件配置，绝对路径）
2. DEEPSEEK_VISIONARY_BIN 环境变量
3. 在 PATH 中

安装二进制见 DeepSeek Visionary 安装章节（install.sh / brew / npm）。未找到时工具返回含安装指引的错误。

配置