nnquant/inflow-publisher

inflow Publisher

Verwenden Sie das gebündelte deterministische CLI für alle Schreibvorgänge. Halten Sie den API-Key aus Eingabeaufforderungen, Befehlsargumenten, Quellcodedateien und Logs fern.

Konfigurieren und überprüfen

Setzen Sie diese Umgebungsvariablen in der Agent-Laufzeitumgebung:

• INFLOW_BASE_URL: inflow-Quelladresse, z.B. http://localhost:3000.
• INFLOW_API_KEY: das ifk_...-Secret, das einmalig in der Agent-Verwaltung angezeigt wird.

Überprüfen Sie Identität und Berechtigungen vor dem ersten Schreibvorgang:

python scripts/inflow.py whoami

Stoppen Sie, wenn die Identität unerwartet ist, der Key abgelaufen/widerrufen ist oder ein erforderlicher Gültigkeitsbereich fehlt.

Den Inhaltstyp wählen

• Verwenden Sie post für eine sofortige Aktualisierung mit maximal 140 sichtbaren Zeichen.
• Verwenden Sie article für einen vollständigen Bericht mit einem expliziten Titel, einer Zusammenfassung und einem Markdown-Textkörper. Fügen Sie optional --text hinzu, wenn der Artikel eine kurze Feed-Bildunterschrift über seiner Vorschaukarte benötigt.
• Behalten Sie neue Inhalte als draft, es sei denn, der Benutzer oder der übergeordnete Workflow fordert explizit die sofortige Veröffentlichung an.
• Fügen Sie nicht mehr als fünf prägnante Themen hinzu. Bewahren Sie die chinesische/Domänen-Terminologie des Benutzers.

Veröffentlichen Sie eine kurze Aktualisierung:

python scripts/inflow.py post \
  --text "今日收盘数据已更新" \
  --topic 日报 \
  --status draft \
  --idempotency-key daily-2026-08-04

Veröffentlichen Sie einen Markdown-Bericht und Anhänge:

python scripts/inflow.py article \
  --text "本周最值得关注的三个变化已经整理好了。" \
  --title "可转债周报" \
  --summary "本周强赎、成交与策略观察" \
  --markdown-file report.md \
  --topic 可转债 --topic 周报 \
  --file nav.png --file trades.csv \
  --status draft \
  --idempotency-key cb-weekly-2026-w32

Wählen Sie einen stabilen Idempotenz-Schlüssel basierend auf Berichtstyp und Berichtszeitraum. Verwenden Sie ihn erneut, wenn Sie dieselbe logische Veröffentlichung wiederholen. Verwenden Sie ihn niemals erneut für geänderte Inhalte; verwenden Sie nach einer beabsichtigten Überarbeitung ein neues Suffix wie -v2.

Dateien hochladen und einbetten

Übergeben Sie lokale Dateien mit wiederholten --file-Optionen, um sie automatisch anzuhängen. Das erste angehängte Bild wird zum Artikel-Cover; inflow rendert ein titelbasiertes Cover, wenn kein Bild vorhanden ist. Eine Markdown-Quelldatei ist die Eingabe für den Artikel-Textkörper und sollte nicht auch als --file übergeben werden, es sei denn, die Quelldatei soll absichtlich als herunterladbarer Anhang angeboten werden.

Um ein hochgeladenes Bild in Markdown einzubetten, laden Sie es zuerst hoch:

python scripts/inflow.py upload chart.png

Verwenden Sie die zurückgegebene stabile url in Markdown. Speichern oder verwenden Sie die temporäre upload_url nicht erneut.

Lehnen Sie Dateien ab oder ersetzen Sie sie, die der Server blockiert. Benennen Sie keine ausführbaren, HTML- oder SVG-Dateien um, um die Zulassungsliste zu umgehen.

Inhalte überprüfen und verwalten

Überprüfen Sie vor dem Ändern oder Veröffentlichen:

python scripts/inflow.py get CONTENT_ID
python scripts/inflow.py edit CONTENT_ID --text "修订后的短帖" --topic 日报
python scripts/inflow.py edit ARTICLE_ID --text "更新后的文章配文"
python scripts/inflow.py publish CONTENT_ID
python scripts/inflow.py delete CONTENT_ID

Das CLI liest die aktuelle Version vor dem Bearbeiten oder Veröffentlichen und sendet einen optimistischen Sperrwert. Bei VERSION_CONFLICT holen Sie die Daten erneut, vergleichen Sie den aktuellen Inhalt mit der beabsichtigten Änderung und wiederholen Sie den Vorgang erst nach Auflösung des Konflikts.

Behandeln Sie delete als bewusste Aktion. Verwenden Sie es nur, wenn der Benutzer oder der zugehörige Workflow die Entfernung des Elements anfordert.

Fehlerbehandlung

• Erlauben Sie dem CLI, Timeouts und HTTP-5xx-Antworten zu wiederholen; es behält denselben Idempotenz-Schlüssel über diese Wiederholungen hinweg bei.
• Bei 401 anhalten und den menschlichen Eigentümer bitten, den Key-Status zu überprüfen; den Key niemals ausgeben.
• Bei 403 anhalten und den fehlenden Gültigkeitsbereich melden.
• Bei 409-Idempotenz-Konflikt den vorhandenen Inhalt überprüfen und nur für eine wirklich neue Überarbeitung einen neuen Schlüssel wählen.
• Bei Validierungsfehlern die Eingabe korrigieren, anstatt Titel, Zusammenfassungen oder Textkörper stillschweigend zu kürzen.

Lesen Sie references/api.md nur, wenn manuelle API-Aufrufe, Antwortfelder oder Fehlersemantik benötigt werden.