配置

- id: dsh-computer-use
  config:
    ttlMs: 60000
    maxElements: 120
    observeDedup: summary
    verboseReceipts: false
    taskTimeoutMin: 5
    maxTaskCalls: 3
    supersession: note
    allowedApps: []
    cursorTheme: com.dsh.computeruse.rainbow
    nativeImage: auto
    visionProvider: deepseek-official
    visionModel: deepseek-v4-flash-vision-exp
    passwordScan: auto
    extremePatterns: []
    deliveryMode: auto

配置项	默认	说明
`ttlMs`	`60000`	观察快照有效期（毫秒）
`maxElements`	`120`	单次观察最多返回的编号元素数（实测常见任务 30-70 个）
`observeDedup`	`summary`	重复观察降噪：同一未变窗口回极简回执——`summary`（含编号摘要）/ `brief`（单行）/ `off`（每次全量）；需要完整清单时传 `force=true`
`verboseReceipts`	`false`	动作回执详略：false = 只回一行要点；true = 附原始 JSON 明细（排障用）
`taskTimeoutMin`	`5`	`computer_task` 默认超时分钟数（可用 `timeout_min` 覆盖，1-60）。实测设太长会在子 agent 无法收敛时纯浪费
`maxTaskCalls`	`3`	每会话允许的 `computer_task` 次数上限（防委托风暴与反复超时重复劳动）
`supersession`	`note`	同快照连击语义：`note` 附一致性注记 / `enforce` 第二次动作直接拒绝（每动作一观察）/ `off` 全关
`passwordScan`	`auto`	Windows 结构性密码扫描（UIA sidecar 读 `IsPassword` ∨ `ES_PASSWORD` 结构位）；`off` = 零 spawn，凭据保护退回启发式。macOS/Linux 不适用
`allowedApps`	`[]`	作用域白名单；空 = 不限制
`cursorTheme`	`com.dsh.computeruse.rainbow`	虚拟光标主题；空 = 引擎默认
`nativeImage`	`auto`	`auto` 超限额自动降级 / `full` 原图 / `compact` 始终小图
`visionProvider` / `visionModel`	`deepseek-official` / `deepseek-v4-flash-vision-exp`	`vision` 观察者路由
`extremePatterns`	`[]`	极危清单（正则源数组）：命中元素标签 → 警告注记，不阻断
`deliveryMode`	`auto`	投递策略，见上节

dsh-computer-use

同名包的其他仓库

安装

说明文档

配置