本指南对应 App v0.1.3：macOS 15+、Apple 芯片。第一次使用请先完成安装与连接；已有连接的用户可直接按下方任务查找操作。
找到你需要的入口#
| 入口 | 用来做什么 |
|---|---|
| 概览 | 连接服务器；查看本机执行记录和已上报用量；检查连接或打开日志位置。 |
| 侧栏中的 Codex / DeepSeek Harness | 查看安装、原生会话默认配置、可用模型，按需测试模型响应。 |
| 设置 | 调整外观与登录后自动连接；需要排查时查看技术信息。 |
连接这台电脑
- 向服务器管理员取得邀请链接或
device-pairing.json。 - 在概览粘贴邀请并点击“确认”，或点击“选择文件”。不要选择已有的设备
config.json。 - 核对服务器和本机执行目录，再确认接入。
- 概览显示“已连接”后，回到提供邀请的产品使用。
一台客户端一次绑定一个服务器。邀请过期或已领取时，先核对原接入结果，再联系管理员。上次接入中断时，使用界面提供的“继续接入”完成原流程，不要反复领取邀请。
查看模型与权限
侧栏中的 Harness 详情显示已选原生环境：安装版本、当前原生会话的模型与推理强度，以及接口能提供的权限信息。这些内容只读，界舟不会替你改原生设置。模型和默认值包含该电脑已有的本地配置覆盖，不一定是 Harness 官方出厂默认；dsh 也可以配置其他供应方的模型。
模型名称与供应方分别呈现，执行时保留原始模型标识。当前 dsh ACP 不提供可查询的权限模式，界面显示“由原生 Harness 管理”。需要原生审批时，在任务发起方处理。具体任务仍可按调用方与设备配置选择模型或参数。
信息由本机后台读取，读取模型目录不调用模型；普通状态更新使用缓存，需要时点击“重新读取模型信息”。有执行或结果待核对时，先等待或核对原记录。
“模型响应测试”是可选检查，会使用模型额度。Codex 测试使用原生只读模式；dsh 沿用原生权限，不提供只读保证。安装被发现只表示找到了程序，测试通过也只证明这次响应。
查看执行记录与用量
执行记录按独立编号列出，可区分同一个 Harness 的并发任务。范围是近 24 小时开始的执行，以及更早开始但尚未结束的执行。
| 状态 | 如何理解 |
|---|---|
| 执行中 | 后台已观察到任务正在执行。 |
| 待确认 | 缺少完成证据；不能当作成功或已取消。先查询原结果。 |
| 已结束 | 原生执行已有完成、失败或取消结果；业务是否完成由调用方产品验收。 |
列表先显示 10 条，可继续显示更多；一次快照最多 50 条，优先保留未结束项。它不是完整历史分页。分类计数与用量按统计范围计算，不只计算当前可见行。
Token 用量按 Harness 分开，仅统计通过本机 Dock 执行且已上报的用量。“未上报”不等于零，缓存输入属于输入的一部分，不重复相加。Codex 用量在执行结果落盘后更新，不是实时 Token 速率。
主窗口或菜单栏面板显示时，普通快照约每 10 秒刷新；固定测试或待核对测试收据期间约每 2 秒。界面隐藏时暂停普通轮询，独立后台继续记录。忙碌操作或系统弹窗会延后刷新。
暂停连接、自动连接与日志
| 想做什么 | 在哪里操作 |
|---|---|
| 暂时不再接收任务 | 概览 → 服务器区域 → 停止连接。保留服务器绑定，之后可再启动。 |
| 改接另一个服务器 | 概览 → 服务器更多操作 → 移除服务器；再使用新邀请接入。旧身份与历史保留。 |
| 登录电脑后自动连接 | 设置 → 登录后自动连接。改变下次登录行为，不会立即重启当前服务。 |
| 排查连接 | 概览 → 连接工具 → 检查连接；查看结论，需要时展开明细。检查不发送模型请求。 |
| 查看日志 | 概览 → 日志位置，直接在 Finder 中定位文件。 |
| 关闭界面 | 关闭窗口或退出 App。独立后台继续运行。 |
停止或移除前，后台会检查是否有正在执行或结果待核对的任务；不能安全操作时会拒绝，并保留原状态。断线不会自动重派任务，也不表示本机任务已结束。
安装与原生环境#
App 自带运行时和后台；Codex/dsh 的安装、登录与原生配置由设备用户准备。平时不需要打开它们的桌面客户端，后台会使用已选安装。具体工具是否能工作，仍取决于原生权限和系统授权。
日常使用#
从菜单栏打开主窗口，或直接打开 App。侧栏切换概览、Harness 详情与设置；⌘, 打开设置，⌘1 回到概览，⌘R 刷新。业务任务始终在发起任务的产品中操作。
更新 App 与后台#
替换 App 不会自动更新正在运行的后台。旧后台若不提供执行快照或模型信息，界面会说明“不可用”，不会生成示例数据。请在设备空闲、没有待核对任务时，由管理此安装的人更新后台；命令与保留范围见后台升级与回滚。
从 v0.1.2 升级时先确认 macOS 15+。旧版下载与历史说明保留在v0.1.2 Release；新界面操作以本页为准。
遇到问题#
先看常见问题。没有邀请联系服务器管理员；显示模型读取失败则检查所选 Harness 的原生登录和配置；执行待确认时保留原编号，查询原结果。
旧版操作说明#
v0.1.1/v0.1.2 使用 Swift 菜单栏界面，与本文不同；请查看相应 Release。无需为寻找旧按钮重新接入或清空当前连接。
统一桌面布局
macOS 与 Windows 源码客户端共用同一套 GPUI 桌面布局：左侧概览、Harness 与设置导航，右侧面包屑和页面内容，底部本机平台与执行目录。两端默认窗口均为 1100×740，使用相同页面尺寸与滚动状态。标题栏、窗口按钮、快捷键和托盘行为按操作系统适配，不再为 Windows 维护另一套小窗口工具栏导航。