# tapnow

**Repository Path**: north_arrow_moon/tapnow

## Basic Information

- **Project Name**: tapnow
- **Description**: tapnow费用太高，复刻一个本地版本，自己调用api。
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-18
- **Last Updated**: 2026-04-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
  <img src="public/TapNow-logo.png" alt="TapNow Logo" width="120" />
  <h1>TapNow</h1>
  <p>现代 AI 工作流画布引擎 | v0.3.5</p>
</div>

## 🚀 快速开始 (Quick Start)

01.node-v20.11.1-x64.msi

02.python-3.10.10-amd64.exe（请务必勾选 **"Add Python to PATH"**）

start-app.bat

### 🤖 当前支持模型 (Supported Models)

#### **即梦 (Jimeng)**
- 图像生成：
  - 即梦AI-图片生成 3.0
  - 即梦AI-图片生成 3.1
- [获取密钥](https://console.volcengine.com/iam/keymanage)
- [模型开通](https://console.volcengine.com/ai/ability/detail/2)

#### **豆包 (Doubao)**
- 文本模型：
  - Doubao-Seed-2.0-mini
- 图像模型：
  - Doubao-Seedream 4.0
  - Doubao-Seedream 4.5
  - Doubao-Seedream 5.0-lite
- 视频模型：
  - Doubao-Seedance 1.5-pro
  - Doubao-Seedance 2.0-fast
  - Doubao-Seedance 2.0
- [获取密钥](https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey)
- [模型开通](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=model)

#### **谷歌香蕉 (Gemini)** 需要翻墙才能使用
- 图像预览：
  - Nano Banana 2   (gemini-3.1-flash-image-preview)
  - Nano Banana Pro (gemini-3-pro-image-preview)
- [获取密钥](https://aistudio.google.com/api-keys)

---

## 📂 项目结构 (Project Structure)

```text
TapNow/
├── docs/               # 技术文档库（架构设计、API 指南、版本变更、部署说明）
├── library/            # 本地持久化存储 (物理隔离)
│   ├── media/          # 媒体资产 (包含项目 JSON 与对应的素材文件夹)
│   └── assets/         # 资产库收藏索引与元数据 (Metadata)
├── server/             # Express.js 后端服务
│   ├── agent/          # AI 智能代理 (基于 LangGraph.js 的多模态对话系统)
│   ├── comfyui/        # ComfyUI 分布式调度集成层
│   │   ├── comfyClient.js  # [核心] WebSocket 双向通信与任务队列管理
│   │   └── workflows/      # [业务] 工作流 JSON 模板及对应的参数映射处理器 (camera, upscale)
│   ├── providers/      # 多模型适配器 (即梦、豆包、Gemini 等 API 协议封装)
│   ├── routes/         # API 路由分发 (生成任务、画布存取、配置管理)
│   └── utils/          # 后端工具类 (图像处理、坐标转换、文件系统操作)
└── src/                # React & TypeScript 前端工程
    ├── components/     # UI 组件库
    │   ├── canvas/     # 无限画布核心域
    │   │   ├── base/       # 底层渲染层 (NodeWrapper, ConnectionsLayer, Minimap)
    │   │   ├── camera/     # [ComfyUI] 3D 摄像机交互控制面板
    │   │   ├── upscale/    # [ComfyUI] 4K 高清放大参数调节面板
    │   │   ├── nodes/      # 业务节点定义 (Text, Image, Video, Audio)
    │   │   └── features/   # 画布功能组件 (标注工具、提及编辑器、连线逻辑)
    │   ├── dashboard/  # 项目管理仪表盘
    │   └── modals/     # 全局模态框 (设置中心、素材创建)
    ├── hooks/          # 核心业务 Hook (状态管理、生成调度、画布导航逻辑中心)
    ├── services/       # 前端服务层 (API 请求封装、WebSocket 监听、资产上传)
    ├── config/         # 静态配置中心 (模型注册表、计费单价、分辨率限制)
    └── types.ts        # 全局 TypeScript 类型定义与接口声明
```

## ✨ 核心特性 (Key Features)

### 🎨 节点式创作流
- **无限画布界面** - 拖拽式节点工作流，支持平移、缩放与智能连接。
- **外部视频 URL 加载 (New)** - 支持通过网络地址直接加载视频，系统自动识别原始比例并调整卡片尺寸，无需手动调整。
- **高保真图片标注与裁切 (New)** - 全屏画布支持画笔、矩形、橡皮擦；新增 **全能裁切工具**，支持 8 点位调整、等比例锁定及 **多宫格自动拆分** 布局。
- **叠层多图管理** - 生成多张图片时自动执行“扇形堆叠”，支持一键设为主图与比例同步预览。
- **项目冗余清理 (New)** - 橡皮擦式一键清理，智能扫描并删除项目中未被引用的过期素材，节省磁盘空间。
- **智能节点排列** - 选中节点按下 **L** 键即可根据包围盒自动执行横向或竖向排列。
- **全域快捷操作** - 支持 **Ctrl + S** (快速保存)、**F** (智能聚焦选中/全场)、**Del** (删除) 等高效快捷键。
- **沉浸式 UI 交互** - 节点标题与组标签统一采用纯净中文加粗样式；功能区仅在选中时弹出，平移时自动隐藏。
- **多模态文本输入** - 集成 Tiptap 编辑器，支持原生富文本编辑、**非文本区拖拽**、**鼠标框选文本**与 **@ 智能素材引用**。
- **智能提示词预设库 (New)** - 输入 `、` 触发。支持显性标题标签展示、隐性长文本存储，配备 4 列超大网格预览、悬停视频播放及自适应上方弹出逻辑。
- **交互保护机制** - 中键平移具有最高优先级；支持非法连线实时拦截与模型模式自适应连接修剪。
- **视频截图流** - 支持从视频卡片中实时截取当前帧并自动生成连接的图片节点，实现“视频 -> 关键帧 -> 图像编辑/生成”的无缝衔接。

### ⚙️ 集成化设置中心
- **密钥可视化管理** - 告别手动编辑 `.env`。通过 UI 界面直接配置即梦、豆包、可灵、谷歌 Gemini 等厂商 API 密钥，支持掩码保护与一键跳转获取。
- **网络地址与代理** - 专用“网络地址”标签页，统一管理服务器 IP、端口、ComfyUI 算力节点及 **HTTPS 代理** 配置，支持即时生效无需重启。
- **支持模型查阅** - 分类展示（图像/视频/文本）当前系统支持的所有 AI 模型，包含详细的 ID、单价及耗时估算。
- **扁平化专业设计** - 采用高密度、扁平化 UI 布局，在大屏幕下依然保持极佳的阅读与操作体验。

### 🤖 多模型 AI 集成
- **物理级项目隔离 (New)** - 历史记录仅扫描当前项目物理目录 (`library/media/{projectId}`)，支持万级文件下的极速响应。
- **谷歌 Gemini** - 深度集成 **Gemini Nano Banana 2/Pro** 模型，支持 1K/2K/4K 高清生成、联网搜索与多图参考。
- **多模态文本理解** - 接入 **豆包 (Doubao) 2.0-mini**，支持以图片、视频作为上下文进行对话与内容分析。
- **旗舰级图像生成** - 接入 **即梦 (Jimeng) 4.0, 4.5 & 5.0**，支持多图参考、联网搜索与 4K 超清。
- **数据驱动连线限制** - 基于 `modelConfig.ts` 动态管理 `maxInputs` 与 `allowedInputs`，精准控制不同模式下的输入类型与数量。
- **智能模式探测** - 连线时自动探测兼容模式。例如从图片连向“文本输入”或“文生图”节点时，卡片将自动适配并切换至兼容模式。
- **视频生成** - 接入 Veo 3.1, Kling V1-V2.6 Master, 海螺 2.3/O2, 即梦 1.5 Pro。
- **3D 摄像机控制** - 通过交互式 3D 视口实现旋转、倾斜与焦距缩放，支持自动提示词映射。
- **4K 高清放大 (New)** - 集成 ComfyUI Upscale 工作流，支持 2X/4X/6X/8X 阶梯放大，自动识别原图比例并生成高清结果。

### 📊 生产力与成本控制
- **阶梯计费系统 (Refactored)** - 统一图片与视频模型的 `cost` 计费架构，支持按分辨率（512/1K/2K/4K）分级计费，实时预览生成开销。
- **智能生成恢复 (Optimized)** - 优化了后端任务追踪与前端恢复逻辑，彻底解决服务器重启或网络波动后的状态挂起与重复刷屏问题。
- **自动环境配置 (New)** - 系统启动时自动检测并安装缺失依赖（如 `undici`），实现“开箱即用”的代理支持。
- **全局超时管控 (Global Timeout)** - 基于配置中的 `timeEstimate` 自动应用生成超时限制，支持语义化时间解析（如 "2min", "10s"）。
- **AI 聊天助手** - 基于 LangGraph 代理的对话式引导，支持上下文感知与素材联想。
- **可视化指引** - 独立的快捷键提示系统，随时悬停查阅操作指南。

---