悟码工作台 · Wuma Works 新用户手册

适用版本 0.10.1 · 2026 年 9 月。Word / PDF 由同一份内容生成；截图全部是示例数据（账号 / 项目 / 机器码虚构）。

1　悟码工作台是什么

悟码工作台（Wuma Works） 是装在你自己电脑上的 AI 工作台。它把你所有的 Cursor 账号、额度和 AI 对话放在一张台子上：帮你管理多个 Cursor 账号、一键切换、看清每个账号还剩多少额度；把 Cursor 里 AI agent（帮你写代码的 AI 助手）的提问集中到一个窗口里，你在悟码里回复就行，不用在多个 Cursor 窗口之间来回找。

• 账号总览：所有 Cursor 账号的套餐、到期时间、额度用量一屏看完，点一下就切换账号。
• Cursor 会话：Cursor 里每个 agent 对话在悟码各成一条。agent 干完活或需要你拍板时会停下来等你，你在悟码里回复或点选项即可。
• 多开实例：同时开几个互相隔离的 Cursor，每个登录不同账号、装不同扩展。
• 模型用量：看所有账号这个周期在各个模型上花了多少钱。
• 手机端（正式卡）：装上安卓 App「悟码远程」，出门在外也能看 agent 干到哪、回复它、点决策卡（第 11 章）。

2　装之前要准备什么

3　安装

Mac

1. 双击下载好的 悟码工作台-darwin-arm64-0.10.1.zip，解压出「悟码工作台」。
2. 把「悟码工作台」拖进「应用程序」文件夹。
3. 在「应用程序」里双击「悟码工作台」。第一次打开，系统会弹出「未打开“悟码工作台”」「Apple 无法验证……」，点 完成。
4. 打开「系统设置 → 隐私与安全性」，往下滚到「安全性」，能看到「已阻止“悟码工作台”以保护 Mac」，点旁边的 仍要打开，再在弹窗里点 仍要打开，按提示输入开机密码（或按触控 ID）。
5. 悟码打开，出现「激活悟码工作台」窗口，接着看第 4 章。以后再打开就是正常双击，不用重复这几步。

xattr -dr com.apple.quarantine /Applications/悟码工作台.app

Windows

1. 在下载好的 悟码工作台-win32-x64-0.10.1.zip 上点右键 →「全部解压」，解压到任意文件夹（桌面、D 盘都可以，中文路径也没问题）。不要在压缩包里直接双击运行。
2. 打开解压出来的文件夹，双击 悟码工作台.exe。
3. 如果出现蓝色窗口「Windows 已保护你的电脑」，点 更多信息 → 仍要运行。
4. 如果杀毒软件把 exe 隔离了：打开「Windows 安全中心 → 病毒和威胁防护 → 保护历史记录」，找到悟码工作台，选「允许在设备上」，再双击运行。
5. 悟码打开，出现「激活悟码工作台」窗口，接着看第 4 章。

• 悟码是免安装的：不写注册表、不加开机启动；以后删掉这个文件夹就等于卸载。
• 关闭主窗口 = 缩到屏幕右下角的托盘，悟码还在后台运行；双击托盘图标回到窗口，托盘图标右键「退出」才会完全退出。
• 窗口顶部的菜单栏默认隐藏，按 Alt 键显示。

4　激活

第一次打开悟码会先弹出「激活悟码工作台」窗口。把收到的卡密粘贴进去，点 激活。卡密是 5 组、每组 4 位的字母或数字；带空格或小写也没关系，悟码会自动转成大写并加上横线。

激活成功后会显示「激活成功，正在打开悟码…」，主界面随即自动打开，激活窗口自己关掉。输错了会在输入框下面用红字告诉你原因，比如卡密里有一位输错时会提示「卡密不存在」。

常见提示和处理办法：

• 本机机器码是这台电脑的识别码（由系统 ID 加密计算出来，不含任何个人信息）。联系客服时点旁边的 复制，把它发给我们。
• 在激活窗口点 退出 或直接关掉窗口，就是退出悟码；下次打开还会先要求激活。

5　第一次使用：三步向导

