Yanshi 偃师
Um motor de pintura headless nativo de IA — uma tela onde pessoas e IA criam juntas.
- As operações são átomos. Cada edição é um átomo anexado a um registro, e a imagem é a dobra desse registro; desfazer e refazer movem um ponteiro.
- Um núcleo, dois hospedeiros. O mesmo núcleo em Rust roda nativamente no servidor e como WebAssembly no navegador, então a renderização local e a do servidor são uma única implementação, não duas aproximações.
- Um pacote autossuficiente. Um pacote
.yanshicarrega o registro de átomos e todos os blobs que ele referencia, e importá-lo em outro lugar reproduz a imagem.
Sobre esse motor ficam um servidor MCP e um visualizador web, para que um agente e uma pessoa trabalhem no mesmo documento.
Instalação
Binários pré-compilados, sem precisar instalar o Rust — Linux x86_64 (estático), macOS Intel e Apple Silicon:
curl -fsSL https://raw.githubusercontent.com/gradetwo/yanshi/main/scripts/install.sh | sh
O script identifica o artefato de lançamento da sua plataforma, verifica o SHA256 dele com o SHA256SUMS oficial, descompacta em ~/.local/share/yanshi/<versão> e coloca lançadores finos de yanshi-serve e yanshi-mcp em ~/.local/bin. O pacote é autossuficiente: pincéis, pré-visualizações de pincéis, mídias, paletas, texturas e o núcleo WASM estão dentro, e os binários os encontram pelo layout do pacote (bin/… ao lado de share/yanshi/…), então roda em qualquer lugar onde for descompactado.
yanshi-serve --root ~/paint --doc mydoc --bind 127.0.0.1:8080 # depois abra http://127.0.0.1:8080/
yanshi-mcp --root ~/paint --doc mydoc # servidor MCP via stdio, para clientes MCP
yanshi-mcp --list-tools --profiles core # apenas mostrar a superfície de ferramentas
Ajustes: YANSHI_VERSION, YANSHI_PREFIX, YANSHI_BIN_DIR, YANSHI_DRY_RUN=1. Plataformas sem pacote pré-compilado — Linux arm64 e Windows: compile a partir do código-fonte (cargo build --release -p yanshi-http -p yanshi-mcp, ou make release), ou descompacte manualmente o pacote do Windows a partir da página de lançamentos.
Início rápido
Você precisa de Rust (a toolchain estável fixada pelo rust-toolchain.toml, com rustfmt e clippy) e de make. Para o núcleo do navegador (renderização no cliente), adicione também rustup target add wasm32-unknown-unknown e wasm-bindgen-cli 0.2.129; sem eles o servidor roda mesmo assim e o visualizador renderiza no servidor.
git clone https://github.com/gradetwo/yanshi.git
cd yanshi
make dev # compila o núcleo WASM se a toolchain estiver presente, compila e serve ⇒ http://127.0.0.1:8110/
Os dados ficam, por padrão, em ~/.local/share/yanshi/workspace. Para mudar a porta ou a raiz de dados, use variáveis de ambiente (o make dev não repassa variáveis do Make para a receita, enquanto o make serve passa --port explicitamente):
PORT=9000 make dev
make serve PORT=9000
Rode make check (formatação, lint, testes) antes de enviar; make help lista todos os alvos.
Estado atual
- Versão 0.3.2, com pacotes de lançamento pré-compilados para cinco plataformas (uma linha de
curl, veja acima); o código está no GitHub e omake releasecontinua permitindo empacotar por conta própria. - O grupo de ferramentas
semanticestá reservado por decisão e não foi implementado. - O núcleo do lado do navegador é um artefato de compilação e um clone novo não o contém; sem ele nada quebra e o visualizador volta a renderizar no servidor.
De onde vem o nome
Yanshi é o artífice do Liezi, em “Perguntas de Tang”, que constrói um autômato capaz de cantar e dançar. A passagem, no original:
周穆王西巡狩,越昆侖,不至弇山。反還,未及中國,道有獻工人名偃師,穆王薦之,問曰:「若有何能?」偃師曰:「臣唯命所試。然臣已有所造,願王先觀之。」穆王曰:「日以俱來,吾與若俱觀之。」翌日,偃師謁見王。王薦之曰:「若與偕來者何人?」對曰:「臣之所造能倡者。」穆王驚視之,趨步俯仰,信人也。巧夫,顉其頤,則歌合律;捧其手,則舞應節。千變萬化,惟意所適。王以為實人也,與盛姬內御並觀之。技將終,倡者瞬其目而招王之左右侍妾。王大怒,立欲誅偃師。偃師大懾,立剖散倡者以示王,皆傅會革木膠漆白黑丹青之所為。王諦料之,內則肝膽心肺脾腎腸胃,外則筋骨支節皮毛齒髮,皆假物也,而無不畢具者。合會復如初見。王試廢其心,則口不能言;廢其肝,則目不能視;廢其腎,則足不能步。穆王始悅而歎曰:「人之巧乃可與造化者同功乎!」詔貳車載之以歸。夫班輸之雲梯,墨翟之飛鳶,自謂能之極也。弟子東門賈、禽滑釐聞偃師之巧以告二子,二子終身不敢語藝,而時執規矩。
Conforme o Chinese Text Project, Liezi, “Tang Wen”; transcrito aqui em caracteres simplificados.
O que vale a pena tomar emprestado não é a engenhosidade, mas o fato de que a construção e o comportamento são separáveis: aberto, o personagem que canta e dança é couro, madeira, cola, laca e pigmentos; tire-lhe o coração, o fígado ou os rins e ele já não fala, enxerga ou anda; monte-o de novo e ele volta a ser como era.
A passagem termina com o espanto do rei: tamanha arte poderia rivalizar com a natureza. Nós não afirmamos isso. O projeto escreve como a ferramenta é construída, e o que ela não consegue fazer tanto quanto o que consegue.
Logo
A marca é um estilingue: uma forquilha, dois elásticos e uma bolinha vermelha. Ela se inspira em uma fala do filme Who Cares (《谁说我不在乎》):
抽出裤衩里的猴皮筋,做成弹弓打你们家玻璃。
(Tire o elástico da cueca e faça um estilingue para quebrar o vidro da sua casa.)
Trecho no bilibili; os direitos do filme pertencem aos seus detentores.
O que ela toma emprestado é o gesto de uma piada: fazer algo utilizável com o que estiver à mão, que é a mesma atitude do projeto: escrever a construção, usar o que funciona e dizer quando não funciona.
Contato e código-fonte
Relatos de bugs e colaboração: yanshi@wangda.today. Para questões de segurança, escreva para nós em vez de abrir uma issue pública.
- Repositório: github.com/gradetwo/yanshi · download do código-fonte (zip): main.zip
- Documentação: README.md · guia · documento de design (autoritativo, em chinês): yanshi-v1.0-draft4.md
Obras
Deslize para os lados para ver mais; clique para o original em 4K.


