日常使用

这一篇讲每天怎么用：一个键打开总面板，开会话、看状态、回答问题；出了问题怎么说。电脑和手机上怎么连，单独一篇：电脑和手机上怎么连。第一次用先照 成员 · 快速开始 开出第一个会话。

先记住一句话：会话跑在 Tokenman 的机器上，不在你的电脑上。 关掉终端、合上笔记本、断网，会话都照常干活；回来敲 fleet，一切原样——直接回到你上次看的那个会话（换一台电脑、在手机上也一样）；那个会话已经关掉了，就打开 ⌘P 会话列表，光标停在你最近活跃的会话上，回车即接回；你在所有机器上一个会话都没有时，才给你开一个新会话（设置 FLEET_VIEW_LAND：panel 默认 · last 直接接回最近活跃的 · new 每次新开）。想去别的会话，fleet open <名称> 或 ⌘P 里选。

一个键：总面板

所有事都从一个键开始。下面的表由 Tokenman 的按键配置生成，改了默认按键，这里跟着变：

顶栏只管会话，消息单独一行。 看台顶上那一行只写会话本身：状态、标题、改动编号、额度。Tokenman 要告诉你的事——会话在问你、卡住、做完，告警，没人收的结果，临时提示（比如「暂停开新：内存紧张」）——放在顶栏下面单独一行：有没看的才出现，左边是最新一条，右边「✦ 3 · ⌘P」。出错（红 ✖）和没人收的结果（黄 ✓）一直留到你看过；警告（黄 ▲）6 秒、提示（灰 ∙）3 秒就淡出。全部看过，这一行就收起。点这一行，或打开 ⌘P 第一行 「✦ 消息」（或在 ⌘P 里打「消息」），分组列出全部：↵ 看全文，g 跳到那个会话，r 标为已读，没人收的结果按 f 转给编排。换了家，看到的消息和条数一样。在电脑的命令行里 fleet notices 也能看。

面板大致长这样（示例数据）。屏幕上从上到下的顺序就是 ↑↓ 走的顺序，到底再按 ↓ 回到最上、到顶再按 ↑ 到最底；缩进的行光标会停，顶格「─」开头的是组标题。

  › 搜索会话                       会话 8
  ✦ 消息
  + 新会话
  $ 命令行
─ 等你 1
  ! T128     Claude  登录页改版                  web-app
                     要不要保留旧的跳转？
─ 在干活 2
  ↻ T131     Codex   修复导出超时                web-app
  ↻          Claude  周报数据
─ 排队中 1
  ✓ T127     Claude  升级依赖                    web-app  等发布列车
  ▸ 已收起 4 个
  ⇄ 语言 / Language
  ⏏ 退出 Tokenman（会话在后台继续）
  ↵ 切过去  Tab 操作  ↑↓ 选  打字筛选  ? 图例  esc 关

开一个会话

• 开新会话：选「+ 新会话」按 Enter（在列表最上面，消息下一行），打开「新会话」小框：只有「仓库 ‹›」「Agent ‹›」「开 ↵」三项，打开时已选好、光标在「开」上，所以再按一次 Enter 就开。要换：↑↓ 或 Tab 换项，←→ 换仓库或 Agent（不需要仓库就选「不绑仓库」），在值上按 Enter 回到「开」。默认值：仓库是你正在看的会话的仓库（它没绑仓库时用上次新建选的，「不绑仓库」也算），Agent 是这个仓库上次新建用的；按 ⌘N 直接打开这个小框，再按 Enter 就开，Escape 关掉。不用写描述——开好后直接在会话里说要做什么；第一句话发出后，列表里这一行（以及它的任务记录）自动改名为这句话的第一行。
• 切到别的会话：打几个字（标题或单号）筛选，↑↓ 选中会话，Enter 切过去。

