✅ 安装基础依赖
✅ 安装 NVM
✅ 安装 Node 24
✅ 安装 opencodex
✅ 恢复 .opencodex
✅ 恢复 .codex
✅ 恢复 systemd 服务
✅ 启动 opencodex
✅ 检查状态

一、创建脚本

新 VPS：

nano /root/restore-opencodex.sh

粘贴：

!/bin/bash

set -e

BACKUP_FILE="$1"

if [ -z "$BACKUP_FILE" ]; then
echo "用法:"
echo "bash restore-opencodex.sh backup.tar.gz"
exit 1
fi

echo "=============================="
echo " OpenCodex Auto Restore"
echo "=============================="

echo "[1/8] 更新系统..."

apt update
apt install -y curl git build-essential

echo "[2/8] 安装 NVM..."

export NVM_DIR="/root/.nvm"

if [ ! -d "$NVM_DIR" ]; then
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
fi

source /root/.nvm/nvm.sh

echo "[3/8] 安装 Node 24..."

nvm install 24
nvm alias default 24

echo "[4/8] 安装 OpenCodex..."

npm config set ignore-scripts false

npm install -g --allow-scripts=bun @bitkyc08/opencodex

echo "[5/8] 解压备份..."

mkdir -p /root/opencodex-restore

tar -xzvf "$BACKUP_FILE" -C /root/opencodex-restore

BACKUP_DIR=$(find /root/opencodex-restore -maxdepth 1 -type d -name "opencodex-backup-*" | head -1)

if [ -z "$BACKUP_DIR" ]; then
echo "找不到备份目录"
exit 1
fi

echo "[6/8] 恢复配置..."

cp -a "$BACKUP_DIR/.opencodex" /root/ || true

cp -a "$BACKUP_DIR/.codex" /root/ || true

echo "[7/8] 恢复 systemd..."

mkdir -p /root/.config/systemd/user

if [ -d "$BACKUP_DIR/systemd/user" ]; then
cp -a "$BACKUP_DIR/systemd/user/"* /root/.config/systemd/user/
fi

loginctl enable-linger root || true

systemctl --user daemon-reload || true

echo "[8/8] 启动服务..."

ocx service install || true

ocx restart || ocx start

echo
echo "=============================="
echo " 完成"
echo "=============================="

ocx status

保存：

Ctrl + O
Enter
Ctrl + X
二、授权
chmod +x /root/restore-opencodex.sh
三、上传你的备份包

Windows：

假设：

opencodex-backup-20260724-092535.tar.gz

上传：

scp opencodex-backup-20260724-092535.tar.gz root@新VPS_IP:/root/

同时上传脚本：

scp restore-opencodex.sh root@新VPS_IP:/root/
四、新 VPS 执行

SSH：

ssh root@新VPS_IP

运行：

bash restore-opencodex.sh opencodex-backup-20260724-092535.tar.gz

等待完成。

最后应该看到：

✅ Proxy: running

Health:
ok

Service:
installed enabled running
注意一个地方

你的备份里面有：

.codex/auth.json

所以恢复后可能直接继承 Codex 登录。

如果不想迁移账号，把这一行删除：

cp -a "$BACKUP_DIR/.codex" /root/

vironment:
MYSQL_DATABASE: lessonforge
MYSQL_USER: lessonforge
MYSQL_PASSWORD: lessonforge_qsx831220
MYSQL_ROOT_PASSWORD: Qsx@831220

  豆包调用
  curl https://ark.cn-beijing.volces.com/api/v3/responses \

-H "Authorization: Bearer $ARK_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "doubao-seed-2-1-pro-260628",
"input": [
{
"role": "user",
"content": [
{
"type": "input_image",
"image_url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/ark_demo_img_1.png"
},
{
"type": "input_text",
"text": "你看见了什么？"
}
]
}
]
}'

• 求和
• 最大值 / 最小值
• 平均值
• 综合统计（max / min / avg）
• 条件计数
• 区间筛选
• 查找元素下标

