skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
xindoo/sumeru872 installs

sumeru-finalize

小说完稿校验与导出,适用于用户说"小说写完了帮我检查下"、"导出适合起点/番茄的格式"、"查有没有错别字"、"检测敏感词"、"整理成发布版本"、"帮我导出小说发布格式"、"检查小说错别字"、"敏感词检测"、"小说完稿检查"、"适配起点格式导出"、"番茄小说格式导出"、"小说排版整理"、"多平台格式导出"等需求,负责文字校验、IP/敏感内容扫描、版式规范与多平台导出(md/txt/html/epub),批量时每个子Agent最多负责3章

How do I install this agent skill?

npx skills add https://github.com/xindoo/sumeru --skill sumeru-finalize
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill is a utility for novel manuscript finalization, providing features for grammar checking, sensitive content detection, and multi-platform formatting. It operates on local project files and manages task distribution via a sub-agent mechanism. The analysis found no evidence of malicious behavior, obfuscation, or unauthorized data access.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

网文完稿校验

触发关键词

小说写完了帮我检查下、导出适合起点/番茄的格式、查有没有错别字、检测敏感词、整理成发布版本、帮我导出小说发布格式、检查小说错别字、敏感词检测、小说完稿检查、适配起点格式导出、番茄小说格式导出、小说排版整理、多平台格式导出、小说完稿导出

核心功能

  1. 错别字、标点符号、语法错误检查
  2. 敏感内容、违规内容排查
  3. 格式规范统一:章节标题、段落格式、标点规范
  4. 全文字数统计、完稿报告生成
  5. 适配不同平台发布格式导出
  6. 批量替换功能
  7. 自动分段功能

Skill 边界说明:技术性文字校验(错别字/标点/语法)由本 Skill 负责,sumeru-polish Skill 专注于文笔和内容层面的优化,两者互补不重叠。用户在润色后仍应通过 finalize 进行最终技术校验。

子Agent并行校验机制

当需要校验/导出的章节数量大于3章时,自动启用子Agent并行处理模式:

⚠️ 遵循全局约束:每个子Agent最多负责3个章节(详见 AGENTS.md "子Agent并行处理规则")

  • 所需Agent数 = ceil(总章节数 / 3)
  • 相邻章节分配给同一Agent,保持格式处理一致性

调度逻辑

flowchart LR
    A[批量校验任务] --> B[读取章节列表与校验配置]
    B --> C[创建任务队列,按每Agent最多3章分配]
    C --> D[计算所需Agent数 = ceil(总章数 ÷ 3)]
    D --> E[启动N个并行子agent]
    E --> F[子Agent拉取任务 → 校验章节 → 生成错误报告 → 导出格式]
    F --> G{队列是否为空?}
    G -->|否| F
    G -->|是| H[汇总校验结果,合并错误报告,生成完稿报告]

章节分配规则

  • 按章节顺序连续分配(如Agent1负责第1-3章,Agent2负责第4-6章)
  • 尾部不足3章的Agent按实际剩余章节数分配

每个子Agent的校验范围

  • 错别字、标点、语法错误检查
  • 敏感词检测(按三级标准)
  • 格式规范统一
  • 对应平台格式导出

输出内容

  • 错误列表:错别字、标点错误、占位符、重复段落
  • 合规提示:命中 ip-blocklist.md 的禁用名称(命中即阻断导出)
  • 校验后的纯净版全文
  • 完稿报告:总字数、章节数、异常项、导出路径
  • 多平台发布文件:每个平台一套 full.md / full.txt / full.html / book.epub + 分章 txt

构建命令(优先使用脚本,不要手写导出)

# 只检查,不导出
python3 skills/sumeru-finalize/scripts/build.py --check-only

# 导出全平台全格式
python3 skills/sumeru-finalize/scripts/build.py --platform all --format md,txt,html,epub --title "书名" --author "作者"

# 单平台:番茄只要 txt
python3 skills/sumeru-finalize/scripts/build.py --platform fanqie --format txt

# 严格模式:警告也阻断导出
python3 skills/sumeru-finalize/scripts/build.py --check-only --strict

# 批量替换 + 自动分段(替换在导出时生效,不改动 chapters/)
python3 skills/sumeru-finalize/scripts/build.py --platform all --replace "旧名=>新名" --max-paragraph 300

--replace 只影响导出文件,不修改 chapters/ 原件;需要永久改名请先走 review/polish 的备份修改流程。 若黑名单误伤(例如原创角色恰好与名单重名),用 --allow "名字" 放行,并在报告中注明理由。

输出目录结构:

publish/
└── {platform}/
    ├── full.md
    ├── full.txt
    ├── full.html
    ├── book.epub
    └── chapters/001-标题.txt

中间数据写入 .sumeru/finalize/stats.json 与 .sumeru/finalize/report.md,同时在当前目录生成用户可读的 完稿校验报告.md。

各平台导出格式规则

脚本负责:标题格式、首行缩进、段间空行、编码、分章、打包。平台专属栏目(作者有话要说、章节提要、下章预告)需作者手动补充,脚本不自动生成。

起点中文网(qidian)

  • 章节标题格式:第X章 标题内容,居中对齐
  • 段落首行缩进2字符
  • 每段空一行
  • 标点符号使用中文全角
  • 章节字数建议3000-5000字
  • 禁止使用特殊符号作为章节标题
  • 对话单独成段

