启动可视化小说管理面板(只读 Web Dashboard),实时查看项目状态、实体图谱与章节内容。
在本地启动一个 只读 Web 面板,用于可视化查看当前小说项目的:
面板通过 watchdog 监听 .webnovel/ 目录变更并实时刷新,不对项目做任何修改。
export WORKSPACE_ROOT="${CLAUDE_PROJECT_DIR:-$PWD}"
if [ -z "${CLAUDE_PLUGIN_ROOT}" ] || [ ! -d "${CLAUDE_PLUGIN_ROOT}/dashboard" ]; then
echo "ERROR: 未找到 dashboard 模块: ${CLAUDE_PLUGIN_ROOT}/dashboard" >&2
exit 1
fi
export DASHBOARD_DIR="${CLAUDE_PLUGIN_ROOT}/dashboard"
python -m pip install -r "${DASHBOARD_DIR}/requirements.txt" --quiet
export SCRIPTS_DIR="${CLAUDE_PLUGIN_ROOT}/scripts"
export PROJECT_ROOT="$(python "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" where)"
echo "项目路径: ${PROJECT_ROOT}"
# 确保 `python -m dashboard.server` 可在任意工作目录下找到插件模块
if [ -n "${PYTHONPATH:-}" ]; then
export PYTHONPATH="${CLAUDE_PLUGIN_ROOT}:${PYTHONPATH}"
else
export PYTHONPATH="${CLAUDE_PLUGIN_ROOT}"
fi
# 前端 dist 已随插件发布;若缺失说明安装包异常
if [ ! -f "${DASHBOARD_DIR}/frontend/dist/index.html" ]; then
echo "ERROR: 缺少前端构建产物 ${DASHBOARD_DIR}/frontend/dist/index.html" >&2
echo "请重新安装插件或联系维护者修复发布包。" >&2
exit 1
fi
python -m dashboard.server --project-root "${PROJECT_ROOT}"
启动后会自动打开浏览器访问 http://127.0.0.1:8765。
如不需要自动打开浏览器,使用:
python -m dashboard.server --project-root "${PROJECT_ROOT}" --no-browser
PROJECT_ROOT 范围内,防止路径穿越。--port 9000 参数。