Comfyui side automatic update SD-PPP:
CCXRepoUpdaterNode monitors one GitHub repository for a ComfyUI custom node and, when updating is enabled, attempts to bring its local copy up to date. It checks the local Git repository for changes available from its remote source, clones the repository if its local folder does not exist, and reports the result as readable status text. This can help you maintain a custom node without manually running Git commands. Each run replaces the updater’s previously saved repository entry with the repository specified for that run, so it is intended to manage one repository at a time.
Comfyui side automatic update SD-PPP Input Parameters:
repo_url
A single-line STRING containing the repository address, such as https://github.com/user/repo.git. The node uses the second part of the URL path as the local folder name under ComfyUI’s custom_nodes directory and targets the repository’s main branch. Enter the address of the repository you intend to install or update; an empty value returns an error. Default: empty string. Minimum and maximum length: not specified in the node interface. The source does not perform a separate URL-validity check before saving the repository entry, so an incorrectly formatted address may produce a later Git or connection error.
auto_update
A BOOLEAN that controls whether the node may update the repository after checking it. When True, the node attempts to clone a missing local repository or update an existing one if the check finds an update. When False, the check reports that automatic updating is disabled and does not update the repository. Options: True or False. Default: True. Minimum and maximum: not applicable to a Boolean.
force_override
A BOOLEAN passed to the update operation when an update is attempted. If an initial git pull fails, enabling this option allows the updater to try discarding local changes and cleaning untracked files before retrying. It can therefore remove work or files in the repository folder; leave it off unless you have backed up anything you need to keep. It does not cause an update when no update is detected or when auto_update is off. Options: True or False. Default: False. Minimum and maximum: not applicable to a Boolean. Even with this option off, the updater may try to discard local changes when Git reports that they would be overwritten by a merge.
Comfyui side automatic update SD-PPP Output Parameters:
Status
A STRING describing the outcome of this run. It may report a successful update, a failed update with a reason, an empty repository address, or the result of checking the local repository. For example, ✅ repo: 更新成功 [自动更新: 开启] indicates a successful update, while ``❌ repo: 更新失败
- ... [自动更新: 开启]
indicates that the attempt failed.repo 检查成功,[自动更新: 开启]`` means the local Git check completed without detecting that its branch is behind; it is not a guarantee that every possible remote change was checked. When automatic updating is disabled, the status reports that setting rather than installing or updating the repository.
Comfyui side automatic update SD-PPP Usage Tips:
- Enter the repository’s intended GitHub URL and confirm that the branch you need is
main; the node does not expose a branch selector. - Use one repository per run. Running the node with a different URL replaces the previously saved repository entry in the updater’s configuration.
- Keep
auto_updateset toFalsewhen you do not want the node to install or change local files. Set it toTrueonly when you are ready for an update attempt. - Leave
force_overrideset toFalsefor normal operation. Back up local edits and untracked files before attempting an update, because the updater can discard local changes after a particular Git conflict even when this setting is off. - Ensure Git is installed and the repository is accessible from the machine running ComfyUI. Existing repositories are checked with local Git commands; the node needs Git to clone or pull them.
- Read the
Statusresult after each run. A check failure, a successful check, and a successful update are different outcomes.
Comfyui side automatic update SD-PPP Common Errors and Solutions:
错误:仓库URL不能为空
- Explanation: The
repo_urlfield is empty, so the node has no repository to check. - Solution: Enter the full repository URL and run the node again.
❌ repo: git fetch失败 [自动更新: 开启]
- Explanation: Git could not fetch information for the existing local repository. The status may instead show
[自动更新: 禁用]if that setting is off. - Solution: Check the machine’s network connection, repository access, and the existing repository’s configured remote address. If the repository is private, confirm that Git has the required credentials.
❌ repo: 本地git操作异常 [自动更新: 开启]
- Explanation: An exception occurred while checking the existing local repository with Git.
- Solution: Confirm that Git is installed and usable by ComfyUI, and that the repository folder is accessible. Check the ComfyUI console for any additional diagnostic information.
❌ repo: 检查更新异常 [自动更新: 开启]
- Explanation: The update check encountered an unexpected error. The node reports a short message rather than the underlying exception.
- Solution: Verify the local repository folder and Git installation, then retry. If the error persists, inspect the ComfyUI console and the repository’s Git state.
❌ repo: 更新失败 - 克隆失败: …
- Explanation: The local repository folder did not exist, and Git could not clone the configured repository and
mainbranch. The text after the colon comes from Git. - Solution: Check the URL, confirm that the repository has a
mainbranch, verify access permissions and network connectivity, and ensure ComfyUI can write tocustom_nodes.
❌ repo: 更新失败 - 更新失败: …
- Explanation: The local folder exists, but
git pullfailed for a reason the updater did not handle by retrying. Git’s error text follows the final colon. - Solution: Read that error for the specific cause. Check the repository’s branch and remote configuration, access credentials, and any local changes before trying again.
❌ repo: 更新失败 - 放弃更改后更新仍失败: …
- Explanation: Git reported a local-change conflict, the updater attempted to discard changes, and its second
git pullstill failed. - Solution: Do not repeatedly rerun the update without inspecting the repository. Review the Git error, confirm the branch and remote are correct, and restore any needed local work from your backup.
❌ repo: 更新失败 - 强制清理失败: …
- Explanation: During a forced cleanup attempt,
git clean -fdfailed while removing untracked files or folders. - Solution: Check file permissions and whether another process is using files in the repository folder. Back up anything important before attempting cleanup again.
❌ repo: 更新失败 - 放弃本地更改失败: …
- Explanation: The updater could not complete the Git checkout it uses to discard local changes before retrying.
- Solution: Inspect the repository’s Git state and file permissions. Preserve any local work you need, then resolve the Git problem before rerunning the node.
❌ repo: 更新失败 - 更新异常: …
- Explanation: An unexpected exception interrupted the update operation. The status includes the exception text after the final colon.
- Solution: Use that text to identify the immediate cause, then check Git, repository access, network connectivity, and write permissions.
错误:无法找到仓库信息
- Explanation: After saving the repository entry, the node could not find an entry matching the folder name it derived from the URL.
- Solution: Check that the URL has the expected owner and repository path, then rerun the node. If the problem persists, inspect the updater’s saved configuration.