操作页、改名这样的询问、新会话小框都是整页：列表区域整块换掉，顶上一行写明对象（那个会话，或「+ 新会话」），下面一项一行，↑↓ 选、↵ 执行，没有浮窗。Escape 回上一层（从改名回到操作页，再按回到列表），回到列表时选中位置不变，再按一次关闭面板。鼠标单击选行，双击进入会话或打开新会话小框；页里的项目可以点击（点仓库或 Agent 再点一次换下一个，点「开」就开）。

小框里选的仓库和 Agent 按看台保存在本机私有文件中，下次打开还是它们。终端 resize 不重置选择，只在放不下时收紧滚动范围。建议至少 48 列；更窄时显示提示，Tab 和 Escape 照样可用，长内容在页内滚动。

会话的状态

标题统计仍打开的会话，搜索时显示匹配数/总数；折叠、置顶不改变总数。做完但窗口还开着的计入，已收起的不计入。远端读数失效或未知时用 +? 表示未确认部分。选中行只改变背景，状态字符和名称起始列保持不变；Ctrl+T 仍可置顶或取消置顶。底部只显示快捷键、可选图例和短暂反馈。

面板按「要不要你管」分五组：

批次（EPIC）的成员挂在批次驱动那一行下面，跟着它在哪组就在哪组，驱动那一行写「已完成/总数」。

每一行是同样的几列：状态图标 · 编号（这个窗口自己的短编号 K3F9，开窗就有、关窗为止）· Agent（Claude / Codex，取它最近一段对话的，读不到写灰色的「未知」）· 短名 · 仓库（没有仓库就空着）。状态看窗口在不在和它最后报的结果：报过好几次以最新一次为准；窗口关了没报过结果就是「已退出」。同一段对话开在两个窗口时，两行都是红色「等你」，原因写在操作页里。状态图标：↻ 运行中 · ! 等你 · ✓ 已完成 · ✗ 失败 · ◌ 已退出（Agent 退出了、窗口还在，收在「已收起」里）· ∙ 空闲 · ? 失联；只有 ! 和 ✗ 是红色。按 ? 看图例。

单号、PR、在哪台机器这些不再写在行上：选中一行，底部第二行会说它失联了多久、配置是否需要重开（红字）、子任务进度、PR 到了哪一步。单号不显示，但搜得到——打 4539 或 #4539，关联了这个单（或派单原话里写了 #4539）的会话会被找出来，底部写「匹配：关联 issue #4539」。一台机器连不上时，面板顶上会出现一整条红字，那几行整行变灰、图标是 ?；等它恢复就好，会话没有丢。

一个会话能做的事

选中一行按 Tab，是这一行的操作页：进入 · 打开 PR #n（有 PR 才有）· 改名… · 换成 Codex / Claude（会话活着时；这台机器用不了那个 Agent 时变灰、不编号、写原因）· 回收…。操作页下面列着这个窗口的编号、完整 ID、别名（旧的 T 号），和它经历过的每一段对话（Agent · 起止 · 怎么来的 · 压缩了几次）；还没登记到入口时写「未登记到 hub」。按数字直接执行，[ ] 切到上一个 / 下一个会话的操作页。会话在等你、Agent 已退出（在「已收起」里）时都用「进入」：切过去回答、在恢复页按 ↵ 接着做。在它的目录开 shell 是 ⌃\，置顶是 ⌃T（或列表底部的「置顶当前会话」），改回收方式让会话自己改，或用下面的命令。

在终端里也可以用命令做同样的事（<会话> 写名字的一部分、#单号 都行，认不出是哪个时会列出候选，不会乱猜）：

fleet ls              # 我的会话：名称 · 单号 · 机器 · 剩余 · 状态 · PR · 回收方式
fleet ls --all        # 连已结束的一起
fleet open 登录页      # 打开客户端并切到这个会话
fleet answer 登录页 保留   # 不进会话直接回答它的问题
fleet close 周报       # 关掉一个会话
fleet quit            # 退出 fleet（见下）

贴图和拖文件

