路线一 · macOS 安装包
从官网首页获取 dmg:订阅或输兑换码后在激活页下载;免费版(只读面板,不用注册)可直接下载。当前只有 Apple Silicon(aarch64)构建。
- 打开 dmg,把 Wingman 拖进 Applications,启动即可:屏幕顶部出现药丸(悬浮岛,托盘菜单可关),菜单栏出现托盘图标。
- dmg 安装不带全局
wingman命令;本页所有终端命令统一用npx harness-wingman …形态,两条路线通用。
路线二 · npx
终端运行 npx harness-wingman serve,在浏览器打开输出里的 http://127.0.0.1:7333(默认端口 7333,可用 --port 换)。面板只绑 127.0.0.1,面板与数据都在本机。
Linux / Windows
桌面安装包目前只有 macOS。npx 路线(CLI + 浏览器面板)在 Linux / Windows 可以运行,但尚未做过真机完整验收。
哪些功能需要订阅
解剖(CONTEXT 组成)与实况免费,不需要 license;只有配置写动作(一键开关的「确认写入」)需要有效订阅。
获取与导入
- 订阅或输兑换码完成后,浏览器自动跳到激活页:在那里下载
license.json与安装包。 - 面板底部点「导入 license」选中该文件,或把文件直接拖进面板;写入
~/.wingman/license.json,旧文件自动备份。
license 丢了
重新打开激活页(付款完成后到达的那个页面,从收据里的链接可以再进)下载一份即可。激活页不存任何东西——license 文件就是凭证。
续期与离线宽限
- 联网运行
npx harness-wingman license refresh:订阅仍有效即换发新 license,写回~/.wingman/license.json;npx harness-wingman license status查看当前状态。 - 到期后有 14 天离线宽限期:断网或一时没续上,不会立刻锁;超过宽限期只锁写动作,解剖与实况照常。
- 停订后 refresh 会被拒(停订即锁);重新订阅即可恢复。改卡、停订、发票走官网页脚「管理订阅」。
接线 = 把 harness 的 hooks 指到本机面板,实况与任务视图才有数据。统一命令(两条安装路线相同):
npx harness-wingman hook install cc|codex|dsh
- 写前自动备份,重复执行幂等;默认指向端口 7333,面板换过端口就加
--port。 - 解线:
npx harness-wingman hook uninstall <harness>,配置恢复到接线前的逐字节原样(byte-identical);若接线后你自己改过该文件,只移除 Wingman 写入的条目,保留你的改动。
Claude Code
写入 ~/.claude/settings.json 的 hooks(http 型,直指面板;不碰 ~/.claude.json)。Claude Code 热加载 hooks 配置:接线零重启,新事件直接进面板。
Codex
写入 ~/.codex/config.toml 的受管 hooks 块(command 型转发脚本)。接线后还差两步:
- 完整退出并重开 Codex(⌘Q 重启——它只在启动时读 hooks 配置)。
- 在 Codex 里输入
/hooks,把 Wingman 设为 Trusted 且 Enabled(Codex 要求新 hook 由你亲自信任后才会执行)。之后用新任务验证,事件应进入面板。
升级 Wingman 不需要重新信任:受管命令保持不变,信任记录跟着命令走。
dsh
走 dsh 内置的 hooks-claude-code 兼容层,版本钉在 0.1.1-rc.2:dsh 处于 pre-release(SESSION_FORMAT_VERSION=0,官方不承诺兼容),其他版本不保证可用。现状与限制:
- 接线写配置之外,兼容插件需一次性手动安装:
dsh plugin --profile <你的 profile> add @deepseek-ai/dsh-hooks-claude-code@0.1.1-rc.2(Wingman 只写最小配置,不代跑包安装)。 - 面板读 dsh 配置(解剖)需要
dshCLI 在 PATH 上;读不到时 dsh 标签页显示说明,而不是整家消失。 - dsh 的
--dump-config输出不含文件路径与字节数,面板不做 token 估算(不显示没有来源的数字)。
菜单栏找不到 Wingman 图标
MacBook 刘海会挡住排进它下面的菜单栏图标。按住 Command 拖动菜单栏图标,把 Wingman 挪到时钟旁边即可见。
怎么升级
0.4.0 起:托盘菜单点「检查更新」,发现新版确认一次,app 自行下载、验签、原地替换并重启。检查只在你手动点击时发起,没有任何后台自动检查。0.3.0 及更早版本没有这套 updater,升到新版需要最后一次手动下载替换。npx 路线不需要升级动作,每次运行即当前发布版(前提是没有旧的全局安装,见下条)。
装了新版,面板还是旧样子 / 端口被占
多半是以前 npm install -g harness-wingman 留下的旧全局版本:npx 会优先用它而不去取新版,它起的 serve 还会占住 7333 端口。运行 npm uninstall -g harness-wingman 卸掉即可。
Wingman 收集什么数据
对外发送的只有一类:你逐次主动分享、发送前可逐字预览删减的样本——除此之外零遥测,没有任何自动统计。口径与沿革见数据明细 /data。