Topdo

KO | EN

gitlite — search

#ai #go #android #machine-learning #deep-learning #nodejs #java #windows #kubernetes #security #openai #ios #mcp #open-source

(★ 17)

Topdo 是一款基于 Tauri + Vue 3 的 macOS 桌面任务悬浮窗，支持本地模式与飞书同步。

Topdo Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Topdo

### 把任务、习惯和提醒放在你眼前

macOS 桌面悬浮效率工具，支持本地离线、飞书同步、习惯打卡、截止提醒和轻量任务编辑。
Built with **Tauri 2 + Vue 3**

![Platform](https://img.shields.io/badge/platform-macOS-111111?style=flat-square)
![Version](https://img.shields.io/badge/version-v2.2.0-2563eb?style=flat-square)
![Arch](https://img.shields.io/badge/arch-Universal%20(Apple%20Silicon%20%2B%20Intel)-10b981?style=flat-square)

![Topdo 产品介绍图](https://raw.githubusercontent.com/SkyNone/Topdo/main/docs/images/topdo-v2.0.2-promo.jpg)

</div>

---

## 下载

- [下载 Topdo v2.2.0 macOS Universal DMG](https://github.com/SkyNone/Topdo/releases/download/v2.2.0/Topdo_2.2.0_universal.dmg)
- [查看 v2.2.0 Release](https://github.com/SkyNone/Topdo/releases/tag/v2.2.0)

下载 `.dmg` 后，将 `Topdo.app` 拖到 `Applications` 即可。

> 当前安装包未做 Apple notarization。首次打开若被 macOS 拦截，请参考下方「安装排障」。

### 使用文档

- [快速上手](docs/GETTING_STARTED.md)
- [飞书同步配置指南](docs/FEISHU_SETUP.md)
- [FAQ](docs/FAQ.md)
- [隐私说明](docs/PRIVACY.md)

---

## 一句话价值

Topdo 是一个“**常驻、低打扰、键盘优先**”的桌面任务工具：
你可以快速记录任务、推进状态、设置提醒、同步飞书，也可以用习惯模块追踪每天的固定动作。

---

## Topdo v2.2.0 当前能力

| 能力 | 说明 |
|---|---|
| 本地模式 | SQLite 本地持久化，离线可用，开箱即用 |
| 飞书同步 | 对接飞书多维表格，支持任务字段、标签同步与优先级映射 |
| 任务三态 | 待办 / 进行中 / 已完成，适合执行推进 |
| 优先级分组 | 紧急 / 重要 / 普通分组展示，紧急固定展开，重要和普通可收起 |
| 搜索过滤 | `⌘F` 按任务名称和备注搜索，顶部保留搜索状态 |
| 自定义标签 | 每个任务最多 5 个标签，保留最近 5 个标签便于复用 |
| 轻量编辑 | 双击标题改名，详情页可改优先级、截止时间、提醒、重复、子任务和备注 |
| 习惯模块 | 支持创建习惯、打卡、连续天数和习惯提醒 |
| 截止提醒 | 支持 macOS 系统通知，并提供应用内 toast 兜底提醒 |
| 数据导出 | 支持 JSON / CSV / Markdown 导出 |
| 桌面体验 | 置顶、迷你模式、托盘驻留、关闭宠物后的横向胶囊 mini |
| 宠物模式 | 猫咪状态、角标、动画反馈和位置记忆 |
| Universal 安装包 | 同时支持 Apple Silicon 和 Intel Mac |

---

## v2.2 主要新增

- **日有所成**：汇总当天完成的任务与习惯，支持保存为图片、复制文字，并根据完成数量展示不同激励文案。
- **飞书字段映射**：标签可绑定已有多选字段；多个飞书枚举值可映射到同一个 Topdo 优先级，适配不同团队的表格结构。
- **重复任务可靠性**：停止重复时会同时停用原始任务和全部周期实例，避免后续编辑后重复规则再次生效。
- **导出反馈优化**：“日有所成”保存后展示完整路径，可直接在 Finder 中查看；复制和保存反馈始终显示在可见区域。
- **同步与数据体验修复**：继续改善飞书标签同步、历史完成统计和本地缓存一致性。

---

## v2.1 主要新增

- **自定义标签**：任务支持轻量标签，最近 5 个标签可复用；标签会同步到飞书多维表格。
- **同优先级内排序**：支持在同一优先级分组内手动调整任务顺序，适合整理当天执行顺序。
- **分组收起优化**：`重要 / 普通` 支持收起，`紧急` 固定展开，避免关键任务被隐藏。
- **新建任务防误触**：新建面板内改为 `⌘Enter` 创建任务，普通回车不再误创建，中文输入更安全。
- **飞书同步可靠性**：修复重复创建、长期待同步、缺失字段、标签未同步等问题；旧模板缺少 `标签` 字段时会尝试自动创建。
- **循环任务更稳定**：按“原始任务 + 到期日期 + 循环规则”去重，避免同一期循环任务被重复生成。
- **完成反馈更轻量**：从进行中切到已完成时会有克制的小彩蛋动效，清空任务时给出轻提示。
- **迷你模式更可控**：长按拖动迷你胶囊时不再误展开主窗口，短按恢复和拖动移动区分更清楚。
- **体验细节修复**：暗色模式、新建/详情页输入、快捷键说明、标签展示、顶部创建按钮换行等细节继续打磨。

---

## v2.0 主要新增

- **习惯模块**：新增任务 / 习惯双模式，可创建习惯并完成每日打卡。
- **提醒体系**：任务截止提醒和习惯提醒都会走 macOS 系统通知；Topdo 前台时还会显示应用内 toast，避免系统通知被折叠后看不见。
- **任务详情升级**：支持编辑截止日期与时间、重复规则、提醒、子任务、备注和优先级。
- **创建任务优化**：新建面板压缩为更适合小窗口的一屏交互，支持日期、时间、重复和提醒。
- **搜索与快捷键补全**：`⌘F` 搜索、`⌘K` 快捷键面板、`⌘J` 切换任务 / 习惯。
- **设置页收敛**：保留高频设置，支持反馈入口、模板教程外链、数据导出和版本检查。
- **飞书同步修正**：本地优先级会映射到飞书已有枚举，避免多维表格中被误创建新选项。

---

## 30 秒上手

### 1. 安装应用

[下载 `Topdo_2.2.0_universal.dmg`](https://github.com/SkyNone/Topdo/releases/download/v2.2.0/Topdo_2.2.0_universal.dmg)，拖拽 `Topdo.app` 到 `Applications`。

### 2. 选择模式

- **本地模式**：无需配置，立即开始。
- **飞书同步模式**：按 [飞书同步配置指南](docs/FEISHU_SETUP.md) 完成模板、凭证和连接测试。

### 3. 创建任务

按 `⌘N` 新建任务；点击状态圈推进任务；按 `⌘1~⌘4` 切换筛选；按 `⌘F` 搜索。

### 4. 开启习惯

在设置页开启「习惯模块」，点击标题下拉可在 `Topdo / 习惯` 之间切换。

---

## 快捷键

### 全局

- `⌘N`：新建任务
- `⌘F`：搜索任务
- `⌘,`：打开 / 关闭设置
- `⌘K`：快捷键面板
- `⌘J`：任务 / 习惯切换
- `⌘⇧L`：浅色 / 深色切换
- `Esc`：关闭当前弹层

### 筛选栏

- `⌘1`：待办
- `⌘2`：进行中
- `⌘3`：已完成
- `⌘4`：全部

### 列表操作

- `↑ / ↓`：移动焦点
- `Enter`：展开 / 收起详情
- `⌘Enter`：切换任务状态
- 新建面板内 `⌘Enter`：创建任务
- 双击任务标题：直接编辑名称
- `Esc`：取消行内编辑

---

## 任务与提醒

- 截止日期支持日期和时间；只选日期时默认按当天 `23:59` 到期。
- 任务提醒支持：到期时、提前 15 分钟、提前 1 小时、提前 1 天。
- 已完成任务不会继续统计或触发逾期提醒。
- 系统通知依赖 macOS 通知权限；如果系统通知被折叠，应用内 toast 仍会在 Topdo 前台时显示。

---

## 习惯模块

- 支持每天、工作日、自定义星期。
- 支持提醒时间、连续天数和今日打卡统计。
- 习惯提醒会在设置的时间触发；当天已打卡则不会重复提醒。
- 支持编辑、归档和删除习惯。

---

## 飞书同步

第一次配置建议先阅读 [飞书同步配置指南](docs/FEISHU_SETUP.md)，再按设置页里的步骤完成模板复制、凭证填写和连接测试。

在设置页填写以下字段：

- `App ID`
- `App Secret`
- `App Token`（多维表格链接 `/base/` 后 token）
- `Table ID`（链接中 `table=` 参数）

优先级映射规则：

| Topdo | 飞书多维表格 |
|---|---|
| 紧急 | 今日必做 |
| 重要 | 本周完成 |
| 普通 | 自由安排 |

写入飞书时会自动映射，避免在多维表格中误创建新的优先级枚举值。

如果模板里没有 `标签` 字段，Topdo 会在同步标签时尝试自动创建文本字段 `标签`；如果应用权限不足，也可以在多维表格里手动新增该字段。

---

## 设置与反馈

- 设置页提供 GitHub 项目主页和用户反馈入口。
- 飞书模板和教程链接可直接用默认浏览器打开。
- 数据导出支持 JSON / CSV / Markdown。
- 点击设置页版本号可检查 GitHub 最新版本。
- 数据存储与同步范围见 [隐私说明](docs/PRIVACY.md)。
- 常见安装、通知和同步问题见 [FAQ](docs/FAQ.md)。

---

## 支持作者

Topdo 会保持核心功能免费可用。如果它真的帮你减少了任务混乱，欢迎 Star，或者[请作者喝杯咖啡](docs/SUPPORT.md)。

---

## 迷你模式与宠物模式

- 宠物开启时：缩小后进入猫咪 mini 形态。
- 宠物关闭时：缩小后进入横向胶囊 mini，显示 `Topdo + 待办数`。
- 迷你模式支持点击恢复，并保留拖动与位置记忆。
- 宠物模式支持角标、动画和猫咪状态反馈。

> 当前版本不包含顶部吸附灵动岛能力。

---

## 开发者指南

### 环境要求

- macOS 10.15+
- Node.js 18+
- pnpm 10+
- Rust stable
- Xcode Command Line Tools

```bash
xcode-select --install
corepack enable
corepack prepare pnpm@10.33.0 --activate
```

### 本地开发

```bash
pnpm install
pnpm tauri dev
```

### 常用命令

```bash
pnpm build
cd src-tauri && cargo check
pnpm release:mac
```

---

## 发布产物

```bash
pnpm 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 环境首次打开可能被系统拦截，可执行：

```bash
xattr -cr /Applications/Topdo.app
```

若仍失败：

```bash
codesign --force --deep --sign - /Applications/Topdo.app
open /Applications/Topdo.app
```

---

## 路线图

- [ ] 自动更新（Updater）
- [ ] 正式签名与公证发布
- [ ] 更完整的飞书字段映射
- [ ] 更细的搜索与标签体系

---

## License

MIT

---

如果这个项目对你有帮助，欢迎 Star ⭐

</div>

Topdo

Topdo Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Topdo

Topdo Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README