From b234a19604c948ad0aec2dfaba9df6f69bb50fd3 Mon Sep 17 00:00:00 2001
From: Derryyyyyy <98146773+Derryyyyyy@users.noreply.github.com>
Date: Sat, 28 Feb 2026 19:52:42 +0800
Subject: [PATCH] Update README.md
---
README.md | 49 ++++++++++++++++++++++++++++++++++++++++---------
1 file changed, 40 insertions(+), 9 deletions(-)
diff --git a/README.md b/README.md
index 4024715..dbbee76 100644
--- a/README.md
+++ b/README.md
@@ -15,8 +15,7 @@
| | |
---
-
-## 🇨🇳 中文说明 (Chinese)
+## 🇨🇳 中文说明
### 💡 开发背景
目前的数字人(Digital Human)和 AI 生成视频技术在生成人物时非常逼真,但由于镜头轨迹往往过于死板、完美,容易产生一种“电子僵硬感”,缺乏真实拍摄的生命力。
@@ -29,22 +28,54 @@
* **高保真度**:提供平滑、无锐角的呼吸感运镜,模拟真实的人体肌肉控制感。
### ⚙️ 参数说明
-* **intensity (强度)**:默认 **0.40**。
-* **zoom_factor (缩放)**:默认 **1.05**。
-* **fps (帧速率)**:视频的帧率。
-* **seed (随机种子)**:轨迹随机种子。
+* **intensity (强度)**:默认 **0.40**,控制晃动剧烈程度。
+* **zoom_factor (缩放)**:默认 **1.05**,位移后的边缘保护。
+* **fps (帧速率)**:视频的帧率,用于辅助计算运动周期。
+* **seed (随机种子)**:决定运动轨迹的初始形态。
+
+### 📥 安装方法
+1. **Git Clone (推荐)**:
+ 进入 ComfyUI 的 `custom_nodes` 文件夹运行:
+ `git clone https://github.com/Derryyyyyy/ComfyUI-DNode.git`
+2. **手动安装**:
+ 在 `custom_nodes` 下新建名为 `ComfyUI-DNode` 的文件夹,将 `__init__.py` 放入其中。
+
+### 💡 使用方法
+* 在 ComfyUI 中右键选择:`DNode` -> `🎥 Lissajous Camera Shake (V1)`。
+* 将视频帧序列连接至 `images` 输入端即可。
+
+
---
## 🇬🇧 English Documentation
### 💡 Background
-Current Digital Human and AI video generation technologies produce realistic characters, but outputs often feel "stiff" due to static camera movements. **Lissajous Camera Shake** injects authenticity into virtual videos by simulating subtle handheld tremors.
+Current Digital Human and AI video technologies produce realistic characters, but the outputs often feel "stiff" due to overly static or perfect camera movements.
+
+**Lissajous Camera Shake** is designed to solve this problem. By simulating the subtle muscle tremors of a real handheld camera, it injects "presence" into virtual videos, significantly enhancing realism.
### 🌟 Core Features
-* **Smooth Motion**: Uses Lissajous algorithm to generate organic trajectories.
-* **Center Aligned**: Ensures the camera drifts around the absolute center.
+* **Smooth Motion**: Based on the Lissajous algorithm, generating organic trajectories via superimposed low-frequency sine waves.
+* **Center Aligned**: Ensures the camera always drifts around the absolute center, preventing frame deviation.
+* **High Fidelity**: Provides smooth, organic camera movement simulating natural human muscle control.
+### ⚙️ Parameters
+* **intensity**: Default **0.40**. Controls the magnitude of the shake.
+* **zoom_factor**: Default **1.05**. Edge protection for frame shifting.
+* **fps**: Frame rate used for calculating physical motion cycles.
+* **seed**: Determines the unique initial state of the trajectory.
+
+### 📥 Installation
+1. **Git Clone (Recommended)**:
+ Run in your ComfyUI `custom_nodes` folder:
+ `git clone https://github.com/Derryyyyyy/ComfyUI-DNode.git`
+2. **Manual Installation**:
+ Create a folder named `ComfyUI-DNode` in `custom_nodes` and place `__init__.py` inside.
+
+### 💡 Usage
+* Find the node in the menu: `DNode` -> `🎥 Lissajous Camera Shake (V1)`.
+* Connect your video frame sequence to the `images` input.
---
### 📥 安装方法 (Installation)