deepseek harness computer use 不生效：截图黑屏、点击偏移与权限弹窗排查

computer use 不生效，先别重装。 截图黑屏、点击偏移、权限弹窗、完全无响应，这四种现场分别对应能力、坐标、门禁与加载四层；分层判断比反复安装快得多。

先分诊：四种现象对应四层

同样是「不能用」，四种现象的原因完全不同。 先看现象，再决定查哪一层。

分诊的意义是避免在错误层面重装，四种现象也可能叠加。 权限问题重装十次也不会好，坐标问题换插件也不会好；先定位层，再动手。例如既黑屏又偏移，先解决黑屏（权限），再看偏移（坐标）；一次只处理一层。

症状一：截图全黑或空白

截图黑屏有两种可能：没权限，或截错了对象。 判断方法在日志里。

1. 看有没有截图调用。 有调用但返回全黑，偏系统权限；没有调用，说明流程还没走到截图，先查加载与门禁。
2. 查系统授权。 macOS 需要屏幕录制权限，Windows 与 Linux 的授权项不同；授权后通常要重启应用才生效。
3. 确认截的是哪个屏。 多显示器或虚拟桌面下，截到的可能是空白桌面，而不是目标窗口。
4. 换一个目标复测。 用系统自带窗口做对照，能区分「所有窗口都黑」还是「某个应用不允许截屏」。

权限类黑屏的典型特征是「调用成功、图像为空」。 工具没报错，但返回的图没有内容；这种情况下重装插件没有意义，去系统设置里补授权。

部分应用会主动阻止截屏。 受保护窗口、DRM 内容或安全软件覆盖层，可能永远截不到；这类情况应换目标，而不是继续排查插件。

症状二：点击偏移或点不中

点击偏移几乎都是坐标换算问题，不是「AI 点歪了」。 坐标来自截图，点击落在另一套坐标系里，就会出现稳定偏移。

1. 把缩放调到 100%。 系统缩放与截图分辨率不一致时，坐标会按比例偏移；调到 100% 是最快的对照实验。
2. 只保留一个显示器。 多显示器有各自的坐标原点，屏幕排列与实际位置不一致时，点击会落到另一块屏。
3. 确认截图与点击用同一套坐标。 有的实现按物理像素，有的按逻辑像素；混用时偏移量会随缩放变化。
4. 用固定元素复测。 选一个位置不变的按钮，连续点三次；每次都偏同样的距离，说明是坐标换算；偏移量随机，才是识别或定位问题。

偏移量稳定是最重要的判据。 稳定偏移 = 坐标问题；随机偏移 = 元素识别或页面加载问题，两者处理方向完全不同。

全屏与窗口化也会影响坐标。 切换窗口模式后复测一次，能排除窗口边框与标题栏带来的偏移。

症状三：权限弹窗反复出现

弹窗不是故障，是工具门禁在工作。 它拦下的是「未经审批的桌面操作」，而不是插件加载失败（来源）。

1. 看弹窗内容。 是请求屏幕权限、请求操作某个窗口，还是请求放宽沙箱；三种请求对应三种配置。
2. 看门禁策略。 当前 profile 的审批范围是否覆盖了该工具；范围太窄会反复弹窗，范围太宽会失去保护。
3. 缩小任务范围。 只让 agent 操作目标窗口，而不是整个桌面；范围越小，需要审批的动作越少。
4. 保留确认。 不建议为了省事完全关闭审批；桌面操作的风险高于普通工具，保留关键确认是必要的边界。

弹窗反复出现，说明策略与任务不匹配。 要么任务范围太大，要么审批规则太细；调任务比关审批更安全。

不要把「关掉弹窗」当成修复。 关掉之后动作能执行，但风险也失去了拦截；正确的做法是让任务范围与审批范围对齐。

症状四：完全无响应

完全无响应，说明调用根本没发生。 这种现场要看三层：加载、沙箱、门禁。

1. 加载层： dsh plugin --profile web list 是否有插件；没有就是装错 profile 或安装中断。
2. 沙箱层： computer use 需要比普通工具更宽的授权，默认最小权限 profile 往往不够（来源）。
3. 门禁层： 工具是否被策略直接拒绝；日志里会有拒绝记录，而不是「什么都没发生」。
4. 兼容层： 前三层都正常仍无响应，再检查系统版本与插件版本是否匹配。

「什么都没发生」通常不是真的什么都没发生。 日志里至少会有一条加载、拒绝或超时记录；找不到记录，说明你看的不是当前 profile 的日志。

五分钟取证顺序

时间有限时，按这个顺序取证，能最快定位层。 每一步都留下一条可对照的记录。

1. 看现象： 黑屏、偏移、弹窗还是无响应，先归类。
2. 看日志： 有没有工具调用、有没有拒绝、有没有超时；三者对应不同层。
3. 做单变量： 只改缩放，或只改显示器，或只改审批范围；一次只动一个。
4. 做对照： 换一个目标窗口或换一个 profile 复测；结果不同，说明问题在环境而不是插件。
5. 记录版本： 系统版本、插件版本、profile 名写进记录，后续复现才有基准。

取证的目标是缩小范围，不是找到「罪魁祸首」。 能排除三层，剩下的那层就是方向。

恢复默认与关闭

排查结束后，把临时改动收回去。 否则下次使用会带着一堆实验配置。

1. 恢复缩放与显示器设置： 临时调到 100% 或单屏的，改回原值。
2. 恢复审批范围： 临时放宽的审批收回到原范围，保留关键确认。
3. 恢复沙箱： 临时放宽的沙箱授权改回最小可用级别；不用时直接关闭 computer use。
4. 清理测试记录： 测试产生的截图与日志单独存放，避免混进正式会话。

恢复默认不是目的，回到已知可用才是。 如果默认配置本身不满足任务，记录下可用配置，下次直接复用。

什么时候不该用 computer use

computer use 的权限面比浏览器控制大得多，能不用就不用。 三种场景优先选更窄的能力。

1. 只做网页自动化： 用浏览器控制类插件，权限面更窄，行为更可预期。
2. 只需要读写文件或跑命令： 用内置工具，不需要桌面操作。
3. 任务不可回滚： 涉及支付、删除、系统设置的操作，不要交给无人监督的桌面自动化。

最小权限原则在这里同样适用。 用不到桌面的场景，不要开 computer use；开着的场景，用完即关。

下一步

先分诊，再取证，最后恢复。 想看 computer use 的开启与能力边界，看《DeepSeek Harness 怎么开启 computer use》；想区分浏览器控制与桌面操作，看《dsh-browser 是什么》；想了解沙箱模式，看《DeepSeek Harness 沙箱有什么用》。

来源：dsh-computer-use 插件页、DeepSeek Harness 官方文档 - 进程沙箱、DeepSeek Harness 官方文档 - 工具子系统