任务跟踪 — 用户手册 | YoBench
如何在 YoBench 中使用「任务跟踪」模块:8 个提供商(Yandex Tracker、JIRA、GitHub、GitLab、Linear、Asana、Trello、Redmine)、AI 估算、筛选与看板。
「任务跟踪」模块的用途
该模块将所有企业级任务跟踪系统中的任务汇总到一个地方。无需在八个浏览器标签页(Yandex Tracker、JIRA、GitHub、GitLab、Linear、Asana、Trello、Redmine)之间来回切换 — 您可以在一个统一的列表或看板中看到所有项目和团队的任务,并享有筛选、搜索、AI 估算和本地缓存功能。
您将获得:
- 来自 8 个系统的统一任务队列 — 每个集成都将数据存储在本地加密数据库,即使离线也能继续工作。
- 列表视图与看板视图 — 一键在扁平列表和按状态分组的看板间切换。
- AI 复杂度估算 — 在任务详情中直接的按钮:AI 读取描述、评论与清单,返回小时估算与依据。
- 对原生任务的丰富操作 — 内部任务支持:状态变更、富文本评论、工时记录、清单、标签、任务关联与自定义字段。
- 支持全文搜索的自定义字段 — 按项目定义文本、数字、日期或下拉字段;搜索它们与核心字段一样快。
- 任务详情子标签 — 描述、清单、评论、活动、关联与 AI 估算分布在专门的子标签上,即使任务很长面板依然清爽易读。
- 按连接独立的调度器 — 每条跟踪器连接拥有独立的轮询间隔(
poll_minutes),活跃的 JIRA 可以每 2 分钟刷新,而平稳的 Redmine 每小时轮询一次。 - 分页评论与无限滚动 — 长讨论分页加载,大型任务列表持续平滑滚动,不卡顿。
- 外部任务的只读视图 — 来自接入跟踪器的任务在 YoBench 内显示;修改请在源系统中进行。
- 后台同步 — 每条连接按各自间隔轮询,无需人工干预。
支持的提供商与连接参数
代码中已实现 8 个适配器,均可在「添加连接」表单中选择。
Yandex Tracker
- 组织类型(
cloud或360) - 组织 ID
- OAuth 令牌
- 可选:负责人筛选、自定义查询
JIRA Cloud
- 主机 — 例如
https://yourteam.atlassian.net - 邮箱
- API 令牌
- 可选:项目键(用于筛选)
GitHub Issues
- Personal Access Token
- 仓库(格式
owner/repo)(必填) - 可选:负责人筛选
GitLab Issues
- Personal Access Token
- 项目 ID 或路径 (必填)
- 可选:GitLab URL(自托管)
Linear
- API Key
- 可选:团队键、负责人邮箱
Asana
- Personal Access Token
- Project GIDs (必填)
- 可选:负责人姓名
Trello
- API Key
- API Token
- Board IDs (必填)
Redmine
- Redmine URL
- API Key
- 可选:项目标识
UI 功能
列表视图
表格列:
| 列 | 含义 |
|---|---|
| 类型 | 任务类型图标(epic / story / task / bug 等)。 |
| 标题 | 任务标题,可点击进入详情。 |
| 状态 | 当前映射状态的彩色徽章。 |
| 优先级 | 紧急 / 高 / 中 / 低 / 无 — 视觉突出。 |
| 负责人 | 头像与姓名。 |
| 截止日期 | Deadline(due_date)。 |
| 更新时间 | 上次修改时间。 |
看板视图
列对应所选项目的状态或状态映射。卡片可在列间拖拽 — 原生任务即修改状态,外部任务则会同步回源跟踪器。
筛选
- 按状态、优先级、负责人
- 按项目、标签、关联类型(
internal/external) - 按标题搜索
- 自定义任务字段筛选
- 排序:更新时间、优先级、创建时间、截止日期
任务操作
原生任务(在 YoBench 内创建):
- 创建 / 编辑 / 归档
- 状态变更(看板拖拽或详情面板)
- 富文本评论(TipTap),长讨论分页加载并支持无限滚动
- 工时记录(
estimate_hours、spent_hours) - 清单与子项
- 标签(项目级共用注册表)
- 任务关联:阻塞 / 依赖 / 重复
- 自定义字段:文本、数字、日期、下拉选择 — 与标题、描述一同被全文索引覆盖
- 跨项目移动
外部任务(来自接入的跟踪器): 仅查看 + AI 估算。修改请在源系统中进行 — 下次轮询时同步过来。
自定义字段与全文搜索
您可以按项目定义类型为 text、number、date 或 select 的自定义字段。定义后它们会出现在任务编辑器中,并作为列表视图中可筛选的列。全文索引除了覆盖核心字段(标题、描述、评论)之外,还覆盖每个自定义文本字段 —— 因此当您按客户编号、工单引用或发布标签搜索时,无论值存放在哪里都能找到任务。
任务详情子标签
右侧详情面板始终显示头部(状态、优先级、负责人、截止日期),正文则被拆分到多个子标签:
- 描述 — 任务正文与元数据。
- 清单 — 多个命名清单,支持拖动重排。
- 评论 — 分页讨论流,支持富文本与回复。
- 活动 — 所有变更的时间序列。
- 关联 — 阻塞 / 依赖 / 重复。
- AI 估算 — 运行、查看与重新运行 AI 复杂度估算。
AI 任务估算
任务详情面板中有 AI 估算 标签页。点击 运行 AI 估算 后,模块会:
- 收集任务标题、描述、评论与清单项。
- 发送给所选 AI 提供商(见全局设置)。
- 接收带有依据的小时估算。
- 将结果保存到本地数据库(
tracker_ai_estimates),可随时重新运行。
模块全局设置
在 设置 → 任务跟踪 中配置:
- AI 估算提供商(
trackerAiProviderId)— 哪个 AI 聊天 中的提供商驱动 AI 估算。 - AI 估算提示词(
trackerAiEstimatePrompt)— 请求模板。可按您的方法论(故事点 / 小时 / T-shirt sizing)调整。
轮询间隔(poll_minutes)按连接独立设置,非全局。
使用流程
1. 连接跟踪器
- 在左侧菜单打开 任务跟踪 模块。
- 在侧边栏点击 添加连接。
- 选择适配器类型(Yandex Tracker / JIRA / GitHub / GitLab / Linear / Asana / Trello / Redmine)。
- 填写必填字段(主机、令牌、项目 — 取决于适配器)。
- 可选地配置状态映射 — 源系统状态对应到内部状态。
- 保存。首次同步将自动启动。
2. 手动触发同步
侧边栏每个连接旁有 同步 按钮。不点击则按配置间隔轮询(通常 5–15 分钟,按连接设置)。
3. 处理任务
- 列表 — 默认视图,用于浏览队列。
- 看板 — 在状态列之间拖拽卡片。
- 筛选 — 设置自己的条件(例如「我的任务、进行中、紧急优先级」)。
- 任务详情 — 点击行打开右侧面板:描述、评论、清单、活动日志、关联、AI 估算。
4. 运行 AI 估算
在任务详情切换到 AI 估算 → 运行 AI 估算。结果会保存,并作为附加指标显示在列表中。
5. 管理连接
- 编辑 — 修改参数或状态映射。
- 删除 — 断开连接并移除关联任务的本地缓存。
下一步
- 配置 AI 提供商 — 没有它们 AI 估算无法工作。
- 使用 日历 在时间线上查看带截止日期的任务。
- 想集中分析代码项目可同时使用 Git Analytics。
帮助与反馈
发现 Bug 或想新增适配器?通过反馈表单联系我们。