Pluginutveckling och implementering

Kontrolltillägg

Kontrolltillägg lägger till anpassade åtgärdsknappar på vänstra sidan av det nedre kontrollfältet i förhandsgranskningsfönstret, vilket möjliggör snabbåtgärder och integrering med externa verktyg för den aktiva filen eller mappen.

Bygg ett kontrolltillägg med en AI-agent

Ersätt platshållaren nedan och ge sedan den fullständiga instruktionen till din kodningsagent:

Läs och följ utvecklingsguiden för Seer-kontrolltillägg på https://raw.githubusercontent.com/ccseer/Seer-Controls/refs/heads/main/plugin_development_guide.md. Behandla den som den enda sanningskällan för arkitektur, plugin.json, implementering, validering och paketering. Om guiden inte är tillgänglig, stoppa och rapportera det innan du fortsätter.

Innan du utför något arbete, inspektera Requirement (Krav) nedan. Om det saknas, är oförändrad platshållartext eller är för tvetydigt för att implementeras, ställ en klargörande fråga och vänta. Gissa inte det saknade kravet.

När det är klarlagt, implementera ett fullständigt, installerbart kontrolltillägg som följer Canonical v1-processkontraktet i den aktuella arbetsytan. Ändra inte Seer i sig och stanna inte vid en plan eller kodutdrag.

Följ varje tillämpligt valideringssteg i guiden och rapportera de faktiska resultaten.

Requirement: [ERSÄTT DENNA PLATSHÅLLARE med ditt krav på kontrolltillägg, t.ex. öppna VS Code i den aktuella mappen eller kopiera absolut sökväg till urklipp]

Arkitektur & kontrakt

• Processmodell: Implementerar Canonical v1-processkontraktet (backend: "process", capabilities: ["control"]). Seer kör hjälpprogrammet via CLI.
• Returstatus och felrapportering:
  • Framgång: Processen avslutas med kod 0 (eller matchar success_exit_codes). Om "close_after_success": true är konfigurerat stänger Seer automatiskt förhandsgranskningsfönstret efter att körningen har lyckats.
  • Fel: Processen avslutas med en icke-nollkod. Allt som skrivs till standardfel (stderr) fångas upp av Seer och visas som ett Toast-felmeddelande i appen.
• Användargränssnitt & interaktion: Kontrolltillägg ritar inga egna permanenta huvudfönster. Typiska hjälpprogram kör bakgrundsuppgifter, kopierar text till urklipp eller anropar inbyggda systemdialoger i Windows (t.ex. Öppna med, Egenskaper, Dela).

Platshållare för kommandorad

Ett kontrolltillägg tar endast emot målsökvägen — ${input_file} plus de universella platshållarna (${use_backslash}, ${seer_dir}, ${seer_exe}, ${seerviewer_exe}, ${7z}) som listas i det gemensamma avsnittet Platshållare och matchningskoder nedan.

plugin.json-exempel (Control)

Exempel 1: Mappåtgärd (Terminal Here)

Konfigurationen för det officiella tillägget Terminal Here:

{
  "schema_version": 1,
  "id": "io.1218.seer.terminal-here",
  "name": "Terminal Here",
  "description": "Opens a terminal window in the current folder.",
  "version": "1.0.0",
  "appMinVersion": "4.5.10",
  "backend": "process",
  "capabilities": [
    "control"
  ],
  "extensions": [
    "${type_folder}"
  ],
  "command": "terminal_here.exe",
  "arguments": [
    "--input",
    "${input_file}"
  ],
  "close_after_success": false,
  "timeout_ms": 150000,
  "success_exit_codes": [
    0
  ]
}

Exempel 2: Filåtgärd (Explorer Open With)

Konfigurationen för det officiella tillägget Explorer Open With:

{
  "schema_version": 1,
  "id": "io.1218.seer.explorer-open-with",
  "name": "Open With",
  "description": "Opens the Windows Open With dialog for the current file.",
  "version": "1.1.0",
  "appMinVersion": "4.5.10",
  "backend": "process",
  "capabilities": [
    "control"
  ],
  "extensions": [
    "${type_file}"
  ],
  "command": "shellopenwith.exe",
  "arguments": [
    "--input",
    "${input_file}",
    "${use_backslash}"
  ],
  "timeout_ms": 30000,
  "success_exit_codes": [
    0
  ]
}

Källkoden för officiella kontrolltillägg finns på: ccseer/Seer-Controls.

Egenskapstillägg

Egenskapstillägg utökar Seers motor för granskning av metadata. När en användare trycker Ctrl + I på en förhandsgranskad fil eller mapp (eller öppnar egenskapsfönstret), extraherar och visar matchande egenskapstillägg strukturerade metadata och grafiska oscilloskop/diagram.

Bygg ett egenskapstillägg med en AI-agent

Ersätt platshållaren nedan och ge sedan den fullständiga instruktionen till din kodningsagent:

Läs och följ utvecklingsguiden för Seer-egenskapstillägg på https://raw.githubusercontent.com/ccseer/Seer-Properties/refs/heads/main/plugin_development_guide.md. Behandla den som den enda sanningskällan för arkitektur, plugin.json, implementering, validering och paketering. Om guiden inte är tillgänglig, stoppa och rapportera det innan du fortsätter.

