Yanshi 偃师
Eine KI-native Headless-Mal-Engine — eine Leinwand, auf der Menschen und KI gemeinsam schaffen.
- Operationen sind Atome. Jede Bearbeitung ist ein Atom, das an ein Log angehängt wird, und das Bild ist die Faltung dieses Logs; Rückgängig und Wiederholen verschieben nur einen Zeiger.
- Ein Kern, zwei Hosts. Derselbe Rust-Kern läuft nativ auf dem Server und als WebAssembly im Browser — lokales und serverseitiges Rendering sind eine Implementierung, nicht zwei Annäherungen.
- Ein Paket ist eigenständig. Ein
.yanshi-Paket enthält das Atom-Log und alle Blobs, auf die es verweist; wer es anderswo importiert, erhält dasselbe Bild.
Auf dieser Engine sitzen ein MCP-Server und ein Web-Viewer, sodass ein Agent und ein Mensch an demselben Dokument arbeiten.
Installation
Vorgefertigte Binaries, keine Rust-Toolchain nötig — Linux x86_64 (statisch), Intel macOS und Apple Silicon:
curl -fsSL https://raw.githubusercontent.com/gradetwo/yanshi/main/scripts/install.sh | sh
Das Skript erkennt das Release-Asset für Ihre Plattform, prüft dessen SHA256 gegen die offizielle SHA256SUMS, entpackt es nach ~/.local/share/yanshi/<Version> und legt dünne Wrapper für yanshi-serve und yanshi-mcp in ~/.local/bin ab. Das Paket ist eigenständig: Pinsel, Pinselvorschauen, Medien, Paletten, Texturen und der WASM-Kern sind enthalten, und die Binaries finden sie über das Paketlayout (bin/… neben share/yanshi/…) — es läuft, wo immer Sie es entpacken.
yanshi-serve --root ~/paint --doc mydoc --bind 127.0.0.1:8080 # danach http://127.0.0.1:8080/ öffnen
yanshi-mcp --root ~/paint --doc mydoc # stdio-MCP-Server, für MCP-Clients
yanshi-mcp --list-tools --profiles core # nur die Tool-Oberfläche anzeigen
Einstellbar über YANSHI_VERSION, YANSHI_PREFIX, YANSHI_BIN_DIR, YANSHI_DRY_RUN=1. Plattformen ohne vorgefertigtes Paket — Linux arm64 und Windows: aus dem Quellcode bauen (cargo build --release -p yanshi-http -p yanshi-mcp oder make release) oder das Windows-Paket von der Releases-Seite von Hand entpacken.
Schnellstart
Sie brauchen Rust (die in rust-toolchain.toml fixierte Stable-Toolchain mit rustfmt und clippy) und make. Für den Browser-Kern (clientseitiges Rendering) zusätzlich rustup target add wasm32-unknown-unknown und wasm-bindgen-cli 0.2.129; ohne sie läuft der Server trotzdem und der Viewer rendert serverseitig.
git clone https://github.com/gradetwo/yanshi.git
cd yanshi
make dev # baut den WASM-Kern, falls die Toolchain da ist, baut und serviert ⇒ http://127.0.0.1:8110/
Die Daten liegen standardmäßig in ~/.local/share/yanshi/workspace. Port oder Datenwurzel ändern Sie über Umgebungsvariablen (make dev reicht Make-Variablen nicht in sein Rezept durch, während make serve --port explizit übergibt):
PORT=9000 make dev
make serve PORT=9000
Führen Sie vor dem Pushen make check (Format, Lint, Tests) aus; make help listet alle Ziele.
Aktueller Stand
- Version 0.3.2, mit vorgefertigten Release-Paketen für fünf Plattformen (eine
curl-Zeile, siehe oben); der Quellcode liegt auf GitHub, und mitmake releasekönnen Sie ihn weiterhin selbst paketieren. - Die Werkzeuggruppe
semanticist per Entscheidung nur reserviert und nicht implementiert. - Der browserseitige Kern ist ein Build-Artefakt und in einem frischen Klon nicht enthalten; ohne ihn schlägt nichts fehl, und der Viewer fällt auf serverseitiges Rendering zurück.
Woher der Name kommt
Yanshi ist der Kunsthandwerker aus dem Liezi, „Fragen des Tang“, der einen mechanischen Sänger und Tänzer baut. Die Stelle im Original:
周穆王西巡狩,越昆侖,不至弇山。反還,未及中國,道有獻工人名偃師,穆王薦之,問曰:「若有何能?」偃師曰:「臣唯命所試。然臣已有所造,願王先觀之。」穆王曰:「日以俱來,吾與若俱觀之。」翌日,偃師謁見王。王薦之曰:「若與偕來者何人?」對曰:「臣之所造能倡者。」穆王驚視之,趨步俯仰,信人也。巧夫,顉其頤,則歌合律;捧其手,則舞應節。千變萬化,惟意所適。王以為實人也,與盛姬內御並觀之。技將終,倡者瞬其目而招王之左右侍妾。王大怒,立欲誅偃師。偃師大懾,立剖散倡者以示王,皆傅會革木膠漆白黑丹青之所為。王諦料之,內則肝膽心肺脾腎腸胃,外則筋骨支節皮毛齒髮,皆假物也,而無不畢具者。合會復如初見。王試廢其心,則口不能言;廢其肝,則目不能視;廢其腎,則足不能步。穆王始悅而歎曰:「人之巧乃可與造化者同功乎!」詔貳車載之以歸。夫班輸之雲梯,墨翟之飛鳶,自謂能之極也。弟子東門賈、禽滑釐聞偃師之巧以告二子,二子終身不敢語藝,而時執規矩。
Nach dem Chinese Text Project, Liezi, „Tang Wen“; hier in vereinfachten Schriftzeichen wiedergegeben.
Was sich zu übernehmen lohnt, ist nicht die Kunstfertigkeit, sondern dass Konstruktion und Verhalten trennbar sind: Aufgeschnitten ist die Figur, die singt und tanzt, nur Leder, Holz, Leim, Lack und Pigment; nimmt man ihr Herz, Leber oder Niere, kann sie nicht mehr sprechen, sehen oder gehen; setzt man sie wieder zusammen, ist sie wie zuvor.
Die Stelle endet mit dem Staunen des Königs, menschliche Kunst könne es mit der Schöpfung aufnehmen. Das behaupten wir nicht. Das Projekt schreibt auf, wie das Werkzeug gebaut ist — und was es nicht kann, ebenso wie das, was es kann.
Logo
Das Zeichen ist eine Schleuder: ein gegabelter Rahmen, zwei Gummibänder und eine rote Kugel. Inspiriert von einem Satz aus dem Film Who Cares (《谁说我不在乎》):
抽出裤衩里的猴皮筋,做成弹弓打你们家玻璃。
(Zieh das Gummiband aus deiner Unterhose, bau eine Schleuder und schieß die Scheiben bei euch ein.)
Ausschnitt auf bilibili; die Rechte am Film liegen bei den Rechteinhabern.
Entlehnt ist die Geste eines Witzes: aus dem, was gerade da ist, etwas Brauchbares machen — dieselbe Haltung wie das Projekt: die Konstruktion aufschreiben, nutzen, was funktioniert, und es sagen, wenn es nicht funktioniert.
Kontakt und Quellcode
Fehlerberichte und Zusammenarbeit: yanshi@wangda.today. Sicherheitsprobleme bitte per E-Mail melden, nicht als öffentliches Issue.
- Repository: github.com/gradetwo/yanshi · Quellcode-Download (zip): main.zip
- Dokumentation: README.md · Anleitung · Designdokument (maßgeblich, auf Chinesisch): yanshi-v1.0-draft4.md
Werke
Seitlich wischen für mehr; Klick zeigt das 4K-Original.


