先找到你看到的问题。普通设备用户从 App 的“概览 → 检查连接”开始；不要通过重复接入、重新发任务或清空历史来排查。
没有邀请链接#
邀请由服务器管理员生成，App 不能自行创建。向提供服务的人索取；如果你是管理员，按邀请与访问权限生成设备邀请。
选择 config.json 后提示文件无效#
本机 config.json 是已经接入的设备配置，不是新设备配对文件。请使用管理员导出的 device-pairing.json 或邀请链接。不要手工复制字段或创建新设备身份。
App 显示未连接#
先看概览的连接提示。后台已停止时启动连接；正在重连时检查网络和服务器；检查提示凭据失效时联系管理员。更新后先允许 App 访问原配置所在目录，再刷新，不必重新领取邀请。
发现了 Harness，但不能使用#
“已安装”只表示找到了程序。先在原生 Codex/dsh 中确认登录、模型配置与额度。任务到达时后台会启动原生环境，不要求桌面客户端一直打开。需要进一步确认时，可在 Harness 详情手动运行响应测试。
dsh 为什么显示其他模型或没有权限模式#
dsh 是执行框架，也能使用本机配置的其他模型供应方。App 显示的是当前原生会话配置，包含本地覆盖。当前 dsh ACP 没有可查询的权限模式，因此显示“由原生 Harness 管理”；需要审批时仍在任务发起方处理。
任务一直待确认#
这表示缺少完成证据，不代表成功或已取消。保留执行编号，在原产品查询原任务。断线不会自动重派；也不要换编号重新提交同一项工作。详细规则见任务状态与断线处理。
停止或移除服务器被拒绝#
先确认是否有执行中、结果待核对或尚未确认的测试。后台拒绝不安全操作时保留原绑定。若操作结果未知，刷新核对原状态，再查看日志；不要反复点击或结束保存 PID 对应的进程。
原生工具提示权限被拒绝#
权限由原生 Harness 和操作系统管理。后台进程不一定继承桌面客户端已有授权。请核对原生提示与进程来源；Dock 不绕过这类限制，也不把协议连接成功当作工具已获授权。
更新 App 后，执行或模型信息不可用#
界面和独立后台分别运行。旧后台缺少对应接口时，需要在空闲且没有待核对任务时显式更新。见升级与回滚。
怎样向维护者反馈#
在概览点击“日志位置”，Finder 会定位本机文件。反馈系统版本、App 版本、操作步骤和脱敏错误；不要公开完整日志、配置、凭据或私人任务内容。
macOS 阻止首次打开#
此 Alpha 尚未完成 Apple 公证。先确认来源与摘要；无法打开时向维护者反馈系统版本和脱敏提示。