- Installs
- 499
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/lingfengqaq/webnovel-writer --skill webnovel-dashboard- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads webnovel-dashboard automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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。
FAQ
What does the webnovel-dashboard skill do?
启动只读小说管理面板，查看项目状态、实体图谱与章节内容。
How do I install webnovel-dashboard?
Run npx skills add https://github.com/lingfengqaq/webnovel-writer --skill webnovel-dashboard in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/webnovel-dashboard/ (personal) or .claude/skills/webnovel-dashboard/ (project).
Which AI agents can use webnovel-dashboard?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is webnovel-dashboard safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains webnovel-dashboard?
It is published by lingfengqaq in lingfengqaq/webnovel-writer. It has 499 recorded installs.
More from lingfengqaq/webnovel-writer
webnovel-review
lingfengqaq/webnovel-writer
使用审查 Agent 评估章节质量，生成报告并写回审查指标。
webnovel-plan
lingfengqaq/webnovel-writer
基于总纲生成卷纲、时间线和章纲，并把新增设定增量写回现有设定集。
webnovel-init
lingfengqaq/webnovel-writer
深度初始化网文项目。通过分阶段交互收集完整创作信息，生成可直接进入规划与写作的项目骨架与约束文件。
webnovel-query
lingfengqaq/webnovel-writer
查询项目设定、角色、力量体系、势力、伏笔等信息。支持紧急度分析与金手指状态查询。
webnovel-learn
lingfengqaq/webnovel-writer
从当前会话提取成功写作模式并写入 projectmemory.json
Popular data & databases skills
supabase-postgres-best-practices
supabase/agent-skills
Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill BEFORE writing or changing anything that lives in a Postgres database: creating or altering tables and columns (including choosing column types), schema design, migrations and declarative schema files, RLS policies and the tests that verify them, indexes, triggers, database functions, queues and scheduled jobs (pgcron, pgmq), vector/semantic search (pgvector), and restoring dumps (pgrestore) or importing data. Also load it when diagnosing slow queries, high CPU, timeouts, EXPLAIN plans, connection exhaustion, locking, bloat, or rows visible to the wrong user or tenant. This is not just a performance guide — schema, migration, security, and SQL authoring tasks need these rules too, even for a one-column change or a single query.
prisma-client-api
prisma/skills
Prisma Client API reference covering model queries, filters, operators, and client methods. Use when writing database queries, using CRUD operations, filtering data, or configuring Prisma Client. Triggers on "prisma query", "findMany", "create", "update", "delete", "$transaction".
prisma-database-setup
prisma/skills
Deprecated compatibility name for prisma-orm-setup. Use only when a user or existing integration explicitly invokes prisma-database-setup; otherwise select prisma-orm-setup.
prisma-cli
prisma/skills
Prisma ORM 7 CLI reference for existing Prisma 7 applications or explicitly selected Prisma 7 workflows. Covers prisma init, generate, migrate, db, dev, studio, and mcp. For setup, connection repair, or Prisma 8, use prisma-orm-setup; not the Prisma Platform CLI.
prisma-postgres
prisma/skills
Deprecated compatibility name for prisma-postgres-setup. Use only when a user or existing integration explicitly invokes prisma-postgres; otherwise select prisma-postgres-setup.
prisma-driver-adapter-implementation
prisma/skills
Required reference for Prisma ORM 7 SQL driver adapter work. Use when implementing or modifying adapters, adding database drivers, or touching SqlDriverAdapter, Transaction, savepoint, result mapping, or DriverAdapterError behavior. Covers current transaction lifecycle, optional savepoint hooks, original database-error preservation, and verification.