tic

Tic 是一款免费、开源的 macOS 应用，它将待办清单从菜单栏移至桌面，以浮动便签形式呈现。每个便签都是独立的清单，可拖拽、调整大小和自定义，方便在工作时保持任务可见。 ## 主要功能 - **浮动便签** – 无边框、可拖拽、可调整大小的面板。可选择让便签浮动在其他窗口之上，或显示在所有空间。位置和状态在启动间会记忆。 - **多个清单** – 可从菜单栏、⌘N 快捷键、便签内 + 按钮或 Dock 菜单创建新清单。新清单自动命名为清单 1、清单 2 等。 - **丰富任务** – 支持最多 3 层子任务（完成父任务会完成其子任务）、多行备注（Shift-Return）和行内 Markdown 格式（粗体、斜体、代码、删除线、链接）。点击编辑，拖拽排序，或右拖嵌套。 - **纯色或液态玻璃便签** – 可为每个便签选择颜色主题或半透明材质，让桌面透出。 - **卷起** – 双击便签标题栏可折叠为仅显示标题。 - **Raycast 风格搜索面板** – 居中的浮动命令面板，可搜索、打开或删除任何清单，支持全键盘导航。 - **登录时启动** – 可选自动启动，另有自定义菜单栏图标和原生 Dock 身份。 ## 系统要求 - macOS 14（Sonoma）或更高版本。 ## 安装 1. 从[发布页面](https://github.com/kasvith/tic/releases)下载最新 `Tic-vX.Y.Z.zip`，解压并将 `Tic.app` 移至 `/Applications`。 2. Tic 为临时签名（未公证），Gatekeeper 可能在首次启动时阻止。使用以下命令清除隔离标志： ```sh xattr -c /Applications/Tic.app ``` 然后正常打开。或者，右键点击 `Tic.app` → 打开 → 打开。 3. 如需自动启动，请在菜单栏菜单中启用**登录时启动**。 ## 从源码构建 Tic 是 Swift 包，无需 `.xcodeproj`。 ```sh swift run # 构建 + 启动（开发） swift build -c release # 发布构建 swift test # 运行测试套件（Swift Testing） ./scripts/package.sh # 组装 dist/Tic.app（添加 --open 启动） open Package.swift # 在 Xcode 中编辑 ``` ## 使用说明 - 菜单栏图标显示最近清单（其余在**更多清单**子菜单中），并提供**搜索清单…**、**新清单**（⌘N）和**登录时启动**的快速访问。 - 悬停便签显示控件：颜色、纯色/玻璃、置顶、卷起、**+** 新清单和关闭。点击标题重命名；底部字段添加任务（Return 保持焦点）。 - 悬停任务显示**✕**（删除）和其下方的**＋**行 – 点击可在该行下嵌套添加子任务。点击其他位置时空任务会消失。 ## 键盘快捷键 | 快捷键 | 操作 | | --- | --- | | **Return** | 完成编辑任务 / 添加输入的任务 | | **Shift-Return**（或 **⌥ Return**） | 在同一任务内换行 | | **Shift-Tab** | 将任务设为子任务（嵌套一层） | | **⌃ Shift-Tab** | 取消嵌套子任务（移回上级） | | **⌘N** | 新清单 | | **双击**标题栏 | 卷起/展开便签 | 您也可以拖拽任务排序，或右拖嵌套 – 放置指示器会显示落点（及层级）。编辑时，字段中会显示小键帽提示（⇧⏎ 换行，⇧⇥ 嵌套），无需记忆表格。 ## 架构 Tic 使用 SwiftUI 视图，托管在 AppKit `NSPanel` 中（实现真正桌面粘附行为的唯一方式），由 GRDB 提供 SQLite 支持。`AppModel` 协调器桥接菜单栏和窗口层。完整分解见 `CLAUDE.md`。 **技术栈：** Swift 6 · SwiftUI + AppKit · GRDB (SQLite) · `SMAppService`（登录项）。 ## 开发与发布 - **CI**（`.github/workflows/ci.yml`）在每次推送/PR 时构建、测试和 lint。 - **变更日志**由 [Conventional Commits](https://www.conventionalcommits.org) 和 [git-cliff](https://git-cliff.org)（`cliff.toml`）生成，保存在 `CHANGELOG.md`。 - **发布基于标签：** 推送 `v*` 标签，发布工作流构建 `Tic.app`，生成发布说明，并发布包含压缩应用的 GitHub Release。 ```sh git tag v0.1.0 && git push origin v0.1.0 ``` 图标源图位于 `Assets/`（AppIcon / Flat / MenuBar）。 ## 许可证 基于 [MIT 许可证](LICENSE) 发布。© 2026 Kasun Vithanage。