Configuration

Key	Type	Default	Meaning
`rosSetup`	string	`''`	Shell prefix to prepare the environment, e.g. `source /opt/ros/jazzy/setup.bash &&`
`timeoutMs`	number	`15000`	Per-command timeout
`rosLogDir`	string	`''`	Override `ROS_LOG_DIR` (helps when `~/.ros/log` is not writable)
`workspaceRoot`	string	`''`	cwd for `colcon` / `rosdep` when a tool omits `cwd`
`includeStderr`	boolean	`false`	Attach trailing stderr to successful results
`display`	string	`''`	DISPLAY override for GUI/screenshot tools
`screenshotDir`	string	`''`	Screenshot output dir (default `$TMPDIR/dsh-ros2`)
`screenshotCommand`	string	`''`	Custom screenshot command; `{output}` is replaced with the PNG path
`vision.provider`	string	`'mock'`	`mock` \| `gemini` \| `openai`
`vision.apiKey`	string	`''`	Your API key (user-supplied; never logged)
`vision.model`	string	`''`	Model override (e.g. `gemini-2.5-flash`, `gpt-4o-mini`)
`vision.baseUrl`	string	`''`	API base URL override (OpenAI-compatible endpoints)

Example patch config:

- insert:
    - id: dsh-ros2
      name: dsh-ros2
      config:
        workspaceRoot: /home/you/ros2_ws
        vision:
          provider: gemini
          apiKey: ${GEMINI_API_KEY}   # 经环境变量/密钥管理注入，勿写死

dsh-ros2

AI 分析

安装

说明文档

Configuration