update-nexus

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Update Nexus

更新Nexus

Purpose: Sync system files from the upstream Nexus repository while protecting user data

Trigger: "update nexus", "sync nexus", "get updates", "check for updates"

Duration: 1-2 minutes

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

触发指令："update nexus"、"sync nexus"、"get updates"、"check for updates"

耗时：1-2分钟

What This Does

功能说明

Updates these system files from upstream:

```
00-system/
```
- Core framework, skills, documentation
```
CLAUDE.md
```
- Entry point
```
README.md
```
- Project readme

Protects these user folders (NEVER touched):

```
01-memory/
```
- Your goals, learnings, config
```
02-projects/
```
- Your projects
```
03-skills/
```
- Your custom skills
```
04-workspace/
```
- Your files
```
.env
```
,
```
.claude/
```
- Your secrets and settings

更新来自上游的以下系统文件：

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

保护以下用户文件夹（绝不会被改动）：

```
01-memory/
```
- 您的目标、学习记录、配置
```
02-projects/
```
- 您的项目
```
03-skills/
```
- 您的自定义技能
```
04-workspace/
```
- 您的文件
```
.env
```
,
```
.claude/
```
- 您的密钥和设置

Workflow

操作流程

Step 1: Check for Updates

步骤1：检查更新

Run the update check:

bash

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

Parse the JSON response:

If
```
checked: false
```
with error → Display error, exit gracefully
If
```
update_available: false
```
→ Display "Already up-to-date!", exit
If
```
update_available: true
```
→ Continue to Step 2

运行更新检查命令：

bash

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

解析JSON响应：

如果返回
```
checked: false
```
且带有错误信息 → 显示错误并优雅退出
如果
```
update_available: false
```
→ 显示“当前已是最新版本！”并退出
如果
```
update_available: true
```
→ 继续执行步骤2

Step 2: Show What Will Change

步骤2：展示变更内容

Display to user:

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)

向用户展示：

发现可用更新

当前版本：{local_version}
新版本：     {upstream_version}

待更新文件（共{changes_count}个）：
{列出变更文件，最多显示20个}

受保护内容（不会被改动）：
- 01-memory/    (您的目标与配置)
- 02-projects/  (您的项目)
- 03-skills/    (您的自定义技能)
- 04-workspace/ (您的文件)

Step 3: Confirm with User

步骤3：确认用户意愿

Ask: "Proceed with update? (yes/no)"

If no → Exit with "Update cancelled"
If yes → Continue to Step 4

询问：“是否继续更新？(yes/no)”

如果用户选择no → 显示“更新已取消”并退出
如果用户选择yes → 继续执行步骤4

Step 4: Perform Sync

步骤4：执行同步

Run the sync command:

bash

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

Parse the JSON response:

If
```
success: false
```
→ Display error message, suggest fixes
If
```
success: true
```
→ Continue to Step 5

运行同步命令：

bash

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

解析JSON响应：

如果
```
success: false
```
→ 显示错误信息并建议修复方案
如果
```
success: true
```
→ 继续执行步骤5

Step 5: Display Results

步骤5：展示结果

On success, display:

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}"

更新成功后，显示：

更新完成！

版本从 {local_version} 升级至 {upstream_version}

已更新路径：
{列出已更新文件}

备份已保存至：{backup_path}

如需提交本次更新，请执行：
  git add . && git commit -m "Update Nexus to v{upstream_version}"

Error Handling

错误处理

Error	User Message
"Not a git repository"	"This folder isn't a git repo. Initialize with: git init"
"Could not reach upstream"	"Can't connect to GitHub. Check your internet connection."
"Uncommitted changes detected"	"You have uncommitted changes. Commit them first:\n git add . && git commit -m 'Save changes'"
"Could not read upstream version"	"The upstream repo might not be set up correctly. Check the URL in user-config.yaml"

错误信息	向用户展示的提示
"Not a git repository"	"当前文件夹不是Git仓库，请先执行初始化：git init"
"Could not reach upstream"	"无法连接到GitHub，请检查您的网络连接。"
"Uncommitted changes detected"	"您存在未提交的变更，请先提交：\n git add . && git commit -m '保存变更'"
"Could not read upstream version"	"上游仓库可能配置不正确，请检查user-config.yaml中的URL。"

Advanced: Dry Run

进阶操作：试运行

To preview changes without applying:

bash

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

This shows what WOULD change, but doesn't change anything.

如需预览变更而不实际执行更新：

bash

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

该命令会展示将会发生的变更，但不会对任何文件进行修改。

Notes

注意事项

Backup: Before any sync, your current system files are backed up to
```
.sync-backup/{timestamp}/
```
Safe: User data folders are NEVER in the sync paths - they cannot be touched
Upstream Remote: Automatically added on first use (named "upstream")
Default URL: https://github.com/beamanalytica/Nexus-v4.git (can override in user-config.yaml)

备份机制：在执行任何同步操作前，当前系统文件会被备份至
```
.sync-backup/{timestamp}/
```
安全性：用户数据文件夹绝不会被纳入同步路径——它们不会被任何操作改动
上游远程仓库：首次使用时会自动添加（命名为“upstream”）
默认URL：https://github.com/beamanalytica/Nexus-v4.git（可在user-config.yaml中修改）