4. 配置

配置读 /plugins/dsh-computer-use/config.json（不存在则用默认值），也可以在 profile 的插件条目里用 config: 覆盖（内联优先）。损坏/缺字段时逐字段回退默认值。

字段	默认	含义
`enabled`	`true`	关掉后一个工具都不注册
`tools`	`"native"`	`native` = 25 个独立工具；`single` = 一个 `computer_use`（带 `action`），省 schema token
`warmup`	`true`	加载时预热后端；关掉则首次调用才拉起（多等约 1-2 秒冷启动）
`installSkill`	`true`	把随包技能装到 `/skills/computer-use/`（带所有权标记，不覆盖用户自写版本）
`accessMode`	`"auto"`	谁能调用电脑操控：`auto` 全自动 / `ask` 每次弹审批 / `off` 禁用（见 §5.4）
`allowSubagents`	`false`	是否允许子代理调用电脑操控（默认关闭：子代理动用户鼠标键盘时用户看不见也难喊停）
`indicator`	`true`	是否显示屏幕最前端的「DSH 正在操作电脑」浮层（见 §5.5）
`indicatorLocale`	`"auto"`	浮层文案语言：`auto` / `zh-CN` / `en-US`
`indicatorShowAction`	`true`	文案后是否带上当前动作（「· 正在点击」）
`indicatorAutoHideMs`	`30000`	无操作活动多久后自动隐藏（兜底，防止浮层滞留）
`requestTimeoutMs`	`30000`	单次调用默认超时
`screenshotTimeoutMs`	`60000`	截图/取界面树超时
`startupTimeoutMs`	`20000`	等待后端 ready 上限
`maxRestarts`	`3`	后端崩溃后自动重启上限，超出后报明确不可用原因
`screenshotMaxWidth`	`1600`	模型可见截图长边上限（0 = 不缩放）
`screenshotMaxBytes`	`524288`	单张截图字节预算，超出按 png→jpeg→更小栅格降级重拍
`screenshotFormat` / `screenshotQuality`	`"png"` / `80`	默认编码与 jpeg 质量
`saveFrames` / `keepFrames`	`true` / `40`	截图落盘到 `plugins/dsh-computer-use/frames/`，只保留最新 N 张
`debug`	`false`	把原生后端的 stderr 诊断写进 DSH 日志

// 示例：省 token 的单工具模式 + 更小的截图
{ "tools": "single", "screenshotMaxWidth": 1280, "screenshotFormat": "jpeg" }

dsh-computer-use

同名套件的其他儲存庫

安裝

說明文件

4. 配置