番茄小说(fanqie)

  • 章节标题格式:第X章 标题内容
  • 段落首行不缩进,段落间空一行
  • 每句尽量简短,适合移动端阅读
  • 章节字数建议2000-3000字
  • 对话使用引号包裹,说话人单独成段或句尾注明

晋江文学城(jjwxc)

  • 章节标题格式:第X章 标题内容
  • 支持HTML格式标签
  • 段落首行缩进2字符
  • 章节字数建议2500-4000字
  • 作者有话要说区域需作者手动补充
  • 章节提要需作者手动补充

纵横中文网(zongheng)

  • 章节标题格式:第X章 标题内容
  • 段落首行缩进2字符
  • 章节字数建议3000-6000字
  • 支持分卷设置
  • 标点规范使用中文全角

17K小说网(17k)

  • 章节标题格式:第X章 标题内容
  • 段落首行缩进2字符
  • 章节字数建议2000-4000字
  • 支持章节预览
  • 下章预告需作者手动补充

敏感词检测标准

一级敏感(必须修改)

  • 违反国家法律法规的内容
  • 涉及政治敏感人物、事件
  • 色情、淫秽描写
  • 暴力、恐怖内容
  • 分裂国家、破坏民族团结言论
  • 宗教极端内容

二级敏感(建议修改)

  • 过于血腥暴力的细节描写
  • 低俗用语、粗口
  • 可能引起不适的医疗描写
  • 涉及未成年人的不当内容
  • 赌博、毒品相关描写
  • 侵犯他人隐私的内容

三级敏感(优化建议)

  • 网络用语过多影响阅读
  • 容易产生歧义的表述
  • 可能引起争议的话题
  • 过度使用网络热梗
  • 重复冗余的表述

错误分级提示

严重错误(红色标记)

  • 错别字导致语义完全改变
  • 敏感词一级违规内容
  • 章节标题格式完全不符合规范
  • 段落结构严重混乱
  • 标点符号大面积错误

中等错误(黄色标记)

  • 一般错别字
  • 标点符号使用不规范
  • 敏感词二级内容
  • 段落格式不统一
  • 语法错误影响理解

轻微错误(蓝色标记)

  • 建议优化的用词
  • 标点符号使用可以更规范
  • 敏感词三级内容
  • 段落排版可进一步美化
  • 重复性表述建议

批量替换功能说明

功能特性

  • build.py --replace "旧=>新" 支持全局字面量替换,可重复传入多组规则
  • 替换只作用于导出文件,不改动 chapters/ 原件
  • 正则替换、替换前预览由模型侧辅助完成(脚本不内置正则,避免误替换)
  • 替换次数会随导出流程统计,写入报告

使用场景

  1. 角色名统一修改
  2. 地名、设定名称批量调整
  3. 敏感词批量替换
  4. 标点符号统一规范
  5. 网络用语批量转换

操作方式

  • 预设规则:按常用场景(角色改名/地名统一/标点规范)生成规则清单
  • 自定义规则:--replace "旧=>新",多组规则重复传参
  • 复杂匹配:需要正则时,先由模型生成候选替换清单,人工确认后再执行字面量替换
  • 预览:先 --check-only 确认原文状态,再导出并对比 full.txt

自动分段功能说明

功能特性(脚本能力边界)

  • build.py --max-paragraph N:仅对超长段落按句末标点(。!?…)拆分,保持句子完整
  • 默认关闭(0),需要时显式开启
  • 不自动改写对话格式,不改变原文语序
  • 语义级分段(对话/场景切换)由模型在润色阶段完成,脚本只做机械兜底

分段规则

  1. 字数控制:单段建议 100-300 字,超过阈值才拆
  2. 逻辑完整:只在句末标点处拆分,不在句中截断
  3. 对话优先:对话独立成段由润色环节处理,脚本不擅自改动
  4. 场景切换:场景转场由作者/模型使用分隔线处理

可配置参数

  • 最大段落字数(--max-paragraph,默认 0 不启用)
  • 仅在句末标点处拆分
  • 保留原有段落结构,不合并段落

数据持久化

完稿数据自动保存到 .sumeru/finalize/ 目录:

  • stats.json:统计与导出结果,包含 passed、errors、warnings、逐章字数
  • report.md:完稿校验报告
  • export-config.json:各平台导出配置参数

用户可见输出(当前工作目录):

  • publish/:各平台导出版本,按平台名分类存放
  • 完稿校验报告.md:错误/警告/导出结果汇总

与其他 Skill 配合

  • 前置 Skill:读取最终章节内容
    • 默认从 chapters/ 读取最新章节内容(review 修复和 polish 润色直接修改 chapters/,无需额外操作)
  • 黑名单来源:skills/sumeru-outline/references/ip-blocklist.md,与 outline 阶段共用同一份基准

数据复用

  • 可随时重新导出其他平台格式,无需重新校验
  • 错误报告可作为后续写作的规避参考
  • 支持增量导出,修改部分章节后仅重新生成对应章节的平台版本

产物与验收标准(Definition of Done)

验收项标准校验方式
无阻断错误命名/缺章/空章/禁用名称均为 0build.py --check-only 退出码 0
版式统一标题格式、段落缩进、空行符合平台规则抽查 publish/{platform}/full.txt
全平台导出目标平台目录均生成成功检查 publish/
报告完整总字数/章节数/异常项齐全检查 完稿校验报告.md
EPUB 可用mimetype 为首条且未压缩测试用例覆盖

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/xindoo/sumeru/sumeru-finalize">View sumeru-finalize on skillZs</a>