使用说明
任务桥
人类和代理的本地任务执行控制平面
本地工作流
安装
自制木桶（macOS/Linux）：
brew tap yeisme/tap
brew install --cask taskbridge
Scoop（Windows）：
scoop bucket add yeisme https://github.com/yeisme/scoop-bucket
scoop install taskbridge
GitHub发布档案： 从以下网址下载适用于您平台的存档 发布，用以下方式验证 checksums.txt，打开包装，放好 taskbridge 在你 PATH.
直接Linux软件包资产： 下载 .deb, .rpm，或 .apk 文件来自 发布这些是直接发布的资产，而不是存储库支持的APT、YUM或APK通道。
去安装：
go install github.com/yeisme/taskbridge@latest
从源代码构建：
git clone https://github.com/yeisme/taskbridge.git
cd taskbridge
task build
软件包安装程序仅安装 taskbridge 二进制和静态发布元数据。它们不会创建提供者凭据、OAuth令牌、本地任务存储或远程Todo写入。
配置
export TASKBRIDGE_HOME=~/.taskbridge
export TASKBRIDGE_STORAGE_PATH=~/.taskbridge/data
export TASKBRIDGE_PROVIDERS=microsoft,todoist
首次使用时，请先运行诊断程序，然后尝试演示：
taskbridge doctor
taskbridge quickstart
taskbridge demo today
提供商身份验证
taskbridge auth status
taskbridge auth login microsoft
taskbridge auth login google
taskbridge auth login feishu
taskbridge auth login ticktick
taskbridge auth login dida
taskbridge auth login todoist
taskbridge provider list
taskbridge provider enable todoist
taskbridge provider test todoist
有关详细的提供程序连接指南，请参阅 docs/provider-setup-guide.mdOAuth凭据文件保存在 ~/.taskbridge/credentials/<provider>_credentials.json，身份验证令牌保存在 ~/.taskbridge/credentials/tokens.json.
任务浏览和管理
taskbridge list
taskbridge list --all
taskbridge list --source microsoft --status todo
taskbridge list --query "today"
taskbridge list --format json
taskbridge lists
taskbridge lists --source microsoft
taskbridge task add "Organize OpenSpec output contract" --due 2026-06-10 --priority 3
taskbridge task show <task-id> --format json
taskbridge task edit <task-id> --due 2026-06-12
taskbridge task done <task-id>
taskbridge task undo <task-id>
list 支持按来源、状态、象限、优先级、标签、列表和关键字进行过滤；输出格式包括 table, json, markdown, compact，以及 tsv. task 以本地存储为目标，不直接写入远程提供商；必须进行远程同步 sync.
同步
taskbridge sync pull microsoft
taskbridge sync push todoist
taskbridge sync bidirectional microsoft --target todoist
taskbridge sync status
taskbridge sync diff microsoft --target todoist --format json
taskbridge sync conflicts
taskbridge sync resolve <conflict-id>
taskbridge sync backup create
taskbridge sync backup restore <backup-id>
taskbridge sync audit <session-id> --format json
taskbridge sync watch microsoft --interval 10m
sync pull 写入本地存储； sync push 写入远程提供者； bidirectional 双向书写。 --dry-run 不写入本地存储或调用远程写API。远程覆盖、删除和冲突丢弃需要明确确认。
日常控制平面
taskbridge today
taskbridge today --json
taskbridge next
taskbridge next --limit 3
taskbridge next --source openspec
taskbridge inbox
taskbridge inbox --limit 10 --source todoist
taskbridge review
taskbridge review --json
taskbridge review --apply-file actions.json --dry-run
taskbridge review --apply-file actions.json --confirm
新用户可以在没有任何提供商身份验证的情况下进行浏览：
taskbridge demo today
taskbridge demo today --json
today 是日常任务工作台：在一个视图中显示今天必须完成的任务、有风险的任务和建议的下一步。 next 推荐现在要推进的最有价值的任务。 inbox 列出没有家庭、截止日期或分流状态的任务。 review 进行健康检查并建议采取行动；默认情况下，它只建议，从不写入。
项目规划
taskbridge project create "Learn OpenClaw"
taskbridge project create "Ship TaskBridge control plane" --goal-text "Complete the four control-plane phases"
taskbridge project list
taskbridge project split <project-id> --max-tasks 10
taskbridge project split-markdown <project-id> --file plan.md
taskbridge project confirm <project-id>
taskbridge project sync <project-id>
taskbridge project review <project-id>
taskbridge project next <project-id>
taskbridge project adjust <project-id>
taskbridge project done <project-id>
taskbridge project archive <project-id>
project create 创建草稿； split 生成分解建议； confirm 确认并创建存储中的本地任务； sync 同步到提供商。 adjust 默认情况下为模拟运行，在应用操作之前需要确认。 archive 不会删除历史数据。
治理和智能协助
taskbridge governance overdue-health --format json
taskbridge governance resolve-overdue --dry-run
taskbridge governance resolve-overdue --confirm
taskbridge governance rebalance-longterm --format json
taskbridge governance detect-decomposition --limit 10 --format json
taskbridge governance decompose-task <task-id> --format json
taskbridge governance decompose-task <task-id> --write-tasks
taskbridge governance achievement
overdue-health 分析逾期任务的健康状况； resolve-overdue 批量处理逾期任务； rebalance-longterm 重新分配长期未安排的任务； detect-decomposition 识别复杂的任务候选者； decompose-task 将任务拆分为执行步骤； achievement 分析完成情况。批量完成、批量重新调度、删除和远程覆盖必须有一个模拟运行/确认/操作文件门。
分析
taskbridge analyze quadrant
taskbridge analyze priority
taskbridge analyze priority --json
taskbridge analyze time
taskbridge analyze trend
taskbridge analyze report --json
analyze 提供象限、优先级、时间分布、趋势和组合报告分析。默认人工输出使用共享统计面板； --json 输出信封，而传统 --format json 与可解析的有效载荷保持兼容。这些是只读命令：它们不会更改任务或同步提供程序。
代理集成
taskbridge agent capabilities
taskbridge agent today
taskbridge agent plan "Learn OpenClaw" --dry-run
taskbridge agent execute --action-file actions.json --dry-run
taskbridge agent execute --action-file actions.json --confirm
taskbridge agent schemas
agent 是代理安全执行入口点。stdout总是 taskbridge.agent-result.v1 JSON。代理不直接读写 ~/.taskbridge 数据文件，不包含提供者令牌。危险行为卷土重来 requires_confirmation=true 不写作时 --confirm 不见了。
常规命令应首选 --json 信封或 --agent key=值输出，例如 taskbridge version --json, taskbridge provider list --agent，以及 taskbridge config show --json；代理脚本不应解析人工输出。
后台服务
taskbridge serve
taskbridge serve --token-refresh
taskbridge serve --sync --sync-interval 15m
serve 启动一个长时间运行的后台服务，用于自动令牌刷新和定时同步。日志会转到stderr或日志系统；stdout遵循JSON/events合约。
交互式终端
taskbridge tui
启动交互式终端界面，用于浏览和操作任务。TUI不是可脚本化的机器输出入口点；代理和CI不应依赖于TUI输出。
支持的平台
| 平台 | 状态 | 授权方式 | 备注 |
|---|---|---|---|
| 微软Todo | ✅ 完成 | OAuth 2.0 | 完全支持 |
| 谷歌任务 | ✅ 完成 | OAuth 2.0 | 基本支持 |
| 飞舒任务 | ✅ 完成 | OAuth 2.0 | 完全支持 |
| TickTick | ✅ 完成 | OpenAPI令牌 | 本机象限 |
| 迪达 | ✅ 完成 | OpenAPI代币 | 中国版 |
| Todoist | ✅ 完成 | API令牌 | 完全支持 |
| OmniFocus | 📋 计划 | -- | 仅限macOS |
| 苹果提醒 | 📋 计划 | -- | macOS/iOS |
项目结构
taskbridge/
├── cmd/ # CLI command entry points
├── internal/
│ ├── auth/ # Tokens and authentication
│ ├── model/ # Core data models
│ ├── project/ # Project and planning storage
│ ├── projectplanner/ # Goal decomposition and plan suggestions
│ ├── provider/ # Todo app adapters
│ │ ├── microsoft/ # Microsoft Todo
│ │ ├── google/ # Google Tasks
│ │ ├── feishu/ # Feishu Tasks
│ │ ├── ticktick/ # TickTick / Dida
│ │ └── todoist/ # Todoist
│ ├── storage/ # Storage layer
│ └── sync/ # Sync engine
├── pkg/
│ ├── config/ # Configuration management
│ ├── logger/ # Logging
│ ├── paths/ # Path conventions
│ └── ui/ # CLI/TUI UI components
├── docs/ # Design and usage docs
│ └── commands/ # Command manual
└── openspec/ # OpenSpec change management
技术栈
- 语言：去1.25+
- 命令行界面：眼镜蛇
- 配置：毒蛇
- 存储：文件存储/MongoDB（可选）
本地验证和开发工具
task deps
task fmt-check
task lint
task test
task build
task check
首次设置开发机器时，请安装辅助工具：
task tools:install
发布配置和本地快照构建：
task release:check
task snapshot
task release:local
可选热重新加载（需要空气）：
task dev:watch
当 task 如果未安装，请使用等效命令：
go test ./...
mkdir -p dist && go build -trimpath -ldflags="-s -w" -o dist/taskbridge