激活后账号库还是空的，悟码会自动打开「三步把悟码用起来」向导。每一行前面的红点表示「还没做」，点这一行右边的按钮就能完成它；完成的行会变成绿点。

第 1 步：添加账号

有两种加法，可以都用：

• 收录 Cursor 当前登录（最快）：点向导底部的「先跳过，直接进入」来到「账号总览」，点 ＋ 收录 Cursor 当前登录。悟码会把你的 Cursor 里正在登录的账号收进来，不联网、不改动 Cursor。
• 官方授权登录：点 ＋ 添加账号，在「OAuth 授权」页点 在浏览器中打开，在打开的 Cursor 官网页面点「确认登录」，账号会自动加进来并拉取额度。要加别的账号时，改点 在受控窗中打开，在弹出的窗口里登录那个账号（这个窗口和你的浏览器互不影响）。

第 2 步：让 Cursor 接上悟码

这一步让 Cursor 里的 agent 对话出现在悟码的「Cursor 会话」页。依次点三个按钮：

1. 安装 IDE 会话桥：给 Cursor 装一个可以一键还原的小改动，用来把对话同步到悟码。它只对之后新打开的 Cursor 窗口生效，不会重启你正在用的 Cursor。
2. 安装到 mcp.json：在 Cursor 的 MCP 配置里加一个悟码的条目（MCP 是 Cursor 连接外部工具的接口，agent 靠它把问题送回悟码）。只加这一条，你原有的其它条目原样保留。
3. 关闭自动更新：Cursor 一自动升级，第 1 项的改动就会被冲掉，所以建议关掉。以后要恢复自动更新，在「设置 → Cursor 版本与自动更新」里一键还原。

第 3 步：新建第一条会话

1. 点 在新实例中打开目录…，选你的项目文件夹。悟码会新开一个独立的 Cursor 窗口打开它（第一次要在这个窗口里登录 Cursor），它会自动连上悟码。
2. （建议）窗口连上后，健康检查的「悟码会话规则」一行会提示「去安装」。装上后，这个项目里的 agent 会一直通过悟码和你对话。
3. 到「Cursor 会话」页点 新建会话，选刚才的窗口，点 创建（详见第 7 章）。agent 报到后，这条会话就出现在列表里，你直接在悟码里给它派活。

三步都完成后，向导会显示三个对勾，按钮变成「全部就位，开始使用」：

6　账号总览

「账号总览」是悟码的首页。最上面四个数字依次是：账号数、所有账号的剩余额度合计、这个周期已经花掉的金额、需要关注的账号数（点一下只看这些账号，再点一下恢复全部）。

下面每一行是一个账号：

• 账号：邮箱（点一下复制）、备注、登录令牌还剩多少天有效；「当前」表示 Cursor 正在用这个账号。
• 套餐 / 到期：套餐名（Pro、Pro+、Ultra 等）和本计费周期还剩几天。
• 套餐额度：三条进度条——Cursor Models（Cursor 自家模型的套餐额度）、Other Models（第三方模型的套餐额度）、Grok Bot（每周额度），数字是已用比例；快用完时进度条变成琥珀色。

• 看到红色的 登录失效，或黄色的 无刷新令牌：点 重新授权，在打开的官网页面确认登录就修好了。
• 右上角 隐私 按钮可以把邮箱打上马赛克，方便截图给别人看。
• 「批量选择」可以一次勾选多个账号刷新或删除；「导出备份」是明文文件，用完请删掉。

7　Cursor 会话：在悟码里回复 agent

在 Cursor 里，agent 做完一段活或遇到需要你决定的事时，会停下来等你回复。装好第 5 章第 2 步之后，这些对话都会出现在悟码的「Cursor 会话」页：左边是会话列表，中间是对话内容，底部是输入框。你在这里回复，Cursor 那边的 agent 立刻就能收到，不用再切回 Cursor。

会话状态

每条会话前面有一个状态标签：

回复 agent

• 在底部输入框里写，按 Enter 发送，Shift + Enter 换行。
• agent 给了建议回复时，点一下建议就直接发出去。
• 可以粘贴截图、把文件拖进输入框；「快捷指令」里能存常用的话，一键加到输入框。

