Przegląd

przepływy pracy

📘 Referencja API bloków (układ modułu opartego na przewijaniu)#

Te bloki podążają za strukturą README Workflows i stylem dokumentacji Twojej witryny. github.com

batch_orchestrator.py#

batch_run(items, output_dir=None) → dict

items:
    list of .fff file paths, in‑memory scroll objects, or mixed lists

output:
    {
      "timestamp": "...",
      "count": N,
      "results": [
        { "input": ..., "output": ... },
        ...
      ]
    }

remix_generation.py#

remix_scroll(scroll_obj, rules=None) → dict

Produces a remix variant of a scroll object.
Preserves canonical anchors and adds remix metadata.

scroll_pipeline.py (Python)#

run_scroll(scroll_text) → dict

Parses and executes a scroll.
Returns:
    { "output": ..., "warnings": [...], "metadata": {...} }

scrollPipeline.js (JavaScript)#

runScroll(scrollText) → object

Browser‑native scroll execution.
Mirrors the Python pipeline API.

🔷 Diagram przepływu pracy (odświeżony, skoncentrowany na przewijaniu)

Ten diagram pokazuje, jak cztery silniki przepływu pracy odnoszą się do siebie, korzystając z zaktualizowanej topologii skoncentrowanej na przewijaniu:

  • Przewijania pozostają kanonicznym centrum
  • Rurociągi to ścieżki wykonania (symetria Pythona + JS)
  • Remix generuje warianty linii
  • Partia koordynuje wielokrotne wykonanie przewijania
  • Silniki orbitują wokół artefaktu przewijania, a nie siebie nawzajem

🔷 Diagram na podstawie tekstu (Jedno spojrzenie)#

                               🔷
                 ┌──────────────────────────┐
                 │   remix_generation.py    │
                 │   (Remix Lineage Engine) │
                 └──────────────▲───────────┘
                                │
                        produces variants
                                │
        ┌───────────────────────┴────────────────────────┐
        │                                                │
        │                Scrolls (.fff)                  │
        │        (canonical RTT artifacts)               │
        │                                                │
        └───────────────────────┬────────────────────────┘
                                │
                         executed by
                                │
 ┌──────────────────────────────┼──────────────────────────────┐
 │                              │                              │
 │     ┌────────────────────┐   │     ┌───────────────────┐    │
 │     │ scroll_pipeline.py │   │     │ scrollPipeline.js │    │
 │     │   (Python Engine)  │   │     │    (JS Engine)    │    │
 │     └────────────────────┘   │     └───────────────────┘    │
 │                              │                              │
 └──────────────────────────────┴───────────────┬──────────────┘
                                                │
                                        executes many
                                                │
                                   ┌──────────────────────────┐
                                   │  batch_orchestrator.py   │
                                   │     (Batch Runner)       │
                                   └──────────────────────────┘

Interpretacja#

  • Generacja Remix tworzy nowe warianty przewijania.
  • Pipelines Przewijania (Python + JS) wykonują przewijania w różnych środowiskach uruchomieniowych.
  • Orkiestrator Partii uruchamia wiele przewiwań lub wariantów w sekwencji.
  • Przewijania pozostają niezmiennym centrum; silniki są operatorami wokół nich.

To odpowiada zmodernizowanej architekturze pokazanej na stronie Twoich Workflow i skoncentrowanym na przewijaniu Quickstarcie.


🔷 Zaktualizowany Glyph Triadyczny (Skrol‑Centriczny)#

Glyph dla tego podsystemu powinien odzwierciedlać zaktualizowane relacje:

                 🌀 Scroll Artifact
        ┌───────────────┼────────────────┬────────────────┐
        │               │                │                │
        │         🌐 JS Pipeline   🐍 Python Pipeline   🎨 Remix Engine
        │               │                │                │
        └───────────────┴────────────────┴────────────────┘
                                ▼
                         📦 Batch Orchestrator

