Webnovel Dashboard 是小说创作插件中的本地只读 Web 面板，目标是让作者查看创作进度、设定词典、关系图谱、章节内容与追读力数据，并暴露 Story Runtime 主链状态，包括 /api/story-runtime/health、latest commit 与 fallback 情况。它会监听 .webnovel/ 变化，但明确不修改任何项目文件。
使用时先确认环境与模块目录：设置 WORKSPACE_ROOT，检查 CLAUDE_PLUGIN_ROOT/dashboard 是否存在，再解析项目根目录： export PROJECT_ROOT="$(python "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" where)" 随后校验前端产物与依赖，缺少前端构建产物时提示确认插件完整安装；不默认安装依赖，仅在启动因缺依赖失败时提示手动执行： python -m pip install -r "${DASHBOARD_DIR}/requirements.txt" 启动命令为： python -m dashboard.server --project-root "${PROJECT_ROOT}" 可加 --no-browser 不自动打开浏览器，或用 --port 9000 自定义端口。启动后优先确认 /api/story-runtime/health、/api/preflight 等接口可用。
成功标准是进程已启动并输出可访问 URL，页面显示项目数据，如章节列表、实体图谱等。常见故障包括启动报缺依赖、前端 dist/ 缺失、项目根解析失败、端口占用、页面空白或数据缺失；可分别通过手动安装依赖、确认插件完整安装、检查 .webnovel/state.json 与 WORKSPACE_ROOT、更换端口、确认 state.json 和 index.db 等数据文件来处理。
安全边界为纯只读面板，不提供修改接口，不修改任何项目文件，文件访问限制在 PROJECT_ROOT 范围内，默认仅监听 localhost。