用途:备份与恢复本地知识库。该技能提供备份(把知识库快照推送到 GitHub 私有仓库)和恢复(在新设备上拉取并还原知识库)两项核心功能。
主要能力:备份对象包括 knowledge-base/.md、knowledge-base/_index.json、experience/.md、experience/_index.json,以及 backup/chroma_export.jsonl(ChromaDB 条目的可移植 JSONL 导出,仅含 id、text、metadata,不含二进制向量)。不备份 .venv/ 和 chroma_hybrid_db/,因为它们是机器生成、可在恢复后重建。脚本直接驱动 git init/add/commit/push,首次备份会自动创建 GitHub 私有仓库。
使用方式:需先安装 chroma-hybrid-search 技能的 .venv 与 requirements.txt(共用同一虚拟环境),并安装 git 与 GitHub CLI,执行一次 gh auth login。命令中的 <PY> 为虚拟环境 Python,Windows PowerShell 为 & "$HOME.deep-memory.venv\Scripts\python",Linux/macOS 为 ~/.deep-memory/.venv/bin/python。默认工作区为 ~/.deep-memory,可用 DEEP_MEMORY_WORKSPACE 环境变量或 --workspace 参数覆盖。备份命令示例:<PY> skills/memory-backup/scripts/backup.py,支持 --message、--visibility public、--repo 参数,--repo 默认为 deep-memory-knowledge。恢复命令:<PY> skills/memory-backup/scripts/restore.py,默认安全模式仅复制本地缺失文件;加 --overwrite 则完全替换本地知识库;可用 --workspace 指定目标目录,恢复后需运行 <PY> skills/chroma-hybrid-search/scripts/update_db.py 重建本地向量索引。
限制:推送前会检查远端是否含本地没有的提交,若远端领先则中止而非强制覆盖,需先运行 restore.py 再重新备份。具体安装细节可参考 skills/chroma-hybrid-search/SKILL.md。