支持
这里写的每一条都是应用实际的行为。如果你看到的和下面写的不一样, 那就是个 bug —— 告诉我。
快速上手
TaskHolder 能做什么
TaskHolder 把 Markdown 计划变成可以看见、可以移动的卡片。导入 AI 写的计划或你自己写的计划,其中的阶段和任务会变成画布上的卡片,完整大纲显示在任务树中。
你可以调整计划顺序、编辑卡片、标记进度,并附加文件、链接和提示词。把卡片拖进 Claude Code 或其他应用即以 Markdown 交出,完成后再把计划导出回 Markdown。导入绝不会修改原始的 .md 文件。
可选的 AI 控制塔会显示哪个 Claude Code 会话正在处理哪张卡片。它只在你的 Mac 上运行,不需要 API 密钥。
安装
下载 .dmg,它在
下载页面上,打开后把
TaskHolder 拖进「应用程序」文件夹。
需要 macOS 12 或更高版本,Apple Silicon 和 Intel 都支持。
如果 macOS 提示应用「已损坏」:这说明下载下来的文件丢了签名, 通常是下载中断造成的。删掉它、清空废纸篓,再重新下载一次。如果还是这样, 请联系我,不要去找绕过的办法。
最初的 14 天
登录一次,完整的应用就属于你 14 天 —— 全部功能,不需要银行卡。 试用绑定在你的账户上,不绑定机器,所以重装既不会让它重新开始, 也不会让它提前结束。
期限结束后,TaskHolder 会请你购买授权才能继续编辑。 导出你的成果始终是开放的,试用结束后也一样。 文件是你的。
你的第一个项目
1. 创建项目。按 ⌘N,按你要规划的内容选择 Code、Video 或 Blog。
2. 导入计划。按 ⌘I,或把 .md 文件拖到画布上。文件是如何解析的,会显示在底部的 🧭 解析方式。
3. 调整。在左侧任务树中调整顺序。双击卡片即可编辑。
4. 交出卡片。按 E 进入导出模式,选中卡片,拖进 Claude Code、聊天窗口或任何应用,内容会以 Markdown 形式进入。
5. 保存与导出。⌘S 把项目保存为 .taskflow 文件。在 文件 ▸ 导出 中可以导出 Markdown、JSON、YAML 或纯文本。
帮助 ▸ 教程 会在应用内一步步带你完成这些操作,随时可以重看。
购买之后
一次付款,永久拥有,没有订阅。授权存在你的账户里,所以在新电脑上登录就能恢复。 没有会弄丢的授权码,也不用到处找「恢复购买」按钮: 登录就是恢复。
使用 TaskHolder
把计划带进来
把 Markdown 文件拖到画布上,或按 ⌘I。标题会变成卡片,标题的层级就是你看到的层级。标题下的列表项会作为文字留在该卡片中。TaskHolder 如何解析你的文档
TaskHolder 会把原文与项目一起保存。开启 保留源文档(设置 ▸ Editor,默认关闭)后,完整导出导入的文件时,未编辑的内容会原样保留,包括格式、空行和注释。
动手调整
在任务树中拖动来调整顺序或更换父级。在画布上可以自由摆放卡片,双击空白处即可新建卡片。画布只显示最底层的卡片,阶段等父级卡片在任务树中。
- ⌘N
- 新建项目
- ⌘O
- 打开项目
- ⌘S
- 保存
- ⌘I
- 导入 Markdown
- ⌘E
- 导出
- ⌘Z
- 撤销
大多数画布快捷键都可以在 Settings → Shortcuts 里重新设置。
送它回去干活
按 ⌘E 以默认格式导出,或在 文件 ▸ 导出 中选择 Markdown、JSON、YAML 或纯文本。若只想把几张卡片交给 AI,按 E,选中卡片,拖进 Claude Code 或聊天窗口。
Markdown 与 .taskflow 的区别:Markdown
用来阅读和交接。.taskflow 是完整的项目文件 ——
它保留卡片位置、剪贴内容和其他一切。保存工作用它,分享成果用 Markdown。
跟进 Claude Code(可选)
在 设置 ▸ AI & Agents 中开启 AI 模式,然后选择 连接 Claude Code。在写入任何内容之前,对话框会先显示将要修改哪个设置文件、添加什么内容。断开连接只会移除它添加的内容。
把卡片拖进 Claude Code 会话,或使用 AI 面板中的 在 Claude Code 中开始,带着整个计划启动会话。每张卡片都会显示正在处理它的会话。开启自动状态后,Claude 完成的卡片会移到 Test。标记 Done 始终由你决定。
需要同一台 Mac 上安装 Claude Code 2.1.269 或更高版本。无需 API 密钥,也没有额外费用。
导入 Markdown
TaskHolder 如何把文档变成卡片,以及怎样写出能顺利导入的计划。
TaskHolder 如何解析你的文档
TaskHolder 用一种方式解析整个文件。它按顺序检查下面五种方式,采用第一个适合整篇文档的方式。
- 关键词结构
## Phase 1·### Task 1.1- 编号结构
## 1.·### 1.1- 标识符结构
AW-03·FR-1·Article 1· 제1조- 清单结构
- [ ]行- 标题结构
#的数量决定层级
关键词结构识别 Phase、Step、Stage、Part、Chapter、Task、Item、Action、Todo 和 Subtask,后面需要带编号,例如 "Phase 1" 或 "Task 2.3"。
所用的方式显示在底部的 🧭 解析方式。如果卡片拆分得不对,可以在那里选择其他方式。TaskHolder 会用该方式重新载入原始文件,并丢弃导入后所做的编辑,所以最好在导入后立即切换。
不会丢掉任何内容。第一个任务之前的标题或简介、最后一个任务之后的章节都会保存在项目中。普通列表项和粗体标签会作为文字留在卡片里。画布显示最底层的卡片,阶段等父级卡片在任务树中。
写出能顺利导入的计划
每个任务给一个独立标题。例如 ## Phase 1: 准备 下面写 ### Task 1.1: 安装。每个标题会变成一张卡片。
关键词后面加编号。"Phase 1" 和 "Task 2.3" 会被识别为结构,单独的 "Phase" 不会。
一个文件只用一种写法。整个文件用同一种方式解析,混用编号标题和关键词标题可能得到意料之外的卡片。
细节写在标题下面。标题下的列表和段落会成为该卡片的内容。如果想把列表项拆成卡片,请在 设置 ▸ Editor 中修改卡片深度级别。
把 ID 写进标题。阶段下面的 ### AW-01、### P0-1 这类标题会成为子卡片。
用中文写计划?关键词是英文单词。请使用 ## 1.、### 1.1 这样的编号标题。
请 AI 按这种格式写。例如:"用 ## Phase N: 标题 和 ### Task N.M: 标题 的标题格式写计划,每个任务的细节用列表写在它的标题下面。"
故障排查
下面是 TaskHolder 实际会显示的提示,以及每一条到底是什么意思。
「需要重新验证(在线)」
你的授权已经离线校验到了允许的上限。连上网络再打开 TaskHolder, 它会自己重新校验,通常几秒钟就好。
这条提示出现时你并没有被锁住。它的意思是「我们最近没能完成校验」, 而不是「你没付钱」。
「需要检查时钟」
TaskHolder 发现系统时钟往回走了,而它没办法把这和「有人想延长试用」区分开。 请把 Mac 设置为网络时间(系统设置 → 通用 → 日期与时间 → 自动设置),然后重新打开应用。
你的项目分毫未动。这项检查不会删除任何东西。
「你的试用已结束」
14 天用完了。在那个界面上购买授权,付款完成的瞬间应用就会解锁 —— 不用重启。
已经买过了?在同一个界面上点在线重新验证。 如果仍然显示已过期,请确认你登录的是付款时用的那个账户 —— 授权是跟着账户走的。
我的 Markdown 导入结果和预期不一样
先看底部的 🧭 解析方式。它会显示 TaskHolder 用了哪种方式,导入后可以立即换成其他方式。只有粗体或列表项不会生成卡片,请给每个任务一个标题。写出能顺利导入的计划
导入不会修改你的 .md 文件,没有变成卡片的文字也会保存在项目中。如果在意的文档仍然导入得不好,请发给我,这些样本正是改进解析器的依据。
有东西不见了
先按 ⌘Z —— 一次撤销对应一次操作, 一次删掉好几张卡片也能一起撤回来。
如果撤销够不到它,请先停下,在那个项目里别再继续操作, 联系我。不要靠继续编辑来自行修复 —— 那可能会覆盖掉还能救回来的内容。
联系方式
这些邮件是真人在看 —— 就是我,开发者本人。72 小时内回复。
发邮件到 [email protected]这个按钮会自动填好你的应用版本和操作系统。 除此之外什么都不收集,你的项目也绝不会被发送到任何地方。
提供这些信息能让我修得更快
- 你做了什么操作,实际发生了什么
- 如果有提示,它的确切内容
- 是每次都出现,还是偶尔出现
- 如果是导入问题:方便的话,附上那个 Markdown 文件
想看更简短的答案? 问答页面整理了大家在购买前 最常问的问题。