Gumloop 功能规格 - Cmd+K 全局命令面板

初始上下文

1. 概览

背景 — 从 GUI 层级到文本意图

Gumloop v9.9.0 发布 Cmd+K。Changelog 描述为："A command menu for searching and jumping to agents, chats, and actions, including searching the text inside past conversations."

在此之前，用户导航完全依赖侧栏层级结构：Agents 文件夹 → 点开 → 找到 Agent；Chats 列表 → 滚动 → 找到对话。随着 Agent 和对话数量的增长，这种模式的摩擦指数级增加。

为什么是「操作系统层」

Cmd+K 不是又一个搜索框。在操作系统的设计哲学中，Command Palette 是从「GUI 为主」到「键盘优先混合模式」的关键桥梁——允许熟练用户绕过 GUI 层级，直接通过文本意图到达目标。

Cmd+K 将这三者合为一体，成为 Gumloop 平台的统一意图入口。

目标

1. 消除层级导航摩擦：用户不需要知道目标 Agent 在哪个文件夹，只需输入名称关键词

1. 对话内容可检索：将历史对话从"一次性消费品"转变为"可查询的知识库"

1. 键盘优先体验：所有搜索、选择、跳转操作通过键盘完成

1. 降低功能发现门槛：新用户通过搜索发现 Agent 和功能，而非逐级探索

1. 建立平台级肌肉记忆：Cmd+K 成为用户在任何页面都能依赖的"万能入口"

2. 核心机制 [⚠️ 推断]

2.1 系统架构

┌──────────────────────────────────────────────────────────────────────┐
│                    Cmd+K 命令面板系统架构                              │
│                                                                      │
│  用户交互层                                                          │
│  ┌────────────┐    ┌───────────────┐    ┌───────────────────┐       │
│  │ 快捷键拦截  │───▶│ 搜索框 UI     │───▶│ 搜索结果渲染       │       │
│  │ (Cmd+K)    │    │ (实时输入)     │    │ (分组列表+高亮)    │       │
│  └────────────┘    └───────────────┘    └───────────────────┘       │
│                              │                                       │
│  搜索层                                                              │
│  ┌───────────────────────────▼───────────────────────────────┐     │
│  │                    搜索路由器                                │     │
│  │  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐  │     │
│  │  │ Agent    │  │ Chat     │  │ Action   │  │ File     │  │     │
│  │  │ Index    │  │ Index    │  │ Index    │  │ Index    │  │     │
│  │  │ (名称+   │  │ (标题+   │  │ (命令名+ │  │ (文件名+ │  │     │
│  │  │  描述)   │  │  内容)   │  │  描述)   │  │  内容)   │  │     │
│  │  └──────────┘  └──────────┘  └──────────┘  └──────────┘  │     │
│  └───────────────────────────────────────────────────────────┘     │
│                              │                                       │
│  数据层                                                              │
│  ┌───────────────────────────▼───────────────────────────────┐     │
│  │  后端搜索 API（/api/search?q=xxx&types=agent,chat,action） │     │
│  │  - 模糊匹配 + 全文搜索                                      │     │
│  │  - 权限过滤（仅返回用户有权访问的实体）                      │     │
│  │  - 相关性排序（最近使用/频率/匹配度加权）                    │     │
│  └───────────────────────────────────────────────────────────┘     │
└──────────────────────────────────────────────────────────────────────┘

2.2 搜索作用域

对话内容搜索是 Cmd+K 最独特的能力——用户通过回忆对话中的具体内容（如"上次讨论的数据库迁移方案"）定位历史对话，而非仅通过对话标题。

2.3 搜索结果排序

排序算法基于三个维度的加权：

• 最近使用加权（Recency）：最近交互过的实体排名靠前

• 频率加权（Frequency）：高频使用的 Agent/Chat 排名靠前

• 匹配度加权（Relevance）：精准匹配 > 前缀匹配 > 模糊匹配 > 内容匹配

• 分组展示：按实体类型分组（Agents / Chats / Actions / Files），每组内按上述算法排序

2.4 快捷键机制

3. 功能需求

3.1 搜索输入

3.2 结果展示

3.3 导航与跳转

3.4 非功能需求

4. 用户场景与故事

