Yanshi 偃师
Un motor de pintura headless nativo de IA: un lienzo donde personas e IA crean juntas.
- Las operaciones son átomos. Cada edición es un átomo añadido a un registro, y la imagen es el pliegue de ese registro; deshacer y rehacer mueven un puntero.
- Un núcleo, dos anfitriones. El mismo núcleo de Rust se ejecuta de forma nativa en el servidor y como WebAssembly en el navegador, así que el renderizado local y el del servidor son una sola implementación, no dos aproximaciones.
- Un paquete autónomo. Un paquete
.yanshilleva el registro de átomos y todos los blobs que referencia, e importarlo en otro lugar reproduce la imagen.
Sobre ese motor hay un servidor MCP y un visor web, así que un agente y una persona trabajan sobre el mismo documento.
Instalación
Binarios precompilados, sin necesidad de instalar Rust: Linux x86_64 (estático), macOS Intel y Apple Silicon:
curl -fsSL https://raw.githubusercontent.com/gradetwo/yanshi/main/scripts/install.sh | sh
El script detecta el artefacto de publicación para tu plataforma, verifica su SHA256 contra el SHA256SUMS oficial, lo descomprime en ~/.local/share/yanshi/<versión> y deja lanzadores ligeros de yanshi-serve y yanshi-mcp en ~/.local/bin. El paquete es autónomo: pinceles, vistas previas de pinceles, medios, paletas, texturas y el núcleo WASM van dentro, y los binarios los encuentran por la estructura del paquete (bin/… junto a share/yanshi/…), así que funciona donde lo descomprimas.
yanshi-serve --root ~/paint --doc mydoc --bind 127.0.0.1:8080 # luego abre http://127.0.0.1:8080/
yanshi-mcp --root ~/paint --doc mydoc # servidor MCP por stdio, para clientes MCP
yanshi-mcp --list-tools --profiles core # solo mostrar la superficie de herramientas
Ajustes: YANSHI_VERSION, YANSHI_PREFIX, YANSHI_BIN_DIR, YANSHI_DRY_RUN=1. Plataformas sin paquete precompilado (Linux arm64 y Windows): compila desde el código fuente (cargo build --release -p yanshi-http -p yanshi-mcp, o make release), o descomprime a mano el paquete de Windows desde la página de lanzamientos.
Inicio rápido
Necesitas Rust (la cadena estable fijada por rust-toolchain.toml, con rustfmt y clippy) y make. Para el núcleo del navegador (renderizado en el cliente) añade también rustup target add wasm32-unknown-unknown y wasm-bindgen-cli 0.2.129; sin ellos el servidor funciona igual y el visor renderiza en el servidor.
git clone https://github.com/gradetwo/yanshi.git
cd yanshi
make dev # compila el núcleo WASM si está la cadena de herramientas, compila y sirve ⇒ http://127.0.0.1:8110/
Los datos viven por defecto en ~/.local/share/yanshi/workspace. Para cambiar el puerto o la raíz de datos, pasa variables de entorno (make dev no reenvía las variables de Make a su receta, mientras que make serve pasa --port explícitamente):
PORT=9000 make dev
make serve PORT=9000
Ejecuta make check (formato, lint, pruebas) antes de subir cambios; make help lista todos los objetivos.
Estado actual
- Versión 0.3.2, con paquetes de lanzamiento precompilados para cinco plataformas (una línea de
curl, ver arriba); el código está en GitHub y conmake releaseaún puedes empaquetarlo tú mismo. - El grupo de herramientas
semanticestá reservado por decisión y no está implementado. - El núcleo del lado del navegador es un artefacto de compilación y un clon recién hecho no lo tiene; sin él nada falla y el visor vuelve al renderizado en el servidor.
De dónde viene el nombre
Yanshi es el artífice del Liezi, en «Preguntas de Tang», que construye un autómata capaz de cantar y bailar. El pasaje, en el original:
周穆王西巡狩,越昆侖,不至弇山。反還,未及中國,道有獻工人名偃師,穆王薦之,問曰:「若有何能?」偃師曰:「臣唯命所試。然臣已有所造,願王先觀之。」穆王曰:「日以俱來,吾與若俱觀之。」翌日,偃師謁見王。王薦之曰:「若與偕來者何人?」對曰:「臣之所造能倡者。」穆王驚視之,趨步俯仰,信人也。巧夫,顉其頤,則歌合律;捧其手,則舞應節。千變萬化,惟意所適。王以為實人也,與盛姬內御並觀之。技將終,倡者瞬其目而招王之左右侍妾。王大怒,立欲誅偃師。偃師大懾,立剖散倡者以示王,皆傅會革木膠漆白黑丹青之所為。王諦料之,內則肝膽心肺脾腎腸胃,外則筋骨支節皮毛齒髮,皆假物也,而無不畢具者。合會復如初見。王試廢其心,則口不能言;廢其肝,則目不能視;廢其腎,則足不能步。穆王始悅而歎曰:「人之巧乃可與造化者同功乎!」詔貳車載之以歸。夫班輸之雲梯,墨翟之飛鳶,自謂能之極也。弟子東門賈、禽滑釐聞偃師之巧以告二子,二子終身不敢語藝,而時執規矩。
Según el Chinese Text Project, Liezi, «Tang Wen»; transcrito aquí en caracteres simplificados.
Lo que vale la pena tomar prestado no es la destreza, sino que la construcción y el comportamiento son separables: abierto, el personaje que canta y baila es cuero, madera, cola, laca y pigmentos; quítale el corazón, el hígado o los riñones y ya no puede hablar, ver ni andar; vuelve a montarlo y queda como antes.
El pasaje termina con el asombro del rey: semejante arte podría rivalizar con la naturaleza. Nosotros no afirmamos eso. El proyecto escribe cómo está construida la herramienta, y lo que no puede hacer tanto como lo que sí puede.
Logo
La marca es una tirachinas: un marco ahorquillado, dos gomas y una bolita roja. Se inspira en una frase de la película Who Cares (《谁说我不在乎》):
抽出裤衩里的猴皮筋,做成弹弓打你们家玻璃。
(Sácate la goma de los calzoncillos y haz una tirachinas para romper los cristales de tu casa.)
Fragmento en bilibili; los derechos de la película pertenecen a sus titulares.
Lo que toma prestado es el gesto de un chiste: hacer algo útil con lo que haya a mano, que es la misma actitud del proyecto: escribir la construcción, usar lo que funciona y decirlo cuando no funciona.
Contacto y código
Informes de errores y colaboración: yanshi@wangda.today. Para problemas de seguridad, escríbenos en lugar de abrir un issue público.
- Repositorio: github.com/gradetwo/yanshi · descarga del código (zip): main.zip
- Documentación: README.md · guía · documento de diseño (autoritativo, en chino): yanshi-v1.0-draft4.md
Obras
Desliza hacia los lados para ver más; haz clic para ver el original en 4K.


