1️⃣ 环境准备

bash

# 1.1 确认 Node/NPM 路径（NVM 安装方式）
which node    # 应输出 /root/.nvm/versions/node/v22.23.2/bin/node
which npm     # 应输出 /root/.nvm/versions/node/v22.23.2/bin/npm
which dsh     # 应输出 /root/.nvm/versions/node/v22.23.2/bin/dsh

# 1.2 安装系统依赖
yum install -y rsync

# 1.3 安装 Playwright + Chromium（用于验证，可选）
/usr/bin/python3 -m pip install playwright
/usr/bin/python3 -m playwright install chromium

2️⃣ 克隆仓库并修正路径

bash

cd /root
git clone https://github.com/UnKnownFish125/dsh-deepmemory.git
cd dsh-deepmemory

# 2.1 修正硬编码的 Python 路径
sed -i 's|/opt/AstrBot/venv/bin/python3|/usr/bin/python3|g' scripts/install.sh
sed -i 's|/opt/AstrBot/venv/bin/python3|/usr/bin/python3|g' scripts/verify.sh

# 2.2 修正硬编码的 Node 路径（如存在）
sed -i 's|/usr/local/node/lib/node_modules|/root/.nvm/versions/node/v22.23.2/lib/node_modules|g' agent-preset/memory-plugin/plugin-v3.js

3️⃣ 安装 react-dom 依赖（解决 render-check.mjs 报错）

bash

cd /root/.dsh/profiles/web/
pnpm install react@18.3.1 react-dom@18.3.1
cd /root/dsh-deepmemory

4️⃣ 手动验证关键组件（确保核心功能正常）

bash

export DSH_HOME=/root/.dsh
export NODE_PATH=/root/.nvm/versions/node/v22.23.2/lib/node_modules
export NODE=/root/.nvm/versions/node/v22.23.2/bin/node
export PATH=/root/.nvm/versions/node/v22.23.2/bin:$PATH

# 4.1 验证 client.js 转换+渲染（应输出 render ok...）
CTMP=$(mktemp -d /www/verify-tmp/client-XXXXXX)
cp /root/dsh-deepmemory/web-plugin/client.js "$CTMP/client.js"
/usr/bin/python3 /root/dsh-deepmemory/scripts/fix-client-bundle.py "$CTMP/client.js" dsh-deepmemory
CLIENT_JS="$CTMP/client.js" $NODE /root/dsh-deepmemory/scripts/verify/render-check.mjs

# 4.2 验证 preset 插件（应输出插件就绪信息）
PLUGIN_PATH=/root/dsh-deepmemory/agent-preset/memory-plugin/plugin-v3.js $NODE /root/dsh-deepmemory/scripts/verify/plugin-check.mjs

5️⃣ 跳过验证并执行安装（因脚本环境变量传递问题）

bash

# 5.1 备份并注释掉验证块
cp scripts/install.sh scripts/install.sh.bak
sed -i '16,22s/^/# /' scripts/install.sh
sed -i '15a # 跳过验证（手动确认通过）' scripts/install.sh

# 5.2 在 install.sh 中强制设置 PATH
sed -i '5i export PATH=/root/.nvm/versions/node/v22.23.2/bin:$PATH' scripts/install.sh

# 5.3 执行安装
sudo -E bash scripts/install.sh

6️⃣ 重启 DSH Web 服务

bash

# 方法一（如果有 systemd 服务）
systemctl restart dsh-web

# 方法二（使用安装脚本生成的 safe-restart）
bash /www/scripts/dsh-safe-restart.sh

# 方法三（手动重启）
pkill -f "dsh web"
npx @deepseek-ai/dsh web &

7️⃣ 验证安装结果

bash

# 检查 memory-server 状态
curl http://localhost:28866/v1/health

# 检查插件文件
ls /root/.dsh/profiles/web/node_modules/dsh-deepmemory/
ls /root/.dsh/.agent-presets/harness-memory/

---

✅ 安装成功的标志

• 安装脚本输出 安装完成。当前状态: {"documents":0,...}

• Web 界面中新建会话时可选 「记忆增强模式」 预设

• 对话中出现 memory_save / memory_recall 等工具调用

• 界面显示「记忆」选项卡

---

📌 注意事项

问题	解决方案
node 命令找不到	在 install.sh 中设置 PATH
Python 路径错误	全局替换 /opt/AstrBot/venv/bin/python3 → /usr/bin/python3
react-dom 版本冲突	强制安装 react@18.3.1 react-dom@18.3.1
验证脚本路径硬编码	手动修改 plugin-v3.js 中的导入路径
验证失败但手动测试通过	跳过验证（已手动确认）