开始使用
1. 安装
安装与升级均使用首页显示的已验证安装命令，自动准备独立 Node/npm 并迁移可确认的旧命令入口。安装完成后启动后台服务：
linkcattle service install
| 平台 | 使用方式 |
|---|
| macOS Apple Silicon | CLI；Codex、Pi、Claude、DSH 或 Qoder |
| Linux x64 | 原生验收待完成；本轮尚未发行安装包 |
| Windows | 原生 CLI/Core 验收待完成；本轮尚未发行安装包 |
| Android ARM64 | 正在构建签名 APK |
| iOS | 正在准备归档与 App Store 发行 |
macOS ARM64 Core 0.1.1 已通过 Developer ID 签名、Apple 公证和 Gatekeeper。CLI 平台组件单独验收，请仅使用已验证下载列出的平台，并保持系统安全保护开启。
linkcattle service install 会校验并安装 Runtime、启动用户后台服务，npm 跳过安装脚本时同样可用，无需批准脚本或运行 rebuild。macOS 要求的后台批准需按提示单独完成；安装不请求录屏、输入或摄像头权限。故障先查 linkcattle service status。Linux npm 目录权限及平台边界见 CLI 指南。
2. 接入电脑
安装完成后运行：
linkcattle --lang zh
linkcattle --region cn
linkcattle login
linkcattle connect codex
Codex 桌面共用仅支持 macOS。首次接入前，完成任务并退出独立运行的 Codex；成功后正常打开。不默认绑定项目。使用 linkcattle connect codex -qr 可改由手机扫码认领。
其他接入方式：
linkcattle connect pi --executable /absolute/path/to/pi
linkcattle connect claude --profile /absolute/private/claude/profile.json
linkcattle connect dsh --profile /absolute/private/deepseek/profile.json
linkcattle connect qoder
linkcattle connect web 127.0.0.1:8080
Qoder 适配器需要 Qoder CLI 1.1.37、Node.js 22+、npm 和 jq。先在电脑执行 qoder login；首次接入会安装固定版本的官方 SDK。Qoder 使用既有登录，不配置自定义模型端点或 Key，暂不支持 IDE 共控。
Pi 使用既有本机环境；Claude 和 DSH 使用已有的受保护配置。各 Agent 保留原有模型登录和工具权限。Linux/WSL 的项目与 Agent 应放在同一环境中；WSL 须持续运行，systemd 本身不能维持 WSL 实例。API 接入与服务管理见 CLI 指南。
3. 手机继续使用
电脑工作区需要匹配的平台与 Runtime。电脑登录后自动登记系统和电脑信息，从“连接”或首页切换器选择电脑。
在电脑管理菜单中可重命名已登记电脑。只有账号拥有者可以修改显示名；去除首尾空白后须为 1–80 个字符，不含控制字符，并同步到同账号的各台设备。心跳、重连和 Runtime 重启保留昵称。新电脑默认使用人可读的系统名称；主机名仅为技术标识时改用系统或可用机型名称。本机需先登录，才能修改名称。
首页按图标展示服务，长按、更多菜单或 Shift+F10 可管理。新增服务默认显示在所属电脑首页；隐藏后仍可从“全部服务”找回。收藏标明来源电脑，打开远端收藏不改变当前选择；首页偏好按账号及地域隔离。刷新旁边的铃铛打开通知与分享申请。
分享时打开服务的更多菜单，选择“分享服务”，直接生成包含该服务当前全部可分享功能的邀请码，不再选择权限。接收者扫码申请后，拥有者在生成邀请码的设备上通过通知批准。授权包含允许的修改和 Agent 任务，归属和凭据仍由拥有者保管。已有受限分享需重新邀请并批准，才会获得当前功能；未来新增功能不会自动加入旧授权。
“添加服务”把有界请求发给所选电脑的 Runtime。先在目标电脑准备好 Agent 登录、执行器和权限；结果未知时，从“连接”的接入请求中查询原结果，不要重复提交。旧平台仍可使用已有服务，但需升级后才能登记电脑及远程新增服务。
登录同一中国区账号，从应用市场安装 Coding，在“服务”打开电脑服务，选择项目和会话。电脑须保持唤醒、联网，并运行 Agent 和 LinkCattle 后台服务。更新手机应用不会更新电脑运行时。CLI 校验并管理独立发行的 Core，两者版本可以不同，无需单独安装 Connector。升级匹配的 CLI 包前，先完成正在执行的任务。
通用网站可从“服务”直接打开，无需业务应用；保留网站登录，目前仅限拥有者账号。第三方登录/CDN、硬编码地址、JavaScript Cookie 和 Service Worker 可能需要适配。
地域、语言和数据
Android 可在服务菜单选择添加到手机桌面，然后在系统提示中确认。桌面图标通过原有身份与权限校验直接打开服务；须登录创建图标的账号，已删除或授权失效的服务不能打开。需要手机桌面支持固定快捷方式。
中国区入口为 https://linkcattle.spark-data.cn/gateway。新加坡和美国入口尚未开放。切换地域不迁移账号或服务。App 与 CLI 支持 zh、en、ja、ru，语言不改变账号地域。
项目和模型登录留在电脑上。平台处理账号、授权和连接元数据；可信 HTTPS 网关可以读取转发正文。CLI 使用 ~/.linkcattle/，不得打包或提交该目录。
linkcattle disconnect ID 暂停连接；linkcattle service uninstall 停止后台服务并保留配置；linkcattle delete INSTANCE_ID --yes 永久删除服务登记和分享授权，保留项目、原生会话和电脑文件。