Innan du utför något arbete, inspektera Requirement (Krav) nedan. Om det saknas, är oförändrad platshållartext eller är för tvetydigt för att implementeras, ställ en klargörande fråga och vänta. Gissa inte det saknade kravet.

När det är klarlagt, implementera ett fullständigt, installerbart egenskapstillägg som följer Canonical v1-processkontraktet och specifikationen Schema 1 JSON i den aktuella arbetsytan. Ändra inte Seer i sig och stanna inte vid en plan eller kodutdrag.

Följ varje tillämpligt valideringssteg i guiden och rapportera de faktiska resultaten.

Requirement: [ERSÄTT DENNA PLATSHÅLLARE med ditt krav på egenskapstillägg, t.ex. extrahera och visa detaljerade parametrar för ljud-/videocodec och bithastighet för MP4-filer]

Arkitektur & kontrakt

• Processmodell: Implementerar Canonical v1-processkontraktet (backend: "process", capabilities: ["property"], result_schema: 1).
• CLI-anrop: Värden skickar: --input "${input_file}" --output "${output_file}" --output-dir "${output_dir}"
• Publicering av utdata:
  • Värden expanderar ${output_file} till en bassökväg utan filändelse (t.ex. <requestDir>/<md5>).
  • Tillägget måste skriva sitt JSON-resultat till <output-base>.json (dvs. ${output_file}.json).
  • Visuella bilagor (diagram, histogram, vektorskop) måste sparas i ${output_dir}.
  • Begränsning: ${no_cache} är förbjudet för egenskapstillägg.
• Policy för avslutningskoder:
  • Förväntade domänresultat (t.ex. osignerad fil, inte ett git-arkiv, tomma metadata) måste avslutas med kod 0 och beskriva statusen i JSON.
  • Avsluta med icke-nollkod endast vid allvarliga fel eller ogiltiga anrop (icke-noll-avslutningar gör att värden rensar förfrågningskatalogen).

Platshållare för kommandorad

Samt de universella platshållarna som listas i det gemensamma avsnittet Platshållare och matchningskoder nedan, som även täcker ${type_*}-matchningskoderna. ${no_cache} avvisas för egenskapstillägg.

Specifikation för resultat-JSON (Schema 1)

Resultatfilen ${output_file}.json måste vara giltig UTF-8-JSON innehållande result_schema: 1 och ett data-objekt:

1. Platta rader (Flat Rows)

Endast när hela resultatet är en enda rad (t.ex. SHA-256):

{
  "result_schema": 1,
  "data": {
    "SHA-256": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824"
  }
}

2. Undergrupp med en sorterad array av objekter med en nyckel (Standard)

Allt som ger mer än en rad måste publiceras som exakt en undergrupp uppkallad efter plugin-programmet – lösa rader på toppnivå kolliderar med raderna från alla andra plugin-program, som inspektören visar i en enda lista. Arrayens ordning är visningsordningen, så detta är den enda form där plugin-programmet kan bestämma i vilken ordning raderna visas:

{
  "result_schema": 1,
  "data": {
    "Git": {
      "value": [
        { "Repository": "ccseer/Seer-Properties" },
        { "Branch": "main" },
        { "Status": "Clean" }
      ]
    }
  }
}

3. Undergrupp med ett värdeobjekt

value kan också vara ett vanligt objekt, men dess rader återges i den tolkade objektets nyckelordning, vilket plugin-programmet inte kan styra. Använd det bara när radordningen inte spelar någon roll:

{
  "result_schema": 1,
  "data": {
    "Git": {
      "value": {
        "Branch": "main",
        "Status": "Working tree clean"
      }
    }
  }
}

4. Grafiska diagram & oscilloskop (Bildbilagor)

Spara genererade PNG-diagram i ${output_dir} och deklarera dem med {"type": "image", "value": "relative_filename.png"}:

{
  "result_schema": 1,
  "data": {
    "Image Scopes": {
      "value": [
        { "RGB Histogram": { "type": "image", "value": "histogram.png" } },
        { "Luma Waveform": { "type": "image", "value": "waveform.png" } }
      ]
    }
  }
}

plugin.json-exempel (Property)

{
  "schema_version": 1,
  "id": "io.1218.seer.git-info",
  "name": "Git Info",
  "description": "Reports repository information for the current folder using Git.",
  "version": "1.0.0",
  "appMinVersion": "4.5.10",
  "backend": "process",
  "capabilities": [
    "property"
  ],
  "extensions": [
    "${type_folder}"
  ],
  "invocations": {
    "property": {
      "command": "git_info.exe",
      "arguments": [
        "--input",
        "${input_file}",
        "--output",
        "${output_file}",
        "--output-dir",
        "${output_dir}"
      ],
      "result_schema": 1,
      "timeout_ms": 30000,
      "success_exit_codes": [
        0
      ]
    }
  }
}

Källkoden för officiella egenskapstillägg finns på: ccseer/Seer-Properties.