사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/lingfengqaq/webnovel-writer --skill webnovel-dashboard시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
Webnovel Dashboard
目标
- 在本地启动只读 Web 面板，查看创作进度、设定词典、关系图谱、章节内容与追读力数据。
- 暴露 Story Runtime 主链状态：
/api/story-runtime/health、latest commit、fallback 情况。 - 可监听
.webnovel/变化，但不修改任何项目文件。
执行流程
Step 1：确认环境与模块目录
bash
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：解析项目根目录
bash
export PROJECT_ROOT="$(python "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" where)"
echo "项目路径: ${PROJECT_ROOT}"PROJECT_ROOT 必须解析成功。
Step 3：校验前端产物与依赖
bash
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 因缺依赖启动失败时，提示用户手动执行：
bash
python -m pip install -r "${DASHBOARD_DIR}/requirements.txt"Step 4：启动 Dashboard
bash
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。