决策卡

agent 想让你在几个方案里选一个时，会发来一张「需要你拍板」的卡片。点选你要的选项，有多道题就点「下一题」，最后点 提交选择。都不合适的话，直接在下方输入框写你的想法，发出去就算这张卡的答复。

看 agent 正在做什么

agent 干活时，对话里会实时显示它的「执行过程」：读了哪些文件、改了哪些文件（改动的几行跟着这一步一起出来，正在写的时候先露前几行）、跑了什么命令。默认显示最近 15 步，点「展开全部」看完整过程；想多看或少看，在「Cursor 会话」页左下角 设置 → 偏好 → 执行过程露最近几步 里改（手机端跟着一起变）。

输入框下面、模型名旁边的「上下文 29% · 286k / 1M」是这条对话此刻用掉的上下文，和 Cursor 输入框里的 Context Usage 是同一个数；75% 起变提醒色、90% 起变红，快满时可以考虑开新对话或用「转移上下文」接着做。

「在等你」收件箱

左侧栏顶部的 在等你 会汇总所有正在等你回复的会话，数字就是等你的条数，点一条直接跳过去。悟码不在前台时还会弹系统通知，点通知也能直达那条会话（可以在「设置 → 常用」里关掉）。

新建会话

点会话列表上方的 新建会话：选目标窗口（已经连上悟码的 Cursor 窗口），选模型，设数量和第一条指令，点 创建。悟码会在那个 Cursor 窗口里新建对话并发出第一条指令，agent 报到后这条会话就出现在列表里，状态是「待命」。

其它常用操作

在左侧的会话上点右键（或点对话标题栏最右边的「⋯」），能找到这些操作：

• 停止当前回合：让 agent 立刻停下这一轮。
• 查看会话：跳到 Cursor 里对应的那个对话。
• 转移上下文：一条对话太长时，把它的来龙去脉交给另一条会话接着做。
• 置顶、重命名、移动到文件夹、删除：整理列表用；在悟码里重命名，Cursor 里那条对话的名字也跟着改；删掉的会话先进「回收站」，可以恢复。

8　多开实例

「多开实例」可以同时开几个互相隔离的 Cursor：每个实例有自己的登录账号、扩展和设置，和你平时用的 Cursor 互不影响。

1. 在输入框里写一个名字，比如「工作」「测试」，点 ＋ 新建并启动。
2. 悟码会打开一个全新的 Cursor 窗口。第一次启动需要在里面登录 Cursor、按需装扩展。
3. 以后在列表里点 启动 就能再次打开它。删除实例会把它的数据移进废纸篓（Windows 是回收站）。

9　模型用量

「模型用量」汇总所有账号这个计费周期在各个模型上的花费：上面是合计和占比，下面按账号拆开。数据来自 Cursor 官网，在「账号总览」点 刷新全部 就会更新（悟码默认每 30 分钟自动刷新一次）。

10　设置

健康检查

设置页最上面是「健康检查」，列出悟码正常工作需要的五件事。全绿就是「一切就位」；哪一行不是绿的，点右边的按钮一键修。左侧栏最下面的「健康检查」和顶部的四个小标签是同一份状态，点它们也会跳到这里。

授权

「授权」一栏显示卡的类型、到期时间、卡密末 4 位、本机机器码和上次联网校验的时间。左侧栏悟码名字下面也会显示「试用 · 剩 N 天」。

• 联网校验：马上联网核对一次授权。
• 复制机器码：联系客服时用。
• 解除本机绑定：正式卡换电脑时用，解除后这张卡可以拿到别的电脑上激活。试用卡不能换绑。

外观和常用选项

「外观」点一下就切换：暖纸（默认浅色）、石墨（深色）、跟随系统，另有两套经典配色。下面几项常用选项改完点 保存设置：

• 自动刷新额度的间隔（默认 30 分钟，填 0 关闭）。
• 菜单栏托盘图标：右键托盘就能按剩余额度快速切换账号。
• agent 在等你时弹系统通知。
• 当前账号额度用完时，自动切到剩余最多的账号。

Cursor 版本与自动更新

