tt/ttstd-infinite-canvas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
10c8e19d940cbbe329ea0b2572b24310b7fc5949
ttstd-infinite-canvas/README.md

428 lines
18 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<p align="center">
<img src="web/public/logo.svg" width="88" alt="影策 logo">
</p>
<h1 align="center">影策</h1>
<p align="center">让一个故事，从文字走向银幕</p>
<p align="center">
<a href="https://github.com/ddcat-ai/open-ai-canvas">GitHub</a> ·
<a href="docs/content/docs/overview/features.mdx">功能</a> ·
<a href="docs/content/docs/overview/quick-start.mdx">文档</a> ·
<a href="SECURITY.md">安全策略</a>
</p>
影策是一个开源的 AI 影视与短剧创作工作台：用自由画布组织创作，用结构化工作流管理剧本、角色、场景和分镜，并通过统一的任务系统完成图片、视频、音频与文本生成。
> 项目仍在快速开发，数据结构和外部接口可能调整。默认适合个人、本地或可信环境部署；未经安全配置，不要直接作为公网多人服务使用。
在线演示：[https://ddcat.pronhubcn.com](https://ddcat.pronhubcn.com)
账号/密码：test/test123456
## 赞助商
感谢以下赞助商对影策项目的支持：
| LOGO | 类型 | 赞助商名称 | 说明 | 网站 |
| --- | --- | --- | --- | --- |
| <img src="assets/artdance.png" alt="ArtDance" width="160"> | 商业 | ArtDance | 本项目 Seedance 模型的天使投资人。 | [artbox.top](https://artbox.top) |
| <img src="assets/soonstudio.jpg" alt="soonstudio" width="160"> | 商业 | soonstudio | API 一站式网站，自研系统，非 New API；支持手机、短信接码，覆盖国内外几乎所有模型 API 接口，并发高、稳定性强。源于开源，步入 AI 领域，感谢开源。 | [soonstudio.ai](https://soonstudio.ai/) |
| <img src="assets/fluxion.jpg" alt="Fluxion AI" width="160"> | 商业 | Fluxion AI | 面向个人开发者、技术团队与企业，通过统一 API 接入并管理全球主流 AI 模型，根据不同模型与线路，API 调用成本较官方或基准价格可降低 40%—98%。 | [注册送 $3.88 试用福利](https://fluxionai.space/register?source=github&campaign=yingce&promo=yingce) |
| <img src="assets/sponsor1.svg" alt="快乐机艺术小组" width="160"> | 团队 | 快乐机艺术小组 | 一支跨学科的艺术创作团队，持续探索数字与艺术的全新表达形式。 | 暂无 |
| <img src="assets/metaso.png" alt="秘塔" width="160"> | 企业 | 秘塔 | 提供 MiniMax H3 视频生成 API，支持原生 2K、音画同步和 OpenAI 兼容协议。 | [metaso.cn](https://metaso.cn/minimax-h3/?s=dd) |
| <img src="assets/fruivision.png" alt="浮瑞万相AI" width="160"> | 企业 | 浮瑞万相AI | 一家专注于AI视听的AI Native公司 | 暂无 |
| <img src="assets/xmzm.png" alt="喜马抓马" width="160"> | 团队 | 喜马抓马 | 中国AI视听先锋厂牌/AI 视听全链路综合服务平台 | [himadrama.com](https://himadrama.com) |
| <img src="assets/yuyutech.jpg" alt="羽宇科技" width="160"> | 企业 | 羽宇科技 | 一站式AI应用平台。提供模型算力入口、AI短剧视频制作（Studio）、企业数字员工（Agent）及内容出海（OPC）全栈解决方案。 | 暂无 |
## 核心能力
- **自由画布**：节点、连线、框选、缩放、小地图、撤销重做、导入导出和只读分享。
- **影视创作工作流**：剧本、角色、场景、风格板、参考素材、结构化分镜和 3D 导演台。
- **多媒体生成**：文本、图片、视频、音频任务，支持参考图、首尾帧、运镜、续写、局部修改和批量生成。
- **任务与素材管理**：异步队列、进度与日志、取消/重试、素材库、资源引用校验和登录后的跨设备同步。
- **时间线剪辑**：片段编排、拆分、修剪、字幕转写和服务端成片导出，并支持插件化编辑面板。
- **云端 Agent**：支持持久化对话、画布摘要和流式事件回放；当前为只读阶段，真实环境能力以文档和验收清单为准。
- **Agent 技能生态**：内置技能覆盖生产流程；社区技能库 [judian-skills](https://github.com/itsWyatt-K/judian-skills) 提供 34 个场景域包索引，完整卡片通过 GitHub 安装后按需读取。安装：技能页 → 安装技能 → GitHub 标签 → 仓库地址填 `https://github.com/itsWyatt-K/judian-skills`，子目录填 `skills/drama/story-structure-engine` 这类域包路径。
- **管理与渠道**：系统渠道、逻辑模型、用量/积分、功能开关、对象存储、响应拦截和管理后台。
完整功能以[功能清单](docs/content/docs/overview/features.mdx)为准。
## 快速开始
### 环境要求
- [Bun](https://bun.sh/)：前端和文档站
- [Go 1.25](https://go.dev/)：后端
- Docker Compose：仅在使用容器开发或部署时需要
### 宿主机启动
```bash
git clone https://github.com/ddcat-ai/open-ai-canvas.git
cd open-ai-canvas
# 使用 Git 忽略的目录保存本地开发数据和缓存
mkdir -p .local/project-workbench-debug .local/cache/go-build .local/cache/go-mod
# 终端一：后端
cd backend
CANVAS_BACKEND_ADDR=127.0.0.1:8080 \
CANVAS_BACKEND_DATA_DIR=../.local/project-workbench-debug \
GOCACHE=../.local/cache/go-build \
GOMODCACHE=../.local/cache/go-mod \
go run ./cmd/server
# 终端二：前端
cd ../web
bun install --frozen-lockfile
bun run dev
```
打开 <http://localhost:3000>。首次使用时注册管理员账号，并在设置中配置模型渠道。前端默认将 `/api` 代理到 `http://127.0.0.1:8080`；如需修改代理目标，可设置 `VITE_API_PROXY_TARGET`。
Windows PowerShell 用户可在仓库根目录执行：
```powershell
.\scripts\start-local.ps1
```
### Docker 开发与本地构建
源码热更新：
```bash
LOCAL_UID=$(id -u) LOCAL_GID=$(id -g) \
docker compose -f docker-compose.dev.yml up --build
```
本地构建并运行 release 镜像：
```bash
docker compose -f docker-compose.local.yml up -d --build
```
默认前端端口为 `3000`、后端端口为 `8080`；端口冲突时可通过 `CANVAS_WEB_HOST_PORT` 和 `CANVAS_BACKEND_HOST_PORT` 覆盖。
更多本地开发说明（包括时间线字幕转写）见[本地开发文档](docs/content/docs/backend/local-development.mdx)。
## 架构概览
```text
浏览器（web/）
├─ React 工作区、画布、任务中心和素材库
├─ Zustand / localForage 本地状态与降级缓存
└─ 登录态 API、资源请求和 SSE
│
▼
后端（backend/）
├─ Gin handler -> service -> repository/model
├─ SQLite（本地）或 PostgreSQL + Redis（部署）
├─ 异步任务 worker、权限、资源存储和模型中转
└─ provider / outbound -> 外部模型渠道
```
前端业务 API 统一经 `web/src/services/api/request.ts` 调用。生产环境由 Nginx 托管前端并代理后端，公网只需暴露 web 入口；SSE 仅在明确的流式路径关闭代理缓冲。
## 服务器部署
### 源码构建（推荐）
适用于 Linux 云服务器。脚本会安装 Docker、拉取源码、生成受保护的 `.env`，并启动 PostgreSQL、Redis、后端和网页：
```bash
curl -fsSL https://raw.githubusercontent.com/ddcat-ai/open-ai-canvas/main/scripts/install-server.sh | sudo bash
```
默认访问 `http://服务器IP:3000`。更新或排查：
```bash
cd /opt/open-ai-canvas
sudo docker compose --env-file .env \
-f docker-compose.deploy.yml -f docker-compose.build.yml ps
sudo docker compose --env-file .env \
-f docker-compose.deploy.yml -f docker-compose.build.yml logs -f --tail=200
```
### 使用 GHCR 镜像
不需要源码时，可使用镜像部署脚本：
```bash
curl -fsSL https://raw.githubusercontent.com/ddcat-ai/open-ai-canvas/main/scripts/install-server-image.sh | sudo bash
```
生产环境请在 `/opt/open-ai-canvas/.env` 中将 `CANVAS_IMAGE_TAG` 固定为具体 Release，不要使用 `latest`。更新流程、数据库迁移、备份和回退说明见[系统更新文档](docs/content/docs/backend/system-update.mdx)。
## 安全边界
- 首次管理员注册应在受控网络完成，公网部署保持 `CANVAS_REGISTRATION_ENABLED=false`。
- 设置准确的 `CANVAS_CORS_ORIGINS`，不要在公网使用 `*`；使用 HTTPS 并正确转发代理头。
- 后端默认拒绝本机、私网和链路本地模型地址。开发时只通过 `CANVAS_ALLOWED_PRIVATE_UPSTREAM_HOSTS` 精确放行可信主机，不要使用全量放行开关。
- 用户 API Key 不应出现在 URL、日志、错误上报或服务端长期明文存储中；只在可信部署和 HTTPS 链路中使用真实密钥。
- 后端 `8080` 应留在 Compose 网络内，不要直接暴露到公网；限制 `.env`、数据库、上传目录、备份和 `.settings-key` 的权限。
- 媒体资源可使用后端数据目录、阿里云 OSS 或腾讯云 COS；删除素材前会检查业务引用。
安全问题请按 [`SECURITY.md`](SECURITY.md) 报告，不要在公开 Issue 中粘贴密钥、Cookie、数据库或生产日志。
## 文档与验证
### 文档导航
- [快速开始](docs/content/docs/overview/quick-start.mdx)
- [功能清单](docs/content/docs/overview/features.mdx)
- [代码功能地图](docs/content/docs/backend/code-map.mdx)
- [本地开发](docs/content/docs/backend/local-development.mdx)
- [数据库结构](docs/content/docs/backend/backend-database.mdx)
- [画布操作手册](docs/content/docs/canvas/canvas-node-manual.mdx)
- [插件系统](docs/content/docs/plugins/plugin-system.mdx)
- [待办与待测试](docs/content/docs/progress/todo.mdx) · [待测试清单](docs/content/docs/progress/pending-test.mdx)
- [更新日志](CHANGELOG.md) · [贡献指南](CONTRIBUTING.md) · [上游声明](NOTICE)
### 验证命令
按改动范围运行最小验证：
```bash
# 前端
cd web && bun run lint && bun run build
# 后端
cd backend && go test ./...
# 文档站
cd docs && bun run types:check
```
## 许可证和上游
本项目采用 [MIT](LICENSE) 协议。影策基于 [basketikun/infinite-canvas](https://github.com/basketikun/infinite-canvas) 的早期版本进行二次开发，上游作者和贡献者保留其对应代码的权利与署名。
---
## 贡献者与团队
感谢参与产品设计、开发、测试、内容和社区建设的成员。以下为紧凑展示，完整保留每位成员的头像、昵称、联系方式和个性签名：
<table>
<tr>
<td width="50%" valign="top">
<img src="assets/user-ddcat.jpg" alt="ddCat" width="56" align="left">
<strong>ddCat<br><sub>项目发起者 · 微信：ddcat0829</sub></strong><br>
<a href="mailto:ddcat666@126.com">ddcat666@126.com</a><br>
<em>在计算机里头没有任何黑魔法，所有的东西只不过是我现在不知道而已，总有一天我会把所有的细节、所有的内部的东西全搞明白的。</em>
<br clear="left">
</td>
<td width="50%" valign="top">
<img src="assets/user-sikongyue.png" alt="爱笑的毛毛虫" width="56" align="left">
<strong>爱笑的毛毛虫<br><sub>用户名：sikongyue</sub></strong><br>
<a href="mailto:315515767@qq.com">315515767@qq.com</a><br>
<em>正在啃 main 分支，争取下次 merge 的时候变成蝴蝶</em>
<br clear="left">
</td>
</tr>
<tr>
<td width="50%" valign="top">
<img src="assets/user-delve.jpg" alt="delve-s" width="56" align="left">
<strong>delve-s</strong><br>
<a href="mailto:3013141136@qq.com">3013141136@qq.com</a><br>
<em>我亦无他，惟手熟尔</em>
<br clear="left">
</td>
<td width="50%" valign="top">
<img src="assets/user-CyrusAuyeung.jpg" alt="CyrusAuyeung" width="56" align="left">
<strong>CyrusAuyeung</strong><br>
<a href="mailto:cyrusauyeungho@gmail.com">cyrusauyeungho@gmail.com</a><br>
<em>HKUST(GZ) UG</em>
<br clear="left">
</td>
</tr>
<tr>
<td width="50%" valign="top">
<img src="assets/user-nz.jpg" alt="奶大佬" width="56" align="left">
<strong>奶大佬</strong><br>
<a href="mailto:1304634970@qq.com">1304634970@qq.com</a><br>
<em>人生就是要不断的探索</em>
<br clear="left">
</td>
<td width="50%" valign="top">
<img src="assets/user-dyh.jpg" alt="dyh" width="56" align="left">
<strong>dyh</strong><br>
<a href="mailto:1613203335@qq.com">1613203335@qq.com</a><br>
<em>无</em>
<br clear="left">
</td>
</tr>
<tr>
<td width="50%" valign="top">
<img src="assets/user-kyori.jpg" alt="kyori" width="56" align="left">
<strong>kyori</strong><br>
<a href="mailto:1771634408@qq.com">1771634408@qq.com</a><br>
<em>励志成为未来最好用的画布仓库的贡献者</em>
<br clear="left">
</td>
<td width="50%" valign="top">
<img src="assets/user-bowen.jpg" alt="Bowen" width="56" align="left">
<strong>Bowen</strong><br>
<a href="mailto:admin@bowen.games">admin@bowen.games</a><br>
<em>剑走偏峰，雷厉风行。</em>
<br clear="left">
</td>
</tr>
<tr>
<td width="50%" valign="top">
<img src="assets/user-ken.jpg" alt="ken" width="56" align="left">
<strong>ken</strong><br>
<a href="mailto:2506802@qq.com">2506802@qq.com</a><br>
<em>走自己的路</em>
<br clear="left">
</td>
<td width="50%" valign="top">
<img src="assets/user-fish.png.jpg" alt="fish" width="56" align="left">
<strong>fish</strong><br>
<a href="mailto:cihai.sea@gmail.com">cihai.sea@gmail.com</a><br>
<em>AI 界热于助人的拖油瓶</em>
<br clear="left">
</td>
</tr>
<tr>
<td width="50%" valign="top">
<img src="assets/user-QAyong.jpg" alt="QAyong" width="56" align="left">
<strong>QAyong<br><sub>ID：QAyong<br>B站：QAyong</sub></strong><br>
<a href="mailto:2110491559@qq.com">2110491559@qq.com</a><br>
<em>AI 短剧合规，资产确权</em>
<br clear="left">
</td>
<td width="50%" valign="top">
<img src="assets/user-K37ix.jpg" alt="_K37ix." width="56" align="left">
<strong>_K37ix.</strong><br>
<a href="mailto:2773843782@qq.com">2773843782@qq.com</a><br>
<em>Making things that think</em>
<br clear="left">
</td>
</tr>
<tr>
<td width="50%" valign="top">
<img src="assets/user-rou.jpg" alt="Rou" width="56" align="left">
<strong>Rou</strong><br>
<a href="mailto:rou325089@163.com">rou325089@163.com</a><br>
<em>上善若水</em>
<br clear="left">
</td>
<td width="50%" valign="top">
<img src="assets/user-vv.jpg" alt="vv" width="56" align="left">
<strong>vv<br><sub>dy/xhs：荣灵</sub></strong><br>
<a href="mailto:2838033228@qq.com">2838033228@qq.com</a><br>
<em>就是水水</em>
<br clear="left">
</td>
</tr>
<tr>
<td width="50%" valign="top">
<img src="assets/user-dominic1556.jpg" alt="Dominic1556" width="56" align="left">
<strong>Dominic1556</strong><br>
<a href="mailto:184026530@qq.com">184026530@qq.com</a><br>
<em>Done is better than perfect</em>
<br clear="left">
</td>
<td width="50%" valign="top">
<img src="assets/user-yuxi.jpg" alt="宇熙" width="56" align="left">
<strong>宇熙</strong><br>
<a href="mailto:53121904@qq.com">53121904@qq.com</a><br>
<em>年轻的时候不狂，老了拿什么回忆</em>
<br clear="left">
</td>
</tr>
<tr>
<td width="50%" valign="top">
<img src="assets/user-yingzi.png" alt="影子" width="56" align="left">
<strong>影子</strong><br>
<a href="mailto:305818148@qq.com">305818148@qq.com</a><br>
<em>年纪大佬才明白人要顺势而为。</em>
<br clear="left">
</td>
<td width="50%" valign="top">
<img src="assets/user-ray.jpg" alt="Ray" width="56" align="left">
<strong>Ray</strong><br>
<a href="mailto:cnraylee@qq.com">cnraylee@qq.com</a><br>
<em>AI时代的全栈落地工，欢迎找我聊需求</em>
<br clear="left">
</td>
</tr>
<tr>
<td width="50%" valign="top">
<img src="assets/user-bjsg.jpg" alt="不见山谷" width="56" align="left">
<strong>不见山谷<br><sub>VV：yu170718</sub></strong><br>
<a href="mailto:1762202553@qq.com">1762202553@qq.com</a><br>
<em>空山不见人，但闻人语响</em>
<br clear="left">
</td>
<td width="50%" valign="top">
<img src="assets/user-yep.jpg" alt="yep" width="56" align="left">
<strong>yep</strong><br>
<a href="mailto:1239738103@qq.com">1239738103@qq.com</a><br>
<em>思考，坚持</em>
<br clear="left">
</td>
</tr>
<tr>
<td width="50%" valign="top">
<img src="assets/user-hamburger.jpg" alt="汉堡爸爸" width="56" align="left">
<strong>汉堡爸爸<br><sub>VV：jxs62888</sub></strong><br>
<a href="mailto:309151651@qq.com">309151651@qq.com</a><br>
<em>没什么大不了</em>
<br clear="left">
</td>
<td width="50%" valign="top">
<img src="assets/user-bensharp.jpg" alt="bensharp" width="56" align="left">
<strong>bensharp<br><sub>VV：jiahezuiai</sub></strong><br>
<a href="mailto:275008147@qq.com">275008147@qq.com</a><br>
<em>在哪跌倒，就在哪睡一觉</em>
<br clear="left">
</td>
</tr>
<tr>
<td width="50%" valign="top">
<img src="assets/user-daqzia.jpg" alt="daqzia" width="56" align="left">
<strong>daqzia<br><sub>VV：wangzhiwei-8234</sub></strong><br>
<a href="mailto:wzwzcb@gmail.com">wzwzcb@gmail.com</a><br>
<em>NullPointerException</em>
<br clear="left">
</td>
<td width="50%" valign="top">
<img src="assets/user-xingmeng.jpg" alt="醒梦" width="56" align="left">
<strong>醒梦<br><sub>VV：love-is-heart-is</sub></strong><br>
<a href="mailto:1948863412@qq.com">1948863412@qq.com</a><br>
<em>Always believe that good things will happen</em>
<br clear="left">
</td>
</tr>
<tr>
<td width="50%" valign="top">
<img src="assets/user-morrow.jpg" alt="morrow" width="56" align="left">
<strong>morrow<br><sub>VV：morrow0127</sub></strong><br>
<a href="mailto:3201190041@qq.com">3201190041@qq.com</a><br>
<em>最难不过坚持</em>
<br clear="left">
</td>
<td width="50%" valign="top">
<img src="assets/user-chunqiu.jpg" alt="春秋" width="56" align="left">
<strong>春秋<br><sub>Agent记忆核心贡献者 · VV：A13068788886</sub></strong><br>
<a href="mailto:558328@qq.com">558328@qq.com</a><br>
<br clear="left">
</td>
</tr>
<tr>
<td width="50%" valign="top">
<img src="assets/user-song.jpg" alt="亿媒网老宋" width="56" align="left">
<strong>亿媒网老宋</strong><br>
<a href="mailto:61731514@qq.com">61731514@qq.com</a><br>
<a href="https://em8.top">亿媒网 em8.top</a><br>
<em>全国10W+媒体、自媒体，助力企业品牌传播</em>
<br clear="left">
</td>
</tr>
</table>
Reference in New Issue View Git Blame Copy Permalink