使用说明

公开下载目前为 v0.1.3 预览版。下面的可视化设置和账号说明针对下一版本开发构建;它们尚未包含在旧安装包中。

查看公开下载 · 隐私与数据处理

在文件上打开轮盘

在 Finder 中拖住文件,光标停顿后出现轮盘。移动到动作扇区并松手执行;移回盘心或离开轮盘取消。

不想拖动时,可以在 Finder 文件的右键菜单中选择「服务 → 用 Kodeoff 打开轮盘」。首次安装后若服务项还未出现,可重新登录 macOS 后再检查。

下一版本还提供可选的 Finder 长按与直接右键入口,需在设置中启用并授权辅助功能。这些入口仍在实机验证;无需为普通拖拽入口额外授权。

直接在轮盘上自定义

打开设置中的轮盘自定义页,把可用动作拖到目标扇区上即可替换。点击扇区查看当前动作及其配置;空位也可以接收拖入的动作。

轮盘默认使用毛玻璃,可在外观设置中切换浅色或深色。触发停顿时长与半径控制轮盘出现的时机。

账号与设备

使用邮箱和密码登录。注册及找回密码需要服务器启用邮件发送;未启用邮件的自建服务可使用账号码或配对码添加设备。

默认服务由 App 内置,普通用户无需填写或查看服务器地址。当前开发构建先连接本地服务,用于电脑和模拟器联调;正式官方服务仍在准备中。

账号码可让新设备加入账号,请像密码一样保管。配对码为短期有效的一次性凭据。设备登录后会获得独立凭据,可从设备列表移除不再使用的设备。

收件、缓存与退出

iOS 收件箱展示当前账号的文件与剪贴板文本。点击文件可下载并预览;下载策略和缓存保留天数可在设置中调整。

当前中继通道在 App 打开时自动刷新。切到后台后不会发送新文件通知;回到 App 后同步新内容。

退出登录会清除本机登录状态和该账号的收件缓存,并尝试吊销当前设备;不会删除服务器上供其他设备使用的文件。离线退出后,可从其他设备确认并移除旧设备。

macOS 凭据保存在本机固定文件中,不读取钥匙串。iOS 使用系统钥匙串;网页使用浏览器本地存储。切换服务不会把旧服务凭据发送到新服务。

自建服务

自建中继适合自行管理服务器的用户。服务端位于开发仓库的 server/;本机开发可运行 bash server/run-dev.sh,使用临时数据目录。专用开发或自建构建可单独启用连接配置,默认用户界面不展示该配置。

本机回环地址只能由服务器所在电脑访问,手机不能通过它连接另一台电脑。真机联调需在构建中配置可达地址;跨网络服务需要 HTTPS、持久数据目录、邮件配置及备份恢复验证。

中继目前未接入端到端加密。服务器可以读取存储的内容;不要把临时开发实例当作已验收的生产服务。

遇到问题

连接失败时,先检查服务是否运行、设备能否访问该地址、HTTPS 证书及本地网络权限。登录失败时确认账号属于当前服务;重置密码会使旧设备登录失效。

Windows 目前为实验性本地轮盘构建,尚未接入手机收发;iOS 和 iCloud 功能需要各自的构建与验证,不能由桌面下载包替代。

可在 反馈页提供平台、版本、复现步骤及错误提示。请勿提交密码、账号码、配对码、凭据文件或私人文件。