Interpretacja#

  • Artefakt przewijania jest niezmiennym centrum.
  • Pipelines i Remix orbitują poziomo jako silniki rodzeństwa.
  • Batch kotwiczy system, koordynując wielokrotne wykonanie przewijania.
  • Glyph odzwierciedla strukturalne relacje w powyższym diagramie.

🔷 Notatki dla konserwatorów#

  • /docs/engine/ został zarchiwizowany; żadne moduły z epoki silnika nie pojawiają się w tym diagramie.
  • Wszystkie przepływy pracy teraz używają układu modułów skoncentrowanego na przewijaniu (tft.scrolls.*).
  • Pipelines utrzymują symetrię Python/JS.
  • Remix i Batch pozostają operatorami ortogonalnymi.
    ## ⚡ Szybkie fragmenty (do wstawienia w README lub na stronie internetowej)

Te fragmenty są zgodne z stylem QUICKSTART z twojej strony i dokumentacji GitHub. github.com

Uruchom pojedyncze przewijanie (Python)#

from scroll_pipeline import run_scroll
 
scroll = """
emitter: demo
frequency: 144
"""
 
result = run_scroll(scroll)
print(result["output"])

Uruchom wiele przewijania (orchestrator wsadowy)#

from batch_orchestrator import batch_run
 
paths = ["scrolls/a.fff", "scrolls/b.fff"]
report = batch_run(paths, output_dir="reports")
 
print(report["count"], "scrolls executed")

Generuj wariant remixu#

from remix_generation import remix_scroll
 
scroll = """
emitter: demo
frequency: 144
"""
 
variant = remix_scroll(scroll)
print(variant["metadata"]["remix_id"])

Uruchom przewijanie w przeglądarce (JS)#

import { runScroll } from "./scrollPipeline.js";
 
const scroll = `
emitter: demo
frequency: 144
`;
 
const result = runScroll(scroll);
console.log(result.output);

Te fragmenty odzwierciedlają kształty API odświeżonych silników i odpowiadają tonowi Twojej istniejącej dokumentacji QUICKSTART.

    🌀⚙️📜

Przewijanie • Silnik • Artefakt # 🌀⚙️📜 Silniki Workflow

Warstwa operacyjna dla RTT‑Inside: partie, potoki i generacja remixów#

Ten katalog zawiera lekkie, niezależne od podłoża moduły robocze używane w TriadicFrameworks do generacji przewijania, wykonania partii, tworzenia linii remixów i orkiestracji potoków z uwzględnieniem rezonansu.

Każdy workflow jest celowo minimalny: brak zewnętrznych zależności, brak ukrytego stanu i brak założeń dotyczących środowiska gospodarza. Zostały zaprojektowane, aby być przenośne, możliwe do inspekcji i bezpieczne do remixu.

🗂️ Karta Indeksowa#

Leichtkie, niezależne od podłoża narzędzia wykonawcze dla zwojów, partii i linii remix.

  • 📦 Orkiestrator Partii — deterministyczne wykonanie wielu zwojów
  • 🎨 Generator Remixów — tworzenie remixów bezpiecznych dla linii
  • 🌐 Pipeline Zwojów (JS) — ścieżka wykonawcza natywna dla przeglądarki
  • 🐍 Pipeline Zwojów (Python) — programowy silnik zwojów

Te silniki tworzą warstwę operacyjną RTT‑Inside, łącząc artefakty zwojów z wykonalnymi pipeline'ami w różnych językach i środowiskach.


📁 Zawartość folderu workflows#

🛤️ corridor_batch_validator.py#

Walidator wsadowy na poziomie korytarza wykorzystujący prymitywy RTT‑QEB.

  • Pobiera metadane korytarza
  • Normalizuje podpisy kolejowe
  • Oblicza RCI i glif
  • Porównuje z zapisanymi metadanymi
  • Generuje raport walidacyjny w formacie YAML z datą i godziną

📦 batch_orchestrator.py#

