使用指南。

01 / 准备你的 Mac

ServerDeck 需要 macOS 14 或更高版本。当前安装包适用于 Apple Silicon；Intel 安装包暂未发布。基本终端与文件管理不需要模型服务或远端常驻客户端。

连接服务器前，准备服务器地址、SSH 端口、用户名和密码或私钥。加密私钥请先使用系统 ssh-add 解锁。网站发布当前面向 Ubuntu / Debian + systemd，需要 root 或免交互 sudo、公网 80 / 443 端口和已配置的 DNS。

02 / 安装与应用内更新

1. 从下载页获取与你的芯片匹配的 ZIP 包，并核对 SHA-256 校验值。
2. 解压得到 ServerDeck.app。更新时先结束任务并退出旧版，再拖入「应用程序」。
3. 当前开发版采用 ad-hoc 签名，尚未完成 Apple Developer ID 签名与公证。如被系统拦截，先核实文件来源，再按 macOS「系统设置 → 隐私与安全性」中提供的说明操作；不要关闭系统整体安全检查。

0.10.6 起，启动应用时会检查新版本，也可从应用菜单选择「检查更新…」。确认「下载并安装」后，应用会验证更新、下载并安装，随后重新打开。有活跃会话时会先询问是否结束；取消退出会保留已下载更新，稍后仍可安装。0.10.5 及更早版本需要先手动安装一次新版。

服务器档案与应用包分开保存。更新前可以导出服务器档案作备份，但档案导出不包含登录密码或模型 Key。不要同时运行两个版本。

03 / 建立第一次连接

1. 在服务器列表添加档案，填写地址、端口和账号，选择密码或私钥认证。
2. 第一次连接时，核对服务器主机指纹后确认信任。指纹变化时先核实原因。
3. 连接成功后，在终端输入命令，或切换到文件、网站与活动页面。

想先熟悉操作？通过终端菜单打开本地 Shell，无需创建服务器档案。切换目标不会结束其他服务器的任务；关闭应用时会确认并结束当前会话。

04 / 让 Agent 加入工作

打开「Agent → Agent 设置」，填写模型 API 地址、模型名称与 API Key。当前使用兼容 Chat Completions 的接口；调用费用取决于你配置的模型服务。

在提示符输入 # 问题 获取解释与命令建议，选择建议后仍需按 Enter 执行。按 ⌘ Enter 明确将任务交给 Agent；Agent 与你共享当前 Shell 的目录和环境，默认逐项审批操作，也可以停止并接管。

本地存储不代表离线推理：相关任务内容会发送到所配置的模型接口。请按需要选择数据范围与权限模式。

05 / 发布一个静态网站

1. 在域名服务商处配置 DNS，将目标域名解析到服务器。
2. 进入服务器的「网站」页面，填写域名并选择静态产物目录。
3. 查看检查结果与发布计划，确认后发布，再验证网站和 HTTPS。

可以直接使用内置产品简介页，也可以选择自己的静态网站目录。已有网站被替换前会提示内容影响与备份；证书续期在服务器执行，不依赖 Mac 保持在线。

06 / 把常用操作交给肌肉记忆

Enter 执行命令或提交当前可见接收者的输入
⌘ Enter 将任务交给 Agent
⇧ Enter 输入换行
Tab 查询当前 Shell 补全
Ctrl R 搜索历史与保存条目
⌘ ⇧ L 打开本地 Shell
⌘ ⌥ , 打开 Agent 设置