docs: warn that ComfyUI-Manager deletes through a symlinked dev copy
The working tree was symlinked into custom_nodes for pre-publish testing. Manager's remove/replace path runs shutil.rmtree on the resolved path, so it deleted the target's contents rather than unlinking the symlink -- wiping this tree, .git included. Recovered by re-cloning; nothing was lost because everything was pushed. Updates the local-environment section to describe the post-publish arrangement (Manager install under the lowercase registry id) and to require tearing down any dev symlink before touching Manager. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CdgKVDqEbD14EJ4RC3GPmg
This commit is contained in:
co-authored by
Claude Opus 5
parent
877a5ad776
commit
2d740a2b80
@@ -18,18 +18,25 @@ Registered through ComfyUI's **V3 schema API**, not the legacy
|
||||
|
||||
- ComfyUI checkout: `/home/dreevelle/comfy/ComfyUI`
|
||||
- Python venv: `/home/dreevelle/comfy-env/bin/python`
|
||||
- `ComfyUI/custom_nodes/ComfyUI-ResolutionTools` is a **symlink to this working
|
||||
tree**, so edits are live on the next server restart:
|
||||
- The package is published, and `ComfyUI/custom_nodes/comfyui-resolution-tools`
|
||||
(lowercase, the registry id) is a **ComfyUI-Manager install** that tracks
|
||||
registry releases. This working tree is not wired into ComfyUI.
|
||||
|
||||
```bash
|
||||
ln -sfn /home/dreevelle/Projects/ComfyUI-ResolutionTools \
|
||||
/home/dreevelle/comfy/ComfyUI/custom_nodes/ComfyUI-ResolutionTools
|
||||
```
|
||||
To test a change before releasing it, symlink this tree in under its CamelCase
|
||||
name so it doesn't collide with the Manager install:
|
||||
|
||||
This is the pre-publish testing setup. Once the package is on the registry,
|
||||
swap the symlink for an independent clone of the GitHub remote (the
|
||||
FastImageSequence arrangement) so the installed copy tracks releases rather
|
||||
than the working tree.
|
||||
```bash
|
||||
ln -sfn /home/dreevelle/Projects/ComfyUI-ResolutionTools \
|
||||
/home/dreevelle/comfy/ComfyUI/custom_nodes/ComfyUI-ResolutionTools
|
||||
```
|
||||
|
||||
**Remove that symlink before doing anything in ComfyUI-Manager for this
|
||||
package.** Manager's remove/replace path does `shutil.rmtree` on the *resolved*
|
||||
path, so it deletes the symlink target's contents instead of unlinking — on
|
||||
2026-08-09 that wiped this working tree, `.git` included, and it had to be
|
||||
restored by re-cloning. Commit and push before any Manager operation, and never
|
||||
leave a symlinked dev copy in place while installing or updating the published
|
||||
version.
|
||||
|
||||
## Verifying changes
|
||||
|
||||
|
||||
Reference in New Issue
Block a user