悟码加给 Cursor 的功能都改在 Cursor 的安装文件里，Cursor 一自动升级就会失效，所以这里建议保持「自动更新已关」。要升级 Cursor 时，先确认悟码已经适配了新版本；需要恢复自动更新就点「还原原设置」。

11　手机端：在手机上看和回复会话（正式卡）

装上安卓 App 悟码远程，不在电脑前也能看每条会话进行到哪、回复 agent、点决策卡、停止或新建会话。手机端是正式卡功能：试用卡激活的悟码打不开远程连接，设置页会写明「试用卡不包含手机端」。

它是怎么连上的

• 手机和电脑都连到你自己云服务器上的「悟码中继」（一个很小的程序）。我们不运营中继，你的会话不经过我们的服务器。
• 手机和电脑之间全程端到端加密，中继只负责转发，看不到内容。
• 手机只能碰会话（看、回复、停止、新建、转移），碰不到账号、文件和命令；手机丢了在电脑上一键吊销，它就再也连不上。

要准备什么

第 1 步：在云服务器上装中继（只做一次）

1. 把中继安装包的四个文件传到服务器的同一个目录，比如 /root/wuma-relay。
2. 用 root 登录服务器，进到这个目录，运行下面这一行（把 你的公网IP 换成服务器的公网 IP；ARM 服务器把文件名换成 wuma-relay-linux-arm64）。脚本会先核对文件没被改过，再装成系统服务、开机自动启动。
3. 装完最后会打印一串 wuma-relay:// 开头的电脑连接码，整串复制下来，下一步要用。它等于这台中继的钥匙，别发给别人。
4. 到云服务器控制台的「安全组 / 防火墙」里放行 TCP 8443（入方向）。

bash install.sh --binary ./wuma-relay-linux-amd64 --host 你的公网IP

第 2 步：在悟码里填连接码、打开远程连接

1. 打开悟码 →「Cursor 会话」页 → 左下角 设置 → 左边选 手机端。
2. 把电脑连接码整串粘进「粘贴中继的电脑连接码」下面的框里，点 保存连接码。
3. 点 打开远程连接，顶部状态变成「已连上中继」就好了。建议同时勾上「远程开着时不让这台电脑睡眠」：电脑一睡眠，手机就连不上了。

第 3 步：手机扫码配对（每台手机只做一次）

1. 手机装好 悟码远程 并打开，首页就是「还没配对电脑」。
2. 在电脑上点 出配对二维码，屏幕上出现一个二维码（5 分钟内有效，只能用一次）。
3. 在手机上点 扫码配对，对准电脑屏幕上的二维码。
4. 手机上会显示 6 位核对码，电脑同时弹出「新设备请求配对」。两边数字一样就在电脑上点 允许；对不上或者不是你本人在操作，点「拒绝」。
5. 手机自动进入会话列表，配对完成。以后打开 App 直接就是会话列表，不用再扫。

配好以后

• 手机上的会话列表和电脑同步：点进一条就能看执行过程、回复、点决策卡；右上角可以停止当前回合或重试。
• 一台电脑最多配 5 台手机；在电脑「设置 → 手机端」底部能看到每台手机上次在线的时间。
• 手机底部四栏：会话（全部会话）· 在等你（agent 在等你回复的，图标上带数字）· 进度（创建进度 / 转移作业）· 我的（后台保持连接、省电设置、回收站、快捷指令、解除配对）。
• 手机要连得上，电脑上的悟码必须开着、远程连接开着、电脑没睡眠。
• 华为、小米等手机锁屏后会断网：在 App 底部「我的 → 后台省电设置」里按提示放行，锁屏也能收到「在等你」提醒。

手机丢了、换手机、不想用了

• 吊销某台手机：电脑「设置 → 手机端 → 已配对的手机」点那台手机后面的 吊销（点两次确认），它就再也连不上了。
• 全部断开：点 全部断开，所有手机都要重新扫码。
• 暂时不用：点 关闭远程连接，所有手机立刻断开；再点打开，已配对的手机自动连回来，不用重扫。

试用卡为什么用不了