在电脑上的 Tokenman 终端里，直接拖入文件，或按 Ctrl+V 粘贴剪贴板图片。传好后会自动插入会话所在机器的路径，多文件也一样，不需要另开上传菜单。普通文字粘贴不变。

准备和上传附件时，终端继续显示输出，也可以调整窗口大小。顶栏依次显示 Preparing（准备）、Uploading（已接收字节和总进度）、Confirming（确认）和 Uploaded（完成）。期间会明确提示输入已暂停：文字、回车和再次拖入的文件都直接丢弃，不缓存、不回放。按 Ctrl+C 只取消上传，恢复输入，不打断远端正在做的事。成功后只插入一次确认过的远端路径，不自动回车；失败、切换会话或断线时不插入任何路径，输入恢复后请重新输入。

一次最多 16 个文件，图片每个 10 MiB，其他文件每个 100 MiB，合计 100 MiB。传输最多等 120 秒。若无法确认当前会话，附件会明确失败，普通文字仍可输入。

在代码仓库里干活

交给仓库的任务，会话在自己的一份代码副本里改，不碰别人的；做完自己开 PR，检查通过后自己合并，然后告诉你结果。你在「排队中」里看到它，在 PR 上看改了什么。

你不用盯着它。要它停下、换个方向，切过去直接说；它卡住时会出现在「等你」里。

关掉电脑、换电脑、在手机上看

会话跑在 Tokenman 的机器上：关掉终端、合上笔记本、换一台电脑或在手机上打开，都还是那一套会话。怎么连、关掉后怎么回来，见 电脑和手机上怎么连。

任务记录：T 号

你在 「+ 新会话」行交出去的每件事，Tokenman 都先记一笔，编号 T 开头（比如 T42）。记下的是你的原话、交给了哪台机器、哪个会话、现在什么状态。

• 任务只有这一个号：它归你，不归哪个仓库。交给仓库的任务在那个仓库里改代码、开 PR——GitHub 只放代码和 PR，没有另一张单子。
• 在入口网页的 会话 页能看到你所有的任务记录：一件事一行，任务和它的会话在同一行，按要不要你管分组（等你 · 在干活 · 排队中 · 已收起），批次的成员挂在批次下面。会话结束了记录还在。点一行看详情：你的原话、它的回报、PR、终端入口。页头的 新建 也能直接派一件。
• 已完成 表示入口收到了确认的工作结果。会话消失不代表完成；旧记录没有确认的任务状态时显示 还不清楚。详情里展开 技术详情 可分别看到请求、确定和已核实的代理，以及会话观测。需要合并的 PR 尚未确认时，工作结果旁显示 等待 GitHub。刷新失败时，当前页面保留上次确认的状态和读取时间，标明暂时无法更新；重试读取 只重新读取，不会启动工作。
• 跟同事说「T42 那件事」，对方在会话页搜编号就能找到。

先看设计页，再开任务

装了 fleet-epic 插件时，在会话里说 /fleet-task-plan <主题>（比如「批次报告送不到你手里」），它先把这件事写成一页设计页：现象、原因（证据折叠在下面）、目标与范围、改法、可能出的问题、需要你定的事、上线证据。页面私密，推到你微信。你看完直接说要改哪条，它改同一页；点头就按页开一个任务，页面顶上标出任务号，执行会话照页去做。一批相关的事用 /fleet-epic-plan，同一种页面。

回收：会话什么时候关

会话做完会被自动收走，不用手动清理。收走前先记下历史，代码副本留着，在面板「已收起」里随时能 ↵ 恢复。默认规则：

想改：选中那一行 Tab →「改回收方式」，可以选 合并后关、做完就关（可以带时长）、循环停了关、到某个时间关、不自动关。正在干活、正在等你回答的会话不会被收走。

额度和用量

面板顶上那一行只说你正在看的这个会话：剩多少上下文、用的哪个模型（比如 剩余 62% · Opus 5.5 · high）。灰色表示这个读数是 5 分钟以前的。