这些练习的核心思想只有一个：👉 遍历列表（for 循环）

📌 一、求和（sum）

def sum_nums(nums):
    """
    计算列表中所有元素的总和
    """
    total = 0
    for i in nums:
        total = total + i
    return total

print(sum_nums([23, 23, 23, 45, 23]))

💡 思路

• 用一个变量 total 存总和
• 遍历列表，不断累加

📌 二、求最大值（max）

def max_nums(nums):
    """
    返回列表中的最大值
    """
    max_num = nums[0]  # 假设第一个元素最大

    for i in nums:
        if i > max_num:
            max_num = i

    return max_num

print(max_nums([23, 23, 423, 32]))

💡 思路

• 先设第一个元素为最大值
• 遍历并不断更新

📌 三、求最小值（min）

def min_nums(nums):
    """
    返回列表中的最小值
    """
    min_num = nums[0]

    for i in nums:
        if i < min_num:
            min_num = i

    return min_num

print(min_nums([27, 29, 23, 43]))

📌 四、求平均值（avg）

def avg(nums):
    """
    计算列表平均值
    """
    total = 0

    for i in nums:
        total = total + i

    average = total / len(nums)
    return average

print(avg([27, 29, 23, 43]))

💡 公式

平均值 = 总和 / 个数

📌 五、统计 max / min / avg（基础写法）

def sats(nums):
    """
    同时返回最大值、最小值、平均值（多次遍历）
    """
    # 最大值
    max_num = nums[0]
    for i in nums:
        if i > max_num:
            max_num = i

    # 最小值
    min_num = nums[0]
    for i in nums:
        if i < min_num:
            min_num = i

    # 平均值
    total = 0
    for i in nums:
        total = total + i

    avg = total / len(nums)

    return max_num, min_num, avg

print(sats([23, 54, 28, 23]))

📌 六、统计 max / min / avg（优化写法 ⭐）

def stats(nums):
    """
    同时返回最大值、最小值、平均值（一次遍历完成）
    """
    max_num = nums[0]
    min_num = nums[0]
    total = 0

    for i in nums:
        if i > max_num:
            max_num = i
        if i < min_num:
            min_num = i
        total = total + i

    avg = total / len(nums)

    return max_num, min_num, avg

print(stats([27, 29, 23, 43]))

🚀 优点

• 只遍历一次列表
• 更高效（面试常考点）

📌 七、统计大于某个值的个数

def count_greater(nums, x):
    """
    统计大于 x 的元素个数
    """
    count = 0

    for i in nums:
        if i > x:
            count = count + 1

    return count

print(count_greater([23, 54, 23], 10))

📌 八、统计区间内元素个数

def count_between(nums, a, b):
    """
    统计区间 [a, b] 内的元素个数（包含边界）
    """
    count = 0

    for i in nums:
        if a <= i <= b:
            count = count + 1

    return count

print(count_between([23, 25, 43, 64], 23, 40))

📌 九、找出区间内的元素

def find_between(nums, a, b):
    """
    找出区间 (a, b) 内的所有元素（不包含边界）
    """
    result = []

    for i in nums:
        if a < i < b:
            result.append(i)

    return result

print(find_between([23, 24, 32, 35], 22, 30))

💡 区别

📌 十、查找最大值下标

def find_max_idx(nums):
    """
    返回最大值所在的索引（下标）
    """
    max_val = nums[0]
    max_idx = 0

    for i in range(len(nums)):
        if nums[i] > max_val:
            max_val = nums[i]
            max_idx = i

    return max_idx

print(find_max_idx([23, 25, 534]))

📌 十一、查找最小值下标

def find_min_idx(nums):
    """
    返回最小值所在的索引（下标）
    """
    min_val = nums[0]
    min_idx = 0

    for i in range(1, len(nums)):
        if nums[i] < min_val:
            min_val = nums[i]
            min_idx = i

    return min_idx

print(find_min_idx([23, 25, 534]))

📦 完整代码（可直接运行）

