Yanshi Yanshi

Yanshi 偃师

Um motor de pintura headless nativo de IA — uma tela onde pessoas e IA criam juntas.

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

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.

Obras

Degas: BastidoresDegas: Quatro dançarinasEstudo de referência de balé (4K)

Deslize para os lados para ver mais; clique para o original em 4K.