上下文快满时，仓库任务的会话会自己交接给一个新会话接着做；空白会话里你也可以直接说「交接一下」。

可选：把常用动作设成单独的键

Tokenman 只用 ⌘P（手机 F12 或 ⌃] p）一个键，其余都在面板里：新会话、命令行、退出 Tokenman 都是面板里的一行，选中按 ↵，或在搜索框打几个字（如「命令行」「退出」）直达；退出会先问一句。⌘K 清屏、⌘T 新标签、⌘N 新窗口、⌘Q 退出都还给 iTerm2。习惯了旧的快捷键，可以在自己电脑的 ~/.config/claude-fleet/fleet.conf 里加回来：

[client]
FLEET_KEYS_EXTRA="next=cmd+down prev=cmd+up new=cmd+n"
[common]
FLEET_KEYS_PHONE_EXTRA="ctrl+]n=next ctrl+]b=prev"

可以设的动作（这张表也是生成的）：

不用 iTerm2（比如 Ghostty、系统自带的终端）时 ⌘ 键到不了 Tokenman，用 F12 或 ⌃] p（先按 ⌃]，再按 p）打开面板。iTerm2 里 F12 不开面板，照旧归会话。

出了问题怎么说

• 连不上、打不开：先看 故障排查。需要别人帮你看时，在终端敲 fleet doctor --json，把输出发给管理员。
• 常见疑问：常见问题。

无仓库的编排会话也可以在列表菜单中换成 Codex。原会话要先结束当前回合；有原生定时任务时，面板会请它核对当前任务、准备交接笔记，再完成切换。准备期间原会话继续运行；登录、目录信任或任务信息不全时会说明原因。会话内的循环巡检与单次提醒分别保留时间和到期规则，已删除的任务不会接续。项目中的 Claude 持久提醒也会跟过去：Tokenman 先存好一份暂不生效的副本，原会话再用自己的调度器删掉原提醒，等原会话退出后副本才生效，所以提醒会在切换后的对话里按时、只到一次。原会话自己做不到时（比如额度用光），只有确认没有别的 Claude 可能改写这个项目的任务表，切换才会接过提醒；否则会说明是哪个进程挡着，原会话和提醒继续运行。不要求你查找或手工导出 JSON。可信节点会补齐 HOME 的目录信任，保留你明确设置的不信任或关闭预信任的选择。未发送的输入会保留为草稿。

Codex 会话自行交接时会核对并沿用当前账号，临时代理目录不会被当作另一个账号。提示交接已准备好后，仍要等当前回合正常结束才会切换；账号不可用或目录映射无法核实时会说明原因，原会话继续保留。

已接受的远端任务会先核实所选代理，再交付首条输入。启动核实失败或连接丢失回执时，Tokenman 会保留任务等待恢复，不会自动换代理或再开一份。继续会话会沿用原对话；明确换代理时，确认原会话停止后才接受下一次尝试，切换结果不明时须先恢复。

网页对话的连接

网页对话经入口转发到你家里的节点；入口和你的节点之间保持一条常开的通道，每次请求在里面走一个来回，不用每次重新连。对话仍只在你家里的节点上跑，对话与额度规则不变；本机网页照常使用。

发送后断线时，页面会重新读取原来的对话，并提示消息可能已送达。先查看恢复的内容，再决定是否重试；页面不会自动重复发送消息、停止请求或回答。

入口会在国内存一份你的对话（你说的话、回复的文字、每个工具步骤的一行；工具的输出不存），加密存放，只有你能看。打开对话时页面先显示这一份，标「同步中」，等你家里的节点答复后换成它的、标「已同步」；家里的节点连不上时也能看历史，标「同步中 · 家机器暂时连不上」。这一份 90 天没更新就删掉；在「设置 → 对话历史」里可以关掉，关掉立即删除。