ZAgents Docs

搜索语法

面向文件和事项的 GitHub 风格限定符搜索 —— type:、mime:、ext:、category:、status:、assignee: 等,支持自动补全。

Multica 的搜索框支持将 GitHub 风格限定符 与普通文本组合使用。普通词进行全文搜索; 限定符用于缩小结果。前缀 - 表示排除,多词值请加双引号。

自动补全

文件搜索框会在输入时建议限定符键,以及光标所在键的取值(文档类型、分类、 is:/has: 选项等)。↑/↓ 移动,Enter 或 Tab 接受,Esc 关闭。点击搜索框旁的 ? 查看应用内参考。

文件

按元数据搜索文件(标题、描述、文件名 —— 不含文件内容):

type:prd is:root            # 所有无父级的 PRD
ext:pdf category:Docs       # “Docs” 分类下的 PDF
type:rfc -has:children      # 无子文件的 RFC
限定符含义
type:<slug>语义文档类型(plan、ard、test、rfc、prd、brd、fsd、user-story 或工作区自定义类型)
mime:<class|mime>格式 / MIME(mime:image、mime:pdf)
ext:<ext>文件扩展名(ext:pdf、ext:md)
category:<name|uuid>工作区分类
issue: project: agent: squad: checker:附加到该所有者的文件
is: has: parent: in: creator:层级 / 关系 / 字段 / 创建者

type: 的含义已变更

type: 现在选择文档类型,而非文件格式。请用 mime: 或 ext: 按格式筛选。

在 设置 → 文件 中管理文档类型与分类。系统类型为内置只读。CLI:

zagents files types list --output json
zagents files list --type prd
zagents files search "type:prd category:Docs"

事项

status:in_progress assignee:@me
priority:high is:open payment
project:Backend status:todo
限定符含义
status:事项状态(backlog/todo/in_progress/in_review/done/blocked/cancelled)
priority:优先级(urgent/high/medium/low/none)
assignee:@me / assignee:<uuid>负责人
project:<name|uuid>项目
is:open / is:closed开放 / 关闭

CLI:zagents issue search "status:todo assignee:@me migration"。 未知限定符或无效枚举值会回退为普通全文搜索 —— 拼写错误不会报错。

本页目录