@abelxiaoxing/cadence 2.1.0 → 2.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.de.md +72 -76
- package/README.es.md +71 -75
- package/README.fr.md +72 -76
- package/README.ja.md +83 -101
- package/README.ko.md +81 -97
- package/README.md +71 -86
- package/README.pt-BR.md +72 -76
- package/README.ru.md +72 -77
- package/README.zh-CN.md +74 -84
- package/docs/reuse-and-distribution.md +1 -0
- package/package.json +5 -2
- package/src/native-build.ts +1 -1
- package/src/service/contracts/workbench.ts +82 -0
- package/src/service/knowledge-store.ts +496 -0
- package/src/service/project-knowledge.ts +539 -0
- package/src/service/workflow-git.ts +773 -0
- package/src/service-host.mjs +172 -83
- package/web/dist/assets/cadence.css +1 -1
- package/web/dist/assets/cadence.js +28 -28
- package/web/dist/manifest.json +7 -7
package/README.de.md
CHANGED
|
@@ -2,119 +2,115 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Deutsch](README.de.md) · [Français](README.fr.md) · [Español](README.es.md) · [Português (Brasil)](README.pt-BR.md) · [Русский](README.ru.md)
|
|
4
4
|
|
|
5
|
-
Cadence macht [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) zu einem
|
|
6
|
-
|
|
5
|
+
Cadence macht [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) zu einem gesprächsgesteuerten Engineering-Workflow: `/cadence [Ziel]` eingeben, das Ergebnis einmal abstimmen, und ein dauerhafter Owner setzt um, repariert und prüft.
|
|
6
|
+
Im Terminal oder in der optionalen WebUI.
|
|
7
|
+
|
|
8
|
+
## So funktioniert es
|
|
9
|
+
|
|
10
|
+
```mermaid
|
|
11
|
+
flowchart TD
|
|
12
|
+
A["/cadence Ziel"] --> B["Nur lesend untersuchen"]
|
|
13
|
+
B --> C["Abstimmen, einmal freigeben"]
|
|
14
|
+
C --> D["Unabhängige Aufgaben parallel in Worktrees"]
|
|
15
|
+
D --> E["Echte Prüfungen + automatisches Agent-Review"]
|
|
16
|
+
E -->|"bestanden"| F["Lokal in deinen Branch mergen"]
|
|
17
|
+
E -->|"fehlgeschlagen"| G["Selbst korrigieren"]
|
|
18
|
+
G --> D
|
|
19
|
+
F --> H["Wissen pflegen (festes Budget)"]
|
|
20
|
+
H -.-> B
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
```mermaid
|
|
24
|
+
flowchart LR
|
|
25
|
+
A["Prüfung schlägt fehl"] --> B["Reparieren"] --> C["Route neu planen"] --> D["Abweichung erfassen"] --> E["Stopp nur bei äußeren Bedingungen"]
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
```mermaid
|
|
29
|
+
flowchart LR
|
|
30
|
+
T["Pi-Terminal"] <-->|"verbinden / trennen"| O[("Dauerhafter Owner")]
|
|
31
|
+
W["WebUI<br/>Board · Branches · Eingreifen"] <-->|"verbinden / trennen"| O
|
|
32
|
+
O --> X["Worker in Worktrees"] --> Y["Dein Branch"]
|
|
33
|
+
O -.-> K[".cadence/ Wissen"]
|
|
34
|
+
```
|
|
7
35
|
|
|
8
36
|
## Warum Cadence
|
|
9
37
|
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
Cadence ist ein vertrauenswürdiger Assistent, **keine Sandbox**: Seine Agenten bearbeiten deine Arbeitskopie direkt mit Host-Tools, daher nutze es nur für Code, den du prüfen und wiederherstellen kannst.
|
|
38
|
+
| | |
|
|
39
|
+
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
|
|
40
|
+
| **Arbeit überlebt das Fenster** | Clients verbinden und trennen sich nur; der Owner läuft weiter. |
|
|
41
|
+
| **Vor der Freigabe ändert sich nichts** | Erst lesende Untersuchung, dann eine lesbare Vereinbarung, die du bestätigst. |
|
|
42
|
+
| **Verlässliche Ergebnisse** | Echte Prüfungen und unabhängiges Review; Modelltext zählt nie als bestanden. |
|
|
43
|
+
| **Schließt selbst ab** | Nach der Freigabe repariert, plant neu oder erfasst Abweichungen; Stopp nur bei Bedingungen außerhalb des Repositorys. |
|
|
44
|
+
| **Schneller durch Aufbau** | Unabhängige Aufgaben laufen nebeneinander in eigenen Worktrees. |
|
|
45
|
+
| **Wissen wächst mit** | Routentabelle und festes Budget: Worker lesen nur Passendes, neue Erkenntnisse ersetzen veraltete. |
|
|
46
|
+
| **WebUI zum Sehen und Steuern** | Aufgaben-Board, Revisionen, Abweichungen, Branches, Denken; mitten in der Antwort eingreifen oder einreihen. |
|
|
47
|
+
| **Ein Verlauf** | Browser-Gespräche sind die Pi-Sitzungen des Projekts; an beiden Orten fortsetzbar. |
|
|
48
|
+
|
|
49
|
+
> Cadence ist ein vertrauenswürdiger Assistent, **keine Sandbox**: Die Agenten nutzen Host-Werkzeuge im freigegebenen Checkout oder Worktree.
|
|
50
|
+
> Nur für Code verwenden, den du prüfen und wiederherstellen kannst.
|
|
24
51
|
|
|
25
52
|
## Installation
|
|
26
53
|
|
|
27
|
-
|
|
54
|
+
Benötigt Node `>=22.19.0` und Pi mit Login bei einem Modellanbieter; Cadence nutzt den Pi-Login.
|
|
28
55
|
|
|
29
56
|
```sh
|
|
30
57
|
npm install -g @abelxiaoxing/cadence
|
|
31
58
|
pi install "$(npm root -g)/@abelxiaoxing/cadence"
|
|
59
|
+
cadence server install # optionale WebUI und Boot-Dienst
|
|
32
60
|
```
|
|
33
61
|
|
|
34
|
-
`cadence server install`
|
|
35
|
-
|
|
36
|
-
Port und Token liegen in `~/.pi/agent/cadence/.env`; wer das Token hat, kann deinen Workspace verwenden, daher den Link geheim halten.
|
|
62
|
+
`cadence server install` gibt einen privaten Link aus (`http://127.0.0.1:17423/?token=…`).
|
|
63
|
+
Das Token gewährt Zugriff auf deinen Arbeitsbereich: Link nicht weitergeben.
|
|
37
64
|
|
|
38
65
|
## Verwendung
|
|
39
66
|
|
|
40
|
-
###
|
|
41
|
-
|
|
42
|
-
1. Öffne den ausgegebenen Link einmal; der Browser erinnert sich dann an dich.
|
|
43
|
-
Wenn du ihn verlierst, gibt `cadence token-link --reveal` ihn erneut aus.
|
|
44
|
-
2. Wähle einen Projektordner.
|
|
45
|
-
Die gespeicherte Modellpräferenz wird beim Senden wiederverwendet; fehlt sie, wähle einmal ein Modell.
|
|
46
|
-
3. Sende einmal `/cadence [Ziel]`.
|
|
47
|
-
Dieses Gespräch bleibt im Cadence-Modus; kläre Anforderungen mit normalen Nachrichten.
|
|
48
|
-
4. Prüfe den vollständigen Plan und klicke **Implement this plan**.
|
|
49
|
-
Implementierung, Checks, automatische Fehlerbehebung und die vereinbarte lokale Lieferung laufen automatisch.
|
|
50
|
-
5. Verfolge den Fortschritt im Gespräch; die Protokolle der Subagenten öffnest du über das Dock **Subagents** unten links.
|
|
51
|
-
Aktualisieren und Abschluss beenden den Modus nicht.
|
|
52
|
-
**Exit Cadence** beendet nur den Modus; **Cancel workflow — request stop** fordert den Abbruch an.
|
|
67
|
+
### Browser
|
|
53
68
|
|
|
54
|
-
|
|
69
|
+
1. Den ausgegebenen Link einmal öffnen (`cadence token-link --reveal` zeigt ihn erneut).
|
|
70
|
+
2. Mit der Schaltfläche unten rechts einen Arbeitsordner wählen.
|
|
71
|
+
3. `/cadence [Ziel]` senden und die Rückfragen beantworten.
|
|
72
|
+
4. **Implement this plan** klicken; Board und **Subagents**-Dock zeigen den Fortschritt.
|
|
73
|
+
Bilder per Einfügen oder Ziehen ([Details](docs/conversation-mode.md#images-in-the-webui)).
|
|
55
74
|
|
|
56
|
-
###
|
|
75
|
+
### Terminal
|
|
57
76
|
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
Zum Verlassen `exit cadence` eingeben; dadurch wird laufende Arbeit nicht abgebrochen.
|
|
64
|
-
Modellpräferenzen werden projektübergreifend in `~/.pi/agent/cadence/settings.json` gespeichert.
|
|
65
|
-
|
|
66
|
-
Der lokale Owner startet bei Bedarf; ein Systemdienst ist nur für die optionale WebUI/Autostart-Nutzung nötig.
|
|
67
|
-
|
|
68
|
-
`/cadence-history [run-id]`: readonly run details and retained history; no service startup or task execution.
|
|
69
|
-
See [History and diagnostics](docs/history.md).
|
|
70
|
-
[Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
|
|
71
|
-
Browser authentication is not execution consent.
|
|
72
|
-
|
|
73
|
-
### Weitere Projekte
|
|
77
|
+
`/cadence <Ziel>` einmal im Pi-Gespräch eines vertrauten Projekts eingeben; der Modus bleibt nach Abschluss aktiv.
|
|
78
|
+
`exit cadence` oder `退出 Cadence` beendet ihn, ohne angenommene Arbeit abzubrechen.
|
|
79
|
+
`/cadence-history [run-id]` ist nur lesend.
|
|
80
|
+
`CADENCE_PARALLEL` (Standard 4) legt die gleichzeitigen Worker fest.
|
|
81
|
+
Details: [Konversationsmodus](docs/conversation-mode.md), [Verlauf](docs/history.md).
|
|
74
82
|
|
|
75
83
|
```sh
|
|
76
|
-
cadence project open /absolute/project
|
|
77
|
-
cadence project open /absolute/new-project --create
|
|
84
|
+
cadence project open /absolute/project # ein Owner, Port und Verlauf pro Projekt
|
|
78
85
|
```
|
|
79
86
|
|
|
80
|
-
Jedes Projekt erhält seinen eigenen Owner, Port und seine eigene Historie, und der Befehl gibt seinen privaten Link aus; der WebUI-Ordnerwähler öffnet Projekte auf dieselbe Weise.
|
|
81
|
-
Das Öffnen eines anderen Projekts stoppt nie die Arbeit im vorherigen.
|
|
82
|
-
|
|
83
|
-
### Checks
|
|
84
|
-
|
|
85
|
-
Prüfbefehle stehen im ausdrücklich genehmigten Plan, einschließlich Baseline- und Abnahmeprüfungen.
|
|
86
|
-
Ihre tatsächlichen Ergebnisse bleiben von der automatischen Agent-Prüfung getrennt.
|
|
87
|
-
|
|
88
87
|
## Dienst verwalten
|
|
89
88
|
|
|
90
89
|
```sh
|
|
91
90
|
cadence server status
|
|
92
|
-
cadence server restart # nach
|
|
93
|
-
cadence server upgrade
|
|
94
|
-
cadence server stop
|
|
95
|
-
cadence server uninstall # vor npm uninstall -g
|
|
91
|
+
cadence server restart # nach Upgrade oder Änderung an .env / models.json
|
|
92
|
+
cadence server upgrade # laden, installieren, neu starten; Rückfall, falls die neue Version nicht startet
|
|
93
|
+
cadence server stop
|
|
94
|
+
cadence server uninstall # vor npm uninstall -g
|
|
95
|
+
cadence doctor # Reste und jüngste Wiederherstellungen; --fix für den Rest
|
|
96
96
|
```
|
|
97
97
|
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
Uninstall entfernt nur die Dienstdefinition; Projekte, Historie und Pi-Einstellungen bleiben.
|
|
101
|
-
Linux-Root- und benannte Dienste, entfernter HTTPS-Zugang und Wiederherstellung sind in [Dienstverwaltung](docs/service-management.md) und [Fernzugriff](docs/remote-access.md) beschrieben.
|
|
98
|
+
Nach Absturz oder Stromausfall ist keine Bereinigung nötig: Der nächste Start stellt wieder her und sagt, was er getan hat.
|
|
99
|
+
Siehe [Dienstverwaltung](docs/service-management.md) und [Fernzugriff](docs/remote-access.md).
|
|
102
100
|
|
|
103
101
|
## Entwicklung
|
|
104
102
|
|
|
105
|
-
Pi kann auch
|
|
106
|
-
Cadence benötigt Pi 1.5.0 oder einen kompatiblen 1.x-Host; Entwicklungs-Pins und getestete Laufzeiten sind keine
|
|
103
|
+
Pi kann auch einen lokalen Checkout oder ein gepacktes Tarball laden: absoluten oder relativen Pfad zu `packages` in Pi hinzufügen oder `pi -e ./cadence` probieren.
|
|
104
|
+
Cadence benötigt Pi 1.5.0 oder einen kompatiblen 1.x-Host; Entwicklungs-Pins und getestete Laufzeiten sind keine allgemeinen Kompatibilitätszusagen.
|
|
107
105
|
|
|
108
106
|
```sh
|
|
109
107
|
bun install
|
|
110
108
|
bun run verify
|
|
111
109
|
```
|
|
112
110
|
|
|
113
|
-
|
|
114
|
-
`verify` ist die einzige Prüfung für Entwicklung und Releases: nur schnelle Checks, ohne Browser.
|
|
115
|
-
Erforderlich sind ein offizieller Node-Build und ein privates temporäres Verzeichnis; siehe [Verifikation](engineering/verification.md).
|
|
111
|
+
Hinweise nach Bereich: [engineering/](engineering/) und [AGENTS.md](AGENTS.md). `verify` ist das einzige schnelle Gate; es braucht einen offiziellen Node-Build und ein privates temporäres Verzeichnis ([Verifikation](engineering/verification.md)).
|
|
116
112
|
|
|
117
113
|
## Lizenz
|
|
118
114
|
|
|
119
|
-
|
|
120
|
-
|
|
115
|
+
MIT.
|
|
116
|
+
Gebündelte Anpassungen, Schriften und Fremdkomponenten behalten ihre Lizenzen: [Wiederverwendung und Verteilung](docs/reuse-and-distribution.md), [Drittanbieterhinweise](THIRD_PARTY_NOTICES.md).
|
package/README.es.md
CHANGED
|
@@ -2,119 +2,115 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Deutsch](README.de.md) · [Français](README.fr.md) · [Español](README.es.md) · [Português (Brasil)](README.pt-BR.md) · [Русский](README.ru.md)
|
|
4
4
|
|
|
5
|
-
Cadence convierte
|
|
6
|
-
|
|
5
|
+
Cadence convierte [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) en un flujo de ingeniería guiado por conversación: escribe `/cadence [objetivo]`, acuerda el resultado una vez y un owner persistente implementa, se recupera y verifica.
|
|
6
|
+
Desde el terminal o la WebUI opcional.
|
|
7
|
+
|
|
8
|
+
## Cómo funciona
|
|
9
|
+
|
|
10
|
+
```mermaid
|
|
11
|
+
flowchart TD
|
|
12
|
+
A["/cadence objetivo"] --> B["Investigar solo lectura"]
|
|
13
|
+
B --> C["Alinear y aprobar una vez"]
|
|
14
|
+
C --> D["Tareas independientes en worktrees paralelos"]
|
|
15
|
+
D --> E["Comprobaciones reales + revisión automática de Agent"]
|
|
16
|
+
E -->|"pasa"| F["Fusión local en tu rama"]
|
|
17
|
+
E -->|"falla"| G["Autocorrección"]
|
|
18
|
+
G --> D
|
|
19
|
+
F --> H["Cuidar el conocimiento (presupuesto fijo)"]
|
|
20
|
+
H -.-> B
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
```mermaid
|
|
24
|
+
flowchart LR
|
|
25
|
+
A["Falla una comprobación"] --> B["Reparar"] --> C["Replanificar la ruta"] --> D["Desviación registrada"] --> E["Parar solo por condiciones externas"]
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
```mermaid
|
|
29
|
+
flowchart LR
|
|
30
|
+
T["Terminal de Pi"] <-->|"conectar / desconectar"| O[("Owner persistente")]
|
|
31
|
+
W["WebUI<br/>tablero · ramas · intervenir"] <-->|"conectar / desconectar"| O
|
|
32
|
+
O --> X["Workers en worktrees"] --> Y["Tu rama"]
|
|
33
|
+
O -.-> K["Conocimiento .cadence/"]
|
|
34
|
+
```
|
|
7
35
|
|
|
8
36
|
## Por qué Cadence
|
|
9
37
|
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
Cadence es un asistente de confianza, **no una caja de arena**: sus agentes editan tu copia de trabajo directamente con herramientas del host, así que úsalo en código que puedas revisar y recuperar.
|
|
38
|
+
| | |
|
|
39
|
+
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
|
|
40
|
+
| **El trabajo sobrevive a la ventana** | Los clientes solo se conectan y desconectan; el owner sigue. |
|
|
41
|
+
| **Nada cambia antes de aprobar** | Investigación de solo lectura y un acuerdo legible que confirmas. |
|
|
42
|
+
| **Resultados fiables** | Comprobaciones reales y revisión independiente; el texto del modelo nunca cuenta como aprobado. |
|
|
43
|
+
| **Termina solo** | Tras aprobar, repara, replanifica o registra una desviación, y solo para por condiciones fuera del repositorio. |
|
|
44
|
+
| **Más rápido por diseño** | Las tareas independientes corren en paralelo en sus propios worktrees. |
|
|
45
|
+
| **El conocimiento se acumula** | Tabla de rutas y presupuesto fijo: los workers leen lo que corresponde y las lecciones nuevas sustituyen a las obsoletas. |
|
|
46
|
+
| **WebUI que muestra y dirige** | Tablero de tareas, revisiones, desviaciones, ramas, razonamiento; intervenir o encolar un mensaje en plena respuesta. |
|
|
47
|
+
| **Un solo historial** | Las conversaciones del navegador son las sesiones de Pi del proyecto; continúa en cualquiera. |
|
|
48
|
+
|
|
49
|
+
> Cadence es un asistente de confianza, **no un sandbox**: sus agentes usan herramientas del host en el checkout o worktree aprobado.
|
|
50
|
+
> Úsalo con código que puedas revisar y recuperar.
|
|
24
51
|
|
|
25
52
|
## Instalación
|
|
26
53
|
|
|
27
|
-
|
|
54
|
+
Requiere Node `>=22.19.0` y Pi con sesión iniciada en un proveedor de modelos; Cadence reutiliza el inicio de sesión de Pi.
|
|
28
55
|
|
|
29
56
|
```sh
|
|
30
57
|
npm install -g @abelxiaoxing/cadence
|
|
31
58
|
pi install "$(npm root -g)/@abelxiaoxing/cadence"
|
|
59
|
+
cadence server install # WebUI y servicio de arranque opcionales
|
|
32
60
|
```
|
|
33
61
|
|
|
34
|
-
`cadence server install`
|
|
35
|
-
El
|
|
36
|
-
El puerto y el token están en `~/.pi/agent/cadence/.env`; cualquiera con el token puede usar tu espacio de trabajo, así que mantén el enlace privado.
|
|
62
|
+
`cadence server install` muestra un enlace privado (`http://127.0.0.1:17423/?token=…`).
|
|
63
|
+
El token da acceso a tu espacio de trabajo: mantén el enlace privado.
|
|
37
64
|
|
|
38
65
|
## Uso
|
|
39
66
|
|
|
40
|
-
###
|
|
41
|
-
|
|
42
|
-
1. Abre el enlace impreso una vez; el navegador entonces te recuerda.
|
|
43
|
-
Si lo pierdes, `cadence token-link --reveal` lo imprime de nuevo.
|
|
44
|
-
2. Elige una carpeta de proyecto.
|
|
45
|
-
Al enviar se reutiliza la preferencia de modelo guardada; elige una vez si no existe.
|
|
46
|
-
3. Envía `/cadence [objetivo]` una vez.
|
|
47
|
-
Esta conversación permanece en modo Cadence; aclara los requisitos con mensajes normales.
|
|
48
|
-
4. Revisa el plan completo y pulsa **Implement this plan**.
|
|
49
|
-
La implementación, comprobaciones, recuperación automática y entrega local acordada son automáticas.
|
|
50
|
-
5. Sigue el progreso en la conversación; abre los registros de los subagentes desde el panel **Subagents** abajo a la izquierda.
|
|
51
|
-
Recargar o terminar un objetivo no desactiva el modo.
|
|
52
|
-
**Exit Cadence** sale del modo; **Cancel workflow — request stop** solicita cancelar el trabajo.
|
|
67
|
+
### Navegador
|
|
53
68
|
|
|
54
|
-
|
|
69
|
+
1. Abre una vez el enlace mostrado (`cadence token-link --reveal` lo vuelve a mostrar).
|
|
70
|
+
2. Elige una carpeta de trabajo con el botón inferior derecho.
|
|
71
|
+
3. Envía `/cadence [objetivo]` y responde a las preguntas.
|
|
72
|
+
4. Pulsa **Implement this plan** y sigue el tablero y el dock **Subagents**.
|
|
73
|
+
Imágenes pegadas o arrastradas ([detalles](docs/conversation-mode.md#images-in-the-webui)).
|
|
55
74
|
|
|
56
|
-
###
|
|
75
|
+
### Terminal
|
|
57
76
|
|
|
58
|
-
Escribe `/cadence <objetivo>` una
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
Usa `exit cadence` para salir; salir no cancela el trabajo aceptado.
|
|
64
|
-
Las preferencias de modelo se guardan entre proyectos en `~/.pi/agent/cadence/settings.json`.
|
|
65
|
-
|
|
66
|
-
El propietario local se inicia bajo demanda; el servicio del sistema es opcional para WebUI/inicio automático.
|
|
67
|
-
|
|
68
|
-
`/cadence-history [run-id]`: readonly run details and retained history; no service startup or task execution.
|
|
69
|
-
See [History and diagnostics](docs/history.md).
|
|
70
|
-
[Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
|
|
71
|
-
Browser authentication is not execution consent.
|
|
72
|
-
|
|
73
|
-
### Más proyectos
|
|
77
|
+
Escribe `/cadence <objetivo>` una vez en la conversación de Pi de un proyecto de confianza; el modo sigue activo al terminar.
|
|
78
|
+
`exit cadence` o `退出 Cadence` lo cierra sin cancelar el trabajo aceptado.
|
|
79
|
+
`/cadence-history [run-id]` es de solo lectura.
|
|
80
|
+
`CADENCE_PARALLEL` (4 por defecto) fija los workers simultáneos.
|
|
81
|
+
Detalles: [modo conversación](docs/conversation-mode.md), [historial](docs/history.md).
|
|
74
82
|
|
|
75
83
|
```sh
|
|
76
|
-
cadence project open /absolute/project
|
|
77
|
-
cadence project open /absolute/new-project --create
|
|
84
|
+
cadence project open /absolute/project # un owner, puerto e historial por proyecto
|
|
78
85
|
```
|
|
79
86
|
|
|
80
|
-
Cada proyecto obtiene su propio owner, puerto e historial, y el comando imprime su enlace privado; el selector de carpetas de la interfaz web abre proyectos de la misma manera.
|
|
81
|
-
Abrir otro proyecto nunca detiene el trabajo del anterior.
|
|
82
|
-
|
|
83
|
-
### Comprobaciones
|
|
84
|
-
|
|
85
|
-
Los comandos de verificación se declaran en el plan aprobado, incluidas las comprobaciones iniciales y de aceptación.
|
|
86
|
-
Sus resultados reales se mantienen separados de la revisión automática del agente.
|
|
87
|
-
|
|
88
87
|
## Gestionar el servicio
|
|
89
88
|
|
|
90
89
|
```sh
|
|
91
90
|
cadence server status
|
|
92
|
-
cadence server restart #
|
|
93
|
-
cadence server upgrade
|
|
94
|
-
cadence server stop
|
|
95
|
-
cadence server uninstall #
|
|
91
|
+
cadence server restart # tras actualizar o cambiar .env / models.json
|
|
92
|
+
cadence server upgrade # descargar, instalar, reiniciar; vuelve atrás si la nueva versión falla
|
|
93
|
+
cadence server stop
|
|
94
|
+
cadence server uninstall # antes de npm uninstall -g
|
|
95
|
+
cadence doctor # restos y recuperaciones recientes; --fix para el resto
|
|
96
96
|
```
|
|
97
97
|
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
Uninstall solo elimina la definición del servicio; los proyectos, el historial y la configuración de Pi permanecen.
|
|
101
|
-
Los servicios raíz de Linux y con nombre, el acceso HTTPS remoto y la recuperación se cubren en [gestión del servicio](docs/service-management.md) y [acceso remoto](docs/remote-access.md).
|
|
98
|
+
Un fallo o apagón no exige limpieza: el siguiente arranque se recupera y dice qué hizo.
|
|
99
|
+
Consulta [gestión del servicio](docs/service-management.md) y [acceso remoto](docs/remote-access.md).
|
|
102
100
|
|
|
103
101
|
## Desarrollo
|
|
104
102
|
|
|
105
103
|
Pi también puede cargar un checkout local o un tarball empaquetado: añade su ruta absoluta o relativa a `packages` de Pi, o prueba `pi -e ./cadence`.
|
|
106
|
-
Cadence requiere Pi 1.5.0 o un host 1.x compatible; los pines de desarrollo y los
|
|
104
|
+
Cadence requiere Pi 1.5.0 o un host 1.x compatible; los pines de desarrollo y los runtimes probados no son promesas de compatibilidad universal.
|
|
107
105
|
|
|
108
106
|
```sh
|
|
109
107
|
bun install
|
|
110
108
|
bun run verify
|
|
111
109
|
```
|
|
112
110
|
|
|
113
|
-
|
|
114
|
-
`verify` es la única verificación para desarrollo y publicación: solo comprobaciones rápidas, sin navegador.
|
|
115
|
-
Requiere un build oficial de Node y un directorio temporal privado; ver [verificación](engineering/verification.md).
|
|
111
|
+
Guías por área en [engineering/](engineering/) y [AGENTS.md](AGENTS.md). `verify` es la única puerta rápida; requiere un build oficial de Node y un directorio temporal privado ([verificación](engineering/verification.md)).
|
|
116
112
|
|
|
117
113
|
## Licencia
|
|
118
114
|
|
|
119
|
-
|
|
120
|
-
Las adaptaciones, fuentes y
|
|
115
|
+
MIT.
|
|
116
|
+
Las adaptaciones, fuentes y componentes de terceros incluidos conservan sus licencias: [reutilización y distribución](docs/reuse-and-distribution.md), [avisos de terceros](THIRD_PARTY_NOTICES.md).
|
package/README.fr.md
CHANGED
|
@@ -2,119 +2,115 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Deutsch](README.de.md) · [Français](README.fr.md) · [Español](README.es.md) · [Português (Brasil)](README.pt-BR.md) · [Русский](README.ru.md)
|
|
4
4
|
|
|
5
|
-
Cadence transforme [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) en
|
|
6
|
-
|
|
5
|
+
Cadence transforme [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) en workflow d'ingénierie piloté par la conversation : saisissez `/cadence [objectif]`, validez le résultat une fois, et un owner persistant implémente, reprend et vérifie.
|
|
6
|
+
Dans le terminal ou via la WebUI optionnelle.
|
|
7
|
+
|
|
8
|
+
## Fonctionnement
|
|
9
|
+
|
|
10
|
+
```mermaid
|
|
11
|
+
flowchart TD
|
|
12
|
+
A["/cadence objectif"] --> B["Enquête en lecture seule"]
|
|
13
|
+
B --> C["Aligner, puis approuver une fois"]
|
|
14
|
+
C --> D["Tâches indépendantes en parallèle dans des worktrees"]
|
|
15
|
+
D --> E["Vérifications réelles + revue Agent automatique"]
|
|
16
|
+
E -->|"réussi"| F["Fusion locale dans votre branche"]
|
|
17
|
+
E -->|"échec"| G["Auto-correction"]
|
|
18
|
+
G --> D
|
|
19
|
+
F --> H["Entretenir les connaissances (budget fixe)"]
|
|
20
|
+
H -.-> B
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
```mermaid
|
|
24
|
+
flowchart LR
|
|
25
|
+
A["Échec d'une vérification"] --> B["Réparer"] --> C["Replanifier la route"] --> D["Écart enregistré"] --> E["Arrêt seulement pour des conditions externes"]
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
```mermaid
|
|
29
|
+
flowchart LR
|
|
30
|
+
T["Terminal Pi"] <-->|"connexion / déconnexion"| O[("Owner persistant")]
|
|
31
|
+
W["WebUI<br/>tableau · branches · intervention"] <-->|"connexion / déconnexion"| O
|
|
32
|
+
O --> X["Workers dans des worktrees"] --> Y["Votre branche"]
|
|
33
|
+
O -.-> K["Connaissances .cadence/"]
|
|
34
|
+
```
|
|
7
35
|
|
|
8
36
|
## Pourquoi Cadence
|
|
9
37
|
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
Cadence est un assistant de confiance, **pas un bac à sable** : ses agents modifient directement votre copie de travail avec les outils de l'hôte, utilisez-le donc sur du code que vous pouvez examiner et récupérer.
|
|
38
|
+
| | |
|
|
39
|
+
| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
|
|
40
|
+
| **Le travail survit à la fenêtre** | Les clients se connectent et se déconnectent seulement ; l'owner continue. |
|
|
41
|
+
| **Rien ne change avant l'approbation** | Enquête en lecture seule, puis un accord lisible que vous confirmez. |
|
|
42
|
+
| **Résultats fiables** | Vérifications réelles et revue indépendante ; un texte du modèle ne vaut jamais réussite. |
|
|
43
|
+
| **Termine seul** | Après approbation, il répare, replanifie ou enregistre un écart, et ne s'arrête que pour des conditions hors dépôt. |
|
|
44
|
+
| **Plus rapide par conception** | Les tâches indépendantes s'exécutent côte à côte dans leurs worktrees. |
|
|
45
|
+
| **Les connaissances s'accumulent** | Table de routes et budget fixe : les workers lisent ce qui correspond, les nouvelles leçons remplacent les périmées. |
|
|
46
|
+
| **Une WebUI qui montre et pilote** | Tableau des tâches, révisions, écarts, branches, réflexion ; intervenir ou mettre en file en pleine réponse. |
|
|
47
|
+
| **Un seul historique** | Les conversations du navigateur sont les sessions Pi du projet ; reprise des deux côtés. |
|
|
48
|
+
|
|
49
|
+
> Cadence est un assistant de confiance, **pas un bac à sable** : ses agents utilisent les outils de l'hôte dans le checkout ou worktree approuvé.
|
|
50
|
+
> À utiliser sur du code que vous pouvez relire et restaurer.
|
|
24
51
|
|
|
25
52
|
## Installation
|
|
26
53
|
|
|
27
|
-
|
|
54
|
+
Nécessite Node `>=22.19.0` et Pi connecté à un fournisseur de modèles ; Cadence réutilise la connexion de Pi.
|
|
28
55
|
|
|
29
56
|
```sh
|
|
30
57
|
npm install -g @abelxiaoxing/cadence
|
|
31
58
|
pi install "$(npm root -g)/@abelxiaoxing/cadence"
|
|
59
|
+
cadence server install # WebUI et service de démarrage optionnels
|
|
32
60
|
```
|
|
33
61
|
|
|
34
|
-
`cadence server install`
|
|
35
|
-
|
|
36
|
-
Le port et le jeton se trouvent dans `~/.pi/agent/cadence/.env` ; quiconque possède le jeton peut utiliser votre espace de travail, gardez donc le lien privé.
|
|
62
|
+
`cadence server install` affiche un lien privé (`http://127.0.0.1:17423/?token=…`).
|
|
63
|
+
Le jeton donne accès à votre espace de travail : gardez le lien privé.
|
|
37
64
|
|
|
38
65
|
## Utilisation
|
|
39
66
|
|
|
40
|
-
###
|
|
41
|
-
|
|
42
|
-
1. Ouvrez le lien affiché une fois ; le navigateur vous mémorise ensuite.
|
|
43
|
-
Si vous le perdez, `cadence token-link --reveal` l'affiche à nouveau.
|
|
44
|
-
2. Choisissez un dossier de projet.
|
|
45
|
-
La préférence de modèle est réutilisée à l’envoi ; choisissez une fois si elle est absente.
|
|
46
|
-
3. Envoyez une fois `/cadence [objectif]`.
|
|
47
|
-
Cette conversation reste en mode Cadence ; précisez les besoins par des messages ordinaires.
|
|
48
|
-
4. Lisez le plan complet et cliquez sur **Implement this plan**.
|
|
49
|
-
L’implémentation, les vérifications, la reprise automatique et la livraison locale convenue sont automatiques.
|
|
50
|
-
5. Suivez la progression dans la conversation ; ouvrez les traces des sous-agents depuis le panneau **Subagents** en bas à gauche.
|
|
51
|
-
Actualiser ou terminer un objectif ne quitte pas le mode.
|
|
52
|
-
**Exit Cadence** quitte le mode ; **Cancel workflow — request stop** demande l’annulation.
|
|
67
|
+
### Navigateur
|
|
53
68
|
|
|
54
|
-
|
|
69
|
+
1. Ouvrez une fois le lien affiché (`cadence token-link --reveal` le réaffiche).
|
|
70
|
+
2. Choisissez un dossier de travail avec le bouton en bas à droite.
|
|
71
|
+
3. Envoyez `/cadence [objectif]`, puis répondez aux questions.
|
|
72
|
+
4. Cliquez sur **Implement this plan** et suivez le tableau et le dock **Subagents**.
|
|
73
|
+
Images par collage ou glisser-déposer ([détails](docs/conversation-mode.md#images-in-the-webui)).
|
|
55
74
|
|
|
56
|
-
###
|
|
75
|
+
### Terminal
|
|
57
76
|
|
|
58
|
-
Saisissez `/cadence <objectif>` une
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
Saisissez `exit cadence` pour quitter ; cela n’annule pas le travail accepté.
|
|
64
|
-
Les préférences de modèle sont conservées entre projets dans `~/.pi/agent/cadence/settings.json`.
|
|
65
|
-
|
|
66
|
-
Le propriétaire local démarre à la demande ; le service système est facultatif pour la WebUI et le démarrage automatique.
|
|
67
|
-
|
|
68
|
-
`/cadence-history [run-id]`: readonly run details and retained history; no service startup or task execution.
|
|
69
|
-
See [History and diagnostics](docs/history.md).
|
|
70
|
-
[Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
|
|
71
|
-
Browser authentication is not execution consent.
|
|
72
|
-
|
|
73
|
-
### Plus de projets
|
|
77
|
+
Saisissez `/cadence <objectif>` une fois dans la conversation Pi d'un projet de confiance ; le mode reste actif après l'objectif.
|
|
78
|
+
`exit cadence` ou `退出 Cadence` le quitte sans annuler le travail accepté.
|
|
79
|
+
`/cadence-history [run-id]` est en lecture seule.
|
|
80
|
+
`CADENCE_PARALLEL` (4 par défaut) fixe le nombre de workers simultanés.
|
|
81
|
+
Détails : [mode conversation](docs/conversation-mode.md), [historique](docs/history.md).
|
|
74
82
|
|
|
75
83
|
```sh
|
|
76
|
-
cadence project open /absolute/project
|
|
77
|
-
cadence project open /absolute/new-project --create
|
|
84
|
+
cadence project open /absolute/project # un owner, un port et un historique par projet
|
|
78
85
|
```
|
|
79
86
|
|
|
80
|
-
Chaque projet reçoit son propre owner, son port et son historique, et la commande affiche son lien privé ; le sélecteur de dossiers du WebUI ouvre les projets de la même manière.
|
|
81
|
-
Ouvrir un autre projet n'arrête jamais le travail du précédent.
|
|
82
|
-
|
|
83
|
-
### Vérifications
|
|
84
|
-
|
|
85
|
-
Les commandes de vérification figurent dans le plan explicitement approuvé, avec les vérifications initiales et d’acceptation.
|
|
86
|
-
Leurs résultats restent distincts de la revue automatique par un Agent.
|
|
87
|
-
|
|
88
87
|
## Gérer le service
|
|
89
88
|
|
|
90
89
|
```sh
|
|
91
90
|
cadence server status
|
|
92
|
-
cadence server restart # après une mise à
|
|
93
|
-
cadence server upgrade
|
|
94
|
-
cadence server stop
|
|
95
|
-
cadence server uninstall #
|
|
91
|
+
cadence server restart # après une mise à jour ou un changement de .env / models.json
|
|
92
|
+
cadence server upgrade # télécharger, installer, redémarrer ; retour arrière si la nouvelle version échoue
|
|
93
|
+
cadence server stop
|
|
94
|
+
cadence server uninstall # avant npm uninstall -g
|
|
95
|
+
cadence doctor # restes et reprises récentes ; --fix pour le reste
|
|
96
96
|
```
|
|
97
97
|
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
Uninstall supprime uniquement la définition du service ; les projets, l'historique et les réglages de Pi restent.
|
|
101
|
-
Les services racine Linux et nommés, l'accès HTTPS distant et la récupération sont couverts par [gestion du service](docs/service-management.md) et [accès distant](docs/remote-access.md).
|
|
98
|
+
Un plantage ou une coupure n'exige aucun nettoyage : le démarrage suivant reprend et indique ce qu'il a fait.
|
|
99
|
+
Voir [gestion du service](docs/service-management.md) et [accès distant](docs/remote-access.md).
|
|
102
100
|
|
|
103
101
|
## Développement
|
|
104
102
|
|
|
105
|
-
Pi peut aussi charger un checkout local ou
|
|
106
|
-
Cadence nécessite Pi 1.5.0 ou un hôte 1.x compatible ; les versions
|
|
103
|
+
Pi peut aussi charger un checkout local ou un tarball empaqueté : ajoutez son chemin absolu ou relatif aux `packages` de Pi, ou essayez `pi -e ./cadence`.
|
|
104
|
+
Cadence nécessite Pi 1.5.0 ou un hôte 1.x compatible ; les versions épinglées et runtimes testés ne sont pas des promesses de compatibilité universelle.
|
|
107
105
|
|
|
108
106
|
```sh
|
|
109
107
|
bun install
|
|
110
108
|
bun run verify
|
|
111
109
|
```
|
|
112
110
|
|
|
113
|
-
|
|
114
|
-
`verify` est la seule validation pour le développement et les publications : uniquement des vérifications rapides, sans navigateur.
|
|
115
|
-
Elle nécessite un build Node officiel et un répertoire temporaire privé ; voir [vérification](engineering/verification.md).
|
|
111
|
+
Guides par domaine : [engineering/](engineering/) et [AGENTS.md](AGENTS.md). `verify` est l'unique barrière rapide ; il faut un build Node officiel et un répertoire temporaire privé ([vérification](engineering/verification.md)).
|
|
116
112
|
|
|
117
113
|
## Licence
|
|
118
114
|
|
|
119
|
-
|
|
120
|
-
|
|
115
|
+
MIT.
|
|
116
|
+
Adaptations, polices et composants tiers inclus conservent leurs licences : [réutilisation et distribution](docs/reuse-and-distribution.md), [mentions tierces](THIRD_PARTY_NOTICES.md).
|