手机端是正式卡功能。试用卡激活的悟码在「设置 → 手机端」顶部会写「试用卡不包含手机端（远程连接），换成正式卡后可用」，打开远程和添加手机的按钮都是灰的。换成正式卡激活后，之前填好的连接码和配好的手机都还在，远程会自动接着连。

12　授权、到期和断网

13　常见问题

悟码会上传我的账号吗？

不会。账号信息（含登录令牌）加密存在你自己的电脑上。悟码只连 Cursor 官方（查额度、官方授权登录）和悟码授权服务器（只发卡密、机器码哈希和版本号）。

切换账号会不会丢掉 Cursor 里的聊天记录或设置？

不会。切换只改 Cursor 的登录信息，不碰聊天记录、设置和扩展；切换前还会自动备份当前的登录信息（保留最近 10 份）。

会话页里看不到我的 Cursor 对话？

• 到「设置 → 健康检查」看 IDE 会话桥、协同 MCP、悟码会话规则这几行是不是都绿了，不是绿的点按钮修。
• 会话桥只对装好之后新打开的 Cursor 窗口生效：用「在新实例中打开目录…」开一个新窗口，或把 Cursor 完全退出后再打开。
• 装会话桥提示「没有写入权限」：到「系统设置 → 隐私与安全性 → App 管理」把「悟码工作台」打开，再装一次（只需一次）。
• Cursor 最近升级过的话，升级会冲掉会话桥，在健康检查里重新安装，并把自动更新关掉。

数据存在哪？

「设置 → 常用」里的 打开数据目录 可以直接打开第一个位置。目录名叫「Cursor 切号」是因为这是悟码以前的名字，沿用下来是为了老数据不用搬家。

Mac 上弹出「钥匙串」输入密码的提示？

悟码用系统钥匙串给账号库和授权信息加密。第一次安装不会弹这个提示；以后每次升级到新版本，第一次打开时 macOS 都会问一次是否允许悟码使用钥匙串里的这条信息（系统按安装包逐个授权，新版本要重新允许一次）：输入开机密码后点 始终允许 即可，同一个版本之后不会再问。点之前悟码不会出窗口；如果打开后没反应，先找找这个提示框是不是被别的窗口挡住了。万一点成了「拒绝」，退出悟码再打开，它会再问一次。

手机连不上电脑？

• 先看电脑「设置 → 手机端」顶部的状态：「已关」就点打开远程连接；「连接中…」一直不变或「出错」，多半是云服务器安全组没放行端口，或中继没在运行（服务器上 systemctl status wuma-relay 看一下）。
• 电脑睡眠 / 合盖 / 悟码退出了，手机就会显示电脑离线；打开电脑、打开悟码后会自动连回来。
• 手机显示「已被电脑吊销」：在电脑上重新点「出配对二维码」，手机上点「重新配对」扫码。
• 试用卡用不了手机端，见第 11 章最后一节。

托盘图标在哪？

Mac 在屏幕右上角的菜单栏，Windows 在屏幕右下角的通知区域（可能收在小箭头里）。可以在「设置 → 常用」里关掉。

怎么卸载？

1. 如果以后不再用悟码，先把它对 Cursor 做的改动还原：「Cursor 会话」页左下角 设置 →「桥」点 移除 IDE 会话桥；「设置 → 高级 · 实验性 → 协同 MCP」点 卸载 MCP 条目；「设置 → Cursor 版本与自动更新」点 还原原设置；装过「无感换号」或「悟码会话规则」的，也在对应位置卸载。
2. 用的是正式卡的话，在「设置 → 授权」点 解除本机绑定，这张卡还能拿到别的电脑上用。
3. 退出悟码：Mac 按 ⌘Q；Windows 在托盘图标上右键「退出」。
4. 删掉应用：Mac 把「应用程序」里的悟码工作台 拖进废纸篓；Windows 删掉解压出来的文件夹。
5. 想连数据一起删，再删掉上面「数据存在哪」里列的两个目录。

14　联系我们

反馈问题时请一起发来：悟码版本号（左侧栏悟码名字下面）、电脑系统和版本、问题截图；方便的话再附上日志（「设置 → 常用 → 查看日志」）。

附录：名词大白话