全局搜索
Web 界面提供 macOS Spotlight 风格的居中搜索对话框,一次检索任务、草稿、文档、决策、Wiki 页面与快速笔记。它取代了早期只能显示 5 条结果的侧边栏内联搜索。
打开与关闭
| 操作 | 方式 |
|---|---|
| 打开 | 按 Ctrl+K(Windows/Linux)或 Cmd+K(macOS);或点击侧边栏顶部的搜索触发按钮 |
| 关闭 | 按 Esc、点击对话框右上角 ×、点击对话框外的遮罩区域,或按浏览器后退 |
对话框弹出时,背后的页面保持原样并锁定滚动,关闭后回到原页面(筛选、排序等状态不丢失)。
侧边栏中的搜索框现在是一个只读的触发按钮,显示「搜索 (⌘K)…」,点击即打开对话框;输入与结果都迁移到了对话框中。
对话框布局
- 桌面端:水平居中、距顶部约 12vh、固定 800px 宽、最大高度 75vh,深色半透明遮罩
- 窄屏(宽度小于 640px):自动铺满全屏,结果行改为固定两行(第一行标题,第二行 ID 与标签)
搜索类型
对话框顶部有一排类型标签,选择后立即按新范围重新搜索:
| 标签 | 范围 |
|---|---|
| 全部 | 任务、文档、决策、Wiki、备忘 |
| 任务 | 仅任务(含草稿) |
| 文档 | 仅文档 |
| Wiki | 仅 Wiki 页面 |
| 决策 | 仅决策记录 |
| 备忘 | 仅快速笔记 |
输入框为空时不展示结果;输入后约 300 毫秒自动执行搜索。
包含已完成任务
对话框提供「已完成语料」开关:开启后搜索范围扩大到 backlog/completed/ 目录中的历史任务,命中的已完成记录带 Completed 徽章,点击后以只读弹窗打开(不提供编辑操作)。默认关闭,默认结果与之前完全一致。
结果列表
结果按类型分组(任务 → 文档 → Wiki → 决策 → 备忘),每组有一个带数量与折叠箭头的表头:
- 点击表头(或聚焦后按 Enter / 空格)折叠或展开该组;折叠后该组不参与滚动定位
- 每一行显示:类型图标、资源 ID、标题、状态与优先级标签
- 输入的关键词在标题与资源 ID中均会高亮
- 结果数量不设上限;列表使用虚拟滚动,数千条结果也保持流畅
键盘操作
| 按键 | 行为 |
|---|---|
| ↑ / ↓ | 上下移动选中项 |
| Enter | 打开选中项 |
| Esc | 关闭对话框 |
| Ctrl+K / Cmd+K | 打开(已在对话框中时保持聚焦) |
打开结果的导航行为
- 任务:以模态框形式覆盖在当前页面上方,关闭后回到搜索对话框,查询词、类型过滤与滚动位置均保留
- 文档 / 决策 / Wiki:跳转到对应的整页视图,按浏览器后退即可回到搜索对话框
- 备忘:跳转到
/memos?date=<day>——memo 没有独立详情路由,直接在备忘页面的当日视图中打开
位置记忆
在结果列表中滚动后按 Enter 打开条目,再点击返回/后退回到对话框时,列表会恢复到原来的位置(内部记录的是「首个可见行」而非像素偏移,结果集变化时仍能稳定还原)。若位置已失效(例如结果变少),则回到列表顶部。
用 Esc、点击遮罩或 × 关闭对话框时不会记录位置——主动放弃搜索时不需要记住滚动。
分享与刷新
对话框的状态保存在地址栏中:
http://localhost:6420/search?q=timezone&type=task
q为关键词,省略表示未输入type为类型过滤(doc是document的简写),省略表示「全部」- 刷新页面或把链接发给同事,都会以相同的查询、过滤与结果重新打开对话框
相关章节
- 任务列表 — 列表页筛选与任务详情模态框
- Wiki 浏览与编辑 — Wiki 页面阅读与编辑