> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voido.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 安装 Void Island，在刘海查看 AI 会话与专注

> Void Island 是随 Voido 附带的独立 macOS 应用，显示在刘海或菜单栏，集中查看 AI 编程会话、专注、日程和记录。本页介绍安装、连接助手和更新方式。

Void Island 是随 Voido 一起提供的独立 macOS 应用，显示在屏幕顶部的刘海或菜单栏。你可以在这里查看正在运行的 AI 编程会话并直接审批，也可以开始专注、查看日程，或往今天的每日笔记里记一笔。Void Island 只支持 macOS。

## 安装

第一次打开 Voido 时，它会把自带的 Void Island 装进「应用程序」文件夹，并在后台打开，不需要另外下载。

如果你删掉了 Void Island，Voido 不会再自动装回。需要时可以重新安装：

**1. 打开 Island 设置**

在 Voido 中打开「设置 → Island」。状态会显示「未安装」「已安装，未运行」或「已安装，可以更新」等。

**2. 安装并打开**

点「安装 Void Island」。Voido 会把自带的 Void Island 复制到「应用程序」文件夹并打开它。

**3. 完成连接**

连接成功后，这里的卡片会换成 Void Island 的完整设置。

如果需要开机自动启动，在 macOS「系统设置 → 通用 → 登录项」中添加 Void Island。

## 标签页

在设置的「位置」中选择显示在「刘海」或「菜单栏」。Void Island 包含以下标签页：

* **需要 Voido 的**：地图、专注、记录、日程。它们读写你的任务和笔记，Voido 需要保持运行。
* **可以单独使用的**：AI、Git、菜单栏、小猫等。

「记录」会在今天的每日笔记里加一行带时间的记录。

「专注」可以选一件今天的任务开始，也可以不选直接自由专注；在这里写下一件新事，会加进任务列表。

## 连接 AI 编程助手

AI 标签页显示 Claude Code 和 Codex 的会话；如果安装了 Gemini CLI、Cursor 或 OpenCode，也会一并显示。Voido 里的 AI 助手对话显示为「Void Assistant」。

**1. 连接 hooks**

在「AI 编程助手的 hooks」下点「连接」。Void Island 会先备份原有的配置文件。

**2. 信任 Codex 的 hooks**

使用 Codex 时，还需要在 Codex 中「信任 hooks」一次。

**3. 在刘海上审批**

助手请求批准、提问或给出计划时，可以直接在 Void Island 上处理：⌘Y 允许，⌘N 拒绝。

「断开」只会移除 Void Island 添加的 hooks。还可以开启完成提醒、显示用量限制，以及在 AI 运行时保持 Mac 唤醒。

## 更新

Void Island 没有单独的更新程序，跟随 Voido 更新。Voido 更新后启动时，如果 Void Island 没在运行，会自动换成新版本；如果它正在运行，先退出 Void Island，再到「设置 → Island」点「更新 Void Island」。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.