Skip to content

查询面板 ​

查询面板是 TrackFlow 的核心导航区域,位于工单列表页的左侧,灵感来自 YouTrack 的 Saved Query 功能,让你快速在不同的工单视图之间切换。

面板布局 ​

查询面板从上到下分为五个区域:

┌─────────────────────────┐
│  🔍 过滤已保存的查询...  │  ← 查询列表过滤框
├─────────────────────────┤
│  ▾ 草稿                 │  ← 草稿区
├─────────────────────────┤
│  ▾ 项目                 │  ← 项目区
├─────────────────────────┤
│  ▾ 标签                 │  ← 标签区
├─────────────────────────┤
│  ▾ 已保存的搜索          │  ← 查询列表
└─────────────────────────┘

点击各区域的 ▾ 标题可以折叠/展开该区域。


草稿区 ​

显示你未完成的工单草稿。当你开始创建工单但中途取消时,已填写的内容会自动保存为草稿。

草稿操作

  • 点击草稿:恢复编辑该草稿,右侧创建面板会自动填入已保存的内容
  • 右键草稿:弹出菜单,可删除单条草稿
  • 点击「新建工单」:清空草稿,重新开始创建

TIP

草稿只保存在本地浏览器,不同设备、不同浏览器之间不共享。


项目区 ​

显示你收藏的项目列表,用于快速按项目过滤工单。

项目列表

  • 所有项目:显示你所有可访问项目的工单(默认选中)
  • 收藏的项目:点击项目名,右侧工单列表只显示该项目的工单

收藏项目

点击项目区右上角的管理收藏项目(⭐ 图标),弹出项目选择列表,勾选想要显示在面板中的项目。


标签区 ​

显示你收藏的工单标签,用于快速按标签过滤工单。

  • 每个标签后面显示该标签下的工单数量
  • 点击标签名,右侧工单列表只显示带该标签的工单
  • 点击管理标签收藏可添加/移除收藏的标签

已保存的搜索 ​

这是查询面板的核心区域,显示所有已保存的查询列表,每行显示查询名称和匹配的工单数量。

内置系统查询 ​

以下查询为系统内置,所有用户都有,不可删除:

查询名图标说明
分配给我🎯当前用户为负责人的工单
我报告的🐛当前用户创建的工单
未解决📌所有状态类别为 Open 或 In Progress 的工单
最近更新—按更新时间倒序排列的所有工单
我评论的—当前用户评论过的工单

自定义查询 ​

除系统内置外,你可以创建自己的命名查询:

创建查询

  1. 在工单列表右侧设置好筛选条件
  2. 点击查询面板「已保存的搜索」右侧的 + 按钮
  3. 输入查询名称,点击保存

管理查询

鼠标悬停在查询行右侧会出现 ⋯ 按钮,点击弹出菜单:

操作说明
重命名修改查询名称
编辑修改查询的筛选条件
共享将查询共享给其他团队成员
置顶将查询固定到列表顶部
删除删除该查询(系统查询不可删除)
收藏在查询名称前显示 ⭐ 标记

共享查询

共享后的查询对项目所有成员可见,显示在他们的查询面板中(标注「共享」来源)。


查询语法 ​

在工单列表顶部的搜索框中,支持两种模式:

筛选模式(Filter) ​

点击切换到筛选模式(漏斗图标),以图形化的方式添加筛选条件:

  1. 点击 + 添加筛选条件
  2. 选择字段(状态、负责人、优先级、Sprint 等)
  3. 选择操作符(等于、不等于、包含等)
  4. 输入或选择筛选值

多个筛选条件之间为 AND 关系(同时满足)。

点击切换到搜索模式(搜索图标),在输入框中直接输入结构化查询语法:

字段名: 值 字段名: 值 ...

支持的字段

字段说明示例
assignee负责人用户名,me 表示当前用户assignee: me
reporter创建者用户名reporter: zhangwei
status状态名称status: 进行中
priority优先级priority: 高
project项目 Keyproject: DE4
sprint迭代名称sprint: "Sprint 33"
tag标签名称tag: Backend
type工单类型type: 缺陷
created创建时间created: today
updated更新时间updated: -7d..today
due截止日期due: ..today

时间格式

格式说明
today今天
-7d7 天前
-1w1 周前
-1m1 个月前
2026-09-01具体日期
-7d..today最近 7 天(范围)
..today今天之前(无下限)
today..今天之后(无上限)

示例

# 分配给我且优先级为高的工单
assignee: me priority: 高

# DE4 项目本周创建的缺陷
project: DE4 type: 缺陷 created: -7d..today

# 所有逾期未解决的工单
due: ..today status: 待处理

面板操作 ​

调整面板宽度 拖拽面板右侧的分隔线(鼠标变为双向箭头时拖拽),可以调整查询面板的宽度。

折叠/展开面板 双击分隔线,或点击面板顶部的收起按钮,可以完全折叠查询面板,获得更大的工单列表显示区域。再次双击或点击展开按钮恢复。

Released under the MIT License.