需求理解容易漂移
给 Agent 一份经过确认的任务说明和版本化上下文快照，减少反复解释与信息遗漏。
把 AI 协作变成可管理的产品流程
从一条需求，
到一条可验证的
执行链。
产品需求、任务上下文、本地 Agent 和交付记录，不再散落在不同对话里。Taskflow 把它们收进同一条清晰的工作流，让每一步都能被查看、复核和接着做。
Windows 桌面版与 Web 便携版 · 无需账号 · 需求和代码只留在你的电脑
当前工作流 本地运行
需求 · V1 候选
让 Runner 按任务分配启动本地 Agent
拆清目标、依赖和验收条件，再交给执行器。
1需求确认与任务拆分人审草稿 · 明确验收标准已确认
2冻结任务上下文需求摘要 · 依赖 · 文件范围快照 #04
3隔离目录中执行本地 Agent · 独立 Git worktree待执行
4提交成果供验收结果 · 日志 · diff · 分支待验收
一次任务，一份上下文执行过程可追踪 →
WORKSPACE · LOCAL FIRST
从协作失序到过程可见
Agent 不只是一个执行按钮。
它需要知道任务从哪里来、做到哪里。
当需求、分工和结果散落在多个聊天窗口里，问题往往不是模型不够聪明，而是缺少共享的任务状态、明确的完成标准和可回看的执行记录。
任务状态容易失联
从待执行、执行中到待验收，状态变化和阻塞原因都可以在执行看板里查看。
做完了，却难以验收
把运行结果、日志、代码差异和分支一并带回，让负责人基于交付证据作出验收判断。
功能 / WHAT IT DOES
从整理需求开始，
一步步把执行接起来。
先把单人、本机的工作流做扎实，再根据真实使用反馈决定团队共享与云端协作的边界。
需求收集与版本决策
手动新增、粘贴文本，或导入 JSON / TXT / Markdown / DOCX（先预览，再确认写入）。可搜索、按模块和版本筛选，并把每条需求标为待讨论、保留、修改后保留、延后或不做。
需求池AI 分析与可审阅拆分
先让模型（配置了 Key 时）或本机 Agent 分析需求；拆分时给出任务草稿和评估，也可能判断“无需拆分”。分析结果和草稿都先由你检查、修改，确认后才创建任务。
人审后才执行执行看板与任务流转
按待澄清、待执行、执行中、待验收、已完成和阻塞查看任务；支持依赖关系、批量派发、启动和随时终止运行。
可视化状态本地 Agent 与自定义 Harness
连接本机的 Claude Code、Codex，或你自己的命令行 Agent（如 DeepSeek Harness，在设置里填启动命令与参数）。登录令牌和 Key 只保存在本机，只在启动对应 Agent 时交给那一个进程。
本机执行器任务快照与运行历史
启动任务时冻结关联需求、全局上下文和任务说明；Run 记录状态、进度、心跳、错误、日志、diff 与交付分支，随时可以回看当时给了 Agent 什么。
上下文可回看隔离执行与人工验收
代码任务在独立 Git worktree 和分支里运行，Agent 提交后进入待验收；你检查交付、通过或写明原因退回，再用 git merge 自行合入。Taskflow 不会改动你的主分支。
本机数据与备份
需求、任务、快照、Run 和事件保存在本地 SQLite；可随时导出 JSON 备份，用于换电脑或恢复。数据库、备份和密钥放在各自的数据目录，不放进安装包。
本地数据桌面版与 Web 便携版
Windows 桌面版把本地服务、数据库和 Runner 装进一个窗口；Web 便携版用浏览器访问，包很小。两者都不需要账号，当前构建尚未代码签名。
Windows快速上手 / HOW TO USE
六步，从一条需求
走到一次验收。
第一次使用按顺序做一遍，约十分钟；之后日常只会用到第 4 到第 6 步。名称里带底色的，就是界面里的按钮或菜单。
- 1
安装并启动
桌面版：运行安装包，从开始菜单或桌面打开 Taskflow。
Web 便携版：解压后双击
start-taskflow.cmd，浏览器会自动打开http://127.0.0.1:4179。安装前，先看看 下载 部分里要提前装好的东西（Git、Agent 命令行）。
- 2
选择要改的项目
任务会在你指定的 Git 仓库里执行。桌面版：菜单 工作台 → 选择项目仓库…；Web 版：在 执行看板 顶部的 当前项目目录 里填写路径，点 保存目录。
选好后 Runner 会自动开始领取任务（桌面版的 Runner 菜单可停止或重启它）。
- 3
配好执行器和模型
打开侧栏 设置（Agent 与密钥）：Claude Code 点 登录 Claude Code，或粘贴订阅令牌 / API Key；Codex 用它自己的登录。想接别的命令行 Agent，点 添加 Agent。
想让模型帮你做分析和拆分，再到“模型接口”里填 Claude / OpenAI / DeepSeek 的 Key 和模型名（可选）。看到执行器显示“可用”再往下。
- 4
放入需求
在 需求清单 点 新增需求，或用侧栏 导入需求 粘贴文本、选择 JSON / TXT / Markdown / DOCX 文件；预览候选项，确认后才写入。
为每条需求选好决策（保留、延后、不做……）和目标版本，同一页可搜索、按模块和版本筛选。
- 5
分析、拆分并分配
在需求行点 分配 AI，选择只分配、分配并分析，或分配并执行；需求太大时点 拆分。
AI 给出的分析和任务草稿会先摆在你面前，你可以改，确认之后才会真正创建任务。可以放心试：不确认就什么都不会发生。
- 6
执行与验收
到 执行看板 勾选任务点 执行所选，或 执行全部待执行；运行详情 可看进度、日志和心跳，终止 随时停下。
完成后任务进入待验收：查看结果和代码差异，通过或写明原因退回。代码在分支
wb/<任务号>-a<次数>里，用git diff查看、git merge合入。
界面速查
- 需求清单
- 新增、筛选、决策、导入；每行有分配 AI、拆分、删除
- 执行看板
- 按状态分栏的任务，批量执行、运行详情、终止、验收
- AI 协作任务
- AI 任务的列表和各次运行，可选执行器后批量执行
- 变更记录
- 需求和任务的每一次变化
- 设置
- Agent 登录、自定义 Agent、模型接口 Key；密钥页面读不回来
- JSON 备份
- 导出整库备份；恢复只写入空数据库，不会覆盖现有数据
一条任务的完整旅程
让需求经过确认，再变成可检验的交付。
不是让 Agent 自由接管所有工作，而是明确输入、执行边界和由谁确认结果。
导入需求
整理原始想法，记录目标版本与决策。
拆分与确认
检查任务边界、依赖和可验证标准。
领取与执行
Runner 在独立工作区启动所选 Agent。
回传成果
状态、日志、结果和代码差异归档。
人工验收
通过或退回，留下可继续工作的记录。
下载 / DOWNLOAD
选一种方式，
在自己的电脑上运行。
两种方式运行的是同一个 Taskflow，数据都只保存在你的电脑上。目前提供 Windows 版本，当前为 V0.1 预览版。
最新版本 V0.1.2 · 发布于 2026-10-21 · 更新说明与历史版本
Windows 桌面版
- 一个窗口里包含本地服务、数据库和 Runner，不需要安装 Node.js
- 需要另外装好：Git，以及你要用的 Agent 命令行（Claude Code、Codex 等）
- 安装时可选目录，并创建桌面和开始菜单快捷方式
安装：下载 Taskflow-Setup-0.1.2.exe 并运行 → 打开 Taskflow → 菜单 工作台 → 选择项目仓库…。当前构建未代码签名，Windows 可能提示“未知发布者”，请只运行从你信任的来源取得的文件。
Web 便携版
- 体积很小（不到 1 MB），解压即用，不需要 npm install
- 需要另外装好：Node.js 22.13 或更新版本、Git，以及你要用的 Agent 命令行
- 数据默认在
%LOCALAPPDATA%\Taskflow\data，不在压缩包里
使用：解压 → 双击 start-taskflow.cmd → 浏览器打开 http://127.0.0.1:4179。关闭启动窗口或按 Ctrl+C 即可停止服务和 Runner。
两个版本的数据不互通。桌面版和 Web 便携版默认使用不同的数据目录；要从一个迁到另一个，先在旧的里用侧栏 JSON 备份 导出，再到新的里导入。
暂时没有 macOS / Linux 安装包。手上有项目源码并装有 Node.js 22.13+ 的话，可以在项目目录运行 npm run taskflow 启动同样的 Web + Runner。
数据留在你自己的电脑
本地状态，
本地执行，交付归你。
当前版本是本机单人工作区。页面只通过回环地址访问本地服务；服务把状态写入 SQLite，Runner 只在本机调用你配置的 Agent，并在所选 Git 仓库的隔离分支里执行。
这不是云端协作服务：没有团队账号、多成员权限、跨设备共享和云端调度。只有你配置了模型 Key、并使用模型分析或拆分时，需求标题、说明和全局上下文才会发给你选择的那家模型服务。
工作台窗口需求、看板、上下文与验收
↔
本地 API + SQLite状态机 · 快照 · Run 历史
仅监听本机回环地址 · 不将本地目录开放给网页云端
本地 Runner领取任务 · 进度回传 · 可取消
隔离 Git worktreeAgent 执行 · diff 与分支交付
数据库、备份与密钥在用户数据目录 · 支持 JSON 备份与恢复
当前版本 / V0.1 PREVIEW
先把单机执行链跑通。
现在适合个人在本机验证需求管理、Agent 执行与交付验收流程。团队共享、云端数据库、成员权限和自动更新尚未实现，路线图不当作现成功能。
✓需求导入、列表筛选与版本决策
✓AI 分析与拆分草稿审核
✓依赖任务看板与状态流转
✓本机 Runner 与自定义命令行 Agent
✓运行快照、历史、日志与 diff
✓本地 SQLite 与 JSON 备份恢复
✓Windows 安装包与 Web 便携版（未签名）
…代码签名、自动更新、macOS / Linux 安装包
…多成员实时协作与共享上下文
…云端调度与远程 Agent
常见问题
开始之前，
先了解边界。
这个预览版主要验证“需求如何更清楚地交给 Agent，结果如何可靠地收回来”。
需要提前装什么？
桌面版：Git，加上你要用的 Agent 命令行（Claude Code、Codex 等）。Web 便携版：再加 Node.js 22.13 或更新版本。Taskflow 自己不带 AI 模型，也不替你登录；Agent 的登录和额度都在你本机管理。
安装时 Windows 提示“未知发布者”怎么办？
当前构建还没有代码签名，SmartScreen 会提示。只运行从你信任的来源取得的安装包；确认无误后，在提示里选“更多信息”再选“仍要运行”。签名证书是后续发布工作。
数据存在哪里？会上传到云端吗？
不会同步到云端。桌面版放在当前 Windows 用户的数据目录里（菜单 工作台 → 打开数据目录 可直达），Web 便携版默认在 %LOCALAPPDATA%\Taskflow\data。只有你配置了模型 Key 并使用模型分析或拆分时，需求标题、说明和全局上下文（勾选“附带项目概况”时还有 README 和目录结构）才会发给你选的那家模型服务。
Agent 会直接改我的主分支吗？
不会。每次执行都在独立的 Git worktree 和分支里进行，起点是项目当前的 HEAD，不会复制你未提交的修改；结束后提交到 wb/… 分支。分析类任务只读。是否合入由你用 git merge 决定。
怎么接 DeepSeek 或别的模型？
有两种用法。一是在设置的“模型接口”里填 Claude / OpenAI / DeepSeek 的 Key 和模型名，用于需求分析和拆分；二是把它的命令行工具作为自定义 Agent 来执行任务，在 添加 Agent 里填启动命令和参数。Taskflow 不预设未经确认的命令格式。
可以多人跨电脑一起用吗？
目前不可以。现在是单机单人数据库；多成员权限、实时共享状态、云端服务和远程 Agent 调度属于后续架构工作。换电脑请先用 JSON 备份 导出。