企业官网建设流程全解析

Cotabby 是一款免费开源的macOS 本地 AI 自动补全工具：在你打字时，光标的灰色“幽灵文字”会实时给出 AI 续写建议，按Tab一键接受。它完全在设备本地运行，无需账号、不上传数据。本教程带你用Homebrew 安装、依次授予 3 项权限、完成初始配置，5 分钟让 AI 自动补全覆盖 Mac 上的每一个文本框。

1️⃣ Cotabby 是什么：全系统的本地 AI 自动补全

Cotabby 是一个 macOS 菜单栏应用，把 AI 自动补全带到你正在使用的几乎任何文本框（邮件、聊天、浏览器、笔记）。除了句子续写，它还提供：

• 👻Ghost-text 自动补全— 灰色建议内联显示，逐词接受不打断你的节奏
• 😀Emoji 自动补全— 输入:rocket:直接接受，不用离开输入框
• ⚡斜杠宏— 输入/快速执行数学、单位与货币换算、日期、随机数
• ✅一键自动纠错— 单个按键修复可能的拼写错误

隐私是它的核心设计：默认的 Apple Intelligence 与开源引擎都跑在你自己的 Mac 上，无分析、无遥测、无崩溃上报，正常使用下你输入的文字永远不会写盘。更多细节可看 README.md 的 Privacy 章节。

2️⃣ 30秒确认系统要求

安装前花 30 秒对照一下你的 Mac：

3️⃣ 最快安装方法：Homebrew 一键安装

打开「终端」，只需两条命令（推荐方式）：

brew tap FuJacob/cotabby brew install --cask cotabby

安装完成后，Cotabby 会出现在菜单栏。以后升级只需：

brew upgrade --cask cotabby

不想用 Homebrew？也可以手动下载安装包，把 Cotabby 拖入「应用程序」文件夹：

4️⃣ 按顺序授予 3 项核心权限（关键步骤）

Cotabby 要“住”在别的应用里工作，所以 macOS 会询问 3 项权限。首次启动时 Cotabby 会手把手带你完成授权，每项权限对应一个具体功能：

权限模型定义在 PermissionModels.swift，检查与申请逻辑在 PermissionManager.swift。

💡新手提醒：授权「输入监控」后，Cotabby 可能需要退出并重新打开才完全生效（首次向导会提示你重启，见 WelcomeCoordinator.swift）。所有权限随时可在「系统设置 → 隐私与安全性」中修改；密码框等安全字段 Cotabby 会自动静默，绝不生成和插入建议。

5️⃣ 60秒完成初始设置向导

首次启动 Cotabby 会弹出欢迎向导（WelcomeView.swift），按提示走完即可：

1. 权限步骤— 逐项授权上面 3 项权限（WelcomePermissionStepView.swift）
2. 按键步骤— 确认接受键：Tab逐词接受、`整句接受、Esc取消（WelcomeKeybindStepView.swift）
3. 个性化步骤— 选择模板与个性化偏好（WelcomePersonalizeStepView.swift）

全程约 1 分钟，中途关闭窗口也没关系，下次启动向导会自动重新出现。

6️⃣ 第一次收到建议：Tab 接受、` 全接受

现在，在任意文本框开始打字。当灰色幽灵文字出现时：

• 按Tab— 接受下一个词（默认逐词接受，可在「设置 → 接受模式」改为整句）
• 按`— 一次性接受整条建议
• 按Esc或继续打字 — 忽略建议

再体验两个彩蛋功能：输入/打开内联宏面板，直接算汇率、换算单位：

所有快捷键都能在「设置 → Shortcuts」中重新绑定。

7️⃣ 引擎选择：3 种 AI 引擎如何选

打开「设置 → Engine」（引擎路由见 SuggestionEngineRouter.swift），Cotabby 提供 3 种生成方式：

菜单栏就能直接下载开源模型；Mac 支持 Apple Intelligence 的话，从它开始最简单，否则选开源引擎的tabby-2-mini作为日常均衡之选。

8️⃣ 新手常见问题快答

• 建议不出现？依次检查：3 项权限是否全部授予、授权后是否重启过 Cotabby、当前窗口是否是终端或密码框（这两类 Cotabby 会故意保持安静）。
• 想临时关掉？菜单栏关闭「Enable Globally」全局暂停，或把某个应用加入禁用列表；还能在「设置 → Shortcuts」里设一个全局开关快捷键。
• 隐私吗？默认引擎全部在设备本地生成；网络只用于下载模型和检查更新，不携带你输入的任何文字。详见 FAQ.md。
• 后续怎么升级？brew upgrade --cask cotabby，或让 Cotabby 自动检查更新。

9️⃣ 总结与延伸阅读

到这里，你的 Cotabby 已经跑起来了：Homebrew 两条命令安装 → 3 项权限按向导授予 → 欢迎向导 60 秒完成 →Tab开始享受本地 AI 自动补全。

想深入了解更多，可以阅读这些仓库文档：

• README.md — 功能总览与安装说明
• FAQ.md — 新手常见问题全集
• ARCHITECTURE.md — 建议生成的完整流水线（十分钟维护者地图）
• SOURCE_LAYOUT.md — 源码目录结构说明
• THIRD_PARTY_LICENSES.md — 第三方组件与许可证
• releases/README.md — 各版本发布说明