update-nexus

更新 Nexus

目的：从上游 Nexus 仓库同步系统文件，同时保护用户数据

触发语句："update nexus"、"sync nexus"、"get updates"、"check for updates"

耗时：1–2 分钟

---

功能说明

从上游更新以下系统文件：

• 00-system/ - 核心框架、技能、文档
• CLAUDE.md - 入口文件
• README.md - 项目说明文件

保护以下用户文件夹（绝不会触碰）：

• 01-memory/ - 你的目标、经验和配置
• 02-projects/ - 你的项目
• 03-skills/ - 你的自定义技能
• 04-workspace/ - 你的文件
• .env、.claude/ - 你的机密信息和设置

---

工作流

步骤 1：检查更新

运行更新检查：

python 00-system/core/nexus-loader.py --check-update

解析 JSON 响应：

• 如果 checked: false 且有错误 → 显示错误，然后正常退出
• 如果 update_available: false → 显示“已是最新版本！”，然后退出
• 如果 update_available: true → 继续执行步骤 2

步骤 2：显示变更内容

向用户显示：

UPDATE AVAILABLE

Current version: {local_version}
New version:     {upstream_version}

Files to update ({changes_count}):
{list changed_files, max 20}

PROTECTED (will NOT be touched):
- 01-memory/    (your goals & config)
- 02-projects/  (your projects)
- 03-skills/    (your custom skills)
- 04-workspace/ (your files)

步骤 3：征求用户确认

询问：“是否继续更新？（yes/no）”

• 如果回答 no → 显示“更新已取消”，然后退出
• 如果回答 yes → 继续执行步骤 4

步骤 4：执行同步

运行同步命令：

python 00-system/core/nexus-loader.py --sync --force

解析 JSON 响应：

• 如果 success: false → 显示错误消息并建议解决方法
• 如果 success: true → 继续执行步骤 5

步骤 5：显示结果

成功后，显示：

UPDATE COMPLETE!

{local_version} → {upstream_version}

Updated paths:
{list files_updated}

Backup saved to: {backup_path}

To commit this update:
  git add . && git commit -m "Update Nexus to v{upstream_version}"

---

错误处理

错误	提示用户的消息
"Not a git repository"	"此文件夹不是 Git 仓库。请使用以下命令初始化：git init"
"Could not reach upstream"	"无法连接到 GitHub。请检查你的网络连接。"
"Uncommitted changes detected"	"你有尚未提交的更改。请先提交：\n git add . && git commit -m 'Save changes'"
"Could not read upstream version"	"上游仓库可能未正确配置。请检查 user-config.yaml 中的 URL"

---

高级用法：试运行

若要预览更改但不应用：

python 00-system/core/nexus-loader.py --sync --dry-run

这会显示将要发生的更改，但不会实际更改任何内容。

---

备注

• 备份：每次同步前，当前系统文件都会备份到 .sync-backup/{timestamp}/
• 安全：用户数据文件夹绝不会包含在同步路径中，因此不会被触碰
• 上游远程仓库：首次使用时自动添加（名称为 "upstream"）
• 默认 URL：https://github.com/beamanalytica/Nexus-v4.git（可在 user-config.yaml 中覆盖）