拖住文件,
松手执行。

在 Finder 中按住文件停一下,轮盘随即弹出,
列出打开、复制路径、编辑、分享等动作。

v0.1.3,macOS 13 及以上

Finder 拖拽示意
项目设计稿.md示例文件
复制文件的完整路径

界面预览,不读取或修改文件。上方按钮仅切换本页的预览外观;App 内的主题切换将在下一版本提供。

常用文件操作

这些动作都在同一个轮盘里,不需要的可在设置中关闭。

打开文件或所在目录

用 VS Code 打开项目,在终端进入所在目录,或选择其他应用。

复制路径

可选择 POSIX 路径、文件 URI,或带引号的路径。

~/Projects/notes.md

编辑、改名和新建

文本可直接编辑并保存。其他文件可改名,或新建同格式文件。

notes.md ⌘ S周五:整理项目文件

使用方式

  1. 1

    拖住文件

    在 Finder 中按住文件开始拖动。

  2. 2

    短暂停顿

    默认停顿 300ms 后出现轮盘。

  3. 3

    选择动作并松手

    要取消,移回轮盘中心再松手。

也可在 Finder 中右键文件,选择「服务 → 用 Kodeoff 打开轮盘」。首次安装后,可能要注销并重新登录 macOS,服务项才会出现。

查看轮盘动作说明
扇区行为
VS Code 打开未安装 VS Code 时置灰
复制路径默认 POSIX,设置里可切 file:// URI / 带引号
发送到手机拖住单个文件松手,经你的 iCloud 私有库发往手机端 Kodeoff(两端登录同一 Apple ID 即收);多选、文件夹、未登录 iCloud,或所用版本未包含 iCloud 权限时置灰。此通道未经真机验证,详见「文件分享」一节。
AirDrop系统隔空投送,多选可用;iCloud 不可用或空间不足时的备选方式
打开方式…二级环列出所有声明支持该类型的 App(点选)
快捷编辑文本文件进入内联迷你编辑器(⌘S 保存);非文本 / 文件夹则重命名
新建同格式文件在父目录新建同扩展名空文件;文件夹新建同级空文件夹(自动编号)
Finder 中显示定位选中
终端打开文件夹直接打开,文件打开其所在目录
设置触发停顿时长、路径格式、扇区开关、开机自启

文件分享

发送文件有三条通道,进度不同:AirDrop 现已可用,其余见下方说明。

AirDrop

可用

通过系统隔空投送发到附近设备,支持多个文件。

iCloud

待验证

将通过你的 iCloud 私有库把文件同步到手机。iOS 收件 App 已开发完成、尚未发布,整条通道未经真机验证,当前预览包也不含此功能。

自托管中转

待验证

在自己搭建的服务器上收发文件,macOS 与 iOS 端均已接入。收发链路仅在开发者本机测试通过;未做公网部署与长期运行验证,跨网使用需自行配置 TLS。

隐私与权限

复制路径、编辑和新建文件等本地操作不联网,也不需要辅助功能权限。

端到端加密尚未上线

加密信封已实现、通道接入进行中。当前中继传输尚未使用该信封,服务器可访问其存储的文件与元数据;跨网络使用需要 HTTPS。

查看各通道的加密与存储说明
通道传输中静态存储端到端?谁能看到明文
iCloud 私有库(CloudKit) 框架级 TLS(Apple 保证) 服务器端加密、Apple 持钥;若你开启 iCloud 高级数据保护(ADP),加密字段与资产升级端到端(应用元数据不在其端到端范围) 否(保守说法:iCloud 体系内可见) iCloud 体系(含 Apple,依你的 iCloud 安全设置而不同);开发者无服务器、不经手文件
自托管账号中转 默认仅本机回环明文 HTTP;服务端可选内置 TLS(--tls-cert/--tls-key,适用于单机 / 内网);跨网生产推荐反向代理终止 TLS 服务器明文落盘(文件与元数据);设备凭据只存哈希 否——相对 CloudKit 的明确隐私退步 你的服务器运营方,及无 TLS 链路上的中间人
AirDrop Apple 协议栈系统级加密(不由 Kodeoff 宣称) 无应用侧落盘,不经手接收端 不宣称(系统直投) 收发双方设备的使用者;Kodeoff 不经手
端到端加密尚未接入任何通道。

通道接入与验证完成前,不宣称「仅你可读」。

支持的平台

macOS 13+

集成 Finder、终端与 AirDrop。预览包使用 ad-hoc 签名,尚未完成 Developer ID 签名和公证;首次打开请右键→「打开」。

Windows 10+(x64)

实验性构建版,提供五个常用动作。尚未经 Windows 真机验证,不包含 AirDrop 与 iCloud 功能;首次运行 SmartScreen 请选「仍要运行」。

下载 Kodeoff

v0.1.3 公开预览版,提供 macOS 与 Windows 安装包。

macOS 首次打开请右键→「打开」;Windows 首次运行 SmartScreen 请选「仍要运行」,详见支持的平台一节。

常见问题

需要什么权限?

不需要辅助功能权限。文件访问遵循 macOS 的权限设置。

如何调整轮盘?

在设置中调整触发停顿时长、停顿半径及轮盘动作。浅色 / 深色 / 玻璃外观切换,以及可选的 Finder 长按与直接右键入口,将在下一版本加入;其中 Finder 长按与右键入口需要辅助功能权限,仍在真机验证。上述新功能均不在当前 v0.1.3 下载包中。

如何取消操作?

拖拽时可在轮盘中心松手、拖出轮盘边界,或按 Esc 取消 Finder 拖拽。通过右键「服务」打开的轮盘需点击外部或中心关闭,不支持 Esc。

授权与开源说明

代码不开源。授权与收费方案尚未公布。