opencode
6c92b6358d
Full documentation hub replacing the release-notes-only view: - Handbook pages (docs/handbook) for all features and admin/betrieb - API reference generated from lib/api-spec/openapi.yaml via scripts/src/generate-docs.mjs (replaces sync-release-docs.mjs): endpoints, schemas/fields, search index, per-release snapshots - mkdocs layout: sidebar nav, right TOC with scrollspy, search overlay, version dropdown, repo link - FieldHelp (?) buttons in forms linking to reference field docs - v0.7.0 release notes backfilled, v0.8.0 release notes added
50 lines
2.0 KiB
Markdown
50 lines
2.0 KiB
Markdown
---
|
|
title: Tool anlegen & bearbeiten
|
|
order: 3
|
|
---
|
|
|
|
# Tool anlegen & bearbeiten
|
|
|
|
## Neues Tool anlegen
|
|
|
|
Unter **Tool hinzufügen** legst du ein neues Tool an. Die Felder entsprechen
|
|
dem Eingabeschema [`ToolInput`](/docs/reference/schemas/toolinput):
|
|
|
|
| Feld | Pflicht | Bedeutung |
|
|
| --- | --- | --- |
|
|
| **Name** | ja | Anzeigename des Tools (min. 2 Zeichen). |
|
|
| **Beschreibung** | ja | Was tut das Tool, warum nutzen es Leute? (min. 10 Zeichen) |
|
|
| **Kategorie** | ja | Zugeordnete Kategorie (aus bestehenden Kategorien wählbar). |
|
|
| **Website-URL** | nein | Offizielle Website (`https://…`). |
|
|
| **Icon-/Logo-URL** | nein | Direktlink zu einem Logo-Bild. |
|
|
| **Features** | nein | Schlüsselfähigkeiten, z. B. „Echtzeit-Kollaboration“. Bereits bekannte Features sind auswählbar. |
|
|
| **Tags** | nein | Schlagwörter zum Auffinden. Bereits bekannte Tags sind auswählbar. |
|
|
|
|
> Hinter jedem Label findest du ein **Hilfe-Icon (?)** — es verlinkt direkt
|
|
> zur Feldbeschreibung in dieser Doku.
|
|
|
|
### Hinweise
|
|
|
|
- **Features & Tags** sind Listen. Über **+ Feature / + Tag** fügst du weitere
|
|
Einträge hinzu; über das ✕-Symbol entfernst du sie.
|
|
- URLs müssen absolut und gültig sein.
|
|
- Leere Einträge in Feature-/Tag-Listen werden beim Speichern verworfen.
|
|
|
|
## Tool bearbeiten
|
|
|
|
Auf der Detailseite eines Tools öffnet **Bearbeiten** das Formular mit den
|
|
aktuellen Werten. Du kannst Name, Beschreibung, Kategorie, URLs, Features und
|
|
Tags ändern. Nur angemeldete Nutzer:innen können Tools bearbeiten.
|
|
|
|
## Tool löschen
|
|
|
|
Über die Detailseite kannst du ein Tool **in den Papierkorb verschieben**
|
|
(Soft-Delete). Es verschwindet aus dem Katalog, bleibt aber im Papierkorb
|
|
erhalten. Siehe [Administration & Papierkorb](/docs/handbook/administration).
|
|
|
|
## Zugehörige Endpunkte
|
|
|
|
- [`POST /tools`](/docs/reference/endpoints/tools#createtool) — Tool anlegen
|
|
- [`PATCH /tools/{id}`](/docs/reference/endpoints/tools#updatetool) — Tool bearbeiten
|
|
- [`DELETE /tools/{id}`](/docs/reference/endpoints/tools#deletetool) — Tool löschen
|