各种疑难杂症总结

[Boyee2022]

1. docker 里面部署出问题就源码七点
2. 源码启动失败，界面进去报 500 黑框啥都没有--》这个是用的 node 版本太新了，用 nvm 或是啥把 node 版本换成 20 就可以
3. 源码拉下来，但是 xml 错误，--》把原先的～/.adalflow 给删了，把依赖中的 adalflow 由 0.1 改为 1.1 把依赖重装一遍
4. 源码拉下来，500,如果是大陆，看一下你的代理，有没有开 tun,如果开了 tun,查看日志，看该项目去请求 openai 的时候走没走代理，多半儿是代理的问题，要开 tun 虚拟网卡。
5. 换成 google 出问题，google 目前卡地区很严重，如果你的节点不干净或是你的 google 账户被判定为国内，同样不行，去申请一个新的 google 账户，记得用干净 ip
6. python 启动，python 环境依赖问题，忽视掉 api 中的 pyproject.toml，将其转化成 requirments,然后在项目根目录中 uv add -r requirements ，记得把 poetry 相关的依赖选项去掉。对了，提前把项目跟目录中的 uv.lock 删掉。启动时 uv run python -m api.main 所有操作在根目录中完成。
7. 启动前端nvm use 20.
8. 我贡献一个完整的源码启动脚本
9. 记得给脚本权限，放在根目录中

#!/bin/bash

echo "=== Starting DeepWiki Development Environment ==="

# 激活Python虚拟环境
source .venv/bin/activate

# 激活nvm并使用Node 20
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
nvm use 20

# 启动后端API服务（后台运行）
echo "Starting backend API server on port 8001..."
uv run python -m api.main &
BACKEND_PID=$!
echo "Backend started with PID: $BACKEND_PID"

# 等待后端启动
echo "Waiting for backend to be ready..."
sleep 8

# 启动前端开发服务器
echo "Starting frontend development server on port 3000..."
npm run dev

# 当前端停止时，也停止后端
echo "Stopping backend server..."
kill $BACKEND_PID 2>/dev/null
echo "=== Development environment stopped ==="