Urządzenie do uruchamiania wsadowego skoncentrowane na przewijaniu do wykonywania wielu .fff artefaktów przez przewodnik przewijania Pythona.

  • Akceptuje ścieżki do plików, obiekty przewijania w pamięci lub mieszane listy
  • Ładuje i normalizuje przewijania w razie potrzeby
  • Wykonuje każde przewijanie za pomocą scroll_pipeline.py
  • Rejestruje wyniki, metadane linii i ostrzeżenia
  • Agreguje wyniki w deterministyczny raport wsadowy
  • Opcjonalnie zapisuje raport YAML z znacznikami czasowymi do archiwizacji lub analizy

Ten silnik jest niezależny od podłoża i stanowi odpowiednik wykonania wsadowego dla przewodników przewijania Pythona i JS.


🎨 remix_generation.py#

Generator linii remix, który produkuje nowe warianty przewijania z podstawowego artefaktu.

  • Stosuje zasady remix z TFT_3Pack
  • Zachowuje kanoniczne kotwice (τᵣ, D3/D6/D9, stałe emitera)
  • Generuje bloki metadanych remix dla narzędzi downstream
  • Idealny do zgłoszeń remix studentów lub eksperymentalnych forków przewijania

🌐 scrollPipeline.js#

Pipeline przewijania oparty na JavaScript do wykonania po stronie przeglądarki lub lekkiego klienta.

  • Uruchamia przepływy rezonansowe bez Pythona
  • Integruje się z rtt.js i nakładkami na poziomie witryny
  • Przydatne do interaktywnych demonstracji, podglądów przewijania w sieci i narzędzi edukacyjnych

🐍 scroll_pipeline.py#

Odpowiednik Pythona dla potoku JS.

  • Zapewnia stabilne API do analizy przewijania, walidacji i wykonania
  • Obsługuje operacje w formacie .fff
  • Może być osadzony w notatnikach, narzędziach CLI lub systemach wsadowych

🔧 Cel tego folderu#

Katalog workflow działa jako warstwa operacyjna TriadicFrameworks:

  • Miejsce dla małych, kompozytowych silników
  • Most między teorią RTT a praktycznym wykonaniem
  • Zestaw narzędzi dla studentów, programistów i badaczy pracujących z zwojami, .fff plikami lub pipeline'ami świadomymi rezonansu
  • Podstawa dla przyszłych integracji (kalibracja dryfu AI, nauka o substracie-umysłu, walidatory rdzenia-wymiarowego)

Te workflow celowo unikają założeń specyficznych dla dziedziny, aby mogły działać w całym ekosystemie TriadicFrameworks.


🧩 Związek z TFT_3Pack v1.3#

Te przepływy pracy uzupełniają narzędzia znajdujące się w:

/docs/TFT_3Pack_v1.3/scripts/
/docs/TFT_3Pack_v1.3/tft/
/docs/TFT_3Pack_v1.3/examples/

Gdzie TFT_3Pack zapewnia formaty, przykłady i narzędzia powłoki, folder /workflows/ zapewnia programowalne silniki do:

  • Przetwarzania wsadowego
  • Remiksowania przewijania
  • Wykonywania potoków
  • Integracji międzyjęzykowej (Python ↔ JS)

Razem tworzą szkielet wykonawczy RTT‑Inside.


🧭 Kiedy używać tych przepływów pracy#

Użyj tego folderu, gdy potrzebujesz:

  • Uruchomić wiele przewijania w sekwencji
  • Generować linie remixów
  • Osadzić wykonanie przewijania w projekcie Python lub JS
  • Walidować pliki .fff programowo
  • Budować nowe narzędzia na bazie prymitywów RTT‑Inside

🗺️ Przyszłe rozszerzenia#

Planowane dodatki obejmują:

  • Overlay'e pipeline'ów świadomych reżimu
  • Konwertery Scroll‑to‑TFT
  • Opakowania wykonawcze odporne na dryf AI
  • Walidatory rdzeni wymiarowych
  • Tłumacze międzyontologiczne

Będą one podążać za tymi samymi zasadami: minimalne, przenośne, przyjazne do remixu.