Schnellstart¶

Drei Befehle genügen: installieren, ins Projektverzeichnis wechseln, flower eintippen. Diese Seite stellt diese drei nach vorn und erklärt dann, was nach dem Enter auf dem Bildschirm passiert, wie du antwortest, wenn es dich etwas fragt, und was du zuerst prüfst, wenn es nicht läuft.

Installieren, ins Verzeichnis, flower tippen¶

curl -fsSL https://chenyuheee.github.io/flower/install.sh | sh
cd /path/to/your/project
flower

Das erste Skript sucht automatisch nach uv / pipx / pip und installiert damit den Befehl flower; nötig ist nur Python ≥ 3.10, kein Node und kein Claude Code CLI. Der dritte Befehl nimmt keinerlei Argumente und braucht keine Anführungszeichen in der Shell.

Wenn du anders installieren willst (pipx / pip / aus dem Quelltext) oder das Skript auf deiner Maschine nicht funktioniert, siehe Installation — du musst diese Seite aber nicht erst zu Ende lesen, bevor du hierher zurückkommst.

Nach dem Enter¶

Beim ersten Lauf auf dieser Maschine fragt es zuerst nach den Zugangsdaten: API-Key oder Gateway-Adresse. Einmal konfiguriert, landet das in ~/.config/flower/.env und gilt danach überall. Ist auf der Maschine bereits Claude Code installiert und eingerichtet, borgt es sich dessen Token und fragt gar nicht erst.

Sind die Zugangsdaten da, steht der Cursor auf >:

要做什么? 一句话就够,回车开始(Ctrl-C 退出)
> 帮我做一个 X

Diese Zeile liest von der Standardeingabe, ohne Shell-Parsing — chinesische Anführungszeichen, Leerzeichen, Ausrufezeichen kannst du direkt eintippen.

Vor dem Start gibt es eine Zeile - 验一下凭证… aus, das ist eine echte API-Sonde. Werden die Zugangsdaten abgelehnt, kommt ! 凭证被拒:… und es fragt dich sofort, ob du neu konfigurieren willst; kommt keine Verbindung zustande, kommt (探针没打通:… —— 当作网络问题,照常开跑) — es schickt dich nicht dazu, ein völlig intaktes Token neu einzurichten.

Geht die Sonde durch, fängt die Arbeit an, und zwar in drei Schritten. Jede ==-Trennlinie auf dem Bildschirm ist eine Schritt-Grenze, das 1/3 rechts ist der Fortschritt:

== 确认需求 ======================================================== 1/3

  ? X 要跑在什么环境上?
     1) 只在我这台 macOS 上
     2) Linux 服务器
     3) 两个都要
你的回答 (回车=跳过,让它自己判断) > 1
  + 只在我这台 macOS 上

  ? 「做完了」以什么为准?
你的回答 (回车=跳过,让它自己判断) > 能跑起来,并且 pytest 全绿
  + 能跑起来,并且 pytest 全绿

  + 完成 9 轮 · $0.53 · 用时 6:02

== 设定目标 ======================================================== 2/3

  ~ 把这份需求拆成能当场验证的条目
  + 完成 12 轮 · $0.41 · 用时 9:06

== 干活 ============================================================ 3/3

  ~ 先看一眼现在有什么,再决定第一刀切哪
  * Read README.md
  > 派人 coder 实现 X 的第一版,带最小测试
  先让 coder 把骨架搭起来,我再看要不要拆第二个人。
  - 上下文 36.8K · 累计 $0.94 · 12:44
  + 完成 12 轮 · $12.34 · 用时 52:53
  + 完成 37 轮 · $1.40 · 用时 58:19

总花费 $14.68 · 清单 /path/to/your/project/runs/manifest.json

Die Symbole sind durchgehend ASCII: ~ Denken, * Werkzeugaufruf, > Beauftragen, + Erfolg, x Fehlschlag, ? Frage, <- Anknüpfen an den letzten Lauf. Keine Emojis — Emojis und Rahmenzeichen lösen im Terminal Glyphen-Fallbacks aus, im Test ist das Terminal deswegen zweimal abgestürzt. Alle Terminal-Beispiele in dieser Dokumentation benutzen genau dieses ASCII-Set und sehen exakt so aus wie auf deinem Bildschirm.

Drei Stellen lohnen einen zweiten Blick:

• Die letzten beiden + 完成-Zeilen sind keine Dopplung. Die erste ist die Arbeitsrunde, die zweite die Verdikt-Runde — das Verdikt läuft in einer eigenen Session, bekommt aber keine eigene ==-Trennlinie, weil es eine Runde innerhalb des Schritts 干活 ist. Im Lauf-Manifest heißt sie 干活·判定#1.
• Das $ in der + 完成-Zeile ist das Geld dieser einen Runde, 用时 ist die Gesamtdauer vom Start bis jetzt — zwei verschiedene Maßstäbe.
• Statuszeilen der Form - 上下文 … · 累计 … · … folgen nur dem Haupt-Thread, der Kontext der Subagents steckt nicht darin. Werkzeugaufrufe der Subagents werden standardmäßig angezeigt, eingerückt hinter einem senkrechten Strich |; was sie sagen, siehst du erst mit -v — das ist das Geschehen vor Ort, nicht die Entscheidung.

