-10b981?style=flat-square){kind=icon}
下载 .dmg 后，将 Topdo.app 拖到 Applications 即可。
当前安装包未做 Apple notarization。首次打开若被 macOS 拦截，请参考下方「安装排障」。
Topdo 是一个“常驻、低打扰、键盘优先”的桌面任务工具： 你可以快速记录任务、推进状态、设置提醒、同步飞书，也可以用习惯模块追踪每天的固定动作。
| 能力 | 说明 |
|---|---|
| 本地模式 | SQLite 本地持久化，离线可用，开箱即用 |
| 飞书同步 | 对接飞书多维表格，支持任务字段、标签同步与优先级映射 |
| 任务三态 | 待办 / 进行中 / 已完成，适合执行推进 |
| 优先级分组 | 紧急 / 重要 / 普通分组展示，紧急固定展开，重要和普通可收起 |
| 搜索过滤 | ⌘F 按任务名称和备注搜索，顶部保留搜索状态 |
| 自定义标签 | 每个任务最多 5 个标签，保留最近 5 个标签便于复用 |
| 轻量编辑 | 双击标题改名，详情页可改优先级、截止时间、提醒、重复、子任务和备注 |
| 习惯模块 | 支持创建习惯、打卡、连续天数和习惯提醒 |
| 截止提醒 | 支持 macOS 系统通知，并提供应用内 toast 兜底提醒 |
| 数据导出 | 支持 JSON / CSV / Markdown 导出 |
| 桌面体验 | 置顶、迷你模式、托盘驻留、关闭宠物后的横向胶囊 mini |
| 宠物模式 | 猫咪状态、角标、动画反馈和位置记忆 |
| Universal 安装包 | 同时支持 Apple Silicon 和 Intel Mac |
- 日有所成：汇总当天完成的任务与习惯，支持保存为图片、复制文字，并根据完成数量展示不同激励文案。
- 飞书字段映射：标签可绑定已有多选字段；多个飞书枚举值可映射到同一个 Topdo 优先级，适配不同团队的表格结构。
- 重复任务可靠性：停止重复时会同时停用原始任务和全部周期实例，避免后续编辑后重复规则再次生效。
- 导出反馈优化：“日有所成”保存后展示完整路径，可直接在 Finder 中查看；复制和保存反馈始终显示在可见区域。
- 同步与数据体验修复：继续改善飞书标签同步、历史完成统计和本地缓存一致性。
- 自定义标签：任务支持轻量标签，最近 5 个标签可复用；标签会同步到飞书多维表格。
- 同优先级内排序：支持在同一优先级分组内手动调整任务顺序，适合整理当天执行顺序。
- 分组收起优化：
重要 / 普通支持收起，紧急固定展开，避免关键任务被隐藏。 - 新建任务防误触：新建面板内改为
⌘Enter创建任务，普通回车不再误创建，中文输入更安全。 - 飞书同步可靠性：修复重复创建、长期待同步、缺失字段、标签未同步等问题；旧模板缺少
标签字段时会尝试自动创建。 - 循环任务更稳定：按“原始任务 + 到期日期 + 循环规则”去重，避免同一期循环任务被重复生成。
- 完成反馈更轻量：从进行中切到已完成时会有克制的小彩蛋动效，清空任务时给出轻提示。
- 迷你模式更可控：长按拖动迷你胶囊时不再误展开主窗口，短按恢复和拖动移动区分更清楚。
- 体验细节修复：暗色模式、新建/详情页输入、快捷键说明、标签展示、顶部创建按钮换行等细节继续打磨。
- 习惯模块：新增任务 / 习惯双模式，可创建习惯并完成每日打卡。
- 提醒体系：任务截止提醒和习惯提醒都会走 macOS 系统通知；Topdo 前台时还会显示应用内 toast，避免系统通知被折叠后看不见。
- 任务详情升级：支持编辑截止日期与时间、重复规则、提醒、子任务、备注和优先级。
- 创建任务优化：新建面板压缩为更适合小窗口的一屏交互，支持日期、时间、重复和提醒。
- 搜索与快捷键补全：
⌘F搜索、⌘K快捷键面板、⌘J切换任务 / 习惯。 - 设置页收敛：保留高频设置，支持反馈入口、模板教程外链、数据导出和版本检查。
- 飞书同步修正：本地优先级会映射到飞书已有枚举，避免多维表格中被误创建新选项。
下载 Topdo_2.2.0_universal.dmg，拖拽 Topdo.app 到 Applications。
- 本地模式：无需配置，立即开始。
- 飞书同步模式：按 飞书同步配置指南 完成模板、凭证和连接测试。
按 ⌘N 新建任务；点击状态圈推进任务；按 ⌘1~⌘4 切换筛选；按 ⌘F 搜索。
在设置页开启「习惯模块」，点击标题下拉可在 Topdo / 习惯 之间切换。
⌘N：新建任务⌘F：搜索任务⌘,：打开 / 关闭设置⌘K：快捷键面板⌘J：任务 / 习惯切换⌘⇧L：浅色 / 深色切换Esc：关闭当前弹层
⌘1：待办⌘2：进行中⌘3：已完成⌘4：全部
↑ / ↓：移动焦点Enter：展开 / 收起详情⌘Enter：切换任务状态- 新建面板内
⌘Enter：创建任务 - 双击任务标题：直接编辑名称
Esc：取消行内编辑
- 截止日期支持日期和时间；只选日期时默认按当天
23:59到期。 - 任务提醒支持：到期时、提前 15 分钟、提前 1 小时、提前 1 天。
- 已完成任务不会继续统计或触发逾期提醒。
- 系统通知依赖 macOS 通知权限；如果系统通知被折叠，应用内 toast 仍会在 Topdo 前台时显示。
- 支持每天、工作日、自定义星期。
- 支持提醒时间、连续天数和今日打卡统计。
- 习惯提醒会在设置的时间触发；当天已打卡则不会重复提醒。
- 支持编辑、归档和删除习惯。
第一次配置建议先阅读 飞书同步配置指南，再按设置页里的步骤完成模板复制、凭证填写和连接测试。
在设置页填写以下字段：
App IDApp SecretApp Token（多维表格链接/base/后 token）Table ID（链接中table=参数）
优先级映射规则：
| Topdo | 飞书多维表格 |
|---|---|
| 紧急 | 今日必做 |
| 重要 | 本周完成 |
| 普通 | 自由安排 |
写入飞书时会自动映射，避免在多维表格中误创建新的优先级枚举值。
如果模板里没有 标签 字段，Topdo 会在同步标签时尝试自动创建文本字段 标签；如果应用权限不足，也可以在多维表格里手动新增该字段。
- 设置页提供 GitHub 项目主页和用户反馈入口。
- 飞书模板和教程链接可直接用默认浏览器打开。
- 数据导出支持 JSON / CSV / Markdown。
- 点击设置页版本号可检查 GitHub 最新版本。
- 数据存储与同步范围见 隐私说明。
- 常见安装、通知和同步问题见 FAQ。
Topdo 会保持核心功能免费可用。如果它真的帮你减少了任务混乱，欢迎 Star，或者请作者喝杯咖啡。
- 宠物开启时：缩小后进入猫咪 mini 形态。
- 宠物关闭时：缩小后进入横向胶囊 mini，显示
Topdo + 待办数。 - 迷你模式支持点击恢复，并保留拖动与位置记忆。
- 宠物模式支持角标、动画和猫咪状态反馈。
当前版本不包含顶部吸附灵动岛能力。
- macOS 10.15+
- Node.js 18+
- pnpm 10+
- Rust stable
- Xcode Command Line Tools
xcode-select --install
corepack enable
corepack prepare pnpm@10.33.0 --activatepnpm install
pnpm tauri devpnpm build
cd src-tauri && cargo check
pnpm release:macpnpm release:mac产物路径：
.app：src-tauri/target/universal-apple-darwin/release/bundle/macos/Topdo.app.dmg：src-tauri/target/universal-apple-darwin/release/bundle/dmg/Topdo_2.2.0_universal.dmg
部分 macOS 环境首次打开可能被系统拦截，可执行：
xattr -cr /Applications/Topdo.app若仍失败：
codesign --force --deep --sign - /Applications/Topdo.app
open /Applications/Topdo.app- 自动更新（Updater）
- 正式签名与公证发布
- 更完整的飞书字段映射
- 更细的搜索与标签体系
MIT
如果这个项目对你有帮助，欢迎 Star ⭐