Files
2026-10-09 19:18:33 +08:00

209 lines
6.2 KiB
Python
Raw Permalink 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.
# -*- coding: utf-8 -*-
"""带时间戳的备份工具。任何文档/配置/脚本更新前必须先跑它。
python songforge/tools/backup.py 生歌规则.md LLM_Wiki.md
python songforge/tools/backup.py --note "加 songforge CLI 章节" AGENTS.md
python songforge/tools/backup.py --from-root D:\\CodeFiles\\Thinking\\ComfyUI-MiniMaxH3
python songforge/tools/backup.py --restore bak\\20261004-120000
python songforge/tools/backup.py --list
产物:workflows/bak/<YYYYMMDD-HHMMSS-毫秒>/<原相对路径>
恢复:python songforge/tools/backup.py --restore <备份目录>
坑位记录:
- 早期版本把路径压平成 "目录__文件.bak",文件一多就分不清谁是谁,
且 AGENTS.md 在仓库根、不在 workflows 下,会退化成 ..__..__..__AGENTS.md.bak。
现在保留完整目录树:workflows 内的文件按相对路径存放,
仓库根的文件统一放在 <ROOT>/ 下,一眼能看出来源。
- 路径分隔符统一转成 "/",Windows 与 Linux 读 manifest 结果一致。
"""
import datetime
import json
import os
import shutil
import sys
WF_ROOT = os.path.dirname(os.path.dirname(os.path.dirname(
os.path.abspath(__file__)))) # .../user/default/workflows
BAK = os.path.join(WF_ROOT, "bak")
def stamp():
"""毫秒精度:同一秒内连续备份两次不会互相覆盖。"""
return datetime.datetime.now().strftime("%Y%m%d-%H%M%S-%f")[:-3]
def comfy_root():
"""workflows 的上三级 = ComfyUI 根。"""
return os.path.dirname(
os.path.dirname(
os.path.dirname(WF_ROOT)
)
)
def rel_under(path):
"""返回可还原、正斜杠的相对路径。
- workflows 内:songforge/cli/main.py
- ComfyUI 根: ROOT__/AGENTS.md
- 根之外: ABS__/D/somewhere/file.md
"""
path = os.path.abspath(path)
for base, prefix in ((WF_ROOT, ""), (comfy_root(), "ROOT__/")):
rel = os.path.relpath(path, base)
if not rel.startswith(".."):
return prefix + rel.replace(os.sep, "/")
rel = path.replace(":", "").replace(os.sep, "/").lstrip("/")
return "ABS__/" + rel
def backup(paths, note=""):
"""复制文件到 bak/<时间戳>/,保留原目录树,返回备份目录。"""
# 坑位:原来用 exist_ok=True,同一毫秒内连续两次备份会落进同一目录,
# 上一次的 _manifest.json 直接被覆盖,恢复时就少了一份。改成原子创建。
base = stamp()
for n in range(0, 100):
cand = os.path.join(BAK, base if n == 0 else "%s-%d" % (base, n + 1))
try:
os.makedirs(cand, exist_ok=False)
dst_dir = os.path.abspath(cand)
break
except FileExistsError:
continue
else:
raise RuntimeError("无法在 %s 下分配备份目录" % BAK)
items = []
for p in paths:
p = os.path.abspath(p)
if not os.path.exists(p):
print(" [skip] 不存在: %s" % p)
continue
rel = rel_under(p)
dst = os.path.join(dst_dir, *rel.split("/"))
os.makedirs(os.path.dirname(dst), exist_ok=True)
shutil.copy2(p, dst)
items.append(dict(src=p, bak=dst, rel=rel,
size=os.path.getsize(dst)))
print(" [ok] %s" % rel)
with open(os.path.join(dst_dir, "_manifest.json"), "w",
encoding="utf-8") as f:
json.dump(dict(stamp=os.path.basename(dst_dir), note=note,
items=items), f, ensure_ascii=False, indent=1)
print("备份完成 -> %s (%d 个文件)" % (dst_dir, len(items)))
return dst_dir
def restore(bak_dir):
"""按 manifest 把文件拷回原位。"""
bak_dir = os.path.abspath(bak_dir)
mpath = os.path.join(bak_dir, "_manifest.json")
if not os.path.exists(mpath):
print("找不到 manifest: %s" % mpath)
return 1
with open(mpath, encoding="utf-8") as f:
m = json.load(f)
for it in m["items"]:
if not os.path.exists(it["bak"]):
print(" [miss] 备份件丢失: %s" % it["bak"])
continue
os.makedirs(os.path.dirname(it["src"]), exist_ok=True)
shutil.copy2(it["bak"], it["src"])
print(" [restore] %s" % it["rel"])
print("恢复完成 <- %s" % bak_dir)
return 0
def list_bak():
if not os.path.isdir(BAK):
print("还没有任何备份: %s" % BAK)
return 1
rows = []
for name in sorted(os.listdir(BAK), reverse=True):
mp = os.path.join(BAK, name, "_manifest.json")
if not os.path.isfile(mp):
continue
with open(mp, encoding="utf-8") as f:
m = json.load(f)
rows.append((name, len(m.get("items", [])), m.get("note", "")))
if not rows:
print("备份目录为空: %s" % BAK)
return 1
for name, n, note in rows:
print(" %s %2d 个 %s" % (name, n, note))
return 0
def _expand(root, patterns):
out = []
for pat in patterns:
full = os.path.join(root, pat.replace("/", os.sep))
if os.path.isdir(full):
for dirpath, _, files in os.walk(full):
for fn in files:
if fn.endswith(".pyc"):
continue
out.append(os.path.join(dirpath, fn))
else:
out.append(full)
return out
def main(argv):
if not argv:
print(__doc__)
return 1
if argv[0] in ("-h", "--help"):
print(__doc__)
return 0
if argv[0] == "--restore":
if len(argv) < 2:
print(__doc__)
return 1
return restore(argv[1])
if argv[0] == "--list":
return list_bak()
note = ""
root = None
while argv and argv[0].startswith("--"):
opt = argv[0]
if opt == "--note" and len(argv) >= 2:
note = argv[1]
argv = argv[2:]
elif opt == "--from-root" and len(argv) >= 2:
root = os.path.abspath(argv[1])
argv = argv[2:]
else:
print("未知参数: %s" % opt)
print(__doc__)
return 1
if not argv:
print(__doc__)
return 1
backup(_expand(root, argv) if root else argv, note)
return 0
if __name__ == "__main__":
sys.exit(main(sys.argv[1:]))