def sum_nums(nums):
    total = 0
    for i in nums:
        total += i
    return total

def max_nums(nums):
    max_num = nums[0]
    for i in nums:
        if i > max_num:
            max_num = i
    return max_num

def min_nums(nums):
    min_num = nums[0]
    for i in nums:
        if i < min_num:
            min_num = i
    return min_num

def avg(nums):
    total = 0
    for i in nums:
        total += i
    return total / len(nums)

def stats(nums):
    max_num = nums[0]
    min_num = nums[0]
    total = 0

    for i in nums:
        if i > max_num:
            max_num = i
        if i < min_num:
            min_num = i
        total += i

    return max_num, min_num, total / len(nums)

def count_greater(nums, x):
    count = 0
    for i in nums:
        if i > x:
            count += 1
    return count

def count_between(nums, a, b):
    count = 0
    for i in nums:
        if a <= i <= b:
            count += 1
    return count

def find_between(nums, a, b):
    result = []
    for i in nums:
        if a < i < b:
            result.append(i)
    return result

def find_max_idx(nums):
    max_val = nums[0]
    max_idx = 0

    for i in range(len(nums)):
        if nums[i] > max_val:
            max_val = nums[i]
            max_idx = i

    return max_idx

def find_min_idx(nums):
    min_val = nums[0]
    min_idx = 0

    for i in range(1, len(nums)):
        if nums[i] < min_val:
            min_val = nums[i]
            min_idx = i

    return min_idx

🧾 学习总结

通过这些练习，我掌握了：

• for 循环遍历列表
• 累加器思想（total / count）
• 最大最小值更新逻辑
• 函数封装
• 返回多个值（tuple）
• append() 使用
• 下标遍历

👉 这些都是后续学习算法和数据结构的基础。

我们希望通过这个项目，让大家的小智都能播放歌曲。

如果你有任何想法或建议，请随时提出 Issues 或加入 QQ 群：826072986

项目主要贡献者：空白泡泡糖果 (B站UP)，硅灵造物科技 (B站UP)，小霜霜Meow (B站UP)

音乐服务器提供者（为爱发电）：cz

💡注意事项

1. 如果小智说找不到歌曲怎么办？
   进入小智后台，找到对应设备，修改角色配置

选择 DeepSeekV3 大语言模型
在人物介绍中填入
收到音乐相关的需求时，只使用 MPC tool self.music.play_song 工具，同时禁止使用 search_music 功能。

3. 暂不支持的开发板
   ESP32C3芯片的开发板
   项目改动范围
   新增
   main\boards\common\music.h
   main\boards\common\esp32_music.cc
   main\boards\common\esp32_music.h
   修改
   main\mcp_server.cc
   main\boards\common\board.cc
   main\boards\common\board.h
   main\application.cc
   main\application.h
   main\display\display.cc
   main\display\display.h
   main\audio\audio_service.cc
   main\audio\audio_service.h
   main\idf_component.yml

然后锁权限（很重要）：

sudo chmod 600 /root/mcp-tool/.env

🧾 第 2 步：修改 service 文件（只保留干净配置）
sudo nano /etc/systemd/system/mcp-calculator.service

把 [Service] 改成下面这样（重点）：

[Service]
Type=simple
User=root
WorkingDirectory=/root/mcp-tool
EnvironmentFile=/root/mcp-tool/.env
ExecStart=/usr/bin/python3 /root/mcp-tool/mcp_pipe.py /root/mcp-tool/calculator.py
Restart=always
RestartSec=3
StandardOutput=journal
StandardError=journal

👉 注意：

❌ 不要再有 Environment=

✅ 只保留 EnvironmentFile=

🔄 第 3 步：完整重载并重启
sudo systemctl daemon-reload
sudo systemctl stop mcp-calculator
sudo systemctl start mcp-calculator
sudo systemctl status mcp-calculator

✅ 正确结果应该是
Active: active (running)

并且日志中 永远不再出现：

Please set the MCP_ENDPOINT environment variable