Yorishiro開源項目:macOS終端集成Claude Code的3D動漫角色工具(Metal+SwiftUI本地渲染)

Yorishiro開源項目上線:macOS終端里的3D動漫角色,只為讓Claude Code“看得見”。
Yorishiro是GitHub上新發布的MIT協議開源工具,專為macOS Terminal打造。它不調用云端API,也不改寫終端行為——而是把本地運行的Claude Code服務,變成一個能眨眼、思考、敲鍵盤的3D日系角色。渲染全靠Metal + SwiftUI,動畫由LLM輸出的token流實時驅動:遇到<thinking>切沉思姿態,<output>開始就動手指,<done>收尾時點頭。它不提升代碼生成速度,只解決一件事:讓你不再盯著光標發呆。作者在README里寫得清楚:“This is not a CLI tool. This is a presence harness.” 當前只支持手動配置Claude Code本地HTTP服務(默認http://127.0.0.1:8000/v1/chat/completions),不兼容OpenAI/Gemini/DeepSeek,沒LangChain、LlamaIndex或OpenClaw Agent Runtime適配,也沒有插件系統或貢獻指南。
技術實現:一個強約定的前端殼
Yorishiro監聽本地SSE流,只認三類標簽:<thinking>、<code>、<done>。它不解析原始文本,也不做任何LLM輸出后處理——標簽必須由開發者在Claude Code服務端顯式注入。匹配到標簽后,直接映射到Unity導出的GLB模型骨骼幀。表情靠Shader參數調節,無語音、無麥克風,交互僅限鍵盤:Enter提交、Ctrl+C中斷、Tab切換形態。一旦服務端返回格式不符(比如漏掉<thinking>閉合標簽),角色立刻靜止。這種設計讓它無法接入ReAct、Plan-and-Execute等通用Agent流程,更談不上和現有框架協同。
定位清醒:玩具,不是基礎設施
它沒有npm包,沒有Homebrew formula,沒有Docker鏡像。安裝需要Xcode 15+、Swift 5.9,手動編譯運行。發布兩周,Star 142,Fork 9,Issue區沒人問集成,最熱問題是“怎么換立繪”。它不像Cursor或Continue.dev——不補全代碼、不跳轉調試、不讀Git上下文;也不像Devin或Manus——不拆解任務、不規劃步驟、不維護記憶。它的存在本身就在提問:當LLM越來越快,我們是否需要一個視覺錨點,來確認它“正在算”?這個問題真實,但遠未形成共識。
行業對照:具身化的兩種路子
Yorishiro和OpenClaw走完全相反的路。OpenClaw聚焦多Agent調度、可觀測性、跨平臺互操作,靠協議抽象降低耦合;Yorishiro反其道而行,把單點交互壓進極致視覺化,同時主動放棄通用性。類似思路早有雛形:Hugging Face的Gradio Avatar Demo、微軟Research的“AI Persona”概念驗證,但都停留在Web界面。真正可比的是MIT Media Lab早期的Affective Chatbot——用微表情緩解對話焦慮。Yorishiro更進一步:它不模擬情緒,而是用角色動作同步LLM的計算周期。Apple Vision Pro的Persona SDK已在AR/VR中實踐這類思路,但在CLI里,這是第一次。
?? Binance · OKX · Gate.io · HTX · Bitget
現實瓶頸:沒有API,就沒有擴展可能
所有動畫邏輯硬編碼在Swift里:沒Webhook、沒JSON Schema事件總線、沒WebSocket廣播。結果很直接:
- VS Code插件沒法觸發它的動畫(比如測試通過時讓角色跳舞);
- Prometheus沒法監控“LLM延遲升高是否導致角色卡頓”;
- OpenClaw的Agent Orchestrator根本納管不了它——后者要求每個Agent暴露
/health和/schema端點。
作者在Discord里說得坦率:“If you want API, fork and add it yourself.” 這種“自己動手”的哲學,既是項目魅力所在,也是生態天花板。
給AI愛好者的建議
花30分鐘編譯跑起來值得——它用最少代碼證明:CLI的進化方向,未必是更快的補全,而是更可信的“在場感”。別把它塞進CI/CD,也別指望替代Copilot。真正的玩法在fork之后:改CharacterController.swift,把<thinking>換成粒子特效,或者接MacBook攝像頭做視線追蹤。某天你發現角色CPU高了會擦汗——那才是Yorishiro該有的樣子:不是讓AI像人,而是讓人愿意相信它正在干活。