搜索与序列
搜索
Backlog.md 基于 Fuse.js 提供统一的模糊搜索服务，覆盖任务、文档和决策记录。
CLI 搜索
执行 backlog search 并在后面输入关键词，即可在所有项目中搜索：
backlog search "用户登录"
过滤条件
| 选项 | 说明 | 示例 |
|---|---|---|
--type <type> |
限制结果类型（task、document、decision） |
--type task |
--status <status> |
按任务状态过滤（可重复或逗号分隔多选） | --status "In Progress" |
--exclude-status <status> |
排除指定状态的任务 | --exclude-status "Done" |
--unassigned |
只显示没有负责人的任务 | --unassigned |
--priority <priority> |
按优先级过滤（high、medium、low） |
--priority high |
--modified-file <path> |
按修改文件路径子串过滤 | --modified-file src/api.ts |
--completed |
搜索范围扩大到 completed 语料中的历史任务 | --completed |
--limit <number> |
限制返回结果总数 | --limit 10 |
--plain |
纯文本输出 | --plain |
组合搜索示例
# 搜索包含 "api" 且状态为 In Progress 的任务
backlog search "api" --status "In Progress"
# 搜索高优先级的 bug
backlog search "bug" --priority high --type task
# 搜索关联了某个文件的改动
backlog search "auth" --modified-file src/auth.ts
# 仅搜索文档和决策
backlog search "架构" --type document --type decision
# 排除已完成任务
backlog search "api" --exclude-status "Done"
# 只搜索未指派的高优先级任务
backlog search "api" --unassigned --priority high
# 只看前 20 条，然后翻下一页
backlog search "api" --max-count 20
backlog search "api" --max-count 20 --skip 20
# 只输出匹配总数
backlog search "api" --count
列表分页
backlog search 与 task list、draft list、milestone list、doc list、doc search、decision list、memo list 共 8 个列表命令统一支持 grep 风格的分页窗口选项：
| 选项 | 说明 | 示例 |
|---|---|---|
--max-count <n> |
最多输出 n 条 | --max-count 20 |
--skip <n> |
跳过前 n 条（取下一页） | --skip 20 |
--count |
只输出匹配总数（一个数字） | --count |
- 窗口在过滤、排序、
--limit之后按输出顺序应用，连续翻页不重叠不遗漏 - 被截断的文本输出以
Showing <first>-<last> of <total> items. Next: backlog <command> --skip <n>结尾，照抄 Next 命令即可取下一页 --count只输出数字且不能与--json组合（返回非零退出）- JSON 信封仅在窗口截断时附加
total/nextSkip字段，未截断时输出逐字节不变 milestone list的窗口单位是里程碑；--with-no-milestone的「No Milestone」节固定前置、不占配额也不计入--count
backlog instructions overview 的 List Paging Quick Reference 是这组选项的集中速查；各命令分册（任务、草稿、里程碑、文档、决策、备忘）各自覆盖本分页。
TUI 搜索
在 backlog board 或 backlog task list 的交互式界面中，输入搜索关键词即可实时过滤列表。TUI 搜索为即时响应模式，无需按 Enter，输入即更新结果。
Web 搜索
运行 backlog browser 启动 Web 界面后，按 Ctrl+K（Windows/Linux）或 Cmd+K（macOS），或点击侧边栏的搜索触发按钮，即可打开全局搜索对话框，一次检索任务、草稿、文档、决策、Wiki 页面与快速笔记。结果按类型分组，关键词与资源 ID 高亮、支持键盘操作与滚动位置记忆；查询与类型过滤同步到 /search?q=...&type=... 链接，可刷新或分享。详见全局搜索。
CLI 的
backlog search纯文本输出只覆盖任务、文档与决策；memo 与 Wiki 结果视为 Web-only 类型，仅出现在 Web 搜索与 JSON 输出中。
搜索分数阈值对齐
CLI、TUI、MCP 与 Web UI 使用统一的 Fuse.js 分数阈值 0.45，过滤掉相关性过低的结果。这避免了用短数字（如 63）搜索时误匹配到无关任务 ID，同时保持文本查询的 Fuse 语义不变。
序列
序列概念与用途
序列（Sequences）是从任务依赖关系自动计算出的可并行执行的任务组。它帮助你在不手动排期的情况下，直观了解：
- 关键路径：哪些任务必须在其他任务之前完成
- 可并行工作包：同一序列内的任务可以由不同成员同时推进
- 项目瓶颈：依赖链最长的路径往往决定整体工期
查看序列
backlog sequence list
默认以交互式 TUI 展示序列视图。按 --plain 输出纯文本：
backlog sequence list --plain
序列输出解读
Unsequenced:
back-12 - 优化首页加载速度
Sequence 1:
back-1 - 设计数据库表
back-2 - 搭建项目骨架
Sequence 2:
back-3 - 实现用户注册 API
back-4 - 实现用户登录 API
Sequence 3:
back-5 - 部署到测试环境
- Unsequenced：没有依赖关系、也没有被其他任务依赖、且未设置 ordinal 的任务。它们不阻塞任何任务，也不被任何任务阻塞
- Sequence N：第 N 层可并行任务组。Sequence 1 没有前置依赖，Sequence 2 依赖于 Sequence 1 中的某些任务，以此类推
- 已标记为
Done的任务不会出现在序列中
TUI 序列视图操作
backlog sequence list 的交互式界面已重写为双面板布局：
- 左侧栏：分两组列出
Unsequenced任务与Sequence 1、Sequence 2……各序列，点击切换当前聚焦的序列 - 右侧任务列表：展示当前序列（或 Unsequenced）下的任务，方向键或
j/k浏览，Enter查看任务详情 - 移动模式：在任务列表上按
m进入，调整任务顺序并自动更新依赖关系（移动预览由纯函数buildMovePreview计算，所见即所得） - 按
Escape或q退出
重写前的递归式
select item在深层序列上会栈溢出，现已通过buildSequenceRows等纯函数消除。
Web UI 序列页面
在浏览器界面中，序列页面支持拖拽重新排序。拖放任务卡片到不同序列位置时，系统会自动更新相关的依赖关系。
在 CLI 指令中查看序列速查
backlog instructions overview 的 Quick Reference 中包含了序列命令速查：
backlog sequence list --plain
该命令输出纯文本序列分层。序列由任务依赖关系派生而来，同一序列内的任务可以并行推进，不同序列之间存在先后依赖。更多序列操作参见本章「查看序列」与「TUI 序列视图操作」两节。
序列对项目规划的意义
| 应用场景 | 操作 |
|---|---|
| 规划 Sprint | 根据序列分层将任务分配到不同迭代周期 |
| 识别风险 | 关键路径上的任务延期将直接影响整体进度 |
| 资源分配 | 将同一序列中的任务分配给不同开发者并行推进 |
| 依赖审查 | 定期运行 backlog sequence list 检查是否存在不合理的强依赖 |