Přeskočit na obsah

Tato stránka byla automaticky přeložena z angličtiny, jediného jazyka, ve kterém se tento web píše. Číst originál.

objects.search

Hledání podřetězce bez ohledu na velikost písmen v identitách, titulcích, popisech a obsahu.

Hledání podřetězce bez ohledu na velikost písmen v identitách, titulcích, popisech a obsahu.

Zpřístupnění

Kde je tato jedna definice dosažitelná. Absence je explicitní: povrch, který není uveden, ji nenese.

povrchjako
MCPnástroj majordomus_search
HTTPGET /api/v1/search operationId objects.search
příkazová řádka—

Schémata

Kanonický vstup a výstup z typů Rustu; schéma nástroje MCP a parametry a odpovědi OpenAPI se odvozují z nich.

input · SearchInput

Vstup objects.search: co hledat, kde a kolik.
vlastnosttyppovinnépopis
druh string | null ne Pouze objekty tohoto druhu; druh, který repozitář nemá, je neplatný vstup. výchozí null
limit integer | null ne Nejvýše tolik zásahů (výchozí 20, nejvýše 200). výchozí null
query string ano Podřetězec bez rozlišení velikosti písmen, porovnávaný s identitou, názvem, popisem a obsahem.
JSON Schema 
{
  "additionalProperties": false,
  "description": "The input of `objects.search`: what to look for, where, how much.",
  "properties": {
    "kind": {
      "default": null,
      "description": "Only objects of this kind; a kind the repository does not have is an invalid input.",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "default": null,
      "description": "At most this many hits (default 20, at most 200).",
      "format": "uint64",
      "maximum": 200,
      "minimum": 1,
      "type": [
        "integer",
        "null"
      ]
    },
    "query": {
      "description": "Case-insensitive substring, matched against identity, title, description and content.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "title": "SearchInput",
  "type": "object"
}

výstup · SearchResult

Odpověď objects.search.
vlastnosttyppovinnépopis
počet integer ano Kolik zásahů bylo vráceno.
nálezy array ano Nálezy v pořadí URI, nejvýše limit z nich.
limit integer ano Limit, který platil.
query string ano Dotaz tak, jak byl zadán.
JSON Schema 
{
  "$defs": {
    "SearchHit": {
      "description": "One search hit: the object, summarised, and the first matching line of its content.",
      "properties": {
        "description": {
          "description": "The one-line description, when the kind holds one.",
          "type": [
            "string",
            "null"
          ]
        },
        "id": {
          "description": "The capability id, `<kind>.<identity>`.",
          "type": "string"
        },
        "identity": {
          "description": "The identity within the kind.",
          "type": "string"
        },
        "kind": {
          "description": "The kind the object was read as.",
          "type": "string"
        },
        "path": {
          "description": "Repository-relative source path.",
          "type": "string"
        },
        "snippet": {
          "description": "The first line of content that matched, when one did.",
          "type": [
            "string",
            "null"
          ]
        },
        "title": {
          "description": "The title, when the kind's title rule found one.",
          "type": [
            "string",
            "null"
          ]
        },
        "uri": {
          "description": "`majordomus://<kind>/<identity>`.",
          "type": "string"
        }
      },
      "required": [
        "uri",
        "id",
        "kind",
        "identity",
        "path"
      ],
      "type": "object"
    }
  },
  "description": "The answer of `objects.search`.",
  "properties": {
    "count": {
      "description": "How many hits were returned.",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "hits": {
      "description": "The hits, in URI order, at most `limit` of them.",
      "items": {
        "$ref": "#/$defs/SearchHit"
      },
      "type": "array"
    },
    "limit": {
      "description": "The limit that applied.",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    },
    "query": {
      "description": "The query as given.",
      "type": "string"
    }
  },
  "required": [
    "query",
    "count",
    "limit",
    "hits"
  ],
  "title": "SearchResult",
  "type": "object"
}

Politiky

benchmark
povinné — cíl na každém transportu, který expozice deklaruje; případy jsou ty ze vstupního typu
cache
process: až 64 záznamů v procesu, vymezených otiskem registru

Cíle benchmarku

Odvozeno z registru pro tento repozitář: jeden požadavek na transport a případy, které poskytuje typ vstupu. Celá matice je na stránce měření výkonu.

transportstatepřípadytargets
directpokryto2common-word studený+teplý
no-hit studený+teplý
mcppokryto2common-word studený+teplý
no-hit studený+teplý
httppokryto2common-word studený+teplý
no-hit studený+teplý

Tvrzení implementovaná vedle ní

Připojeno souborem, který každé tvrzení implementuje; každé odkazuje na svou stránku s implementací a testem, který je dokazuje.

Okamžiky, na které to odpovídá

Prohledává názvy a popisy všech stránek, které tento web publikuje.