Yanshi Yanshi

Yanshi 偃师

Un motor de pintura headless nativo de IA: un lienzo donde personas e IA crean juntas.

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

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.

Obras

Degas: Entre bastidoresDegas: Cuatro bailarinasEstudio de referencia de ballet (4K)

Desliza hacia los lados para ver más; haz clic para ver el original en 4K.