anymouschina/TapCanvas

TapCanvas Pro – AI 驅動的視覺內容創作畫布

是什麼 – TapCanvas Pro 是一個開源、採用單體倉儲（monorepo）結構的 Web 應用程式，允許您在單一無限畫布上建立長篇 AI 生成內容（文字、圖像、影片、故事板）。它結合前端畫布、後端 API 與 Agents 執行層，使資產、提示詞與模型呼叫能以專案形式持久化，並可在不同步驟間重複使用。

核心元件

元件	技術堆疊	作用
apps/web	Vite + React 18 + Mantine + React‑Flow	互動式畫布 UI，節點代表文字、圖像、影片、腳本等。支援拖曳資產並連接節點以定義工作流程。
apps/hono-api	NestJS + Hono + Node.js + Prisma + PostgreSQL + Redis	HTTP API，用於儲存專案、資產、驗證，並公開 AI 工具的 Schema。
apps/agents‑cli	TypeScript	「Agents 橋接器」——一個最小的自主代理循環（plan → tool → report）。處理語意理解、技能選擇、記憶、子代理，並將呼叫轉發至設定的 LLM 端點。
apps/new‑api	修改版 new‑api 網關	統一網關，支援多個模型提供者（文字、圖像、影片）。處理路由、配額與計費。
packages/*	共用 TypeScript 套件	前端與後端共用的 Schema、SDK 與可重用工具。

主要功能

• 無限畫布工作流程 – 文件、角色、故事板、生成的圖像/影片以及執行連結的節點可無限迭代。
• 代理驅動執行 – POST /public/agents/chat 端點將使用者提示路由至 Agents 橋接器，由其決定呼叫哪個工具（如文字生成、圖像合成），並將結果寫回畫布。
• 多模型整合 – new‑api 網關允許您透過統一 Schema 接入任何支援的 LLM、擴散模型或影片模型。
• 專案層級資產持久化 – 角色卡、參考圖像、腳本片段與執行日誌依專案儲存，支援跨會話連續性。
• 章節式創作 – 專為長鏈情境設計，如小說轉故事板或分集影片製作，上下文注入作用於單一章節。
• Docker 優先部署 – 一個 docker‑compose.yml 檔案可透過單一指令啟動 PostgreSQL、Redis、代理橋接器、API 與模型網關。

典型使用情境

• 將小說或劇本轉為故事板，再進一步生成短片。
• 需要集中管理提示詞、生成資產與執行歷史的協作團隊。
• 任何需要多個 AI 步驟（如生成場景描述 → 創作概念圖 → 合成影片片段）且結果可追蹤的工作流程。

快速上手

1. 選擇啟動方式 – 一鍵 Docker Compose 流程（推薦快速試用）或本地原始碼設定（用於開發）。
2. 安裝相依性 – 專案使用 pnpm 工作區（pnpm -w install）。
3. 設定 – 複製 API、Web 前端與 agents‑cli 的 .env.example 檔案，至少設定 DATABASE_URL、JWT_SECRET 與 AGENTS_BRIDGE_BASE_URL。
4. 執行 –
   • Docker：cd apps/hono-api && docker compose up -d，然後 pnpm dev:web。
   • 原始碼：開啟三個終端機：pnpm --filter agents dev -- serve --port 8799，pnpm dev:api，pnpm dev:web。
5. 在瀏覽器中開啟 http://localhost:5173；畫布 UI 應已載入，並能與 API 及代理橋接器通訊。

授權 – TapCanvas 的社群版採用 MIT 授權發行。與商業版本明確分離，MIT 條款僅適用於本倉儲中的程式碼。

---

以上所有資訊均直接取自倉儲的 README，未推斷任何額外功能。