Wer diese drei Schritte jeweils ausführt¶

Die ersten beiden Schritte sind die Umsetzung der beiden Mechanismen Vorab-Klärung und Zielwächter; der dritte ist der Abschnitt, den beide zusammen bewachen. Standardmäßig laufen höchstens 3 Verdikt-Runden (--rounds), mit --no-goal lässt sich das komplett abschalten — danach gilt „es sagt, es ist fertig" tatsächlich als fertig.

Ein Verdikt hat nur drei mögliche Ergebnisse: erreicht, nicht erreicht, in dieser Umgebung nicht prüfbar. Die letzten beiden sind verschiedene Ergebnisse — „hier nicht prüfbar" wird niemals als bestanden gewertet, sondern hält an und fragt dich.

Ein vollständiger Lauf ist nicht billig. Gemessene Referenzwerte: HT002 hat ein bestehendes Projekt auf macOS installiert und zum Laufen gebracht — 4 Schritte, rund 1 Stunde, $38.24; HT001 hat eine Terminal-IDE von null geschrieben — 10.4 Stunden, $171.62. Wenn du erst sehen willst, was es fragt, bevor du weitermachst, nimm --clarify-only.

Wie man auf Fragen antwortet¶

Der Abschnitt, der mit ? beginnt, ist eine Frage an dich; es gibt drei Antwortarten:

• Nummer eintippen (1 / 2 / 3) — wählt diesen Punkt, der Bildschirm antwortet mit einer Zeile + <选中的那条>.
• Einfach tippen — freie Antwort, sie muss keine der Optionen sein.
• Nur Enter — überspringen, es entscheidet selbst, der Bildschirm antwortet mit . 已跳过.

Standardmäßig wartet es 1800 Sekunden auf dich (--timeout). Kommt niemand, gibt es ! 无人应答 —— 它会自己判断,把假设记进「未知与假设」 aus und läuft weiter, es hängt sich nicht auf. Die Zahl der Fragen ist standardmäßig unbegrenzt (--asks steht auf -1); eine positive Zahl ist ein hartes Kontingent, ist es aufgebraucht, kommt ! 提问额度用完.

Während es läuft, kannst du weiter reden¶

Ganz unten am Bildschirm steht immer eine Eingabezeile. Die ist kein Dekor — vor jeder Ausgabe wird sie gelöscht und danach neu gezeichnet, sie wird also nicht von den Logs nach oben weggespült. Es gibt zwei Varianten, je nachdem, ob eine Frage offen ist:

你的回答 (回车=跳过,让它自己判断) >
(直接说 = 加需求,下个检查点送达;? 开头 = 顺便问一句,不打扰它干活) >

Wenn keine Frage offen ist, kannst du zwei Dinge tun.

Einfach einen Satz tippen = Anforderung ergänzen. Es wird nicht unterbrochen und sieht das erst, wenn es das nächste Mal den Posteingang prüft. Die Bestätigung sieht so aus:

+ 收到 (它下次查收件箱时会看到;已追加进确认书)

„已追加进确认书" ist wichtig: Der Satz landet gleichzeitig in 需求.md und überlebt damit die Schrittgrenze — der nächste Schritt ist eine neue Session, die nur die eingefrorenen Dateien liest; was nicht auf die Platte kommt, ist so gut wie nie gesagt worden.

Mit ? beginnen = eine Frage nebenbei. Es startet dafür eine separate, nur lesende Session, die nur die letzten 60 Events und den Inhalt der Workbench zur Verfügung hat. Dieser Seitenkanal läuft über den Oracle, standardmäßig gedeckelt auf 12 Runden / $0.5:

? 现在到哪了
# 旁路
  在干活第二轮,coder 刚补完 parser 的测试,正在跑第三次验证。
  ($0.0123,没有打扰正在跑的运行)

Nach der Antwort wird es verworfen — dieser Frage-Antwort-Abschnitt geht nicht in den Kontext des laufenden Laufs ein, und die Kosten gehen nicht ins Haupt-Lauf-Manifest, sondern in ein eigenes unter runs/aside/. Fragen stört den Lauf also nicht, und du musst dem Geld auch nicht nachtrauern.

Nebenbei zu Ctrl+C: Ein erstes Drücken mitten im Lauf unterbricht diese Runde und lässt dich etwas sagen, es beendet nicht.

! 已打断这一轮。正在跑的 subagent 会丢掉半成品。
  要说什么?(直接回车 = 什么都不说,接着跑;再按一次 Ctrl+C = 退出)
>

Erst ein zweites Drücken beendet wirklich. (Auf dem allerersten Prompt 要做什么? beendet Ctrl-C sofort und gibt 已取消 aus.)

Ein zweiter Lauf knüpft an den letzten an¶

Tippst du im selben Verzeichnis erneut flower, ändert sich schon der erste Satz:

接着上次? 直接回车 = 接着做;也可以说点新的;/new = 重开一件事(Ctrl-C 退出)
> 顺便支持代码块高亮
<- 在 ~/proj 接上上次  需求已确认 · 目标 7 条 · 干活上下文 71.4K · 第 3 次唤醒

Die <--Zeile ist das Wake-Banner und meldet den aktuellen Zustand dieses Verzeichnisses. Es fragt die Anforderungen nicht noch einmal ab und setzt das Ziel nicht neu; das gilt auch, wenn der Prozess gekillt oder die Maschine neu gestartet wurde. Der Satz, den du jetzt sagst, wird an 需求.md angehängt und löst eine Neuableitung der Prüfliste aus — ohne Neuableitung liest der Judge weiter die alte Liste, und was du ergänzt hast, käme im Verdikt gar nicht vor. Details und Kosten (der Kontext wächst dabei stetig) siehe Kontinuität.

Willst du nicht anknüpfen, tippe /new: Anforderungen, Ziel und Lineage des vorigen Abschnitts werden nach notes/archive/<时间戳>/ verschoben (nicht gelöscht), dann geht es von vorn los.

In Skripte schreiben, unbeaufsichtigt¶

Das Anliegen kann auch direkt als Argument mitgegeben werden, die Flags dürfen davor oder dahinter stehen:

flower "帮我做一个 X"                      # Anliegen als Argument
flower --rounds 5 "帮我做一个 X"           # Flags davor
flower "帮我做一个 X" --rounds 5           # Flags dahinter, äquivalent
echo "帮我做一个 X" | flower --timeout 0   # per Pipe in die Standardeingabe, vollautomatisch

Nur Flags ohne Anliegen geht auch — flower --clarify-only fragt dich zuerst, was zu tun ist, und macht dann weiter.

Warum der Weg „nach dem Enter tippen" trotzdem bleibt. Das Anführungszeichenpaar auf der Kommandozeile ist reine Last. Selbst erlebt: Das schließende Anführungszeichen wurde als chinesisches ” getippt, zsh wartete endlos auf das echte schließende Zeichen (und fiel in den Fortsetzungsprompt dquote>), es sah aus, als hinge das Programm — dabei war es kein einziges Mal gestartet. Bei nacktem flower wird von der Standardeingabe gelesen, ohne Shell-Parsing, chinesische Anführungszeichen, Leerzeichen, Ausrufezeichen und Zeilenumbrüche kannst du alle direkt tippen. Der Pipe-Weg benutzt denselben Eingang — wenn die Standardeingabe kein Terminal ist, gibt es keinen Prompt-Kopf aus, sondern liest direkt eine Zeile.

Wenn es nicht läuft¶

Wenn flower nichts tut, ein Zugangsdaten-Fehler kommt oder die Ausgabe auf den ersten Blick falsch aussieht, prüfe Zugangsdaten und Binary zuerst mit dem billigsten möglichen Schuss separat. Ein einzelner Agent, nur lesende Werkzeuge, ein Schuss, um beide Enden zu testen:

flower -v -w /path/to/any/repo once "读一眼这个仓库,一句话说它是干什么的"

once gibt standardmäßig nur drei Werkzeuge frei — Read, Glob, Grep; es kann nichts schreiben, deshalb ist dieser Schuss sehr billig. Gemessene Referenz: Opus 5 mit 1-Millionen-Fenster über ein Drittanbieter-Gateway, Bodenpreis pro Runde $0.1741, billigere Modelle liegen darunter. Der Abschnitt „Prüfen, ob die Installation geklappt hat" auf der Seite Installation führt genau diesen Befehl aus.

Läuft es durch, sieht es so aus — Zahlen und Fließtext werden abweichen, die Symbole nicht:

ANTHROPIC_AUTH_TOKEN = sk-1***(共 19 位)
ANTHROPIC_BASE_URL = https://your-gateway.example.com
ANTHROPIC_MODEL = claude-opus-5[1m]
- 验一下凭证…
  ~ 先看目录结构,再挑一两个文件读
  * Glob **/*.py
  * Read README.md
  这是一个用 Rust 写的命令行 HTTP 压测工具。
  - 累计 $0.00 · 0:00
  + 完成 4 轮 · $0.0932 · 用时 0:00

Zwei Dinge sollte man erkennen:

• Die ersten Zeilen sind die von -v ausgegebene wirksame Konfiguration. Ein falsches Gateway sieht man sofort — das ist der Hauptgrund, warum es dieses Flag gibt.
• Das $ in der + 完成-Zeile ist echt, 累计 und 用时 sind auf dem once-Pfad konstant 0 (für jedes Event wird ein neuer Renderer erzeugt, der Zustand sammelt sich nicht an).

Läuft dieser Schuss durch, stimmen Zugangsdaten, Gateway, Modellname und mitgeliefertes Binary alle, das Problem liegt woanders. Läuft er nicht durch, gehört das zur Installation — zurück zu Installation.

Was als Nächstes¶