5. 竞品分析

关键洞察

1. 「Agent 平台的操作系统层」是差异化定位：没有竞品在 AI Agent 管理场景中提供 Command Palette。Gumloop 在定义一个全新的交互范式

1. 对话内容搜索是独特的数据优势：Spotlight 可以搜索文件名，但无法搜索"上周三我和同事聊的那个想法"。对话内容是 Gumloop 独有的数据维度

1. Linear 的"即时创建"是下一步方向：Cmd+K 不仅能搜索已有资源，还能快速创建——从"导航工具"升级为"全局操作入口"

1. AI IDE 的融合趋势：Cursor/Windsurf 将 AI 融入命令面板。Gumloop 如果加入自然语言操作能力，将定义 Agent 平台的终极交互形态

6. 架构对比

┌─────────────────────────────────────────────────────────────────┐
│              传统 Command Palette（VS Code 模式）                 │
│                                                                 │
│  搜索维度：命令 + 文件 + 符号（代码结构）                        │
│  数据模型：静态索引（文件名、函数名、命令注册表）                 │
│  搜索算法：模糊匹配（fzy/subsequence scoring）                   │
│  结果呈现：平铺列表，按匹配分排序                                 │
│  交互范式：搜索→选择→执行                                        │
└─────────────────────────────────────────────────────────────────┘

                              VS

┌─────────────────────────────────────────────────────────────────┐
│              Gumloop Cmd+K（Agent 平台模式）                      │
│                                                                 │
│  搜索维度：Agent + Chat + Action + File + 对话全文               │
│  数据模型：动态索引（实体元数据 + 对话内容 + 文件内容）           │
│  搜索算法：模糊匹配 + 全文搜索 + 语义匹配（未来）                 │
│  结果呈现：分组列表 + 内容片段 + 元信息 + 高亮                    │
│  交互范式：搜索→预览→跳转（未来：搜索→执行→确认）                │
│                                                                 │
│  新增维度：                                                      │
│  ├── 对话内容搜索（文本回忆 → 定位对话）                          │
│  ├── 跨实体类型（同一搜索词匹配多种资源）                         │
│  ├── 权限感知（只显示用户有权访问的实体）                         │
│  └── 上下文感知（根据当前页面调整排序权重）                       │
└─────────────────────────────────────────────────────────────────┘

7. 遥测

8. 路线图与未来演进方向

演进路线图

v9.9.0          v9.10.0         v10.x              v11.x             未来
  │                │               │                  │                 │
  ▼                ▼               ▼                  ▼                 ▼
┌────────┐    ┌────────┐    ┌────────────┐    ┌────────────┐    ┌──────────┐
│基础搜索 │───▶│文件扩展 │───▶│智能排序    │───▶│NL→操作     │───▶│语音+     │
│Agent   │    │+Files  │    │+快速创建   │    │+AI 原生UX  │    │开放扩展   │
│Chat    │    │        │    │+个性化     │    │+意图识别   │    │+第三方   │
│Action  │    │        │    │            │    │            │    │          │
└────────┘    └────────┘    └────────────┘    └────────────┘    └──────────┘

关键演进判断

1. 搜索质量是留存的基础：如果用户频繁遇到零结果或不相关结果，Cmd+K 将很快被抛弃。零结果率必须控制在 5% 以下

1. 对话内容搜索的索引质量：对话文本质量参差不齐（口语化、代码、表格、JSON 等），索引需要处理多语言混合、特殊字符和噪音文本

1. 从导航到操作的跃迁：Cmd+K 的战略意义在于——如果它只是"搜索+跳转"，是 UX 改进；如果它成为"自然语言→Agent 操作"的入口，它定义了 AI 原生的交互范式

1. 权限感知搜索的复杂度：当 Cmd+K 覆盖团队共享和组织级资源时，搜索结果的权限过滤至关重要——不能泄露用户无权访问的实体

由 Claude spec-generate 系统生成 · 来源：Gumloop v9.9.0 "Killarney" Changelog + v9.10.0 "Atlin" Changelog + 竞品推断

⚠️ docs.gumloop.com 中无 Cmd+K 相关帮助页面。本规格基于 Changelog 描述和竞品对比推断。