mcpField
W
webnovel-dashboard

webnovel-dashboard

github.com/lingfengqaq创意与媒体7.7k502 次安装6 天前更新
代码仓库

关于 webnovel-dashboard

webnovel-dashboard 是用于查看网络小说项目状态的本地只读 Web 面板，面向小说创作者。它展示创作进度、设定与章节数据，并提供 Story Runtime 状态接口；不会修改项目文件。

主要功能

  1. 01查看创作进度与章节内容
  2. 02浏览设定词典和关系图谱
  3. 03查看追读力数据
  4. 04检查 Story Runtime 状态
  5. 05监听 .webnovel/ 文件变化

适用场景

  1. 01查看小说项目的章节与设定数据
  2. 02排查 Story Runtime 健康状态
  3. 03跟踪 .webnovel/ 数据变化

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/lingfengqaq/webnovel-writer --skill webnovel-dashboard

安装后在 Claude Code 中输入/webnovel-dashboard确认已加载。

详细介绍

来自项目 README

Webnovel Dashboard

目标

  • 在本地启动只读 Web 面板，查看创作进度、设定词典、关系图谱、章节内容与追读力数据。
  • 暴露 Story Runtime 主链状态：/api/story-runtime/health、latest commit、fallback 情况。
  • 可监听 .webnovel/ 变化，但不修改任何项目文件。

执行流程

Step 1：确认环境与模块目录
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：解析项目根目录
export PROJECT_ROOT="$(python "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" where)"
echo "项目路径: ${PROJECT_ROOT}"

PROJECT_ROOT 必须解析成功。

Step 3：校验前端产物与依赖
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

不默认安装依赖。仅当 Step 4 因缺依赖启动失败时，提示用户手动执行：

python -m pip install -r "${DASHBOARD_DIR}/requirements.txt"
Step 4：启动 Dashboard
python -m dashboard.server --project-root "${PROJECT_ROOT}"

不自动打开浏览器时加 --no-browser；自定义端口加 --port 9000。

启动后优先确认接口可用：/api/story-runtime/health、/api/preflight。

成功标准

  • Dashboard 进程已启动并输出可访问 URL；页面显示项目数据（章节列表、实体图谱等）。

失败恢复

故障恢复方式
启动报缺依赖手动 pip install -r "${DASHBOARD_DIR}/requirements.txt"，检查 Python 版本与网络
前端 dist/ 缺失确认插件完整安装，dist 应随插件打包
项目根解析失败检查 .webnovel/state.json 是否存在，确认 WORKSPACE_ROOT 正确
端口占用用 --port <其他端口> 或关闭占用进程
页面空白/数据缺失确认 .webnovel/ 下有 state.json、index.db 等数据文件

安全边界

  • 纯只读面板，不提供修改接口，不修改任何项目文件。
  • 文件访问限制在 PROJECT_ROOT 范围内，默认仅监听 localhost。

评论

支持 Markdown