路线一 · 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 可以运行,但尚未做过真机完整验收。
哪些功能需要订阅
免费层不需要 license,但只显示一个工具(自选,可换,同一时间只开一个):该工具的任务、控制预览、用量、实况与回跳都可用。试用或有效订阅解锁三家工具、跨工具的项目总览,以及配置写动作(一键开关的「确认写入」)。
试用与计费
月付先免费试用 30 天,之后自动按 $7.99/月续费;开始试用需绑定付款方式,可随时在「管理订阅」里取消。试用结束前取消不会扣款,到期后回到免费层(一个工具)。
年付同样先免费试用 30 天,之后自动按 $79.99/年续费(比月付省两个月),同样需绑定付款方式。免费层始终保留一个工具的完整只读能力,无需注册。
获取与导入
- 开始试用、直接订阅或输兑换码完成后,浏览器自动跳到激活页:在那里下载
license.json;安装包从官网「下载免费版」入口获取。 - 面板底部点「导入 license」选中该文件,或把文件直接拖进面板;写入
~/.wingman/license.json,旧文件自动备份。
license 丢了
用浏览器历史里保留的激活页地址重新打开即可下载;找不到地址就提交支持请求。激活页不存任何东西——license 文件就是凭证。
续期与离线宽限
- 在面板点「刷新授权」即可换取最新状态;没有打开面板时,也可运行
npx harness-wingman license refresh。两种方式都只会在你明确操作时联网;npx harness-wingman license status查看当前状态。 - 30 天试用 license 到试用结束日即止,不叠加 14 天宽限;未转为付费时回到免费层:只显示一个工具,其余工具与项目总览锁定,写动作锁定。
- 正式付费 license 到期后有 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 收集什么数据
Wingman 没有自动遥测或自动统计。远端处理只由你的明确动作触发:分享样本并确认预览、激活/刷新 license、点击或提交私密反馈,或者发送支持邮件；完整字段与时机见数据与隐私 /data。
私密报告问题
打开私密 Bug / Feature 表单。点击打开时,Tally 会收到白名单复现提示并可能处理连接信息；问题正文和可选截图只有提交时才发送。不要提交 prompt、源码、文件路径、账号信息或凭证。
表单不可用、Billing 或 Security 问题请邮件联系 support@getwingman.dev。不要发送密钥或完整 license。处理者与留存见数据与隐私 /data。