# LinkShell 独立 Mac App 独立桌面版同时提供工作台与本机管理:工作台用于控制本机或其他电脑、继续对话、处理审批、使用终端和远程桌面;本机管理负责 Host、权限、日志、用量及更新。它与手机 App 共用已有 Host / Gateway 协议。 ## 桌面工作台 窗口是装在同一个 `LinkShell.app` 里的 Electron 44:打开 App 时 Swift 入口 `execv` 成 `LinkShell Desktop`,bundle id、签名和已授予的录屏 / 辅助功能权限都不变;Host 调用的 `Contents/MacOS/LinkShell`(屏幕、输入、权限检查)照旧。布局是半透明侧栏、46px 工具栏、实心主面板、浮动输入框;颜色和尺寸见[视觉规范](design/visual-system.md),方案见[桌面版改用 Electron](design/desktop-electron-plan.md)。 - **侧栏:** 按项目分组的会话;子会话(Claude 桌面 App 启动的会话、分叉)缩进在父会话下,可折叠,已归档的不显示。会话和项目行有右键菜单(重命名、分叉、复制、在 Finder 中显示、归档、删除;在此项目中新建、复制路径、全部归档)。 - **这台 Mac / 其他电脑:** 连接本机运行中的 Host 不需要账号、会员或网关;其他电脑通过账号或配对码添加。 - **新建会话:** 选 Agent、模型、项目和分支。模型是 Agent 报给这台电脑的真实列表;ACP Agent(Gemini、Grok、Copilot、Antigravity 等)在这台电脑上用过一次后才有列表,之前显示「默认模型」。 - **对话:** 各 Agent 统一呈现:只给模型看的标签(``、IDE 状态等)不显示;其他会话发来的消息显示为「收到的消息来自「会话」」并可打开;子代理的回传、`!` 命令、CI 与定时任务事件各有自己的样式;Codex Desktop 附带的文件、粘贴内容和浏览器状态显示为气泡上方的标签。计划卡在本轮末尾逐步更新。运行中追加消息:Agent 支持插话(Steer)时直接送进当前一轮,否则按钮写明会先打断再发送。选中对话里的文字会浮出「在侧边问答中提问」(仅支持侧边问答的 Agent)和「引用到回复」。斜杠命令只列这个 Agent 自己有的。 - **检查器:** 变更、文件(可收起、可拖宽的文件列表,支持 `fs.rename` 重命名与 `fs.delete` 删除并带未保存修改保护)、终端、任务、端口预览;侧边问答只对有旁支对话的 Agent 开放(Codex 的 `/side`,Claude、Grok 的 `/btw`),不打断主任务,草稿按会话保留;插件(MCP Apps)只对报告支持的 Agent 显示,调用插件时自动打开。 - **远程桌面:** Mac 恢复原生 WebRTC → VideoToolbox 硬件解码 → 最新帧缓存 → Metal 呈现,Apple silicon 优先 H.265,Intel 优先 H.264;只协商本机支持硬件解码的格式。Electron 负责界面和加密信令;`LinkShell --desktop-media` 子进程独立加载 `WebRTC.framework`,通过 IOSurface Mach 端口把解码画面交给窗口内的 AppKit/Metal 视图,避免与 Chromium 的同名 Objective-C 类冲突。像素不经过 JavaScript、Canvas 或 Chromium `