TaskPaper 是一款专为 macOS 设计的纯文本任务管理应用。它摒弃了复杂的图形界面和数据库，采用类 Markdown 的简洁语法，将任务、项目、标签组织在一个可快速搜索和过滤的纯文本文件中。其核心哲学是“用文本思考，用工具管理”，为追求高效、专注且喜爱键盘操作的用户提供了极致的灵活性。

一、核心界面与工作区详解

TaskPaper 的界面极其简洁，主要分为四个区域：

标题栏与工具栏：顶部是标准的 macOS 窗口标题栏，下方是可自定义的工具栏，包含最常用的操作按钮，如“新建”、“打开”、“搜索”、“显示已完成任务”等。
编辑区（主工作区）：这是应用的核心，一个全屏的纯文本编辑器。所有内容都以文本形式呈现：
- 项目：以冒号 : 结尾的行，例如 工作项目：。
- 任务：以连字符 - 开头的行，例如 - 撰写项目报告。
- 笔记：既不是项目也不是任务的行，用于记录想法或说明。
- 标签：在任何行末尾，以 @ 开头的关键词，如 @due(2023-10-27)、@重要。
侧边栏（导航/搜索面板）：通常位于左侧，可通过菜单栏“查看”->“显示侧边栏”或快捷键 Command + Option + S 开关。它包含：
- 搜索：输入查询语法，实时过滤编辑区内容。
- 保存的搜索：用户自定义的常用搜索条件，点击即可应用。
- 标签浏览器：自动列出文档中所有使用的标签及其数量，点击可快速按该标签过滤。
状态栏：窗口底部显示当前文档的统计信息，如总任务数、已完成数，以及光标位置等。

二、完整操作流程：从创建到导出

步骤一：创建新文件启动 TaskPaper 后，会自动创建一个名为“无标题.taskpaper”的空白文档。你也可以通过菜单栏“文件”->“新建”（Command + N）来创建。

步骤二：打开现有文件 TaskPaper 文件本质是 .taskpaper 扩展名的纯文本文件。通过“文件”->“打开”（Command + O）可以打开它，或直接打开任何 .txt 文件，TaskPaper 会将其识别。

步骤三：保存文件首次保存时，使用“文件”->“保存”（Command + S），选择位置并命名。TaskPaper 会自动添加 .taskpaper 后缀。

步骤四：创建项目在编辑区直接输入项目名称并以冒号结尾，按回车。例如：个人管理：。

步骤五：添加任务在项目下方，新起一行，输入连字符、空格，然后输入任务描述。例如：- 购买下周食材。

步骤六：添加标签在任务描述后，输入空格和标签。例如：- 购买下周食材 @待办 @due(2023-10-28) @超市。标签是 TaskPaper 实现过滤和智能管理的核心。

步骤七：组织与缩进使用 Tab 键（或 Command + ]）使任务向右缩进，创建子任务。使用 Shift + Tab（或 Command + [）向左缩进。

步骤八：标记任务完成将光标置于任务行任意位置，按 Command + D。TaskPaper 会在任务前添加一个 ✔ 符号，并为其加上 @done 标签及完成时间戳（如 @done(2023-10-27 10:00)）。再次按 Command + D 可取消完成。

步骤九：搜索与过滤点击侧边栏顶部的搜索框，或直接按 Command + F 将焦点移至搜索框。输入查询语法，如 @待办 and not @done，编辑区将只显示符合条件的内容。

步骤十：归档已完成任务首先，通过搜索 @done 找到所有已完成任务。然后，选中这些内容，剪切（Command + X），在文档底部新建一个“归档：”项目，并粘贴（Command + V）。更高效的方式是使用“脚本”（见进阶技巧）。

步骤十一：导出文档通过“文件”->“导出”菜单，可以选择多种格式：

你也可以直接复制（Command + C）编辑区的内容，粘贴到任何支持文本的地方，其结构和标签会得以保留。

快速创建任务：在任何位置，按 Command + Shift + A 可直接在当前行下方插入一个新任务项（- ）。
日期标签快捷输入：输入 @due 后，TaskPaper 通常会弹出日期选择器，或支持自然语言如 @due(today), @due(next friday)。
批量操作：结合搜索过滤出特定任务组后，使用多光标功能（按住 Option 键并拖动鼠标，或 Command 键点击）可以同时为多个任务添加或删除标签。

TaskPaper 支持 JavaScript 脚本进行高级自动化。通过“脚本”菜单（需在“偏好设置”->“通用”中启用）可以运行预设脚本，如“归档已完成任务”、“将过期任务标记为@today”等。高级用户可编写自定义脚本。

解决方案：前往菜单栏“查看”->“显示侧边栏”（Command + Option + S），以及“查看”->“显示搜索框”（Command + Option + F）。

解决方案：TaskPaper 文件是纯文本，只需将文件保存在 Dropbox、iCloud Drive、OneDrive 等同步网盘的文件夹中即可实现多设备同步和编辑。

解决方案：TaskPaper 本身不内置版本历史。但由于文件是纯文本，强烈建议配合使用具有版本控制功能的云盘（如 Dropbox 的“文件版本历史”）或 Git 仓库来管理重要文件。

解决方案：使用“折叠/展开”功能。点击项目行左侧的三角形，或使用快捷键 Command + ‘（单引号）来折叠/展开当前项目。搜索时，可以输入 @focus 然后保存为搜索，点击后只显示带有 @focus 标签的任务。