1. 本地开发循环
一个仓库对应一个工作区，Git 状态持续可见，终端驱动任务推进，文件视图承担核对与确认职责。
- 把目标仓库作为独立工作区打开。
- 开始大改前先浏览一次文件树。
- 每次重要修改后先在编辑器里确认，再回到主线程继续。
完整使用说明
从第一次启动到日常执行，imux 应该这样用。
imux 的目标不是多一个聊天窗口，而是把意图快速压到可执行工作面上。下面这份说明可以作为 imux 的基准操作手册，帮助你在本地项目、远程主机、文件编辑、源码状态和监督器工作流之间保持一致。
快速开始
- 01
从 imux 官方网站下载当前 macOS 安装包并完成安装。
- 02
打开 imux，从本地目录创建工作区，或者从已配置的 SSH 目标开始。
- 03
在交给监督器执行前，先在 Settings 中设置好你的 LLM 提供商与模型。
- 04
让右侧资源管理器和编辑器承担文件、路径、任务上下文的展示，保持终端始终是主工作面。
推荐的使用方式
imux 最适合被当作一套可重复执行的操作面，而不是一次性提示框。下面这些方式可以在保持终端优先的同时，减少上下文漂移。
2. 远程运维循环
把每台 SSH 主机都当成一等工作区，使用和本地一致的纪律。远程任务只有在路径与认证状态清晰时才真正安全。
- 先确认 SSH 目标，再建立连接。
- 等终端明确显示远端 shell 状态后再使用远程资源管理器。
- 尽量一台主机一个工作区，避免日志、路径和目标混杂。
3. 审核与验证循环
不要只相信生成结果。imux 最强的地方，是你可以快速把文件、路径、Git 状态和命令结果放到同一视图里核对。
- 每次关键步骤完成后立刻打开相关文件。
- 发布前确认准确路径和分支状态。
- 把右侧面板当作证据面，而不仅仅是导航面。
4. 多任务监督循环
当多个任务并行时，监督器最适合做的是维持目标边界和进度可解释性，而不是输出空泛总结。
- 给每个工作区一个简短且具体的目标。
- 只有在上下文发生明显变化时再重新调用监督器。
- 优先使用多个干净工作区，而不是一个超载会话。
1. 先建立工作区，而不是先堆终端
imux 的核心不是孤立终端，而是工作区。一个工作区最好只对应一个明确项目或一个明确远程主机，这样终端、文件、浏览器任务和监督器都基于同一上下文运行。
- 本地工作区应该直接指向你真正要处理的仓库或目录。
- 远程工作区最好一台主机一个，不要把不相关的远端任务混在一起。
- 尽量一项目标对应一个工作区，这样监督器生成的计划更清晰。
2. 把本地和远程资源管理器当作控制平面来用
资源管理器不是装饰，而是你快速确认项目结构、打开文件、核对路径、保持方向感的主要界面。
- 在开始编辑或交给监督器前，先用本地资源管理器读一遍仓库结构。
- 只有在 SSH 会话真正连接并认证完成后，再依赖远程资源管理器执行远端文件操作。
- 需要让终端上下文明确指向某个文件时，直接把路径拖进当前终端对话。
3. 在工作区内直接阅读、编辑和保存文件
imux 提供工作区内文件查看与编辑能力，避免你为了每一次小改动或核对都跳到第二个编辑器里。
- 点击文件即可在工作区内部查看或编辑。
- 保存后可以立刻回到当前终端线程，不丢上下文。
- 文件视图也适合做核对：在让监督器继续前，先确认实际内容。
4. 把监督器当成执行层，而不是聊天玩具
监督器只有在目标具体、上下文充分、边界明确时才真正高效。它的价值在于压缩歧义、组织下一步，而不是输出一堆空泛话术。
- 给每个工作区先设定一个明确目标，再让监督器接手。
- 先看监督器给出的下一步是否可执行，不要盲目接受模糊计划。
- 监督器适合用来组织推进、追踪进度，以及约束多任务漂移。
5. 让源码状态在执行过程中始终可见
imux 最大的价值之一，是让 Git 状态在执行过程中始终可见，而不是到最后才想起来核对改动。
- 开始编辑前先确认当前分支和工作树状态。
- 利用可见路径和仓库上下文，避免误改到错误目录。
- 在准备发布或交付结果前，再检查一遍当前变更。
6. 用发布优先的习惯来升级 imux
不要把升级当成盲覆盖。imux 控制的是项目上下文、远程访问和模型设置，升级动作本身也应该有工程纪律。
- 先读升级日志，再替换应用构建。
- 升级后重新确认模型设置、SSH 行为和保存的连接偏好。
- 先用一个干净工作区验证新构建，再把全部重要任务迁移过去。
能立刻改善体验的习惯
只要建立几条简单习惯，imux 就会从一个看起来不错的工具，变成真正稳定的指挥中心。
尽量保持一个工作区只对应一个仓库或一台远程主机。
把工作区目标先写清楚，再交给监督器推进。
把精确文件路径拖进线程，而不是用模糊描述代替。
尽早看 Git 状态，不要到最后才检查。
每次非小型改动后，都用编辑器做一次人工确认。
每次升级后至少验证一个本地路径和一个远程路径。
怎样给 imux 下达任务，才能在 2 到 3 轮内进入执行
大多数启动缓慢的问题，并不是功能不够，而是目标太模糊。一个短而具体的任务简报，通常就足够让 imux 快速开工。
先说清楚具体仓库、目录或 SSH 目标。
一次只讲当前最重要的一个结果，不要把多个无关目标塞在一起。
如果你已经知道关键文件、命令或 URL，就直接指出来。
用一句可衡量的话说明什么叫完成。
下一轮只需要收紧范围或优先级，不需要把全部需求重新讲一遍。
常见问题与恢复方式
imux 出现卡顿、混乱或不可靠时，通常原因都在操作方式本身，而不是神秘错误。优先检查下面这些点。
SSH 连接像是卡住了
大多数远程问题都来自认证未完成、SSH 配置不匹配，或者在连接尚未稳定前就开始浏览远程文件。
- 重新确认 SSH config 里的目标并干净重连。
- 等终端明确出现远端 shell 状态后再使用远程资源管理器。
- 如果仍然异常，先用普通 SSH 会话测试该目标。
工作区显得很乱、不聚焦
这通常意味着工作区目标过大，或者多个不相关路径与任务堆在了同一个操作面里。
- 把不相关任务拆成多个工作区。
- 把当前目标压缩成一个明确结果。
- 关闭不再参与当前决策链的文件和面板。
监督器给出的下一步太空泛
这往往意味着它缺少明确目标、最新文件证据，或者没有得到清晰的完成标准。
- 用一句话重述目标，并写明什么算完成。
- 继续前先打开最相关的文件。
- 把它重新指向当前仓库状态，而不是依赖旧对话记忆。
安全升级检查表
从 imux 官方网站下载最新 DMG。
先正常退出当前应用，避免中途打断写入或活动会话。
安装新构建后重新打开 imux，并在继续重要工作前核对 LLM 设置与 SSH 连接。
如果资源管理器、监督器、文件编辑或路由行为有变化，先读升级日志再继续。