岛仔 Daozai 使用教程：在 Windows 顶部管理音乐、邮件、日程与 AI 额度

岛仔 Daozai 是什么

岛仔是一款面向 Windows 10/11 x64 的桌面伙伴。它由 Rust 和 egui 构建，不依赖 Electron，默认贴在屏幕顶部，收起时显示为一条小刘海；鼠标靠近后展开，离开后重新收起。

岛仔的设计重点是让信息在需要时出现，而不是持续占据桌面空间。它可以集中处理音乐、歌词、邮件验证码、日程、待办、专注、饮水记录、临时文件和 AI 额度等桌面事务。

核心功能概览

• 桌面伙伴：支持眨眼、打盹、喝水等互动，也可以切换极简模式。
• 音乐与歌词：读取 Windows 媒体会话，控制播放、切歌和进度，并显示单行歌词。
• 专注与饮水：使用专注／休息计时器，记录饮水进度，设置目标、提醒时段，并支持快捷记录与撤销。
• 文件置物架：临时收集文件，打开或定位原文件，也可以将文件拖到其他应用；从置物架移除不会删除原文件。
• 待办：添加、编辑和完成任务，并为任务设置可选的日期与时间提醒。
• 邮件：连接多个邮箱账号，识别验证码来源，点击复制验证码，阅读正文并在默认浏览器中打开链接。
• 日程：查看月历和当日安排，合并工作日历与邮件邀请，支持全天、跨天、重复日程以及单次修改或取消。
• AI 额度：支持 Codex、Claude、Kimi、Grok Bot 和 Gemini，可管理多账号、查看重置时间，并自定义常驻圆环和配色。
• 系统提示：显示电源、电量、网络、音量、大写锁定、输入语言和蓝牙设备状态。

安装岛仔

使用安装版

1. 打开最新 Releases 页面。
2. 下载对应版本的 Daozai-Setup-v0.6.50-x64.exe 安装器。具体文件名可能会随版本更新。
3. 双击安装器，选择安装位置，并按需决定是否创建桌面快捷方式和开机自启。
4. 点击“一键安装”，完成后从桌面快捷方式或开始菜单启动“岛仔”。
5. 打开托盘菜单中的设置，根据需要启用音乐、邮件、日程、AI 额度或其他功能。

首次安装时，桌面快捷方式默认勾选，开机自启默认关闭。安装器无需解压。

使用免安装压缩包

如果不希望使用安装器，可以下载类似 Daozai-v0.6.50-windows-x64.zip 的免安装版本，完整解压后运行其中的 daozai.exe。即使使用免安装版本，程序仍默认将应用数据保存到当前用户的数据目录。

系统要求与下载校验

岛仔目前提供 Windows 10/11 x64 成品包，需要支持 OpenGL 的显卡驱动。暂不提供 macOS、Linux 或 ARM64 成品包。Windows 10、不同显卡和多显示器组合仍可能存在兼容性差异。

Release 页面附带 SHA256SUMS.txt，可以在 PowerShell 中使用以下命令计算下载文件的 SHA-256 值：

Get-FileHash -Algorithm SHA256 .\Daozai-Setup-v0.6.50-x64.exe

当前程序未做商业代码签名，Windows 可能显示未知发布者提示。运行前请核对仓库来源和文件校验值。

第一次使用：从顶部面板开始

启动后，岛仔通常以收起状态停留在屏幕顶部。将鼠标移动到顶部区域，面板会展开；鼠标离开后会重新收起。需要处理的信息会在相应功能开启后出现在顶部。

设置专注和饮水目标

1. 在设置或顶部面板中打开专注功能。
2. 开始一段专注时间，在专注和休息阶段之间切换。
3. 打开饮水面板，设置当天饮水目标和提醒时段。
4. 通过快捷操作记录饮水进度；如果误记录，可以使用撤销功能。

管理待办事项

1. 打开待办面板，添加一条任务。
2. 需要提醒时，为任务选择日期和时间。
3. 完成任务后勾选对应项目。
4. 通过编辑入口修改任务内容或提醒设置。

使用文件置物架

将文件拖入置物架后，可以暂时集中保存需要稍后处理的项目。你可以打开文件、定位原文件，或者将文件从置物架拖到其他应用。移除置物架记录不会删除磁盘上的原文件，因此它适合临时收集，而不是文件备份。

控制音乐和查看歌词

开启音乐功能后，岛仔会读取 Windows 媒体会话。你可以在顶部面板中控制播放、暂停、切歌和播放进度；支持的情况下，还可以查看单行歌词。桌面伙伴也能拿起麦克风跟随音乐呈现互动效果。

连接邮箱、日历与 AI 服务

配置邮箱

岛仔支持 QQ、163、126、腾讯企业邮、iCloud 和 Gmail 等邮箱入口，使用 IMAP 获取邮件。根据服务商要求，你通常需要填写授权码或 App 专用密码，而不是直接使用网页登录密码。

