Webnovel Dashboard

Objectives

• Launch a local read-only web panel to view writing progress, setting dictionary, relationship graph, chapter content, and followership data.
• Expose Story Runtime main chain status:

  /api/story-runtime/health

  , latest commit, and fallback status.
• Can monitor changes in

  .webnovel/

  , but does not modify any project files.

Execution Process

Step 1: Confirm Environment and Module Directory

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"
export SCRIPTS_DIR="${CLAUDE_PLUGIN_ROOT}/scripts"

Step 2: Resolve Project Root Directory

export PROJECT_ROOT="$(python "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" where)"
echo "项目路径: ${PROJECT_ROOT}"

PROJECT_ROOT

Step 3: Validate Frontend Build Artifacts and Dependencies

if [ -n "${PYTHONPATH:-}" ]; then
  export PYTHONPATH="${CLAUDE_PLUGIN_ROOT}:${PYTHONPATH}"
else
  export PYTHONPATH="${CLAUDE_PLUGIN_ROOT}"
fi

if [ ! -f "${DASHBOARD_DIR}/frontend/dist/index.html" ]; then
  echo "ERROR: 缺少前端构建产物 ${DASHBOARD_DIR}/frontend/dist/index.html（dist 应随插件打包，确认插件完整安装）" >&2
  exit 1
fi

python -m pip install -r "${DASHBOARD_DIR}/requirements.txt"

Step 4: Launch Dashboard

python -m dashboard.server --project-root "${PROJECT_ROOT}"

--no-browser

--port 9000

/api/story-runtime/health

/api/preflight

Success Criteria

• Dashboard process has started and outputs accessible URL; the page displays project data (chapter list, entity graph, etc.).

Failure Recovery

pip install -r "${DASHBOARD_DIR}/requirements.txt"

dist/

.webnovel/state.json

WORKSPACE_ROOT

--port <other port>

.webnovel/

Security Boundaries

• Pure read-only panel, no modification interfaces provided, no project files modified.
• File access is restricted within the

  PROJECT_ROOT

  scope, and only localhost is monitored by default.