快速开始
在电脑上安装 Skiff CLI
在终端运行官方安装命令。安装器会选择当前正式渠道。
启动并检查服务
本地服务会主动连接轻舟网关。通过 status 与 doctor 命令确认执行端已经就绪。
在手机登录并绑定
使用同一个熵桥账号登录，在设备页添加电脑并完成配对。
新建或接续会话
选择执行端、工作目录、Agent 和模型，然后创建新会话，或从本地历史中接着做。
skiff service status检查服务状态skiff doctor运行连接诊断skiff update --channel prod更新到最新正式版 CLI选择 Agent CLI
轻舟会发现所选电脑上已经安装且受支持的 Agent CLI。选好 Agent 后，再设置它可用的模型与控制项。Claude Code 与 Codex 提供更深入的会话和权限适配；其他适配器只展示对应 CLI 确实具备的能力。
Claude Code
Codex
GitHub Copilot CLI
Gemini CLI
Cursor CLI
Kimi CLI
OpenCode
Qoder
iFlow CLI
Pi
Antigravity
ACP- Agent 列表以当前电脑上已安装、已就绪的 CLI 为准。
- 模型、权限模式、思考强度和会话恢复能力会因 Agent 而异。
- 查找 PC 历史会话时，需要选择相同的 Agent 和工作目录。
接续 PC 会话
在“新会话”中先选择电脑和代码目录，再选择 PC 上使用的同一 Agent，进入“恢复”选择本地历史。轻舟会向执行端查询该目录下兼容的会话，并把历史内容恢复到手机时间线。
- 继续执行时，电脑必须在线。
- 能否恢复以及可恢复范围，取决于所选编程 Agent 的能力。
- 如果 PC 记录有更新，可在会话中使用“拉取最新”刷新。
任务进行中可以做什么
- 查看排队、执行、等待、完成、失败和离线状态。
- 阅读计划步骤、进度卡、结果、问题和富文本输出。
- 在 diff 摘要中查看每个文件的新增与删除行数。
- 发送下一条指令，或中断正在执行的任务。
- 在执行端支持时切换 Agent、模型、权限模式与推理投入。
给 Prompt 添加图片
点击输入框旁的图片按钮，选择图片，确认预览后发送。图片会通过轻舟存储传输，并在本地执行端交给 Agent 使用。
不要把 API Key、访问 Token、密码或无权上传的源代码截图放进图片指令。
设备与离线状态
设备页会显示已绑定电脑、在线状态、活跃会话、CLI 版本与最近同步时间。电脑离线时仍可阅读已经同步的历史，但要等它重新连接后才能继续执行。
Skiff Pro
- 图片指令
- 每台执行端最多 5 路并发任务
- 最多 3 台在用电脑
- 以 App 内实时展示为准的扩展用量视图与历史范围
常见问题排查
电脑显示离线
先运行 skiff service status，再运行 skiff doctor。确认电脑网络正常，且 CLI 与手机登录的是同一账号。
找不到 PC 历史会话
确认所选代码目录和 Agent 与 PC 会话一致。执行端重新连上后，刷新恢复列表。
任务一直停在排队或等待
进入会话查看是否有待回答问题或权限卡。如果并发已满，请等待任务槽位，或中断旧任务。
图片发送失败
确认 Skiff Pro 已生效，使用支持的图片格式，单张文件不要超过当前上传限制，并在稳定网络下重试。
仍未解决？请邮件联系 support@entropybridge.com，并附上 App 版本、CLI 版本和简要现象。请勿发送 API Key、访问 Token 或私有源代码。
support@entropybridge.com