1. 在设置中进入邮箱连接功能。
2. 选择邮箱服务商并添加账号。
3. 按照服务商要求填写邮箱地址、服务器信息以及授权码或 App 专用密码。
4. 保存后等待岛仔读取收件箱。

岛仔可以识别邮件中的验证码来源，点击验证码即可复制；也可以阅读正文并使用默认浏览器打开邮件中的链接。程序读取收件箱，不读取垃圾邮件文件夹。

配置工作日历

工作日历通过 CalDAV 连接。目前入口包括飞书、钉钉和企业微信。需要注意，安装这些平台的桌面端并不等于已经取得独立日历账号授权；连接时需要平台提供的独立日历账号和密码。

正式日历邀请可以自动进入日程。普通邮件正文中出现日期，并不会自动创建日程。来自工作日历和邮件的同一场日程，会通过 UID 与开始时间去重，同时保留来源标识。

如果某条邮件日程不需要显示，可以将其忽略，之后也能从详情中恢复。日程列表滚轮只滚动下方列表，大卡片会保持当前选择；点击其他日程后才会切换详情。

查看 AI 额度

岛仔支持 Codex、Claude、Kimi、Grok Bot 和 Gemini 的额度展示。收起时可以通过圆环查看额度，展开后可查看账号和重置时间。你还可以配置多个账号，选择需要常驻展示的服务并自定义配色。

不同服务的连接方式、账号类型和订阅可用性可能不同。使用前应根据对应服务的本机登录状态或独立连接方式完成授权。

更新、卸载与数据保留

应用内更新

1. 打开“设置 → 关于”。
2. 点击“检查更新”。
3. 查看最新正式版本和更新说明。
4. 按需要选择“下载并安装”“浏览器下载”或“稍后”。

应用内下载完成并通过校验后会重启完成更新。也可以从 Releases 页面手动下载新版本并再次安装。更新不会清除原有设置和记录。

卸载应用

可以通过 Windows“已安装的应用”卸载岛仔。根据项目说明，卸载同样会保留用户数据。

了解本地数据

设置、待办、饮水记录、置物路径和连接元数据保存在 %APPDATA%\Daozai。邮箱和日历密码保存在 Windows 凭据管理器中，Gemini 会话使用 Windows DPAPI 加密。

读取已有 AI 客户端登录信息时，岛仔不会回写原客户端配置。不要将授权码、Cookie 或登录 JSON 上传到 Issue。开启邮箱、日历或歌词功能后，程序会访问相应服务商接口，因此它并不是完全离线软件。

从源码构建

如果你希望参与开发或自行编译，需要准备 Rust stable、MSVC C++ 构建工具和 Windows SDK。建议使用较新的 stable Rust，并选择 Windows MSVC 工具链。

rustup default stable-x86_64-pc-windows-msvc
cargo build --locked --release --bin daozai
.\target\release\daozai.exe

运行测试与打包

cargo test --locked --all-targets --features record -- --test-threads=1
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\package.ps1

测试建议使用单线程，以隔离依赖进程环境变量的数据目录测试。低内存设备可以设置 $env:CARGO_BUILD_JOBS = "1"。打包需要 NSIS 3，也可以使用 -NsisCompiler 参数指定 makensis.exe。

发布脚本会检查程序版本和运行库依赖，并生成单文件 EXE 安装器、精简免安装 ZIP 以及 SHA-256 校验文件。项目结构、界面预览和贡献方式可以参考开发指南。

使用时的注意事项

• 先从基础功能开始：可以先启用待办、专注或音乐功能，再按需连接邮箱、日历和 AI 服务。
• 妥善保管授权信息：邮箱授权码、Cookie 和登录 JSON 不应提交到 Issue 或其他公开位置。
• 确认服务可用性：不同邮箱、日历平台、AI 账号和订阅的连接能力可能不同，仓库中的支持列表不代表每个账号都能完成同步。
• 注意日历来源：正式日历邀请会进入日程，但普通邮件正文里的日期不会自动生成日程。
• 区分置物架与删除：从文件置物架移除项目只会删除记录，不会删除原文件。
• 更新前保留校验信息：下载新版本时，建议结合 Release 页面和 SHA256SUMS.txt 验证文件来源。

总结

岛仔 Daozai 将桌面伙伴、音乐歌词、专注饮水、待办、文件暂存、邮件、日程和 AI 额度集中到屏幕顶部，以收起和靠近展开的方式减少干扰。安装 Windows 版本后，可以从待办和专注功能入手，再逐步连接邮箱、日历与 AI 服务；如果需要定制或参与开发，也可以使用 Rust 和 Windows 工具链从源码构建。

开始使用前，可以访问最新版本页面下载程序，并参考使用指南了解更完整的操作说明。